humalis 1.3.0 → 1.4.0

package/dist/outils/version.js

@@ -0,0 +1,15 @@
+import { readFileSync } from 'node:fs';
+/** La version du paquet, lue dans son package.json (deux dossiers au-dessus de src/outils/ comme de dist/outils/). */
+export function versionHumalis() {
+    return JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version;
+}
+/** « humalis --version » ou « humalis --aide » : le texte à afficher, ou undefined pour une autre commande. */
+export function reponseSimple(arguments_, aide) {
+    if (arguments_.length !== 1)
+        return undefined;
+    if (['--version', '-v', 'version'].includes(arguments_[0]))
+        return `humalis ${versionHumalis()}`;
+    if (['--aide', '--help', '-h', 'aide'].includes(arguments_[0]))
+        return aide;
+    return undefined;
+}

package/dist/parser/langues.js

@@ -2,7 +2,8 @@
  * L'analyse syntaxique des langues (plan 2026-10-30-qualite-publication,
  * partie 1, décisions Q1 à Q4) :
  *
- * - le bloc « langues : » en haut du fichier, une langue par ligne ;
+ * - le bloc « langues : » en haut du fichier, une langue par ligne, ou sur la
+ *   même ligne séparées par des virgules : « langues : francais, anglais » ;
  * - le bloc « traductions anglais : », des lignes « "texte" : "version" » ;
  * - la version écrite à côté d'un texte : « "Bienvenue" en anglais "Welcome" » ;
  * - l'élément « selecteur de langue », en tête de ligne.
@@ -39,13 +40,40 @@ export function analyserLangues(flux) {
     const debut = flux.avancer();
     flux.avancer();
     const langues = { type: 'Langues', langues: [], ligne: debut.ligne };
+    const ajouter = (jeton) => langues.langues.push({ mot: normaliser(jeton.original ?? jeton.valeur), ligne: jeton.ligne });
+    // « langues : francais, anglais » : sur la ligne même, séparées par des virgules.
+    if (!flux.verifier('FIN_LIGNE') && !flux.estFini()) {
+        for (;;) {
+            const jeton = flux.actuel();
+            if (!estMot(jeton)) {
+                throw new ErreurSyntaxique(`après « langues : », on attend le nom d'une langue, par exemple « francais » ou « anglais » : à la place, on trouve « ${jeton.valeur || jeton.type} »`, jeton.ligne);
+            }
+            flux.avancer();
+            ajouter(jeton);
+            if (flux.verifier('FIN_LIGNE') || flux.estFini())
+                break;
+            if (flux.actuel().type === 'PONCTUATION' && flux.actuel().valeur === ',') {
+                flux.avancer();
+                if (flux.verifier('FIN_LIGNE') || flux.estFini()) {
+                    throw new ErreurSyntaxique(`après la virgule, il manque le nom d'une langue : « langues : francais, anglais »`, jeton.ligne);
+                }
+                continue;
+            }
+            throw new ErreurSyntaxique(`séparez les langues par des virgules : « langues : francais, anglais ». À la place de la virgule, on trouve « ${flux.actuel().valeur || flux.actuel().type} »`, jeton.ligne);
+        }
+        flux.sauterFinsDeLigne();
+        if (flux.verifier('INDENT')) {
+            throw new ErreurSyntaxique(`les langues s'écrivent soit sur la ligne, soit en dessous, une par ligne, pas les deux à la fois`, flux.actuel().ligne);
+        }
+        return langues;
+    }
     lignesDuBloc(flux, () => {
         const jeton = flux.actuel();
         if (!estMot(jeton)) {
             throw new ErreurSyntaxique(`une ligne du bloc « langues » est le nom d'une langue, par exemple « francais » ou « anglais » : à la place, on trouve « ${jeton.valeur || jeton.type} »`, jeton.ligne);
         }
         flux.avancer();
-        langues.langues.push({ mot: normaliser(jeton.original ?? jeton.valeur), ligne: jeton.ligne });
+        ajouter(jeton);
     });
     return langues;
 }

package/dist/vocabulaire/table-langues.js

