@fraza/core 0.3.7 → 0.3.10

package/dist/docs/06-modules/forms/{configuration.md → 02-configuration.md}

@@ -4,7 +4,7 @@ description: Variable d'activation, dépendances d'origine, de courriel et de st
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 03-reference/06-configuration/variables-d-environnement
 ---
 
@@ -30,7 +30,7 @@ En revanche, trois services du core conditionnent son fonctionnement. Les ignore
 | `FRAZA_STORAGE_*` | Les champs de type fichier échouent. Le reste du formulaire fonctionne. |
 | `FRAZA_ENCRYPTION_KEY` | Aucun jeton de délai n'est émis : le délai minimal n'est pas vérifié, avec un avertissement au journal. |
 | Table `fraza_email_outbox` (`npx fraza-db migrate`) | Aucun courriel n'est mis en file. Les soumissions sont enregistrées. |
-| `FRAZA_NAME`, `FRAZA_LOGO_URL`, `FRAZA_SITE_URL` | La [page publique dédiée](./affichage.md#page-publique-dédiée) s'affiche sans marque : ni logo dans la barre, ni nom en pied de page. Le formulaire lui même fonctionne. |
+| `FRAZA_NAME`, `FRAZA_LOGO_URL`, `FRAZA_SITE_URL` | La [page publique dédiée](./06-affichage.md#page-publique-dédiée) s'affiche sans marque : ni logo dans la barre, ni nom en pied de page. Le formulaire lui même fonctionne. |
 
 La première ligne mérite d'être répétée : c'est la panne la plus fréquente de ce module, et la moins lisible. Le routeur du core compare l'en-tête `Origin` de la requête à l'origine déclarée. Sans variable, il n'y a rien à comparer et la protection refuse tout.
 
@@ -56,7 +56,7 @@ La première, `Général`, porte le titre, le slug, la description et le statut.
 
 Le mode « redirection » remplace le message par une navigation vers l'URL donnée, exécutée par le navigateur après la réponse du serveur. Une adresse en `https://` ou `http://`, ou une page du site comme `/merci` ; toute autre est refusée à l'enregistrement.
 
-Voir [Soumissions](./soumissions.md) pour l'effet exact de chacun de ces réglages sur le pipeline.
+Voir [Soumissions](./05-soumissions.md) pour l'effet exact de chacun de ces réglages sur le pipeline.
 
 ## Statut d'un formulaire
 
@@ -85,7 +85,7 @@ Elles ne suffisent pas seules : les routes et les écrans d'admin exigent d'abor
 
 `forms.view` suffit à **lire le contenu des soumissions**, y compris les données personnelles qu'elles portent et les pièces jointes. Ce n'est pas une permission de simple consultation de structure, à garder en tête au moment de la distribuer.
 
-Le point de soumission public, lui, n'exige aucune permission. Voir [Soumissions](./soumissions.md).
+Le point de soumission public, lui, n'exige aucune permission. Voir [Soumissions](./05-soumissions.md).
 
 ## Entrées d'admin
 

package/dist/docs/06-modules/forms/{champs.md → 03-champs.md}

@@ -4,8 +4,8 @@ description: Catalogue des types de champs, options de configuration, largeurs,
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
-    - 06-modules/forms/affichage
+    - 06-modules/forms/05-soumissions
+    - 06-modules/forms/06-affichage
 ---
 
 Un formulaire est une liste ordonnée de champs, composée au glisser-déposer dans l'onglet Champs du constructeur. Les champs sont stockés en JSON avec le formulaire, il n'y a pas de table de champs.
@@ -101,7 +101,7 @@ Les champs fichier d'un formulaire totalisent 50 Mo au plus (`maxFiles × maxSiz
 
 `ALL` lève la restriction de famille, pas les contrôles de contenu du core : le SVG reste refusé quel que soit le réglage, la signature binaire doit correspondre à l'extension déclarée quand cette extension est connue, et le contenu est inspecté à la recherche de balises exécutables. La taille maximale du champ s'applique toujours.
 
-Le point de soumission compte les fichiers envoyés sous le nom du champ, `maxFiles` au plus, vérifie chacun, puis les téléverse tous une fois la soumission entière validée. Voir [Soumissions](./soumissions.md).
+Le point de soumission compte les fichiers envoyés sous le nom du champ, `maxFiles` au plus, vérifie chacun, puis les téléverse tous une fois la soumission entière validée. Voir [Soumissions](./05-soumissions.md).
 
 ### Longueur des textes
 
@@ -139,6 +139,6 @@ La même lecture (`readSubmission` de `fields.js`) tourne dans le navigateur ava
 
 ## Notes
 
-- Les champs sont stockés en JSON dans le formulaire, sans schéma en base. Leur définition est vérifiée à l'enregistrement du formulaire, voir [Modèle de données](./modele-de-donnees.md).
+- Les champs sont stockés en JSON dans le formulaire, sans schéma en base. Leur définition est vérifiée à l'enregistrement du formulaire, voir [Modèle de données](./07-modele-de-donnees.md).
 - Le type `checkbox` porte une propriété `consentText` créée à l'ajout du champ. Elle n'est ni modifiable dans le constructeur, ni rendue nulle part. Ne pas compter dessus.
 - L'ordre des champs dans le constructeur est l'ordre de rendu, l'ordre du tableau récapitulatif des courriels, et l'ordre de la fiche de soumission.

package/dist/docs/06-modules/forms/{admin.md → 04-admin.md}

@@ -4,13 +4,13 @@ description: Liste des formulaires, constructeur à deux onglets, boîte de réc
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/champs
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/03-champs
+    - 06-modules/forms/05-soumissions
 ---
 
 Le module ajoute une section `Formulaires` à la barre latérale de l'admin, avec deux entrées : les formulaires et leurs soumissions. Cette page décrit ce que fait l'interface, y compris les quelques comportements qui surprennent.
 
-L'accès à la section demande `forms.view`, en plus de `admin.access`. Sans elle, `/admin/forms` répond 404, comme une page inconnue. Créer, modifier, dupliquer et supprimer demandent `forms.manage`. Voir [Configuration](./configuration.md).
+L'accès à la section demande `forms.view`, en plus de `admin.access`. Sans elle, `/admin/forms` répond 404, comme une page inconnue. Créer, modifier, dupliquer et supprimer demandent `forms.manage`. Voir [Configuration](./02-configuration.md).
 
 ## Écrans
 
@@ -36,7 +36,7 @@ Sous 1024 px, la liste compacte montre le titre, la date de modification, le nom
 | Dupliquer | Copie titrée `<titre> (copie)`, slug ré-unicifié, statut `inactive`. Aucune soumission copiée. |
 | Supprimer | Après confirmation. Supprime **les soumissions du formulaire** et leurs fichiers, dans une transaction. |
 
-La confirmation de suppression nomme les soumissions et leurs pièces jointes. Elle est irréversible, et les pièces jointes sont retirées du stockage objet. Voir [Modèle de données](./modele-de-donnees.md).
+La confirmation de suppression nomme les soumissions et leurs pièces jointes. Elle est irréversible, et les pièces jointes sont retirées du stockage objet. Voir [Modèle de données](./07-modele-de-donnees.md).
 
 ## Constructeur
 
@@ -48,11 +48,11 @@ Un bouton `Voir` ouvre la page publique dans un nouvel onglet. Il n'apparaît qu
 
 Trois colonnes : la palette, le canevas, l'inspecteur.
 
-La **palette** liste les types de champs en quatre familles, `Basique`, `Choix`, `Avancé` et `Mise en page`. Cliquer sur un type l'ajoute à la fin, le glisser le dépose à la position visée. Voir [Champs](./champs.md) pour le catalogue.
+La **palette** liste les types de champs en quatre familles, `Basique`, `Choix`, `Avancé` et `Mise en page`. Cliquer sur un type l'ajoute à la fin, le glisser le dépose à la position visée. Voir [Champs](./03-champs.md) pour le catalogue.
 
 Le **canevas** affiche les champs à leur largeur réelle, donc côte à côte quand ils sont en demi ou en tiers. Chaque bloc porte son libellé, son type et son nom, et une poignée pour le déplacer. La croix de suppression n'apparaît qu'au survol.
 
-L'**inspecteur** n'apparaît que lorsqu'un champ est sélectionné, et un champ qui vient d'être ajouté l'est automatiquement. Il porte les réglages du type sélectionné, décrits dans [Champs](./champs.md) : pour un champ fichier, « Nombre de fichiers maximal » et « Taille maximale par fichier (Mo) », bornés ; pour un texte ou un paragraphe, « Longueur maximale (caractères) ».
+L'**inspecteur** n'apparaît que lorsqu'un champ est sélectionné, et un champ qui vient d'être ajouté l'est automatiquement. Il porte les réglages du type sélectionné, décrits dans [Champs](./03-champs.md) : pour un champ fichier, « Nombre de fichiers maximal » et « Taille maximale par fichier (Mo) », bornés ; pour un texte ou un paragraphe, « Longueur maximale (caractères) ».
 
 ### Onglet Réglages
 
@@ -94,12 +94,12 @@ La carte `Réponses` affiche les champs **dans l'ordre du formulaire**, avec le
 
 Les champs cachés **apparaissent** dans cette carte, contrairement aux courriels qui les excluent. Une case de consentement s'affiche en `Oui` ou `Non`, une liste de cases à cocher en valeurs séparées par des virgules.
 
-La carte `Fichiers` n'apparaît que s'il y en a. Chaque pièce jointe se télécharge par la route protégée du module, dans un nouvel onglet. Voir [API](./api.md).
+La carte `Fichiers` n'apparaît que s'il y en a. Chaque pièce jointe se télécharge par la route protégée du module, dans un nouvel onglet. Voir [API](./08-api.md).
 
-La carte `Détails techniques` expose le statut, le réseau de l'adresse IP (`/24` ou `/48`), ou `—` quand le formulaire n'en garde aucune, le navigateur et la page d'origine. Le navigateur et la page d'origine viennent des en-têtes de la requête et sont falsifiables. Voir [Soumissions](./soumissions.md).
+La carte `Détails techniques` expose le statut, le réseau de l'adresse IP (`/24` ou `/48`), ou `—` quand le formulaire n'en garde aucune, le navigateur et la page d'origine. Le navigateur et la page d'origine viennent des en-têtes de la requête et sont falsifiables. Voir [Soumissions](./05-soumissions.md).
 
 ## Notes
 
 - Aucun écran n'adapte ses boutons à la permission : un compte qui n'a que `forms.view` voit les actions d'écriture et se fait refuser par l'API au moment de les utiliser.
 - La duplication d'un formulaire ne demande pas de confirmation. Elle est sans risque, la copie étant créée inactive.
-- Le constructeur ne prévisualise pas le formulaire. Pour le voir tel que le visiteur le verra, ouvrir sa page publique avec le bouton `Voir`. Voir [Affichage](./affichage.md).
+- Le constructeur ne prévisualise pas le formulaire. Pour le voir tel que le visiteur le verra, ouvrir sa page publique avec le bouton `Voir`. Voir [Affichage](./06-affichage.md).

package/dist/docs/06-modules/forms/{soumissions.md → 05-soumissions.md}

@@ -4,8 +4,8 @@ description: Pipeline de soumission, vérification d'origine, anti-robots, pièc
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/modele-de-donnees
-    - 06-modules/forms/api
+    - 06-modules/forms/07-modele-de-donnees
+    - 06-modules/forms/08-api
 ---
 
 Une soumission traverse neuf étapes, dans cet ordre. Comprendre lesquelles rejettent et lesquelles laissent passer est la clé du diagnostic quand un formulaire ne fonctionne pas.
@@ -42,13 +42,13 @@ Trois conséquences directes :
 - Si aucune des deux variables n'est renseignée, **toute** soumission est refusée. C'est la panne la plus fréquente à l'installation.
 - Une soumission depuis la même origine passe automatiquement, sans jeton à gérer côté client.
 
-Voir [Configuration](./configuration.md).
+Voir [Configuration](./02-configuration.md).
 
 ## Format de la requête
 
 Le corps doit être un formulaire encodé. Les composants du module envoient du **`multipart/form-data`**, seul encodage capable de porter des fichiers. Le parseur accepte aussi `application/x-www-form-urlencoded` pour un formulaire sans pièce jointe. Un corps JSON est refusé dans tous les cas.
 
-Chaque champ de saisie est envoyé sous son `name`, plus deux champs techniques décrits ci-dessous. Les composants fournis par le module s'en chargent. Voir [Affichage](./affichage.md).
+Chaque champ de saisie est envoyé sous son `name`, plus deux champs techniques décrits ci-dessous. Les composants fournis par le module s'en chargent. Voir [Affichage](./06-affichage.md).
 
 ## Anti-robots
 
@@ -82,7 +82,7 @@ Seules les **métadonnées** sont enregistrées avec la soumission : nom du cham
 
 Ces fichiers sont **privés**. Aucune URL publique n'existe : ils ne sont accessibles que par la route de téléchargement de l'admin, protégée par `forms.view`.
 
-Supprimer une soumission retire ses fichiers du stockage, et supprimer un formulaire vide son dossier `forms/<id>/`, après la réponse, depuis la file `fraza_forms_storage_deletion`. Voir [Modèle de données](./modele-de-donnees.md). Une soumission refusée ne laisse aucun fichier : tous sont vérifiés avant le premier téléversement, et ceux déjà envoyés sont retirés si un envoi ou l'enregistrement échoue.
+Supprimer une soumission retire ses fichiers du stockage, et supprimer un formulaire vide son dossier `forms/<id>/`, après la réponse, depuis la file `fraza_forms_storage_deletion`. Voir [Modèle de données](./07-modele-de-donnees.md). Une soumission refusée ne laisse aucun fichier : tous sont vérifiés avant le premier téléversement, et ceux déjà envoyés sont retirés si un envoi ou l'enregistrement échoue.
 
 ## Ce qui est enregistré
 
@@ -97,7 +97,7 @@ L'adresse IP est lue par `getIpFromRequest` du core, comme la clé de limitation
 
 L'agent utilisateur et le référent sont pris tels quels dans les en-têtes, **sans la vérification `FRAZA_TRUST_PROXY`** : un appelant peut les falsifier, ils servent au diagnostic.
 
-Voir [Modèle de données](./modele-de-donnees.md).
+Voir [Modèle de données](./07-modele-de-donnees.md).
 
 ## Courriels
 
@@ -135,7 +135,7 @@ Le serveur bascule une soumission `new` en `read` quand il la sert à sa fiche,
 
 La liste `/admin/forms/submissions` filtre par statut et par formulaire, cinquante par page, du plus récent au plus ancien.
 
-Il n'existe **pas d'export**. Les soumissions se consultent une par une. Voir [Administration](./admin.md) pour le détail des écrans.
+Il n'existe **pas d'export**. Les soumissions se consultent une par une. Voir [Administration](./04-admin.md) pour le détail des écrans.
 
 ## Rétention
 

package/dist/docs/06-modules/forms/{affichage.md → 06-affichage.md}

@@ -4,7 +4,7 @@ description: Les trois façons de rendre un formulaire sur le site, leurs diffé
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 02-guides/blocs-personnalises
 ---
 
@@ -123,5 +123,5 @@ Son rendu suit le [thème du projet](../../02-guides/personnaliser-l-apparence.m
 
 ## Notes
 
-- Les trois voies passent par le même point de soumission et sont donc soumises aux mêmes contrôles d'origine et anti-robots. Voir [Soumissions](./soumissions.md).
-- Un projet qui veut d'autres champs que ceux de `FormRenderer` écrit son propre îlot client, sur le même contrat : jeton de `/token` dans `_t`, champ `_hp` vide, envoi en `multipart/form-data`, `details.fieldErrors` en retour. Voir [API](./api.md).
+- Les trois voies passent par le même point de soumission et sont donc soumises aux mêmes contrôles d'origine et anti-robots. Voir [Soumissions](./05-soumissions.md).
+- Un projet qui veut d'autres champs que ceux de `FormRenderer` écrit son propre îlot client, sur le même contrat : jeton de `/token` dans `_t`, champ `_hp` vide, envoi en `multipart/form-data`, `details.fieldErrors` en retour. Voir [API](./08-api.md).

package/dist/docs/06-modules/forms/{modele-de-donnees.md → 07-modele-de-donnees.md}

@@ -4,7 +4,7 @@ description: Tables fraza_forms_form, fraza_forms_submission et fraza_forms_stor
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 03-reference/01-cores/database
 ---
 
@@ -44,7 +44,7 @@ Un tableau d'objets, dans l'ordre de rendu. Chaque champ porte au minimum `id`,
 
 Il n'existe aucun schéma de base sur ce JSON : la définition est vérifiée par le module à l'enregistrement du formulaire, qui refuse avec un message en français un nom invalide ou en double, un champ à options sans option ou avec une valeur vide ou répétée, des champs fichier au-delà de 50 Mo au total, plus de 100 champs. À la lecture, chaque champ est normalisé : nombres ramenés dans leurs bornes (`maxLength`, `maxFiles`, `maxSizeMb`), options en chaînes, identifiants remplis.
 
-Voir [Champs](./champs.md) pour la structure complète par type.
+Voir [Champs](./03-champs.md) pour la structure complète par type.
 
 ### Structure de `settings`
 
@@ -133,6 +133,6 @@ Les fichiers laissés par des soumissions supprimées avant cette version, dans
 ## Notes
 
 - `dropTables` supprime les trois tables et la fonction du déclencheur, dans l'ordre qui respecte la clé étrangère. Il ne supprime toujours aucun fichier du stockage objet.
-- Une soumission est supprimée après `retentionDays` jours par la tâche `forms-retention`, voir [Soumissions](./soumissions.md#rétention). Sans réglage, elle est gardée sans limite.
+- Une soumission est supprimée après `retentionDays` jours par la tâche `forms-retention`, voir [Soumissions](./05-soumissions.md#rétention). Sans réglage, elle est gardée sans limite.
 - Migrations, appliquées par `npx fraza-db migrate` : `001-truncate-stored-ips` réduit les adresses déjà enregistrées, par lots de 1000, sans effet si on la relance. `002-queue-storage-deletions` crée la file et le déclencheur, aussi posés par `createTables()` sur une base neuve, et met en file le dossier de chaque formulaire supprimé avant elle (les trous de la séquence des identifiants).
 - Le commentaire d'en-tête du module mentionne une clé `sourceUrl` dans `meta`. Elle n'est jamais écrite, le tableau de cette page fait foi.

package/dist/docs/06-modules/forms/{api.md → 08-api.md}

@@ -4,7 +4,7 @@ description: Routes HTTP d'admin et publiques, et fonctions serveur importables
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/soumissions
+    - 06-modules/forms/05-soumissions
     - 03-reference/01-cores/api
 ---
 
@@ -25,7 +25,7 @@ Le module expose ses formulaires de trois façons : des routes HTTP d'admin, tro
 import { getPublicFormById } from '@fraza/module-forms/server';
 ```
 
-`@fraza/module-forms/server` est délibérément séparé de `/public` : il ne contient aucun composant, et reste donc importable depuis un Server Component sans tirer de code client. C'est ce qu'utilise un bloc du BlockEditor écrit dans le projet. Voir [Affichage](./affichage.md).
+`@fraza/module-forms/server` est délibérément séparé de `/public` : il ne contient aucun composant, et reste donc importable depuis un Server Component sans tirer de code client. C'est ce qu'utilise un bloc du BlockEditor écrit dans le projet. Voir [Affichage](./06-affichage.md).
 
 ## API
 
@@ -101,7 +101,7 @@ L'ordre de déclaration compte : les chemins de soumissions sont déclarés **av
 
 `GET /forms/public/:slug/token` renvoie `{ token }`, le jeton du délai minimal, `null` sans `FRAZA_ENCRYPTION_KEY`. Elle répond `404` si le formulaire est absent ou inactif. `FormRenderer` l'appelle à son montage.
 
-`POST /forms/public/:slug/submit` est le point de soumission, compté par le préréglage `public_form`. Il exige un corps en `multipart/form-data`, refuse le JSON, et attend en plus des champs du formulaire les deux champs techniques `_hp` et `_t`, le jeton de la route précédente. Voir [Soumissions](./soumissions.md).
+`POST /forms/public/:slug/submit` est le point de soumission, compté par le préréglage `public_form`. Il exige un corps en `multipart/form-data`, refuse le JSON, et attend en plus des champs du formulaire les deux champs techniques `_hp` et `_t`, le jeton de la route précédente. Voir [Soumissions](./05-soumissions.md).
 
 Chaque formulaire a son plafond de corps : ses champs fichier à leur taille maximale, plus 1 Mio pour le texte. La route, elle, est plafonnée à 51 Mio, le plus grand formulaire possible. Au-delà du plafond du formulaire, la réponse est un 413 « L'envoi dépasse la taille acceptée par ce formulaire (N Mo). ».
 
@@ -109,7 +109,7 @@ Une réponse d'erreur est l'erreur d'API du core, `{ error, code, message, detai
 
 ### Aucune de ces routes n'est ouverte à un autre domaine
 
-Les routes publiques n'exigent ni session ni permission, mais le routeur du core applique une **vérification d'origine** sur toute requête modifiante. La soumission depuis un domaine tiers est donc refusée par construction, et sans `NEXT_PUBLIC_URL` renseignée, toute soumission l'est. Voir [Configuration](./configuration.md).
+Les routes publiques n'exigent ni session ni permission, mais le routeur du core applique une **vérification d'origine** sur toute requête modifiante. La soumission depuis un domaine tiers est donc refusée par construction, et sans `NEXT_PUBLIC_URL` renseignée, toute soumission l'est. Voir [Configuration](./02-configuration.md).
 
 ## Notes
 

package/dist/docs/06-modules/forms/index.md

@@ -4,28 +4,40 @@ description: Constructeur de formulaires, collecte des soumissions, notification
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/forms/installation
-    - 06-modules/forms/champs
+    - 06-modules/forms/01-installation
+    - 06-modules/forms/03-champs
 ---
 
 `@fraza/module-forms` ajoute un constructeur de formulaires à l'admin, une boîte de réception pour les soumissions, et un point de soumission public. Un formulaire se compose au glisser-déposer, sans code.
 
+```bash
+npm i @fraza/module-forms
+```
+
+| Paquet | `@fraza/module-forms` |
+|---|---|
+| Licence | MIT, Fraza Libre. |
+| Registre | npmjs, sans compte ni configuration. |
+| Activation | `FRAZA_MODULE_FORMS=true` |
+
+L'activation, la création des tables et les services dont dépendent les soumissions sont dans [Installation](./01-installation.md).
+
 ![Le constructeur de formulaire, sa palette de champs à gauche et le formulaire en cours à droite](../../assets/modules/forms/constructeur.light.webp)
 
-La palette range les types de champs par famille, et chaque champ posé porte sa largeur : pleine, demie ou tiers de ligne en écran large. L'URL publique s'affiche sous le titre, le formulaire y est servi dès qu'il est enregistré. Voir [Champs](./champs.md) pour le catalogue complet.
+La palette range les types de champs par famille, et chaque champ posé porte sa largeur : pleine, demie ou tiers de ligne en écran large. L'URL publique s'affiche sous le titre, le formulaire y est servi dès qu'il est enregistré. Voir [Champs](./03-champs.md) pour le catalogue complet.
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer les tables, vérifier les dépendances. |
-| [Configuration](./configuration.md) | Variables d'environnement, permissions, entrées d'admin. |
-| [Champs](./champs.md) | Catalogue des types de champs et validation appliquée. |
-| [Administration](./admin.md) | Constructeur, liste des formulaires et boîte de réception. |
-| [Soumissions](./soumissions.md) | Pipeline de soumission, anti-spam, fichiers, courriels, rétention. |
-| [Affichage](./affichage.md) | Les trois façons de rendre un formulaire sur le site. |
-| [Modèle de données](./modele-de-donnees.md) | Tables `fraza_forms_form`, `fraza_forms_submission` et `fraza_forms_storage_deletion`. |
-| [API](./api.md) | Routes HTTP et fonctions serveur importables. |
+| [Installation](./01-installation.md) | Installer le module, créer les tables, vérifier les dépendances. |
+| [Configuration](./02-configuration.md) | Variables d'environnement, permissions, entrées d'admin. |
+| [Champs](./03-champs.md) | Catalogue des types de champs et validation appliquée. |
+| [Administration](./04-admin.md) | Constructeur, liste des formulaires et boîte de réception. |
+| [Soumissions](./05-soumissions.md) | Pipeline de soumission, anti-spam, fichiers, courriels, rétention. |
+| [Affichage](./06-affichage.md) | Les trois façons de rendre un formulaire sur le site. |
+| [Modèle de données](./07-modele-de-donnees.md) | Tables `fraza_forms_form`, `fraza_forms_submission` et `fraza_forms_storage_deletion`. |
+| [API](./08-api.md) | Routes HTTP et fonctions serveur importables. |
 
 ## Ce que le module apporte
 
@@ -50,11 +62,11 @@ Le module n'a aucune dépendance de code au-delà du core, mais deux de ses fonc
 | Courriels de notification et de confirmation | La configuration courriel du core, Resend ou SMTP. |
 | Champs de type fichier | Le stockage objet du core. |
 
-La première est la cause de panne la plus fréquente, et la moins visible : le formulaire s'affiche correctement et échoue à l'envoi. Voir [Configuration](./configuration.md).
+La première est la cause de panne la plus fréquente, et la moins visible : le formulaire s'affiche correctement et échoue à l'envoi. Voir [Configuration](./02-configuration.md).
 
 ## Ce que le module ne fait pas
 
-- **Il n'enregistre pas de bloc BlockEditor**, et `@fraza/start` n'en livre pas non plus. Un projet écrit le sien en quelques lignes, ou passe par une autre voie d'affichage. Voir [Affichage](./affichage.md).
+- **Il n'enregistre pas de bloc BlockEditor**, et `@fraza/start` n'en livre pas non plus. Un projet écrit le sien en quelques lignes, ou passe par une autre voie d'affichage. Voir [Affichage](./06-affichage.md).
 - Il ne propose ni logique conditionnelle entre champs, ni étapes multiples, ni calculs.
 - Il n'exporte pas les soumissions. Elles se consultent une par une dans l'admin.
 
@@ -62,4 +74,4 @@ La première est la cause de panne la plus fréquente, et la moins visible : le
 
 - Le champ `version` du manifeste suit la version du paquet : [`fraza-module sync-version`](../../03-reference/05-cli/fraza-module.md#sync-version), lancé par chaque build, la recopie dans `src/version.js`, et `prepublishOnly` refuse de publier si les deux divergent.
 - Supprimer un formulaire supprime ses soumissions et leurs fichiers, dans une transaction, c'est explicite et irréversible.
-- Chaque valeur est vérifiée selon le type de son champ, dans le navigateur puis sur le serveur. Voir [Champs](./champs.md).
+- Chaque valeur est vérifiée selon le type de son champ, dans le navigateur puis sur le serveur. Voir [Champs](./03-champs.md).

package/dist/docs/06-modules/index.md

@@ -60,9 +60,9 @@ Ils sont indépendants et cohabitent sans conflit. Une page nommée `blogue` et
 
 ## Version documentée
 
-Chaque module suit son propre cycle de publication, indépendant de celui du core. La page d'accueil d'un module indique donc la version qu'elle documente.
+Cette section décrit la dernière version publiée de chaque module. Tous les paquets Fraza à leur dernière version fonctionnent ensemble, et `npx fraza-update` les installe ensemble : un projet à jour lit donc la documentation de ses modules.
 
-Si la version installée est plus récente, ses notes de version sont livrées avec elle, dans `node_modules/<module>/CHANGELOG.md`. Elles sont donc consultables hors ligne, sans accès au dépôt. `npx fraza-update` les affiche automatiquement après une mise à jour.
+Ce qui a changé d'une version à l'autre est dans les notes de version, livrées avec chaque module dans `node_modules/<module>/CHANGELOG.md`, et consultables hors ligne. `npx fraza-update` les affiche automatiquement après une mise à jour.
 
 ## Ce qui reste dans le dépôt du module
 

package/dist/docs/06-modules/medias/{installation.md → 01-installation.md}

@@ -4,18 +4,17 @@ description: Installer @fraza/module-medias, configurer le stockage objet, crée
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/medias/configuration
-    - 06-modules/medias/integration
+    - 06-modules/medias/02-configuration
+    - 06-modules/medias/05-integration
 ---
 
-Cette page couvre l'installation de `@fraza/module-medias` dans un projet déjà structuré par `@fraza/start`. Le module n'est jamais déclaré à la main : il est découvert au boot par scan des dépendances, comme décrit dans [Cycle de vie d'un module](../../02-guides/cycle-de-vie-d-un-module.md).
-
-C'est le seul module officiel qui demande une étape de câblage manuelle dans le projet, parce qu'il sert du binaire.
+Cette page installe `@fraza/module-medias` dans un projet créé par `npx @fraza/start`. Le module n'est jamais déclaré à la main : il est découvert au boot par scan des dépendances, comme décrit dans [Cycle de vie d'un module](../../02-guides/cycle-de-vie-d-un-module.md).
 
 ## Prérequis
 
-- Un projet généré par `npx @fraza/start`, avec `@fraza/core` installé.
-- Un **stockage objet compatible S3** configuré. Sans lui, le module démarre mais aucun téléversement n'aboutit. Voir [Configuration](./configuration.md).
+- Un projet créé par `npx @fraza/start`, avec `@fraza/core` à jour.
+- Un **stockage objet compatible S3** configuré. Sans lui, le module démarre mais aucun téléversement n'aboutit. Voir [Configuration](./02-configuration.md).
+- Aucun compte : le paquet est publié sur npmjs.
 
 ## Installer
 
@@ -23,35 +22,35 @@ C'est le seul module officiel qui demande une étape de câblage manuelle dans l
 npm i @fraza/module-medias
 ```
 
-`sharp` est une **peer dependency facultative** (`>=0.35.0`) : le core la charge au premier traitement d'image, et Next.js en installe déjà une copie. La déclarer en peer garantit qu'il n'y en a qu'une seule dans le projet, dans une version que le site contrôle. Sans `sharp`, le module démarre, mais refuse les images JPEG, PNG et WebP tant que l'optimisation retire leurs métadonnées, ce qu'elle fait par défaut. Sur un projet dont le verrou est ancien, `npm update sharp` suffit à remonter au seuil de `0.35.0`.
-
-Le module n'a plus aucune dépendance de production : `archiver` a été retiré, l'archive ZIP est écrite par le core.
-
-Ce choix est un exemple de la règle décrite dans [Créer un module](../../02-guides/creer-un-module.md) : tout ce que le site fournit déjà va en `peerDependencies`.
-
 Ajouter la variable d'activation à `.env.local`, et aux variables de la plateforme en production :
 
-```bash
+```dotenv
 #------ MODULE - MEDIAS ------#
 FRAZA_MODULE_MEDIAS=true
 ```
 
 Sans ce drapeau, le module est ignoré : aucune table, aucune route, aucune entrée d'admin, et le registre média du core reste vide.
 
-Puis régénérer les manifestes et créer les tables :
+Régénérer les manifestes, puis créer les tables :
 
 ```bash
 npx fraza-modules sync    # déclenché automatiquement au postinstall
 npx fraza-db init         # crée fraza_media et fraza_media_references
 ```
 
-`fraza-db init` est idempotent. Sur une base qui possède déjà les tables, il applique les migrations en attente sans toucher aux données. Voir [Modèle de données](./modele-de-donnees.md).
+`fraza-db init` est idempotent : sur une base qui a déjà les tables, il applique les migrations en attente sans toucher aux données. Il enregistre aussi les quatre permissions du module, et les attribue au rôle `admin`. Voir [Modèle de données](./06-modele-de-donnees.md).
 
-## Monter la route de fichier
+## Installer `sharp`
 
-**C'est l'étape à ne pas oublier.** Sans elle, les médias sont téléversables mais aucune URL publique ne répond.
+`sharp` est une **peer dependency facultative** (`>=0.35.0`) : le core la charge au premier traitement d'image, et Next.js en installe déjà une copie. La déclarer en peer garantit qu'il n'y en a qu'une seule dans le projet, dans une version que le site contrôle.
 
-Créer le fichier suivant dans le projet :
+Sans `sharp`, le module démarre, mais refuse les images JPEG, PNG et WebP tant que l'optimisation retire leurs métadonnées, ce qu'elle fait par défaut. Sur un projet dont le verrou est ancien, `npm update sharp` suffit à remonter au seuil de `0.35.0`.
+
+Ce choix suit la règle décrite dans [Créer un module](../../02-guides/creer-un-module.md) : tout ce que le site fournit déjà va en `peerDependencies`. Le module n'a aucune dépendance de production : l'archive ZIP est écrite par le core.
+
+## Monter la route de fichier
+
+**C'est l'étape à ne pas oublier sur un projet monté à la main.** Sans elle, les médias sont téléversables mais aucune URL publique ne répond. Le start template officiel fournit déjà ce fichier.
 
 ```js
 // app/za/media/[filename]/route.js
@@ -62,7 +61,17 @@ L'import passe par le **core**, pas par le module. Le core y expose un relais qu
 
 Cette route doit rester un Route Handler et non une page : elle diffuse du binaire avec ses en-têtes de type, de cache et de disposition, ce qu'une page ne sait pas faire.
 
-Le start template officiel fournit déjà ce fichier.
+C'est le seul module officiel qui demande un fichier de route dans le projet, parce qu'il sert du binaire.
+
+## Effet sur les autres modules
+
+L'installation suffit à activer, dans tout le projet :
+
+- le sélecteur d'image du BlockEditor, sur les blocs image et sur les champs `ImageField` des blocs personnalisés ;
+- les champs de type `image`, `thumbnail` et `gallery` de `@fraza/module-posts`, quel que soit le nom que le projet leur donne dans sa variable de type ;
+- le choix de l'image de partage Open Graph quand `FRAZA_SEO` est actif.
+
+Aucun de ces modules ne déclare `@fraza/module-medias` en dépendance. Voir [Intégration](./05-integration.md).
 
 ## Vérifier
 
@@ -73,19 +82,7 @@ Le start template officiel fournit déjà ce fichier.
 2. `Médias` apparaît dans la barre latérale de l'admin.
 3. Téléverser une image depuis `/admin/media`, puis ouvrir l'URL publique proposée par la fiche du média.
 
-Si le téléversement échoue, la cause est presque toujours la configuration du stockage objet, pas le module. Voir [Configuration](./configuration.md).
-
-Les permissions du module sont enregistrées et attribuées au rôle `admin` pendant `fraza-db init`. Un module ajouté après coup n'a donc besoin que d'un `npx fraza-db init` pour que les quatre permissions apparaissent dans `/admin/roles`.
-
-## Effet sur les autres modules
-
-L'installation suffit à activer, dans tout le projet :
-
-- le sélecteur d'image du BlockEditor, sur les blocs image et sur les champs `ImageField` des blocs personnalisés ;
-- les champs de type `image`, `thumbnail` et `gallery` de `@fraza/module-posts`, quel que soit le nom que le projet leur donne dans sa variable de type ;
-- le choix de l'image de partage Open Graph quand `FRAZA_SEO` est actif.
-
-Aucun de ces modules ne déclare `@fraza/module-medias` en dépendance. Voir [Intégration](./integration.md).
+Si le téléversement échoue, la cause est presque toujours la configuration du stockage objet, pas le module. Voir [Configuration](./02-configuration.md).
 
 ## Mettre à jour
 
@@ -93,12 +90,12 @@ Aucun de ces modules ne déclare `@fraza/module-medias` en dépendance. Voir [In
 npx fraza-update
 ```
 
-La commande installe la dernière version de tous les paquets Fraza du site, toutes à la fois : tous les paquets Fraza à leur dernière version fonctionnent ensemble. Mettre à jour `@fraza/module-medias` seul, par `npm i`, laisserait le core et les autres modules en arrière.
+La commande installe la dernière version de tous les paquets Fraza du site, toutes à la fois, puis enchaîne `fraza-modules sync`, `fraza-db migrate` et `fraza-doctor`. Tous les paquets Fraza à leur dernière version fonctionnent ensemble : mettre à jour `@fraza/module-medias` seul, par `npm i`, laisserait le core et les autres modules en arrière.
 
-Les notes de version sont livrées avec le package, dans `node_modules/@fraza/module-medias/CHANGELOG.md`.
+Les notes de version sont livrées avec le paquet, dans `node_modules/@fraza/module-medias/CHANGELOG.md`.
 
 ## Notes
 
 - Le module dépend de `@fraza/core` en `peerDependency`. Il n'embarque pas sa propre copie du core.
 - Désinstaller le module ne supprime ni les tables, ni les fichiers du stockage objet. `dropTables` est exporté depuis `@fraza/module-medias` pour la partie base.
-- Désactiver le module sans le désinstaller laisse les contenus référencer des médias devenus irrésolubles, et les références ne sont plus tenues à jour. Voir [Désactivé avec ses tables](./integration.md#désactivé-avec-ses-tables).
+- Désactiver le module sans le désinstaller laisse les contenus référencer des médias devenus irrésolubles, et les références ne sont plus tenues à jour. Voir [Désactivé avec ses tables](./05-integration.md#désactivé-avec-ses-tables).

package/dist/docs/06-modules/medias/{configuration.md → 02-configuration.md}

@@ -4,7 +4,7 @@ description: Variables d'environnement, stockage objet, optimisation des images,
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/medias/televersement
+    - 06-modules/medias/03-televersement
     - 03-reference/01-cores/storage
 ---
 
@@ -24,7 +24,7 @@ Les trois dernières sont sans effet si `FRAZA_MODULE_MEDIAS_OPTIMIZE` vaut `fal
 
 L'activation se compare strictement à la chaîne `true`. Les drapeaux d'optimisation fonctionnent en sens inverse : ils sont actifs sauf si la valeur vaut exactement `false`. Une valeur mal orthographiée laisse donc l'optimisation active.
 
-Voir [Téléversement](./televersement.md) pour l'effet précis de ces réglages sur un fichier.
+Voir [Téléversement](./03-televersement.md) pour l'effet précis de ces réglages sur un fichier.
 
 ## Stockage objet
 
@@ -78,11 +78,11 @@ Le module enregistre une section `Médias` et un item `Médias` à l'intérieur.
 
 L'ordre 25 de la section place la médiathèque avant les modules de contenu, qui commencent à 60. Voir [Étendre l'admin](../../02-guides/etendre-l-admin.md).
 
-Ce que l'écran permet de faire est décrit dans [Administration](./admin.md).
+Ce que l'écran permet de faire est décrit dans [Administration](./04-admin.md).
 
 ## Notes
 
 - Aucune variable du module ne contient de secret. Les secrets du stockage sont ceux du core, lisibles côté serveur uniquement.
 - La configuration d'optimisation est relue à chaque téléversement, pas mise en cache au boot. La changer ne demande pas de redémarrage, mais ne réoptimise évidemment pas les fichiers déjà en place.
-- Changer `FRAZA_MODULE_MEDIAS` à `false` désactive le module mais laisse les tables et les fichiers en place, sans plus tenir les références à jour. Voir [Intégration](./integration.md#désactivé-avec-ses-tables).
-- `sharp` est requis pour optimiser une image. Voir [Installation](./installation.md#installer).
+- Changer `FRAZA_MODULE_MEDIAS` à `false` désactive le module mais laisse les tables et les fichiers en place, sans plus tenir les références à jour. Voir [Intégration](./05-integration.md#désactivé-avec-ses-tables).
+- `sharp` est requis pour optimiser une image. Voir [Installation](./01-installation.md#installer).

package/dist/docs/06-modules/medias/{televersement.md → 03-televersement.md}

@@ -4,7 +4,7 @@ description: Formats acceptés, limites de taille, validation de contenu, optimi
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/medias/integration
+    - 06-modules/medias/05-integration
     - 03-reference/01-cores/storage
 ---
 
@@ -61,7 +61,7 @@ Chaque média porte deux identifiants de fichier, qui ne servent pas à la même
 
 La clé de stockage est fixée à la création et n'est jamais réécrite, pas même lors d'un remplacement de fichier. Le nom public, lui, se change librement.
 
-C'est cette séparation qui permet de renommer un média sans casser quoi que ce soit : les contenus référencent l'**identifiant** du média, jamais son nom ni son URL. Voir [Intégration](./integration.md).
+C'est cette séparation qui permet de renommer un média sans casser quoi que ce soit : les contenus référencent l'**identifiant** du média, jamais son nom ni son URL. Voir [Intégration](./05-integration.md).
 
 ### Assainissement du nom public
 
@@ -96,7 +96,7 @@ Une revalidation dont l'`ETag` correspond reçoit un 304 sans corps, sans lectur
 
 Un fichier non image est donc **téléchargé** plutôt qu'affiché, y compris un PDF. C'est une mesure de défense : un document affiché dans le contexte du site pourrait exécuter du script sur son origine.
 
-La route n'exige ni session ni permission. Voir [Configuration](./configuration.md).
+La route n'exige ni session ni permission. Voir [Configuration](./02-configuration.md).
 
 ## Remplacer un fichier
 
@@ -112,4 +112,4 @@ Comme l'URL publique ne change pas, un navigateur ou un CDN peut continuer à se
 - L'auteur d'un média est facultatif. Un dépôt machine, par une tâche planifiée ou un import, laisse le champ nul et la médiathèque n'affiche alors aucun auteur. Seul un identifiant d'utilisateur réel est accepté par ailleurs, la colonne portant une clé étrangère vers la table des utilisateurs.
 - La médiathèque permet de télécharger jusqu'à cent médias d'un coup, dans une archive sans recompression, écrite par `createZipStream` du core, un objet à la fois. Un objet absent du stockage est sauté. Un stockage qui ne répond pas interrompt le téléchargement. L'archive porte la date du jour dans le fuseau du site.
 - La taille enregistrée est celle des octets stockés, après optimisation. Le paramètre `size` d'`uploadMedia` et de `replaceMedia` est ignoré.
-- Un média encore référencé par un contenu ne peut pas être supprimé. Le détacher d'abord. Voir [Intégration](./integration.md).
+- Un média encore référencé par un contenu ne peut pas être supprimé. Le détacher d'abord. Voir [Intégration](./05-integration.md).

package/dist/docs/06-modules/medias/{admin.md → 04-admin.md}

@@ -4,15 +4,15 @@ description: Médiathèque, filtres, téléversement, sélection multiple, actio
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/medias/televersement
-    - 06-modules/medias/integration
+    - 06-modules/medias/03-televersement
+    - 06-modules/medias/05-integration
 ---
 
 Le module ajoute un seul écran à l'admin, `/admin/media`. Tout s'y fait : téléverser,
 chercher, renommer, remplacer, supprimer, récupérer les URL publiques. Cette page décrit
 ce que fait l'interface, y compris les quelques comportements qui surprennent.
 
-L'accès demande `media.view` : sans elle, `/admin/media` répond 404, comme une page inconnue. Voir [Configuration](./configuration.md).
+L'accès demande `media.view` : sans elle, `/admin/media` répond 404, comme une page inconnue. Voir [Configuration](./02-configuration.md).
 
 ## Ce que chaque permission débloque
 
@@ -58,7 +58,7 @@ Le bouton accepte plusieurs fichiers d'un coup, mais les envoie **un par un**. U
 refusé, pour un format ou une taille hors limites, produit son propre message et
 n'interrompt pas les suivants. Le sélecteur de fichier ne propose que les extensions
 acceptées, et celui du remplacement que celles de la catégorie du média. Voir
-[Téléversement](./televersement.md) pour ce qui est accepté.
+[Téléversement](./03-televersement.md) pour ce qui est accepté.
 
 À la fin du lot, la vue revient en première page, là où les nouveaux médias apparaissent.
 La confirmation compte les fichiers qui ont abouti.
@@ -94,7 +94,7 @@ propose de découper la sélection : la réduire est manuel.
 suppressions réussies disparaissent de la grille ; celles qui échouent restent
 sélectionnées, ce qui permet de recommencer sans tout re-pointer. Un média encore
 référencé par un contenu compte parmi les échecs. Voir
-[Intégration](./integration.md).
+[Intégration](./05-integration.md).
 
 ## Fiche d'un média
 
@@ -114,7 +114,7 @@ Renommer vers un nom déjà pris fait échouer l'enregistrement complet : le tex
 alternatif et la légende saisis en même temps ne sont pas écrits non plus. Corriger le
 nom, puis enregistrer à nouveau. Le message « Ce nom de fichier est déjà utilisé »
 apparaît en notification plutôt que sous le champ, pour la raison expliquée dans
-[API](./api.md).
+[API](./07-api.md).
 
 Un fichier qui n'est pas une image n'a pas d'aperçu. Un lien `Ouvrir le fichier` le sert
 à la place, ce qui déclenche un téléchargement pour tout ce qui n'est pas une image.
@@ -144,4 +144,4 @@ contenu d'abord.
   réglables.
 - L'interface ne montre pas qui a téléversé un média, ni la liste des contenus qui le
   référencent. Ces deux informations existent en base et sont lisibles par
-  [l'API](./api.md).
+  [l'API](./07-api.md).