Communitygithub.com

omd-cjk-type-shader

Um efeito, bem feito: 먹 번짐 — um grande título de exibição coreano, japonês ou chinês que se lê como tinta sumi impressa em hanji. O título permanece real, com texto DOM selecionável na cor da tinta desde o primeiro quadro; uma camada WebGL2 sobreposta adiciona o que a tinta real faz: um traço úmido e brilhante com um brilho suave que encolhe ao secar, acúmulo de tinta mais escuro nas bordas, pontas e cantos do traço, fibras de papel aparecendo em traços grossos e espalhamento capilar ao longo das fibras em apenas algumas bordas. Em um fundo escuro, muda automaticamente para 금니 em 감지 (pigmento dourado em papel índigo): sem espalhamento, um estado úmido fosco, grãos se assentando, um brilho lento. Dois parâmetros (sangramento, duração), ~5 KiB gzip de JS de biblioteca, textura de papel procedural, fallback estático, prefers-reduced-motion, script de verificação em GPU real. Use para um título principal/de lançamento CJK, título de marca, linha de campanha ou abertura de seção que deve parecer um pôster de caligrafia impresso. Gatilhos: '먹 번짐', '잉크 번짐', '한지 느낌 제목', '한글 타이포 셰이더', '제목에 셰이더', '墨のにじみ', '和紙', '筆文字っぽ...

O que é omd-cjk-type-shader?

Este skill transforma títulos grandes em coreano, japonês ou chinês (CJK) para que pareçam impressos ou pintados com tinta sumi em papel hanji, mantendo o texto como DOM real selecionável e acessível desde o primeiro quadro. Ele usa uma camada WebGL2 sobreposta que adiciona efeitos realistas de tinta, como brilho úmido, acúmulo de tinta nas bordas, fibras de papel aparecendo e espalhamento capilar, tudo controlado por dois parâmetros simples (sangramento e duração). Em fundos escuros, o efeito muda automaticamente para o estilo 금니 (pigmento dourado) sobre 감지 (papel índigo), sem espalhamento, com um brilho seco e grãos se assentando. O skill é projetado para plataformas como Claude Code, Cursor e Codex, com um orçamento enxuto de cerca de 5 KiB gzip de JS de biblioteca, fallback para navegadores sem WebGL2 e suporte a prefers-reduced-motion. Inclui um script de verificação que testa o efeito em GPU real para garantir legibilidade e desempenho. Use para títulos de herói ou campanha que exijam uma sensação caligráfica impressa.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-cjk-type-shader/tree/main

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

omd-cjk-type-shader — 먹 번짐: texto de exibição CJK como tinta sumi em hanji

Tinta encharcando papel é a imagem que as escritas coreana, japonesa e chinesa compartilham. Este skill faz um grande título CJK parecer como se tivesse sido impresso ou pincelado em sumi sobre hanji. Em uma olhada rápida, deve parecer um pôster de caligrafia, não um filtro.

Como funciona. O título é texto DOM comum na cor da tinta, legível e selecionável desde o primeiro quadro. O skill traça cada grafema onde o navegador o posicionou e constrói três campos a partir dessa máscara: distância fora dos traços, distância dentro deles e cobertura local de tinta. Uma camada WebGL2 desenhada sobre o texto adiciona apenas o que a tinta real faz:

  • úmido → seco: o traço começa brilhante-escuro com um brilho suave ao redor, e o brilho encolhe à medida que a tinta seca;
  • acúmulo: a tinta se acumula mais escura ao longo da borda do traço e nas pontas e cantos convexos dos traços (baixa cobertura local);
  • kasure: fibras de papel aparecem no meio de traços grossos depois que secam;
  • nijimi: espalhamento capilar corre ao longo de algumas fibras de papel em algumas bordas, escolhidas por ruído de baixa frequência, nunca como um anel uniforme ao redor de cada glifo;
  • papel: uma textura procedural de hanji (turbulência SVG, sem imagem) na página.

Em um fundo escuro, a mesma assinatura muda para 금니(金泥) em 감지(紺紙). Escribas de sutras Goryeo escreviam com pó de ouro misturado com cola em papel tingido de índigo. O pigmento não encharca como a tinta, então esta variante nunca espalha e não tem brilho. A cola úmida parece fosca e um pouco mais escura; à medida que seca, os grãos se assentam e capturam a luz (um brilho esparso), um brilho lento cruza a linha, pontas e cantos onde o pincel pausou parecem mais ricos, e passagens finas deixam o índigo aparecer. Ativa-se sozinho quando a cor do título é mais clara que o fundo pintado mais próximo (data-ink-ground="dark" ou "light" força). Cada cor que desenha é a própria cor do título, mais escura ou mais clara, ou a do fundo.

