@fraza/core 0.3.8 → 0.3.10

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

@@ -4,7 +4,7 @@ description: Tables fraza_media et fraza_media_references, migrations, cycle de
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/medias/integration
+    - 06-modules/medias/05-integration
     - 03-reference/01-cores/database
 ---
 
@@ -36,13 +36,13 @@ La suppression d'un compte utilisateur vide `uploaded_by` mais ne touche pas au
 
 ### Pourquoi deux noms
 
-`filename` et `storage_key` sont indépendants. Renommer un média réécrit le premier et laisse le second intact, ce qui n'invalide aucune référence puisque les contenus référencent `id`. Voir [Téléversement](./televersement.md).
+`filename` et `storage_key` sont indépendants. Renommer un média réécrit le premier et laisse le second intact, ce qui n'invalide aucune référence puisque les contenus référencent `id`. Voir [Téléversement](./03-televersement.md).
 
 ### `alt_text` et `caption` sont la source de vérité
 
 Ces deux colonnes ne sont pas des valeurs par défaut : ce sont les valeurs. Les blocs image du BlockEditor ne conservent pas de copie locale, ils relisent la fiche du média à chaque rendu.
 
-Corriger un texte alternatif dans la médiathèque le corrige donc partout où l'image est utilisée, sans toucher aux contenus. C'est la contrepartie de la normalisation stricte décrite dans [Intégration](./integration.md).
+Corriger un texte alternatif dans la médiathèque le corrige donc partout où l'image est utilisée, sans toucher aux contenus. C'est la contrepartie de la normalisation stricte décrite dans [Intégration](./05-integration.md).
 
 ## `fraza_media_references`
 
@@ -85,7 +85,7 @@ Les migrations sont numérotées dans `src/migrations.js` et appliquées une foi
 
 | Migration | Effet |
 |---|---|
-| `001-drop-media-visibility` | Retire la colonne `visibility` et son index, ancien correctif rejoué à chaque `init`. **Tous les médias sont publics**, et la route de fichier ne vérifie ni session ni permission. Voir [Configuration](./configuration.md). |
+| `001-drop-media-visibility` | Retire la colonne `visibility` et son index, ancien correctif rejoué à chaque `init`. **Tous les médias sont publics**, et la route de fichier ne vérifie ni session ni permission. Voir [Configuration](./02-configuration.md). |
 | `002-office-mime-types` | Donne leur type MIME aux `.doc`, `.docx`, `.xls`, `.xlsx`, `.ppt` et `.pptx` enregistrés en `application/octet-stream`, d'après l'extension de leur clé de stockage. |
 
 ## Cycle de vie d'un fichier

package/dist/docs/06-modules/medias/{api.md → 07-api.md}

@@ -4,7 +4,7 @@ description: Routes HTTP d'admin de la médiathèque, route publique de service
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/medias/integration
+    - 06-modules/medias/05-integration
     - 03-reference/03-registres/media-registry
 ---
 
@@ -28,7 +28,7 @@ import { getMediaById, buildMediaUrl, attachMedia } from '@fraza/core/media-regi
 
 ## API
 
-Les fonctions utilisables depuis du code sont documentées dans [Registre média](../../03-reference/03-registres/media-registry.md), et leur usage dans [Intégration](./integration.md).
+Les fonctions utilisables depuis du code sont documentées dans [Registre média](../../03-reference/03-registres/media-registry.md), et leur usage dans [Intégration](./05-integration.md).
 
 | Façade | Rôle |
 |---|---|
