omd-cjk-type-shader — 먹 번짐: tipografía CJK como tinta sumi en papel hanji
La tinta empapándose en el papel es la imagen que comparten las escrituras coreana, japonesa y china. Esta habilidad hace que un gran titular CJK parezca impreso o pintado con sumi en hanji. A primera vista, debe parecer un póster de caligrafía, no un filtro.
Cómo funciona. El titular es texto DOM normal con el color de la tinta, legible y seleccionable desde el primer fotograma. La habilidad rastrea cada grafema donde el navegador lo colocó y construye tres campos a partir de esa máscara: distancia fuera de los trazos, distancia dentro de ellos y cobertura local de tinta. Una capa WebGL2 dibujada sobre el texto añade solo lo que la tinta real hace:
- húmedo → seco: el trazo comienza brillante-oscuro con un halo suave a su alrededor, y el halo se encoge a medida que la tinta se seca;
- acumulación: la tinta se acumula más oscura a lo largo del borde del trazo y en las puntas y esquinas convexas (baja cobertura local);
- kasure: las fibras del papel se muestran a través del medio de trazos gruesos una vez secos;
- nijimi: el sangrado capilar corre a lo largo de algunas fibras de papel en algunos bordes, elegidos por ruido de baja frecuencia, nunca como un anillo uniforme alrededor de cada glifo;
- papel: una textura procedural de hanji (turbulencia SVG, sin imagen) en la página.
Sobre un fondo oscuro, la misma firma cambia a 금니 (金泥) sobre 감지 (紺紙). Los escribas de Goryeo escribían con polvo de oro mezclado con pegamento sobre papel teñido con índigo. El pigmento no se empapa como la tinta, así que esta variante nunca sangra ni tiene halo. El pegamento húmedo se ve mate y un poco más oscuro; al secarse, los granos se asientan y capturan la luz (un destello disperso), un brillo lento cruza la línea, las puntas y esquinas donde el pincel se detuvo se ven más ricas, y los trazos finos dejan ver el índigo. Se activa automáticamente cuando el color del titular es más claro que el fondo pintado más cercano (data-ink-ground="dark" o "light" lo fuerza). Cada color que dibuja es el color propio del titular, más oscuro o más brillante, o el del fondo.
Se reproduce una vez cuando el titular entra en el viewport, luego el bucle de renderizado se detiene. Los saltos de línea, keep-all, los cambios de fuente y los redimensionamientos se vuelven a rastrear.
Ejemplo funcional: examples/demo.html (archivo único, coreano + japonés + chino tradicional, sobre hanji y en una sección 감지). Prueba: scripts/verify.mjs.
1. Cuándo usar / cuándo no
Usar cuando:
- un titular de pantalla coreano, japonés o chino (≥ 40px; héroe, título de lanzamiento, línea de campaña, encabezado de sección) debe sentirse entintado, caligráfico, "impreso en hanji / washi / 宣紙";
- los colores de la tinta y el papel de la marca son conocidos (foreground/canvas en DESIGN.md, o el
colorcalculado del titular y el fondo pintado más cercano). Los fondos oscuros reciben la variante 금니: usa un color de texto claro y cálido con margen para oscurecer (el#d4b062del demo sobre#1a2440es 7.4:1).
No usar para:
- texto de cuerpo, etiquetas, botones, navegación, nada por debajo de ~32px (la acumulación y el sangrado necesitan grosor de trazo para leerse);
- titulares solo latinos (funciona, pero el sentido cultural se pierde);
- más de uno o dos titulares por página. La audacia en un solo lugar (regla de tf-shaders).
2. El efecto y sus dos parámetros
| Parámetro | Rango | Predeterminado | Qué hace |
|---|---|---|---|
bleed | 0–1 | 0.7 | Cuánto viaja el sangrado capilar a lo largo de las fibras (hasta 0.12em × bleed, en los bordes que el ruido elige) y cuán grande es el halo húmedo. 0.4 = apenas visible, 0.8 = un pincel mojado. |
duration | s | 2.6 | Tiempo de húmedo a seco. El halo alcanza su punto máximo temprano y se encoge; la acumulación y la visibilidad de las fibras aparecen al secarse. Menos de 1.5s se lee como un destello, más de 4s como un estado de carga. |
Todo lo demás está fijo a propósito. Tinta = el color calculado del titular, oscurecido al 25% para las acumulaciones; papel = el color de fondo de la página. La tinta del texto debe ser un gris-negro sumi, no negro puro (el demo usa #3a3530 sobre #f3eee4, aproximadamente 10:1), para que las acumulaciones más oscuras tengan espacio para mostrarse. Una firma, no un panel de control.
3. El contrato que mantiene el texto como texto
- El titular es un
<h1>/<h2>normal con su texto real.inkBleed()envuelve el texto en.ink-texte inserta una capaaria-hidden="true",pointer-events: nonesobre él (z-index 2). La capa solo oscurece, aclara o extiende lo que ya está allí. Nunca reemplaza ni redibuja los glifos, y al eliminar la capa, el titular sigue completo. - El titular se pinta en el primer fotograma. Sin
opacity: 0, sin clip, sin esperar al sombreador. tf-shaders midió que LCP llegaba a 7.8s cuando el texto del héroe esperaba a un sombreador. - La selección, copia, buscar en página, traducción, lectores de pantalla y SEO ven texto plano.
verify.mjsverifica que seleccionar el titular devuelve todo su texto en cada pasada. - Deja aproximadamente 0.4 em de espacio despejado alrededor del titular (el demo usa
margin-bottom: 0.4em). El sangrado y el halo se extienden hasta ~0.3 em más allá de los glifos. - Nunca dibujes titulares CJK con un componente de sombreador de lienzo/
Text. El texto en lienzo pierde selección, accesibilidad, indexación y la forma CJK correcta (lista de "No hacer" de tf-shaders).
4. Tipografía CJK (se aplica antes del sombreador)
De /hangul (reglas HG) para coreano; ja/zh con alcance separado para que las reglas coreanas no se filtren:
.ink:lang(ko) { word-break: keep-all; overflow-wrap: anywhere; /* HG-10, con alcance en :lang(ko) */
letter-spacing: -0.02em; /* HG-7: display nunca por debajo de -0.03em */
line-height: 1.3; } /* HG-5: display con wrapping >= 1.3 */
.ink:lang(ja), .ink:lang(zh-Hant) {
line-break: strict; /* kinsoku: sin kana pequeño / marcas de cierre al inicio de línea */
word-break: keep-all; overflow-wrap: anywhere; /* romper solo en marcas de frase <wbr> que coloques */
letter-spacing: 0; line-height: 1.4; }
:lang(ko), :lang(ja), :lang(zh) { font-synthesis: none; } /* sin negrita/cursiva falsa en CJK */
- Marca los límites de frase en japonés/chino con
<wbr>(estilo BudouX: 墨がにじむように、<wbr>名前が<wbr>紙に染みこむ。). En headless Chrome 149,word-break: auto-phrasese calculó correctamente pero no produjo saltos de frase en este demo, así que no confíes en ello. - Coreano: saltos de línea solo en espacios entre 어절, nunca sílaba por sílaba. Coloca manualmente los saltos de línea del display cuando el redactor se preocupe (tf-shaders
cjk-type.md). - Establece
langen el titular (ko,ja,zh-Hant/zh-Hans). Elige las variantes de glifo correctas para puntos de código Han compartidos y da alcance a las reglas anteriores. - Fuentes: usa una cara que incluya el peso que establezcas (HG-12). El demo usa Noto Serif KR / JP / TC 700 de Google Fonts, que carga solo los fragmentos de glifos que usa la página. Una cara myeongjo/mincho/song es adecuada para tinta. Pretendard también funciona. Traza después de
document.fonts.readypara que el campo siga a la cara real, no a la alternativa.
5. Librería, licencia, presupuesto
Librería: @paper-design/shaders (vanilla ShaderMount), anclada en 0.0.82 (2026-10-21; dispose() ahora libera el contexto WebGL), WebGL2. Registro de decisión (verificado 2026-10-13 a partir de 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 (LICENSE + NOTICE "Paper Shaders, Copyright 2026 Paper") | MIT (© 2026 Shader Effects Inc.); dep typegpu 0.12.3 MIT (Software Mansion) |
| Redistribución en una skill/plantilla | permitido; conserva NOTICE si distribuyes código | permitido |
| Runtime | WebGL2: todos los navegadores de escritorio y móviles actuales | Solo WebGPU, sin alternativa (Chrome/Edge, Android 12+ Chrome, Safari 26+, Firefox reciente) |
| JS para este efecto | 17.5 KiB min / 5.3 KiB gzip (esbuild, solo ShaderMount); CDN por archivo +esm 16.4 KiB / 5.0 KiB gzip | 2,535 KiB min / 710 KiB gzip (esbuild, Shader+MeshGradient de shaders/react) |
| Telemetría | ninguna (su único fetch() lee el tipo de contenido de un blob local) | activada por defecto: muestrea el 5% de las sesiones a shaders.com/api/telemetry; pasa disableTelemetry |
| GLSL personalizado + texturas | sí (ShaderMount(el, frag, uniforms), uniformes de imagen) | a través de su gráfico de componentes |
El efecto necesita un shader de fragmentos personalizado y una textura, que es exactamente para lo que es ShaderMount, con 1/130 del peso del runtime WebGPU y el doble de alcance de navegadores. El demo importa Paper desde jsDelivr (anclado, compilación por archivo) y no lo distribuye, por lo que no se necesita una copia de NOTICE. Si distribuyes los archivos de Paper, copia su NOTICE junto a ellos. Si un proyecto ya incluye shaders, este efecto aún se ejecuta con Paper. No cargues ambos runtimes en una sola página.
Presupuesto para un titular:
- JS: 5.0–5.3 KiB gzip de librería + 5.3 KiB gzip de código de efecto (sombreador, dos transformaciones de distancia, desenfoque de cobertura, trazado; medido sin minificar con comentarios).
- GPU: un cuadrilátero, una búsqueda de textura y 7 llamadas de ruido de valor por píxel, sobre el cuadro del titular más un relleno ≤0.32em,
minPixelRatio: 1, limitado a 1920×1080 px. Se ejecuta durantedurationy luegosetSpeed(0)detiene el bucle rAF. Paper también lo pausa fuera de la pantalla y en pestañas ocultas. - CPU: por cambio de maquetación (cambio de fuente, redimensionamiento, cambio de ajuste; debounced 120ms), dos transformaciones de distancia euclidiana (fuera y dentro de los trazos) y un desenfoque de caja separable, a la mitad de resolución para tipografías mayores de 64px.
- Textura de papel: un SVG inline
feTurbulencedata URI enhtml(~600 bytes), sin solicitud de imagen. - Las fuentes son el costo real. Las caras CJK son grandes. Carga solo el peso de display, como fragmentos de rango unicode.
6. Degradado y movimiento reducido
- Sin WebGL2 (sondea
canvas.getContext('webgl2')antes de montar;ShaderMountlanza un error si no puede obtener un contexto o enlazar el programa): no se inserta ninguna capa, el titular recibe.ink-static(un tenuetext-shadowCSS). El titular ya está en tinta sobre papel texturizado, por lo que está completo sin el sombreador.verify.mjsfuerza esta ruta simulandogetContext. prefers-reduced-motion: reduce: monta en el fotograma seco con velocidad 0. El lector obtiene el estado final entintado como un solo fotograma fijo, sin movimiento y sin bucle rAF.- Fallo de compilación del sombreador (uno ocurrió al construir esto: un desajuste de precisión con el sombreador de vértices de Paper) toma la misma ruta
.ink-static. En tu propio GLSL, declarauniform mediump vec2 u_resolution;, porque la precisión debe coincidir con el sombreador de vértices de Paper.
7. Verificar en una GPU real
next build o un lint exitoso no prueban nada para sombreadores (regla de tf-shaders). Ejecuta:
npm i -D playwright-core && npx playwright-core install chromium # un Playwright Chromium fresco, no tu propio Chrome
node <skill>/scripts/verify.mjs path/to/page.html ./ink-verify --frames 36
Lanza Chromium sin cabeza con --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS) y ejecuta tres pasadas: GPU, movimiento reducido, sin WebGL. Mide el primer titular en cada fondo (data-ink-ground="light" y "dark"). Luego:
- registra la cadena del renderizador WebGL, para que sepas si una GPU real o SwiftShader dibujó los fotogramas;
- avanza el reloj del sombreador de manera determinista y guarda los fotogramas (aliméntalos a ffmpeg para el GIF/MP4 del demo);
- prueba el renderizado con píxeles: sombreador activado vs desactivado dentro del cuadro del titular, y primer fotograma vs fotograma seco;
- mide la legibilidad a lo largo de todo el efecto: los núcleos de los glifos (texto activado vs texto transparente) tal como se dibujan en cada fotograma muestreado contra el papel detrás de ellos, percentil 10 para que los bordes suavizados no decidan, fotograma peor. Los titulares de display son texto grande WCAG, por lo que el umbral es 3:1;
- verifica que el texto seleccionado sea igual al texto del titular, que la capa sea
aria-hidden+pointer-events: none, que el movimiento reducido esté quieto, y que sin WebGL no quede ningún lienzo.
Medido el 2026-11-06 (headless Chromium, ANGLE Metal Renderer: Apple M5 Pro, no SwiftShader), todas las comprobaciones pasaron:
| Fondo | Píxeles del cuadro del titular cambiados por el sombreador | Húmedo vs seco | Legibilidad de glifos (p10, fotograma peor) |
|---|---|---|---|
claro (sumi en hanji, #3a3530 en #f3eee4) | 10.2% | 5.9% | 8.01:1 |
oscuro (금니 en 감지, #d4b062 en #1a2440) | 8.8% | 8.7% | 4.58:1 |
| Mira los fotogramas de todos modos, a tamaño completo: un campo desalineado (línea base incorrecta) se muestra como acumulación desplazada de los trazos, y una configuración de sangrado demasiado fuerte se lee como pelusa. Solo tus ojos capturan esas cosas. |
8. Puerto a Next.js / React
Mantén la misma función y ciclo de vida en una hoja '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(); }, []). Renderiza el titular en el servidor como texto plano, de modo que el sombreador solo lo decore después de la hidratación. No uses <ShaderMount> de @paper-design/shaders-react aquí: no te da la sonda WebGL2, la clase de degradado ni el control sobre cuándo se vuelve a trazar el campo.
9. Atribución
El marco de presupuesto primero, la regla de "el degradado es diseño", la regla de LPC del primer fotograma, las revelaciones de 어절 no sílaba, keep-all y el bucle de capturas de pantalla en GPU real provienen del experimento tf-shaders del propietario (skill/shader-landing/SKILL.md, references/cjk-type.md, scripts/shoot.mjs, RESEARCH.md, 2026-10). Los valores de tipografía coreana provienen de la skill /hangul de OmD. La transformación de distancia es la EDT de tiempo lineal de Felzenszwalb & Huttenlocher, escrita aquí desde cero. La variante de fondo oscuro sigue un patrón indicado en print3d.js de Leonxlnx/taste-skill (MIT), "sobre papel oscuro la tinta es la luz": el tratamiento se invierte, no solo se recolorea. No se copió código; el modelo dorado está escrito desde cero a partir de la práctica 감지금니.
No hacer
- No ocultes el titular hasta que el sombreador esté listo. El texto es el contenido; la tinta es el marco.
- No animes sílaba por sílaba, y no dividas Hangul en tramos por carácter para una revelación.
- No ejecutes el bucle para siempre. Un efecto de tinta seca no cuesta nada; uno en bucle agota las baterías.
- No pongas dos runtimes (Paper +
shaders) en una página para un solo titular. - No sangres cada borde ni dibujes un halo uniforme. Un anillo uniforme alrededor de cada glifo se lee como una pegatina, no como tinta; el sangrado pertenece a unos pocos bordes.
- No uses tinta de texto negra pura. Las acumulaciones necesitan un valor más oscuro para mostrarse, y el sumi es gris-negro.