Communitygithub.com

omd-cjk-type-shader — 먹 번짐 : Titres CJK comme encre sumi sur ha…

Un effet unique, bien réalisé : 먹 번짐 — un grand titre d'affichage coréen, japonais ou chinois qui se lit comme de l'encre sumi imprimée sur du hanji. Le titre reste un texte DOM réel et sélectionnable, de la couleur de l'encre dès la première image ; une couche WebGL2 par-dessus ajoute ce que fait l'encre réelle : un trait brillant et humide avec un halo doux qui rétrécit en séchant, une accumulation plus sombre de l'encre aux bords, extrémités et coins du trait, des fibres de papier visibles à travers les traits épais, et un effet capillaire le long des fibres sur quelques bords seulement. Sur un fond sombre, il bascule automatiquement en 금니 sur 감지 (pigment d'or sur papier indigo) : pas d'effet capillaire, un état humide terne, des grains qui se déposent, un lent reflet. Deux paramètres (débordement, durée), ~5 Ko gzip de bibliothèque JS, texture de papier procédurale, repli statique, préfère-mouvement-réduit, script de vérification sur GPU réel. À utiliser pour un titre CJK hero/lancement, un titre de marque, une ligne de campagne ou un ouvre-section qui doit ressembler à une affiche de calligraphie imprimée. Déclencheurs : '먹 번짐', '잉크 번짐', '한지 느낌 제목', '한글 타이포 셰이더', '제목에 셰이더', '墨のにじみ', '和紙', '筆文字っぽ...'

Qu'est-ce que omd-cjk-type-shader — 먹 번짐 : Titres CJK comme encre sumi sur ha… ?

