Communitygithub.com

omd-cjk-type-shader

Un efecto, bien hecho: 먹 번짐 — un gran titular coreano, japonés o chino que parece tinta sumi impresa en papel hanji. El titular es texto DOM real, seleccionable desde el primer fotograma; una capa WebGL2 añade lo que la tinta real hace: un trazo húmedo y brillante con un halo suave que se encoge al secarse, acumulación de tinta más oscura en los bordes, puntas y esquinas del trazo, fibras de papel visibles en trazos gruesos y sangrado capilar solo en algunos bordes. Sobre fondo oscuro cambia automáticamente a 금니 en 감지 (pigmento dorado sobre papel índigo): sin sangrado, estado húmedo mate, granos que se asientan, un destello lento. Dos parámetros (sangrado, duración), ~5 KiB gzip de JS de librería, textura de papel procedural, degradado estático, prefers-reduced-motion y script de verificación en GPU real. Úsalo para un titular principal de lanzamiento, título de marca, línea de campaña o encabezado de sección CJK que deba sentirse como un póster de caligrafía impreso. Disparadores: '먹 번짐', '잉크 번짐', '한지 느낌 제목', '한글 타이포 셰이더', '제목에 셰이더', '墨のにじみ', '和紙', '筆文字っぽ...'

¿Qué es omd-cjk-type-shader?

Esta habilidad transforma un titular CJK (coreano, japonés o chino) en un elemento tipográfico que imita el efecto de tinta sumi sobre papel hanji o washi. El titular se mantiene como texto DOM real, seleccionable y accesible desde el primer fotograma, mientras que una capa WebGL2 (usando la librería `@paper-design/shaders`) añade dinámicamente: brillo húmedo que se desvanece al secarse, acumulación de tinta en bordes, visibilidad de fibras de papel y sangrado capilar controlado por ruido. Sobre fondos oscuros, el efecto cambia automáticamente a 금니 (pigmento dorado) sobre 감지 (papel índigo), sin sangrado y con un destello de granos de oro. Solo requiere dos parámetros ajustables (sangrado y duración), pesa aproximadamente 5 KiB gzip y no depende de imágenes externas, ya que la textura de papel se genera proceduralmente con SVG. Soporta plataformas modernas con WebGL2 y ofrece degradados elegantes para navegadores sin soporte de GPU o con prefers-reduced-motion. Incluye un script de verificación que prueba el efecto en GPU real, midiendo legibilidad, cambios de píxeles y comportamiento en modos reducidos. Es ideal para un máximo de uno o dos titulares por página, garantizando que el texto permanezca accesible, indexable y con un rendimiento optimizado para LCP (Largest Contentful Paint).

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 color calculado 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 #d4b062 del demo sobre #1a2440 es 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ámetroRangoPredeterminadoQué hace
bleed0–10.7Cuá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.
durations2.6Tiempo 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-text e inserta una capa aria-hidden="true", pointer-events: none sobre é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.mjs verifica 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-phrase se 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 lang en 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.ready para 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.81shaders 4.0.4 (shaders.com)
LicenciaApache-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/plantillapermitido; conserva NOTICE si distribuyes códigopermitido
RuntimeWebGL2: todos los navegadores de escritorio y móviles actualesSolo WebGPU, sin alternativa (Chrome/Edge, Android 12+ Chrome, Safari 26+, Firefox reciente)
JS para este efecto17.5 KiB min / 5.3 KiB gzip (esbuild, solo ShaderMount); CDN por archivo +esm 16.4 KiB / 5.0 KiB gzip2,535 KiB min / 710 KiB gzip (esbuild, Shader+MeshGradient de shaders/react)
Telemetríaninguna (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 + texturassí (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 durante duration y luego setSpeed(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 feTurbulence data URI en html (~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; ShaderMount lanza un error si no puede obtener un contexto o enlazar el programa): no se inserta ninguna capa, el titular recibe .ink-static (un tenue text-shadow CSS). El titular ya está en tinta sobre papel texturizado, por lo que está completo sin el sombreador. verify.mjs fuerza esta ruta simulando getContext.
  • 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, declara uniform 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:

FondoPíxeles del cuadro del titular cambiados por el sombreadorHúmedo vs secoLegibilidad 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.

Skills relacionados