humalis 1.2.0 → 1.3.1

package/dist/outils/developpement.js

@@ -3,6 +3,7 @@ import { existsSync, mkdirSync, readFileSync, statSync } from 'node:fs';
 import { createServer } from 'node:http';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { AIDE_REPERES } from '../cibles/commun/reperes.js';
 export function dependances(fichier, source) {
     return [...source.matchAll(/^\s*utiliser\s+(?:fichier|style)\s+"([^"]+)"/gmu)]
         .map((capture) => resolve(dirname(fichier), capture[1]));
@@ -72,7 +73,8 @@ export async function developper(fichier, port) {
         reponse.setHeader('Access-Control-Allow-Origin', '*');
         if (requete.url === '/diagnostics.js') {
             reponse.setHeader('Content-Type', 'text/javascript');
-            reponse.end(`let panneau=document.createElement('pre');panneau.style='position:fixed;inset:0 0 auto;z-index:999999;background:#420;color:white;padding:1rem;white-space:pre-wrap;display:none';document.body.append(panneau);setInterval(async()=>{let e=await(await fetch('http://localhost:${port + 1}/diagnostics')).text();panneau.textContent=e;panneau.style.display=e?'block':'none'},500);`);
+            // L'aide Alt + survol (le fichier et la ligne Humalis d'un élément), puis le panneau des erreurs.
+            reponse.end(AIDE_REPERES + `let panneau=document.createElement('pre');panneau.style='position:fixed;inset:0 0 auto;z-index:999999;background:#420;color:white;padding:1rem;white-space:pre-wrap;display:none';document.body.append(panneau);setInterval(async()=>{let e=await(await fetch('http://localhost:${port + 1}/diagnostics')).text();panneau.textContent=e;panneau.style.display=e?'block':'none'},500);`);
         }
         else {
             reponse.setHeader('Content-Type', 'text/plain; charset=utf-8');

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/miseEnPage.js

@@ -56,7 +56,7 @@ export function analyserStylePropre(flux, propriete) {
     return undefined;
 }
 const APPAREILS = ['telephone', 'tablette', 'ordinateur'];
-const DRAPEAUX = ['modifiable', 'ouvert', 'plusieurs', 'pourcentage', 'boucle'];
+const DRAPEAUX = ['modifiable', 'ouvert', 'plusieurs', 'pourcentage', 'boucle', 'fixe'];
 /** « sur telephone : », « sur tablette ou ordinateur : » (en tête de ligne, suivi d'un appareil). */
 export function estSurAppareil(flux) {
     return flux.verifier('MOT_CLE', 'sur') && estMot(flux.regarder(1)) && APPAREILS.includes(normaliser(flux.regarder(1).valeur));

package/dist/vocabulaire/table-ecran.js

@@ -100,6 +100,10 @@ export const ENTREES_ECRAN = [
     style('ombre', 'Une ombre sous l’élément : aucune, legere, moyenne ou forte.', PAGE('    bloc avec ombre legere :\n        texte "Poisson braisé"'), 'box-shadow', 'StyleSheet shadow* et elevation'),
     style('degrade', 'Un fond en dégradé entre deux couleurs : « degrade bleu vers violet », puis au besoin vertical ou horizontal (diagonal sinon).', PAGE('    bloc avec degrade bleu vers violet :\n        titre "Réservez" avec texte blanc'), 'linear-gradient', 'LinearGradient (expo-linear-gradient)', undefined, 'Deux couleurs seulement (de base ou du thème) ; un dégradé plus fin s’écrit en CSS.'),
     style('colle', 'L’élément reste collé en haut de l’écran quand on défile ; « colle en bas » le colle en bas.', PAGE('    bloc avec colle :\n        texte "Toujours visible"'), 'position: sticky', null, undefined, 'Sur le téléphone, seuls l’en-tête et le pied de page restent collés ; ailleurs, un avertissement le dit.'),
+    // ─── Défilement et hauteur (plan, apparence sans CSS) ────────────────
+    style('defilement', 'Le bloc défile seul, avec sa propre barre, sans faire bouger le reste de la page : « defilement interne ».', PAGE('    ligne avec hauteur ecran :\n        colonne avec defilement interne :\n            texte "Un long chapitre."'), 'overflow-y: auto', null, [...BLOCS, 'menu'], 'Sur le téléphone, toute la page défile : un avertissement le dit.'),
+    style('hauteur', 'Le bloc prend toute la hauteur de l’écran, sous l’en-tête : « hauteur ecran ».', PAGE('    ligne avec hauteur ecran :\n        colonne avec defilement interne :\n            texte "Un long chapitre."'), 'height: 100dvh', null, BLOCS, 'Sur le téléphone, toute la page défile : un avertissement le dit.'),
+    { ...style('fixe', 'L’en-tête ne bouge jamais : seule la zone en dessous défile, avec sa barre (« entete avec fixe : »).', 'entete avec fixe :\n    lien "Accueil" vers "accueil"\n\npage "accueil" :\n    titre "Accueil"', 'position: fixed', null, ['entete'], 'Seulement sur l’en-tête. Sur le téléphone, l’en-tête reste en haut comme avec « colle ».'), valeurLibre: true },
     style('sur', 'Dans un bloc « sur telephone : », les appareils où le contenu s’affiche.', PAGE('    sur telephone :\n        texte "Petit écran"'), 'display', 'SurAppareil (largeur de la fenêtre)', ['appareil']),
     // ─── La publication (plan 2026-10-30-qualite-publication, parties 3 à 5) ──
     {
@@ -389,6 +393,8 @@ export const ENTREES_ECRAN = [
     valeur('forte', ['ombre'], 'Une ombre marquée.', PAGE('    bloc avec ombre forte :\n        texte "a"'), ['fort']),
     valeur('douce', ['bordure', 'transition'], 'Des coins légèrement arrondis ; pour une transition, des changements adoucis (200 ms).', PAGE('    bloc avec bordure douce :\n        texte "a"'), ['doux']),
     valeur('ronde', ['bordure'], 'Une forme ronde : un cercle pour un élément carré.', PAGE('    bloc avec bordure ronde :\n        texte "a"'), ['rond']),
+    valeur('interne', ['defilement'], 'Le bloc a son propre défilement : « defilement interne ».', PAGE('    colonne avec defilement interne :\n        texte "a"')),
+    valeur('ecran', ['hauteur'], 'La hauteur de l’écran, moins celle de l’en-tête : « hauteur ecran ».', PAGE('    ligne avec hauteur ecran :\n        texte "a"'), [], 'écran'),
     valeur('haut', ['colle'], 'Collé en haut de l’écran (par défaut).', PAGE('    bloc avec colle :\n        texte "a"')),
     valeur('bas', ['colle'], 'Collé en bas de l’écran : « colle en bas ».', PAGE('    bloc avec colle en bas :\n        texte "a"')),
     valeur('telephone', ['sur'], 'Un écran de moins de 640 pixels de large.', PAGE('    sur telephone :\n        texte "a"'), ['telephones'], 'téléphone'),

package/docs/guide.en.md

@@ -408,6 +408,11 @@ CSS can also come from a file: `utiliser style "./theme.css"` at the top of
 the file. CSS applies to the web, static and desktop targets; mobile only
 translates named styles (colour, background, size, position, border).
 
+`humalis verifier` warns when a class used with `avec style` is missing from
+the project's CSS and suggests a close name. It also warns when an
+`!important` rule targets a `.humalis-…` class: remove `!important` or use
+your own class.
+
 ---
 
 ## 6. Layout
@@ -446,6 +451,33 @@ Block settings: `largeur` (width: `etroite` narrow, `large` wide),
 `alignement centre` (centred), `degrade bleu vers violet` (gradient), `colle`
 (sticks to the top while scrolling).
 
+### A page that fits the screen
+
+`entete avec fixe :` (fixed header) keeps the header still: only the area below
+scrolls, with its own scrollbar. `hauteur ecran` (screen height) makes a block
+fill the screen under the header, and `defilement interne` (inner scrolling)
+gives a block its own scrolling without moving the rest. Together they make a
+documentation page: the table of contents and the text each scroll on their own,
+without a line of CSS.
+
+```humalis
+entete avec fixe :
+    lien "Home" vers "guide"
+
+page "guide" :
+    titre "The guide"
+    ligne avec hauteur ecran :
+        menu vertical avec defilement interne :
+            lien "Install" vers "guide"
+            lien "Pages" vers "guide"
+        colonne avec defilement interne :
+            texte "A long chapter that scrolls on its own."
+```
+
+On the static target, the scrollbar stays the window's. On a phone the whole page
+scrolls: `hauteur ecran` and `defilement interne` have no effect, and a warning
+says so.
+
 ### Depending on the device
 
 ```humalis
@@ -1927,6 +1959,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 |
@@ -1940,6 +1973,14 @@ For web and static, `--adresse https://…` gives the site's final address
 (sitemap, share links). For desktop, `--serveur https://…` gives the address
 of the server the application calls.
 
+With `humalis developper`, every element of the page carries its Humalis
+file and line: in the browser's inspector, a heading shows for example
+`data-humalis-source="pages/accueil.humalis:12"` (the path starts from the
+main file, the line is the one in that file). Hold the Alt key (Option on
+Mac) and hover over an element: a small label shows the same reference next
+to the cursor. `humalis compile` adds none of this: the published site stays
+identical.
+
 ### Error messages
 
 Messages are in French, with the line number, and often suggest the fix:

package/docs/guide.md

@@ -389,6 +389,10 @@ Le CSS peut aussi venir d'un fichier : `utiliser style "./theme.css"` en haut du
 fichier. Le CSS s'applique au web, au statique et au desktop ; le mobile ne
 traduit que les styles nommés (couleur, fond, taille, position, bordure).
 
+`humalis verifier` avertit si une classe donnée par `avec style` est absente du CSS
+du projet et propose un nom proche. Il avertit aussi si une règle `!important`
+cible une classe `.humalis-…` : retirez `!important` ou utilisez votre propre classe.
+
 ---
 
 ## 6. La mise en page
@@ -424,6 +428,32 @@ Les réglages des blocs : `largeur` (`etroite`, `large`), `remplissage` et
 `moyenne`), `bordure douce`, `repartition entre`, `alignement centre`,
 `degrade bleu vers violet`, `colle` (reste en haut pendant le défilement).
 
+### Une page qui tient dans l'écran
+
+`entete avec fixe :` garde l'en-tête immobile : seule la zone en dessous défile,
+avec sa barre. `hauteur ecran` fait remplir l'écran à un bloc, sous l'en-tête, et
+`defilement interne` donne à un bloc son propre défilement, sans faire bouger le
+reste. Ensemble, ils font une page de documentation : le sommaire et le texte
+défilent chacun de leur côté, sans une ligne de CSS.
+
+```humalis
+entete avec fixe :
+    lien "Accueil" vers "guide"
+
+page "guide" :
+    titre "Le guide"
+    ligne avec hauteur ecran :
+        menu vertical avec defilement interne :
+            lien "Installer" vers "guide"
+            lien "Les pages" vers "guide"
+        colonne avec defilement interne :
+            texte "Un long chapitre, qui défile seul."
+```
+
+Sur le statique, la barre de défilement reste celle de la fenêtre. Sur le
+téléphone, toute la page défile : `hauteur ecran` et `defilement interne` n'ont
+pas d'effet, et un avertissement le dit.
+
 ### Selon l'appareil
 
 ```humalis
@@ -1841,6 +1871,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 |
@@ -1854,6 +1885,14 @@ Pour le web et le statique, `--adresse https://…` donne l'adresse finale du
 site (plan du site, liens de partage). Pour le desktop, `--serveur https://…`
 donne l'adresse du serveur que l'application appelle.
 
+Avec `humalis developper`, chaque élément de la page porte son fichier
+Humalis et sa ligne : dans l'inspecteur du navigateur, un titre montre par
+exemple `data-humalis-source="pages/accueil.humalis:12"` (le chemin part du
+fichier principal, la ligne est celle de ce fichier). Tiens la touche Alt
+(Option sur Mac) et survole un élément : une petite étiquette affiche ce
+même repère près du curseur. `humalis compile` n'ajoute rien de tout cela :
+le site publié reste identique.
+
 ### Les messages d'erreur
 
 Les messages sont en français, avec la ligne, et proposent souvent la

package/llms.txt

@@ -146,7 +146,8 @@ page "accueil" :
 - Un nom de classe CSS sans guillemets : il manque le nom de la classe CSS entre guillemets
 - « utiliser » sans « style » : il manque « style » après « utiliser »
 - Un chemin de fichier CSS sans guillemets : il manque le chemin du fichier CSS entre guillemets
-- Une classe CSS définie nulle part : n'est définie dans aucun bloc style
+- Un style CSS introuvable : n'est défini dans aucun CSS du projet
+- Une règle CSS écrase un style Humalis : le CSS écrase « humalis-page »
 - Une option de variable inconnue : n'est pas une option de variable
 - Un mot après « memorisee en » qui n’est pas « secret » : est attendu après « memorisee en »
 - Une variable en haut du fichier sans « avec partagee » : ajoutez « avec partagee »

package/package.json

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