humalis 1.0.4 → 1.2.0

package/docs/guide.md

@@ -93,6 +93,14 @@ Un texte qui s'affiche s'écrit entre guillemets : `titre "Bienvenue"`. Sans
 guillemets, c'est un nom de variable : `texte prenom` affiche ce que contient
 la variable `prenom`.
 
+Pour mettre un guillemet dans un texte, écris `\"` :
+
+```humalis
+page "citation" :
+    titre "Une citation"
+    texte "Elle a dit \"bonjour\" en entrant."
+```
+
 ### Les accents sont permis, jamais obligatoires
 
 `si age est supérieur ou égal à 18` et `si age est superieur ou egal a 18` se
@@ -167,6 +175,96 @@ page "carte" :
 l'ordre des niveaux, sans en sauter : les lecteurs d'écran s'en servent pour
 parcourir la page.
 
+Dans un bloc placé sous un sous-titre, un `soustitre` descend d'un niveau tout
+seul : la carte d'une section devient un niveau 3. Dans une `section`, le premier
+sous-titre est le titre de la section, même rangé dans son propre bloc ; tous les
+autres sous-titres de la section descendent d'un niveau. `avec niveau` reste
+possible pour choisir soi-même.
+
+```humalis
+page "accueil" :
+    titre "Accueil"
+    section :
+        soustitre "Nos pages"
+        grille :
+            bloc :
+                soustitre "Exemples"
+                texte "Six applications à essayer."
+```
+
+Dans un `titre`, un `soustitre` ou un `texte`, `{accent "…"}` met quelques mots
+en valeur avec la couleur de marque. Le texte reste lisible normalement par les
+lecteurs d'écran et dans le titre de l'onglet.
+
+```humalis
+page "offre" :
+    titre "Une offre {accent "simple"}"
+    texte "Prix : {accent "gratuit"} pour toujours"
+```
+
+### Listes
+
+`liste :` crée des puces ; `liste numerotee :` numérote chaque élément. Chaque instruction du bloc devient une entrée.
+
+```humalis
+page "guide" :
+    liste :
+        texte "Installer Node.js"
+        texte "Créer le projet"
+    liste numerotee :
+        texte "Écrire le fichier"
+        texte "Compiler"
+```
+
+### Code dans une phrase
+
+Dans un texte, `{code "…"}` affiche un court morceau de code à chasse fixe.
+
+```humalis
+page "guide" :
+    texte "Écris {code "titre"} pour donner un titre."
+```
+
+### Bloc de code
+
+`code langage :` recopie les lignes indentées sans les interpréter ; le langage est facultatif.
+
+```humalis
+page "guide" :
+    code humalis :
+        page "accueil" :
+            titre "Bienvenue"
+```
+
+`avec animation frappe` écrit le code lettre par lettre, avec un curseur ;
+`avec animation frappe au defilement` attend que le bloc arrive à l'écran. Le
+vrai code reste en place pendant la frappe (lecteurs d'écran, bouton Copier), et
+il s'affiche tout de suite si la personne a demandé de réduire les animations.
+Sur le téléphone, le code s'affiche entier.
+
+```humalis
+page "accueil" :
+    code humalis avec animation frappe :
+        page "boutique" :
+            titre "Nos produits"
+            bouton "Commander"
+```
+
+### Tableau
+
+Un tableau a une légende, des colonnes et des rangées de même largeur. Une traduction peut suivre chaque cellule.
+
+```humalis
+langues :
+    francais
+    anglais
+
+page "guide" :
+    tableau "Les commandes" en anglais "Commands" :
+        colonnes "Commande", "Rôle" en anglais "Role"
+        rangee "humalis compile", "produit le projet" en anglais "builds the project"
+```
+
 ### Image
 
 ```humalis
@@ -363,10 +461,35 @@ page "accueil" :
 Humalis vérifie le contraste : une couleur de texte trop pâle sur le fond est
 signalée à la compilation.
 
+Une police peut être livrée avec le site, sans dépendre d'un service extérieur :
+`police titres "Space Grotesk" depuis "./polices/space-grotesk.woff2"` (fichiers
+`.woff2`, `.woff`, `.ttf` ou `.otf`).
+
+Le visiteur peut aussi passer d'un thème à l'autre. `basculer theme` passe au
+thème inverse de celui qu'on voit, et `si theme est sombre :` (ou `clair`)
+réagit au thème affiché :
+
+```humalis
+theme :
+    mode automatique
+
+page "accueil" :
+    titre "Accueil"
+    bouton "Changer de thème"
+    quand l'utilisateur clique sur "Changer de thème" :
+        basculer theme
+    si theme est sombre :
+        texte "Bonne soirée"
+    sinon :
+        texte "Bonne journée"
+```
+
 ### L'en-tête et le pied communs
 
 `entete :` et `pied :` s'affichent sur toutes les pages. Une page peut s'en
-passer avec `sans entete` ou `sans pied`.
+passer avec `sans entete` ou `sans pied`. Avec un en-tête, Humalis ajoute seul
+un lien « Aller au contenu », caché tant que le clavier ne l'atteint pas : il
+permet de sauter l'en-tête.
 
 ```humalis
 entete avec colle :
@@ -452,6 +575,32 @@ page "carte" :
 ```
 
 Dans un `menu`, le lien de la page où l'on est est marqué comme actif.
+Les liens d'un menu passent à la ligne quand la place manque. Un `menu
+vertical :` range ses liens en colonne, sans jamais ouvrir une deuxième colonne :
+un sommaire de hauteur limitée défile. Il se combine avec `repliable`
+(`menu vertical repliable :`).
+
+```humalis
+page "guide" :
+    titre "Le guide"
+    menu vertical :
+        lien "Installer" vers "guide"
+        lien "Les pages" vers "guide"
+```
+
+Un `menu repliable :` se range derrière un bouton burger (nommé « Menu » pour les
+lecteurs d'écran) sur un petit écran (téléphone) ; l'icône devient une croix
+quand le menu est ouvert. Un lien choisi, un toucher à côté ou la touche Échap
+referment le menu. Sur grand écran, il reste ouvert :
+
+```humalis
+page "accueil" :
+    menu repliable :
+        lien "Accueil" vers "accueil"
+        lien "La carte" vers "accueil"
+        lien "Réserver" vers "accueil"
+    titre "Accueil"
+```
 
 ---
 
@@ -497,6 +646,17 @@ Les animations : `apparition`, `montee`, `agrandissement`. Les effets au
 survol : `agrandi`, `leve`. Humalis respecte le réglage « réduire les
 animations » de la personne.
 
+Sur un bloc, `et en cascade` fait apparaître ses enfants l'un après l'autre :
+
+```humalis
+page "accueil" :
+    titre "Nos plats"
+    grille avec animation montee au defilement et en cascade :
+        texte "Soupe du jour"
+        texte "Risotto"
+        texte "Tarte aux pommes"
+```
+
 ---
 
 ## 9. Les variables et les calculs
@@ -893,8 +1053,10 @@ Les actions s'écrivent dans un événement.
 | `afficher erreur "…"` | un message d'erreur |
 | `montrer "nom"`, `cacher "nom"` | fait apparaître ou disparaître un élément |
 | `changer x par …` | change une variable |
+| `changer x par champ "Libellé"` | prend la valeur actuelle d'un champ |
 | `changer texte de "nom" par "…"` | change le texte d'un élément |
 | `ajouter … à liste`, `retirer … de liste` | modifie une liste |
+| `ajouter champ "Libellé" à liste` | ajoute la valeur actuelle d'un champ |
 | `rediriger vers "page"` | va à une page |
 | `revenir vers "page"` | revient en arrière, ou va à cette page |
 | `envoyer requete vers "…"` | appelle un serveur (voir [le serveur](#22-relier-les-pages-au-serveur)) |
@@ -915,6 +1077,22 @@ page "merci" :
     titre "Merci !"
 ```
 
+Dans une action, `champ "Libellé"` lit ce que la personne a saisi au moment du clic. Un champ nombre donne un nombre, une case à cocher donne vrai ou faux, et les autres champs donnent du texte. Le libellé est celui de la langue de base, même si le champ a une traduction.
+
+```humalis
+page "taches" :
+    variable taches = ["Acheter du pain"]
+    variable dernier = ""
+    champ "Nouvelle tâche"
+    bouton "Ajouter"
+    quand l'utilisateur clique sur "Ajouter" :
+        ajouter champ "Nouvelle tâche" à taches
+        changer dernier par champ "Nouvelle tâche"
+    texte "Dernière ajoutée : {dernier}"
+    pour chaque t dans taches :
+        texte t
+```
+
 ---
 
 ## 16. Les messages, les fenêtres et les questions
@@ -1534,9 +1712,13 @@ page "catalogue" :
 ```
 
 - `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"`.
 - `traductions anglais :` traduit une seule fois un texte répété.
 - `selecteur de langue` affiche le choix de la langue ; `changer langue par
   anglais` et `si langue est anglais :` s'utilisent dans les événements.
+- Le message de `copier` se traduit comme les autres textes :
+  `copier code avec message "Copié" en anglais "Copied"`.
 - Humalis signale à la compilation tout texte qui n'a pas sa traduction. Les
   messages de Humalis (champ obligatoire, chargement…) suivent la langue.
 

package/llms.txt

@@ -5,7 +5,7 @@ Humalis est un langage en français. Un fichier .humalis décrit des pages, des
 ## Grammaire en une page
 
 - Une page commence par `page "nom" :`. Son contenu est indenté de 4 espaces ; chaque bloc ajoute 4 espaces.
-- Les éléments d’écran pris en charge : titre, texte, image, bouton, lien, champ, formulaire, section, bloc, ligne, colonne, grille, sous-titre, fenêtre, menu, icône, badge, avatar, progression, chargement, étoiles, compteur, code QR, onglets, onglet, déroulant, accordéon, carrousel, fil d’Ariane, audio, fichier, carte, marqueur, graphique, série, sélecteur. Leur texte s’écrit entre guillemets.
+- Les éléments d’écran pris en charge : titre, texte, image, bouton, lien, champ, formulaire, section, bloc, ligne, colonne, grille, sous-titre, liste, tableau, fenêtre, menu, icône, badge, avatar, progression, chargement, étoiles, compteur, code QR, onglets, onglet, déroulant, accordéon, carrousel, fil d’Ariane, audio, fichier, carte, marqueur, graphique, série, sélecteur. Leur texte s’écrit entre guillemets.
 - Déclare une valeur avec `variable nom = valeur` ; une condition commence par `si ... :`.
 - Les événements pris en charge : quand, utilisateur, clique, sur, survole, charge, soumis, ecrit, arrête d’écrire, appuie, arrive en bas de, l’ordre de … change. Écris l’événement sous l’élément visé, puis l’action dans son bloc.
 - Les actions prises en charge : afficher, erreur, montrer, cacher, changer, rediriger, ajouter, retirer, envoyer, requête, connecter, déconnecter, revenir, réussite, avertissement, pendant, disparaître, action, après, toutes, copier, partager, confirmer.
@@ -27,6 +27,15 @@ page "accueil" :
 
 ## Messages d’erreur
 
+- Code dans une phrase sans guillemets : code attend un texte entre guillemets
+- Une ligne inconnue dans un tableau : un tableau contient « colonnes » et « rangee »
+- Deux-points après un tableau : deux-points après la légende du tableau
+- Bloc de code dans un événement : un bloc de code se place dans une page
+- Tableau sans légende : un tableau attend une légende
+- Tableau sans colonnes : un tableau attend une ligne « colonnes »
+- Rangée de mauvaise largeur : la rangée a 1 cellules
+- Texte accentué sans guillemets : accent attend un texte entre guillemets
+- Accent hors d’un texte de page : accent s’emploie seulement
 - Un élément sans texte : n'a pas de texte
 - Un libellé sans lettre : ne contient aucune lettre
 - Deux champs de même nom : deux champs du même formulaire
@@ -224,6 +233,8 @@ page "accueil" :
 - Un nom d’ancre qui n’est pas valable : n'est pas valable
 - Deux ancres de même nom : est déjà utilisée dans la page
 - Un lien vers une ancre qui n’existe pas : n'existe pas dans la page « carte »
+- Un lien de l’en-tête ou du pied vers une ancre qui n’existe nulle part : n'existe dans aucune page
+- Une page et un composant qui auraient le même nom : auraient le même nom dans le code produit
 - Une adresse qui peut exécuter du code : est refusée
 - Des paramètres de page sur une adresse externe : n'a pas de paramètres de page
 - « nouvel onglet » sur autre chose qu’un lien : s'applique à un lien
@@ -257,6 +268,8 @@ page "accueil" :
 - Une animation sans nom : il manque le nom de l’animation
 - « duree » ou « delai » sans animation : donne l’attente d’une animation
 - « au defilement » sans animation : « au defilement » suit le nom d’une animation
+- « en cascade » sur un simple élément : il s’écrit sur un bloc
+- Un texte traduit et « sans traduction » : gardez l’un ou l’autre
 - Une animation sur un champ : pas d’animation sur un champ
 - Trop d’éléments animés au défilement : trop de mouvement
 - Une image sans description : décrivez l’image pour les personnes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humalis",
-  "version": "1.0.4",
+  "version": "1.2.0",
   "description": "Un seul langage, en français, pour créer une application complète : web, mobile, desktop et serveur",
   "type": "module",
   "bin": {
@@ -22,7 +22,7 @@
     "node": ">=24"
   },
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc && rolldown dist/navigateur.js --format esm --minify --file dist/navigateur.js",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "essai:web": "node scripts/essai-web.mjs",
@@ -40,6 +40,7 @@
     "essai:desktop": "node scripts/essai-desktop.mjs",
     "essai:formulaire": "node scripts/essai-formulaire.mjs",
     "essai:vitrine": "node scripts/essai-vitrine.mjs",
+    "site:doc": "node scripts/doc-site.mjs",
     "llms": "node --disable-warning=ExperimentalWarning --experimental-loader ./scripts/charger-typescript.mjs scripts/generer-llms.mjs",
     "essai:medias": "node scripts/essai-medias.mjs",
     "essai:interactions": "node scripts/essai-interactions.mjs",
@@ -74,6 +75,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
+    "rolldown": "1.2.4",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   }