DESIGN.mdバリデーター

YAMLのフロントマター、必須のprimaryカラー、カラーがカラー形式（hex、rgb、hsl、oklch、色名など）で書かれているか、フォントサイズと角丸がpx、em、remで書かれているか、タイポグラフィのプロパティ、コンポーネントのプロパティとそのトークン参照（YAMLがテキストとして読まない、引用符なしの参照を含む）、omittedリスト、重複したセクションや順序の違うセクション、そして各コンポーネントの文字色と背景色のコントラストがWCAG AAの最低基準4.5:1を満たすかをチェックします。エラーがあるとファイルは無効になり、警告は修正したほうがよい点を示します。

いいえ。検証はすべてブラウザ内で行われ、貼り付けたテキストや選んだファイルが当社のサーバーに送信されることはありません。プレビューが行うリクエストはフォントのスタイルシートの取得だけです。当社のサーバーがGoogle Fontsから取得し、そのリクエストに含まれるのはタイポグラフィトークンのフォントファミリー名だけです。

Stitchで使われ、google-labs-code/design.mdリポジトリで公開されているGoogleのDESIGN.md形式です。バリデーターは、Design Extractorが生成するすべてのDESIGN.mdのチェックに使っているのと同じルールに加え、コンポーネントのカラーのコントラストチェックを適用します。

"{colors.brand}"のような参照は、フロントマターに存在するトークン（この例ではcolorsの下のbrand）を指している必要があります。足りないトークンを追加するか、存在するトークンを指すように参照を変更してください。参照は引用符で囲んでください。YAMLは引用符のない{colors.brand}をテキストではなくマッピングとして読みます。

はい。Googleのオープンソースのコマンドラインツールで、パイプライン内のファイルをチェックできます。npx @google/design.md lint DESIGN.mdを実行してください。JSONレポートを出力し、エラーが見つかるとコード1で終了するため、壊れたファイルがあるとジョブが失敗します。ルールセットはこのページと重なりますが、一部の重大度は異なります。