humalis 1.1.0 → 1.2.0

package/dist/parser/parser.js

@@ -776,7 +776,7 @@ function estBlocMiseEnPage(flux) {
     const suivant = flux.regarder(1);
     return ((suivant.type === 'PONCTUATION' && suivant.valeur === ':') ||
         (suivant.type === 'MOT_CLE' && suivant.valeur === 'avec') ||
-        (genre === 'menu' && estLeMot(suivant, 'repliable')) ||
+        (genre === 'menu' && (estLeMot(suivant, 'repliable') || estLeMot(suivant, 'vertical'))) ||
         ((genre === 'section' || GENRES_AVEC_TITRE.includes(genre)) && suivant.type === 'CHAINE'));
 }
 function analyserBlocMiseEnPage(flux) {
@@ -786,9 +786,15 @@ function analyserBlocMiseEnPage(flux) {
         flux.avancer();
     const genre = filAriane ? 'filAriane' : GENRES_BLOC.find((g) => estLeMot(debut, g));
     // « menu repliable : » : sur un petit écran, un bouton « Menu » ouvre et ferme les liens.
-    const repliable = genre === 'menu' && estLeMot(flux.actuel(), 'repliable');
-    if (repliable)
-        flux.avancer();
+    // « menu vertical : » : les liens en colonne. Les deux se combinent, dans n'importe quel ordre.
+    let repliable = false;
+    let vertical = false;
+    while (genre === 'menu' && (estLeMot(flux.actuel(), 'repliable') || estLeMot(flux.actuel(), 'vertical'))) {
+        if (estLeMot(flux.avancer(), 'repliable'))
+            repliable = true;
+        else
+            vertical = true;
+    }
     // Le titre d'une section devient son premier élément : un « titre » comme les autres.
     const titre = [];
     let titreBloc;
@@ -824,7 +830,7 @@ function analyserBlocMiseEnPage(flux) {
         } while (flux.accepter('MOT_CLE', 'et'));
     }
     flux.attendre('PONCTUATION', ':', `deux-points à la fin de la ligne « ${genre} », puis son contenu en dessous, décalé`);
-    return { type: 'Bloc', genre, styles, classes, ...(titreBloc ? { titre: titreBloc } : {}), ...(ancre !== undefined ? { ancre } : {}), ...(nom !== undefined ? { nom } : {}), ...(repliable ? { repliable } : {}), corps: [...titre, ...analyserBloc(flux)], ligne: debut.ligne };
+    return { type: 'Bloc', genre, styles, classes, ...(titreBloc ? { titre: titreBloc } : {}), ...(ancre !== undefined ? { ancre } : {}), ...(nom !== undefined ? { nom } : {}), ...(repliable ? { repliable } : {}), ...(vertical ? { vertical } : {}), corps: [...titre, ...analyserBloc(flux)], ligne: debut.ligne };
 }
 function lireNombre(flux, description) {
     const negatif = flux.accepter('PONCTUATION', '-');

package/dist/ri/construire.js

@@ -691,6 +691,9 @@ class Construction {
         // « menu repliable » : la marque que lisent le CSS et le bouton « Menu ».
         if (instruction.repliable)
             options.push({ nom: 'menu', valeur: 'repliable' });
+        // « menu vertical » : la colonne que lit le CSS.
+        if (instruction.vertical)
+            options.push({ nom: 'menu', valeur: 'vertical' });
         const noeud = {
             type: 'bloc',
             genre: instruction.genre,

package/docs/guide.en.md

@@ -187,8 +187,10 @@ Keep the levels in order, without skipping: screen readers use them to move
 through the page.
 
 Inside a block placed under a subtitle, a `soustitre` goes down one level on its
-own: a card in a section becomes level 3. `avec niveau` (with level) still lets
-you choose.
+own: a card in a section becomes level 3. In a `section`, the first subtitle is
+the section's title, even when it sits in its own block; every other subtitle of
+the section goes down one level. `avec niveau` (with level) still lets you
+choose.
 
 ```humalis
 page "home" :
@@ -608,12 +610,23 @@ page "menu" :
 ```
 
 `fil d'Ariane` is a breadcrumb. In a `menu`, the link to the current page is
-marked as active. The links of a menu wrap when space runs out. A menu that
-your CSS turns into a column (`flex-direction: column`) keeps that wrapping: add
-`flex-wrap: nowrap` so it scrolls instead of starting a second column.
+marked as active. The links of a menu wrap when space runs out. A `menu
+vertical :` stacks its links in a column and never starts a second column: a
+table of contents with a limited height scrolls. It combines with `repliable`
+(`menu vertical repliable :`).
 
-A `menu repliable :` (collapsible menu) folds behind a "Menu" button on a small
-screen (phone); choosing a link closes it. On a large screen it stays open:
+```humalis
+page "guide" :
+    titre "The guide"
+    menu vertical :
+        lien "Install" vers "guide"
+        lien "Pages" vers "guide"
+```
+
+A `menu repliable :` (collapsible menu) folds behind a burger button (named
+"Menu" for screen readers) on a small screen (phone); the icon turns into a cross
+while the menu is open. Choosing a link, tapping outside or pressing Escape
+closes it. On a large screen it stays open:
 
 ```humalis
 page "home" :

package/docs/guide.md

@@ -176,8 +176,10 @@ 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. `avec niveau` reste possible
-pour choisir soi-même.
+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" :
@@ -573,13 +575,23 @@ 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 que ton
-CSS met en colonne (`flex-direction: column`) garde ce retour à la ligne :
-ajoute `flex-wrap: nowrap` pour qu'il défile au lieu d'ouvrir une deuxième
-colonne.
+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 :`).
 
-Un `menu repliable :` se range derrière un bouton « Menu » sur un petit écran
-(téléphone) ; un lien choisi referme le menu. Sur grand écran, il reste ouvert :
+```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" :

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humalis",
-  "version": "1.1.0",
+  "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": {