@@ -65,11 +65,11 @@ Un refus répond l'erreur d'API du core, `{ error, code, message }`, voir [API](
 
 `kind=other` garde les types MIME que la table des types ne connaît pas.
 
-`POST /media` attend un champ `file`, plus éventuellement `altText` et `caption`. Voir [Téléversement](./televersement.md) pour les formats et les limites. Le corps de `POST /media` et de `POST /media/:id/replace` est plafonné à 101 Mio, la limite d'une vidéo plus 1 Mio d'enveloppe : au-delà, le routeur du core répond 413 sans lire le corps.
+`POST /media` attend un champ `file`, plus éventuellement `altText` et `caption`. Voir [Téléversement](./03-televersement.md) pour les formats et les limites. Le corps de `POST /media` et de `POST /media/:id/replace` est plafonné à 101 Mio, la limite d'une vidéo plus 1 Mio d'enveloppe : au-delà, le routeur du core répond 413 sans lire le corps.
 
 `POST /media/bulk-download` attend `{ ids }`, **cent au plus**, et renvoie une archive assemblée à la volée, sans recompression. Les objets absents du stockage sont sautés sans faire échouer l'archive.
 
-`DELETE /media/:id` échoue en `409`, code `in_use`, si le média est encore référencé, avec le nombre de contenus concernés dans le message. Détacher d'abord. Voir [Intégration](./integration.md). Le refus vaut aussi pour une référence écrite pendant la suppression par une transaction encore ouverte : la clé étrangère le garantit, et la réponse est la même.
+`DELETE /media/:id` échoue en `409`, code `in_use`, si le média est encore référencé, avec le nombre de contenus concernés dans le message. Détacher d'abord. Voir [Intégration](./05-integration.md). Le refus vaut aussi pour une référence écrite pendant la suppression par une transaction encore ouverte : la clé étrangère le garantit, et la réponse est la même.
 
 ### Publique
 
@@ -77,11 +77,11 @@ Un refus répond l'erreur d'API du core, `{ error, code, message }`, voir [API](
 |---|---|---|
 | `GET` | `/za/media/:filename` | aucune |
 
-Ce n'est **pas** une route du routeur d'API : c'est un Route Handler Next.js monté par le projet, hors du préfixe `/za/api`. Voir [Installation](./installation.md).
+Ce n'est **pas** une route du routeur d'API : c'est un Route Handler Next.js monté par le projet, hors du préfixe `/za/api`. Voir [Installation](./01-installation.md).
 
 Elle retrouve la fiche par son nom public, lit l'objet au stockage et diffuse le flux. Elle répond `404` « Fichier introuvable. » si le nom est inconnu ou si le stockage répond 404, `400` « Nom de fichier invalide. » si le nom est illisible, `500` si le stockage ne répond pas, avec le message générique du core. Ces trois réponses sont du texte brut. Ces réponses portent `Cache-Control: no-store` : aucun cache ne les garde. Sans le module, le relais du core répond le même 404, `no-store` compris.
 
-Les en-têtes appliqués sont détaillés dans [Téléversement](./televersement.md). Le point à retenir : seuls JPEG, PNG, GIF et WebP sont servis en affichage direct, tout le reste est forcé en téléchargement.
+Les en-têtes appliqués sont détaillés dans [Téléversement](./03-televersement.md). Le point à retenir : seuls JPEG, PNG, GIF et WebP sont servis en affichage direct, tout le reste est forcé en téléchargement.
 
 ## Notes
 

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

@@ -4,28 +4,40 @@ description: Médiathèque partagée, téléversement vers un stockage objet, op
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/medias/installation
-    - 06-modules/medias/admin
-    - 06-modules/medias/integration
+    - 06-modules/medias/01-installation
+    - 06-modules/medias/04-admin
+    - 06-modules/medias/05-integration
 ---
 
 `@fraza/module-medias` ajoute une médiathèque à l'admin et remplit le [registre média](../../03-reference/03-registres/media-registry.md) du core. Les autres modules l'utilisent sans jamais le déclarer en dépendance : ils appellent les façades du core, qui deviennent actives dès que ce module est installé.
 
+```bash
+npm i @fraza/module-medias
+```
+
+| Paquet | `@fraza/module-medias` |
+|---|---|
+| Licence | MIT, Fraza Libre. |
+| Registre | npmjs, sans compte ni configuration. |
+| Activation | `FRAZA_MODULE_MEDIAS=true` |
+
+L'activation, la création des tables et la route de fichier sont dans [Installation](./01-installation.md).
+
 ![La médiathèque, sa grille de vignettes, sa recherche et son filtre par type](../../assets/modules/medias/mediatheque.light.webp)
 
-La grille est le point d'entrée humain de la bibliothèque : recherche par nom de fichier, filtre par type, téléversement. C'est le même fonds que vient chercher un bloc image ou un champ média d'un autre module, par le registre plutôt que par un import. Voir [Intégration](./integration.md).
+La grille est le point d'entrée humain de la bibliothèque : recherche par nom de fichier, filtre par type, téléversement. C'est le même fonds que vient chercher un bloc image ou un champ média d'un autre module, par le registre plutôt que par un import. Voir [Intégration](./05-integration.md).
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer les tables, monter la route de fichier. |
-| [Configuration](./configuration.md) | Variables d'environnement, stockage objet, permissions, entrée d'admin. |
-| [Téléversement](./televersement.md) | Formats acceptés, limites, validation, optimisation, nommage. |
-| [Administration](./admin.md) | La médiathèque : filtres, sélection multiple, actions groupées, fiche d'un média. |
-| [Intégration](./integration.md) | Référencer un média depuis un autre module ou un bloc. |
-| [Modèle de données](./modele-de-donnees.md) | Tables `fraza_media` et `fraza_media_references`. |
-| [API](./api.md) | Routes HTTP d'admin et route publique de fichier. |
+| [Installation](./01-installation.md) | Installer le module, créer les tables, monter la route de fichier. |
+| [Configuration](./02-configuration.md) | Variables d'environnement, stockage objet, permissions, entrée d'admin. |
+| [Téléversement](./03-televersement.md) | Formats acceptés, limites, validation, optimisation, nommage. |
+| [Administration](./04-admin.md) | La médiathèque : filtres, sélection multiple, actions groupées, fiche d'un média. |
+| [Intégration](./05-integration.md) | Référencer un média depuis un autre module ou un bloc. |
+| [Modèle de données](./06-modele-de-donnees.md) | Tables `fraza_media` et `fraza_media_references`. |
+| [API](./07-api.md) | Routes HTTP d'admin et route publique de fichier. |
 
 ## Ce que le module apporte
 
@@ -44,7 +56,7 @@ C'est le seul module officiel dont la valeur principale n'est pas sa propre inte
 
 Sans ce module, ces façades sont des fonctions neutres : les lectures renvoient vide, les écritures renvoient un échec explicite, le sélecteur d'image se masque. Aucun code appelant n'a donc à se conditionner.
 
-C'est ce contrat qui est documenté dans [Intégration](./integration.md).
+C'est ce contrat qui est documenté dans [Intégration](./05-integration.md).
 
 ## Où vivent les fichiers
 
@@ -55,7 +67,7 @@ Deux noms coexistent donc pour chaque fichier :
 - une **clé de stockage** privée, jamais exposée, de la forme `media/<année>/<mois>/<nom unique>` ;
 - un **nom public** assaini, utilisé dans l'URL `/za/media/<nom>`.
 
-Renommer un média change le second sans toucher au premier, ce qui n'invalide aucune référence. Voir [Téléversement](./televersement.md).
+Renommer un média change le second sans toucher au premier, ce qui n'invalide aucune référence. Voir [Téléversement](./03-televersement.md).
 
 ## Notes
 

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

@@ -1,19 +1,19 @@
 ---
 title: Installation
-description: Installer @fraza/module-pages, créer la table, activer le module et brancher le rendu public à la racine du site.
+description: Installer @fraza/module-pages, créer la table, brancher le rendu public et fournir le template par défaut.
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/pages/configuration
-    - 06-modules/pages/templates
+    - 06-modules/pages/02-configuration
+    - 06-modules/pages/05-templates
 ---
 
-Cette page couvre l'installation de `@fraza/module-pages` 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).
+Cette page installe `@fraza/module-pages` 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é.
-- Aucune configuration ni connexion : le module est gratuit et publié sur npmjs.
+- Un projet créé par `npx @fraza/start`, avec `@fraza/core` à jour.
+- Aucun compte : le paquet est publié sur npmjs.
 
 ## Installer
 
@@ -23,21 +23,21 @@ npm i @fraza/module-pages
 
 Ajouter la variable d'activation à `.env.local`, et aux variables de la plateforme en production :
 
-```bash
+```dotenv
 #------ MODULE - PAGES ------#
 FRAZA_MODULE_PAGES=true
 ```
 
-Sans ce drapeau, le module est ignoré : aucune table, aucune route, aucune entrée d'admin. Le détail des variables est dans [Configuration](./configuration.md).
+Sans ce drapeau, le module est ignoré : aucune table, aucune route, aucune entrée d'admin. Le détail des variables est dans [Configuration](./02-configuration.md).
 
-Régénérer les manifestes puis créer la table :
+Régénérer les manifestes, puis créer la table :
 
 ```bash
 npx fraza-modules sync    # déclenché automatiquement au postinstall
 npx fraza-db init         # crée fraza_pages_page
 ```
 
-`fraza-db init` est idempotent. Sur une base qui possède déjà la table, il applique les migrations de schéma 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à la table, il applique les migrations en attente sans toucher aux données. Il enregistre aussi les permissions `pages.view` et `pages.manage`, et les attribue au rôle `admin`. Voir [Modèle de données](./04-modele-de-donnees.md).
 
 ## Brancher le rendu public
 
@@ -53,7 +53,7 @@ Le catch-all ne couvre pas la racine `/`. L'accueil du site reste `app/(public)/
 
 ### Projet sans catch-all dynamique
 
-Si le projet n'utilise pas le registre de résolveurs, la vue publique se re-exporte directement :
+Si le projet n'utilise pas le registre de résolveurs, la vue publique se réexporte directement :
 
 ```js
 // app/(public)/[...slug]/page.js
@@ -68,7 +68,7 @@ Le module n'embarque aucun template. Il résout `page.template`, et retombe sur
 
 Le template `default` est fourni par le projet hôte dans `components/fraza/templates/default.js`, et enregistré au boot par le manifeste que génère `fraza-modules sync`. Le start template en fournit un. Sans aucun template enregistré, le module rend les blocs bruts via `BlockListRenderer` du core, sans mise en page.
 
-Voir [Templates](./templates.md) pour en écrire un.
+Voir [Templates](./05-templates.md) pour en écrire un.
 
 ## Vérifier
 
@@ -79,20 +79,18 @@ Voir [Templates](./templates.md) pour en écrire un.
 2. `Pages` apparaît dans la barre latérale de l'admin.
 3. Créer une page depuis `/admin/pages`, la laisser en visibilité publique, puis l'ouvrir à `/<slug>`.
 
-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 `pages.view` et `pages.manage` apparaissent dans `/admin/roles`.
-
 ## Mettre à jour
 
 ```bash
 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-pages` 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-pages` 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-pages/CHANGELOG.md`.
+Les notes de version sont livrées avec le paquet, dans `node_modules/@fraza/module-pages/CHANGELOG.md`.
 
 ## Notes
 
 - Le module dépend de `@fraza/core` en `peerDependency`. Il n'embarque pas sa propre copie du core.
-- Les blocs image utilisent le registre de médias du core. Si `@fraza/module-medias` est installé, le sélecteur d'image et l'image de partage Open Graph deviennent disponibles dans l'éditeur. Le module le déclare comme module optionnel, dans `manifest.optionalModules` : `npx fraza-doctor` le rappelle par une information tant qu'il manque. Voir [Dépendances souples](../../03-reference/01-cores/modules.md#dépendances-souples).
 - Désinstaller le module ne supprime pas la table. `dropTables` est exporté depuis `@fraza/module-pages` pour le faire explicitement.
+- Les blocs image utilisent le registre de médias du core. Si `@fraza/module-medias` est installé, le sélecteur d'image et l'image de partage Open Graph deviennent disponibles dans l'éditeur. Le module le déclare comme module optionnel, dans `manifest.optionalModules` : `npx fraza-doctor` le rappelle par une information tant qu'il manque. Voir [Dépendances souples](../../03-reference/01-cores/modules.md#dépendances-souples).

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

@@ -4,7 +4,7 @@ description: Variables d'environnement, permissions et intégration à l'admin d
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/pages/modele-de-donnees
+    - 06-modules/pages/04-modele-de-donnees
     - 03-reference/06-configuration/variables-d-environnement
 ---
 

package/dist/docs/06-modules/pages/{admin.md → 03-admin.md}

@@ -4,8 +4,8 @@ description: Liste arborescente, formulaire d'édition, sélecteur de parent, da
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/pages/modele-de-donnees
-    - 06-modules/pages/templates
+    - 06-modules/pages/04-modele-de-donnees
+    - 06-modules/pages/05-templates
 ---
 
 Le module ajoute une section `Pages` à la barre latérale de l'admin. Tout le contenu d'une page s'y édite : titre, slug, blocs, template, parent, visibilité et SEO. Cette page décrit ce que fait l'interface, y compris les quelques comportements qui surprennent.
@@ -18,7 +18,7 @@ Le module ajoute une section `Pages` à la barre latérale de l'admin. Tout le c
 | `/admin/pages/new` | Création. |
 | `/admin/pages/edit/<id>` | Édition. |
 
-L'accès à la section demande `pages.view` : sans elle, `/admin/pages` répond 404, comme une page inconnue. Créer, modifier, dupliquer et supprimer demandent `pages.manage`. Voir [Configuration](./configuration.md).
+L'accès à la section demande `pages.view` : sans elle, `/admin/pages` répond 404, comme une page inconnue. Créer, modifier, dupliquer et supprimer demandent `pages.manage`. Voir [Configuration](./02-configuration.md).
 
 ## Liste
 
@@ -47,7 +47,7 @@ La duplication reprend les blocs, le SEO, le template et la visibilité de l'ori
 
 ### Colonne SEO
 
-Quand `FRAZA_SEO` est actif, une colonne affiche le score SEO de chaque page. Le drapeau inactif, la colonne n'existe pas. Voir [Configuration](./configuration.md).
+Quand `FRAZA_SEO` est actif, une colonne affiche le score SEO de chaque page. Le drapeau inactif, la colonne n'existe pas. Voir [Configuration](./02-configuration.md).
 
 ## Formulaire
 
@@ -57,7 +57,7 @@ L'en-tête de l'édition montre l'adresse complète de la page, et le bouton `Vo
 
 ### Slug et aperçu d'URL
 
-Sous le champ slug, l'URL publique complète est recalculée à chaque frappe, en préfixant le chemin du parent sélectionné. Le slug saisi est normalisé à l'enregistrement, et suffixé s'il entre en collision avec celui d'une page de même parent. Les règles complètes sont dans [Modèle de données](./modele-de-donnees.md).
+Sous le champ slug, l'URL publique complète est recalculée à chaque frappe, en préfixant le chemin du parent sélectionné. Le slug saisi est normalisé à l'enregistrement, et suffixé s'il entre en collision avec celui d'une page de même parent. Les règles complètes sont dans [Modèle de données](./04-modele-de-donnees.md).
 
 ### Contenu
 
@@ -79,7 +79,7 @@ Les dates s'affichent en français (`fr-CA`), dans le fuseau du navigateur. « C
 
 ### Template
 
-Le sélecteur liste les templates de `kind: 'page'` enregistrés dans le projet. Voir [Templates](./templates.md).
+Le sélecteur liste les templates de `kind: 'page'` enregistrés dans le projet. Voir [Templates](./05-templates.md).
 
 Si la page porte un template qui n'existe plus, le sélecteur se réaligne sur le premier template disponible, et l'enregistrement suivant écrit cette valeur. Le rendu public, lui, ne réécrit rien : il retombe sur `default` tant que le champ n'a pas été enregistré.
 

package/dist/docs/06-modules/pages/{modele-de-donnees.md → 04-modele-de-donnees.md}

@@ -4,8 +4,8 @@ description: Table fraza_pages_page, hiérarchie par parent_id, règles de slug,
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/pages/api
-    - 06-modules/pages/templates
+    - 06-modules/pages/06-api
+    - 06-modules/pages/05-templates
 ---
 
 Le module crée une seule table, `fraza_pages_page`. Comprendre sa forme est nécessaire pour écrire un template, appeler l'API ou diagnostiquer une URL qui ne résout pas.

package/dist/docs/06-modules/pages/{templates.md → 05-templates.md}

@@ -109,7 +109,7 @@ Au rendu, le module cherche le template dont l'identifiant vaut `page.template`.
 
 Un template supprimé du projet ne casse donc pas les pages qui l'utilisaient : elles retombent sur `default` jusqu'à ce que leur champ soit changé.
 
-L'éditeur, lui, ne se comporte pas pareil. Face à un template inconnu, son sélecteur se réaligne sur le premier template de la liste, et l'enregistrement suivant écrit cette valeur en base. Renommer l'identifiant d'un template déjà utilisé demande donc de repasser sur les pages concernées, sous peine de les voir migrer une à une vers un template arbitraire. Voir [Administration](./admin.md).
+L'éditeur, lui, ne se comporte pas pareil. Face à un template inconnu, son sélecteur se réaligne sur le premier template de la liste, et l'enregistrement suivant écrit cette valeur en base. Renommer l'identifiant d'un template déjà utilisé demande donc de repasser sur les pages concernées, sous peine de les voir migrer une à une vers un template arbitraire. Voir [Administration](./03-admin.md).
 
 ## Notes
 

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

@@ -4,7 +4,7 @@ description: Routes HTTP d'admin et publiques, et fonctions serveur importables
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/pages/modele-de-donnees
+    - 06-modules/pages/04-modele-de-donnees
     - 03-reference/01-cores/api
 ---
 
@@ -24,7 +24,7 @@ Le module expose ses pages de deux façons : des routes HTTP pour le navigateur,
 import { listPublicChildPages, getPublishedPageBySegments } from '@fraza/module-pages/public';
 ```
 
-`@fraza/module-pages/public` exporte aussi `default` et `generateMetadata`, destinés au re-export dans un catch-all. Voir [Installation](./installation.md).
+`@fraza/module-pages/public` exporte aussi `default` et `generateMetadata`, destinés au re-export dans un catch-all. Voir [Installation](./01-installation.md).
 
 ## API
 

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

@@ -4,28 +4,40 @@ description: Pages CMS hiérarchiques rendues à la racine du site, éditées au
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/pages/installation
-    - 06-modules/pages/configuration
+    - 06-modules/pages/01-installation
+    - 06-modules/pages/02-configuration
 ---
 
 `@fraza/module-pages` ajoute une section « Pages » à l'admin et rend chaque page publiée à la racine du site, à l'URL construite depuis sa chaîne de parents. Le contenu est édité au `BlockEditor` du core et rendu par un template fourni par le projet hôte.
 
+```bash
+npm i @fraza/module-pages
+```
+
+| Paquet | `@fraza/module-pages` |
+|---|---|
+| Licence | MIT, Fraza Libre. |
+| Registre | npmjs, sans compte ni configuration. |
+| Activation | `FRAZA_MODULE_PAGES=true` |
+
+L'activation, la création de la table et le rendu public sont dans [Installation](./01-installation.md).
+
 Le module est indépendant de `@fraza/module-posts`. Les deux peuvent cohabiter : pages sert de repli sur toute URL non réclamée, posts réserve son préfixe.
 
 ![La liste des pages dans l'admin, rangée en arbre](../../assets/modules/pages/liste.light.webp)
 
-La liste range chaque page sous son parent, décalée d'un cran par niveau, et affiche sous le titre le chemin public reconstruit depuis la chaîne des parents. La colonne SEO n'apparaît que si `FRAZA_SEO` est actif. Le détail de l'écran est dans [Administration](./admin.md).
+La liste range chaque page sous son parent, décalée d'un cran par niveau, et affiche sous le titre le chemin public reconstruit depuis la chaîne des parents. La colonne SEO n'apparaît que si `FRAZA_SEO` est actif. Le détail de l'écran est dans [Administration](./03-admin.md).
 
 ## Pages de cette section
 
 | Page | Contenu |
 |---|---|
-| [Installation](./installation.md) | Installer le module, créer la table, brancher le rendu public. |
-| [Configuration](./configuration.md) | Variables d'environnement, permissions, entrée d'admin. |
-| [Administration](./admin.md) | Liste arborescente, formulaire, parent, dates et enregistrement. |
-| [Modèle de données](./modele-de-donnees.md) | Table `fraza_pages_page`, hiérarchie, règles de slug et de visibilité. |
-| [Templates](./templates.md) | Écrire un template de page et les propriétés qu'il reçoit. |
-| [API](./api.md) | Routes HTTP et fonctions serveur importables. |
+| [Installation](./01-installation.md) | Installer le module, créer la table, brancher le rendu public. |
+| [Configuration](./02-configuration.md) | Variables d'environnement, permissions, entrée d'admin. |
+| [Administration](./03-admin.md) | Liste arborescente, formulaire, parent, dates et enregistrement. |
+| [Modèle de données](./04-modele-de-donnees.md) | Table `fraza_pages_page`, hiérarchie, règles de slug et de visibilité. |
+| [Templates](./05-templates.md) | Écrire un template de page et les propriétés qu'il reçoit. |
+| [API](./06-api.md) | Routes HTTP et fonctions serveur importables. |
 
 ## Ce que le module apporte
 

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

@@ -4,16 +4,16 @@ description: Installer @fraza/module-posts, déclarer un premier type, créer le
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/types-et-champs
-    - 06-modules/posts/configuration
+    - 06-modules/posts/03-types-et-champs
+    - 06-modules/posts/02-configuration
 ---
 
-Cette page couvre l'installation de `@fraza/module-posts` 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).
+Cette page installe `@fraza/module-posts` 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é.
-- Aucune configuration ni connexion : le module est gratuit et publié sur npmjs.
+- Un projet créé par `npx @fraza/start`, avec `@fraza/core` à jour.
+- Aucun compte : le paquet est publié sur npmjs.
 
 ## Installer
 
@@ -21,33 +21,29 @@ Cette page couvre l'installation de `@fraza/module-posts` dans un projet déjà
 npm i @fraza/module-posts
 ```
 
-## Déclarer un premier type
+Ajouter la variable d'activation et un premier type à `.env.local`, et aux variables de la plateforme en production :
 
-Contrairement aux autres modules, activer `@fraza/module-posts` ne suffit pas : sans type déclaré, il ne crée aucune section d'admin et ne rend rien.
-
-```bash
+```dotenv
 #------ MODULE - POSTS ------#
 FRAZA_MODULE_POSTS=true
 FRAZA_MODULE_POSTS_TYPES=blogue:Blogue:MoonIcon
 FRAZA_MODULE_POSTS_TYPE_BLOGUE=title:title|slug:slug|date:date:now:sidebar|content:editor:Contenu
 ```
 
-Trois lignes, dans cet ordre : le drapeau d'activation, la liste des types, puis les champs de chaque type. Le nom de la variable de champs est dérivé de la clé du type en majuscules.
+Sans le drapeau, le module est ignoré : aucune table, aucune route, aucune entrée d'admin. Contrairement aux autres modules, le drapeau seul ne suffit pas : sans type déclaré, le module ne crée aucune section d'admin et ne rend rien.
 
-La syntaxe complète est dans [Types et champs](./types-et-champs.md).
+Les trois lignes viennent dans cet ordre : le drapeau d'activation, la liste des types, puis les champs de chaque type. Le nom de la variable de champs est dérivé de la clé du type en majuscules. La syntaxe complète est dans [Types et champs](./03-types-et-champs.md).
 
-## 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 les tables du module
 ```
 
-`fraza-db init` est **sensible à la configuration** pour ce module. Il ne crée les tables de taxonomies que si au moins un type déclare un champ `taxonomy`, et la table des relations que si au moins un type déclare un champ `relation`.
-
-Conséquence directe : après avoir ajouté une taxonomie ou une relation à un type existant, il faut relancer `npx fraza-db init`. La commande est idempotente, elle ne touche pas aux données en place.
+`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 permissions `posts.view` et `posts.manage`, et les attribue au rôle `admin`.
 
-Voir [Modèle de données](./modele-de-donnees.md) pour le détail des tables et des migrations.
+Pour ce module, `fraza-db init` est **sensible à la configuration**. Il ne crée les tables de taxonomies que si au moins un type déclare un champ `taxonomy`, et la table des relations que si au moins un type déclare un champ `relation`. Après avoir ajouté une taxonomie ou une relation à un type existant, relancer `npx fraza-db init`. Voir [Modèle de données](./06-modele-de-donnees.md).
 
 ## Brancher le rendu public
 
@@ -59,28 +55,17 @@ app/(public)/[...slug]/page.js
 
 Ce fichier itère les résolveurs de [`core/public-content`](../../03-reference/01-cores/public-content.md). Le module y enregistre le sien au boot, à la priorité 10. **Il n'y a donc rien à importer** : l'installation suffit.
 
-Le sous-chemin `@fraza/module-posts/public` exporte bien une vue par défaut, `PostPublicView({ postType, slug })`, mais elle sert de repli de débogage pour un projet qui voudrait court-circuiter le registre. Le start template ne l'utilise pas : une URL de post porte toujours son type en premier segment, elle ne se prête donc pas à un fichier de route fixe. Voir [API](./api.md).
+Le sous-chemin `@fraza/module-posts/public` exporte bien une vue par défaut, `PostPublicView({ postType, slug })`, mais elle sert de repli de débogage pour un projet qui voudrait court-circuiter le registre. Le start template ne l'utilise pas : une URL de post porte toujours son type en premier segment, elle ne se prête donc pas à un fichier de route fixe. Voir [API](./08-api.md).
 
 ## Fournir un template
 
 Le module enregistre lui-même un template `default` par type, qui rend le titre puis les blocs bruts via `BlockListRenderer`. C'est suffisant pour vérifier l'installation, pas pour un site.
 
-Pour reprendre la main sur la mise en page, écrire un template dans `components/fraza/templates/` et le déclarer sur le type. Voir [Templates](./templates.md).
-
-## Vérifier
-
-1. La connexion à la base répond :
-   ```bash
-   npx fraza-db test
-   ```
-2. Une section `Blogue` apparaît dans la barre latérale de l'admin, avec un item `Posts`.
-3. Créer un post depuis `/admin/posts/blogue/list`, le laisser en visibilité publique, puis l'ouvrir à `/blogue/<slug>`. Voir [Administration](./admin.md).
+Pour reprendre la main sur la mise en page, écrire un template dans `components/fraza/templates/` et le déclarer sur le type. Voir [Templates](./07-templates.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 `posts.view` et `posts.manage` apparaissent dans `/admin/roles`.
+## Ajouter les médias
 
-## Médias
-
-Si un type déclare un champ `image`, `thumbnail` ou `gallery` sans que `@fraza/module-medias` soit installé et activé, le module journalise un avertissement au boot listant les champs concernés. Le module démarre quand même, mais le sélecteur d'image reste indisponible dans l'éditeur.
+Si un type déclare un champ `image`, `thumbnail` ou `gallery` sans que `@fraza/module-medias` soit installé et activé, le module journalise au boot un avertissement qui liste les champs concernés. Le module démarre quand même, mais le sélecteur d'image reste indisponible dans l'éditeur.
 
 Le module déclare `@fraza/module-medias` comme module optionnel, dans `manifest.optionalModules` : `npx fraza-doctor` le rappelle par une information tant qu'il manque, sans en faire un constat bloquant. Voir [Dépendances souples](../../03-reference/01-cores/modules.md#dépendances-souples).
 
@@ -90,21 +75,30 @@ npm i @fraza/module-medias
 
 Puis, dans `.env.local` :
 
-```bash
+```dotenv
 FRAZA_MODULE_MEDIAS=true
 ```
 
 Voir [Module Médias](../medias/index.md).
 
+## Vérifier
+
+1. La connexion à la base répond :
+   ```bash
+   npx fraza-db test
+   ```
+2. Une section `Blogue` apparaît dans la barre latérale de l'admin, avec un item `Posts`.
+3. Créer un post depuis `/admin/posts/blogue/list`, le laisser en visibilité publique, puis l'ouvrir à `/blogue/<slug>`. Voir [Administration](./05-admin.md).
+
 ## Mettre à jour
 
 ```bash
 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-posts` 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-posts` 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-posts/CHANGELOG.md`.
+Les notes de version sont livrées avec le paquet, dans `node_modules/@fraza/module-posts/CHANGELOG.md`.
 
 ## Notes
 

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

@@ -4,11 +4,11 @@ description: Variables d'environnement, permissions et intégration à l'admin d
 related:
   title: Étapes suivantes
   links:
-    - 06-modules/posts/types-et-champs
+    - 06-modules/posts/03-types-et-champs
     - 03-reference/06-configuration/variables-d-environnement
 ---
 
-Le module inverse la répartition habituelle : la **structure** du contenu vit dans les variables d'environnement, le **contenu** vit en base. Cette page couvre les variables globales, les permissions et l'admin. La syntaxe de déclaration des types est traitée à part, dans [Types et champs](./types-et-champs.md).
+Le module inverse la répartition habituelle : la **structure** du contenu vit dans les variables d'environnement, le **contenu** vit en base. Cette page couvre les variables globales, les permissions et l'admin. La syntaxe de déclaration des types est traitée à part, dans [Types et champs](./03-types-et-champs.md).
 
 ## Variables d'environnement
 
@@ -16,7 +16,7 @@ Le module inverse la répartition habituelle : la **structure** du contenu vit d
 |---|---|---|
 | `FRAZA_MODULE_POSTS` | oui | `true` active le module. Absente ou fausse, le module est ignoré : aucune table, aucune route, aucune entrée d'admin. |
 | `FRAZA_MODULE_POSTS_TYPES` | non | Liste des types de contenu. Absente, le module est actif mais ne déclare rien. |
-| `FRAZA_MODULE_POSTS_TYPE_<CLÉ>` | non | Champs d'un type. Voir [Types et champs](./types-et-champs.md). Une erreur de déclaration fait échouer le démarrage. |
+| `FRAZA_MODULE_POSTS_TYPE_<CLÉ>` | non | Champs d'un type. Voir [Types et champs](./03-types-et-champs.md). Une erreur de déclaration fait échouer le démarrage. |
 | `FRAZA_MODULE_POSTS_TYPE_<CLÉ>_PRIVATE` | non | Champs retirés des réponses publiques et du rendu public. Chaque nom doit désigner un champ déclaré du type. |
 | `FRAZA_MODULE_POSTS_TYPE_<CLÉ>_LIST` | non | Colonnes du tableau d'admin. |
 | `FRAZA_MODULE_POSTS_TYPE_<CLÉ>_ORDERABLE` | non | `true` active le réordonnancement manuel. |
@@ -38,7 +38,7 @@ Quand le drapeau est actif :
 - Les valeurs sont stockées sous la clé `seo` des données du post.
 - Le rendu public transforme cet objet en métadonnées Next.js avec `buildSeoMetadata`, en `ogType: 'article'`.
 - Le jeton `seo` devient utilisable comme colonne dans `_LIST`, affichant une pastille de score.
-- Les champs laissés vides retombent sur le contenu du post : la méta description est dérivée d'un champ `text` ou `editor`, l'image de partage d'un champ `thumbnail` ou `image`. Voir [Repli SEO automatique](./types-et-champs.md#repli-seo-automatique).
+- Les champs laissés vides retombent sur le contenu du post : la méta description est dérivée d'un champ `text` ou `editor`, l'image de partage d'un champ `thumbnail` ou `image`. Voir [Repli SEO automatique](./03-types-et-champs.md#repli-seo-automatique).
 
 Drapeau inactif, la page publique n'expose que son titre comme métadonnée, et aucun repli n'est calculé.
 
@@ -64,13 +64,13 @@ Le module enregistre **une section de navigation par type déclaré**, et non un
 | Propriété | Valeur |
 |---|---|
 | Titre de section | Libellé du type, ou clé capitalisée si aucun libellé n'est donné. |
-| Icône | Troisième segment de la déclaration du type, `BookIcon` par défaut. Un nom du jeu `@fraza/icons`, ou une icône exportée par `components/fraza/icons.js`. Voir [Types et champs](./types-et-champs.md#déclarer-un-type). |
+| Icône | Troisième segment de la déclaration du type, `BookIcon` par défaut. Un nom du jeu `@fraza/icons`, ou une icône exportée par `components/fraza/icons.js`. Voir [Types et champs](./03-types-et-champs.md#déclarer-un-type). |
 | Ordre | 300 pour le premier type, puis 301, 302, dans l'ordre de déclaration. |
 | Chemin de la liste | `/admin/posts/<clé>/list` |
 | Chemin d'une taxonomie | `/admin/posts/<clé>/taxonomies/<clé de taxonomie>` |
 | Permission | `posts.view` sur tous les items. |
 
-Les écrans desservis par ces entrées sont décrits dans [Administration](./admin.md).
+Les écrans desservis par ces entrées sont décrits dans [Administration](./05-admin.md).
 
 L'ordre des sections suit donc l'ordre de `FRAZA_MODULE_POSTS_TYPES`, et les types occupent une plage continue à partir de 300. Un autre module ne peut pas s'intercaler entre deux types : il se place avant en prenant un ordre inférieur à 300, ou après en prenant un ordre supérieur à la plage occupée. Voir [Étendre l'admin](../../02-guides/etendre-l-admin.md).