/* =========================================================================
 *  tokens.css — Shafa Shahd Design System Foundation
 *  Phase 2A — Design Token Migration
 *  Source of truth: DESIGN_SYSTEM.md
 *  =========================================================================
 *  Naming convention:
 *    --shafa-*   Official brand tokens (semantic, canonical)
 *    --*         Backward-compat aliases mapping to --shafa-* tokens
 *                (existing templates reference these; do not remove until
 *                 a full template migration is done in a later phase)
 * ========================================================================= */

:root {

  /* ===================================================================
   * 1. SURFACES & CANVAS (LUXURY MINIMAL)
   * =================================================================== */
  --shafa-canvas:          #FAF8F5; /* Warm Velvet Alabaster */
  --shafa-surface-card:    #FFFFFF; /* Pure White with crisp micro-border */
  --shafa-surface-muted:   #F5F1E8; /* Muted Warm Sand */
  --shafa-surface-dark:    #111412; /* Deep Obsidian Forest */
  --shafa-surface-glass:   rgba(255, 255, 255, 0.78);
  --shafa-surface-glass-border: rgba(197, 160, 89, 0.22);
  --shafa-surface-card-border:  rgba(232, 226, 213, 0.85);

  /* ===================================================================
   * 2. BRAND ACCENTS — LUXURY GOLD & NOBLE EMERALD
   * =================================================================== */
  --shafa-gold-satin:      #C5A059; /* Satin Luxury Gold — primary accent */
  --shafa-gold-hover:      #B38D45; /* Darker gold for interactive states */
  --shafa-gold-subtle:     #F9F4E8; /* Tinted champagne gold for badges */
  --shafa-gold-glow:       rgba(197, 160, 89, 0.25);
  --shafa-gold-gradient:   linear-gradient(135deg, #DFC07A 0%, #C5A059 50%, #9F7E3B 100%);
  /* نسخهٔ روشن‌تر برای hover — پیش از این در buttons.css هاردکد بود
     (E6C885/D4AF60/B08D45) و سومین نسخهٔ گرادیان طلایی بود. */
  --shafa-gold-gradient-hover: linear-gradient(135deg, #E6C885 0%, #D4AF60 50%, #B08D45 100%);
  --shafa-gold-gradient-soft: linear-gradient(135deg, rgba(223, 192, 122, 0.15) 0%, rgba(197, 160, 89, 0.05) 100%);

  /* --- گرادیان طلایی برای *متن* (background-clip: text) --------------------
     چرا یک توکن جدا؟
     پالت بالا برای زمینهٔ تیره ساخته شده است. روی #111D16 عالی است
     (#DFC07A → 10.5:1) ولی روی زمینهٔ روشن همهٔ stopها زیر آستانهٔ WCAG
     می‌افتند:
         #DFC07A → 1.66:1     #C5A059 → 2.32:1     #9F7E3B → 3.59:1
     یعنی هر متنی که با این گرادیان روی کارت/صفحهٔ روشن رندر می‌شد
     عملاً ناخوانا بود. ممیزی ۷ عنصر متن-گرادیانی، ۶ مورد را رد کرد.
     این نسخه بین دو طلایی تیره نوسان می‌کند که هر دو پاس می‌شوند:
         #8A641A → 5.06:1      #5E4411 → 8.57:1     (روی #FAF8F5)
     در تم تاریک به نسخهٔ روشنِ بالا برمی‌گردد، چون آنجا زمینه تیره است.
     برای بخش‌هایی که حتی در تم تاریک هم روشن می‌مانند (مثل hero صفحهٔ خانه
     که background اش #FAF8F5 هاردکد است) از نسخهٔ ثابتِ *-fixed استفاده کن،
     وگرنه در تم تاریک متن روشن روی زمینهٔ روشن می‌افتد. */
  --shafa-gold-gradient-text:
    linear-gradient(135deg, #8A641A 0%, #5E4411 50%, #8A641A 100%);
  /* ثابت: فقط برای سطوحی که در *هر دو* تم روشن می‌مانند (مثلاً پنل‌های
     همیشه‌روشن). تم تاریک آن را override نمی‌کند چون فرضش روشن‌ماندن است.
     هیرو صفحهٔ خانه از این استفاده نکند: وقتی هیرو رنگ هاردکد داشت، در تم
     تاریک روشن می‌ماند و این نسخه لازم بود. حالا که از --shafa-hero-base
     می‌خواند، باید گرادیان *چرخان* را بگیرد تا در تم تاریک طلای روشن شود. */
  --shafa-gold-gradient-text-fixed:
    linear-gradient(135deg, #8A641A 0%, #5E4411 50%, #8A641A 100%);

  --shafa-green-alpine:    #162B21; /* Deep Noble Emerald Forest */
  --shafa-green-hover:     #0F1F17; /* Intense Obsidian Green */
  --shafa-green-soft:      #EDF4F0; /* Soft botanical sage */
  --shafa-green-gradient:  linear-gradient(135deg, #1E3B2E 0%, #162B21 100%);
  --shafa-green-gradient-hover: linear-gradient(135deg, #1A3629 0%, #0F2018 100%);

  /* Emerald tints — used by badges, stock chips and nav active states.
   * Kept separate from --shafa-green-alpine so the dark variant can
   * retint them without inverting the emerald surface itself. */
  --shafa-emerald-ink:         #162B21;
  --shafa-emerald-tint-bg:     rgba(22, 43, 33, 0.07);
  --shafa-emerald-tint-border: rgba(22, 43, 33, 0.18);

  /* برندِ پایه — در تم روشن اکسنت/مرکز ثانویه همان رنگ‌های کرم‌وتالوست،
     در تم تاریک از رنگ‌های Primary/Secondary پالت تیره می‌آید (§14). */
  --shafa-brand-primary:   var(--shafa-gold-satin);
  --shafa-brand-secondary: var(--shafa-green-alpine);

  --shafa-honey-amber:     #8C4A15; /* Pure Harvest Amber */
  --shafa-honey-glow:      rgba(140, 74, 21, 0.18);

  /* ===================================================================
   * 2b. GOLD AS TEXT — accessible gold for Persian copy
   * Gold Satin (#C5A059) is a SURFACE/ACCENT color only: on cream it
   * measures 2.3:1 and fails WCAG AA. Any gold used as text color must
   * use this token instead. Dark value lives with the dark variant.
   * =================================================================== */
  --shafa-gold-text:       #8A641A; /* Deep Antique Gold — 5.1:1 on #FAF8F5, 5.4:1 on #FFFFFF */
  /* کانال RGB همان طلای متن. --shafa-gold-text-rgb تا ۲۰۲۶-۰۹ مصرف می‌شد ولی
     هیچ‌جا تعریف نشده بود، پس هر rgba(var(--shafa-gold-text-rgb), …) باطل بود
     و --shafa-lm-badge-bg/-border (خط ۳۰۳-۳۰۴) بی‌اثر می‌ماند.
     مقدار = اجزای #8A641A. تعریف تیره در بلوک data-theme="dark" پایین‌تر. */
  --shafa-gold-text-rgb:   138, 100, 26;
  --shafa-on-gold:         #111412; /* Text/icon color on gold surfaces */
  --shafa-on-emerald:      #FFFFFF; /* Text/icon color on emerald surfaces */
  --shafa-on-dark-surface: #FAF8F5; /* Text on --shafa-surface-dark (footer, stats) */

  /* ===================================================================
   * 3. TYPOGRAPHY & TEXT (WCAG AAA Compliant)
   * =================================================================== */
  --shafa-text-primary:    #181614; /* Deep Mineral Charcoal — 15:1 contrast */
  --shafa-text-secondary:  #544F49; /* Warm Earth Muted — 7:1 contrast */
  --shafa-text-tertiary:   #6B645B; /* Subtle metadata, captions & placeholders.
     5.50:1 on #FAF8F5 · 5.83:1 on #FFFFFF · 5.18:1 on #F5F1E8.
     مقدار قبلی #7D766D بود: ۴.۲۳ / ۴.۴۸ / ۳.۹۸ — زیر حد AA برای متن
     ۱۲ پیکسلی (که دقیقاً کاربرد این توکن است). این توکن در ۱۳۱ نقطه
     استفاده می‌شود، پس تیره‌کردن یک‌بار آن کل سایت را درست می‌کند.
     --shafa-text-faint (خط پایین) برای موارد تزئینی و غیرِ اطلاعاتی است. */
  --shafa-text-faint:      #8A837A; /* فقط آیکون/خط تزئینی — نه متن خوانا */
  --shafa-text-inverse:    #FAF8F5; /* Cream text on dark surfaces */

  /* ===================================================================
   * 4. BORDERS & STRUCTURAL DIVIDERS
   * =================================================================== */
  --shafa-border-subtle:   #E8E2D5; /* Organic Divider — fine structural lines */
  --shafa-border-strong:   #78716C; /* stone-500 — stronger hairlines & stars */
  --shafa-border-focus:    #8A641A; /* Focus outline — Deep Antique Gold.
     WCAG 2.2 SC 1.4.11 needs >= 3:1 for a focus indicator. Satin Gold #C5A059
     is only 2.32:1 on #FAF8F5 / 2.46:1 on #FFFFFF, so it cannot be used.
     #8A641A is 5.06:1 / 5.36:1. Dark theme overrides this with the sand
     accent #D6BD98 (7.13:1 on #1A3636). */
  --shafa-border-dark:     #2A2724; /* Dark dividers inside footer */
  /* چاپ: روی کاغذ سفید، --shafa-border-subtle (#E8E2D5) عملاً نامرئی است.
     مرز گزارش‌های چاپی از یک خاکستری گرم میانه می‌خواند تا در کاغذ دیده شود. */
  --shafa-border-print:    #A8A29A;

  /* ===================================================================
   * 5. SYSTEM FEEDBACK & SEMANTICS
   * =================================================================== */
  --shafa-status-success:  #1B5E36; /* Deep Emerald — success & health */
  --shafa-status-warning:  #945B0A; /* Deep Ochre — stock warnings */
  --shafa-status-error:    #9E2A2B; /* Carmine Red */
  /* Info — Deep Petrol Teal. جایگزین آبی Sky (#0284c7) که در admin.css
   * هاردکد بود: آن رنگ با برند تضاد داشت و روی #FFFFFF فقط 4.1:1 می‌داد.
   * تیل از خانوادهٔ نفتی برند است و 6.24:1 روی کارت سفید می‌دهد. */
  --shafa-status-info:     #0F6B72; /* 6.24:1 روی کارت · 5.88:1 روی canvas */

  /* ===================================================================
   * 6. TYPOGRAPHY SCALE (Fluid & Responsive)
   *    Source: DESIGN_SYSTEM.md §3
   * =================================================================== */
  --shafa-fs-hero:    clamp(2.25rem, 4vw + 1rem, 3.5rem);   /* 36–56px */
  --shafa-fs-h1:      clamp(1.85rem, 2.5vw + 1rem, 2.5rem); /* 30–40px */
  --shafa-fs-h2:      clamp(1.4rem, 1.8vw + 0.8rem, 1.85rem); /* 22–30px */
  --shafa-fs-h3:      clamp(1.1rem, 0.5vw + 0.9rem, 1.25rem); /* 17.6–20px — fluid so h2→h3 keeps a visible step on small screens */
  --shafa-fs-body:    1rem;     /* 16px */
  --shafa-fs-sm:      0.875rem; /* 14px */
  --shafa-fs-caption: 0.75rem;  /* 12px */

  /* Optical sizing tokens for different text sizes */
  --shafa-tracking-tight:    0;          /* Large headings — Persian needs 0 */
  --shafa-tracking-normal:   0;          /* Body text — Persian needs 0 (negative tracking breaks glyph joining) */
  --shafa-tracking-wide:     0.02em;     /* Small caps, UI labels */
  --shafa-tracking-wider:    0.05em;     /* Eyebrow, uppercase */

  /* Leading (line-height) tokens — Persian optical rhythm */
  --shafa-lh-tight:   1.25;
  --shafa-lh-heading: 1.4;
  --shafa-lh-body:    1.8; /* Optimized for Persian optical rhythm */
  --shafa-lh-caption: 1.6;

  /* ===================================================================
   * 7. SPACING SCALE (8pt Grid System)
   *    Source: DESIGN_SYSTEM.md §4
   * =================================================================== */
  --shafa-space-2xs: 0.25rem; /* 4px */
  --shafa-space-xs:  0.5rem;  /* 8px */
  --shafa-space-sm:  0.75rem; /* 12px */
  --shafa-space-md:  1rem;    /* 16px */
  --shafa-space-lg:  1.5rem;  /* 24px */
  --shafa-space-xl:  2rem;    /* 32px */
  --shafa-space-2xl: 3rem;    /* 48px */
  --shafa-space-3xl: 4.5rem;  /* 72px */
  --shafa-space-4xl: 6rem;    /* 96px */

  /* ===================================================================
   * 8. LAYOUT GEOMETRY
   *    Source: DESIGN_SYSTEM.md §4
   * =================================================================== */
  --shafa-container-max:    1240px;
  --shafa-container-narrow:  840px;

  /* فرم‌های تک‌ستونی ۵۱۲px و فرم‌های چندستونی عرض ظرف باریک را می‌گیرند.
     به‌جای عدد جادویی 32rem مستقیم در forms.css تعریف شده است. */
  --shafa-form-width:      32rem;
  --shafa-form-width-wide: var(--shafa-container-narrow);

  --shafa-radius-sm:   4px;
  --shafa-radius-md:   8px;
  --shafa-radius-lg:   12px;
  --shafa-radius-xl:   20px;   /* کارت‌ها و سطوح بزرگ */
  --shafa-radius-2xl:  24px;   /* رسانهٔ hero و پنل‌های بزرگ */
  --shafa-radius-full: 9999px;
  --shafa-radius-pill: var(--shafa-radius-full);

  /* ===================================================================
   * 9. MOTION TOKENS
   *    Source: DESIGN_SYSTEM.md §7
   * =================================================================== */
  --shafa-ease-natural:   cubic-bezier(0.16, 1, 0.3, 1); /* Elegant decelerate */
  --shafa-duration-fast:  150ms;
  --shafa-duration-base:  250ms;
  --shafa-duration-slow:  400ms;

  /* Spring timing (for GSAP) */
  --shafa-spring-stiffness: 170;
  --shafa-spring-damping:   26;
  --shafa-spring-mass:      1;

  /* ===================================================================
   * 10. REDUCED MOTION TOKENS
   * =================================================================== */
  --shafa-reduced-duration: 0.001ms;
  --shafa-reduced-ease:     none;

  /* ===================================================================
  /* ===================================================================
   * 11. GLASS & SHADOWS (Organic Luxury)
   * =================================================================== */
  --shafa-glass-bg:     rgba(255, 255, 255, 0.82);
  --shafa-glass-border: rgba(197, 160, 89, 0.22);
  --shafa-glass-shadow: 0 12px 36px -4px rgba(24, 22, 20, 0.08);
  --shafa-glass-blur:   20px;

  --shafa-shadow-sm:   0 2px 8px -2px rgba(24, 22, 20, 0.04),
                       0 1px 3px rgba(24, 22, 20, 0.02);
  --shafa-shadow-md:   0 8px 24px -4px rgba(24, 22, 20, 0.05),
                       0 2px 6px -1px rgba(197, 160, 89, 0.06);
  --shafa-shadow-lg:   0 20px 40px -10px rgba(24, 22, 20, 0.08),
                       0 8px 16px -4px rgba(197, 160, 89, 0.08);
  --shafa-shadow-hover: 0 24px 48px -12px rgba(197, 160, 89, 0.20),
                        0 8px 20px -4px rgba(24, 22, 20, 0.06);
  --shafa-shadow-gold: 0 8px 30px -4px rgba(197, 160, 89, 0.35);
  --shafa-shadow-emerald: 0 8px 26px -4px rgba(22, 43, 33, 0.32);

  /* ===================================================================
   * 11b. DERIVED SURFACES — the only place components may read a
   *      background from. Every value here has a dark counterpart, which
   *      is what makes component-level dark mode possible without adding
   *      per-component dark blocks. Rule: if a component needs a
   *      background, it takes a token from here — never a raw hex.
   * =================================================================== */
  --shafa-card-bg:         linear-gradient(180deg, #FFFFFF 0%, #FAF8F5 100%);
  --shafa-panel-bg:        linear-gradient(135deg, #FFFFFF 0%, #FAF8F5 100%);
  --shafa-panel-bg-deep:   linear-gradient(135deg, #FFFFFF 0%, #FAF8F5 50%, #F5F1E8 100%);
  --shafa-media-bg:        radial-gradient(circle at 50% 45%, #FFFFFF 30%, #F5EFE4 100%);
  --shafa-nav-bg:          rgba(250, 248, 245, 0.82);
  --shafa-nav-bg-filled:   rgba(255, 255, 255, 0.92);
  --shafa-input-bg:        rgba(255, 255, 255, 0.70);
  --shafa-input-bg-strong: #FFFFFF;
  /* رنگ ماتِ معادلِ --shafa-input-bg روی canvas، برای پوشاندن border زیر لیبل شناور.
     محاسبهٔ روشن: 0.70*255 + 0.30*(250,248,245) = (253.5, 252.9, 252) -> #FEFDFC
     محاسبهٔ تیره: در §14 با نام --shafa-dk-field-mask تعریف شده (#213E3C).
     هر دو رنگ فقط یک‌بار تعریف می‌شوند و هر دو مسیر تم یک‌خط map می‌کنند. */
  --shafa-field-mask-light: #FEFDFC;
  --shafa-field-mask-dark:  var(--shafa-dk-field-mask);

  /* --- هیرو صفحهٔ خانه -------------------------------------------------
     هیرو پیش از این شش رنگ هاردکد داشت و هیچ‌کدام تم تاریک را نمی‌دید:
     زمینهٔ #FAF8F5، یک لکهٔ سفید rgba(255,252,245,.8)، پردهٔ
     rgba(250,248,245,.98)، و متن #4A4640. نتیجه در تم تاریک دو باگ جدا:
       ۱) متن‌هایی که از توکن می‌آمدند (تیتر، متن توضیحی) روشن شدند و
          روی زمینهٔ روشنِ قفل‌شده نامرئی شدند.
       ۲) متن #4A4640 اگر زمینه را تیره می‌کردیم خودش تیره می‌ماند و
          ناخوانا می‌شد.
     پس کل پالت هیرو توکن شد تا هر دو با هم بچرخند. */
  --shafa-hero-base:        #FAF8F5;              /* زمینهٔ پایه */
  --shafa-hero-bloom:       rgba(255, 252, 245, 0.80);  /* لکهٔ روشن وسط */
  --shafa-hero-bloom-soft:  rgba(255, 252, 245, 0.15);  /* لکهٔ گوشه */
  --shafa-hero-scrim:       250, 248, 245;        /* RGB پردهٔ گرادیانی */
  --shafa-hero-sub:         #4A4640;              /* متن زیر تیتر */
  --shafa-hero-pill-bg:     linear-gradient(135deg, rgba(255, 255, 255, 0.95) 0%, rgba(252, 248, 240, 0.85) 100%);
  --shafa-hero-pill-ring:   rgba(255, 255, 255, 0.95);

  /* --- نوار اعتماد هیرو ------------------------------------------------
     شش آیتم (آزمایشگاهی / رهگیری / زنبوردار / ارسال). این پنل پیش از
     این سه رنگ هاردکد داشت و هیچ‌کدام تم تاریک را نمی‌دید:
       گرادیان rgba(255,255,255,.95) → rgba(250,248,245,.92)
       حلقهٔ داخلی rgba(255,255,255,.95)
       هالهٔ بالای پنل rgba(223,190,122,.16)
     متن‌های هر شش آیتم از --shafa-text-primary و --shafa-text-tertiary
     می‌آمدند، پس در تم تاریک روشن می‌شدند و روی این پنلِ قفل‌شدهٔ روشن
     عملاً نامرئی می‌شدند — همان باگ هیرو، اینجا تکرار شده بود. */
  --shafa-hero-trust-bg:    linear-gradient(135deg, rgba(255, 255, 255, 0.95) 0%, rgba(250, 248, 245, 0.92) 100%);
  --shafa-hero-trust-ring:  rgba(255, 255, 255, 0.95);
  --shafa-hero-trust-halo:  rgba(223, 190, 122, 0.16);
  --shafa-hero-trust-shadow: 0 4px 16px rgba(24, 22, 20, 0.04);
  --shafa-hero-trust-shadow-gold: 0 24px 60px -10px rgba(197, 160, 89, 0.16);
  /* جایگزین مات در موبایل: آنجا backdrop-filter خاموش می‌شود و بدون یک
     رنگ ماتِ توکن‌شده، پنل شفاف می‌ماند. */
--shafa-hero-trust-bg-matte:  rgba(252, 250, 247, 0.96);
  --shafa-field-mask-bg:    var(--shafa-field-mask-light);
  --shafa-icon-btn-bg:     rgba(255, 255, 255, 0.75);
  --shafa-glass-panel-bg:  rgba(255, 255, 255, 0.65);
  --shafa-surface-veil:      rgba(255, 255, 255, 0.90);
  --shafa-surface-veil-soft: rgba(255, 255, 255, 0.78);
  --shafa-inset-ring:      rgba(255, 255, 255, 0.95);

  /* --- Lead Magnet (راهنمای ۵ دقیقه‌ای تشخیص عسل واقعی) -------------------
     دو فرم: کارت کامل (.lead-magnet) و خطی (.lead-magnet-inline).
     همه رنگ‌ها باید در هر دو تم کار کنند تا exit-intent و inline در فوتر
     هم در تم تاریک خوانا بمانند. */
  --shafa-lm-bg:           linear-gradient(135deg, #FFFFFF 0%, #FFFDF7 100%);
  --shafa-lm-bg-alt:       linear-gradient(135deg, #FAF8F5 0%, #F5F1E8 100%);
  --shafa-lm-accent:       var(--shafa-gold-text);
  --shafa-lm-accent-hover: var(--shafa-gold-hover);
  --shafa-lm-badge-bg:     rgba(var(--shafa-gold-text-rgb), 0.12);
  --shafa-lm-badge-border: rgba(var(--shafa-gold-text-rgb), 0.35);
  --shafa-lm-sub:          var(--shafa-text-tertiary);
  --shafa-lm-hint:         var(--shafa-text-tertiary);
  --shafa-lm-ring:         rgba(255, 255, 255, 0.95);
  --shafa-lm-shadow:       0 4px 16px rgba(24, 22, 20, 0.06);
  --shafa-lm-shadow-lg:    0 24px 48px -12px rgba(197, 160, 89, 0.18);
  /* Toast tones — must work in both themes */
  --shafa-lm-toast-bg:        var(--shafa-surface-dark);
  --shafa-lm-toast-success:   var(--shafa-green-alpine);
  --shafa-lm-toast-error:     var(--shafa-status-error);
  --shafa-lm-toast-text:      var(--shafa-on-dark-surface);
  --shafa-hairline:        rgba(232, 226, 213, 0.85);
  --shafa-hairline-soft:   rgba(232, 226, 213, 0.60);

  /* ===================================================================
   * 12. FOCUS VISIBLE STYLES (Accessibility)
   * =================================================================== */
  --shafa-focus-ring:        0 0 0 3px var(--shafa-border-focus);
  --shafa-focus-ring-inset:  inset 0 0 0 3px var(--shafa-border-focus);
  /* هالهٔ focus برای سطوحی که با --shafa-border-focus هم‌رنگ‌اند.
     #C5A059 دقیقاً وسطِ --shafa-gold-gradient است (stop 50%)، پس outline طلایی
     روی دکمهٔ طلایی عملاً نامرئی می‌شود. این هالهٔ تیره تضاد لازم را می‌دهد. */
  --shafa-focus-halo-light: #0E1512;
  --shafa-focus-halo-dark:  var(--shafa-dk-focus-halo); /* #0B1818 — تیرهٔ نفتی */
  --shafa-focus-halo:       var(--shafa-focus-halo-light);

  /* ===================================================================
   * 12. Z-INDEX SCALE
   * =================================================================== */
  --shafa-z-base:   1;
  --shafa-z-nav:    100;
  --shafa-z-toast:  1100;
  --shafa-z-drawer: 1200;
  --shafa-z-modal:  1300;
  --shafa-z-skip:   9999;

  /* ===================================================================
   * 13. TOUCH TARGET MINIMUMS (WCAG 2.5.5)
   * =================================================================== */
  --shafa-touch-sm: 40px;
  --shafa-touch:    44px;
  --shafa-touch-lg: 48px;

  /* ===================================================================
   * BACKWARD-COMPAT ALIASES
   * Maps legacy token names → new --shafa-* values.
   * Existing templates use these; migrate in later phases.
   * Do NOT introduce new code referencing these alias names.
   * =================================================================== */

  /* Canvas / background */
  --bg:            var(--shafa-canvas);
  --surface:       var(--shafa-surface-card);
  --surface-2:     var(--shafa-surface-muted);
  --surface-alt:   var(--shafa-surface-muted);

  /* Text */
  --text:          var(--shafa-text-primary);
  --text-soft:     var(--shafa-text-secondary);
  --muted:         var(--shafa-text-tertiary);

  /* Borders */
  --border:        var(--shafa-border-subtle);
  --border-strong: var(--shafa-border-strong);

  /* Accent (primary interactive color) — mapped to Gold Satin per brand */
  --accent:        var(--shafa-gold-satin);
  --accent-strong: var(--shafa-gold-hover);
  --accent-soft:   var(--shafa-gold-subtle);
  --accent-2:      var(--shafa-honey-amber);
  --secondary:     var(--shafa-green-alpine);
  --secondary-container: var(--shafa-green-soft);
  /* Third brand hue for .feature-card--tertiary. Was referenced in
   * style.css but never declared, so the variant rendered unstyled. */
  --tertiary:     var(--accent-2);
  --tertiary-container: var(--accent-2);
  --honey-deep:    var(--shafa-border-subtle);

  /* Feedback */
  --danger:        var(--shafa-status-error);
  --success:       var(--shafa-status-success);
  --info:          var(--shafa-status-info);

  /* On-accent text — جوهرِ سطح اکسنت. قبلاً #FFFFFF بود و با هر دو تم
     می‌افتاد زیر حد AA (روی طلای روشن ۲.۳۲:۱، و در تم تاریکِ شنی
     فقط ۱.۸۱:۱). حالا از --shafa-on-gold می‌خواند تا خودکار بچرخد:
     #111412 روی #C5A059 → ۷.۵۵:۱ · #1A3636 روی #D6BD98 → ۷.۲۱:۱. */
  --on-accent:       var(--shafa-on-gold);
  --on-accent-strong: var(--shafa-on-gold);
  /* جوهرِ سطوحِ پررنگ (بَج موجودی، بَج آزمایشگاه، تیک چک‌باکس، حالت فعال
     برند). این سطوح در تم روشن تیره‌اند و متن سفید می‌خواهند، ولی در تم
     تاریک روشن می‌شوند (#8FC0A6 / #E0928C / #D6BD98) و متن سفید رویشان
     می‌افتد: ۲.۰۵:۱ تا ۲.۱:۱. پس جوهر باید با تم بچرخد:
     #FFFFFF در روشن · #1A3636 در تاریک (۵.۳:۱ تا ۶.۵:۱).
     توجه: این توکن برای گرادیان‌های تیره مثل --shafa-green-gradient نیست؛
     آن‌ها در هر دو تم تیره می‌مانند و #FFFFFF درست است. */
  --on-strong:        #FFFFFF;

  /* Typography */
  --fs-hero:    var(--shafa-fs-hero);
  --fs-h1:      var(--shafa-fs-h1);
  --fs-h2:      var(--shafa-fs-h2);
  --fs-h3:      var(--shafa-fs-h3);
  --fs-body:    var(--shafa-fs-body);
  --fs-small:   var(--shafa-fs-sm);
  --fs-sm:      var(--shafa-fs-sm);
  --fs-caption: var(--shafa-fs-caption);
  --fs-display: clamp(3rem, 6vw, 5rem);
  --lh-base:    var(--shafa-lh-body);
  --lh-tight:   var(--shafa-lh-tight);
  --lh-heading: var(--shafa-lh-heading);
  --lh-caption: var(--shafa-lh-caption);

  /* Spacing — legacy short names */
  --s-1: var(--shafa-space-2xs);  /* 4px */
  --s-2: var(--shafa-space-xs);   /* 8px */
  --s-3: var(--shafa-space-md);   /* 16px */
  --s-4: var(--shafa-space-lg);   /* 24px */
  --s-5: var(--shafa-space-xl);   /* 32px */
  --s-6: var(--shafa-space-2xl);  /* 48px */
  --s-7: var(--shafa-space-3xl);  /* 72px */
  --s-8: var(--shafa-space-4xl);  /* 96px */
  --s-9: clamp(2.5rem, 4.5vw, 4.5rem); /* Extra large grid gap */
  --space-section: clamp(3rem, 7vw, 6rem);

  /* Layout */
  --container:  var(--shafa-container-max);
  --nav-height: 72px;

  /* Radii — هر alias به یک توکن canonical اشاره می‌کند (پیش از این
     --radius-lg مقدار ۲۰ را hardcode داشت و با --shafa-radius-lg=12px
     نام‌گذاری متناقض داشت). */
  --radius-sm:   var(--shafa-radius-md);
  --radius-md:   var(--shafa-radius-lg);
  --radius:      var(--shafa-radius-lg);
  --radius-lg:   var(--shafa-radius-xl);
  --radius-xl:   var(--shafa-radius-2xl);
  --radius-pill: var(--shafa-radius-full);

  /* Motion */
  --ease:   var(--shafa-ease-natural);
  --t-fast: var(--shafa-duration-fast);
  --t-base: var(--shafa-duration-base);
  --t-slow: var(--shafa-duration-slow);

  /* Glass */
  --glass-bg:     var(--shafa-glass-bg);
  --glass-border: var(--shafa-glass-border);
  --glass-shadow: var(--shafa-glass-shadow);
  --glass-blur:   var(--shafa-glass-blur);

  /* Shadows */
  --shadow:        var(--shafa-shadow-md);
  --shadow-accent: 0 8px 24px rgba(197, 160, 89, 0.14); /* Gold-tinted lift */
  --shadow-hover:  var(--shafa-shadow-hover);
  --shadow-card:   var(--shafa-shadow-sm);
  --shadow-toast:  0 8px 32px rgba(0, 0, 0, 0.12);
  --shadow_overlay: rgba(24, 22, 20, 0.45);

  /* Focus ring — Deep Antique Gold per brand.
     WCAG 2.2 SC 1.4.11 Non-text Contrast requires >= 3:1 for a focus indicator.
     Satin Gold (#C5A059) measures only 2.32:1 on --shafa-canvas and 2.46:1 on
     white, so it must not be used for focus. --shafa-gold-text (#8A641A) is
     5.06:1 on #FAF8F5 and 5.36:1 on #FFFFFF. Error ring at 0.55 alpha keeps
     the soft brand feel and still clears 3:1. */
  --focus-ring:       0 0 0 3px var(--shafa-gold-text);
  --focus-ring-error: 0 0 0 3px rgba(158, 42, 43, 0.55);

  /* RGB channels (for rgba() composition) */
  --accent-rgb:        197, 160, 89;   /* Satin Gold */
  --accent-strong-rgb: 179, 141, 69;
  --success-rgb:       27, 94, 54;
  --danger-rgb:        158, 42, 43;
  --info-rgb:          15, 107, 114; /* #0F6B72 */
  --bg-rgb:            250, 248, 245; /* must match --shafa-canvas (#FAF8F5) */
  --text-rgb:          24, 22, 20;
  --border-strong-rgb: 120, 113, 108;
  --white-rgb:         255, 255, 255;

  /* Derived soft backgrounds */
  --accent-soft-bg:      rgba(var(--accent-rgb), 0.10);
  --success-soft-bg:     rgba(var(--success-rgb), 0.10);
  --danger-soft-bg:      rgba(var(--danger-rgb), 0.10);
  --info-soft-bg:        rgba(var(--info-rgb), 0.10);
  --accent-soft-border:  rgba(var(--accent-rgb), 0.25);
  --success-soft-border: rgba(var(--success-rgb), 0.25);
   --danger-soft-border:  rgba(var(--danger-rgb), 0.25);
   --info-soft-border:    rgba(var(--info-rgb), 0.25);

  /* Surface RGB channels */
  --shafa-surface-dark-rgb: 17, 20, 18; /* #111412 */

  /* Brand Accent RGB channels */
  --shafa-gold-satin-rgb: 197, 160, 89;   /* #C5A059 */
  --shafa-gold-hover-rgb:   179, 141, 69; /* #B38D45 */
  --shafa-green-alpine-rgb: 22, 43, 33;   /* #162B21 */
  --shafa-honey-amber-rgb:  140, 74, 21;  /* #8C4A15 */

  /* Font stacks */
  --font-body:    'Vazirmatn', 'Inter', system-ui, sans-serif;
  --font-display: 'Vazirmatn', 'Inter', system-ui, sans-serif;
  /* NOTE: Playfair Display removed — not in approved brand type spec. */
  /* NOTE: --neon, --neon-bright, --neon-glow removed — brand anti-pattern. */

  /* Z-index aliases */
  --z-base:     var(--shafa-z-base);
  --z-particle: 50; /* kept for JS that references it; no new CSS should use this */
  --z-nav:      var(--shafa-z-nav);
  --z-toast:    var(--shafa-z-toast);
  --z-drawer:   var(--shafa-z-drawer);
  --z-modal:    var(--shafa-z-modal);
  --z-skip:     var(--shafa-z-skip);

  /* Touch target aliases */
  --touch:    var(--shafa-touch);
  --touch-lg: var(--shafa-touch-lg);
  --touch-sm: var(--shafa-touch-sm);

  /* Missing backward-compat aliases for admin/components */
  --error-dark:      var(--shafa-status-error); /* darker variant, use error with opacity */
  --font-mono:       'JetBrains Mono', 'Fira Code', monospace;
  --fs-base:         var(--shafa-fs-body);
  --fs-lg:           var(--shafa-fs-h3);
  --on-error:        #FFFFFF;
  --on-primary:      var(--shafa-on-gold);
  --primary-bg:      rgba(var(--accent-rgb), 0.10);
  --primary-light:   rgba(var(--accent-rgb), 0.20);
  --shadow-md:       var(--shafa-shadow-md);
  --shadow-sm:       var(--shafa-shadow-sm);
  --shadow-xl:       var(--shafa-shadow-lg);
  --surface-3:       var(--shafa-panel-bg-deep);
  --transition-fast: var(--shafa-duration-fast);
  --warning:         var(--shafa-status-warning);
  --warning-bg:      var(--danger-soft-bg); /* Use danger soft bg for warning */

  /* Paper texture — kept but neutral */
  --paper-texture: none;

  /* ===================================================================
   * Landing-page semantic aliases — landing.css نوشته شده برخلاف
   * نام‌گذاریٔ --color-* / --font-size-* / --spacing-* / --shadow-*؛
   * این aliasها به توکن‌های --shafa-* اشاره می‌کنند و مقادیرشان در
   * هر دو تم با بلوک تیره rotate می‌شوند.
   * =================================================================== */
  --color-primary:            var(--shafa-gold-satin);
  --color-primary-variant:    var(--shafa-gold-hover);
  --color-on-primary:         var(--shafa-on-gold);
  --color-on-primary-variant: var(--shafa-on-gold);
  --color-success:            var(--shafa-status-success);
  --color-background:         var(--shafa-canvas);
  --color-background-muted:   var(--shafa-surface-muted);
  --color-surface:            var(--shafa-surface-card);
  --color-border:             var(--shafa-border-subtle);
  --color-border-muted:       var(--shafa-border-subtle);
  --color-text-primary:       var(--shafa-text-primary);
  --color-text-secondary:     var(--shafa-text-secondary);
  --color-text-body:          var(--shafa-text-primary);
  --color-text-muted:         var(--shafa-text-tertiary);
  --color-text-heading:       var(--shafa-text-primary);

  --font-family-primary:    var(--font-body);
  --font-family-fallback:   system-ui, sans-serif;

  --font-size-2xl:          var(--shafa-fs-h2);
  --font-size-3xl:          var(--shafa-fs-h1);
  --font-size-4xl:          clamp(2.25rem, 4.5vw, 3.75rem);
  --font-size-5xl:          clamp(1.75rem, 3vw, 2.5rem);
  --font-size-6xl:          clamp(2rem, 4vw, 3rem);
  --font-size-xl:           var(--shafa-fs-h3);
  --font-size-lg:           var(--shafa-fs-h3);
  --font-size-base:         var(--shafa-fs-body);
  --font-size-sm:           var(--shafa-fs-sm);

  --font-weight-bold:       700;
  --font-weight-semibold:   600;
  --font-weight-medium:     500;

  --line-height-body:       var(--shafa-lh-body);
  --line-height-copy:       var(--shafa-lh-body);
  --letter-spacing-wide:    var(--shafa-tracking-wide);

  --container-max-width:    var(--shafa-container-max);

  --duration-fast:          var(--shafa-duration-fast);

  --shadow-lg:              var(--shafa-shadow-lg);

  --spacing-1:              var(--s-1);
  --spacing-2:              var(--s-2);
  --spacing-3:              var(--s-3);
  --spacing-4:              var(--s-4);
  --spacing-5:              var(--s-5);
  --spacing-6:              var(--s-6);
  --spacing-8:              var(--s-8);
  --spacing-10:             var(--space-section);
  --spacing-12:             var(--space-section);

  --radius-full:            var(--shafa-radius-full);

  --input-bg:               var(--shafa-input-bg);

  /* ===================================================================
   * 14. RAW DARK PALETTE
   * Declared once and referenced by both dark application paths below,
   * so every dark hex value lives in exactly one place.
   * =================================================================== */
  /* --- پالت پایهٔ تاریک (انتخاب‌شده توسط طراح) -------------------------
     پنج رنگ مرجع، از روشن‌ترین (متن) تا تیره‌ترین (زمینه):
       Text       #F4EEE0  → --shafa-dk-text-primary
       Accent     #D6BD98  → --shafa-dk-accent-sand
       Secondary  #677D6A  → --shafa-dk-brand-secondary
       Primary    #40534C  → --shafa-dk-brand-primary
       Background #1A3636  → --shafa-dk-canvas
     بقیهٔ سطوح از فاصلهٔ همین پنج رنگ روی محور روشنایی مشتق شده‌اند تا
     نردبان سطوح (canvas < muted < card < elevated) حفظ شود. هر مقدار با
     نسبت کنتراستش روی canvas و card سنجیده شده (WCAG 2.2):
       متن اصلی   #F4EEE0 → 11.17:1 (canvas) · 9.42:1 (card)
       متن ثانویه #D3CCBC →  8.08:1 · 6.82:1
       متن سوم    #BDB7A8 →  6.05:1 · 5.45:1
       اکسنت      #D6BD98 →  7.13:1 · 6.02:1  (روی این، متن تیره #1A3636 → 7.2:1)
       مرکز ثانویه #A8BEAE →  6.55:1 · 5.52:1
     نکته: #677D6A و #40534C رنگ «سطح» هستند نه رنگ متن؛ متن روشن روی
     #40534C می‌دهد 7.09:1 ولی متن تیره فقط 1.58:1، پس هر جا این دو به
     عنوان پس‌زمینه می‌آیند باید متن روشن بنشیند. */
  --shafa-dk-canvas:          #1A3636; /* Background — سبز-نفتی عمیق */
  --shafa-dk-surface-muted:   #1E3A39;
  --shafa-dk-surface-card:    #24423F;
  --shafa-dk-surface-elevated:#2C4D49;
  --shafa-dk-surface-dark:    #12292B; /* فوتر/بلوک‌های فرورفته */
  --shafa-dk-brand-primary:   #40534C; /* Primary */
  --shafa-dk-brand-secondary: #677D6A; /* Secondary */
  --shafa-dk-accent-sand:     #D6BD98; /* Accent — شنی گرم */
  --shafa-dk-text-primary:    #F4EEE0; /* Text — کرم گرم */
  --shafa-dk-text-secondary:  #D3CCBC;
  --shafa-dk-text-tertiary:   #BDB7A8;
  --shafa-dk-border-subtle:   #33514D; /* 1.49:1 روی canvas */
  --shafa-dk-border-strong:   #677D6A; /* Secondary — 2.90:1 روی canvas */
  --shafa-dk-border-focus:    #D6BD98; /* اکسنت به‌عنوان focus: 7.13:1 */
  --shafa-dk-emerald-ink:     #A8BEAE; /* 5.52:1 روی --shafa-dk-surface-card */
  --shafa-dk-gold-text:       #D6BD98; /* 6.02:1 روی --shafa-dk-surface-card */
  --shafa-dk-status-success:  #8FC0A6; /* 5.33:1 روی card */
  --shafa-dk-status-warning:  #D9A85E; /* 5.04:1 روی card */
  --shafa-dk-status-error:    #E59C96; /* 4.95:1 روی card · 5.86:1 روی canvas
     مقدار قبلی #E0928C بود و کامنتش «4.50:1» می‌گفت — ولی محاسبهٔ دقیق
     ۴٫۴۹۶:۱ است، یعنی ۰٫۰۰۴ زیر حد AA. نگهبان
     tests/unit/ColorContrastTest.php این را گرفت. */
  --shafa-dk-status-info:     #7FC4C9; /* 5.53:1 روی card · 6.55:1 روی canvas */
  /* هالهٔ focus پشت اکسنت: باید از اکسنت روشن‌تر تیره باشد تا حلقهٔ
     focus روی دکمهٔ شنی گم نشود (همان نقشی که #050A08 داشت). */
  --shafa-dk-focus-halo:      #0B1818;
  /* ماتِ هم‌رنگِ ورودی روی canvas: 0.70*(36,66,63) + 0.30*(26,54,54)
     = (33, 62, 60) — لکهٔ تیره پشت لیبل شناور را می‌پوشاند. */
  --shafa-dk-field-mask:      #213E3C;

  /* کانال‌های RGB پالت تاریک — برای rgba() هایی که رنگ را با شفافیت
     می‌خواهند و نباید هگزِ خام را تکرار کنند. */
  --shafa-dk-canvas-rgb:        26, 54, 54;   /* #1A3636 */
  --shafa-dk-surface-muted-rgb: 30, 58, 57;   /* #1E3A39 */
  --shafa-dk-surface-card-rgb:  36, 66, 63;   /* #24423F */
  --shafa-dk-brand-primary-rgb: 64, 83, 76;   /* #40534C */
  --shafa-dk-brand-secondary-rgb: 103, 125, 106; /* #677D6A */
  --shafa-dk-accent-sand-rgb:   214, 189, 152; /* #D6BD98 */
  --shafa-dk-emerald-ink-rgb:   168, 190, 174; /* #A8BEAE */
  --shafa-dk-border-subtle-rgb: 51, 81, 77;   /* #33514D */
  --shafa-dk-text-primary-rgb:  244, 238, 224;  /* #F4EEE0 */
  /* کانال RGB طلای متن در تم تاریک — جفتِ --shafa-dk-gold-text (#D6BD98).
     تا ۲۰۲۶-۹ تعریف نشده بود و --shafa-gold-text-rgb در تم تاریک بی‌مصرف می‌ماند. */
  --shafa-dk-gold-text-rgb:     214, 189, 152;  /* #D6BD98 */
}

/* ===================================================================
 *  DARK MODE VARIANT — single source of truth
 *  -------------------------------------------------------------------
 *  Brand rule (DESIGN_SYSTEM.md §1 "Quiet Luxury"): dark mode is NOT a
 *  site-wide inversion. It re-pigments surfaces, text and hairlines onto
 *  the dark palette in §14 (petrol-teal surfaces, warm sand accent,
 *  cream text) while keeping the same token roles as the light theme.
 *
 *  That palette replaced the earlier warm-forest dark set (#0E1512 canvas
 *  with #E0C078 gold focus). The three dark blocks this file once carried
 *  are now the two application paths below, which share one set of raw
 *  values (--shafa-dk-*) declared once in :root:
 *
 *    1. :root[data-theme="dark"]              → user/JS choice
 *    2. @media (prefers-color-scheme: dark)
 *       :root:not([data-theme])               → no-JS / pre-script fallback
 *
 *  The inline head script (includes/header.php) always sets
 *  data-theme="light|dark" before first paint, so path 2 only applies
 *  when JavaScript is unavailable.
 * =================================================================== */

/* Path 1 — explicit user / JS choice */
:root[data-theme="dark"] {
  color-scheme: dark;

  /* Surfaces */
  --shafa-canvas:           var(--shafa-dk-canvas);
  --shafa-surface-card:     var(--shafa-dk-surface-card);
  --shafa-surface-muted:    var(--shafa-dk-surface-muted);
  --shafa-surface-elevated: var(--shafa-dk-surface-elevated);
  --shafa-surface-dark:     var(--shafa-dk-surface-dark);
  --shafa-surface-glass:        rgba(var(--shafa-dk-surface-card-rgb), 0.72);
  --shafa-surface-glass-border: rgba(var(--shafa-dk-accent-sand-rgb), 0.22);
  --shafa-surface-card-border:  rgba(var(--shafa-dk-accent-sand-rgb), 0.16);

  /* Text */
  --shafa-text-primary:   var(--shafa-dk-text-primary);
  --shafa-text-secondary: var(--shafa-dk-text-secondary);
  --shafa-text-tertiary:  var(--shafa-dk-text-tertiary);
  --shafa-text-faint:     #7E8A84; /* فقط آیکون/خط تزئینی — نه متن خوانا */
  --shafa-text-inverse:   var(--shafa-dk-canvas);

  /* Borders */
  --shafa-border-subtle: var(--shafa-dk-border-subtle);
  --shafa-border-strong: var(--shafa-dk-border-strong);
  --shafa-border-dark:   var(--shafa-dk-border-subtle);
  --shafa-border-focus:  var(--shafa-dk-border-focus);
  --shafa-focus-halo:    var(--shafa-focus-halo-dark);

  /* Accents — the dark palette's accent is warm sand (#D6BD98), so the whole
     gold family (surface, text, gradients, halos) rotates onto that hue. */
  --shafa-gold-satin:   var(--shafa-dk-accent-sand);
  --shafa-gold-glow:    rgba(var(--shafa-dk-accent-sand-rgb), 0.28);
  --shafa-gold-gradient:       linear-gradient(135deg, #E6D0B2 0%, #D6BD98 50%, #C4A87F 100%);
  --shafa-gold-gradient-hover: linear-gradient(135deg, #F0DCC2 0%, #E2CBA8 50%, #D2B78E 100%);
  --shafa-gold-gradient-soft:  linear-gradient(135deg, rgba(214, 189, 152, 0.18) 0%, rgba(214, 189, 152, 0.06) 100%);
  --shafa-gold-hover:     var(--shafa-dk-accent-sand);
  --shafa-gold-text:      var(--shafa-dk-gold-text);
  --shafa-gold-text-rgb:  var(--shafa-dk-gold-text-rgb);
  --shafa-gold-subtle:    #2B3F3B;
  /* تم تاریک: زمینه تیره است، پس گرادیانِ متن باید روشن باشد. اما نمی‌توان
     همان --shafa-gold-gradient عمومی را گذاشت: تیره‌ترین stop آن (#9F7E3B)
     روی سبک‌ترین سطح تیره (#2C4D49) فقط حدود 2.9:1 می‌دهد و متن 16px
     (مثل .about-panel__badge b) حد 4.5:1 می‌خواهد. با اکسنت شنی پالت
     تیره: #D6BD98 → 5.12:1 و #E6D0B2 → 6.19:1، پس همین دو stop مجازند.
     نسخهٔ ثابت عمداً دست‌نخورده می‌ماند — بخش‌هایی که در تم تاریک هم
     روشن‌اند به آن نیاز دارند. */
  --shafa-gold-gradient-text: linear-gradient(135deg, #E6D0B2 0%, #D6BD98 50%, #D6BD98 100%);
  --shafa-honey-amber:    #D2B183;
  --shafa-green-alpine:   var(--shafa-dk-emerald-ink);
  --shafa-emerald-ink:    var(--shafa-dk-emerald-ink);
  --shafa-green-hover:    #8CA894;
  --shafa-green-soft:     #223B38;
  --shafa-green-gradient: linear-gradient(135deg, #40534C 0%, #2F4741 100%);
  --shafa-green-gradient-hover: linear-gradient(135deg, #4A6058 0%, #354F48 100%);
  --shafa-on-gold:        var(--shafa-dk-canvas);
  --shafa-on-emerald:     var(--shafa-dk-canvas);
  --shafa-on-dark-surface: var(--shafa-dk-text-primary);
  --shafa-honey-glow:     rgba(210, 177, 131, 0.22);
  /* RGB channels for the accent hues — required so rgba(var(--shafa-*-rgb), α)
     compositions rotate in dark mode. Without these, every gold/green/honey
     rgba() in the component layer stays on the light palette and reads as a
     foreign color against the petrol-teal dark canvas. */
  --shafa-gold-satin-rgb:   214, 189, 152; /* #D6BD98 — dark accent sand */
  --shafa-gold-hover-rgb:   214, 189, 152; /* same as satin in dark mode */
  --shafa-green-alpine-rgb: 168, 190, 174; /* #A8BEAE — dark emerald ink */
  --shafa-honey-amber-rgb:  210, 177, 131; /* #D2B183 — dark honey */
  --shafa-emerald-tint-bg:     rgba(var(--shafa-dk-emerald-ink-rgb), 0.14);
  --shafa-emerald-tint-border: rgba(var(--shafa-dk-emerald-ink-rgb), 0.30);
  --shafa-brand-primary:   var(--shafa-dk-brand-primary);
  --shafa-brand-secondary: var(--shafa-dk-brand-secondary);
  --on-strong:        var(--shafa-dk-canvas);

  /* Status — brighter but not neon (brand bans neon glows) */
  --shafa-status-success: var(--shafa-dk-status-success);
  --shafa-status-warning: var(--shafa-dk-status-warning);
  --shafa-status-error:   var(--shafa-dk-status-error);
  --shafa-status-info:    var(--shafa-dk-status-info);

  /* Shadows */
  --shafa-shadow-sm:    0 1px 2px rgba(0, 0, 0, 0.40), 0 1px 4px rgba(0, 0, 0, 0.20);
  --shafa-shadow-md:    0 4px 12px rgba(0, 0, 0, 0.35);
  --shafa-shadow-lg:    0 12px 32px rgba(0, 0, 0, 0.45);
  --shafa-shadow-hover: 0 24px 48px -12px rgba(0, 0, 0, 0.40);
  --shafa-glass-bg:     rgba(var(--shafa-dk-surface-card-rgb), 0.72);
  --shafa-glass-border: rgba(var(--shafa-dk-accent-sand-rgb), 0.22);
  --shafa-glass-shadow: 0 12px 36px -4px rgba(0, 0, 0, 0.40);

  /* Derived surfaces — the dark counterparts of the §11b tokens */
  --shafa-card-bg:        linear-gradient(180deg, #24423F 0%, #1E3A39 100%);
  --shafa-panel-bg:       linear-gradient(135deg, #24423F 0%, #1A3636 100%);
  --shafa-panel-bg-deep:  linear-gradient(135deg, #2C4D49 0%, #24423F 55%, #1E3A39 100%);
  --shafa-media-bg:       radial-gradient(circle at 50% 45%, #2C4D49 30%, #1E3A39 100%);
  --shafa-nav-bg:         rgba(var(--shafa-dk-canvas-rgb), 0.82);
  --shafa-nav-bg-filled:  rgba(var(--shafa-dk-surface-muted-rgb), 0.94);
  --shafa-input-bg:       rgba(var(--shafa-dk-surface-card-rgb), 0.70);
  --shafa-input-bg-strong:#24423F;
  --shafa-field-mask-bg:  var(--shafa-field-mask-dark);
  --shafa-icon-btn-bg:    rgba(var(--shafa-dk-surface-card-rgb), 0.75);
  --shafa-glass-panel-bg: rgba(var(--shafa-dk-surface-card-rgb), 0.65);
  --shafa-surface-veil:      rgba(var(--shafa-dk-surface-card-rgb), 0.90);
  --shafa-surface-veil-soft: rgba(var(--shafa-dk-surface-card-rgb), 0.78);

  /* هیرو — معادل تیره. مقادیر از خانوادهٔ --shafa-dk-* گرفته شده‌اند تا با
     بقیهٔ تم هم‌خوان بمانند. لکهٔ روشنِ وسط در تم روشن rgba(255,252,245,.8)
     بود که روی زمینهٔ تیره یک هالهٔ سفید می‌ساخت؛ اینجا معادل کم‌رمق‌ترش
     را گذاشتیم تا فقط عمق بدهد. */
  --shafa-hero-base:       var(--shafa-dk-canvas);
  --shafa-hero-bloom:      rgba(var(--shafa-dk-brand-secondary-rgb), 0.30);
  --shafa-hero-bloom-soft: rgba(var(--shafa-dk-brand-primary-rgb), 0.35);
  --shafa-hero-scrim:      26, 54, 54;
  --shafa-hero-sub:        var(--shafa-dk-text-secondary);
  --shafa-hero-pill-bg:    linear-gradient(135deg, rgba(var(--shafa-dk-surface-card-rgb), 0.92) 0%, rgba(var(--shafa-dk-surface-muted-rgb), 0.88) 100%);
  --shafa-hero-pill-ring:  rgba(var(--shafa-dk-accent-sand-rgb), 0.18);

  /* نوار اعتماد — معادل تیره. پنل شیشه‌ای تیره تا متن‌های روشنِ
     --shafa-text-primary / --shafa-text-tertiary خوانا بمانند. */
  --shafa-hero-trust-bg:   linear-gradient(135deg, rgba(var(--shafa-dk-surface-card-rgb), 0.88) 0%, rgba(var(--shafa-dk-surface-muted-rgb), 0.92) 100%);
  --shafa-hero-trust-ring: rgba(var(--shafa-dk-accent-sand-rgb), 0.16);
  --shafa-hero-trust-halo: rgba(var(--shafa-dk-accent-sand-rgb), 0.10);
  --shafa-hero-trust-shadow: 0 4px 16px rgba(0, 0, 0, 0.30);
  --shafa-hero-trust-shadow-gold: 0 24px 60px -10px rgba(0, 0, 0, 0.45);
  --shafa-hero-trust-bg-matte:  rgba(var(--shafa-dk-surface-muted-rgb), 0.96);
  --shafa-inset-ring:     rgba(255, 255, 255, 0.06);
  --shafa-hairline:       rgba(var(--shafa-dk-border-subtle-rgb), 0.90);
  --shafa-hairline-soft:  rgba(var(--shafa-dk-border-subtle-rgb), 0.60);

  /* Lead Magnet — معادل تیره. پنل شیشه‌ای تیره با اکسنت شنی برای
     متن‌های روشن و آیکون طلایی. Toast هم در تم تاریک باید تیره باشد. */
  --shafa-lm-bg:           linear-gradient(135deg, #24423F 0%, #1E3A39 100%);
  --shafa-lm-bg-alt:       linear-gradient(135deg, #1E3A39 0%, #1A3636 100%);
  --shafa-lm-accent:       var(--shafa-dk-gold-text);
  --shafa-lm-accent-hover: var(--shafa-dk-accent-sand);
  --shafa-lm-badge-bg:     rgba(var(--shafa-dk-accent-sand-rgb), 0.18);
  --shafa-lm-badge-border: rgba(var(--shafa-dk-accent-sand-rgb), 0.40);
  --shafa-lm-sub:          var(--shafa-dk-text-tertiary);
  --shafa-lm-hint:         var(--shafa-dk-text-tertiary);
  --shafa-lm-ring:         rgba(var(--shafa-dk-accent-sand-rgb), 0.18);
  --shafa-lm-shadow:       0 4px 16px rgba(0, 0, 0, 0.35);
  --shafa-lm-shadow-lg:    0 24px 48px -12px rgba(0, 0, 0, 0.45);
  --shafa-lm-toast-bg:        var(--shafa-dk-surface-dark);
  --shafa-lm-toast-success:   var(--shafa-dk-status-success);
  --shafa-lm-toast-error:     var(--shafa-dk-status-error);
  --shafa-lm-toast-text:      var(--shafa-dk-canvas);

  /* Backward-compat aliases that must follow the dark surfaces */
  --bg:            var(--shafa-canvas);
  --surface:       var(--shafa-surface-card);
  --surface-2:     var(--shafa-surface-muted);
  --surface-alt:   var(--shafa-surface-muted);
  --text:          var(--shafa-text-primary);
  --text-soft:     var(--shafa-text-secondary);
  --muted:         var(--shafa-text-tertiary);
  --border:        var(--shafa-border-subtle);
  --shadow_overlay: rgba(0, 0, 0, 0.50);
  --bg-rgb:              26, 54, 54;
  --text-rgb:            244, 238, 224;
  --border-strong-rgb:   103, 125, 106;
  --accent-rgb:          214, 189, 152; /* اکسنت تاریک = شنی */
  --accent-strong-rgb:   226, 203, 168;
  --accent-2-rgb:        210, 177, 131;
  --info-rgb:            127, 196, 201; /* #7FC4C9 — تیل روشن تم تاریک */
  --secondary-rgb:       168, 190, 174;
  --scrollbar-track: var(--shafa-surface-muted);
  --scrollbar-thumb: var(--shafa-border-subtle);
}

/* Path 2 — system preference, no-JS safety net only.
 * The inline pre-paint script (includes/header.php) always sets data-theme
 * before first paint, so this block is intentionally NOT a full duplicate of
 * path 1: it only repaints the surfaces/text needed to avoid a white
 * flash when JavaScript is unavailable. Adding tokens here duplicates the
 * mapping and guarantees drift — add them to path 1 instead. */
@media (prefers-color-scheme: dark) {
  :root:not([data-theme]) {
    color-scheme: dark;

    --shafa-canvas:         var(--shafa-dk-canvas);
    --shafa-surface-card:   var(--shafa-dk-surface-card);
    --shafa-surface-muted:  var(--shafa-dk-surface-muted);
    --shafa-text-primary:   var(--shafa-dk-text-primary);
    --shafa-text-secondary: var(--shafa-dk-text-secondary);
    --shafa-text-tertiary:  var(--shafa-dk-text-tertiary);
    --shafa-border-subtle:  var(--shafa-dk-border-subtle);
    --shafa-border-focus:   var(--shafa-dk-border-focus);
    --shafa-focus-halo:     var(--shafa-focus-halo-dark);
    --shafa-field-mask-bg:  var(--shafa-field-mask-dark);

    --bg:            var(--shafa-canvas);
    --surface:       var(--shafa-surface-card);
    --surface-2:     var(--shafa-surface-muted);
    --text:          var(--shafa-text-primary);
    --text-soft:     var(--shafa-text-secondary);
    --muted:         var(--shafa-text-tertiary);
    --border:        var(--shafa-border-subtle);
    --bg-rgb:              26, 54, 54;
    --text-rgb:            244, 238, 224;
    --border-strong-rgb:   103, 125, 106;
  }
}

/* Scrollbar — follows the active surface tokens in both themes */
::-webkit-scrollbar-track { background: var(--scrollbar-track, var(--shafa-surface-muted)); }
::-webkit-scrollbar-thumb { background: var(--scrollbar-thumb, var(--shafa-border-subtle)); }
::-webkit-scrollbar-thumb:hover { background: var(--shafa-text-tertiary); }

/* ===================================================================
 * FOCUS VISIBLE STYLES (Accessibility - WCAG 2.4.7)
 * =================================================================== */
:focus-visible {
  outline: none;
  box-shadow: var(--shafa-focus-ring);
  border-color: var(--shafa-border-focus);
}

/* Inset focus for inputs/buttons that need it */
.field input:focus-visible,
.field textarea:focus-visible,
.field select:focus-visible,
.btn:focus-visible,
.nav-link:focus-visible,
.drawer__item:focus-visible,
.footer__nav-list a:focus-visible {
  box-shadow: var(--shafa-focus-ring-inset);
}

/* Skip link focus */
.skip-link:focus {
  position: absolute;
  top: var(--shafa-space-md);
  inset-inline-start: var(--shafa-space-md);
  z-index: var(--shafa-z-skip);
  padding: var(--shafa-space-xs) var(--shafa-space-md);
  background: var(--shafa-text-primary);
  color: var(--shafa-text-inverse);
  border-radius: var(--shafa-radius-md);
  box-shadow: var(--shafa-shadow-md);
}

/* ===================================================================
 * COMPREHENSIVE REDUCED MOTION OVERRIDES
 * Source: DESIGN_SYSTEM.md §7 & Apple HIG
 * =================================================================== */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.001ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.001ms !important;
    transition-delay: 0 !important;
    scroll-behavior: auto !important;
  }

  /* Disable GSAP ScrollTrigger animations */
  .scroll-reveal,
  .products-skeleton,
  .cart-skeleton,
  .skeleton-overlay {
    opacity: 1 !important;
    transform: none !important;
    animation: none !important;
    transition: none !important;
  }

  /* Disable parallax and floating elements */
  [data-parallax],
  .bee-characters,
  .floating-element {
    display: none !important;
  }

  /* Disable CSS-based animations */
  @keyframes spin { to { transform: rotate(360deg); } }
  @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.5; } }
  @keyframes fadeIn { from { opacity: 0; } to { opacity: 1; } }
  @keyframes slideUp { from { transform: translateY(20px); opacity: 0; } to { transform: translateY(0); opacity: 1; } }

  .animate-spin,
  .animate-pulse,
  .animate-fade-in,
  .animate-slide-up {
    animation: none !important;
  }

  /* Ensure instant transitions for interactive elements */
  .btn,
  .field input,
  .field textarea,
  .card,
  .panel,
  .modal,
  .drawer,
  .toast,
  .gallery-photo {
    transition-duration: 0.001ms !important;
  }
}
