@fraza/core 0.3.8 → 0.3.12

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).

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