/* ============================================================================
   Marca Alejandro Battaglio · Territorio "Taller"
   Versión 1.0 · 4 de septiembre de 2026

   Manual completo: 06-manual/manual-de-marca.md
   Decisiones cerradas: 04-territorio/decidido.md (no reabrir)

   Todos los ratios de contraste están calculados con la fórmula de luminancia
   relativa de WCAG 2.1, no estimados. Umbrales: 4,5:1 texto normal,
   3:1 texto grande (>= 33px) y elementos de interfaz.

   Tipografías con licencia SIL Open Font License:
   Space Grotesk  https://fonts.google.com/specimen/Space+Grotesk
   JetBrains Mono https://fonts.google.com/specimen/JetBrains+Mono
   ============================================================================ */

:root {

  /* --- COLOR · superficies -------------------------------------------------
     El fondo es el plano de abajo. La superficie es el plano de encima, y es
     la ÚNICA manera permitida de dar profundidad: nada de sombras. */

  --fondo:            #14161A;  /* plano base */
  --superficie:       #1D2026;  /* 1,11:1 sobre fondo · plano elevado */

  /* --- COLOR · texto ------------------------------------------------------- */

  --texto:            #E8E9EA;  /* 14,90:1 sobre fondo · 13,42:1 sobre superficie */
  --texto-atenuado:   #9AA0A8;  /*  6,87:1 sobre fondo ·  6,19:1 sobre superficie */
  --sobre-acento:     #14161A;  /*  6,38:1 sobre el acento · texto dentro de un botón relleno */

  /* --- COLOR · líneas ------------------------------------------------------
     1,37:1 no llega al 3:1 de WCAG, y es correcto: una línea decorativa no
     transmite información. Si una línea SÍ informa (borde de campo, elemento
     seleccionado), usar --texto-atenuado o --acento. */

  --linea:            #2C3037;  /*  1,37:1 sobre fondo · 1,23:1 sobre superficie */

  /* --- COLOR · acento ------------------------------------------------------
     UNO SOLO Y SE RESERVA. Una pantalla, un naranja. Ver manual 5.1.
     Nunca en títulos, iconos decorativos, bordes de tarjeta ni fondos.
     Presupuesto de superficie: máximo 5 % del área visible. */

  --acento:           #FF6B2C;  /*  6,38:1 sobre fondo ·  5,74:1 sobre superficie */

  /* --- COLOR · estados de enlace -------------------------------------------
     Los cuatro pasan 4,5:1 sobre las dos superficies.
     OBLIGATORIO: cada estado cambia algo más que el color (el subrayado),
     porque quien no distingue los naranjas necesita ver moverse otra cosa. */

  --enlace:           #FF6B2C;  /*  6,38:1 sobre fondo ·  5,74:1 sobre superficie · subrayado 1px a 3px */
  --enlace-encima:    #FF8850;  /*  7,67:1 sobre fondo ·  6,91:1 sobre superficie · subrayado 2px */
  --enlace-pulsado:   #E85A1C;  /*  5,10:1 sobre fondo ·  4,59:1 sobre superficie · subrayado pegado */
  --enlace-visitado:  #CC9270;  /*  6,82:1 sobre fondo ·  6,15:1 sobre superficie · subrayado punteado */
  --sobre-enlace-encima: #14161A; /* 7,67:1 sobre --enlace-encima */

  /* --- COLOR · estados del sistema -----------------------------------------
     No hay segundo acento. El naranja hace de alarma porque ya es el color de
     la atención. Sin rojo, y sobre todo SIN VERDE: un verde aquí abre la
     puerta al lima de OH WOW! por la ventana de atrás. */

  --error:            #FF6B2C;  /*  6,38:1 sobre fondo · borde de campo e icono */
  --correcto:         #9AA0A8;  /*  6,87:1 sobre fondo · icono de comprobado */
  --aviso:            #9AA0A8;  /*  6,87:1 sobre fondo */

  /* --- COLOR · foco --------------------------------------------------------
     Única excepción permanente a la regla del acento reservado: la
     accesibilidad manda. Anillo de 2px con 2px de separación. */

  --foco:             #FF6B2C;  /*  6,38:1 sobre fondo ·  5,74:1 sobre superficie */
  --foco-grosor:      2px;
  --foco-separacion:  2px;

  /* --- COLOR · versión clara (CONSTRUIDA el 14 de octubre de 2026) ---------
     La pidió él para la web: modo claro y oscuro, con botón. El oscuro sigue siendo
     la marca; el claro es la alternativa. Ver manual 4.3.
     El #D74000 que se documentó primero solo pasaba sobre blanco puro (4,09:1 sobre
     la superficie), así que el acento claro baja a #C23A00: pasa sobre las dos. */

  --claro-fondo:          #FFFFFF;
  --claro-superficie:     #F2F3F5;  /*  1,11:1 sobre fondo · plano elevado */
  --claro-texto:          #14161A;  /* 18,11:1 sobre fondo · 16,31:1 sobre superficie */
  --claro-texto-atenuado: #5C626B;  /*  6,15:1 sobre fondo ·  5,54:1 sobre superficie */
  --claro-linea:          #DCDFE4;  /*  1,34:1 sobre fondo · decorativa, como --linea */
  --claro-acento:         #C23A00;  /*  5,39:1 sobre fondo ·  4,85:1 sobre superficie */
  --claro-sobre-acento:   #FFFFFF;  /*  5,39:1 sobre --claro-acento · botón relleno */
  --claro-enlace-encima:  #A83200;  /*  6,73:1 sobre fondo ·  6,06:1 sobre superficie */
  --claro-enlace-pulsado: #8F2A00;  /*  8,40:1 sobre fondo ·  7,57:1 sobre superficie */
  --claro-enlace-visitado:#8A5A3C;  /*  5,82:1 sobre fondo ·  5,24:1 sobre superficie */

  /* --- COLOR · prohibidos --------------------------------------------------
     No son variables, son un recordatorio. Nunca en esta marca:
     #C1FE1A lima de OH WOW! · #1A1A1A negro de OH WOW! · #CE9AED violeta
     #0070FF azul · #FE01AC magenta · cualquier neón · un segundo acento. */


  /* --- LETRA · familias ----------------------------------------------------
     La monoespaciada va DONDE HAY CÓDIGO Y EN NINGÚN OTRO SITIO.
     Nada de etiquetas, pies, metadatos ni numeritos de interfaz en mono. */

  --letra:   "Space Grotesk", -apple-system, "Segoe UI", Helvetica, Arial, sans-serif;
  --codigo:  "JetBrains Mono", "SFMono-Regular", Consolas, monospace;

  /* --- LETRA · grosores ----------------------------------------------------
     Tres, no cinco. Light 300 y semibold 600 quedan fuera: dos pesos contiguos
     no se distinguen en pantalla y solo añaden ruido. */

  --peso-normal: 400;  /* todo el texto corrido */
  --peso-medio:  500;  /* títulos de sección, y lo que pesa sin gritar */
  --peso-fuerte: 700;  /* título de página y titular de portada. Nada más */

  /* --- LETRA · escala ------------------------------------------------------
     Base 17px, razón 1,25 (tercera mayor). Redondeado al píxel entero.
     Si un tamaño no está aquí, NO EXISTE: ningún valor se pone a ojo.
     Razón elegida sobre 1,2 (los pasos altos se quedan cortos) y sobre
     1,333 (el paso -2 cae a 9,6px y deja de leerse). */

  --txt--2:  0.6875rem;  /* 11px · etiquetas de figura, pies de tabla, créditos */
  --txt--1:  0.875rem;   /* 14px · notas al pie, metadatos, fecha */
  --txt-0:   1.0625rem;  /* 17px · TEXTO CORRIDO, tamaño por defecto */
  --txt-1:   1.3125rem;  /* 21px · entradilla, cita destacada */
  --txt-2:   1.6875rem;  /* 27px · título de sección (h3) */
  --txt-3:   2.0625rem;  /* 33px · título de bloque (h2) */
  --txt-4:   2.625rem;   /* 42px · título de página (h1) */
  --txt-5:   3.25rem;    /* 52px · titular de portada, y solo ahí */

  /* --- LETRA · interlineado ------------------------------------------------
     No es fijo: cuanto más grande la letra, más apretada va. */

  --interlinea-pequena: 1.5;   /* pasos -2 y -1 */
  --interlinea-texto:   1.7;   /* paso 0, texto corrido */
  --interlinea-media:   1.35;  /* pasos 1 y 2 */
  --interlinea-titular: 1.15;  /* pasos 3, 4 y 5 */

  /* --- LETRA · espaciado entre letras y medida ----------------------------- */

  --tracking-texto:   0;        /* el texto corrido nunca se toca */
  --tracking-titular: -0.02em;  /* pasos 4 y 5: Space Grotesk abre de más en grande */
  --medida-min:       62ch;     /* por debajo, el ojo salta de línea */
  --medida-max:       78ch;     /* por encima, pierde el renglón */

  /* --- ESPACIADO · módulo 8px ---------------------------------------------
     Todo margen, relleno y hueco es múltiplo del módulo. Un valor fuera de
     esta tabla no se usa: si hace falta algo intermedio, se coge el vecino.
     El 8 casa con la interlínea del texto (28,9px = 3,6 módulos) y con la
     rejilla de 4 de las pantallas, así que nada cae en medio píxel. */

  --esp-modulo: 8px;

  --esp-0:  0.25rem;  /*   4px · 0,5x · icono y su texto */
  --esp-1:  0.5rem;   /*   8px ·   1x · relleno de una etiqueta */
  --esp-2:  0.75rem;  /*  12px · 1,5x · entre elementos de lista */
  --esp-3:  1rem;     /*  16px ·   2x · entre párrafos */
  --esp-4:  1.5rem;   /*  24px ·   3x · relleno de tarjeta y de bloque de código */
  --esp-5:  2rem;     /*  32px ·   4x · entre bloques hermanos */
  --esp-6:  3rem;     /*  48px ·   6x · entre secciones */
  --esp-7:  4rem;     /*  64px ·   8x · sobre una sección con título */
  --esp-8:  6rem;     /*  96px ·  12x · entre zonas de una página */
  --esp-9:  8rem;     /* 128px ·  16x · respiración de portada */

  /* --- FORMA ---------------------------------------------------------------
     Un radio, uno solo. Botones, tarjetas, campos, bloques de código.
     Las tablas y los separadores van a canto vivo (radio 0). */

  --radio:        6px;
  --linea-grosor: 1px;   /* sin excepciones decorativas: el borde grueso (>=3px)
                            y la banda lateral de color están PROHIBIDOS.
                            NINGUNA CAJA LLEVA RECUADRO, tampoco de 1px: se separa
                            por su fondo (--superficie). La línea queda para separar
                            filas y para el borde de un campo. Ver manual 3.3 */

  /* --- MOVIMIENTO ----------------------------------------------------------
     Cambiado por él el 14 de octubre de 2026: «le falta algo de animaciones, es
     muy tiesa». La web se mueve: el titular entra palabra a palabra, los bloques
     aparecen al bajar, las páginas pasan de una a otra con transición, las cifras
     cuentan hasta su valor y el inicio lleva un vídeo. Sigue prohibido: paralaje,
     partículas y todo lo de 5.3 que no es movimiento (degradados, sombras, vidrio).
     Ver manual 5.3. */

  --transicion:   120ms ease-out;                  /* cambios de estado: color, subrayado */
  --mov-curva:    cubic-bezier(0.16, 1, 0.3, 1);   /* sale rápido y frena suave */
  --mov-entrada:  700ms;                           /* lo que entra en pantalla */
  --mov-pagina:   450ms;                           /* el paso de una página a otra */
  --mov-escalon:  70ms;                            /* el retraso entre piezas de una serie */

  /* --- PROHIBIDO -----------------------------------------------------------
     No hay variables de sombra, de degradado ni de desenfoque, y no se añaden.
     Degradados, vidrio esmerilado (backdrop-filter), halos, resplandores y
     sombras (de caja y de texto) están fuera de esta marca. La profundidad la
     da --superficie. Ver manual 5.3. */

}