É executado uma vez quando o título entra no viewport, então o loop de renderização para. Quebra de linha, keep-all, trocas de fonte e redimensionamentos são retraçados.

Exemplo funcional: examples/demo.html (arquivo único, coreano + japonês + chinês tradicional, em hanji e em uma seção 감지). Prova: scripts/verify.mjs.

1. Quando usar / quando não usar

Use quando:

  • um título de exibição coreano, japonês ou chinês (≥ 40px; herói, título de lançamento, linha de campanha, abertura de seção) deve parecer entintado, caligráfico, "impresso em hanji / washi / 宣紙";
  • as cores de tinta e papel da marca são conhecidas (DESIGN.md foreground/canvas, ou o color computado do título e o fundo pintado mais próximo). Fundos escuros recebem a variante 금니: use uma cor de texto clara e quente com espaço para escurecer (o #d4b062 do demo sobre #1a2440 é 7,4:1).

Não use para:

  • texto de corpo, rótulos, botões, navegação, qualquer coisa abaixo de ~32px (acúmulo e espalhamento precisam de largura de traço para serem lidos);
  • títulos apenas em latim (funciona, mas o ponto cultural se perde);
  • mais de um ou dois títulos por página. Ousadia em um lugar (regra de tf-shaders).

2. O efeito e seus dois parâmetros

ParâmetroFaixaPadrãoO que faz
bleed0–10,7Até onde o espalhamento capilar viaja ao longo das fibras (até 0,12em × bleed, nas bordas que o ruído escolhe) e quão grande o brilho úmido fica. 0,4 = quase imperceptível, 0,8 = um pincel molhado.
durations2,6Tempo do úmido ao seco. O brilho atinge o pico cedo e encolhe; acúmulo e aparecimento de fibras vêm à medida que seca. Abaixo de 1,5s parece um flash, acima de 4s parece um estado de carregamento.

Todo o resto é fixo de propósito. Tinta = color computado do título, escurecido para 25% para acúmulos; papel = cor de fundo da página. A tinta do texto deve ser um preto-acinzentado sumi, não preto puro (o demo usa #3a3530 sobre #f3eee4, cerca de 10:1), para que os acúmulos mais escuros tenham espaço para aparecer. Uma assinatura, não um painel de controle.

3. O contrato que mantém o texto como texto

  • O título é um <h1>/<h2> normal com seu texto real. inkBleed() envolve o texto em .ink-text e insere uma camada aria-hidden="true", pointer-events: none sobre ele (z-index 2). A camada apenas escurece, clareia ou estende o que já está lá. Nunca substitui ou redesenha os glifos, e com a camada removida o título ainda está completo.
  • O título é pintado no primeiro quadro. Sem opacity: 0, sem clip, sem esperar pelo shader. O tf-shaders mediu LCP indo para 7,8s quando o texto do herói esperava por um shader.
  • Seleção, cópia, encontrar na página, tradução, leitores de tela e SEO veem texto simples. verify.mjs verifica que selecionar o título retorna seu texto completo em cada passagem.
  • Deixe cerca de 0,4em de espaço claro ao redor do título (o demo usa margin-bottom: 0.4em). O espalhamento e o brilho se estendem até ~0,3em além dos glifos.
  • Nunca desenhe títulos CJK com um componente de shader canvas/Text. Texto em canvas perde seleção, acessibilidade, indexação e o correto shaping CJK (lista de "Não fazer" do tf-shaders).

4. Tipografia CJK (aplica-se antes do shader)

De /hangul (regras HG) para coreano; ja/zh com escopo separado para que as regras coreanas não vazem:

.ink:lang(ko) { word-break: keep-all; overflow-wrap: anywhere;  /* HG-10, com escopo :lang(ko) */
                letter-spacing: -0.02em;                          /* HG-7: display nunca abaixo de -0.03em */
                line-height: 1.3; }                               /* HG-5: quebra de display >= 1.3 */
.ink:lang(ja), .ink:lang(zh-Hant) {
  line-break: strict;                                 /* kinsoku: sem kana pequeno / marcas de fechamento no início da linha */
  word-break: keep-all; overflow-wrap: anywhere;      /* quebra apenas em marcas de frase <wbr> que você coloca */
  letter-spacing: 0; line-height: 1.4; }
:lang(ko), :lang(ja), :lang(zh) { font-synthesis: none; } /* sem negrito/itálico falso em CJK */
  • Marque limites de frases japonesas/chinesas com <wbr> (estilo BudouX: 墨がにじむように、<wbr>名前が<wbr>紙に染みこむ。). No headless Chrome 149, word-break: auto-phrase computou corretamente, mas não produziu quebras de frase neste demo, então não confie nele.
  • Coreano: quebras de linha apenas em espaços entre 어절, nunca sílaba por sílaba. Coloque manualmente quebras de linha de exibição quando o redator se importar (tf-shaders cjk-type.md).
  • Defina lang no título (ko, ja, zh-Hant/zh-Hans). Ele escolhe as variantes de glifo corretas para pontos de código Han compartilhados e define o escopo das regras acima.
  • Fontes: use uma face que forneça o peso que você definiu (HG-12). O demo usa Noto Serif KR / JP / TC 700 do Google Fonts, que carrega apenas as fatias de glifo que a página usa. Uma face myeongjo/mincho/song combina com tinta. Pretendard também funciona. Trace após document.fonts.ready para que o campo siga a face real, não a fallback.

5. Biblioteca, licença, orçamento

Biblioteca: @paper-design/shaders (vanilla ShaderMount), fixado em 0.0.82 (2026-10-21; dispose() agora libera o contexto WebGL), WebGL2. Registro de decisão (verificado 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.81shaders 4.0.4 (shaders.com)
LicençaApache-2.0 (LICENSE + NOTICE "Paper Shaders, Copyright 2026 Paper")MIT (© 2026 Shader Effects Inc.); dep typegpu 0.12.3 MIT (Software Mansion)
Redistribuição em um skill/templatepermitido; mantenha NOTICE se você vender o códigopermitido
RuntimeWebGL2: todos os navegadores desktop e mobile atuaisApenas WebGPU, sem fallback (Chrome/Edge, Android 12+ Chrome, Safari 26+, Firefox recente)
JS para este efeito17.5 KiB min / 5.3 KiB gzip (esbuild, apenas ShaderMount); CDN por arquivo +esm 16.4 KiB / 5.0 KiB gzip2,535 KiB min / 710 KiB gzip (esbuild, Shader+MeshGradient de shaders/react)
Telemetrianenhum (seu único fetch() lê o tipo de conteúdo de um blob local)ligado por padrão: amostra 5% das sessões para shaders.com/api/telemetry; passe disableTelemetry
GLSL personalizado + texturassim (ShaderMount(el, frag, uniforms), image uniforms)via seu grafo de componentes

O efeito precisa de um fragment shader personalizado e uma textura, que é exatamente o que ShaderMount é, com 1/130 do peso do runtime WebGPU e com o dobro do alcance do navegador. O demo importa Paper do jsDelivr (fixado, build por arquivo) e não o vende, então nenhuma cópia de NOTICE é necessária. Se você vender os arquivos do Paper, copie seu NOTICE junto. Se um projeto já enviar shaders, este efeito ainda funciona no Paper. Não carregue ambos os runtimes em uma página.

Orçamento para um título:

  • JS: 5.0–5.3 KiB gzip biblioteca + 5.3 KiB gzip de código do efeito (shader, duas transformadas de distância, desfoque de cobertura, rastreamento; medido não minificado com comentários).
  • GPU: um quad, uma consulta de textura e 7 chamadas de ruído de valor por pixel, sobre a caixa do título mais um preenchimento de ≤0.32em, minPixelRatio: 1, limitado a 1920×1080 px. Executa por duration e então setSpeed(0) para o loop rAF. Paper também pausa fora da tela e em abas ocultas.
  • CPU: por mudança de layout (troca de fonte, redimensionamento, requebra; debounced 120ms), duas transformadas de distância euclidiana (fora e dentro dos traços) e um desfoque de caixa separável, em meia resolução acima de texto de 64px.
  • Textura de papel: um data URI de feTurbulence SVG inline em html (~600 bytes), sem requisição de imagem.
  • Fontes são o custo real. Faces CJK são grandes. Carregue apenas o peso de exibição, como fatias de unicode-range.

6. Fallback e movimento reduzido

  • Sem WebGL2 (teste canvas.getContext('webgl2') antes de montar; ShaderMount lança erro se não conseguir um contexto ou vincular o programa): nenhuma camada é inserida, o título recebe .ink-static (um text-shadow CSS fraco). O título já está em tinta sobre papel texturizado, então está completo sem o shader. verify.mjs força este caminho ao simular getContext.
  • prefers-reduced-motion: reduce: monta no quadro seco com velocidade 0. O leitor obtém o estado final entintado como um quadro estático, sem movimento e sem loop rAF.
  • Falha de compilação do shader (uma aconteceu durante a construção: uma incompatibilidade de precisão com o vertex shader do Paper) segue o mesmo caminho .ink-static. Em seu próprio GLSL, declare uniform mediump vec2 u_resolution;, pois a precisão deve corresponder ao vertex shader do Paper.

7. Verifique em uma GPU real

next build ou um lint aprovado não prova nada para shaders (regra tf-shaders). Execute:

npm i -D playwright-core && npx playwright-core install chromium   # um Playwright Chromium novo, não seu próprio Chrome
node <skill>/scripts/verify.mjs path/to/page.html ./ink-verify --frames 36

Ele inicia Chromium headless com --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS) e executa três passes: GPU, movimento reduzido, sem WebGL. Ele mede o primeiro título em cada fundo (data-ink-ground="light" e "dark"). Em seguida:

  • registra a string do renderizador WebGL, para que você saiba se uma GPU real ou SwiftShader desenhou os quadros;
  • avança o relógio do shader deterministicamente e salva quadros (alimente-os ao ffmpeg para o GIF/MP4 do demo);
  • prova a renderização com pixels: shader ligado vs shader desligado dentro da caixa do título, e primeiro quadro vs quadro seco;
  • mede a legibilidade durante todo o efeito: os núcleos dos glifos (texto ligado vs texto transparente) conforme desenhados em cada quadro amostrado contra o papel atrás deles, 10º percentil para que bordas anti-aliasing não decidam, pior quadro. Títulos de exibição são texto grande WCAG, então a barra é 3:1;
  • verifica que o texto selecionado é igual ao texto do título, a camada é aria-hidden + pointer-events: none, movimento reduzido é estático, e sem WebGL não deixa canvas.

Medido em 2026-11-06 (Chromium headless, ANGLE Metal Renderer: Apple M5 Pro, não SwiftShader), todas as verificações passaram:

FundoPixels da caixa do título alterados pelo shaderÚmido vs secoLegibilidade do glifo (p10, pior quadro)
claro (sumi em hanji, #3a3530 sobre #f3eee4)10,2%5,9%8,01:1
escuro (금니 em 감지, #d4b062 sobre #1a2440)8,8%8,7%4,58:1

Olhe os quadros de qualquer forma, em tamanho real: um campo desalinhado (linha de base errada) aparece como acúmulo deslocado dos traços, e uma configuração de espalhamento muito forte parece pelo. Apenas seus olhos captam isso.

8. Port para Next.js / React

Mantenha a mesma função e ciclo de vida em uma folha 'use client': useEffect(() => { let h; document.fonts.ready.then(async () => { const { ShaderMount } = await import('@paper-design/shaders'); h = await inkBleed(ref.current, { bleed, duration }); }); return () => h?.mount.dispose(); }, []). Renderize o título no lado do servidor como texto simples, para que o shader apenas o decore após a hidratação. Não use @paper-design/shaders-react's <ShaderMount> aqui: ele não fornece o teste WebGL2, a classe fallback ou o controle sobre quando o campo é retraçado.

9. Atribuição

O enquadramento de orçamento primeiro, a regra de fallback-é-design, a regra LCP do primeiro quadro, revelações de 어절-não-sílaba, keep-all e o loop de captura de tela em GPU real vêm do experimento tf-shaders do proprietário (skill/shader-landing/SKILL.md, references/cjk-type.md, scripts/shoot.mjs, RESEARCH.md, 2026-10). Os valores de tipo coreano vêm do skill /hangul do OmD. A transformada de distância é a EDT de tempo linear de Felzenszwalb & Huttenlocher, escrita aqui do zero. A variante de fundo escuro segue um padrão declarado em print3d.js de Leonxlnx/taste-skill (MIT), "em papel escuro a tinta é a luz": o tratamento inverte, não apenas recoloriza. Nenhum código foi copiado; o modelo dourado é escrito do zero a partir da prática 감지금니.

Não faça

  • Não esconda o título até o shader estar pronto. O texto é o conteúdo; a tinta é o quadro.
  • Não anime sílaba por sílaba, e não divida Hangul em spans por caractere para uma revelação.
  • Não execute o loop para sempre. Um efeito de tinta seca não custa nada; um looping drena baterias.
  • Não coloque dois runtimes (Paper + shaders) em uma página para um título.
  • Não espalhe todas as bordas ou desenhe um halo uniforme. Um anel uniforme ao redor de cada glifo parece um adesivo, não tinta; espalhamento pertence a algumas bordas.
  • Não use tinta de texto preta pura. Poças precisam de um valor mais escuro para aparecer, e sumi é preto-acinzentado...

Habilidades Relacionadas