Extension VS Code

L’extension officielle Gram pour VS Code transforme votre éditeur en un véritable IDE dédié aux recettes. Propulsée par le @gram-lang/language-server, elle offre des diagnostics en temps réel, une assistance à la saisie avancée et un rendu dynamique en direct.

Capacités principales

1. Aperçu en direct dynamique & nutrition

• Rendu Côte-à-Côte : Au fil de votre frappe, l’extension compile à la volée votre .gram en HTML dans un panneau WebView dédié. Elle embarque les styles officiels du Playground, garantissant un rendu fidèle au pixel près par rapport à la production.
• Résilience aux erreurs : Si votre recette contient des erreurs de syntaxe bloquant la compilation, l’aperçu affiche gracieusement le message d’erreur pour vous tenir informé, sans jamais faire crasher l’extension.

📊 CodeLens des Macros

Un bouton CodeLens apparaît juste au-dessus du titre de votre recette. Un clic révèle un panneau nutritionnel complet (calories, protéines, glucides, lipides) directement dans l’Aperçu. Il met également en surbrillance les ingrédients introuvables dans votre base de données.

2. Vue diagramme de Gantt

• Panneau Chronologique : Lancez Gram: Gantt Chart (ou cliquez sur l’icône de graphique dans la barre d’outils) pour ouvrir une vue chronologique complète — étapes actives, timers passifs, et compression des temps morts. Le tout dans une WebView dédiée, indépendante de l’Aperçu en Direct.
• Modes Horaires : Depuis le menu du panneau, basculez à l’envie entre le temps écoulé (chronomètre, T+), le compte à rebours (T-), et un rétroplanning basé sur l’heure de service souhaitée.
• Vue Compacte : Pour les recettes complexes grouillant d’étapes simultanées, activez une mise en page densifiée.

3. Gestion intelligente des ingrédients

• Gestion silencieuse des pluriels : L’extension fait intelligemment correspondre les pluriels basiques de votre recette (ex : @carottes) aux entrées singulières de votre base YAML (carotte). Vous conservez une rédaction naturelle sans déclencher de fausses alertes.
• Fuzzy Matching : Une faute de frappe sur un ingrédient ? Un algorithme de Levenshtein vous suggère la correspondance la plus probable via les Actions de Code (Quick Fixes).
• Informations au Survol : Survolez n’importe quel ingrédient pour inspecter ses macros. Si la base lui associe une densité, le survol convertit instantanément les volumes en masse (ex : 1 c.à.s → 15 g).

Chargement Automatique de la Base de Données

L’extension détecte automatiquement le fichier .gram/ingredients.yaml à la racine de votre workspace. Pour des configurations avancées, surchargez gram.ingredientDatabase.path dans vos paramètres VS Code.

4. Assistance à l’édition & navigation

• Jetons Sémantiques (Semantic Tokens) : Plutôt qu’une coloration syntaxique basée sur des expressions régulières, l’extension propose une coloration sémantique robuste pilotée par l’AST. Les modificateurs, les unités imbriquées et les ingrédients composites (<@) sont colorés avec précision selon leur rôle.
• Autocomplétion Intelligente :
  • @ suggère les ingrédients de la base, en encapsulant automatiquement de {} les noms composés.
  • & suggère les variables intermédiaires déclarées en amont (ex : ->&pâte).
  • {} suggère contextuellement les unités canoniques (masse, volume, temps) et leurs alias dès que vous tapez un chiffre.

Raccourcis de navigation

Raccourci	Commande	Comportement
F12	Aller à la Définition	Saute d’une référence (&ref) vers sa déclaration initiale (->&ref).
Maj+F12	Trouver Toutes les Références	Liste toutes les occurrences d’une variable intermédiaire.
F2	Renommer le Symbole	Renomme de manière sûre et atomique une variable dans tout le document.

5. Diagnostics & refactorisation

• Validation en Temps Réel : Le LSP lève un drapeau instantanément sur les références orphelines, les déclarations inutilisées et les clés de frontmatter manquantes.
• Actions de Code 💡 :
  • Ajouter une clé title: manquante au frontmatter.
  • Nettoyer les déclarations intermédiaires fantômes.
  • Déclarer une variable manquante pour une référence orpheline.
  • Convertir un volume en masse directement dans le code source (si la densité est connue).

6. Auto-formatage

Déclenchez le formatage du document (Alt+Maj+F ou Maj+Option+F sur macOS) pour nettoyer instantanément la syntaxe :

- ##    Pâte   ->&pâte
- Ajouter le @zeste de citron{1} < @citron et le @sel{ 15 g }.
+ ## Pâte ->&pâte
+ Ajouter le @zeste de citron{1}<@citron et le @sel{15g}.

Améliorations de l’interface de l’éditeur

• Indications inline (Inlay Hints) : Injecte le temps cumulé (en texte grisé) en fin de ligne de chaque en-tête de section. Parfait pour évaluer la durée de préparation d’un seul coup d’œil.
• Vue Plan (Outline) : Le panneau natif Outline de VS Code s’enrichit de la hiérarchie des sections et des variables intermédiaires : un atout majeur pour naviguer dans de longues recettes.
• Pliage (Gutter Folding) : Le frontmatter et le contenu des sections peuvent être repliés pour alléger votre écran.
• Snippets malins : Tapez des raccourcis comme recipe, ##, step, @ing ou #cw pour bootstrapper rapidement des blocs entiers.