Que fait omd-shader-hero — une scène, deux encres de marque ?
Un héros de lancement reçoit une unique apparence de quelqu'un qui ne vous doit rien. Les dégradés maillés sont le rendu shader le plus générique du web, et mélanger deux teintes de marque complémentaires les transforme en marron. Ce skill fait l'inverse : deux encres plates, la couleur de base et une couleur de marque, imprimées comme un champ de tramage ordonné qui se plie lentement, telle la lumière à travers un écran de sérigraphie. Chaque pixel est soit une encre, soit l'autre, donc rien ne se mélange et rien ne devient boueux. Le texte repose sur un découpage net dans l'encre de base, comme un panneau découpé sur un poster riso.
Le script choisit les deux encres, la couleur du texte et le contraste à partir de DESIGN.md. Aucune couleur n'est choisie par goût.
Exemple fonctionnel : examples/hero.html, rempli à partir du fictif examples/DESIGN.example.md. Scripts : scripts/tokens.mjs (encres + contraste), scripts/verify.mjs (vérification de rendu réel).
1. Quand l'utiliser / quand ne pas l'utiliser
À utiliser quand :
- une page de lancement, produit, liste d'attente, événement ou rebranding nécessite un premier écran avec animation ;
- le projet possède un
DESIGN.mdavec une couleur de marque et une base sombre (ou claire) (tokens Core v2 Foundations, paires Foundations prose, ou frontmattercolors:compatible Google) ; - un look graphique, imprimé et affirmé correspond à la marque.
Ne pas utiliser quand :
- il n'y a pas de DESIGN.md ou pas de couleur de marque.
tokens.mjsse termine avec le code 3 et vous vous arrêtez ; exécutezomd-initou demandez. Ne choisissez jamais des couleurs "sympas" pour combler le vide (inconnu signifie absent) ; - la marque est douce, photographique ou luxe discret. Un champ de tramage est bruyant. Utilisez plutôt la photographie du brief (tf-shaders "photo first") ;
- la page a besoin de plusieurs scènes shader. Une scène, plus au maximum un petit accent ailleurs (règle tf-shaders). Pour une histoire complète en défilement, utilisez
omd-landing.
2. Procédure
- Lisez les tokens, ne les choisissez pas.
Le script lit trois formats, dans cet ordre :node <skill>/scripts/tokens.mjs DESIGN.md # affiche la décision en JSON node <skill>/scripts/tokens.mjs DESIGN.md --scheme light # base claire au lieu de sombre- **color.<role>**: \#hex`tokens, les pairesName (`#hex`)dans la section Foundations, puis le frontmattercolors:`. Ensuite, il :- supprime les rôles d'état et d'interface (danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active) ;
- prend le token le plus sombre comme encre de base (le plus clair pour
light) ; - prend une encre de marque : le rôle nommé primary/brand s'il existe, sinon la couleur de marque la plus saturée, en ignorant toute couleur trop proche de la base.
- La couleur du texte est calculée. Le script vérifie les candidats de texte (tokens d'encre/neutres à l'opposé du schéma) par rapport aux deux encres et à leur point médian, et choisit la meilleure. La copie repose ensuite sur un découpage opaque de l'encre de base, donc la barre à franchir est le token de texte sur l'encre de base. Avec le jeu de tests, cela donne 18,8:1. Si même cela est inférieur à 4,5:1, le script émet un avertissement : choisissez un autre token de texte.
- Écrivez le héros. Copiez
examples/hero.html(ou portez-le, voir §6) et remplissez-le :
Cela réécrit le bloc CSSnode <skill>/scripts/tokens.mjs DESIGN.md --write chemin/vers/hero.html#hero-vars(--hero-c0base,--hero-c1marque,--hero-text,--hero-scrim,--hero-scrim-a) et le JSON#hero-tokens. - La copie est réelle. Titre + une phrase + un CTA. Utilisez la ligne de produit réelle de l'utilisateur. N'inventez jamais de métriques, clients ou investisseurs (tf-shaders §0).
- Vérifiez sur un vrai GPU (§5) et regardez les images en taille réelle.
3. La scène et ses deux paramètres
ditheringFragmentShader de Paper : type = 4x4 (Bayer ordonné), colorBack = encre de base, colorFront = encre de marque, et une des deux formes de champ choisies avec data-shape sur .hero-scene :
data-shape | Champ | Interprétation |
|---|---|---|
warp (par défaut) | plis diagonaux lents de la lumière de marque, échelle 1 | un poster riso, énergie à deux coins |
ripple | anneaux concentriques centrés sur le héros, derrière le texte, échelle 0,5 | une impression avec un centre de gravité : le texte est dans l'œil |
La forme est un choix de composition, pas un troisième paramètre : l'échelle de chaque forme est fixe pour que ses cellules se lisent à une taille de px de 2 à 6, et une valeur inconnue utilise warp par défaut. Les deux formes restent deux encres plates (vérifié par comptage de pixels, §5). Les autres formes de tramage de Paper et ses autres shaders ont été laissés de côté : la plupart mélangent les deux couleurs à leurs bords, ce qui brise la règle pour laquelle ce skill existe.
| Paramètre | Plage | Défaut | Effet |
|---|---|---|---|
speed (data-speed) | 0–1 | 0.3 | Dérive des plis. Au-dessus de ~0,6, cela ressemble à un économiseur d'écran. 0 fige le champ. |
px (data-px) | 2–6 px CSS | 3 | Taille de cellule de tramage. 2 = trame fine, 3 = riso, 5–6 = impression grossière. |
Règles de mise en page :
- Découpage, pas de voile. Le bloc de texte repose sur un panneau opaque d'encre de base aux bords nets (inset 2rem × 2,5rem autour du texte). Un voile translucide ou un bord dégradé superposerait la base sur les points de la marque et recréerait la boue. Le petit texte (l'étiquette de pied de page) a également son propre découpage.
- Contraste : 4,5:1 pour le titre et le sous-titre. Le titre est assez grand pour que WCAG accepterait 3:1, mais ce skill ne s'y fie pas.
verify.mjséchoue en dessous de 4,5:1 pour l'un ou l'autre. - Le texte du héros s'affiche dès la première image : pas de
opacity: 0, pas d'attente pour le canvas. Le canvas apparaît en fondu sur 600 ms au-dessus d'un poster CSS déjà complet. - Le poster est aussi en deux encres. Il suit la forme (coins pour
warp, anneaux pourripple, disposés après l'image fixe) et obtient sa tonalité par la taille des points dans deux bandes à bords nets (carrés 4×4 au centre, 2×2 sur les côtés), jamais par alpha : un masque dégradé mélangerait la marque sur la base. Points carrés sur des pixels entiers, comme les cellules de Bayer. - L'affichage coréen suit
/hangul:keep-all+overflow-wrap: anywhere, hauteur de ligne 1,3, crénage -0,02em (jamais en dessous de -0,03em),text-wrap: balance,font-synthesis: none. - Arrière-plan sur
html, jamais surbody(un arrière-plan sur body se peint par-dessus une scène en z négatif ; piège tf-shaders). - Rayon, échelle typographique et espacement proviennent également de DESIGN.md. Le jeu de tests ne définit aucun rayon, donc le CTA est carré.
4. Bibliothèque, licence, budget, repli
Bibliothèque : @paper-design/shaders 0.0.82 (ShaderMount vanilla + ditheringFragmentShader), WebGL2. La version 0.0.82 (2026-10-21) ne modifie que shader-mount.js : dispose() libère désormais le contexte WebGL. Licences vérifiées 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.81 | shaders 4.0.4 (shaders.com) | |
|---|---|---|
| Licence | Apache-2.0 (+ NOTICE "Paper Shaders, Copyright 2026 Paper") | MIT (© 2026 Shader Effects Inc.) ; dépendance typegpu 0.12.3 MIT |
| Exécution | WebGL2, quasi universel | WebGPU uniquement ; canvas transparent et aucun log en cas d'absence de support |
| JS pour cette scène | 23,7 KiB min / 7,0 KiB gzip (esbuild) ; CDN par fichier +esm 5,0 + 2,9 KiB gzip | 2 535 KiB min / 710 KiB gzip (Shader + MeshGradient) |
| Télémétrie | aucune | activée par défaut (échantillonnage 5% vers shaders.com/api/telemetry) ; si vous devez l'utiliser, passez disableTelemetry |
| Téléchargements npm hebdomadaires (2026-10-05..11) | 1 104 377 (-react) | 287 493 |
Paper l'emporte en termes de portée, de poids et de télémétrie. shaders est la voie de mise à niveau uniquement pour un projet qui propose déjà des scènes WebGPU. Dans ce cas, conservez ce pipeline de tokens, le découpage et le repli, et passez disableTelemetry. Les deux licences autorisent l'utilisation dans les skills et les templates. L'exemple importe Paper depuis une URL CDN figée et ne le met pas en vente. Si vous mettez les fichiers de Paper en vente, copiez son NOTICE avec eux.
Budget :
- JS : 7,0 KiB gzip de bibliothèque + 1,1 KiB gzip de code de scène.
- GPU : un quad plein écran, deux couleurs, tramage ordonné.
minPixelRatio: 1etmaxPixelCount1920×1080, car la taille des cellules est la résolution. Paper se met en pause hors écran et dans les onglets cachés. - Pas d'images, pas de vidéo, pas de police autre que la face UI.
Repli (partie intégrante du design, pas une réflexion après coup) :
- Poster tramé CSS sous le canvas : points de l'encre de marque sur l'encre de base (
radial-gradientcellules 6px), masqués vers deux coins. C'est la première peinture, le chemin sans WebGL2 (ShaderMountlance une exception sans contexte ; la page teste d'abordgetContext('webgl2')), et l'état lorsque le CDN est inaccessible.verify.mjsforce ce chemin. prefers-reduced-motion: reduce: vitesse 0 à une image fixe (STILL_FRAME, 8000ms). C'est une composition fixe sans boucle rAF.
5. Vérification sur un vrai GPU
npm i -D playwright-core && npx playwright-core install chromium # Playwright Chromium frais, pas votre propre Chrome
node <skill>/scripts/verify.mjs chemin/vers/hero.html ./hero-verify --frames 48 --seconds 12 --shape all
--shape warp|ripple|all définit data-shape avant l'exécution du module de la page. Pour chaque forme, il effectue quatre passes (GPU 1440px, mobile 390px, mouvement réduit, sans WebGL) avec --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS), et pour chacune :
- enregistre le moteur de rendu WebGL, afin de savoir si un vrai GPU ou SwiftShader a dessiné les images ;
- parcourt l'horloge du shader de manière déterministe sur 12 secondes et sauvegarde les images (ffmpeg → GIF/MP4 de démonstration) ;
- mesure le contraste : masque le texte, échantillonne la scène derrière le titre et le sous-titre dans chaque image, et prend le ratio le plus bas par rapport à la couleur du texte. Il échoue en dessous de 4,5:1 pour l'un ou l'autre ;
- compte les encres : en dehors des découpages, chaque pixel du canvas et du poster CSS doit être soit l'encre de base, soit l'encre de marque (
twoInksScene,twoInksPoster) ; - poster avant canvas, depuis l'horloge de la page : un script d'initialisation échantillonne chaque image rendue et enregistre la première image où le poster est à l'écran et la première image où le canvas a dessiné et n'est pas transparent, ainsi que les temps de peinture et le LCP ;
- temps par image sur la passe GPU : intervalles rAF pendant 3 s pendant que le champ tourne, médiane et p95 ;
- vérifie que le canvas (pas le poster) est à l'écran, que le champ bouge, que le titre est à pleine opacité au chargement, que le mouvement réduit est immobile, et que sans WebGL, le poster s'affiche sans canvas.
Mesuré le 2026-11-06 avec le jeu de tests (Chromium headless, ANGLE Metal Renderer: Apple M5 Pro), toutes les vérifications ont réussi pour les deux formes :
| Forme | Pire ratio titre / sous-titre | Autres pixels d'encre (scène / poster) | Image poster → image canvas (passe GPU) | ms par image (médiane / p95) |
|---|---|---|---|---|
| warp | 18,81 / 18,81 dans les quatre passes | 0 / 0 | 62 → 112 ms | 8,3 / 9,2 |
| ripple | 18,81 / 18,81 dans les quatre passes | 0 / 0 | 44 → 127 ms | 8,3 / 9,2 |
6. Port Next.js / React
Rendu côté serveur de la section, du texte, du découpage et du poster en HTML/CSS pur (le poster n'a pas besoin de JS). Générez les variables CSS au moment de la construction à partir de tokens.mjs --json, pas à l'exécution. Montez la scène dans un composant feuille 'use client' :
useEffect(() => {
if (!probeWebGL2() || !ref.current) return; // le poster reste ; rien à nettoyer
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 { /* conserver le poster */ }
})();
return () => m?.dispose();
}, []);
7. Attribution
Issu de l'expérience tf-shaders du propriétaire (skill/shader-landing/SKILL.md, RESEARCH.md, scripts/shoot.mjs, 2026-10) : une scène plus au maximum un accent, le budget JS indiqué, le poster CSS sous chaque canvas, l'arrière-plan sur html, l'état calme derrière le texte, le contraste vérifié à la pire image, le texte du héros dès la première image, le mouvement réduit comme changement d'état, et la boucle de capture d'écran sur vrai GPU. Ce skill ajoute le pipeline de tokens, le tramage à deux encres, le découpage, le contraste mesuré et le choix d'exécution WebGL2.
À ne pas faire
- N'ajoutez pas de troisième couleur et ne mélangez pas les deux encres (dégradés, superpositions translucides, panneaux dégradés). Deux encres plates sont le cœur du sujet ; un mélange entre teintes complémentaires est de la boue.
- N'utilisez pas de couleur qui ne soit pas un token de DESIGN.md, et jamais une couleur d'état (rouge danger comme encre de marque).
- Ne placez pas de texte directement sur le champ de tramage. Le texte va sur le découpage ; le petit texte a le sien.
- Ne changez pas de shader par point de rupture et n'animez pas de propriétés de compilation. Changer une valeur d'encre ou
pxest une écriture uniforme et est acceptable. - Ne superposez pas le héros sur un arrière-plan
bodyet ne faites pas apparaître le titre en fondu. - Ne chargez pas Paper et
shaderssur la même page.