/** * Wapu Admin DS — Tokens Aliases (transition layer) * * Mapea namespaces legacy hacia el canon `--wa-*`. SOLO incluye aliases SEGUROS: * casos donde el token legacy tiene una equivalencia 1:1 con un token canon. * * Aliases NO son canon nuevo. Son una capa de transición para no romper plugins * mientras migran. Plan de retiro: * - v5.1.1 (este archivo): aliases activos. * - v5.2.0: warning en logs si se consumen aliases (dev mode). * - v5.3.0: aliases marcados @deprecated en CSS comments. * - v6.0.0: aliases ELIMINADOS. Plugins que aún consuman legacy se romperán visualmente. * * Si un token legacy NO tiene alias seguro, está documentado en TOKENS-ALIASES.md * con la razón. NO inventar valores arbitrarios. * * Cargar este archivo DESPUÉS de tokens.css, dentro del mismo bundle DS. * * @package WapuCore * @since 5.1.1 */ /* ═══════════════════════════════════════════════════════════════ * --wapu-* (legacy) → --wa-* (canon) * * 109 tokens detectados en uso. 56 con alias seguro, 53 sin alias seguro * (ver TOKENS-ALIASES.md §3 para razones). * ═══════════════════════════════════════════════════════════════ */ :root { /* ── Semantic colors ── */ --wapu-green: var(--wa-success); --wapu-red: var(--wa-error); --wapu-yellow: var(--wa-warning); --wapu-blue: var(--wa-info); /* Soft variants */ --wapu-green-bg: var(--wa-success-soft); --wapu-red-bg: var(--wa-error-soft); --wapu-yellow-bg: var(--wa-warning-soft); --wapu-blue-bg: var(--wa-info-soft); --wapu-purple-bg: var(--wa-accent-soft); /* Border variants */ --wapu-red-border: var(--wa-error-border); --wapu-yellow-border: var(--wa-warning-border); /* ── Brand accent ── */ --wapu-purple: var(--wa-accent); --wapu-accent: var(--wa-accent); --wapu-primary: var(--wa-accent); --wapu-purple-soft: var(--wa-accent-soft); --wapu-purple-strong: var(--wa-accent-hover); /* ── Text ── */ --wapu-text: var(--wa-text); --wapu-text-muted: var(--wa-text-muted); --wapu-text-subtle: var(--wa-text-subtle); --wapu-text-soft: var(--wa-text-subtle); /* fallback common usage */ /* ── Surfaces ── */ --wapu-surface: var(--wa-surface); --wapu-surface-2: var(--wa-surface-2); --wapu-bg: var(--wa-surface-canvas); --wapu-white: var(--wa-surface); /* "white" mostly used as bg */ /* ── Borders ── */ --wapu-border: var(--wa-border-color); --wapu-border-soft: var(--wa-border-color-soft); /* ── Radius ── */ --wapu-radius: var(--wa-radius); --wapu-radius-sm: var(--wa-radius-sm); --wapu-radius-md: var(--wa-radius-md); --wapu-radius-lg: var(--wa-radius-lg); --wapu-radius-xl: var(--wa-radius-xl); --wapu-radius-xs: var(--wa-radius-sm); /* xs no existe en canon, mapeamos a sm */ --wapu-radius-pill: var(--wa-radius-pill); /* ── Typography ── */ --wapu-font: var(--wa-font-sans); --wapu-font-body: var(--wa-font-sans); --wapu-font-mono: var(--wa-font-mono); /* ── Magenta — alias to accent (decorative, not in canon as separate) ── */ --wapu-magenta: var(--wa-accent); } /* ═══════════════════════════════════════════════════════════════ * --wp-* (legacy admin Layout B partial) → --wa-* (canon) * * Solo 11 tokens en uso, 31 ocurrencias totales. Casi muerto. * Plan: marcar @deprecated en v5.2, eliminar en v5.3. * ═══════════════════════════════════════════════════════════════ */ :root { --wp-primary: var(--wa-accent); --wp-accent: var(--wa-accent); --wp-text: var(--wa-text); --wp-text-muted: var(--wa-text-muted); --wp-text-inverse: var(--wa-accent-text); --wp-surface: var(--wa-surface); --wp-radius: var(--wa-radius); --wp-radius-pill: var(--wa-radius-pill); --wp-font-body: var(--wa-font-sans); /* --wp-accent2 — NO SAFE ALIAS (slot custom de un skin viejo, no canon) */ /* --wp-admin--admin-bar--height — NO ALIAS (token interno de WP, no canon) */ } /* ═══════════════════════════════════════════════════════════════ * --co-* (módulo local de wapu-core, archivo único) → --wa-* (canon) * * 20 tokens, 241 usos. Mapeo limpio porque pertenecían a un solo módulo * con responsabilidad equivalente al admin común. * ═══════════════════════════════════════════════════════════════ */ :root { /* Text */ --co-text: var(--wa-text); --co-text-soft: var(--wa-text-subtle); --co-text-muted: var(--wa-text-muted); --co-text-faint: var(--wa-text-disabled); /* Accent */ --co-accent: var(--wa-accent); --co-accent-soft: var(--wa-accent-soft); /* Surfaces */ --co-card-bg: var(--wa-surface); --co-card: var(--wa-surface); --co-muted-bg: var(--wa-surface-3); --co-muted: var(--wa-surface-3); --co-page-bg: var(--wa-surface-canvas); --co-page: var(--wa-surface-canvas); /* Borders */ --co-border: var(--wa-border-color); --co-card-border: var(--wa-border-color); --co-border-line: var(--wa-border-color); --co-border-hairline: var(--wa-border-color-soft); --co-border-subtle: var(--wa-border-color-soft); --co-border-strong: var(--wa-border-color-strong); --co-divider: var(--wa-border-color-soft); /* Status */ --co-success: var(--wa-success); } /* ═══════════════════════════════════════════════════════════════ * NO SAFE ALIAS — documentación inline de tokens NO mapeados * * Estos tokens existen en el ecosistema pero no se les define alias * porque no hay equivalencia clara, su uso es contextual o pertenecen * a dominios aislados. * * La consecuencia es que los plugins que los usen verán esos tokens * como `var(--token, fallback)` resolviéndose al fallback (el segundo * argumento de var()) o a undefined → comportamiento 'initial'. * * Plan: cuando esos plugins entren en migration window, sus mantainers * deben elegir el equivalente canon contextualmente. * ═══════════════════════════════════════════════════════════════ */ /* * --wapu-gray (873 usos) → no-safe-alias: ambiguo. Puede ser * --wa-text-muted, --wa-text-subtle, * --wa-border-color, --wa-surface-3 * según contexto. Forzar un valor * rompería UI. * * --wapu-gray-100..900 (8 variantes, * aprox 200 usos totales) → no-safe-alias: la escala gray no * existe en canon. Cada caso debe * elegirse manualmente al migrar. * * --wapu-black → no-safe-alias: en la mayoría de * casos quieres --wa-text. Pero algunos * usos son verdaderamente "negro puro". * Decidir por uso. * * --wapu-admin-dark → no-safe-alias: ya marcado dead token. * Eliminar al migrar plugin. * * --wapu-text-headline → no-safe-alias: dead token. No migrar. * * --wapu-text-secondary → no-safe-alias: dead token. Mapear a * --wa-text-muted al migrar. * * --wapu-gradient-soft → no-safe-alias: gradients no son canon. * Cada plugin define el suyo o usa accent. * * --wapu-gradient-text → no-safe-alias: ídem. * * --wapu-btn-color → no-safe-alias: hereda de un skin viejo. * Migrar a --wa-accent. * * --wapu-mobile-appbar-height → no-safe-alias: layout token específico. * Mantener local en theme. * * --wapu-font-title → no-safe-alias: muerto en mayoría. * Mapear a --wa-font-sans al migrar. * * --wapu-ring-info / --wapu-ring-soft → no-safe-alias: dead tokens. * * --wapu-teal → no-safe-alias: dead token. Eliminar. * * --wapu-amber → no-safe-alias: confunde con warning. * Decidir por uso real. * * * --wapu-auth-* (todos, ~16 tokens) → DOMINIO AISLADO (excepción documentada). * wapu-auth-social-login mantiene su * propio scope. No migrar. * * * --wp-accent2 → no-safe-alias: slot del skin "duotono" * que ya no existe. * * --wp-admin--admin-bar--height → no-safe-alias: variable de WP nativa. * No es nuestra. * * * --pg-* (Playground, 325 tokens) → CANON HERMANO. Studio shell tiene su * propio sistema. No alias-ear desde * admin. * * --ds-* (theme, 139 tokens) → CANON HERMANO. Frontend ≠ admin. * No alias-ear desde admin. * * --ws-* (scenes scoped) → SCOPE PER-INSTANCE. No global. * No alias-ear. * * --wcpl-* (wapu-listas local) → no-safe-alias por ahora: cuando el * plugin migre en Phase 1.2 redeclara * sus propios tokens en --wa-*. * * --primary / --ghost / --danger / * --active / --outline / --filled → no-safe-alias: namespace 'other' sin * prefijo. Conflictos masivos detectados * (--primary tiene 23 valores distintos * en 11 plugins). Cada plugin debe * migrar contextualmente. */