@@ -42,7 +42,7 @@ export const ENTREES_LANGUES = [
         contextes: ['declaration'],
         cibles: ecran('src/humalis/langue.tsx : LANGUES, t(), useLangue(), <html lang>', 'humalis/langue.tsx : la langue du téléphone par expo-localization, le choix gardé par AsyncStorage', 'humalis.js : t(), langue(), changerLangue() ; le HTML de départ dans la première langue'),
         couvre: ['html:lang', 'i18n', 'navigator.languages', 'expo-localization'],
-        description: 'Le bloc « langues : » en haut du fichier déclare les langues du site, une par ligne. La première est celle des textes écrits tels quels ; les autres s’ajoutent après un texte (« en anglais "…" ») ou dans un bloc « traductions ». La personne voit d’abord la langue de son navigateur (ou de son téléphone), si le site la parle.',
+        description: 'Le bloc « langues : » en haut du fichier déclare les langues du site, une par ligne, ou sur la même ligne séparées par des virgules (« langues : francais, anglais »). La première est celle des textes écrits tels quels ; les autres s’ajoutent après un texte (« en anglais "…" ») ou dans un bloc « traductions ». La personne voit d’abord la langue de son navigateur (ou de son téléphone), si le site la parle.',
         exemple: `${LANGUES}page "accueil" :\n    selecteur de langue\n    titre "Bienvenue" en anglais "Welcome"`,
         statut: 'supporte',
         etape: 9,

package/docs/guide.en.md

@@ -228,11 +228,14 @@ page "guide" :
 
 ### Code within a sentence
 
-In text, `{code "…"}` displays a short piece of code in a monospace font.
+In text, a piece of code goes between backticks, as in every documentation:
+it shows in a monospace font, as written, quotes and braces included.
+`{code "…"}` does the same.
 
 ```humalis
 page "guide" :
-    texte "Write {code "titre"} to add a heading."
+    texte "Write `titre` to add a heading."
+    texte "A text: `texte "Hello {firstname}"`."
 ```
 
 ### Code block
@@ -747,6 +750,10 @@ A variable (`variable`) holds a number, a text, `vrai` (true) or `faux`
 the French way: `12,50`. Inside a text, `{firstname}` shows the variable's
 value.
 
+A name cannot be one of the small French words Humalis skips so the code reads
+like a sentence: `le`, `la`, `les`, `un`, `une`, `des`, `de`, `du`, `a`, `au`,
+`aux`, `se`. Write `variable total = 0`, not `variable a = 0`.
+
 ### Changing a variable
 
 ```humalis
@@ -1824,7 +1831,8 @@ page "catalogue" :
     lien "Back to home" en francais "Retour à l'accueil" vers "home"
 ```
 
-- `langues :` lists the languages (`francais`, `anglais`…).
+- `langues :` lists the languages (`francais`, `anglais`…), one per line or
+  on the same line separated by commas: `langues : anglais, francais`.
 - `en francais "…"` gives another language's version of a text.
 - `sans traduction` ("without translation") keeps the same text in every
   language, for a proper noun: `lien "GitHub" sans traduction vers "https://github.com"`.
@@ -1959,6 +1967,7 @@ texte "…" est absent` (a text is not shown).
 | Command | Role |
 |---|---|
 | `humalis nouveau <name>` | creates a project |
+| `humalis --version` | shows the installed version (`humalis --help`: the usage) |
 | `humalis developper` | runs the site and recompiles it on every save |
 | `humalis compile <file> --cible <target> --sortie <folder>` | generates a target's project |
 | `humalis compile <file> --cible web --composants <folder>` | generates React components to import elsewhere |

package/docs/guide.md

@@ -218,11 +218,14 @@ page "guide" :
 
 ### Code dans une phrase
 
-Dans un texte, `{code "…"}` affiche un court morceau de code à chasse fixe.
+Dans un texte, un morceau de code s'écrit entre accents graves, comme dans
+toutes les documentations : il s'affiche à chasse fixe, tel quel, guillemets et
+accolades compris. `{code "…"}` fait la même chose.
 
 ```humalis
 page "guide" :
-    texte "Écris {code "titre"} pour donner un titre."
+    texte "Écris `titre` pour donner un titre."
+    texte "Un texte : `texte "Bonjour {prenom}"`."
 ```
 
 ### Bloc de code
@@ -707,6 +710,10 @@ Une variable contient un nombre, un texte, `vrai` ou `faux`, une liste, une
 fiche, ou `rien`. Les nombres à virgule s'écrivent à la française : `12,50`.
 Dans un texte, `{prenom}` affiche la valeur de la variable.
 
+Un nom ne peut pas être un des petits mots que Humalis ignore pour se lire
+comme une phrase : `le`, `la`, `les`, `un`, `une`, `des`, `de`, `du`, `a`, `au`,
+`aux`, `se`. Écris `variable total = 0`, pas `variable a = 0`.
+
 ### Changer une variable
 
 ```humalis
@@ -1741,6 +1748,8 @@ page "catalogue" :
     lien "Retour à l'accueil" en anglais "Back to home" vers "accueil"
 ```
 
+- Les langues tiennent aussi sur une ligne, séparées par des virgules :
+  `langues : francais, anglais` revient au même que le bloc.
 - `en anglais "…"` donne la version d'un texte.
 - `sans traduction` garde le même texte dans toutes les langues, pour un nom
   propre : `lien "GitHub" sans traduction vers "https://github.com"`.
@@ -1871,6 +1880,7 @@ Les autres étapes : `remplir champ "email" avec "…"`, `aller vers "panier"`,
 | Commande | Rôle |
 |---|---|
 | `humalis nouveau <nom>` | crée un projet |
+| `humalis --version` | affiche la version installée (`humalis --aide` : le mode d'emploi) |
 | `humalis developper` | lance le site et le recompile à chaque enregistrement |
 | `humalis compile <fichier> --cible <cible> --sortie <dossier>` | produit le projet d'une cible |
 | `humalis compile <fichier> --cible web --composants <dossier>` | produit des composants React à importer ailleurs |

package/llms.txt

@@ -422,6 +422,10 @@ page "accueil" :
 - Deux blocs « langues » : un seul bloc « langues »
 - Le bloc « langues » après les pages : le bloc « langues » s'écrit en haut du fichier
 - Une langue entre guillemets : une ligne du bloc « langues » est le nom d'une langue
+- Une langue entre guillemets sur la ligne « langues : » : après « langues : », on attend le nom d'une langue
+- Deux langues sans virgule : séparez les langues par des virgules
+- Une virgule en fin de ligne des langues : après la virgule, il manque le nom d'une langue
+- Des langues sur la ligne et en dessous : soit sur la ligne, soit en dessous
 - Une langue que Humalis ne connaît pas : n'est pas une langue connue de Humalis
 - Une langue pas encore disponible : n'est pas encore disponible
 - Une langue écrite deux fois : est déjà dans le bloc « langues »

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humalis",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Un seul langage, en français, pour créer une application complète : web, mobile, desktop et serveur",
   "type": "module",
   "bin": {