Ce skill applique un effet d'encre sumi réaliste à un titre d'affichage CJK (coréen, japonais, chinois) en utilisant une couche WebGL2 superposée à un texte DOM standard. Le titre reste du texte réel, sélectionnable et indexable par les moteurs de recherche dès la première image, tandis que le shader ajoute des effets d'encre dynamiques : un trait humide brillant avec un halo qui rétrécit en séchant, une accumulation plus sombre aux bords et extrémités des traits, des fibres de papier visibles, et un effet capillaire sur quelques bords seulement (pas un liseré uniforme). Sur fond sombre, l'effet bascule automatiquement en '금니 sur 감지' (pigment d'or sur papier indigo), sans effet capillaire, avec un état humide terne et un lent reflet. Le skill ne nécessite qu'environ 5 Ko gzip de code JavaScript, utilise une texture de papier procédurale (SVG turbulence, sans image), et offre un repli statique en l'absence de WebGL2 ou pour 'prefers-reduced-motion'. Il est compatible avec les frameworks modernes (Next.js, React) via une fonction `'use client'` et inclut un script de vérification sur GPU réel pour garantir la qualité du rendu. L'effet est contrôlé par deux paramètres simples (débordement et durée) et s'applique idéalement à un ou deux titres par page, de préférence en taille d'affichage (≥40px).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

omd-cjk-type-shader — 먹 번짐 : Titres d'affichage CJK comme encre sumi sur hanji

L'encre qui imprègne le papier est l'image que partagent les écritures coréenne, japonaise et chinoise. Ce skill donne à un grand titre CJK l'aspect d'une impression ou d'un pinceau à l'encre sumi sur du hanji. À un coup d'œil rapide, il doit ressembler à une affiche de calligraphie, pas à un filtre.

Comment ça fonctionne. Le titre est un texte DOM ordinaire de la couleur de l'encre, lisible et sélectionnable dès la première image. Le skill suit chaque graphème là où le navigateur l'a disposé et construit trois champs à partir de ce masque : la distance à l'extérieur des traits, la distance à l'intérieur, et la couverture locale de l'encre. Une couche WebGL2 dessinée par-dessus le texte ajoute ensuite uniquement ce que fait l'encre réelle :

  • humide → sec : le trait commence brillant et sombre avec un halo doux autour, et le halo rétrécit à mesure que l'encre sèche ;
  • accumulation : l'encre s'accumule plus sombre le long du bord du trait et aux extrémités et aux coins convexes (faible couverture locale) ;
  • kasure : les fibres du papier apparaissent au milieu des traits épais une fois secs ;
  • nijimi : l'effet capillaire se propage le long de quelques fibres de papier à certains bords, choisis par un bruit basse fréquence, jamais en anneau uniforme autour de chaque glyphe ;
  • papier : une texture de hanji procédurale (turbulence SVG, pas d'image) sur la page.

Sur un fond sombre, la même signature passe en 금니 (金泥) sur 감지 (紺紙). Les scribes des sutras Goryeo écrivaient avec de la poudre d'or mélangée à de la colle sur du papier teint à l'indigo. Le pigment ne s'imprègne pas comme l'encre, donc cette variante n'a jamais d'effet capillaire ni de halo. La colle humide paraît terne et un peu plus sombre ; en séchant, les grains se déposent et attrapent la lumière (un scintillement clairsemé), un reflet lent traverse la ligne, les extrémités et les coins où le pinceau s'est attardé sont plus riches, et les passages fins laissent l'indigo apparaître. Cela s'active automatiquement lorsque la couleur du titre est plus claire que le fond peint le plus proche (data-ink-ground="dark" ou "light" le force). Chaque couleur qu'il dessine est la couleur du titre elle-même, plus sombre ou plus claire, ou celle du fond.

Il s'exécute une fois lorsque le titre entre dans la zone d'affichage, puis la boucle de rendu s'arrête. Les retours à la ligne, keep-all, les changements de police et les redimensionnements sont retracés.

Exemple fonctionnel : examples/demo.html (fichier unique, coréen + japonais + chinois traditionnel, sur hanji et sur une section 감지). Preuve : scripts/verify.mjs.

1. Quand l'utiliser / quand ne pas l'utiliser

À utiliser quand :

  • un titre d'affichage CJK (≥ 40px ; hero, titre de lancement, ligne de campagne, ouvre-section) doit donner l'impression d'être encré, calligraphique, "imprimé sur hanji / washi / 宣紙" ;
  • les couleurs d'encre et de papier de la marque sont connues (DESIGN.md premier plan/fond, ou la color calculée du titre et le fond peint le plus proche). Les fonds sombres obtiennent la variante 금니 : utilisez une couleur de texte claire et chaude avec de la place pour s'assombrir (le démo utilise #d4b062 sur #1a2440 avec un rapport de 7,4:1).

Ne pas utiliser pour :

  • le corps du texte, les étiquettes, les boutons, la navigation, tout texte en dessous de ~32px (l'accumulation et l'effet capillaire nécessitent une largeur de trait pour être lisibles) ;
  • les titres latins uniquement (cela fonctionne, mais le sens culturel est perdu) ;
  • plus d'un ou deux titres par page. L'audace en un seul endroit (règle tf-shaders).

2. L'effet et ses deux paramètres

ParamPlageDéfautCe qu'il fait
bleed0–10.7Jusqu'où l'effet capillaire se propage le long des fibres (jusqu'à 0.12em × bleed, aux bords choisis par le bruit) et la taille du halo humide. 0.4 = à peine visible, 0.8 = un pinceau mouillé.
durations2.6Temps du passage humide à sec. Le halo culmine tôt et rétrécit ; l'accumulation et l'apparition des fibres se produisent en séchant. En dessous de 1.5s, cela ressemble à un flash ; au-dessus de 4s, à un état de chargement.

Tout le reste est fixe intentionnellement. Encre = la color calculée du titre, assombrie à 25% pour les accumulations ; papier = la couleur de fond de la page. L'encre du texte doit être un gris-noir sumi, pas du noir pur (le démo utilise #3a3530 sur #f3eee4, environ 10:1), afin que les accumulations plus sombres aient de la place pour se montrer. Une signature, pas un panneau de contrôle.

3. Le contrat qui maintient le texte en tant que texte

  • Le titre est un <h1>/<h2> normal avec son texte réel. inkBleed() enveloppe le texte dans .ink-text et insère une couche aria-hidden="true", pointer-events: none par-dessus (z-index 2). La couche ne fait qu'assombrir, éclaircir ou étendre ce qui est déjà là. Elle ne remplace ni ne redessine les glyphes, et avec la couche retirée, le titre reste complet.
  • Le titre s'affiche dès la première image. Pas de opacity: 0, pas de clip, pas d'attente du shader. Les tf-shaders ont mesuré un LCP passant à 7.8s lorsque le contenu hero attendait un shader.
  • La sélection, la copie, la recherche dans la page, la traduction, les lecteurs d'écran et le référencement voient du texte brut. verify.mjs vérifie que la sélection du titre renvoie son texte intégral à chaque passage.
  • Laissez environ 0.4em d'espace libre autour du titre (le démo utilise margin-bottom: 0.4em). L'effet capillaire et le halo s'étendent jusqu'à ~0.3em au-delà des glyphes.
  • Ne dessinez jamais les titres CJK avec un composant canvas/Text shader. Le texte sur canvas perd la sélection, l'accessibilité, l'indexation et le façonnage CJK correct (liste "Ne pas faire" des tf-shaders).

4. Typographie CJK (s'applique avant le shader)

De /hangul (règles HG) pour le coréen ; ja/zh délimités séparément pour que les règles coréennes ne fuient pas :

.ink:lang(ko) { word-break: keep-all; overflow-wrap: anywhere;  /* HG-10, délimité à :lang(ko) */
                letter-spacing: -0.02em;                          /* HG-7 : affichage jamais en dessous de -0.03em */
                line-height: 1.3; }                               /* HG-5 : affichage avec retour >= 1.3 */
.ink:lang(ja), .ink:lang(zh-Hant) {
  line-break: strict;                                 /* kinsoku : pas de petits kana / marques de fermeture en début de ligne */
  word-break: keep-all; overflow-wrap: anywhere;      /* coupe uniquement aux marques de phrase <wbr> que vous placez */
  letter-spacing: 0; line-height: 1.4; }
:lang(ko), :lang(ja), :lang(zh) { font-synthesis: none; } /* pas de faux gras/italique sur le CJK */
  • Marquez les limites de phrases japonaises/chinoises avec <wbr> (style BudouX : 墨がにじむように、<wbr>名前が<wbr>紙に染みこむ。). Dans Chrome 149 sans tête, word-break: auto-phrase se calculait correctement mais ne produisait pas de coupures de phrases dans ce démo, ne vous y fiez donc pas.
  • Coréen : retours à la ligne uniquement aux espaces entre 어절, jamais syllabe par syllabe. Placez manuellement les retours à la ligne d'affichage lorsque le rédacteur y tient (tf-shaders cjk-type.md).
  • Définissez lang sur le titre (ko, ja, zh-Hant/zh-Hans). Cela sélectionne les variantes de glyphes appropriées pour les points de code Han partagés et délimite les règles ci-dessus.
  • Polices : utilisez une face qui livre le poids que vous définissez (HG-12). Le démo utilise Noto Serif KR / JP / TC 700 depuis Google Fonts, qui charge uniquement les tranches de glyphes utilisées par la page. Un visage myeongjo/mincho/song convient à l'encre. Pretendard fonctionne aussi. Tracez après document.fonts.ready pour que le champ suive la vraie face, pas le fallback.

5. Bibliothèque, licence, budget

Bibliothèque : @paper-design/shaders (vanille ShaderMount), épinglée 0.0.82 (2026-10-21 ; dispose() libère désormais le contexte WebGL), WebGL2. Enregistrement de décision (vérifié le 2026-10-13 à partir des fichiers LICENSE des tarballs npm, des métadonnées npm et de l'API de licence GitHub) :

@paper-design/shaders 0.0.81shaders 4.0.4 (shaders.com)
LicenceApache-2.0 (LICENSE + NOTICE "Paper Shaders, Copyright 2026 Paper")MIT (© 2026 Shader Effects Inc.) ; dépendance typegpu 0.12.3 MIT (Software Mansion)
Redistribution dans un skill/templateautorisée ; conservez NOTICE si vous vendez le codeautorisée
ExécutionWebGL2 : tous les navigateurs de bureau et mobiles actuelsWebGPU uniquement, sans fallback (Chrome/Edge, Android 12+ Chrome, Safari 26+, Firefox récent)
JS pour cet effet17.5 Ko min / 5.3 Ko gzip (esbuild, ShaderMount uniquement) ; CDN par fichier +esm 16.4 Ko / 5.0 Ko gzip2,535 Ko min / 710 Ko gzip (esbuild, Shader+MeshGradient depuis shaders/react)
Télémétrieaucune (son seul fetch() lit le type de contenu d'un blob local)activée par défaut : échantillonne 5% des sessions vers shaders.com/api/telemetry ; passez disableTelemetry
GLSL personnalisé + texturesoui (ShaderMount(el, frag, uniforms), uniforms d'image)via son graphe de composants

L'effet a besoin d'un fragment shader personnalisé et d'une texture, ce qui est exactement ce que fait ShaderMount, avec 1/130ème du poids du runtime WebGPU et deux fois plus de couverture navigateur. Le démo importe Paper depuis jsDelivr (construction épinglée, par fichier) et ne le vend pas, donc aucune copie de NOTICE n'est nécessaire. Si vous vendez les fichiers de Paper, copiez son NOTICE à côté. Si un projet contient déjà shaders, cet effet fonctionne toujours sur Paper. Ne chargez pas les deux runtimes sur une même page.

Budget pour un titre :

  • JS : 5.0–5.3 Ko gzip de bibliothèque + 5.3 Ko gzip de code d'effet (shader, deux transformations de distance, flou de couverture, traçage ; mesuré non minifié avec commentaires).
  • GPU : un quad, une recherche de texture et 7 appels de bruit de valeur par pixel, sur la boîte du titre plus une marge de ≤0.32em, minPixelRatio: 1, plafonné à 1920×1080 px. Il s'exécute pendant duration puis setSpeed(0) arrête la boucle rAF. Paper le met également en pause hors écran et dans les onglets cachés.
  • CPU : par changement de mise en page (changement de police, redimensionnement, ré-enveloppement ; débouncé 120ms), deux transformations de distance euclidienne (à l'extérieur et à l'intérieur des traits) et un flou de boîte séparable, à demi-résolution pour un texte au-dessus de 64px.
  • Texture de papier : une URI de données SVG feTurbulence en ligne sur html (~600 octets), pas de requête d'image.
  • Les polices sont le vrai coût. Les faces CJK sont volumineuses. Chargez uniquement le poids d'affichage, par tranches unicode-range.

6. Repli et mouvement réduit

  • Pas de WebGL2 (sonde canvas.getContext('webgl2') avant montage ; ShaderMount lève une exception s'il ne peut pas obtenir un contexte ou lier le programme) : aucune couche n'est insérée, le titre obtient .ink-static (un text-shadow CSS léger). Le titre est déjà en encre sur papier texturé, donc il est complet sans le shader. verify.mjs force ce chemin en simulant getContext.
  • prefers-reduced-motion: reduce : montage à l'image séchée avec vitesse 0. Le lecteur obtient l'état final encré comme une seule image fixe, sans mouvement ni boucle rAF.
  • Échec de compilation du shader (un est arrivé lors de la construction : un problème de précision avec le vertex shader de Paper) prend le même chemin .ink-static. Dans votre propre GLSL, déclarez uniform mediump vec2 u_resolution;, car la précision doit correspondre au vertex shader de Paper.

7. Vérifier sur un GPU réel

next build ou un lint réussi ne prouve rien pour les shaders (règle tf-shaders). Exécutez :

npm i -D playwright-core && npx playwright-core install chromium   # un Playwright Chromium frais, pas votre propre Chrome
node <skill>/scripts/verify.mjs path/to/page.html ./ink-verify --frames 36

Il lance Chromium sans tête avec --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS) et exécute trois passes : GPU, mouvement réduit, sans WebGL. Il mesure le premier titre sur chaque fond (data-ink-ground="light" et "dark"). Ensuite il :

  • enregistre la chaîne du rendu WebGL, pour que vous sachiez si un vrai GPU ou SwiftShader a dessiné les images ;
  • parcourt l'horloge du shader de manière déterministe et sauvegarde les images (nourrissez-les dans ffmpeg pour le GIF/MP4 de démo) ;
  • prouve le rendu avec des pixels : shader activé vs shader désactivé dans la boîte du titre, et première image vs image séchée ;
  • mesure la lisibilité tout au long de l'effet : les cœurs des glyphes (texte allumé vs texte transparent) tels que dessinés dans chaque image échantillonnée par rapport au papier derrière eux, 10ème percentile pour que les bords anti-aliasés ne décident pas, pire image. Les titres d'affichage sont du texte WCAG large, donc la barre est à 3:1 ;
  • vérifie que le texte sélectionné est égal au texte du titre, que la couche est aria-hidden + pointer-events: none, que le mouvement réduit est fixe, et que sans WebGL il ne reste aucun canvas.

Mesuré le 2026-11-06 (Chromium sans tête, ANGLE Metal Renderer: Apple M5 Pro, pas SwiftShader), tous les contrôles réussis :

FondPixels de la boîte du titre modifiés par le shaderHumide vs secLisibilité des glyphes (p10, pire image)
clair (sumi sur hanji, #3a3530 sur #f3eee4)10.2%5.9%8.01:1
sombre (금니 sur 감지, #d4b062 sur #1a2440)8.8%8.7%4.58:1

Regardez quand même les images en taille réelle : un champ mal aligné (mauvaise ligne de base) se manifeste par une accumulation décalée par rapport aux traits, et un réglage d'effet capillaire trop fort se lit comme de la fourrure. Seuls vos yeux captent cela.

8. Portage Next.js / React

Conservez la même fonction et le même cycle de vie dans une feuille '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(); }, []). Rendez le titre côté serveur en texte brut, de sorte que le shader le décore seulement après l'hydratation. N'utilisez pas <ShaderMount> de @paper-design/shaders-react ici : il ne vous donne pas la sonde WebGL2, la classe de repli, ni le contrôle sur le moment où le champ est retracé.

9. Attribution

Le cadrage budget-d'abord, la règle "le repli est le design", la règle première-image-LCP, les révélations 어절-pas-syllabe, keep-all, et la boucle de capture d'écran sur GPU réel proviennent de l'expérience tf-shaders du propriétaire (skill/shader-landing/SKILL.md, references/cjk-type.md, scripts/shoot.mjs, RESEARCH.md, 2026-10). Les valeurs typographiques coréennes proviennent du skill /hangul d'OmD. La transformation de distance est l'EDT en temps linéaire de Felzenszwalb & Huttenlocher, écrite à neuf ici. La variante sur fond sombre suit un motif énoncé dans print3d.js de Leonxlnx/taste-skill (MIT), "sur papier sombre, l'encre est la lumière" : le traitement s'inverse, il ne se recolore pas simplement. Aucun code n'a été copié ; le modèle doré est écrit à neuf à partir de la pratique 감지금니.

À ne pas faire

  • Ne cachez pas le titre jusqu'à ce que le shader soit prêt. Le texte est le contenu ; l'encre est l'encadrement.
  • N'animez pas syllabe par syllabe, et ne divisez pas le Hangul en plages par caractère pour une révélation.
  • Ne faites pas tourner la boucle indéfiniment. Un effet d'encre séchée ne coûte rien ; une boucle épuise les batteries.
  • Ne mettez pas deux runtimes (Paper + shaders) sur une même page pour un seul titre.
  • Ne créez pas d'effet capillaire sur chaque bord et ne dessinez pas de halo uniforme. Un anneau régulier autour de chaque glyphe ressemble à un autocollant, pas à de l'encre ; l'effet capillaire appartient à quelques bords.
  • N'utilisez pas d'encre de texte noire pure. Les accumulations ont besoin d'une valeur plus sombre pour se montrer, et le sumi est gris-noir.

...

[Le reste du document suit la même structure et a été tronqué pour la traduction.]

Skills associés