@deveye/types 0.15.2 → 0.16.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deveye/types",
-  "version": "0.15.2",
+  "version": "0.16.1",
   "description": "Shared contracts (types + zod schemas) for DevEye apps",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -41,9 +41,9 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "typecheck": "tsc --noEmit",
-    "ci": "npm run lint && npm run typecheck && npm test",
-    "prettier": "prettier --check .",
-    "prettier:fix": "prettier --write .",
+    "ci": "npm run format:check && npm run lint && npm run typecheck && npm test",
+    "format:check": "prettier --check .",
+    "format:fix": "prettier --write .",
     "test": "tsx --test \"src/**/*.test.ts\""
   },
   "dependencies": {
@@ -57,8 +57,8 @@
     "@eslint/js": "^8.0.0",
     "@types/node": "^26.3.0",
     "@types/react": "^19.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^8.0.0",
     "eslint-plugin-prettier": "^5.5.4",
     "tsx": "^4.23.12",

package/src/domain/device.ts

@@ -91,18 +91,10 @@ export interface DeviceRow {
     id: string;
     owner_id: number;
     /**
-     * Espace d'**appairage** : celui que visait le code de liaison. Il porte
-     * l'unicité de l'empreinte (`uniq_workspace_fingerprint`) et sert le
-     * ré-enrôlement depuis la route publique, qui n'a pas de session pour dire
-     * autrement d'où elle vient.
-     *
-     * Ce n'est plus la frontière d'accès : celle-ci est la table de jonction
-     * `device_workspaces`, un appareil pouvant être partagé avec plusieurs
-     * espaces. L'espace d'appairage y figure toujours et ne s'en retire pas.
-     *
-     * `null` quand cet espace a été supprimé : l'appareil survit — il perd son
-     * origine, pas son existence — et reste joignable par les espaces avec
-     * lesquels il est partagé.
+     * Espace d'appairage (celui du code de liaison) : porte l'unicité de
+     * l'empreinte (`uniq_workspace_fingerprint`) et sert le ré-enrôlement par la
+     * route publique. La frontière d'accès est `device_workspaces`, où il figure
+     * toujours. `null` si cet espace a été supprimé : l'appareil survit.
      */
     workspace_id: number | null;
     name: string;
@@ -131,23 +123,6 @@ export interface DeviceRow {
     status_before_delete: string | null;
     /** Last self-destruct failure message (deletion aborted); null otherwise. */
     delete_error: string | null;
-    /**
-     * Sentinelle est-elle active sur cet appareil ? Éteinte par défaut : activer
-     * la feature ne doit lire les journaux d'authentification de personne, c'est
-     * un geste explicite appareil par appareil.
-     */
-    sentinel_enabled: number;
-    /**
-     * Fin de la fenêtre d'apprentissage, unix ms. `null` tant que Sentinelle n'a
-     * jamais été activée ; une date passée signifie « apprentissage terminé ».
-     */
-    sentinel_learning_until: number | null;
-    /** Cadence du manifeste de persistance, en minutes. */
-    sentinel_integrity_minutes: number;
-    /** Relever les issues d'authentification (interrupteur propre). */
-    sentinel_auth_events: number;
-    /** Unix ms du dernier manifeste reçu ; `null` = jamais mesuré. */
-    sentinel_last_integrity_at: number | null;
 }
 
 /**

package/src/domain/featureRegistry.ts

@@ -6,24 +6,10 @@ import {
 } from './workspaceRole';
 
 /**
- * Ce qu'est une fonctionnalité, dit **une fois**.
- *
- * Le même renseignement vivait à trois endroits : `HOME_FEATURE_IDS` pour les
- * tuiles, `WORKSPACE_FEATURE_IDS` pour les droits, et les intitulés recopiés à la
- * main dans `RoleDialog` **et** dans `FEATURE_CATALOG`. Trois copies d'un même
- * couple identifiant / libellé, c'est la garantie qu'une fonctionnalité ajoutée
- * n'arrivera que dans deux d'entre elles — et c'est exactement ce qui était
- * arrivé à `monitoring`, présent dans un tableau et absent de l'autre sans que
- * rien ne le dise.
- *
- * Ce registre porte donc le **descriptif** ; les deux enums gardent leur rôle,
- * qui est de dire *où* une fonctionnalité a le droit d'apparaître. Ils ne sont
- * volontairement pas fusionnés : leur écart est documenté et voulu (`devices`
- * s'accorde mais n'a pas de tuile, `monitoring` a une tuile mais ne s'accorde
- * pas — voir `workspaceRole.ts`).
- *
- * Les écrans qui parcourent les fonctionnalités — la coquille de réglages, la
- * matrice de permissions, l'écran des rôles — lisent celui-ci et rien d'autre.
+ * Ce qu'est une fonctionnalité, dit une fois : le descriptif que lisent les
+ * écrans qui parcourent les fonctionnalités (coquille de réglages, matrice de
+ * permissions, écran des rôles). `HOME_FEATURE_IDS` et `WORKSPACE_FEATURE_IDS`
+ * gardent leur rôle : dire où une fonctionnalité a le droit d'apparaître.
  */
 export interface FeatureDescriptor {
     id: FeatureId;
@@ -38,18 +24,14 @@ export interface FeatureDescriptor {
     /** Classe d'icône de `Styles/icons.css`, sans le préfixe `icon-`. */
     icon: string;
     /**
-     * Cette fonctionnalité sait prévenir. Décide de l'onglet « Notifications »
-     * de ses réglages — et, à elle seule, de l'existence du bouton pour les
-     * quatre qui n'ont rien d'autre à régler.
+     * Cette fonctionnalité sait prévenir : décide de l'onglet « Notifications »
+     * de ses réglages.
      */
     notifies: boolean;
     /**
-     * Elle tient une liste d'entités adressables (un service, une base, une
-     * cible) sur lesquelles des réglages peuvent porter individuellement.
-     *
-     * Faux ne veut pas dire « aucune donnée » : Sentinelle a bien des constats,
-     * mais on ne règle pas un constat, on règle la surveillance. Le critère est
-     * « peut-on ouvrir les réglages de **cet** élément ? ».
+     * Elle tient des entités adressables sur lesquelles des réglages portent
+     * individuellement. Le critère : « peut-on ouvrir les réglages de CET
+     * élément ? » (Sentinelle a des constats, mais on règle la surveillance).
      */
     hasItems: boolean;
     /**
@@ -58,42 +40,23 @@ export interface FeatureDescriptor {
      */
     itemNoun?: string;
     /**
-     * Les **sources** de la fonctionnalité : des réglages d'espace réutilisables
-     * (un jeton Dokploy, un jeton GitHub, une destination d'archives) que
-     * chaque élément ne fait que **désigner**. Corriger une source corrige d'un
-     * coup tout ce qui s'en sert.
-     *
-     * Présent, il ouvre l'onglet « Sources » des réglages **à l'échelle de la
-     * fonctionnalité**, le seul endroit où les sources se créent et se
-     * corrigent. Les dialogues d'élément, eux, ne font que choisir dans la
-     * liste, avec un bouton qui mène ici. `hint` est la phrase de tête de
-     * l'onglet : elle dit ce qu'on y gère et qui s'en sert.
-     *
-     * Les canaux de notification suivent la même logique sans passer par ce
-     * champ : ce sont les sources des émetteurs (chaque feature a les siens,
-     * migration 091), gérées dans leur onglet « Notifications », qui porte
-     * aussi le routage, indissociable (voir `notifies`).
+     * Les sources de la fonctionnalité : des réglages d'espace réutilisables
+     * (un jeton, une destination) que chaque élément ne fait que désigner.
+     * Ouvre l'onglet « Sources » à l'échelle de la fonctionnalité, seul endroit
+     * où elles se créent et se corrigent ; `hint` est la phrase de tête de
+     * l'onglet. Les canaux de notification suivent la même logique dans
+     * l'onglet « Notifications » (voir `notifies`).
      */
     sources?: { hint: string };
     /**
      * Un de ses éléments peut-il être rendu visible depuis un autre espace ?
-     *
-     * La réponse tient entièrement au **chiffrement**, pas au goût : un élément
-     * partagé reste chiffré sous la clé de son espace d'origine — c'est le
-     * levier L3 de `WORKSPACES.md`, et y renoncer voudrait dire re-chiffrer sous
-     * session vivante, ce que ce document range explicitement hors périmètre.
-     *
-     * Or seule la clé de l'**étage ouvert** est résoluble par le serveur seul.
-     * D'où trois cas :
-     *
-     *  - `'open'` — toute la fonctionnalité vit à l'étage ouvert : partageable
-     *    sans condition (Uptime, Bases, Déploiement, Git, Audience, Sauvegardes) ;
-     *  - `'perItem'` — l'étage se choisit élément par élément. Une note
-     *    ordinaire se partage, une note privée non ; un compte mail « open »
-     *    oui, un compte « guarded » non. Le serveur tranche à la ligne, jamais
-     *    la fonctionnalité en bloc ;
-     *  - `'never'` — rien n'y est partageable, pour une raison propre à chaque
-     *    cas (voir la note sous le registre).
+     * Décidé par le chiffrement : un élément partagé reste chiffré sous la clé
+     * de son espace d'origine, et seule la clé de l'étage ouvert est résoluble
+     * par le serveur seul.
+     *  - `'open'` : toute la fonctionnalité vit à l'étage ouvert ;
+     *  - `'perItem'` : l'étage se choisit élément par élément, le serveur
+     *    tranche à la ligne ;
+     *  - `'never'` : rien n'y est partageable (voir la note sous le registre).
      */
     shareTier: 'open' | 'perItem' | 'never';
 }
@@ -290,13 +253,9 @@ export const FEATURE_REGISTRY: readonly (FeatureDescriptor & { id: WorkspaceFeat
 const BY_ID = new Map<string, FeatureDescriptor>(FEATURE_REGISTRY.map((f) => [f.id, f]));
 
 /**
- * Les modules **externes** enregistrés dans ce processus.
- *
- * Le registre natif est une constante ; celui-ci se remplit au chargement, une
- * fois par module installé, depuis la glue générée des deux bundles. Il ne
- * s'agit pas de chargement à chaud : la liste est figée à la compilation, la
- * carte n'existe que parce qu'un fichier ne peut pas être à la fois publié dans
- * ce package et généré par l'application qui l'installe.
+ * Les modules externes enregistrés dans ce processus, remplis au chargement
+ * par la glue générée. Pas de chargement à chaud : la liste est figée à la
+ * compilation.
  */
 const EXTERNAL_BY_ID = new Map<ExternalFeatureId, FeatureDescriptor>();
 
@@ -316,13 +275,10 @@ export function allFeatureDescriptors(): readonly FeatureDescriptor[] {
 }
 
 /**
- * Le descriptif d'une fonctionnalité, native ou externe.
- *
- * Lève plutôt que de rendre `undefined` : un id natif vient d'un enum fermé,
- * donc une absence est un oubli d'entrée dans ce fichier ; un id externe
- * inconnu signifie que la glue générée n'a pas tourné, pas un cas d'exécution
- * à traiter chez l'appelant. Les écrans qui veulent tolérer un module absent
- * (une tuile orpheline) passent par {@link maybeFeatureDescriptor}.
+ * Le descriptif d'une fonctionnalité, native ou externe. Lève plutôt que de
+ * rendre `undefined` : une absence est un oubli d'entrée ici, ou une glue
+ * générée qui n'a pas tourné. Pour tolérer un module absent, voir
+ * {@link maybeFeatureDescriptor}.
  */
 export function featureDescriptor(id: FeatureId): FeatureDescriptor {
     const found = maybeFeatureDescriptor(id);
@@ -341,19 +297,10 @@ export function featureLabel(id: FeatureId): string {
 }
 
 /**
- * Trois `never` méritent leur justification, parce qu'on pourrait croire le
- * contraire :
- *
- *  - **`devices`** a **déjà** son partage inter-espaces, antérieur et d'une
- *    autre nature : `device_workspaces` (migration 072) est une adhésion à part
- *    entière, pas une projection. Le mécanisme d'ici ne s'y superpose pas.
- *  - **`password`** vit toujours à l'étage gardé — c'est la promesse du coffre.
- *    Le serveur sait certes le lire quand le chiffrement par mot de passe est
- *    éteint, mais un partage dont la survie dépend d'un réglage de sécurité
- *    qu'on encourage n'est pas un partage.
- *  - **`cloudsync`** range ses contenus dans un magasin de blobs sur disque,
- *    chiffrés par la BMK et non par une clé d'espace : ce serait un autre
- *    chantier.
+ * Les trois `never` : `devices` a déjà son partage inter-espaces, d'une autre
+ * nature (`device_workspaces` est une adhésion, pas une projection) ;
+ * `password` vit toujours à l'étage gardé ; `cloudsync` range ses contenus
+ * dans un magasin de blobs chiffrés par la BMK, pas par une clé d'espace.
  */
 
 /** Les fonctionnalités dont un élément **pourrait** voyager, côté chiffrement. */
@@ -362,29 +309,14 @@ export const SHAREABLE_FEATURES: readonly WorkspaceFeatureId[] = FEATURE_REGISTR
 ).map((f) => f.id);
 
 /**
- * Celles dont la **lecture élargie est réellement branchée**.
- *
- * `shareTier` dit ce que le chiffrement autorise ; cette liste dit ce que le
- * code fait. L'écart est volontaire et temporaire : projeter suppose que le
- * listage de la fonctionnalité sache aller chercher les lignes projetées et
- * choisir le bon codec ligne par ligne. Tant que ce n'est pas fait, la case
- * cocherait et rien n'apparaîtrait de l'autre côté.
- *
- * Partagée entre client et serveur **exprès** : le serveur refuse, le client
- * n'affiche pas l'onglet. Deux listes séparées auraient donné un onglet qui ne
- * mène nulle part — précisément ce que la coquille de réglages refuse.
- *
- * Brancher une fonctionnalité de plus : `listVisible` / `findVisible` dans son
- * dépôt, le codec par ligne dans son listage, une entrée ici.
+ * Celles dont la lecture élargie est réellement branchée : `shareTier` dit ce
+ * que le chiffrement autorise, cette liste ce que le code fait. Partagée entre
+ * client et serveur : le serveur refuse, le client n'affiche pas l'onglet.
+ * Brancher une native : `listVisible` / `findVisible` dans son dépôt, le codec
+ * par ligne dans son listage, une entrée ici. Un module se déclare par son
+ * manifest (`shareTier` autre que `'never'`) et son entrée `items`.
  */
-export const SHARE_WIRED_FEATURES: readonly WorkspaceFeatureId[] = [
-    'uptime',
-    'database',
-    'deploy',
-    'git',
-    'audience',
-    'backup'
-];
+export const SHARE_WIRED_FEATURES: readonly WorkspaceFeatureId[] = ['backup'];
 
 /** Les fonctionnalités qui savent prévenir, dans l'ordre du registre. */
 export const NOTIFYING_FEATURES: readonly WorkspaceFeatureId[] = FEATURE_REGISTRY.filter(

package/src/domain/home.ts

@@ -8,20 +8,20 @@ import {
 } from './workspaceRole';
 
 /**
- * Disposition de l'accueil (par espace). La grille est composée de **sections**
- * ordonnées, chacune tenant des **tuiles** ordonnées de n'importe quels genres —
- * appareil, fonctionnalité, raccourci, dossier. Les sections sont entièrement
- * modulaires : aucune par défaut, ajoutées / retirées / réordonnées librement.
- * Leur intitulé est facultatif — sans lui, la section se rend comme un simple
- * groupe légèrement espacé, sans titre.
- *
- * Stockée en clair : métadonnée de personnalisation non sensible (comme le
- * thème), jamais de charge zero-knowledge.
+ * Disposition de l'accueil (par espace) : des sections ordonnées, chacune
+ * tenant des tuiles ordonnées de n'importe quels genres (appareil,
+ * fonctionnalité, raccourci, dossier). Aucune section par défaut ; l'intitulé
+ * est facultatif. Stockée en clair : métadonnée de personnalisation, jamais de
+ * charge zero-knowledge.
  */
 
-/** Les seize tuiles de fonctionnalités natives. */
+/**
+ * Les seize tuiles de fonctionnalités natives. Une tuile porte l'id de sa
+ * feature : la tuile Monitoring est celle de la feature `devices`, dont le
+ * module fournit la carte et la vue.
+ */
 export const nativeHomeFeatureIdSchema = z.enum([
-    'monitoring',
+    'devices',
     'sentinel',
     'weather',
     'password',
@@ -50,22 +50,15 @@ export const homeFeatureIdSchema = z.union([nativeHomeFeatureIdSchema, externalF
 export type HomeFeatureId = NativeHomeFeatureId | ExternalFeatureId;
 
 /**
- * Compact widgets that can be pinned to the top-right of the navbar. Like the
- * grid features they are individually add/remove/reorderable; the default set is
- * empty (the navbar shows none until the user adds some).
+ * Compact widgets pinned to the top-right of the navbar, individually
+ * add/remove/reorderable; the default set is empty.
  *  - `weather`  → current temperature of the primary city.
- *  - `devices`  → online / total device count.
  *  - `secrecy`  → password-encryption lock state + re-validation countdown.
- *  - `uptime`   → services up / total monitored.
  *  - `live`     → qui d'autre est dans l'espace, et où (bulles cliquables).
+ * A module's widget is declared by its manifest (`topbarWidget`) and keyed by
+ * its feature id (`homeTopbarWidgetIdSchema`).
  */
-export const nativeHomeTopbarWidgetIdSchema = z.enum([
-    'weather',
-    'devices',
-    'secrecy',
-    'uptime',
-    'live'
-]);
+export const nativeHomeTopbarWidgetIdSchema = z.enum(['weather', 'secrecy', 'live']);
 export type NativeHomeTopbarWidgetId = z.infer<typeof nativeHomeTopbarWidgetIdSchema>;
 
 /**
@@ -77,12 +70,9 @@ export const homeTopbarWidgetIdSchema = z.union([nativeHomeTopbarWidgetIdSchema,
 export type HomeTopbarWidgetId = NativeHomeTopbarWidgetId | FeatureId;
 
 /**
- * Shortcut preview type, auto-detected from the URL's domain (the user never
- * picks it manually). Each value has a server-side adapter under
- * `src/Services/shortcutTemplates/` — dedicated logic where a real source exists
- * (GitHub API, YouTube/Spotify/SoundCloud/TikTok oEmbed, Wikipedia REST, npm
- * registry), and the generic Open Graph + favicon adapter for the rest. `link`
- * is that generic adapter; unknown domains fall back to it.
+ * Shortcut preview type, auto-detected from the URL's domain. Each value has a
+ * server-side adapter under `src/Services/shortcutTemplates/`; `link` is the
+ * generic Open Graph + favicon adapter, and unknown domains fall back to it.
  */
 export const shortcutTemplateSchema = z.enum([
     'link',
@@ -125,38 +115,19 @@ export const shortcutItemSchema = z.object({
 export type ShortcutItem = z.infer<typeof shortcutItemSchema>;
 
 /**
- * Combien de tuiles tient une section, et combien de fonctionnalités tient un
- * dossier.
- *
- * Exporté, et pas seulement écrit dans le schéma : le client doit refuser
- * **avant** d'écrire. Une disposition qui dépasse le plafond ne passe plus la
- * validation, donc le serveur la rejette et le client la relit vide au
- * démarrage suivant, ce qui revient à un accueil effacé sans un mot. Le
- * plafond des dossiers n'est atteignable par aucun geste (il y a moins de
- * fonctionnalités que ça, et aucune ne peut être rangée deux fois), celui des
- * tuiles l'est en créant des dossiers à la chaîne.
+ * Plafonds d'une section et d'un dossier. Exportés parce que le client doit
+ * refuser avant d'écrire : une disposition qui dépasse ne passe plus la
+ * validation, et le client la relirait vide au démarrage suivant.
  */
 export const HOME_SECTION_MAX_TILES = 60;
 export const HOME_FOLDER_MAX_ITEMS = 20;
 
 /**
- * Un dossier de la grille : plusieurs fonctionnalités derrière une seule tuile.
- *
- * Il vit dans une section au milieu des tuiles ordinaires, parce que c'en est
- * une : même carte, même place dans la grille, même glisser-déposer. Ce qui
- * change est ce qui se passe au clic (côté client, les cartes qu'il tient se
- * déploient par-dessus l'accueil).
- *
- * Il ne range que des **fonctionnalités**, là où une section range tout : une
- * carte d'appareil et un raccourci sont déjà des tuiles courtes, les empiler
- * derrière une tuile de pleine hauteur coûterait plus de place qu'il n'en
- * gagnerait. C'est la seule asymétrie qui reste après l'unification, et elle
- * est de mise en page, pas de modèle.
- *
- * Les fonctionnalités qu'il tient comptent comme **posées sur l'accueil** : le
- * sélecteur d'ajout les exclut, exactement comme celles qui ont leur propre
- * tuile. Une fonctionnalité n'est donc jamais à deux endroits à la fois, et la
- * règle « pas deux fois la même » reste une seule règle.
+ * Un dossier de la grille : plusieurs fonctionnalités derrière une seule tuile,
+ * posée dans une section comme une tuile ordinaire. Il ne range que des
+ * fonctionnalités (les autres tuiles sont déjà courtes), et celles qu'il tient
+ * comptent comme posées sur l'accueil : une fonctionnalité n'est jamais à deux
+ * endroits à la fois.
  */
 export const homeFolderSchema = z.object({
     /** Discriminant : c'est lui qui distingue un dossier d'un raccourci. */
@@ -170,28 +141,11 @@ export const homeFolderSchema = z.object({
 export type HomeFolder = z.infer<typeof homeFolderSchema>;
 
 /**
- * Une tuile de l'accueil — appareil, fonctionnalité, raccourci ou dossier.
- *
- * ## Un seul genre de section, donc un seul genre de tuile
- *
- * Les sections étaient auparavant typées (« appareils », « fonctionnalités »,
- * « raccourcis ») et ne tenaient qu'une sorte de tuile. Ça obligeait à choisir
- * le genre **avant** d'avoir quelque chose à poser, à ouvrir une popup pour
- * ajouter une section, et à trois sélecteurs d'ajout différents. Une section
- * n'est plus qu'une rangée de tuiles ; c'est la tuile qui sait ce qu'elle est.
- *
- * ## Chaque tuile garde l'écriture qu'elle avait
- *
- * Un appareil et une fonctionnalité **sont** leur identifiant (l'entité vit
- * ailleurs) ; un raccourci et un dossier portent l'objet lui-même, parce que
- * rien d'autre ne les décrit. Les deux familles d'identifiants ne peuvent pas
- * se confondre — les fonctionnalités forment un enum fermé, les appareils sont
- * des UUID — et c'est {@link homeTileKind} qui tranche, en un seul endroit.
- *
- * Conséquence utile : les dispositions écrites avant l'unification restent
- * valides telles quelles. Leurs sections portent encore un champ `kind`, qui
- * tombe à la lecture comme n'importe quelle clé inconnue, et la première
- * écriture le fait disparaître. Rien à migrer, rien à rattraper au chargement.
+ * Une tuile de l'accueil : appareil, fonctionnalité, raccourci ou dossier. Un
+ * appareil et une fonctionnalité SONT leur identifiant ; un raccourci et un
+ * dossier portent l'objet. Les deux familles d'identifiants ne se confondent
+ * pas (enum fermé contre UUID), et {@link homeTileKind} tranche en un seul
+ * endroit.
  */
 export const homeTileSchema = z.union([
     homeFolderSchema,
@@ -212,11 +166,8 @@ export type HomeTileKind = 'device' | 'feature' | 'shortcut' | 'folder';
 export const HOME_FEATURE_IDS = nativeHomeFeatureIdSchema.options;
 
 /**
- * Le genre d'une tuile.
- *
- * **Le seul endroit qui connaisse la forme de l'union** : tout le reste passe
- * par lui ou par les gardes ci-dessous, donc changer la représentation ne se
- * paye qu'ici.
+ * Le genre d'une tuile. Le seul endroit qui connaisse la forme de l'union :
+ * changer la représentation ne se paye qu'ici.
  */
 export function homeTileKind(tile: HomeTile): HomeTileKind {
     if (typeof tile !== 'string') return 'kind' in tile ? 'folder' : 'shortcut';
@@ -254,31 +205,19 @@ const sectionBase = {
     id: z.string().min(1).max(64),
     /** User-chosen heading; absent → the section renders untitled on the home. */
     title: z.string().max(40).optional(),
-    /**
-     * The section can be folded away from the home.
-     *
-     * Absent (the default) → it always shows, and there is nothing to click:
-     * a chevron on a section nobody wants to fold is one more thing to ignore.
-     */
+    /** The section can be folded away. Absent = always shown, no chevron. */
     collapsible: z.boolean().optional(),
     /**
-     * It starts folded.
-     *
-     * Only meaningful alongside `collapsible` — a section that cannot be
-     * unfolded but starts folded would simply be invisible. The home enforces
-     * that pairing rather than trusting the flag on its own.
+     * Starts folded. Only meaningful alongside `collapsible`; the home enforces
+     * the pairing rather than trusting the flag on its own.
      */
     collapsed: z.boolean().optional()
 };
 
 /**
- * Une section : une rangée ordonnée de tuiles, de n'importe quels genres.
- *
- * Elle ne se distingue plus par ce qu'elle tient — un appareil, une
- * fonctionnalité et un raccourci cohabitent dans la même — mais par son seul
- * `id`. Une ligne peut donc mêler une carte de pleine hauteur et des cartes
- * courtes : c'est assumé, la grille aligne les hauts et laisse les cartes
- * courtes à leur taille.
+ * Une section : une rangée ordonnée de tuiles de n'importe quels genres,
+ * distinguée par son seul `id`. Une ligne peut mêler une carte de pleine
+ * hauteur et des cartes courtes.
  */
 export const homeSectionSchema = z.object({
     ...sectionBase,