/**
 * ─────────────────────────────────────────────────────────────────
 *  DESIGN SYSTEM — ALIASES RETROCOMPATIBLES · WapuCommerce v4.0.40
 * ─────────────────────────────────────────────────────────────────
 *
 *  ⚠️  ESTE ARCHIVO NO DECLARA TOKENS NUEVOS.
 *
 *  Solo mapea namespaces legacy a `--ds-*` canónico para que el código
 *  viejo siga funcionando mientras se migra incrementalmente.
 *
 *  REGLA: ningún alias tiene valor literal. Todos son `var(--ds-X)`.
 *  Si un alias necesita un valor diferente al canónico → revísalo
 *  (probablemente sea un bug, no un alias).
 *
 *  Carga DESPUÉS de tokens.css, ANTES de cualquier otro CSS. Ver
 *  class-wapu-enqueue.php para el orden.
 *
 *  Cada sección lista:
 *   · Owner del namespace
 *   · Estado (legacy / mantenido / deprecated)
 *   · Plan de migración
 *
 *  Documentación: /docs/DS-TOKENS.md
 *  Versión: 4.0.40 — Fase 1 unificación
 * ─────────────────────────────────────────────────────────────────
 */

:root {

    /* ─────────────────────────────────────────────────────────────
     *  --font-* · LEGACY sin prefijo
     *
     *  Owner:    main.css (Block 3 :root, ahora deprecated)
     *  Estado:   🟡 mantenido por compat
     *  Migración: buscar usos de var(--font-sans|font-display|spacing-section)
     *             y reemplazar por --ds-* directo. Cuando 0 usos → eliminar.
     * ──────────────────────────────────────────────────────────── */
    --font-sans:       var(--ds-font-text);
    --font-display:    var(--ds-font-display);
    --spacing-section: 5rem;  /* sin equivalente DS — mantener literal por ahora */

    /* ─────────────────────────────────────────────────────────────
     *  --ws-* · workspace tokens
     *
     *  Owner:    Drop Bridge (PHP) emite --ws-* + --drop-* duplicados.
     *  Estado:   🟢 mantenido — Drop Bridge sigue emitiendo ambos.
     *  Migración: Fase 5 (cuando refactoricemos enqueues) — decidir
     *             si --ws-* o --drop-* es canónico para drop content.
     *
     *  Estos aliases NO se usan cuando el Drop Bridge inyectó valores
     *  reales (ese inline gana en specificity). Solo activan cuando
     *  no hay drop activo (fallback a tokens DS).
     * ──────────────────────────────────────────────────────────── */
    --ws-bg:           var(--ds-surface);
    --ws-surface:      var(--ds-surface);
    --ws-surface-2:    var(--ds-surface-2);
    --ws-text:         var(--ds-ink);
    --ws-text-soft:    var(--ds-ink-2);
    --ws-text-faint:   var(--ds-ink-3);
    --ws-border:       var(--ds-separator);
    --ws-accent:       var(--ds-action);
    --ws-accent-ink:   var(--ds-action-ink);

    /* ─────────────────────────────────────────────────────────────
     *  --drop-* · drop content tokens
     *
     *  Owner:    Drop Bridge (PHP, /inc/class-wapu-drop-bridge.php).
     *  Estado:   🟢 canónico para contenido del drop activo.
     *  Migración: ninguna en Fase 1. Drop Bridge sigue inyectando.
     *
     *  Fallbacks definidos aquí garantizan que componentes que leen
     *  `var(--drop-X)` no se rompan cuando no hay drop activo.
     * ──────────────────────────────────────────────────────────── */
    --drop-bg:         var(--ds-surface);
    --drop-surface:    var(--ds-surface);
    --drop-text:       var(--ds-ink);
    --drop-accent:     var(--ds-action);
    --drop-accent-ink: var(--ds-action-ink);
    --drop-border:     var(--ds-separator);

    /* ─────────────────────────────────────────────────────────────
     *  --co-* · checkout tokens
     *
     *  Owner:    checkout.css (legacy, declarado inline en archivo).
     *  Estado:   🟡 deprecated — fase 4 reescribirá checkout.
     *  Migración: NO añadir más. Migrar usos a --ds-* directo.
     *
     *  Aliases pasivos para que checkout.css siga rendereando mientras
     *  refactor de fase 4 no aterriza.
     * ──────────────────────────────────────────────────────────── */
    --co-bg:        var(--ds-surface);
    --co-card:      var(--ds-surface);
    --co-border:    var(--ds-separator);
    --co-text:      var(--ds-ink);
    --co-text-soft: var(--ds-ink-2);
    --co-text-faint:var(--ds-ink-3);

    /* ─────────────────────────────────────────────────────────────
     *  --wapu-* · legacy tokens (theme v3.x)
     *
     *  Owner:    nadie — eran del theme antes del DS.
     *  Estado:   🔴 deprecated · pendiente eliminar.
     *  Migración: buscar usos restantes y reemplazar uno-por-uno con
     *             --ds-* directo. Cuando 0 usos → borrar este bloque.
     * ──────────────────────────────────────────────────────────── */
    --wapu-text:    var(--ds-ink);
    --wapu-gray:    var(--ds-ink-3);
    --wapu-border:  var(--ds-separator);
    --wapu-bg:      var(--ds-surface);
    --wapu-accent:  var(--ds-action);

}

/* ─────────────────────────────────────────────────────────────────
 *  Lo que NO se aliasa (intencionalmente):
 *
 *  --pg-*  ← Playground chrome (vive en wapu-playground/).
 *            No es responsabilidad del theme. NO declarar aquí.
 *
 *  --cs-*  ← Card Studio (vive en wapu-playground/card-studio.css).
 *            Aislado del DS por diseño actual. Su conexión al DS es
 *            objetivo de Fase 2 (single source of truth product-card).
 * ───────────────────────────────────────────────────────────────── */