設計判断

アーキテクチャ

annealer（コア）  純粋関数: format(input: &str, config: &Config)
                    -> Result<String, FormatError>
                  ファイル I/O なし。wasm32-unknown-unknown 向けにビルド可能。
                  CSS/SCSS/Sass/Less の宣言順には malva のプロパティ順を使用。

anyl（CLI）       ファイル I/O と引数解析を担当し、コアを呼び出す。

annealer（npm）   コアの WebAssembly ビルドと TypeScript ラッパー。

クレートは 1 つ。 現時点ではコアと CLI を 1 つのクレート（crates/annealer）に置きます。早すぎる抽象化を避けるため、実際に必要になった時点でワークスペースに分割します。CLI が使う clap は既定の cli フィーチャーの裏にあるため、--no-default-features でライブラリを WebAssembly 向けにビルドできます。
プロファイルはコードではなく YAML。 HTML、Vue、今後のプロファイルはすべてデータです。プロファイル形式は Rust の関数シグネチャと同じく公開 API なので、各プロファイルに schemaVersion を持たせます。
厳格な検証。 未知のキーはプロファイルの解析時にエラーになり、タイプミスにすぐ気付けます。エディター支援のために JSON Schema（draft-07）を用意しています。draft-07 で表現できない 2 つの規則（フォールバックグループがちょうど 1 つ、グループ名が一意）はローダーでのみ検査します。
malva のバージョン指定は緩く（0.16）。他のプロジェクトで採っているライブラリ依存の方針に合わせています。
変わるのは順序だけ。 annealer は malva にプロパティ名の並び順を問い合わせ、宣言を書かれたとおりのまま移動します。malva が出力したテキストは使いません。空白や引用符などの整形は Prettier や Oxfmt などのフォーマッターに任せます。
npm パッケージは WebAssembly バイナリを埋め込みます。 別の .wasm ファイルを同梱せず、base64 で埋め込みます。圧縮前のサイズが約 33% 増える代わりに、format() が同期関数になり、バンドラーやローダーの設定も不要になります。

実装中の判断

HTML プロファイルの順序。 当初の表には、どれにも一致しない属性や alt/title の置き場所がありませんでした。合意した順序は id → class → 補足（alt、title、placeholder）→ 意味（type、href、src、srcset）→ キーと値（name、value、content）→ 寸法（width、height）→ その他（状態: disabled、checked など）→ ARIA → data → イベントです。Vue プロファイルも「その他の属性」の階層内で同じ順序を使います。
静的形式をバインド形式より前に置くのは class だけ。 その他の名前ではクラスタ内で書かれた順を保ちます。Vue は style を後の宣言が勝つ形でマージし、その他の重複では 1 つの値しか残さないためです。
spreadSafe グループ。 コンパイル時ディレクティブは v-bind のスプレッドオブジェクトとマージされないため、スプレッドをまたいで移動してよいものとします。それ以外は自分のセグメント内に留まります。
複数行のタグでは 1 行に 1 属性。 そうしないと、並べ替えで 1 行に 2 つの属性が並ぶことがあります。vue/max-attributes-per-line の複数行時の既定と同じで、layout.oneAttributePerLine で無効にできます。
Vue の階層 8 を分割。 vue/attributes-order と同じく、その他のディレクティブ → その他の属性の順にします（OTHER_DIRECTIVES → OTHER_ATTR）。
void: always は vue/html-self-closing の既定（html.void: never）と異なります。 その ESLint ルールを残すプロジェクトでは、どちらかに合わせる必要があります。
contentNewline は HTML プロファイルでも有効。 ブロックレベルのコンテンツの先頭と末尾の空白は表示されず、表示されうる要素は ignore リストで除外しています。
ベンダープレフィックス付きの宣言は先頭に置く（vendorPrefix: start）。標準プロパティが最後に宣言され、優先されるようにするためです。スタイルシートを参照してください。

解決済みの論点

v-model と通常の value: クラスタにしません。キー v-model は value と異なります。
プロファイルの厳格さ: 未知のキーは解析時にエラーになります。
malva のバージョン: 緩い範囲指定 0.16。

残っている項目

malva が raffia 0.13 に上がったら追従する（malva 0.16 はまだ raffia 0.12 を使用）。
Svelte プロファイル
静的な class 属性の値の並べ替え（Tailwind の近似順、Bootstrap への提案）
ライブラリプロファイル、プロファイルの合成（extends）、タグ・コンポーネント単位の上書き
手書きのフィクスチャに加えて、実際のプロジェクトから取ったフィクスチャ

#設計判断

#アーキテクチャ

#実装中の判断

#解決済みの論点

#残っている項目

設計判断

アーキテクチャ

実装中の判断

解決済みの論点

残っている項目