omd-shader-hero — una escena, dos tintas de marca
Un héroe de lanzamiento recibe una sola impresión de alguien que no te debe nada. Los degradados mesh son el aspecto de shader más genérico de la web, y mezclar dos tonos de marca complementarios los vuelve marrones. Esta skill hace lo contrario: dos tintas planas, el color base y un color de marca, impresas como un campo de tramado ordenado que se pliega lentamente como la luz a través de una serigrafía. Cada píxel es una tinta u la otra, por lo que nada se mezcla y nada se vuelve turbio. El texto se asienta sobre un recorte de bordes duros en la tinta base, como un panel recortado en un póster riso.
El script elige ambas tintas, el color del texto y el contraste desde DESIGN.md. Ningún color se elige por gusto.
Ejemplo funcional: examples/hero.html, completado con el ficticio examples/DESIGN.example.md. Scripts: scripts/tokens.mjs (tintas + contraste), scripts/verify.mjs (verificación de renderizado real).
1. Cuándo usarlo / cuándo no
Úsalo cuando:
- una página de lanzamiento, producto, lista de espera, evento o cambio de marca necesite una primera pantalla con movimiento;
- el proyecto tenga un
DESIGN.mdcon un color de marca y una base oscura (o clara) (tokens de Core v2 Foundations, pares de Foundations prose, o frontmattercolors:compatible con Google); - un aspecto gráfico, impreso y seguro encaje con la marca.
No lo uses cuando:
- no haya DESIGN.md o ningún color de marca.
tokens.mjssale con código 3 y te detienes; ejecutaomd-inito pregunta. Nunca elijas colores "bonitos" para llenar el vacío (desconocido significa ausente); - la marca sea suave, fotográfica o de lujo tranquilo. Un campo de tramado es ruidoso. Usa la fotografía del brief en su lugar (tf-shaders "photo first");
- la página necesite varias escenas de shader. Una escena, más a lo sumo un pequeño acento en otro lugar (regla de tf-shaders). Para una historia de scroll completa, usa
omd-landing.
2. Procedimiento
- Lee los tokens, no los elijas.
El script lee tres formatos, en este orden: tokensnode <skill>/scripts/tokens.mjs DESIGN.md # imprime la decisión como JSON node <skill>/scripts/tokens.mjs DESIGN.md --scheme light # base clara en lugar de oscura- **color.<role>**: \#hex`, paresName (=`#hex`)dentro de la sección Foundations, luego frontmattercolors:. Luego:- descarta roles de estado y utilidad (danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active);
- toma el token más oscuro como tinta base (el más claro para
light); - toma una tinta de marca: el rol llamado primary/brand si existe, si no, el color de marca más saturado, saltando cualquier color demasiado cercano a la base.
- El color del texto se calcula. El script verifica los candidatos de texto (tokens de tinta/neutral en el extremo opuesto del esquema) contra ambas tintas y su punto medio, y elige el mejor. El texto se asienta sobre un recorte opaco de tinta base, por lo que la barra que debe superar es el token de texto sobre la tinta base. Con el fixture, eso es 18.8:1. Si incluso eso está por debajo de 4.5:1, el script advierte: elige otro token de texto.
- Escribe el héroe. Copia
examples/hero.html(o transpórtalo, ver §6) y complétalo:
Eso reescribe el bloque CSSnode <skill>/scripts/tokens.mjs DESIGN.md --write path/to/hero.html#hero-vars(--hero-c0base,--hero-c1marca,--hero-text,--hero-scrim,--hero-scrim-a) y el JSON#hero-tokens. - El texto es real. Titular + una oración + un CTA. Usa la línea de producto real del usuario. Nunca inventes métricas, clientes o inversores (tf-shaders §0).
- Verifica en una GPU real (§5) y mira los fotogramas a tamaño completo.
3. La escena y sus dos parámetros
ditheringFragmentShader de Paper: type = 4x4 (Bayer ordenado), colorBack = tinta base, colorFront = tinta de marca, y una de dos formas de campo elegidas con data-shape en .hero-scene:
data-shape | Campo | Se lee como |
|---|---|---|
warp (predeterminado) | pliegues diagonales lentos de luz de marca, escala 1 | un póster riso, energía en dos esquinas |
ripple | anillos concéntricos centrados en el héroe, detrás del texto, escala 0.5 | una impresión con centro de gravedad: el texto se sitúa en el ojo |
La forma es una elección de composición, no un tercer parámetro: la escala de cada forma está fija para que sus celdas se lean a px 2–6, y un valor desconocido recurre a warp. Ambas formas permanecen como dos tintas planas (verificado por recuento de píxeles, §5). Otras formas de tramado de Paper y sus otros shaders quedaron fuera: la mayoría mezcla los dos colores en sus bordes, lo que rompe la regla para la que existe esta skill.
| Parámetro | Rango | Predeterminado | Qué hace |
|---|---|---|---|
speed (data-speed) | 0–1 | 0.3 | Deriva de los pliegues. Por encima de ~0.6 se lee como un protector de pantalla. 0 congela el campo. |
px (data-px) | 2–6 CSS px | 3 | Tamaño de la celda de tramado. 2 = pantalla fina, 3 = riso, 5–6 = impresión gruesa. |
Reglas de diseño:
- Recorte, no velo. El cuadro de texto se asienta sobre un panel opaco de tinta base con bordes duros (inset 2rem × 2.5rem alrededor del texto). Un velo translúcido o un borde difuminado colocaría base sobre puntos de marca y recrearía el barro. El texto pequeño (la etiqueta de pie de página) tiene su propio recorte.
- Contraste: 4.5:1 para el titular y el subtítulo. El titular es lo suficientemente grande como para que WCAG aceptaría 3:1, pero esta skill no se basa en eso.
verify.mjsfalla por debajo de 4.5:1 para cualquiera de los dos. - El texto del héroe se pinta en el primer fotograma: sin
opacity: 0, sin esperar al canvas. El canvas aparece gradualmente en 600ms sobre un póster CSS ya completo. - El póster también es de dos tintas. Sigue la forma (esquinas para
warp, anillos pararipple, dispuestos después del fotograma fijo) y obtiene su tono del tamaño del punto en dos bandas de bordes duros (cuadrados 4×4 en los núcleos, 2×2 en los hombros), nunca de alpha: una máscara desvanecida mezclaría marca sobre base. Puntos cuadrados en píxeles enteros, como las celdas Bayer. - El texto coreano sigue
/hangul:keep-all+overflow-wrap: anywhere, interlineado 1.3, tracking -0.02em (nunca por debajo de -0.03em),text-wrap: balance,font-synthesis: none. - Fondo en
html, nunca enbody(un fondo de body se pinta sobre una escena con z negativa; error común de tf-shaders). - El radio, la escala tipográfica y el espaciado también provienen de DESIGN.md. El fixture no define radio, por lo que el CTA es cuadrado.
4. Librería, licencia, presupuesto, respaldo
Librería: @paper-design/shaders 0.0.82 (vanilla ShaderMount + ditheringFragmentShader), WebGL2. 0.0.82 (2026-10-21) cambia solo shader-mount.js: dispose() ahora libera el contexto WebGL. Licencias verificadas el 2026-10-13 desde los archivos LICENSE de los tarballs npm, metadatos npm y la API de licencias de GitHub:
@paper-design/shaders 0.0.81 | shaders 4.0.4 (shaders.com) | |
|---|---|---|
| Licencia | Apache 2.0 (+ NOTICE "Paper Shaders, Copyright 2026 Paper") | MIT (© 2026 Shader Effects Inc.); dep typegpu 0.12.3 MIT |
| Tiempo de ejecución | WebGL2, casi universal | Solo WebGPU; canvas transparente y sin registro cuando no es compatible |
| JS para esta escena | 23.7 KiB min / 7.0 KiB gzip (esbuild); CDN por archivo +esm 5.0 + 2.9 KiB gzip | 2,535 KiB min / 710 KiB gzip (Shader + MeshGradient) |
| Telemetría | ninguna | activada por defecto (muestreo del 5% a shaders.com/api/telemetry); si debes usarlo, pasa disableTelemetry |
| Descargas semanales npm (2026-10-05..11) | 1,104,377 (-react) | 287,493 |
Paper gana en alcance, peso y telemetría. shaders es la ruta de actualización solo para un proyecto que ya incluya escenas WebGPU. Allí, mantén esta canalización de tokens, el recorte y el respaldo, y pasa disableTelemetry. Ambas licencias permiten su uso en skills y plantillas. El ejemplo importa Paper desde una URL CDN fija y no lo provee. Si provees los archivos de Paper, copia su NOTICE con ellos.
Presupuesto:
- JS: 7.0 KiB gzip de librería + 1.1 KiB gzip de código de escena.
- GPU: un quad de ventana completa, dos colores, tramado ordenado.
minPixelRatio: 1ymaxPixelCount1920×1080, ya que el tamaño de celda es la resolución. Paper se pausa fuera de pantalla y en pestañas ocultas. - Sin imágenes, sin video, sin fuente más allá de la cara de la interfaz de usuario.
Respaldo (parte del diseño, no una ocurrencia tardía):
- Póster de semitono CSS debajo del canvas: puntos de la tinta de marca sobre la tinta base (
radial-gradientceldas de 6px), enmascarados hacia dos esquinas. Es la primera pintura, la ruta sin WebGL2 (ShaderMountlanza una excepción sin contexto; la página pruebagetContext('webgl2')primero), y el estado cuando la CDN no está disponible.verify.mjsfuerza esta ruta. prefers-reduced-motion: reduce: velocidad 0 en un fotograma fijo (STILL_FRAME, 8000ms). Esa es una composición fija sin bucle rAF.
5. Verificar en una GPU real
npm i -D playwright-core && npx playwright-core install chromium # Playwright Chromium fresco, no tu propio Chrome
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all
--shape warp|ripple|all establece data-shape antes de que se ejecute el módulo de la página. Para cada forma ejecuta cuatro pases (GPU 1440px, móvil 390px, movimiento reducido, sin WebGL) con --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS), y para cada uno:
- registra el renderizador WebGL, para que sepas si una GPU real o SwiftShader dibujó los fotogramas;
- avanza el reloj del shader de manera determinista a lo largo de 12s y guarda fotogramas (ffmpeg → demo GIF/MP4);
- mide el contraste: oculta el texto, muestrea la escena detrás del titular y el subtítulo en cada fotograma, y toma la peor proporción contra el color del texto. Falla por debajo de 4.5:1 para cualquiera de los dos;
- cuenta las tintas: fuera de los recortes, cada píxel del canvas y del póster CSS debe ser la tinta base o la tinta de marca (
twoInksScene,twoInksPoster); - póster antes que canvas, desde el propio reloj de la página: un script de inicio muestrea cada fotograma renderizado y registra el primer fotograma en que el póster está en pantalla y el primer fotograma en que el canvas ha dibujado y no es transparente, además del tiempo de pintura y LCP;
- tiempo de fotograma en el pase GPU: intervalos rAF durante 3 s mientras el campo se ejecuta, mediana y p95;
- verifica que el canvas (no el póster) está en pantalla, que el campo se mueve, que el titular está a opacidad completa al cargar, que el movimiento reducido está estático, y que sin WebGL se muestra el póster sin canvas.
Medido el 2026-11-06 con el fixture (Chromium sin cabeza, ANGLE Metal Renderer: Apple M5 Pro), todas las comprobaciones pasaron para ambas formas:
| Forma | Peor titular / subtítulo | Píxeles de otra tinta (escena / póster) | Fotograma de póster → fotograma de canvas (pase GPU) | ms por fotograma (mediana / p95) |
|---|---|---|---|---|
| warp | 18.81 / 18.81 en los cuatro pases | 0 / 0 | 62 → 112 ms | 8.3 / 9.2 |
| ripple | 18.81 / 18.81 en los cuatro pases | 0 / 0 | 44 → 127 ms | 8.3 / 9.2 |
6. Port a Next.js / React
Renderiza la sección, el texto, el recorte y el póster como HTML/CSS plano (el póster no necesita JS). Genera las variables CSS en tiempo de compilación desde tokens.mjs --json, no en tiempo de ejecución. Monta la escena en una hoja 'use client':
useEffect(() => {
if (!probeWebGL2() || !ref.current) return; // el póster se queda; nada que limpiar
let m: { dispose(): void } | undefined;
(async () => {
const { ShaderMount, ditheringFragmentShader } = await import('@paper-design/shaders');
try { m = new ShaderMount(ref.current!, ditheringFragmentShader, uniforms, undefined, reduce ? 0 : speed, 8000, 1, 1920 * 1080); }
catch { /* mantener el póster */ }
})();
return () => m?.dispose();
}, []);
7. Atribución
Del experimento tf-shaders del propietario (skill/shader-landing/SKILL.md, RESEARCH.md, scripts/shoot.mjs, 2026-10): una escena más a lo sumo un acento, el presupuesto JS declarado, el póster CSS debajo de cada canvas, fondo en html, estado silencioso detrás del tipo, contraste verificado en el peor fotograma, texto del héroe en el primer fotograma, movimiento reducido como un cambio de estado y el bucle de captura de pantalla en GPU real. Esta skill añade la canalización de tokens, el tramado de dos tintas, el recorte, el contraste medido y la elección del tiempo de ejecución WebGL2.
No hacer
- No añadas un tercer color ni mezcles las dos tintas (degradados, superposiciones translúcidas, paneles difuminados). Dos tintas planas son el punto central; una mezcla entre tonos complementarios es barro.
- No uses un color que no sea un token de DESIGN.md, y nunca uses un color de estado (rojo de danger como tinta de marca).
- No pongas texto directamente sobre el campo de tramado. El texto va sobre el recorte; el texto pequeño tiene el suyo propio.
- No cambies shaders por punto de interrupción ni animes propiedades de tiempo de compilación. Cambiar un valor de tinta o
pxes una escritura de uniforme y está bien. - No apiles el héroe sobre un fondo de
body, ni desvanezcas el titular. - No cargues Paper y
shadersen la misma página.