/* ============================================================================
   USO MÍNIMO
   Pegar debajo si se quiere el arranque hecho. Todo opcional salvo el foco.
   ============================================================================ */

body {
  background: var(--fondo);
  color: var(--texto);
  font-family: var(--letra);
  font-size: var(--txt-0);
  font-weight: var(--peso-normal);
  line-height: var(--interlinea-texto);
  letter-spacing: var(--tracking-texto);
}

h1 { font-size: var(--txt-4); font-weight: var(--peso-fuerte); line-height: var(--interlinea-titular); letter-spacing: var(--tracking-titular); }
h2 { font-size: var(--txt-3); font-weight: var(--peso-fuerte); line-height: var(--interlinea-titular); letter-spacing: var(--tracking-titular); }
h3 { font-size: var(--txt-2); font-weight: var(--peso-medio);  line-height: var(--interlinea-media); }

/* Los cuatro estados cambian color Y subrayado. El subrayado no es opcional. */
a                 { color: var(--enlace);          text-decoration: underline; text-decoration-thickness: 1px; text-underline-offset: 3px; transition: color var(--transicion); }
a:hover           { color: var(--enlace-encima);   text-decoration-thickness: 2px; }
a:active          { color: var(--enlace-pulsado);  text-underline-offset: 1px; }
a:visited         { color: var(--enlace-visitado); text-decoration-style: dotted; }

/* Excepción permanente a la regla del acento reservado. No quitar nunca. */
:focus-visible {
  outline: var(--foco-grosor) solid var(--foco);
  outline-offset: var(--foco-separacion);
}

code, pre, kbd, samp {
  font-family: var(--codigo);
  font-size: var(--txt--1);
}

pre {
  background: var(--superficie);
  border-radius: var(--radio);
  padding: var(--esp-4);
  overflow-x: auto;
}

hr {
  border: 0;
  border-top: var(--linea-grosor) solid var(--linea);
}
