VS ST1 Demo
Support du langage ST1 (calcul de structures à barres du CEREMA-ITM, v24)
pour Visual Studio Code. TypeScript pur, aucune dépendance externe (ni
Python, ni Docker) ; seul le solveur ST1 est requis pour lancer un calcul.
Note — Projet développé hors cadre professionnel, avec un usage massif
d'assistants IA.
Fonctionnalités
- Coloration syntaxique
- Autocomplétion
- Visualisation du modèle
- Lancement des calculs
Aucune télémétrie.
Installation
- Marketplace : onglet Extensions, chercher « VS ST1 ».
- Fichier :
code --install-extension vs-st1-<version>.vsix.
Lancer un calcul ST1
- Ouvrir un fichier
.st1.
- Cliquer sur ▶ (haut-droit de l'éditeur) ou lancer ST1 : exécuter le
calcul (
Ctrl+Maj+P).
Si ST1 est installé à l'emplacement standard du CEREMA, l'exécutable est trouvé
automatiquement. Sinon, renseigner st1.solverPath (Ctrl+,) avec le
chemin de l'exécutable, par exemple
C:\Users\<vous>\AppData\Local\Programs\CEREMA\ST1 v2.24\ST1_v2_24.10.exe.
ST1 est interactif : après lecture du fichier il attend au prompt >. Tapez
QUITTER, ou activez st1.autoQuit pour le faire automatiquement (sans
sauvegarde de projet). Pour un lancement sur mesure, st1.runCommand accepte
une ligne complète avec ${file}, ${fileDirname}, ${workspaceFolder}.
Réglages
| Réglage |
Défaut |
Rôle |
st1.solverPath |
"" |
Chemin de l'exécutable ST1. Vide = détection automatique. |
st1.solverArguments |
[] |
Arguments insérés avant le nom du fichier. |
st1.runCommand |
"" |
Ligne de commande complète, remplaçant les deux précédents. |
st1.saveBeforeRun |
true |
Enregistrer avant de lancer. |
st1.autoQuit |
false |
Envoyer QUITTER après lecture (sans sauvegarde de projet). |
st1.errorFile |
erreur.txt |
Fichier de messages surveillé. |
st1.validation.level |
complet |
lexical, structurel ou complet. |
st1.viewer.defaultView |
auto |
auto, XY, XZ, YZ ou 3D. |
Toutes les commandes sont dans la palette, préfixées ST1 :.
Développement
npm install
npm run gen # catalogue -> grammaire + snippets
npm run compile # build (esbuild) -> dist/
npm test # tests unitaires
npm run package # produit vs-st1-<version>.vsix
Le catalogue (catalog/) est l'unique source de vérité ; F5 ouvre une
fenêtre de test avec le dossier examples/.
Licence
MIT pour l'extension. Le logiciel ST1 et son manuel restent la propriété du
CEREMA-ITM et ne sont pas redistribués : le catalogue ne contient que de la
syntaxe et des renvois de pages.
