humalis 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,15 @@
+Humalis
+Copyright 2026 Les auteurs de Humalis
+
+Humalis a été créé par kongo bola emmanouch.
+
+Ce logiciel est distribué sous la licence Apache, version 2.0 : voir le
+fichier LICENSE, ou https://www.apache.org/licenses/LICENSE-2.0.
+
+Le nom « Humalis » et son logo ne sont pas couverts par cette licence
+(article 6) : ils ne peuvent pas servir à présenter un autre produit
+comme étant Humalis.
+
+Le code que Humalis produit (sites, applications, serveurs) appartient à
+la personne qui l'a écrit en Humalis, sans aucune obligation envers les
+auteurs de Humalis.

package/README.en.md

@@ -0,0 +1,148 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/logo/humalis-logo-sombre.svg">
+    <img src="docs/logo/humalis-logo.svg" alt="Humalis" width="360">
+  </picture>
+</p>
+
+<p align="center"><a href="README.md">Français</a> · <strong>English</strong></p>
+
+# Humalis
+
+**One language, in French, to build a complete application**: a website, a mobile app, a desktop app and its server, all from the same file.
+
+```humalis
+page "shop" :
+    titre "Our products"
+    variable products = ["Book", "Pen", "Notebook"]
+    pour chaque name dans products :
+        texte name
+    bouton "Order"
+    quand l'utilisateur clique sur "Order" :
+        afficher "Thank you for your order!"
+```
+
+The file reads like a sentence. Humalis turns it into a real project, with readable TypeScript code you can take over by hand. Its keywords are French (`titre` = title, `bouton` = button, `quand` = when); the texts your site shows can be in any language.
+
+## Learn the language
+
+The **[complete guide](docs/guide.en.md)** explains the whole language, from the first title to the server, with a checked example for every construct, and a table of the French keywords with their English meaning. It is also available in [French](docs/guide.md).
+
+## Install
+
+You need [Node.js](https://nodejs.org) 24 or later.
+
+```sh
+npm install -g humalis
+```
+
+## First project
+
+```sh
+humalis nouveau my-project
+cd my-project
+humalis developper
+```
+
+`humalis nouveau` ("new") creates the project; `humalis developper` ("develop") runs the site locally and recompiles it on every save.
+
+## One source, several targets
+
+```sh
+humalis compile my-project.humalis --cible web --sortie my-project-web
+humalis compile my-project.humalis --cible statique --sortie my-project-static
+humalis compile my-project.humalis --cible mobile --sortie my-project-mobile
+humalis compile my-project.humalis --cible desktop --sortie my-project-desktop
+humalis compile my-project.humalis --cible serveur --sortie my-project-server   # if the file has a « serveur "…" : » block
+```
+
+`--cible` is the target, `--sortie` the output folder.
+
+| Target | What Humalis produces |
+|---|---|
+| `web` | a React + Vite project, prerendered (one HTML page per address) |
+| `statique` | static HTML, CSS and JavaScript pages, no build step |
+| `serveur` | a Node server with the Astratra packs (login, permissions, sessions) |
+| `mobile` | an Expo app (iPhone, Android) |
+| `desktop` | an Electron app (Mac, Windows, Linux) |
+
+When a construct does not exist yet on a target, the compiler says so clearly instead of producing something wrong.
+
+### Running each generated project
+
+Each generated folder contains a `LISEZMOI.md` (read me) with these commands.
+
+**Web**: a prerendered site, to put on any static host.
+
+```sh
+cd my-project-web && npm install
+npm run dev      # locally
+npm run build    # the final site, in dist/
+```
+
+**Static**: nothing to install. Open `index.html` in a browser, or upload the folder as it is to a host.
+
+**Mobile**: you need [Expo Go](https://expo.dev/go) on the phone, or the iPhone simulator (Xcode, on a Mac) or the Android emulator.
+
+```sh
+cd my-project-mobile && npm install
+npx expo start   # then « i » for iPhone, « a » for Android, or scan the code with Expo Go
+```
+
+**Desktop**: an Electron app, with a French menu.
+
+```sh
+cd my-project-desktop && npm install
+npm start        # opens the app
+npm run paquet   # the installer, in paquets/: .dmg on Mac, .exe on Windows, AppImage on Linux
+```
+
+The installer is built on the target system (the `.dmg` on a Mac, the `.exe` on Windows). To distribute it to other people, sign it (Apple or Windows certificate): see the [electron-builder](https://www.electron.build/code-signing) documentation.
+
+**Server**: a Node server, generated from the file's `serveur "…" :` block. Its `LISEZMOI.md` lists the routes and who may do what.
+
+```sh
+cd my-project-server && npm install
+cp .env.exemple .env      # then fill in JWT_SECRET and the administrator
+npm test                  # checks every access rule
+npm run build && npm start
+```
+
+Without `DATABASE_URL`, data stays in memory; with it, data goes to PostgreSQL.
+
+## What the language can do
+
+- **Pages and elements**: titles, text, images, buttons, links, forms, icons, tabs, carousel, charts, maps, sound.
+- **Layout**: sections, rows, columns, grids, shared header and footer, content per device (`sur telephone :`).
+- **Look**: a theme (colours, fonts, dark mode), named styles (`avec couleur bleu`), and your own CSS.
+- **Logic**: variables, conditions (`si … et …`, `n'est pas`), loops, functions, lists (`trier`, `dont`, `grouper`), dates (`aujourd'hui plus 3 jours`), money (`{price en euros}`).
+- **Data**: a server in the same file, or an existing API (`source "…"`), with loading and error states.
+- **Interactions**: messages, dialogs and confirmations, keyboard shortcuts, search as you type, copy and share.
+- **Quality**: accessibility checked at compile time, several languages (`titre "Welcome" en francais "Bienvenue"`), share previews and the sitemap.
+
+Error messages are in French, with the line number, and often suggest the fix:
+
+```
+Erreur, ligne 3 : le texte utilise {totl}, mais la variable « totl » n'est pas déclarée. Peut-être « total » ?
+```
+
+## Commands
+
+| Command | Role |
+|---|---|
+| `humalis nouveau <name>` | creates a project |
+| `humalis developper` | runs the site and recompiles it on every save |
+| `humalis compile <file> --cible …` | generates a target's project |
+| `humalis verifier <file>` | shows errors and warnings |
+| `humalis formater <file>` | reformats the file |
+| `humalis tester` | runs the tests written in Humalis (`*.test.humalis`) in a browser |
+
+## For AI assistants
+
+The [`llms.txt`](llms.txt) file, shipped with the package, sums up the grammar, the pitfalls and the error messages, so that an assistant writes correct Humalis.
+
+## Licence
+
+[Apache 2.0](LICENSE). Copyright 2026 The Humalis authors ("Les auteurs de Humalis"); Humalis was created by kongo bola emmanouch (see [`NOTICE`](NOTICE)).
+
+The code Humalis produces (sites, apps, servers) belongs to you, with no obligations. The "Humalis" name and logo are not covered by the licence.

package/README.md

@@ -1,3 +1,146 @@
-# Temporary Holding Version
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/logo/humalis-logo-sombre.svg">
+    <img src="docs/logo/humalis-logo.svg" alt="Humalis" width="360">
+  </picture>
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center"><strong>Français</strong> · <a href="README.en.md">English</a></p>
+
+# Humalis
+
+**Un seul langage, en français, pour créer une application complète** : un site web, une application mobile, une application de bureau et son serveur, à partir du même fichier.
+
+```humalis
+page "boutique" :
+    titre "Nos produits"
+    variable produits = ["Livre", "Stylo", "Cahier"]
+    pour chaque nom dans produits :
+        texte nom
+    bouton "Commander"
+    quand l'utilisateur clique sur "Commander" :
+        afficher "Merci pour ta commande !"
+```
+
+Ce fichier se lit comme une phrase. Humalis le transforme en un vrai projet, avec du code TypeScript lisible que l'on peut reprendre à la main.
+
+## Apprendre le langage
+
+Le **[guide complet](docs/guide.md)** explique tout le langage, du premier titre jusqu'au serveur, avec un exemple vérifié pour chaque construction. Il est aussi en [anglais](docs/guide.en.md).
+
+## Installer
+
+Il faut [Node.js](https://nodejs.org) 24 ou plus récent.
+
+```sh
+npm install -g humalis
+```
+
+## Premier projet
+
+```sh
+humalis nouveau mon-projet
+cd mon-projet
+humalis developper
+```
+
+`humalis developper` lance le site en local et le recompile à chaque enregistrement.
+
+## Une source, plusieurs cibles
+
+```sh
+humalis compile mon-projet.humalis --cible web --sortie mon-projet-web
+humalis compile mon-projet.humalis --cible statique --sortie mon-projet-statique
+humalis compile mon-projet.humalis --cible mobile --sortie mon-projet-mobile
+humalis compile mon-projet.humalis --cible desktop --sortie mon-projet-desktop
+humalis compile mon-projet.humalis --cible serveur --sortie mon-projet-serveur   # si le fichier a un bloc « serveur "…" : »
+```
+
+| Cible | Ce que Humalis produit |
+|---|---|
+| `web` | un projet React + Vite, prérendu (une page HTML par adresse) |
+| `statique` | des pages HTML, CSS et JavaScript, sans construction |
+| `serveur` | un serveur Node avec les packs Astratra (connexion, droits, sessions) |
+| `mobile` | une application Expo (iPhone, Android) |
+| `desktop` | une application Electron (Mac, Windows, Linux) |
+
+Quand une construction n'existe pas encore sur une cible, le compilateur le dit clairement au lieu de produire quelque chose de faux.
+
+### Lancer chaque projet produit
+
+Chaque dossier produit contient un `LISEZMOI.md` qui reprend ces commandes.
+
+**Web** : un site prérendu, à déposer chez n'importe quel hébergeur de fichiers.
+
+```sh
+cd mon-projet-web && npm install
+npm run dev      # en local
+npm run build    # le site final, dans dist/
+```
+
+**Statique** : rien à installer. Ouvre `index.html` dans un navigateur, ou déposez le dossier tel quel chez un hébergeur.
+
+**Mobile** : il faut [Expo Go](https://expo.dev/go) sur le téléphone, ou le simulateur iPhone (Xcode, sur Mac) ou l'émulateur Android.
+
+```sh
+cd mon-projet-mobile && npm install
+npx expo start   # puis « i » pour l'iPhone, « a » pour Android, ou scanne le code avec Expo Go
+```
+
+**Desktop** : une application Electron, avec un menu en français.
+
+```sh
+cd mon-projet-desktop && npm install
+npm start        # ouvre l'application
+npm run paquet   # l'installateur, dans paquets/ : .dmg sur Mac, .exe sur Windows, AppImage sous Linux
+```
+
+L'installateur se construit sur le système visé (le `.dmg` sur un Mac, le `.exe` sur Windows). Pour le distribuer à d'autres personnes, il faut le signer (certificat Apple ou Windows) : voir la documentation d'[electron-builder](https://www.electron.build/code-signing).
+
+**Serveur** : un serveur Node, produit depuis le bloc `serveur "…" :` du fichier. Son `LISEZMOI.md` liste les routes et qui a le droit de faire quoi.
+
+```sh
+cd mon-projet-serveur && npm install
+cp .env.exemple .env      # puis remplir JWT_SECRET et l'administrateur
+npm test                  # vérifie chaque règle d'accès
+npm run build && npm start
+```
+
+Sans `DATABASE_URL`, les données restent en mémoire ; avec, elles vont dans PostgreSQL.
+
+## Ce que le langage sait faire
+
+- **Les pages et les éléments** : titres, textes, images, boutons, liens, formulaires, icônes, onglets, carrousel, graphiques, carte, son.
+- **La mise en page** : sections, lignes, colonnes, grilles, en-tête et pied communs, affichage selon l'appareil (`sur telephone :`).
+- **L'apparence** : un thème (couleurs, polices, mode sombre), des styles nommés (`avec couleur bleu`), et ton propre CSS.
+- **La logique** : variables, conditions (`si … et …`, `n'est pas`), boucles, fonctions, listes (`trier`, `dont`, `grouper`), dates (`aujourd'hui plus 3 jours`), argent (`{prix en euros}`).
+- **Les données** : un serveur dans le même fichier, ou une API existante (`source "…"`), avec les états de chargement et d'erreur.
+- **Les interactions** : messages, fenêtres et confirmations, raccourcis clavier, recherche pendant la frappe, copier et partager.
+- **La qualité** : l'accessibilité vérifiée à la compilation, plusieurs langues (`titre "Bienvenue" en anglais "Welcome"`), l'aperçu de partage et le plan du site.
+
+Les messages d'erreur sont en français, avec la ligne, et proposent souvent la correction :
+
+```
+Erreur, ligne 3 : le texte utilise {totl}, mais la variable « totl » n'est pas déclarée. Peut-être « total » ?
+```
+
+## Les commandes
+
+| Commande | Rôle |
+|---|---|
+| `humalis nouveau <nom>` | crée un projet |
+| `humalis developper` | lance le site et le recompile à chaque enregistrement |
+| `humalis compile <fichier> --cible …` | produit le projet d'une cible |
+| `humalis verifier <fichier>` | affiche les erreurs et les avertissements |
+| `humalis formater <fichier>` | remet le fichier en forme |
+| `humalis tester` | lance les tests écrits en Humalis (`*.test.humalis`) dans un navigateur |
+
+## Pour les assistants (IA)
+
+Le fichier [`llms.txt`](llms.txt), livré avec le paquet, résume la grammaire, les pièges et les messages d'erreur, pour qu'un assistant écrive du Humalis juste.
+
+## Licence
+
+[Apache 2.0](LICENSE). Copyright 2026 Les auteurs de Humalis ; Humalis a été créé par kongo bola emmanouch (voir [`NOTICE`](NOTICE)).
+
+Le code que Humalis produit (sites, applications, serveurs) t'appartient, sans aucune obligation. Le nom « Humalis » et son logo ne sont pas couverts par la licence.

package/dist/analyse/accessibilite.js

@@ -0,0 +1,119 @@
+import { texteSimple } from './ecran.js';
+import { contraste, encreSur, FOND_PAGE } from './couleurs.js';
+import { COULEURS_CSS } from '../cibles/web/styles.js';
+const SEUIL_NORMAL = 4.5;
+const SEUIL_GRAND = 3;
+const motsVides = new Set(['image', 'photo']);
+/** Vérifications qui demandent une intention explicite de l'auteur. */
+export function verifierAccessibilite(page, theme) {
+    const diagnostics = [];
+    const signaler = (gravite, message, ligne) => diagnostics.push({ gravite, categorie: 'accessibilite', message, ligne });
+    let titres = 0;
+    let niveauPrecedent = 1;
+    const liens = new Map();
+    const survols = [];
+    const clics = new Set();
+    const parcours = (instructions, champs = new Map()) => {
+        for (const instruction of instructions) {
+            if (instruction.type === 'Element') {
+                const element = instruction;
+                const texte = texteSimple(element.contenu);
+                const option = (nom) => element.styles.find((s) => s.propriete === nom);
+                if (['bouton', 'lien', 'champ'].includes(element.element) && texte !== undefined && texte.trim() === '') {
+                    signaler('erreur', `le ${element.element} n'a pas de texte. Écrivez un libellé entre guillemets.`, element.ligne);
+                }
+                else if (element.element === 'champ' && texte !== undefined) {
+                    if (!/\p{L}/u.test(texte))
+                        signaler('avertissement', `le libellé « ${texte} » du champ ne contient aucune lettre.`, element.ligne);
+                    const deja = champs.get(texte.toLocaleLowerCase('fr'));
+                    if (deja !== undefined)
+                        signaler('avertissement', `deux champs du même formulaire portent « ${texte} » (premier ligne ${deja}). Donnez-leur des libellés différents.`, element.ligne);
+                    else
+                        champs.set(texte.toLocaleLowerCase('fr'), element.ligne);
+                }
+                if (element.element === 'image') {
+                    const description = option('description')?.valeur;
+                    // Une image sans description ni « decoratif » est déjà une erreur (décision M4, src/analyse/medias.ts).
+                    if (description !== undefined && (description.trim().length < 3 || motsVides.has(description.toLocaleLowerCase('fr')) || description === texte || /^IMG[_-]?\d+/i.test(description))) {
+                        signaler('avertissement', `la description « ${description} » de l'image ne dit rien. Décrivez ce qu'elle montre.`, element.ligne);
+                    }
+                }
+                if (element.element === 'icone' && !option('description') && !option('decoratif')) {
+                    signaler('avertissement', 'cette icône seule n’a pas de description pour le lecteur d’écran. Ajoutez « avec description "…" » ou « avec decoratif ». ', element.ligne);
+                }
+                if (element.element === 'etoiles' && !option('description')) {
+                    signaler('avertissement', 'ces étoiles n’ont pas de description explicite. Ajoutez « avec description "Note : 4 sur 5" ». ', element.ligne);
+                }
+                if (element.element === 'lien' && texte !== undefined && /^(ici|cliquez ici|lire la suite|en savoir plus)$/i.test(texte.trim())) {
+                    const adresses = liens.get(texte.toLocaleLowerCase('fr')) ?? new Set();
+                    if (adresses.size === 0 || !adresses.has(element.cible ?? ''))
+                        signaler('avertissement', `le lien « ${texte} » n'explique pas sa destination. Écrivez un libellé plus précis.`, element.ligne);
+                    adresses.add(element.cible ?? '');
+                    liens.set(texte.toLocaleLowerCase('fr'), adresses);
+                }
+                if (element.element === 'titre') {
+                    titres++;
+                    if (titres > 1)
+                        signaler('avertissement', `la page « ${page.nom} » a plusieurs titres principaux. Gardez un seul « titre ».`, element.ligne);
+                }
+                if (element.element === 'soustitre') {
+                    const niveau = element.niveau ?? 2;
+                    if (niveau < 2 || niveau > 6) {
+                        signaler('erreur', 'le niveau d’un sous-titre doit être entre 2 et 6.', element.ligne);
+                        continue;
+                    }
+                    if (titres === 0)
+                        signaler('avertissement', 'ce sous-titre apparaît avant le titre principal de la page.', element.ligne);
+                    if (niveau > niveauPrecedent + 1)
+                        signaler('avertissement', `ce sous-titre fait un saut de niveau : après ${niveauPrecedent}, écrivez un niveau ${niveauPrecedent + 1}.`, element.ligne);
+                    niveauPrecedent = niveau;
+                }
+                if (['texte', 'titre', 'bouton', 'lien', 'champ'].includes(element.element))
+                    verifierContraste(element, theme, signaler);
+            }
+            else if (instruction.type === 'Formulaire')
+                parcours(instruction.corps, new Map());
+            else if (instruction.type === 'Evenement') {
+                if (instruction.genre === 'survol')
+                    survols.push({ cible: instruction.cible, ligne: instruction.ligne });
+                if (instruction.genre === 'clic')
+                    clics.add(instruction.cible);
+                parcours(instruction.corps, champs);
+            }
+            else if (instruction.type === 'Bloc' || instruction.type === 'Boucle')
+                parcours(instruction.corps, champs);
+            else if (instruction.type === 'Condition') {
+                parcours(instruction.alors, champs);
+                parcours(instruction.sinon, champs);
+            }
+        }
+    };
+    parcours(page.corps);
+    for (const survol of survols) {
+        if (!clics.has(survol.cible))
+            signaler('avertissement', 'ce survol n’a pas d’action au clic : le clavier et les écrans tactiles ne peuvent pas le déclencher.', survol.ligne);
+    }
+    if (titres === 0)
+        signaler('avertissement', `la page « ${page.nom} » n'a pas de titre principal. Ajoutez « titre "…" ».`, page.ligne);
+    return diagnostics;
+}
+function verifierContraste(element, theme, signaler) {
+    const valeur = (nom) => element.styles.find((s) => s.propriete === nom)?.valeur;
+    const couleur = valeur('couleur') ?? valeur('texte');
+    const fond = valeur('fond');
+    if (!couleur && !fond)
+        return;
+    const seuil = valeur('taille') === 'grande' ? SEUIL_GRAND : SEUIL_NORMAL;
+    for (const mode of ['clair', 'sombre']) {
+        const hex = (nom) => theme.get(nom)?.[mode] ?? COULEURS_CSS[nom]?.[mode];
+        const fondHex = fond ? hex(fond) : FOND_PAGE[mode];
+        const encreHex = couleur ? hex(couleur) : fondHex ? encreSur(fondHex) : undefined;
+        if (!fondHex || !encreHex)
+            continue;
+        const rapport = contraste(encreHex, fondHex);
+        if (rapport >= seuil)
+            continue;
+        const suggestions = Object.entries(COULEURS_CSS).filter(([, c]) => contraste(c[mode], fondHex) >= seuil).map(([nom]) => nom).slice(0, 3);
+        signaler('avertissement', `le contraste du texte en ${couleur ?? 'couleur calculée'} est ${rapport.toFixed(1).replace('.', ',')} en mode ${mode} ; il faut ${seuil.toString().replace('.', ',')}. Essayez ${suggestions.join(', ')}.`, element.ligne);
+    }
+}