omd-shader-hero — 1つのシーン、2つのブランドインク
ランチングヒーローは、あなたに何も負っていない誰かによる一つの見た目を持ちます。メッシュグラデーションはウェブ上で最も一般的なシェーダールックであり、2つの補色のブランド色をブレンドすると茶色くなります。このスキルはその逆を行います:2つのフラットインク、ベース色と1つのブランドカラーを、スクリーン印刷を通した光のようにゆっくりと折りたたまれるオーダードディザフィールドとして印刷します。すべてのピクセルはどちらかのインクであり、何もブレンドせず、濁ることもありません。コピーはベースインクのハードエッジなノックアウト上に配置され、リソポスターの切り抜きパネルのように見えます。
スクリプトは両方のインク、テキストカラー、コントラストをDESIGN.mdから選びます。色は趣味で選ばれません。
動作例:examples/hero.html、架空のexamples/DESIGN.example.mdから入力。スクリプト:scripts/tokens.mjs(インク+コントラスト)、scripts/verify.mjs(実際のレンダリング検証)。
1. 使用する場合 / 使用しない場合
使用する場合:
- ランチング、製品、ウェイトリスト、イベント、またはブランドリニューアルページで、モーションを伴う最初のスクリーンが必要なとき
- プロジェクトに
DESIGN.mdがあり、ブランドカラーとダーク(またはライト)ベースが定義されているとき(Core v2 Foundationsトークン、Foundations proseペア、またはGoogle互換のcolors:フロントマター) - グラフィカルで印刷された、自信に満ちたルックがブランドに合うとき
使用しない場合:
- DESIGN.mdがない、またはブランドカラーがない場合。
tokens.mjsは終了コード3で終了し、停止します。omd-initを実行するか、質問してください。ギャップを埋めるために「素敵な」色を決して選ばないでください(不明は不在を意味します) - ブランドがソフトで、写真調、またはラグジュアリーで静かな場合。ディザフィールドは騒がしいです。代わりにブリーフの写真を使用してください(tf-shaders「フォトファースト」)
- ページに複数のシェーダーシーンが必要な場合。1シーンのみ、多くても1つの小さなアクセントを別の場所に(tf-shadersルール)。スクロールストーリー全体には
omd-landingを使用してください。
2. 手順
- トークンを読み取り、選択しないでください。
スクリプトは3つのフォーマットをこの順序で読み取ります:node <skill>/scripts/tokens.mjs DESIGN.md # 決定をJSONで出力 node <skill>/scripts/tokens.mjs DESIGN.md --scheme light # ダークではなくライトベース- **color.<role>**: \#hex`トークン、Foundationsセクション内のName (`#hex`)ペア、次にフロントマターcolors:`。その後:- 状態およびユーティリティロール(danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active)を削除します
- 最も暗いトークンをベースインク(
lightの場合は最も明るいもの)とします - 1つのブランドインクを取ります:primary/brandというロールがあればそれ、なければ最も彩度の高いブランドカラーで、ベースに近すぎるものはスキップします
- テキストカラーは計算されます。 スクリプトはテキスト候補(スキームの反対側のインク/ニュートラルトークン)を両方のインクおよびその中間点に対してチェックし、最適なものを選びます。コピーは不透明なベースインクノックアウト上に配置されるため、クリアすべきバーはベースインク上のテキストトークンです。フィクスチャでは18.8:1です。それでも4.5:1未満の場合、スクリプトは警告します:別のテキストトークンを選んでください。
- ヒーローを書きます。
examples/hero.htmlをコピー(または移植、§6参照)して埋めます:
これによりnode <skill>/scripts/tokens.mjs DESIGN.md --write path/to/hero.html#hero-varsCSSブロック(--hero-c0ベース、--hero-c1ブランド、--hero-text、--hero-scrim、--hero-scrim-a)と#hero-tokensJSONが書き換えられます。 - コピーは本物です。 見出し + 1文 + 1つのCTA。ユーザーの実際の製品ラインを使用してください。メトリクス、顧客、投資家を決して発明しないでください(tf-shaders §0)。
- 実際のGPUで検証(§5)し、フレームをフルサイズで確認してください。
3. シーンとその2つのパラメーター
PaperのditheringFragmentShader:type = 4x4(オーダーベイヤー)、colorBack = ベースインク、colorFront = ブランドインク、および.hero-scene上のdata-shapeで選択される2つのフィールド形状のうちの1つ:
data-shape | フィールド | 見た目 |
|---|---|---|
warp(デフォルト) | ブランドライトの遅い対角線上の折り目、スケール1 | リソポスター、2隅にエネルギー |
ripple | ヒーローを中心とした同心円、コピーの背後、スケール0.5 | 重心のある印刷物:コピーが目の中心に |
形状は構成の選択であり、3番目のパラメーターではありません:各形状のスケールは固定されており、セルがpx 2〜6で読み取れるようになっています。不明な値はwarpにフォールバックします。両方の形状は2つのフラットインクを維持します(ピクセルカウントで検証、§5)。Paperの他のディザリング形状と他のシェーダーは除外されました:ほとんどがエッジで2色をブレンドし、このスキルが存在するルールを破ります。
| パラメータ | 範囲 | デフォルト | 動作 |
|---|---|---|---|
speed(data-speed) | 0–1 | 0.3 | 折り目のドリフト。約0.6以上ではスクリーンセーバーのように見えます。0でフィールドをフリーズします。 |
px(data-px) | 2–6 CSS px | 3 | ディザセルサイズ。2 = 細かいスクリーン、3 = リソ、5–6 = 粗い印刷。 |
レイアウトルール:
- ノックアウト、スリムではない。 コピーボックスは不透明なベースインクパネル上にハードエッジで配置されます(コピーの周りにinset 2rem × 2.5rem)。半透明のスリムやフェザーエッジだと、ベースがブランドドットの上に重なり、濁りが再現されます。小さなテキスト(フッターラベル)も独自のノックアウトを持ちます。
- コントラスト:見出しとサブコピーで4.5:1。 見出しは十分大きいためWCAGは3:1を受け入れますが、このスキルはそれに依存しません。
verify.mjsはどちらかが4.5:1未満で失敗します。 - ヒーローコピーは最初のフレームで描画されます:
opacity: 0はなく、キャンバスを待つこともありません。キャンバスは既に完了したCSSポスターの上に600msかけてフェードインします。 - ポスターも2インクです。 形状に従い(
warpは隅、rippleはリング、静止フレーム後にレイアウト)、ドットサイズによってトーンを得ます。2つのハードエッジバンド(コアでは4×4の正方形、ショルダーでは2×2)で、アルファは使用しません:フェードマスクはブランドをベースの上にブレンドします。ベイヤーセルのように、ピクセル全体に正方形のドット。 - 韓国語のディスプレイタイプは
/hangulに従います:keep-all+overflow-wrap: anywhere、行高1.3、トラッキング-0.02em(決して-0.03em未満)、text-wrap: balance、font-synthesis: none。 - 背景は
htmlに、決してbodyには設定しません(body背景はネガティブzのシーンの上にペイントされます;tf-shadersの落とし穴)。 - 半径、タイプスケール、スペーシングもDESIGN.mdから取得します。フィクスチャは半径を定義しないため、CTAは正方形です。
4. ライブラリ、ライセンス、予算、フォールバック
ライブラリ:@paper-design/shaders 0.0.82(vanilla ShaderMount + ditheringFragmentShader)、WebGL2。 0.0.82(2026-10-21)はshader-mount.jsのみを変更:dispose()がWebGLコンテキストを解放するようになりました。ライセンスは2026-10-13にnpm tarballのLICENSEファイル、npmメタデータ、GitHubライセンスAPIから検証済み:
@paper-design/shaders 0.0.81 | shaders 4.0.4(shaders.com) | |
|---|---|---|
| ライセンス | Apache-2.0(+ NOTICE「Paper Shaders, Copyright 2026 Paper」) | MIT(© 2026 Shader Effects Inc.);依存 typegpu 0.12.3 MIT |
| ランタイム | WebGL2、ほぼユニバーサル | WebGPUのみ;未サポート時は透明なキャンバスとログなし |
| このシーンのJS | 23.7 KiB min / 7.0 KiB gzip(esbuild);CDNファイルごと+esm 5.0 + 2.9 KiB gzip | 2,535 KiB min / 710 KiB gzip(Shader + MeshGradient) |
| テレメトリ | なし | デフォルトでオン(5%サンプリング、shaders.com/api/telemetryへ);使用する必要がある場合はdisableTelemetryを渡す |
| npm週間ダウンロード(2026-10-05..11) | 1,104,377(-react) | 287,493 |
Paperはリーチ、軽量性、テレメトリなしで勝ります。shadersは、既にWebGPUシーンを出荷しているプロジェクトのみのアップグレードパスです。その場合、このトークンパイプライン、ノックアウト、フォールバックを維持し、disableTelemetryを渡してください。両方のライセンスはスキルおよびテンプレートでの使用を許可します。サンプルはPaperを固定CDN URLからインポートし、ベンダリングしません。Paperのファイルをベンダリングする場合は、そのNOTICEも一緒にコピーしてください。
予算:
- JS: 7.0 KiB gzipライブラリ + 1.1 KiB gzipシーンコード。
- GPU: 1つのフルビューポートクアッド、2色、オーダードディザ。
minPixelRatio: 1およびmaxPixelCount1920×1080(セルサイズが解像度であるため)。Paperはオフスクリーンおよび非表示タブで一時停止します。 - 画像なし、動画なし、UIフェイス以外のフォントなし。
フォールバック(後付けではなくデザインの一部):
- CSSハーフトーンポスターをキャンバスの下に:ベースインク上のブランドインクのドット(
radial-gradient6pxセル)、2つの隅に向けてマスク。これが最初のペイントであり、WebGL2なしのパス(ShaderMountはコンテキストなしでスロー;ページは最初にgetContext('webgl2')をプローブ)、CDNに到達できない場合の状態です。verify.mjsはこのパスを強制します。 prefers-reduced-motion: reduce: 固定フレーム(STILL_FRAME、8000ms)で速度0。rAFループのない1つの静止構成です。
5. 実際のGPUで検証
npm i -D playwright-core && npx playwright-core install chromium # 新しいPlaywright Chromium、あなた自身のChromeではありません
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all
--shape warp|ripple|allは、ページのモジュールが実行される前にdata-shapeを設定します。各形状に対して4つのパスを実行します(1440px GPU、390pxモバイル、reduced-motion、no-WebGL)、--enable-gpu --ignore-gpu-blocklist --use-angle=metal(macOS)を使用し、各パスで:
- WebGLレンダラーを記録し、実際のGPUまたはSwiftShaderがフレームを描画したかを確認します
- シェーダークロックを12秒間決定論的に進め、フレームを保存します(ffmpeg → デモGIF/MP4)
- コントラストを測定:コピーを非表示にし、すべてのフレームで見出しとサブコピーの背後にあるシーンをサンプリングし、テキストカラーに対する最悪の比率を取ります。どちらかが4.5:1未満で失敗します
- インクをカウント:ノックアウトの外側で、キャンバスとCSSポスターのすべてのピクセルがベースインクまたはブランドインクである必要があります(
twoInksScene、twoInksPoster) - キャンバスより前のポスター:ページ自身のクロックから、initスクリプトが各レンダリングフレームをサンプリングし、ポスターが画面に表示された最初のフレームと、キャンバスが描画されて透明でなくなった最初のフレームを記録します。さらにペイントタイミングとLCPも記録
- フレーム時間(GPUパス):フィールドが実行中の3秒間のrAF間隔、中央値とp95
- キャンバス(ポスターではない)が画面に表示されていること、フィールドが動いていること、見出しがロード時に完全な不透明度であること、reduced motionで静止していること、no-WebGLでポスターが表示されキャンバスがないことを確認します
2026-11-06にフィクスチャ(ヘッドレスChromium、ANGLE Metal Renderer: Apple M5 Pro)で測定、すべてのチェックが両方の形状で合格:
| 形状 | 最悪の見出し / サブコピー | 他のインクのピクセル(シーン / ポスター) | ポスターフレーム → キャンバスフレーム(GPUパス) | フレームms(中央値 / p95) |
|---|---|---|---|---|
| warp | 4パスすべてで18.81 / 18.81 | 0 / 0 | 62 → 112 ms | 8.3 / 9.2 |
| ripple | 4パスすべてで18.81 / 18.81 | 0 / 0 | 44 → 127 ms | 8.3 / 9.2 |
6. Next.js / React 移植
セクション、コピー、ノックアウト、ポスターをプレーンなHTML/CSSとしてサーバーレンダリングします(ポスターにJSは不要)。CSS変数はビルド時にtokens.mjs --jsonから生成し、ランタイムでは生成しないでください。シーンを'use client'リーフにマウントします:
useEffect(() => {
if (!probeWebGL2() || !ref.current) return; // ポスターは残る;クリーンアップ不要
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 { /* ポスターを維持 */ }
})();
return () => m?.dispose();
}, []);
7. 帰属
オーナーのtf-shaders実験(skill/shader-landing/SKILL.md、RESEARCH.md、scripts/shoot.mjs、2026-10)より:1シーン+最大1つのアクセント、規定のJS予算、すべてのキャンバスの下のCSSポスター、html上の背景、タイプの背後にある静かな状態、最悪のフレームでチェックされたコントラスト、ファーストフレームのヒーローコピー、状態変化としてのreduced motion、実際のGPUスクリーンショットループ。このスキルは、トークンパイプライン、2インクディザ、ノックアウト、測定されたコントラスト、WebGL2ランタイムの選択を追加します。
禁止事項
- 3番目の色を追加したり、2つのインクをブレンドしないでください(グラデーション、半透明オーバーレイ、フェザーパネル)。2つのフラットインクがすべてのポイントです。補色間のブレンドは濁りです。
- DESIGN.mdトークンではない色を使用しないでください。特にステートカラー(danger redをブランドインクとして)は使用しないでください。
- テキストをディザフィールドに直接配置しないでください。コピーはノックアウト上に配置します。小さなテキストは独自のノックアウトを持ちます。
- ブレークポイントごとにシェーダーを切り替えたり、コンパイル時のプロパティをアニメートしないでください。インク値や
pxの変更はユニフォーム書き込みであり、問題ありません。 - ヒーローを
body背景の上に重ねたり、見出しをフェードインさせたりしないでください。 - Paperと
shadersを同じページにロードしないでください。