Aperçu de l’architecture

⚠️ Travaux en cours : Vize est en développement actif et n’est pas encore prêt pour une utilisation en production. L’architecture interne peut évoluer au fur et à mesure que le projet évolue.

Vize est conçu comme un espace de travail modulaire Rust où chaque caisse répond à une préoccupation spécifique. L’architecture est organisée en voies réutilisables qui transportent le code source SFC de Vue via des étapes d’analyse, d’analyse et de compilation.

Carte des relations de projet

Le dépôt est organisé comme un studio : les surfaces orientées utilisateur entrent via des paquets JavaScript, le noyau Rust partagé façonne le code source Vue, et des outils spécialisés réutilisent le même parseur et le même modèle de sémantique plutôt que de conserver chacun une copie privée du langage.

Cette carte de relations concerne la propriété et la réutilisation, pas tous les avantages des appels. L’invariant important est que l’analyse analyseur, AST et sémantique restent partagés, tandis que les backends du compilateur et les outils de développement restent des ateliers remplaçables autour de ce modèle de langage partagé.

Voies

Détails de la scène

1. Source — Un fichier .vue contenant <template>blocs , <script>et <style>

2. Armature (analyseur) — Tokenise la source brute en un flux de jetons, puis les analyse en un AST structuré. Le tokenizer gère la syntaxe spécifique à Vue : directives (v-if, v-for, v-bind), interpolation d’expressions ({{ }}), et frontières de blocs SFC.

3. Relief (AST) — La représentation intermédiaire. Tous les étages en aval fonctionnent sur cet AST partagé, éliminant ainsi l’analyse syntaxique redondante.

4. Croquis (Analyse sémantique) — Résout les expressions modèles, suit les portées des variables, détecte les types de liaison (configuration, données, props, injection) et valide la correction des expressions. Utilise OXC pour l’analyse AST JavaScript/TypeScript.

5. Atelier (Compilation) — Transforme l’AST analysé en sortie JavaScript. Trois backends servent des cibles différentes :

   • VDOM (vize_atelier_dom) — appels createVNode/h avec optimisation des drapeaux de patch et élévation statique

   • Vapor (vize_atelier_vapor) — Code réactif à grain fin avec manipulation directe du DOM (sans VDOM)

   • SSR (vize_atelier_ssr) — Concaténationnement de chaînes avec marqueurs d’hydratation

6. Sortie — Code JavaScript généré avec des cartes sources

Outils Voies

Au-delà de la compilation, Vize propose des outils supplémentaires qui réutilisent la même infrastructure d’analyse et d’analyse :

Comme tous les outils partagent le même parseur et AST, ils ont une compréhension cohérente de votre code. Une règle de peluches dans Patina fonctionne sur les mêmes nœuds AST que le compilateur dans Atelier — il n’y a aucun risque de désaccord entre les analyseurs.

Pour la vérification de types, vize_canon ajoute une étape supplémentaire : il génère un TypeScript virtuel à partir des SFC Vue et demande des sessions de projet Corsa à corsa-bind des diagnostics natifs, puis remappe ces résultats sur les fichiers originaux.

Le flux de travail de mise en œuvre est documenté dans Language Engineering Practices, qui mappe les modifications du parser, compilateur, analyseur, vérificateur de type, formateur, LSP et release sur les éléments de fixture, snapshot, parité , benchmark et preuves de préparation attendues pour examen.

Responsabilités en caisse

L’interface de la galerie et l’intégration dev-server pour Musea sont disponibles dans le paquet JavaScript @vizejs/vite-plugin-musea; la caisse de rouille se concentre sur l’analyse et le noyau de génération.

Convention de dénomination

Les caisses Vize portent leur nom d’une terminologie artistique et sculpturale, reflétant la façon dont chaque composant façonne et transforme le code Vue. Ce système de dénomination est plus qu’esthétique — il encode le rôle et les relations entre les caisses. Voir Philosophy pour la justification complète.

Pourquoi la terminologie artistique ?

L’analogie entre la compilation logicielle et la création artistique est étonnamment profonde :

• Un parseur (Armature) fournit le squelette interne — la structure sur laquelle tout le reste se construit, tout comme l’armature d’un sculpteur soutient l’argile

• L’analyse sémantique (Croquis) est comme un croquis rapide — elle saisit le sens essentiel sans s’engager dans une forme finale

• Le compilateur (Atelier) est un atelier où la matière première est transformée en une œuvre achevée

• L’AST (Relief) est une projection — elle donne une structure tridimensionnelle à ce qui était à l’origine un texte plat

• Les reliures (vitrine) sont des vitrines en verre — elles permettent de voir et d’interagir avec l’œuvre à l’intérieur sans la toucher directement

• Le linter (Patina) examine la finition de surface — identifiant les imperfections qui affectent la qualité globale

• Le formateur (Glyphe) assure des proportions cohérentes — comme un typographe sculptant des formes de lettres avec un espacement précis

Cette convention de nommage rend la hiérarchie des caisses intuitive : quand vous voyez vize_atelier_dom, vous comprenez immédiatement qu’il s’agit d’un atelier qui produit des sorties VDOM.

Dépendances externes

Vize s’intègre à l’écosystème plus large de Rust pour des tâches spécialisées :