O que omd-shader-hero — uma cena, duas tintas da marca faz?
Um herói de lançamento tem uma chance com alguém que não te deve nada. Gradientes mesh são o visual de shader mais genérico da web, e misturar dois tons complementares da marca os transforma em marrom. Esta skill faz o oposto: duas tintas planas, a cor base e uma cor da marca, impressas como um campo de pontilhado ordenado que se dobra lentamente como luz através de uma tela de serigrafia. Cada pixel é uma tinta ou outra, então nada se mistura e nada fica turvo. O texto fica sobre um recorte de borda dura na tinta base, como um painel recortado em um pôster risográfico.
O script escolhe ambas as tintas, a cor do texto e o contraste a partir de DESIGN.md. Nenhuma cor é escolhida por gosto.
Exemplo funcional: examples/hero.html, preenchido a partir do fictício examples/DESIGN.example.md. Scripts: scripts/tokens.mjs (tintas + contraste), scripts/verify.mjs (prova de renderização real).
1. Quando usar / quando não usar
Use quando:
- uma página de lançamento, produto, lista de espera, evento ou rebranding precisa de uma primeira tela com movimento;
- o projeto tem um
DESIGN.mdcom uma cor da marca e uma base escura (ou clara) (tokens Core v2 Foundations, pares de prosa do Foundations ou frontmattercolors:compatível com Google); - um visual gráfico, impresso e confiante se encaixa na marca.
Não use quando:
- não há DESIGN.md ou nenhuma cor da marca.
tokens.mjssai com código 3 e você para; executeomd-initou pergunte. Nunca escolha cores "bonitas" para preencher a lacuna (desconhecido significa ausente); - a marca é suave, fotográfica ou de luxo silencioso. Um campo de pontilhado é barulhento. Use a fotografia do briefing (tf-shaders "photo first");
- a página precisa de várias cenas de shader. Uma cena, mais no máximo um pequeno acento em outro lugar (regra tf-shaders). Para uma história de rolagem completa, use
omd-landing.
2. Procedimento
- Leia os tokens, não os escolha.
O script lê três formatos, nesta ordem: tokensnode <skill>/scripts/tokens.mjs DESIGN.md # imprime a decisão como JSON node <skill>/scripts/tokens.mjs DESIGN.md --scheme light # base clara em vez de escura- **color.<role>**: \#hex`, paresName (`#hex`)dentro da seção Foundations e então frontmattercolors:`. Em seguida, ele:- descarta papéis de estado e utilitários (danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active);
- pega o token mais escuro como a tinta base (o mais claro para
light); - pega uma tinta da marca: o papel chamado primary/brand se houver, senão a cor da marca mais saturada, ignorando qualquer uma muito próxima da base.
- A cor do texto é calculada. O script verifica os candidatos a texto (tokens de tinta/neutro no extremo oposto do esquema) contra ambas as tintas e seu ponto médio e escolhe o melhor. O texto então fica sobre um recorte opaco na tinta base, então a barra que ele deve ultrapassar é o token de texto sobre a tinta base. Com o dispositivo de teste, isso é 18.8:1. Se mesmo assim estiver abaixo de 4.5:1, o script avisa: escolha outro token de texto.
- Escreva o herói. Copie
examples/hero.html(ou porte-o, veja §6) e preencha:
Isso reescreve o bloco 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) e o JSON#hero-tokens. - O texto é real. Título + uma frase + um CTA. Use a linha de produto real do usuário. Nunca invente métricas, clientes ou investidores (tf-shaders §0).
- Verifique em uma GPU real (§5) e observe os quadros em tamanho real.
3. A cena e seus dois parâmetros
ditheringFragmentShader do Paper: type = 4x4 (Bayer ordenado), colorBack = tinta base, colorFront = tinta da marca, e uma das duas formas de campo escolhidas com data-shape em .hero-scene:
data-shape | Campo | Interpretação |
|---|---|---|
warp (padrão) | dobras diagonais lentas da luz da marca, escala 1 | um pôster risográfico, energia em dois cantos |
ripple | anéis concêntricos centrados no herói, atrás do texto, escala 0.5 | uma impressão com centro de gravidade: o texto fica no olho |
A forma é uma escolha de composição, não um terceiro parâmetro: a escala de cada forma é fixa para que suas células sejam lidas em px 2–6, e um valor desconhecido cai para warp. Ambas as formas permanecem duas tintas planas (verificado por contagem de pixels, §5). As outras formas de pontilhado do Paper e seus outros shaders foram deixados de fora: a maioria mistura as duas cores nas bordas, o que quebra a regra para a qual esta skill existe.
| Parâmetro | Faixa | Padrão | O que faz |
|---|---|---|---|
speed (data-speed) | 0–1 | 0.3 | Deriva das dobras. Acima de ~0.6 parece um protetor de tela. 0 congela o campo. |
px (data-px) | 2–6 CSS px | 3 | Tamanho da célula de pontilhado. 2 = tela fina, 3 = risográfico, 5–6 = impressão grossa. |
Regras de layout:
- Recorte, não véu. A caixa de texto fica em um painel opaco na tinta base com bordas duras (inset 2rem × 2.5rem ao redor do texto). Um véu translúcido, ou uma borda suave, sobreporia base sobre pontos da marca e recriaria a turvação. Texto pequeno (o rótulo do rodapé) também tem seu próprio recorte.
- Contraste: 4.5:1 para o título e o subtítulo. O título é grande o suficiente para que o WCAG aceitasse 3:1, mas esta skill não depende disso.
verify.mjsfalha abaixo de 4.5:1 para qualquer um. - O texto do herói é pintado no primeiro quadro: sem
opacity: 0, sem esperar pelo canvas. O canvas aparece gradualmente em 600ms sobre um pôster CSS já completo. - O pôster também é de duas tintas. Ele segue a forma (cantos para
warp, anéis pararipple, dispostos após o quadro estático) e obtém seu tom do tamanho do ponto em duas bandas de borda dura (quadrados 4×4 nos núcleos, 2×2 nas bordas), nunca de alfa: uma máscara desbotada misturaria marca sobre base. Pontos quadrados em pixels inteiros, como as células Bayer. - Tipografia coreana segue
/hangul:keep-all+overflow-wrap: anywhere, line-height 1.3, tracking -0.02em (nunca abaixo de -0.03em),text-wrap: balance,font-synthesis: none. - Fundo em
html, nunca embody(um fundo de body pinta sobre uma cena com z negativo; armadilha tf-shaders). - Raio, escala tipográfica e espaçamento vêm do DESIGN.md também. O dispositivo de teste não define raio, então o CTA é quadrado.
4. Biblioteca, licença, orçamento, fallback
Biblioteca: @paper-design/shaders 0.0.82 (vanilla ShaderMount + ditheringFragmentShader), WebGL2. 0.0.82 (2026-10-21) altera apenas shader-mount.js: dispose() agora libera o contexto WebGL. Licenças verificadas em 2026-10-13 a partir dos arquivos LICENSE dos tarballs npm, metadados npm e API de licença do GitHub:
@paper-design/shaders 0.0.81 | shaders 4.0.4 (shaders.com) | |
|---|---|---|
| Licença | Apache-2.0 (+ NOTICE "Paper Shaders, Copyright 2026 Paper") | MIT (© 2026 Shader Effects Inc.); dep typegpu 0.12.3 MIT |
| Runtime | WebGL2, quase universal | WebGPU apenas; canvas transparente e sem log quando não suportado |
| JS para esta cena | 23.7 KiB min / 7.0 KiB gzip (esbuild); CDN por arquivo +esm 5.0 + 2.9 KiB gzip | 2,535 KiB min / 710 KiB gzip (Shader + MeshGradient) |
| Telemetria | nenhuma | ativada por padrão (amostragem de 5% para shaders.com/api/telemetry); se precisar usar, passe disableTelemetry |
| Downloads semanais npm (2026-10-05..11) | 1,104,377 (-react) | 287,493 |
Paper vence em alcance, peso e telemetria. shaders é o caminho de upgrade apenas para um projeto que já envia cenas WebGPU. Lá, mantenha este pipeline de tokens, o recorte e o fallback, e passe disableTelemetry. Ambas as licenças permitem uso em skills e templates. O exemplo importa o Paper de uma URL CDN fixa e não o fornece. Se você fornecer os arquivos do Paper, copie seu NOTICE junto.
Orçamento:
- JS: 7.0 KiB gzip de biblioteca + 1.1 KiB gzip de código da cena.
- GPU: um quadrilátero em tela cheia, duas cores, pontilhado ordenado.
minPixelRatio: 1emaxPixelCount1920×1080, já que o tamanho da célula é a resolução. O Paper pausa fora da tela e em abas ocultas. - Sem imagens, sem vídeo, sem fonte além da face da UI.
Fallback (parte do design, não um pensamento posterior):
- Pôster de meio-tom CSS sob o canvas: pontos da tinta da marca na tinta base (
radial-gradientcélulas de 6px), mascarado em direção a dois cantos. É a primeira pintura, o caminho sem WebGL2 (ShaderMountlança erro sem contexto; a página testagetContext('webgl2')primeiro) e o estado quando a CDN está inacessível.verify.mjsforça este caminho. prefers-reduced-motion: reduce: velocidade 0 em um quadro fixo (STILL_FRAME, 8000ms). Isso é uma composição estática sem loop rAF.
5. Verifique em uma GPU real
npm i -D playwright-core && npx playwright-core install chromium # Playwright Chromium novo, não seu Chrome
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all
--shape warp|ripple|all define data-shape antes do módulo da página ser executado. Para cada forma, executa quatro passagens (GPU 1440px, mobile 390px, movimento reduzido, sem WebGL) com --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS), e para cada uma:
- registra o renderizador WebGL, para que você saiba se uma GPU real ou SwiftShader desenhou os quadros;
- avança o relógio do shader deterministicamente ao longo de 12s e salva quadros (ffmpeg → GIF/MP4 de demonstração);
- mede contraste: esconde o texto, amostra a cena atrás do título e subtítulo em cada quadro e calcula a pior proporção contra a cor do texto. Falha abaixo de 4.5:1 para qualquer um;
- conta as tintas: fora dos recortes, cada pixel do canvas e do pôster CSS deve ser a tinta base ou a tinta da marca (
twoInksScene,twoInksPoster); - pôster antes do canvas, a partir do relógio da própria página: um script de inicialização amostra cada quadro renderizado e registra o primeiro quadro em que o pôster está na tela e o primeiro quadro em que o canvas desenhou e não é transparente, além do tempo de pintura e LCP;
- tempo de quadro na passagem GPU: intervalos rAF por 3 s enquanto o campo roda, mediana e p95;
- verifica se o canvas (não o pôster) está na tela, se o campo se move, se o título está com opacidade total no carregamento, se o movimento reduzido está parado e se a versão sem WebGL mostra o pôster sem canvas.
Medido em 2026-11-06 com o dispositivo de teste (Chromium headless, ANGLE Metal Renderer: Apple M5 Pro), todas as verificações passaram para ambas as formas:
| Forma | Pior título / subtítulo | Pixels de outra tinta (cena / pôster) | Quadro do pôster → quadro do canvas (passagem GPU) | ms do quadro (mediana / p95) |
|---|---|---|---|---|
| warp | 18.81 / 18.81 em todas as quatro passagens | 0 / 0 | 62 → 112 ms | 8.3 / 9.2 |
| ripple | 18.81 / 18.81 em todas as quatro passagens | 0 / 0 | 44 → 127 ms | 8.3 / 9.2 |
6. Porte para Next.js / React
Renderize no servidor a seção, o texto, o recorte e o pôster como HTML/CSS simples (o pôster não precisa de JS). Gere as variáveis CSS em tempo de build a partir de tokens.mjs --json, não em tempo de execução. Monte a cena em uma folha 'use client':
useEffect(() => {
if (!probeWebGL2() || !ref.current) return; // pôster permanece; nada a limpar
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 { /* mantém o pôster */ }
})();
return () => m?.dispose();
}, []);
7. Atribuição
Do experimento tf-shaders do proprietário (skill/shader-landing/SKILL.md, RESEARCH.md, scripts/shoot.mjs, 2026-10): uma cena mais no máximo um acento, o orçamento JS declarado, o pôster CSS sob cada canvas, fundo em html, estado silencioso atrás do tipo, contraste verificado no pior quadro, texto do herói no primeiro quadro, movimento reduzido como mudança de estado e o loop de captura de tela em GPU real. Esta skill adiciona o pipeline de tokens, o pontilhado de duas tintas, o recorte, o contraste medido e a escolha de runtime WebGL2.
Não faça
- Não adicione uma terceira cor nem misture as duas tintas (gradientes, sobreposições translúcidas, painéis com bordas suaves). Duas tintas planas são o ponto principal; uma mistura entre tons complementares é lama.
- Não use uma cor que não seja um token do DESIGN.md, e nunca uma cor de estado (vermelho de perigo como tinta da marca).
- Não coloque texto diretamente no campo de pontilhado. O texto vai sobre o recorte; texto pequeno tem seu próprio.
- Não troque shaders por ponto de quebra nem anime propriedades de tempo de compilação. Alterar um valor de tinta ou
pxé uma escrita uniforme e é aceitável. - Não empilhe o herói sobre um fundo de
body, e não faça o título aparecer gradualmente. - Não carregue Paper e
shadersna mesma página.