アーキテクチャの概要

⚠️ 進行中の作業:Vize は積極的に開発中であり、まだ運用環境で使用する準備ができていません。プロジェクトの進行に応じて内部アーキテクチャが変更される可能性があります。

Vize はモジュール式の Rust ワークスペースとして構築されており、各クレートが特定の懸念事項を処理します。このアーキテクチャは、解析、分析、コンパイルの段階を通じて Vue SFC ソースを運ぶ再利用可能なレーンに編成されています。

プロジェクト関係マップ

リポジトリはスタジオのように編成されています。ユーザー向けのサーフェスは JavaScript パッケージを通じて入力され、 共有された Rust コアは Vue ソースを形成し、専用ツールは同じパーサーとセマンティクスを再利用します。 それぞれが言語のプライベートコピーを保持するのではなく、モデルを作成します。

この関係マップは、すべてのコール エッジではなく、所有権と再利用に関するものです。重要な不変条件は パーサー、AST、セマンティック分析は共有されたままですが、コンパイラー バックエンドと開発者ツールは共有されます。 その共有言語モデルを中心とした置き換え可能なワークショップは残ります。

レーン

ステージ詳細

1.ソース— <template>、<script>、および <style> ブロックを含む .vue ファイル2.アーマチュア(パーサー) — 生のソースをトークンのストリームにトークン化し、構造化された AST に解析します。トークナイザーは、Vue 固有の構文、ディレクティブ (v-if、v-for、v-bind)、式補間 ({{ }})、および SFC ブロック境界を処理します。3.レリーフ(AST) — 中間表現。すべての下流ステージはこの共有 AST 上で動作し、冗長な解析を排除します。4.Croquis(セマンティック分析) - テンプレート式を解決し、変数スコープを追跡し、バインディング タイプ (setup、data、props、inject) を検出し、式の正確さを検証します。 JavaScript/TypeScript AST 解析に OXC を使用します。5.Atelier(コンパイル) — 分析された AST を JavaScript 出力に変換します。 3 つのバックエンドが異なるターゲットに対応します。

• VDOM(vize_atelier_dom) — パッチ フラグの最適化と静的ホイスティングを使用した createVNode/h 呼び出し

• Vapor(vize_atelier_vapor) — 直接 DOM 操作を使用したきめ細かいリアクティブ コード (VDOM なし)

• SSR(vize_atelier_ssr) — 水和マーカーとの文字列連結 6.出力— ソース マップを含む生成された JavaScript コード

ツールレーン

Vize はコンパイル以外にも、同じ解析および分析インフラストラクチャを再利用する追加ツールを提供します。

すべてのツールは同じパーサーと AST を共有するため、コードを一貫して理解できます。 Patina の lint ルールは、Atelier のコンパイラーと同じ AST ノードで動作します。パーサーの不一致のリスクはありません。

型チェックの場合、vize_canon はもう 1 つのステップを追加します。Vue SFC から仮想 TypeScript を生成し、corsa-bind からの Corsa プロジェクト セッションにネイティブ診断を依頼し、その結果を元のファイルにマッピングします。

実装ワークフローは次の場所に文書化されています。 Language Engineering Practices、パーサーをマップします。 コンパイラ、アナライザ、タイプチェッカー、フォーマッタ、LSP、およびフィクスチャ、スナップショット、 同等性、ベンチマーク、準備状況の証拠がレビューされることが予想されます。

クレートの責任

Musea のギャラリー UI と開発サーバー統合は JavaScript パッケージ内にあります @vizejs/vite-plugin-musea; Rust クレートは解析と生成のコアに焦点を当てています。

命名規則

Vize クレートは、芸術と彫刻の用語にちなんで名付けられており、各コンポーネントが Vue コードをどのように形成および変換するかを反映しています。この命名システムは見た目の美しさだけではなく、クレート間の役割と関係をエンコードしています。完全な理論的根拠については、哲学 を参照してください。

なぜアート用語を使うのか?

ソフトウェアのコンパイルと芸術的創作の類似点は驚くほど深いです。

• パーサー(アーマチュア) は内部のスケルトン、つまり彫刻家のアーマチュアが粘土を支えるのと同じように、他のすべてが構築される構造を提供します。

• 意味分析(クロッキー) は簡単なスケッチのようなものです。最終的な形式にこだわることなく本質的な意味を捉えます。

• コンパイラー(アトリエ) は、原材料を完成品に変換する工房です

• AST(レリーフ) は投影です。元は平坦なテキストであったものに 3 次元の構造を与えます。

• バインディング(ヴィトリン) はガラス製の展示ケースです。直接触れることなく、中の作品を見て操作することができます。

• リンター(緑青) は表面仕上げを検査し、全体的な品質に影響を与える欠陥を見つけます。

• フォーマッタ(グリフ) は、正確な間隔で文字の形を彫るタイポグラファーのように、一貫した比率を保証します。

この命名規則により、クレート階層が直感的になります。vize_atelier_dom を見ると、それが VDOM 出力 を生成する ワークショップ であることがすぐにわかります。

外部依存関係

Vize は、特殊なタスクのために広範な Rust エコシステムと統合します。