@nocode-factory/sanity-kit 2.59.0 → 2.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,1961 @@
1
+ # Journal des versions
2
+
3
+ ## 2.61.0 : édition sur place partout (valeurs héritées de toute forme, paragraphes, contrôle automatique)
4
+
5
+ ### Corrigé
6
+
7
+ - **Textes et images hérités des valeurs par défaut, quelle que soit la forme de la liste**
8
+ (cartes avec image ou lien, photos, frise, texte riche, objets) : chaque texte et chaque
9
+ image vise son élément exact. À la première modification, la valeur BRUTE des valeurs
10
+ par défaut (relue dans leur document, jamais la version projetée par la requête du
11
+ site) est recopiée dans la page, comme « Edit default items ». Avant, une liste dont la
12
+ requête ajoutait un champ vide (ex. cartes Engagements) ou qui contenait une image
13
+ n'était pas modifiable sur place.
14
+ - **Remplacer une image d'une liste héritée** : le Studio recopie d'abord la liste par
15
+ défaut dans la page, puis remplace l'image, en un seul enregistrement.
16
+ - **Texte en plusieurs paragraphes** : un clic sur n'importe quel paragraphe ouvre le
17
+ texte entier (avant : seulement le dernier).
18
+ - **Interrupteur « Edit mode / Browse mode »** du kit : en bas à droite.
19
+
20
+ ### Ajouté
21
+
22
+ - **Contrôle automatique de la page** (aperçu, mode édition) : pastille « N à vérifier »
23
+ quand une image du CMS ne peut pas être remplacée ou qu'un texte reste rattaché à une
24
+ liste entière ; un clic entoure ces éléments en rouge. Rien n'est affiché quand tout
25
+ est modifiable.
26
+
27
+ ### À brancher dans le projet
28
+
29
+ - **Libellés** `auditIssues` (« {n} à vérifier ») et `auditHelp` dans les libellés
30
+ `previewEditing` du projet (sinon en anglais). Rien d'autre.
31
+
32
+ ## 2.60.0 : mise à jour guidée, rubrique « À brancher dans le projet »
33
+
34
+ ### Ajouté
35
+
36
+ - **`npx -y @nocode-factory/sanity-kit@latest upgrade`** (ou `npx ncf-kit upgrade` une
37
+ fois en 2.60) : LA commande de mise à jour du kit (à la place d'un
38
+ `npm install` nu, qui n'affiche rien). Installe la dernière version dans `studio/` et
39
+ `web/`, affiche pour toutes les versions sautées ce qu'il faut brancher dans le projet,
40
+ puis lance `doctor --offline`.
41
+ - **Rubrique « À brancher dans le projet »** dans chaque version du journal (rétablie
42
+ depuis la 2.53), lue par `upgrade`. Le journal est livré dans le paquet.
43
+ - **`npm run deploy` (check-deploy)** : affiche aussi les branchements manquants
44
+ (`doctor --offline`, ⚠ et ✖), au passage obligé pour qu'une version arrive en ligne.
45
+ Informatif ; `--skip-doctor` pour le sauter.
46
+ - **CI des PR du kit** : une nouvelle version doit avoir son entrée dans le journal, avec
47
+ sa rubrique « À brancher dans le projet » (« Rien. » si rien), sinon CI rouge.
48
+ - **`doctor` : édition sur place non branchée** (⚠, avec les fichiers du starter à
49
+ reprendre) : le contrôle qui manquait depuis la 2.58.
50
+
51
+ ### À brancher dans le projet
52
+
53
+ - **`CLAUDE.md` du projet** : remplacer « `npm install @nocode-factory/sanity-kit@latest`
54
+ dans web/ et studio/ » par « `npx -y @nocode-factory/sanity-kit@latest upgrade` depuis studio/ » (voir le
55
+ starter ; cette forme marche aussi depuis un kit sans la commande).
56
+
57
+ ## 2.59.0 : publication automatique, menu « + » multilingue, pages réordonnables en dossiers
58
+
59
+ ### Ajouté
60
+
61
+ - **Publication automatique** : une PR fusionnée dans `main` dont la version n'existe pas
62
+ encore sur npm est construite, testée, publiée et étiquetée `v<version>` toute seule
63
+ (workflow « Publier »). Plus d'étiquette à poser à la main (la 2.55.0 et la 2.57.0,
64
+ fusionnées sans étiquette, n'avaient jamais été publiées).
65
+ - **CI des PR : version montée ?** Si le code du kit change sans montée de version (ou
66
+ avec une version déjà publiée, ou `src/version.ts` non aligné), la CI passe au rouge
67
+ avec la marche à suivre.
68
+ - **Presentation : dossiers par collection** dans la liste des pages (accueil et pages à
69
+ la racine, un dossier repliable par collection à pages, nom = `section` du registre).
70
+ Les pages se **réordonnent par glisser-déposer** dans leur groupe.
71
+ - **`doctor` : vue tableur des collections non branchée** (⚠, avec le branchement du
72
+ starter) : une mise à jour du kit ne l'apporte pas à un projet créé avant.
73
+ - **`npm run deploy` (check-deploy) : alerte éléments de liste sans `_type`** avant le
74
+ déploiement du Studio. Alerte seulement, jamais de correction automatique pendant un
75
+ déploiement (`npx ncf-kit item-types --apply` reste un geste volontaire ;
76
+ `--skip-data` pour sauter le contrôle).
77
+
78
+ ### Corrigé
79
+
80
+ - **Menu « + » en multilingue** : « + Article » créait un document SANS langue
81
+ (document-internationalization ne pose la langue que dans « + Français Article » /
82
+ « + English Article »), invisible du site. La base crée désormais dans la langue
83
+ principale ; son doublon « + Français Article » et le template paramétré sont
84
+ retirés du menu. Les autres langues restent (« + English Article »).
85
+
86
+ ### À brancher dans le projet
87
+
88
+ - **Liste de pages Presentation codée dans le projet** (ex. dossiers par collection) :
89
+ la remplacer par celle du kit, `presentationTool({components: ncfPresentationComponents(ncfOptions)})`,
90
+ et transmettre `siteRoutes` (avec `collections[].section`) à `ncfKit` pour nommer les
91
+ dossiers. Sinon, rien à brancher.
92
+
93
+ ## 2.58.0 : édition sur place dans l'aperçu, éléments de liste typés
94
+
95
+ ### Ajouté
96
+
97
+ - **Édition sur place dans Presentation** (`@nocode-factory/sanity-kit/web/editing` et
98
+ `/web/edit`, voir le README) : texte modifié à sa place exacte (champs chaîne, lignes et
99
+ passages en italique des titres en texte riche, textes et listes HÉRITÉS des valeurs par
100
+ défaut, recopiés dans la page au premier enregistrement), « Replace this image » sur
101
+ toute image (sans alt, sous un dégradé ou un titre en plein cadre), interrupteur
102
+ **Edit mode / Browse mode** (en visite, un clic suit les liens). Enregistré dans le
103
+ brouillon, jamais publié. Validé sur Société Paul Ricard.
104
+ - **Pont Studio** monté par le plugin : la demande de l'aperçu ouvre la médiathèque en
105
+ quasi plein écran ; origines limitées aux environnements du kit.
106
+ - **`npx ncf-kit item-types [--apply]`** : éléments de liste sans `_type` (écrits par
107
+ script, ils font planter le formulaire du Studio) listés, puis corrigés par patch
108
+ ciblé verrouillé sur la révision. Vérifié par `doctor`.
109
+
110
+ ### Modifié
111
+
112
+ - **Sélecteur « NCF Médias » d'un champ** : vignettes en masonry dans leurs vraies
113
+ proportions, comme l'onglet Assets (plus de recadrage 4:3).
114
+
115
+ ### Dépendances
116
+
117
+ - `@sanity/visual-editing` (≥ 6.1) et `@sanity/mutate` (≥ 0.18) : pairs FACULTATIFS,
118
+ requis seulement par `/web/edit` et `/web/editing` (fournis par next-sanity). `/web`
119
+ et `/web/defaults` n'en dépendent pas : rien ne change pour un projet qui ne
120
+ branche pas l'édition sur place. Un projet qui la branche les déclare dans
121
+ `web/package.json` (même version que next-sanity, puis `npm dedupe`) ; `doctor`
122
+ signale une copie en double (l'éditeur enregistrerait dans le vide).
123
+ ### À brancher dans le projet
124
+
125
+ - **Édition sur place** (facultative mais attendue) : reprendre du starter (PR #94)
126
+ `web/components/PreviewEditing.tsx`, `web/sanity/fetch.ts` (`annotateImageEditTargets`),
127
+ `web/components/sections/index.tsx` (`withPreviewEditTargets`, `rekeyOwnImageTargets`,
128
+ `inheritedEditScriptProps`), `web/components/SanityImage.tsx` (`imageEditAttributes`,
129
+ `imageAlt`) et les libellés `previewEditing` ; déclarer `@sanity/visual-editing` et
130
+ `@sanity/mutate` dans `web/package.json` puis `npm dedupe` (une seule copie).
131
+ - **CI du site** : étape `npx ncf-kit item-types` (éléments de liste sans `_type`).
132
+
133
+ ## 2.57.0 : table de collection — vue liste native et design soigné
134
+
135
+ ### Modifié
136
+
137
+ - **Vue Liste façon Sanity** : le switch Liste/Table affiche désormais une vraie
138
+ liste native (vignette du type, titre, chemin, pastille de statut
139
+ publié/brouillon) au lieu de lignes trop compactes.
140
+ - **Design de la table soigné** : texte plus lisible, icône du type dans la
141
+ première colonne, en-tête plus net, nombres alignés à droite.
142
+
143
+ ### Retiré
144
+
145
+ - **Filtre par colonne** (champ de saisie sous chaque en-tête) : redondant avec
146
+ la recherche globale, il est supprimé.
147
+
148
+ ### À brancher dans le projet
149
+
150
+ - Rien de plus que la 2.54 (vue tableur).
151
+
152
+ ## 2.56.0 : table de collection : switch Liste / Table, colonnes manipulables, volet enfant
153
+
154
+ ### Ajouté
155
+
156
+ - **Switch Liste / Table**, colonnes **redimensionnables et déplaçables**, clic sur une
157
+ ligne = document en **volet enfant** (les volets précédents se réduisent).
158
+
159
+ ### À brancher dans le projet
160
+
161
+ - Rien de plus que la 2.54 (vue tableur).
162
+
163
+ ## 2.55.0 : table de collection au niveau feuille (filtre, création contextuelle)
164
+
165
+ ### Ajouté
166
+
167
+ - `ncfCollectionTable` accepte `filter` / `params` (ex. `language == $lang`), `id` et
168
+ `newTemplate` (bouton « New » qui crée dans la bonne langue).
169
+
170
+ ### À brancher dans le projet
171
+
172
+ - **Projet multilingue** : une table par langue, avec `filter: 'language == $lang'` et
173
+ `newTemplate` au modèle de la langue, ex. `article-en` (voir `byLanguage(..., true)` du starter).
174
+
175
+ ## 2.54.0 : vue table des collections (façon Airtable)
176
+
177
+ ### Ajouté
178
+
179
+ - **Vue tableur** d'une collection dans Structure : une colonne par champ, tri, recherche,
180
+ colonnes ajoutables ou masquées, export CSV ; clic sur une ligne = le document.
181
+
182
+ ### À brancher dans le projet
183
+
184
+ - **Vue tableur** : elle se branche dans la STRUCTURE du Studio du projet (le kit ne peut
185
+ pas modifier une structure écrite par le projet). Sur chaque collection (pas les pages) :
186
+ `.child(ncfCollectionTable(S, ncfOptions, type, {id, title}))`, ou
187
+ `...ncfCollections(S, context, ncfOptions)` pour la découverte automatique. Modèle :
188
+ `collectionTable` et `byLanguage(..., asTable)` de `studio/sanity.config.ts` du starter.
189
+ `doctor` le vérifie depuis la 2.59.
190
+
191
+ ## 2.53.0 : assets au vrai ratio et suppression, pages réordonnables, menu monolingue
192
+
193
+ ### Ajouté
194
+
195
+ - **Assets** : vignettes au vrai ratio, **suppression d'un média** avec la liste des pages
196
+ où il deviendra vide.
197
+ - **Pages réordonnables** par glisser-déposer dans la liste de Presentation (ordre repris
198
+ par l'onglet Pages).
199
+ - **Menu « + » monolingue** : le doublon « + Français Article » est masqué.
200
+
201
+ ### À brancher dans le projet
202
+
203
+ - **Réordonnancement** : la liste de Presentation doit être celle du kit,
204
+ `presentationTool({components: ncfPresentationComponents(ncfOptions)})`. Une liste codée
205
+ dans le projet ne l'a pas.
206
+
207
+ ## 2.52.0 : import d'assets et dossiers dans le sélecteur
208
+
209
+ ### Ajouté
210
+
211
+ - **Importer des médias depuis l'onglet Assets** : bouton « Importer » et
212
+ **glisser-déposer** sur le panneau. Les fichiers déposés dans un dossier
213
+ ouvert y sont rangés automatiquement.
214
+ - **Source d'asset « NCF Médias »** : le sélecteur d'un champ image ou fichier
215
+ affiche désormais **les mêmes dossiers et la même recherche** que l'onglet
216
+ Assets. Choisir un média se fait donc par dossier, pas seulement le gérer.
217
+ Proposée en premier ; la source par défaut de Sanity reste disponible.
218
+ (Désactivable avec le reste via `tools: {assets: false}`.)
219
+
220
+ ## 2.51.1 : correctif crash à la création d'un groupe de composants
221
+
222
+ ### Corrigé
223
+
224
+ - **Saisir le nom d'un nouveau groupe (ou renommer un groupe) faisait planter le
225
+ Studio** (« Cannot read properties of null (reading 'value') »). La valeur du
226
+ champ était lue dans la fonction de mise à jour d'état, où `currentTarget` vaut
227
+ déjà `null` ; elle est maintenant capturée pendant l'événement.
228
+
229
+ ## 2.51.0 : composants groupables et renommables
230
+
231
+ ### Ajouté
232
+
233
+ - **Onglet Composants : regroupement par groupe** (bouton « By group ») :
234
+ créer / renommer / supprimer des groupes, ranger un composant dans un groupe
235
+ (supprimer un groupe ne supprime pas les composants : ils repassent « Sans
236
+ groupe »).
237
+ - **Renommer un composant** : chaque composant reçoit un nom marketing (bouton
238
+ crayon sur sa carte). Ce nom **remplace le titre partout** : onglet Composants,
239
+ vue Map, et **menu d'insertion du page builder** (là où le marketing choisit
240
+ une section). Le type technique reste inchangé (miniatures, positions du board,
241
+ comptage d'occurrences continuent de fonctionner).
242
+ - Stockage dans un document propre au kit (`ncfComponentMeta`), injecté par le
243
+ plugin comme le board — zéro config côté projet. Les composants sont désignés
244
+ par leur type, jamais par référence.
245
+
246
+ Note : le menu d'insertion « Add item » prend le nom marketing ; les lignes de
247
+ sections DÉJÀ insérées (repliées) peuvent garder le titre d'origine selon la
248
+ version de Sanity (rendu par son système d'aperçu).
249
+
250
+ ## 2.50.0 : onglet « Assets » (gestionnaire de médias)
251
+
252
+ ### Ajouté
253
+
254
+ - **Nouvel onglet « Assets »** : voir et gérer TOUS les médias (images et
255
+ fichiers) du projet au même endroit, pas seulement au clic sur un champ image.
256
+ - **Dossiers** : ranger les médias dans des dossiers (un seul emplacement par
257
+ média), créer / renommer / supprimer. Supprimer un dossier ne supprime pas
258
+ les médias (ils redeviennent « Non classés »).
259
+ - **Recherche, tri et filtres** : par nom, type (image/fichier), usage
260
+ (utilisé / inutilisé), tri par date / nom / taille / type.
261
+ - **Vue grille** (vignettes) ou **vue table** (tri par colonne).
262
+ - **Détail** : aperçu, métadonnées, édition du titre / texte alternatif /
263
+ description (écrits directement sur l'asset), copier l'URL, ouvrir le
264
+ fichier, déplacer vers un dossier. Sélection multiple pour déplacer en lot.
265
+ - **Live** : la liste suit les ajouts et suppressions d'assets.
266
+ - **Compatible avec tous les projets, zéro configuration** : les dossiers sont
267
+ stockés dans un document propre au kit (`ncfAssetMeta`), injecté par le plugin
268
+ comme le board, sans rien déclarer côté projet. Les assets sont désignés par
269
+ leur id, jamais par référence (supprimer un média ne casse pas l'organisation).
270
+ - Activé par défaut ; désactivable via `tools: {assets: false}`.
271
+ - API publique : `useAssets`, `useAssetMeta`, `AssetsTool`, et les utilitaires
272
+ purs `formatBytes`, `thumbnailUrl`, `filterAssets`, `sortAssets`, etc.
273
+
274
+ ## 2.49.1 : champ JSON-LD robuste hors outil + page builder auto-détecté
275
+
276
+ ### Corrigé
277
+
278
+ - **Garde-fou formulaire** : un champ du kit rendu hors d'un outil (donc hors
279
+ `KitProvider`) ne plante plus le formulaire. Nouveau `useOptionalKitContext()`
280
+ / `useOptionalKitConfig()` (renvoient `null` au lieu de lever) ; `JsonLdInput`
281
+ se replie sur le rendu par défaut au lieu de « useKitContext must be called
282
+ inside a tool ». (Le `KitProvider` posé sur les champs du formulaire, lui, date
283
+ de 2.48.2 ; ceci est la ceinture de sécurité.)
284
+ - **`pageBuilderField` : plus de défaut silencieux.** Le champ des sections est
285
+ **auto-détecté** quand celui configuré ne convient pas (champ tableau dont les
286
+ membres sont les sections déclarées par `defineComponentDefaults`) : l'onglet
287
+ Composants trouve les sections même si elles sont dans un autre champ (ex.
288
+ `pageBuilder`), et le nombre de blocs de l'onglet Pages compte sur le bon
289
+ champ. Si aucun champ de sections n'existe, les onglets Pages et Composants
290
+ affichent une **erreur bloquante** (« passer `pageBuilderField: '<nom>'` »),
291
+ et `ncf-kit doctor` le signale.
292
+ - Nouveaux utilitaires publics : `resolvePageBuilderField`,
293
+ `detectPageBuilderField`, `sectionNamesFromDefaults`, hook `usePageBuilder`.
294
+
295
+ ## 2.49.0 : JSON-LD réglé et visible au même endroit
296
+
297
+ - Option `fallback` de `defineJsonLdType` : JSON-LD que le site sert quand rien n'est
298
+ stocké (calculé par le projet depuis les champs). Le champ l'affiche : on voit au
299
+ même endroit que le réglage (Auto / Manuel, bouton IA) ce que le site publie
300
+ aujourd'hui, et que l'IA le remplacera à la prochaine publication (mode Auto).
301
+
302
+ ## 2.48.2 : champ JSON-LD utilisable dans le formulaire
303
+
304
+ - Le champ « Données structurées » plantait dans le formulaire (« useKitContext must
305
+ be called inside a tool ») : la configuration du kit est maintenant fournie à tous
306
+ les champs du formulaire, comme aux outils.
307
+
308
+ ## 2.48.1 : champ JSON-LD rangé dans l'onglet SEO
309
+
310
+ - Le champ « Données structurées » (`jsonLd`, modes auto / manuel et bouton « Rédiger
311
+ avec l'IA ») est rangé dans l'onglet SEO du formulaire (withNcfFormTabs). Il
312
+ tombait en bas de l'onglet Content (nom attendu en minuscules).
313
+
314
+ ## 2.48.0 — JSON-LD généré par IA (auto / manuel)
315
+
316
+ ### Ajouté
317
+
318
+ - **`defineJsonLdType()`** (`@nocode-factory/sanity-kit/jsonld`) : un champ
319
+ « Données structurées (JSON-LD) » à poser sur les pages, avec deux modes.
320
+ - **Auto** (défaut) : le JSON-LD est régénéré par l'IA **à chaque
321
+ publication**, à partir du contenu de la page. Lecture seule.
322
+ - **Manuel** : le bouton « Rédiger avec l'IA » propose un JSON-LD une fois,
323
+ puis la publication n'y touche plus ; on l'édite à la main.
324
+ - Bouton de (re)génération dans les deux modes.
325
+ - L'IA passe par le **même service que la traduction** (Edge Function du kit,
326
+ clé Anthropic côté serveur) : le projet ne fournit que sa clé
327
+ `history.projectKey`. Nouvelle option `jsonLd: {enabled, field}` dans la config
328
+ du plugin (active le bouton et la régénération au publish).
329
+ - Helpers exportés : `generateJsonLd`, `collectDocumentText`,
330
+ `guessDocumentTitle`.
331
+
332
+ ## 2.47.1 — Code embed : entrée de schéma dédiée
333
+
334
+ ### Corrigé
335
+
336
+ - **`defineCodeEmbedType` s'importe depuis `@nocode-factory/sanity-kit/code-embed`**,
337
+ une entrée séparée de l'entrée principale. Celle-ci embarque le tableau et le
338
+ cerveau (React Flow et sa feuille de style `.css`) : l'importer depuis un
339
+ fichier de schéma cassait les scripts Node (`sanity exec`, génération des
340
+ options, build du site) avec `ERR_UNKNOWN_FILE_EXTENSION ".css"`. La nouvelle
341
+ entrée ne contient que l'éditeur de code et son type.
342
+
343
+ ## 2.47.0 — bloc « Code embed »
344
+
345
+ ### Ajouté
346
+
347
+ - **`defineCodeEmbedType()`** : un type d'objet « Code embed » prêt à poser
348
+ partout où un objet est accepté (section de page, article, texte riche).
349
+ HTML, CSS et JS libres, édités dans une interface sombre à coloration
350
+ syntaxique (CodeMirror). Le marketing colle son code et voit le rendu sans
351
+ publier.
352
+ - **Aperçu live dans le Studio** : le formulaire rend le bloc dans la même
353
+ iframe **sandboxée** que le site (`NcfCodeEmbed`, exporté depuis
354
+ `@nocode-factory/sanity-kit/web`). Le JS reste actif mais tourne dans une
355
+ origine isolée (pas d'accès aux cookies ni au stockage du site) ; la hauteur
356
+ s'ajuste automatiquement au contenu.
357
+
358
+ ## 2.46.1 — textes d'aide plus discrets
359
+
360
+ ### Changé
361
+
362
+ - **Les textes d'aide (descriptions de champ) sont plus petits, plus gris et
363
+ en italique**, pour renforcer la hiérarchie : le libellé prime, l'aide se lit
364
+ comme une note. Surcharge globale sur `[id^="desc_"]`, l'identifiant stable
365
+ que Sanity pose sur chaque description.
366
+
367
+ ## 2.46.0 — valeurs par défaut pré-sélectionnées
368
+
369
+ ### Changé
370
+
371
+ - **Un champ à choix (liste) ou une case à cocher qui hérite affiche sa valeur
372
+ par défaut pré-sélectionnée**, au lieu d'un contrôle vide doublé d'une
373
+ mention « Component default value ». L'éditeur voit ce qui s'appliquera :
374
+ position d'image, fond de section, style et taille de bouton, niveau de
375
+ titre…
376
+
377
+ La valeur n'est pas écrite — le champ reste hérité. Choisir autre chose
378
+ l'emporte et fait apparaître la pastille de réinitialisation, comme avant.
379
+ Le texte libre garde son placeholder grisé ; objets, listes et images gardent
380
+ leur mention (rien à « sélectionner »).
381
+
382
+ ## 2.45.1 — le lanceur ouvre la page active, pas l'accueil
383
+
384
+ ### Corrigé
385
+
386
+ - **« Prévisualiser » ouvrait toujours l'accueil.** Le lanceur de la barre
387
+ ignorait la page affichée dans Presentation et retombait sur la racine du
388
+ site. Il rouvre désormais la **page actuellement prévisualisée** — dans le
389
+ Studio comme en ligne (↗) — en lisant son chemin dans le paramètre `preview`
390
+ de l'URL du Studio, puis en l'appliquant à l'environnement choisi.
391
+
392
+ ## 2.45.0 : champs propres à l'instance (options.instanceOnly)
393
+
394
+ - Un champ de section marqué `options: {instanceOnly: true}` (ex. l'ancre d'une
395
+ section) n'a pas de valeur par défaut de composant (absent des réglages du
396
+ composant), n'affiche pas de pastille d'héritage, et la propagation le recopie tel
397
+ quel dans les autres langues (jamais traduit).
398
+
399
+ ## 2.44.2 : aperçu (Presentation) des types qui partagent un dossier
400
+
401
+ - Types dont les pages partagent un même dossier (ex. Page et Legal page à la
402
+ racine) : une seule route Presentation qui cherche dans tous ces types. Avant, la
403
+ première route (Page) gagnait toujours et l'aperçu d'une page légale ne retrouvait
404
+ pas son document.
405
+
406
+ ## 2.44.1 : aperçu (Presentation) des pages à slug sur plusieurs niveaux
407
+
408
+ - Les routes de Presentation des collections utilisent `:slug+` : une page dont le
409
+ slug a plusieurs niveaux (« telecom/projets » -> /telecom/projets,
410
+ /en/telecom/projects) est retrouvée dans l'aperçu ($slug = slug complet). Ordre
411
+ inchangé : langues préfixées, puis dossiers de collections, la racine en dernier.
412
+
413
+ ## 2.44.0 : redirections rangées par famille, publication refusée en cas de conflit
414
+
415
+ - `redirectsStructure(S, {icon})` (`@nocode-factory/sanity-kit/schema`) : entrée
416
+ « Redirects » du Studio en sous-dossiers : Manual (création), Slug changes
417
+ (automatic), Languages (automatic), All redirects. Famille déduite de
418
+ l'identifiant (`redirect-translation-…`, `redirect-auto-…`) : rien à migrer.
419
+ - `redirectConflicts({siteRoutes, i18n})` : validations des champs `from` / `to`
420
+ qui BLOQUENT la publication d'une redirection en conflit : départ déjà redirigé,
421
+ départ = adresse d'une page en ligne (dossier et slug de sa langue), destination
422
+ elle-même redirigée (viser l'adresse finale, indiquée), boucle, destination = départ.
423
+ - `ncf-kit doctor` : signale un projet qui n'utilise pas ces deux règles ; corrige
424
+ un faux positif sur la référence faible des liens (le sélecteur des liens, pas le
425
+ premier sélecteur trouvé).
426
+
427
+ ## 2.43.0 : alerte URL non finales dans l'onglet Pages
428
+
429
+ - Bandeau en haut de l'onglet Pages quand le site (route /api/url-check du
430
+ starter) trouve une page de sa sitemap en 301 / 308 / 404, ou une redirection du
431
+ Studio qui fait deux sauts / mène à une 404 ; détail et « Check again ». Rien si
432
+ tout est bon ou si le site n'a pas ce contrôle.
433
+ - `ncf-kit doctor` : signale un projet sans /api/url-check.
434
+
435
+ ## 2.42.1 : contrôle avant déploiement du Studio, titre et aperçu
436
+
437
+ - `ncf-kit check-deploy` (lancé par `npm run deploy`) bloque si le `studio/.env` du
438
+ poste donnerait un autre nom au Studio que celui enregistré chez Sanity, ou s'il
439
+ n'a pas les adresses d'aperçu (site et préproduction) : sinon le Studio déployé
440
+ change de nom ou refuse l'aperçu de la préproduction (« Blocked preview URL »).
441
+
442
+ ## 2.42.0 : URL finales partout dans le kit
443
+
444
+ - Toute adresse affichée par le kit (onglet Pages, board, liste des pages de
445
+ Presentation, adresse sous le slug) est l'URL FINALE, celle qui répond 200 :
446
+ - document d'une page codée : son adresse réelle (option `siteRoutes` : le
447
+ registre du site), dans le dossier de sa langue ;
448
+ - fiche : dossier et slug de sa langue ;
449
+ - adresse qui est le départ d'une redirection du Studio (`redirectType`, défaut
450
+ 'redirect') : sa destination, chaîne suivie.
451
+ - `ncf-kit doctor` : ✖ si le registre a des pages codées et que `siteRoutes` n'est
452
+ pas transmis au kit.
453
+
454
+ ## 2.41.1 : translate-json traduit les dossiers d'adresse
455
+
456
+ - `translate-json` : les dossiers traduits du registre (`localized`) sont traduits
457
+ comme les titres, puis mis en forme d'adresse (« /actualites » -> « /news »,
458
+ minuscules, tirets, sans accents).
459
+
460
+ ## 2.41.0 : dossiers d'adresse traduits par langue
461
+
462
+ - Types de pages : `localizedPrefixes` ({fr: '/actualites', en: '/news'}), lu par
463
+ `pageTypesFromSiteRoutes` depuis la clé `localized` d'une collection du registre.
464
+ Adresse d'une page : le dossier de SA langue (`/actualites/mon-actualite`,
465
+ `/en/news/my-news`). Utilisé partout où le kit calcule une adresse : onglet
466
+ Pages, adresse sous le slug, liste des pages de Presentation, redirections des
467
+ adresses traduites, suppression.
468
+ - `ncfMainDocuments` : routes de Presentation avec le dossier de chaque langue
469
+ (collections et pages codées `localized`).
470
+
471
+ ## 2.40.0 : translate-json --from (nouveau master)
472
+
473
+ - `npx ncf-kit translate-json --from <langue>` : part d'un fichier de textes de
474
+ référence au lieu du master, et crée les textes de TOUTES les langues du projet,
475
+ master compris (nouveau projet au master allemand créé depuis le starter :
476
+ `--from fr` crée messages/de.json et les titres « de » du registre). Fonctionne
477
+ aussi sur un site monolingue.
478
+
479
+ ## 2.39.0 : master et locales, aucune langue en dur
480
+
481
+ - Plus aucune langue par défaut dans le kit : la langue master vient du projet
482
+ (`i18n.defaultLocale`, sinon la première de `i18n.locales`) ; absente sur un site
483
+ multilingue, erreur de configuration claire.
484
+ - Valeurs par défaut des composants : leur langue source est le MASTER (avant :
485
+ l'anglais dès que le site l'avait). Un projet peut garder un autre choix avec
486
+ `i18n.defaultsSourceLocale`.
487
+ - Tris alphabétiques des listes du Studio selon la langue de l'éditeur (plus le
488
+ français imposé).
489
+ - `ncf-kit doctor` : ✖ si la configuration des langues du projet (web/i18n/config.ts,
490
+ studio/i18n.ts) se rabat sur une langue écrite en dur.
491
+
492
+ ## 2.38.0 : règle d'or, adresses traduites et redirections
493
+
494
+ - Chaque version traduite d'une page ou d'une fiche à page : l'adresse « slug
495
+ d'origine dans cette langue » redirige vers son slug traduit (`/en/rouge` ->
496
+ `/en/red`), enregistrée comme une vraie redirection (visible dans « Redirects »),
497
+ une par version, mise à jour à chaque publication (slug modifié), retirée si
498
+ inutile. Créée aussi par Create / Languages. `syncTranslationRedirects` (entrée
499
+ `schema`) pour les données existantes.
500
+ - Version créée sans IA : le slug est marqué « To translate » avec le titre.
501
+ - Supprimer une page (ou fiche à page) passe toujours par la fenêtre du kit, qui
502
+ retire les redirections menant à la page supprimée.
503
+
504
+ ## 2.37.1 : règle d'or, utilisable dans les scripts
505
+
506
+ - `withSameLanguageReferences` et `fixCrossLanguageReferences` aussi exportés par
507
+ `@nocode-factory/sanity-kit/schema` (sans interface) : l'entrée principale charge
508
+ des feuilles de style, illisibles dans un script `sanity exec`.
509
+
510
+ ## 2.37.0 : règle d'or, références de la même langue
511
+
512
+ - `withSameLanguageReferences(types, ncfOptions)` : chaque champ de référence des
513
+ types du projet (champs, listes, objets, annotations du texte riche) ne propose
514
+ que des documents de la MÊME langue que le document en cours (sans langue :
515
+ toujours proposés ; document commun : langue principale), combiné avec les
516
+ filtres existants. `ncf-kit doctor` l'exige sur un projet multilingue.
517
+ - `fixCrossLanguageReferences(client, {defaultLocale, apply})` : repointe les
518
+ références croisées existantes vers la traduction de la bonne langue (publiés et
519
+ brouillons), signale celles sans équivalent.
520
+
521
+ ## 2.36.0 : supprimer ou retirer du site toutes les langues en une fois
522
+
523
+ - Supprimer la version principale d'un document traduit (page, fiche de
524
+ collection, réglage par langue) propose de supprimer aussi ses autres langues
525
+ (cochées par défaut), en une fois ; bloqué avec la liste si un autre document y
526
+ fait encore référence ; liens de traduction nettoyés.
527
+ - « Remove from site » (dépublication) : sur la version principale, propose aussi
528
+ de retirer du site les autres langues publiées (cochées). S'applique désormais
529
+ aussi aux fiches de collection traduites (à la place du « Unpublish » natif).
530
+ `createRemoveFromSite(config)` exporté.
531
+
532
+ ## 2.35.0 : propagation sur les collections
533
+
534
+ - Publier la version principale d'une fiche de collection (ou de tout type traduit
535
+ document par document) propose, comme pour les pages, de mettre à jour les autres
536
+ langues, ou de les créer à la première publication (traduction IA, textes
537
+ modifiés à la main protégés). Détecté par le champ de langue du schéma : une
538
+ nouvelle collection traduite en profite sans réglage.
539
+ - Propagation et création : les références (type, catégorie, pages liées...)
540
+ pointent la version de la langue cible, plus la version principale.
541
+
542
+ ## 2.34.0 : Presentation, aperçu sur appareil (iPhone, iPad...)
543
+
544
+ - Menu d'appareils juste à côté du bouton mobile natif de Presentation :
545
+ iPhone SE, iPhone 12 Pro (390×844), iPhone 15 Pro Max, Pixel 7, Galaxy S20, iPad
546
+ Mini, iPad Air, iPad Pro 11" et 12.9", ou pleine largeur. L'aperçu prend les
547
+ dimensions de l'appareil, affichées à côté de l'icône. Remplace le bouton Tablet.
548
+ - `react-dom` en dépendance pair (Studio et site l'ont toujours).
549
+
550
+ ## 2.33.3 : « Hide edit panel » sans effet de bord
551
+
552
+ - Le bouton ne fait plus que masquer le panneau d'édition et sa poignée ; il ne
553
+ touche plus aux largeurs gérées par Presentation (au réaffichage, le panneau
554
+ prenait toute la place).
555
+
556
+ ## 2.33.2 : liste des pages, langues en boutons
557
+
558
+ - Choix de la langue par des boutons (FR, EN...) sous la recherche : le menu
559
+ déroulant se décalait dans le panneau étroit de Presentation.
560
+
561
+ ## 2.33.1 : boutons Tablet et Hide edit panel opérants
562
+
563
+ - Les panneaux de Presentation sont trouvés par leurs identifiants stables
564
+ (`presentation-narrow-panel-preview` / `-content`) : la poignée de
565
+ redimensionnement intercalée faisait échouer la recherche, les deux boutons
566
+ n'avaient aucun effet.
567
+
568
+ ## 2.33.0 : Presentation, format tablette et panneau d'édition masquable
569
+
570
+ - `ncfPresentationComponents` ajoute à l'en-tête de l'aperçu deux boutons :
571
+ « Tablet » (aperçu à 768 px, centré ; Presentation n'a qu'ordinateur et mobile)
572
+ et « Hide edit panel » (masque le formulaire à droite, l'aperçu prend la place,
573
+ la liste des pages reste). Choix mémorisés dans le navigateur.
574
+
575
+ ## 2.32.1 : liste des pages de Presentation, langue
576
+
577
+ - Le sélecteur de langue montre toujours la langue réellement filtrée (avant que
578
+ l'aperçu ait une adresse : la langue principale, au lieu d'afficher « FR » en
579
+ listant toutes les langues). Pages sans langue toujours listées. Sélecteur élargi.
580
+
581
+ ## 2.32.0 : liste des pages dans Presentation
582
+
583
+ - `ncfPresentationComponents(ncfOptions)` pour `presentationTool({components})` :
584
+ la liste des pages du site à gauche de l'aperçu (bouton de Presentation pour
585
+ l'afficher ou la masquer). Langue de la page affichée par défaut (sélecteur),
586
+ recherche par titre ou adresse, page affichée surlignée ; un clic ouvre la page
587
+ dans l'aperçu et son document à côté. Plus besoin de repasser par Structure.
588
+ - `ncf-kit doctor` : le signale quand un projet ne l'a pas.
589
+
590
+ ## 2.31.0 : « Edit default items » sur les listes d'items
591
+
592
+ - Une liste d'items d'une section (cartes, boutons, chiffres, logos...) qui hérite
593
+ des items par défaut du composant affiche « Edit default items » : un clic
594
+ recopie les items par défaut dans l'instance, on ne modifie ensuite que ce qu'on
595
+ veut (un item, un détail), au lieu de tout recréer. Tout composant à liste
596
+ d'items en profite, y compris les nouveaux, sans réglage. La pastille bleue
597
+ remet la liste en héritage.
598
+
599
+ ## 2.30.1 : diagnostic, une vraie capture par section
600
+
601
+ - `ncf-kit doctor` : chaque section (section-options.json) a sa capture
602
+ `web/public/sections/<type>.png` ; le workflow des captures tourne chaque nuit
603
+ (valeurs par défaut du Studio) ; alerte si le Studio dessine des vignettes SVG au
604
+ lieu de montrer la vraie capture.
605
+
606
+ ## 2.30.0 : langues bordées (nouvelle langue, nouveau composant), textes édités protégés
607
+
608
+ - **Onglet Pages → Languages** : met chaque langue au niveau de la langue principale,
609
+ sur clic explicite. Documents de la langue principale sans version dans une langue
610
+ (pages, collections, réglages par langue) : créés, traduits par l'IA, publiés,
611
+ reliés. Valeurs par défaut des composants : langue source complétée depuis la
612
+ langue principale (nouveau composant), puis chaque langue depuis la source ;
613
+ document créé s'il manque ; seuls les textes vides ou restés identiques au texte
614
+ source sont traduits.
615
+ - **Textes modifiés à la main protégés** : le kit garde l'empreinte de chaque texte
616
+ écrit par l'IA. À la propagation, un texte d'une langue modifié à la main depuis
617
+ n'est pas écrasé (marqué « To translate », texte source affiché), sauf case
618
+ « Overwrite texts edited by hand » (décochée par défaut).
619
+ - **`npx ncf-kit translate-json [--apply]`** : textes du site par langue
620
+ (`web/i18n/messages/<langue>.json`, titres par langue de `site-routes.json`)
621
+ complétés par l'IA depuis la langue principale ; l'existant n'est jamais modifié.
622
+ - **`ncf-kit doctor`** : langues studio = site, un fichier de textes et un titre de
623
+ registre par langue, chaque document de la langue principale dans chaque langue,
624
+ valeurs par défaut des composants pour chaque langue.
625
+ - Identifiant des versions : `<base>-<langue>` pour un document à identifiant lisible
626
+ (singletons `homePage-de`, `componentDefaults-de`), aléatoire sinon.
627
+
628
+ ## 2.29.2 : onglets, champ toujours caché
629
+
630
+ - `withNcfFormTabs` : un champ `hidden: true` ne reçoit pas d'onglet (sinon
631
+ « Field group 'content' is not defined » quand l'onglet n'avait que lui).
632
+
633
+ ## 2.29.1 : onglets, champ du page builder par défaut `sections`
634
+
635
+ - `withNcfFormTabs` : champ du page builder par défaut `sections`, comme l'option
636
+ `pageBuilderField` de ncfKit (passer `{pageBuilderField}` s'il a un autre nom).
637
+
638
+ ## 2.29.0 : traduire et publier en un clic, versions créées avec la page
639
+
640
+ - Propagation avec « Translate with AI and publish » (coché par défaut) : textes
641
+ traduits par l'IA et chaque langue PUBLIÉE directement (plus de validation de
642
+ brouillon). Sans IA, ou si l'IA échoue : brouillons, textes « To translate ».
643
+ - Première publication d'une page dans la langue principale : « Create the other
644
+ language versions? » crée la page dans chaque langue cochée (structure,
645
+ valeurs, textes traduits, slug traduit et unique), reliée à ses traductions
646
+ (translation.metadata), publiée si l'IA traduit.
647
+ - Texte vidé dans la version principale (il suit la valeur par défaut du
648
+ composant) : vidé aussi dans la traduction, au lieu de « Source text not found ».
649
+ Sous « To translate », le texte source affiche « (empty: follows the component
650
+ default) » dans ce cas.
651
+
652
+ ## 2.28.0 : onglets du formulaire, déploiement du bon Studio, texte source sous « To translate »
653
+
654
+ - `withNcfFormTabs(types, {pageBuilderField})` (`@nocode-factory/sanity-kit/schema`) :
655
+ formulaire des documents rangé en onglets Content (par défaut), Sections, SEO,
656
+ Settings, d'après le nom des champs. Un type qui a déjà ses groupes n'est pas
657
+ touché.
658
+ - `npx ncf-kit check-deploy` : avant `sanity deploy`, vérifie que
659
+ SANITY_STUDIO_APP_ID est un Studio de CE projet et porte le nom d'hôte du .env
660
+ (sinon le déploiement écraserait le Studio d'un autre projet ; vécu). À mettre
661
+ dans `studio/package.json` : `"deploy": "ncf-kit check-deploy && sanity deploy"`.
662
+ `ncf-kit doctor` le vérifie.
663
+ - Champ « To translate » : le texte actuel de la version principale est affiché
664
+ dessous (aide à la traduction).
665
+
666
+ ## 2.27.1 : test prod / préprod indépendant de la langue du bandeau
667
+
668
+ - Le bandeau de préversion porte `data-ncf-preview-banner` ; `check-environments`
669
+ le repère par ce marqueur (et par les anciens libellés). Depuis la 2.26.0
670
+ (libellés en anglais), le test « bandeau présent en préprod » échouait et, plus
671
+ grave, « pas de bandeau en prod » passait toujours.
672
+
673
+ ## 2.27.0 : traduction par IA (« Translate with AI »)
674
+
675
+ - **Service central** : fonction `translate` du service du kit (Supabase), clé
676
+ Anthropic UNIQUE pour tous les projets, chiffrée dans le Vault (jamais dans un
677
+ Studio, un site ou un dépôt). Modèle bon marché : Claude Haiku 4.5. Accès : clé de
678
+ projet d'un projet actif (comme l'historique), plafond de caractères par projet et
679
+ par jour. Les noms de marque, URL et variables ne sont pas traduits.
680
+ - **Champ « To translate »** : bouton « Translate with AI » (traduit le texte de la
681
+ version principale dans ce champ, brouillon de la langue).
682
+ - **Publier la version principale** : la fenêtre de propagation reporte la
683
+ structure ET traduit les textes modifiés par l'IA (case « Translate changed texts
684
+ with AI », cochée par défaut ; en cas d'échec, les textes sont marqués « To
685
+ translate »). Rien n'est publié dans les autres langues. Une modification faite
686
+ dans une autre langue ne remonte jamais à la version principale.
687
+ - **Valeurs par défaut des composants** : langue source `i18n.defaultsSourceLocale`
688
+ (défaut : `en` si le site l'a). Publier celles de la langue source propose de
689
+ retraduire celles des autres langues. Sur une page d'une autre langue, un champ
690
+ qui hérite d'une valeur par défaut non traduite (vide, ou identique au texte
691
+ source) propose « Translate default with AI » (écrit dans le brouillon des valeurs
692
+ par défaut de la langue).
693
+
694
+ ## 2.26.0 : interface du kit en anglais
695
+
696
+ - Tout ce qu'un éditeur voit (Studio et bandeau de préversion du site) est en
697
+ anglais, comme le Studio Sanity : onglets (Pages, Components, History), statuts
698
+ (Published, Modified, Not published), « Remove from site », « Propagate to other
699
+ languages? », « To translate · n », filtres, historique, préversion (Staging ·
700
+ Drafts, Staging · Published, Prod · Published), dates au format en-US.
701
+ - Restent en français : le diagnostic `ncf-kit` (développeurs), la documentation,
702
+ les commentaires. Les étiquettes du board déjà enregistrées dans un projet restent
703
+ telles quelles (seuls les défauts changent).
704
+
705
+ ## 2.25.0 : bandeau de langue dans Presentation
706
+
707
+ - Panneau d'édition de Presentation : si le document édité n'est pas dans la langue
708
+ de la page affichée (aperçu EN, panneau FR), bandeau en haut du formulaire « You
709
+ are editing the FR version. The preview shows EN. » avec « Edit the EN version »
710
+ (ou « No EN version of this document yet. »). Complète `ncfMainDocuments`.
711
+
712
+ ## 2.24.0 : Presentation édite la page affichée, dans sa langue
713
+
714
+ - `ncfMainDocuments(options, {siteRoutes})` pour
715
+ `presentationTool({resolve: {mainDocuments: defineDocuments(...)}})` : une route
716
+ par adresse et par langue (accueil, pages codées du registre, collections, design
717
+ system). Changer de langue ou de page dans l'aperçu change le document du panneau
718
+ de droite. Avant : on continuait d'éditer la langue précédente.
719
+ - `ncf-kit doctor` : le signale sur un site multilingue qui ne l'a pas.
720
+ - À l'ouverture du Studio : vue « Drafts » (on édite), même si l'adresse demandait
721
+ « Published » (lien « Prod · En ligne », Studio rechargé sur cette vue).
722
+ - Vue « Published » : au survol d'un champ, « Switch to Drafts to edit » (le
723
+ formulaire y est en lecture seule, sans explication de Sanity).
724
+
725
+ ## 2.23.0 : l'aperçu suit chaque modification du Studio
726
+
727
+ - `useNcfPreviewRefresh()` (`@nocode-factory/sanity-kit/web`) : à passer à
728
+ `<VisualEditing refresh={...}/>` de next-sanity, dans un composant client. Chaque
729
+ modification faite dans le Studio rafraîchit l'aperçu de Presentation (regroupé :
730
+ une rafale de frappes = un rafraîchissement). Avant, un champ remis à sa valeur
731
+ par défaut (pastille bleue) ne s'affichait qu'après un rechargement.
732
+ - `ncf-kit doctor` : le signale quand un projet ne l'a pas.
733
+
734
+ ## 2.22.1 : pas de pastille cliquable sur un formulaire en lecture seule
735
+
736
+ - Formulaire en lecture seule (vue « Publié », version planifiée, document
737
+ verrouillé) : la pastille bleue n'est plus affichée. Son clic écrivait dans le
738
+ document et Sanity répondait « Attempted to patch a read-only document ».
739
+
740
+ ## 2.22.0 : le diagnostic dit ce dont le kit a besoin dans le projet
741
+
742
+ `npx ncf-kit doctor` signale chaque fonction du kit qui ne peut pas marcher parce
743
+ que le PROJET n'a pas ce qu'il lui faut, sous la forme « le kit a besoin de X (pour
744
+ Y) ; le projet ne l'a pas : correction ». Nouveaux contrôles :
745
+
746
+ - **Purge du cache** : route /api/revalidate en production (en ligne), webhook
747
+ Sanity vers cette route, actif (en ligne, secret jamais affiché), relais à la
748
+ préprod (PREPROD_URL).
749
+ - **Langues** : option `i18n` de ncfKit (sans elle : ni propagation, ni « À
750
+ traduire », ni filtre par langue), choix de la page sans brouillons, références
751
+ faibles, contrôle des données en CI, consignes dans CLAUDE.md.
752
+ - **Version du kit côté site** identique à celle du studio.
753
+ - **Schéma validé en CI** (`sanity schema validate`).
754
+
755
+ Un projet qui installe le kit à jour lance `doctor` : la liste dit exactement
756
+ ce qui reste à reprendre du starter.
757
+
758
+ ## 2.21.0 : « À traduire » dans la liste des pages, traduction groupée
759
+
760
+ - **Onglet Pages** : pastille « À traduire · n » (nombre de champs non traduits) à
761
+ côté du statut, et filtre « Traduction : À traduire ».
762
+ - **Publier** : la fenêtre « Propager aux autres langues ? » ne s'ouvre que s'il y a
763
+ quelque chose à propager, et se ferme seule après « Propager » (notification du
764
+ résultat). Plus de clic sur « Fermer ».
765
+ - **`npx ncf-kit translations`** (depuis studio/) : exporte tous les champs « À
766
+ traduire » en JSON (texte de la version principale et texte actuel) ;
767
+ `npx ncf-kit translations apply <fichier>` écrit les traductions remplies dans les
768
+ BROUILLONS et retire les champs de la liste. Rien n'est publié. Fait pour traduire
769
+ d'un coup depuis Claude Code, à la demande (le Studio ne traduit jamais seul).
770
+
771
+ ## 2.20.1 : le curseur ne sort plus du champ pendant la frappe
772
+
773
+ - Champ d'une section vide (qui hérite de la valeur par défaut) : à la première
774
+ lettre, il devenait « modifié » et changeait d'enveloppe (pastille bleue) ; React
775
+ le recréait et le curseur sortait du champ. Une seule structure dans tous les
776
+ états (hérite, modifié, égal au défaut), même chose pour l'adresse sous le slug
777
+ et la mention « À traduire ». Test de non-régression (`inputFocus.test.ts`).
778
+
779
+ ## 2.20.0 : propagation aux autres langues, règles des liens multilingues
780
+
781
+ - **Propagation** : publier la version PRINCIPALE (langue par défaut) d'une page qui a
782
+ des traductions ouvre « Propager aux autres langues ? ». Appliqué aux BROUILLONS des
783
+ traductions cochées : sections ajoutées (avec le texte d'origine), supprimées,
784
+ déplacées ; valeurs non textuelles recopiées (images, liens, options, nombres…).
785
+ Les textes traduits ne sont jamais écrasés : les textes modifiés sont marqués
786
+ « À traduire » (pastille sous le champ, « Marquer comme traduit »). Rien n'est publié
787
+ dans les autres langues. Fusion à trois états testée (`lib/propagate.ts`).
788
+ - **Diagnostic** (`ncf-kit doctor`, site multilingue) : vérifie les trois règles des
789
+ liens (pages reliées à leurs traductions ; choix de la page dans la langue du
790
+ document, publiées, sans création ; rendu vers la traduction dans la langue affichée).
791
+
792
+ ## 2.19.0 : « Retirer du site »
793
+
794
+ - Pages : action **« Retirer du site »** (menu des actions, à la place du « Unpublish »
795
+ natif peu visible). La version en ligne est supprimée, tout le contenu reste en
796
+ brouillon : la page disparaît du site (404, cache purgé par le webhook), on la remet
797
+ en ligne en publiant. Avant de confirmer, la liste des documents publiés qui pointent
798
+ vers elle ; une référence forte qui bloque est expliquée.
799
+ - Onglet Pages : le statut « Brouillon » devient **« Non publiée »** (jamais publiée ou
800
+ retirée du site).
801
+ - Côté projet : les liens vers une page doivent être des références faibles
802
+ (`weak: true`), sinon Sanity refuse de dépublier une page liée (voir le starter).
803
+
804
+ ## 2.18.0 : adresse sous le slug, purge de la préprod, « instance principale » retirée
805
+
806
+ - **Sous le champ Slug d'une page** (types de pages du kit) : l'adresse complète de la
807
+ page en ligne (préfixe de collection et langue compris), avec « Copier » et « Ouvrir ».
808
+ Fourni par le kit : rien à brancher dans un projet (retirer un composant maison
809
+ équivalent pour ne pas l'afficher deux fois).
810
+
811
+ - Garde de préproduction : `/api/revalidate` passe sans laissez-passer (la route se
812
+ protège par son secret). Un webhook Sanity vers la préproduction peut donc purger
813
+ son cache : une page supprimée ou dépubliée disparaît aussi de la préprod.
814
+
815
+ - Le bouton « Modifier l'instance principale » n'existe plus, nulle part (formulaire
816
+ d'une section dans Structure comme ailleurs). Les valeurs par défaut d'un composant
817
+ s'ouvrent depuis l'onglet **Composants** ; dans une section, la pastille bleue d'un
818
+ champ montre la valeur par défaut et remet le champ en héritage.
819
+
820
+ ## 2.17.2 : pas de bandeau de préversion dans le Studio
821
+
822
+ - `NcfPreviewBanner` (Préversion · Brouillons / En ligne) ne s'affiche plus quand la page
823
+ est encastrée dans le Studio (Presentation) : le Studio a sa propre bascule, et le
824
+ bandeau masquait le bas de la page. Ouverte directement, la préversion le garde.
825
+
826
+ ## 2.17.1 : Presentation ne s'ouvre plus sur la production
827
+
828
+ - Ouvrir une page depuis Pages, « Prod · En ligne » dans « Prévisualiser » ou le bouton
829
+ « Design system » (sans valeurs par défaut) chargeait la PRODUCTION dans Presentation :
830
+ pas de brouillons, pas d'édition visuelle, message « Unable to connect ». Presentation
831
+ s'ouvre désormais toujours sur la préproduction ; production choisie = préproduction
832
+ en contenu en ligne. « Voir en ligne » ouvre toujours le vrai site.
833
+ - Environnement d'aperçu par défaut : la préproduction (au lieu de la production).
834
+
835
+ ## 2.17.0 : « Annuler cette modification » dans l'Historique
836
+
837
+ - Nouveau bouton **« Annuler cette modification »** : remet les valeurs d'avant la
838
+ modification choisie, et seulement elles, dans le document actuel. Ce qui a été
839
+ modifié ensuite est conservé ; une valeur rechangée depuis n'est pas touchée et
840
+ est signalée. Section ajoutée retirée, section supprimée remise à sa place.
841
+ - L'ancien « Restaurer cet état » remettait le document ENTIER dans l'état qui a
842
+ SUIVI la modification (cliquer sur la modification fautive la remettait au lieu de
843
+ l'annuler). Il devient « Restaurer le document tel qu'après cette modification »,
844
+ avec une aide explicite.
845
+ - Les deux écrivent dans le brouillon : rien n'est en ligne avant publication.
846
+
847
+ ## 2.16.0 : filtre par langue dans Pages
848
+
849
+ - Onglet Pages : sélecteur **« Langue »** (Toutes, FR, EN…) à côté de « Grouper par »,
850
+ en liste comme en arbre. Langues proposées : celles de la config `i18n`, sinon celles
851
+ des documents ; le sélecteur n'apparaît qu'à partir de deux langues.
852
+ - Un document sans langue reste affiché quel que soit le filtre (il vaut pour toutes).
853
+
854
+ ## 2.15.0 : publication groupée retirée
855
+
856
+ - La publication groupée (2.14.x) est retirée : « Publier » redevient le bouton de Sanity.
857
+ L'option `batchPublish` n'existe plus.
858
+
859
+ ## 2.14.1 : publication groupée robuste aux pannes temps réel
860
+
861
+ - Si le service temps réel de Sanity (listen) est en panne, l'écoute de la publication
862
+ groupée ne fait plus remonter « Uncaught error » dans le Studio : elle réessaie en
863
+ arrière-plan, et la liste des brouillons est relue à l'ouverture de la fenêtre.
864
+
865
+ ## 2.14.0 : publication groupée
866
+
867
+ - **« Publier » ouvre la liste de tous les brouillons du projet**, cochés par défaut : on
868
+ publie vingt modifications d'un coup, ou on décoche ce qui n'est pas prêt. Document
869
+ ouvert en premier, puis du plus récent au plus ancien ; badge « Nouveau » / « Modifié ».
870
+ - Une seule transaction (API Actions) : tout part ou rien ne part. Un document qui
871
+ référence un contenu jamais publié peut partir avec lui.
872
+ - Publie exactement la révision affichée : si un document change pendant que la fenêtre
873
+ est ouverte, la publication est refusée avec un message clair.
874
+ - Un document en erreur de validation est grisé et ne part pas.
875
+ - Un seul brouillon (celui qu'on édite) : le bouton « Publier » de Sanity, inchangé.
876
+ - `batchPublish: false` dans la configuration du kit pour la désactiver.
877
+
878
+ ## 2.13.1 : la version affichée suit la version installée
879
+
880
+ - Le Studio annonçait « Vous exécutez la 2.11.0 » avec la 2.12 / 2.13 installée :
881
+ `KIT_VERSION` était tenue à la main. Elle est désormais recopiée de `package.json` par
882
+ `npm version`, et un test fait échouer la CI si elles divergent.
883
+
884
+ ## 2.13.0 : le test prod / préprod est livré avec le kit
885
+
886
+ - **`npx ncf-kit check-environments`** : le test bloquant prod / préprod (25 contrôles)
887
+ est désormais dans le kit, plus copié dans chaque projet. À lancer après `next build`,
888
+ depuis le dossier du site (`"postbuild": "ncf-kit check-environments"`). Il démarre le
889
+ site construit en production puis en préproduction simulées et échoue (code 1) si un
890
+ brouillon peut s'afficher en production, si la préproduction s'ouvre sans clé, ou si la
891
+ bascule brouillons / en ligne ment. Sur Vercel, l'échec annule le déploiement.
892
+ `--page <chemin>` choisit la page témoin (défaut `/design-system/options`, sinon `/`).
893
+ - **`ncf-kit doctor`** vérifie que le build lance ce test, que la route d'activation passe
894
+ par `ncfEnableDraftMode` et que le layout porte `<meta name="ncf-data">`.
895
+
896
+ ## 2.12.0 : préprod, l'adresse affichée se partage telle quelle
897
+
898
+ - **La clé de préversion reste dans l'URL** (`?ncf_preview=…`). Le garde la mémorisait
899
+ puis la retirait : une adresse copiée depuis la barre ne s'ouvrait pas chez un client.
900
+ Désormais elle y reste, et un chargement de page sans clé (lien interne, favori) la
901
+ récupère du cookie. Après une navigation côté client, le bandeau de préversion la
902
+ remet dans l'URL sans recharger.
903
+ - **Bandeau : « Copier le lien »** copie l'adresse de la page, clé comprise.
904
+ - Les liens « Préprod » du Studio délivrent une clé de **30 jours** (au lieu d'un) :
905
+ l'adresse ouverte se partage, elle doit tenir le temps d'une relecture client.
906
+ - Toujours révocable, toujours vérifiée à chaque requête ; la production n'est pas gardée
907
+ et n'affiche jamais de brouillons.
908
+
909
+ ## 2.11.0 : prod / préprod, jamais de brouillon en production
910
+
911
+ ### Corrigé (critique)
912
+
913
+ - **La production pouvait afficher des brouillons** dans un navigateur où le mode
914
+ brouillon avait été activé sur le domaine public (Presentation pointé sur la prod).
915
+ Désormais `isDraftData()` / `dataPerspective()` ignorent tout mode brouillon en
916
+ production, et `ncfEnableDraftMode()` y refuse l'activation (la page s'affiche
917
+ telle qu'en ligne). À utiliser partout à la place de `draftMode()`.
918
+ - **« Préprod · En ligne » montrait des brouillons** si le mode brouillon était resté
919
+ actif : le lien passe par la bascule, qui le coupe. La bascule synchronise aussi la
920
+ perspective (`sanity-preview-perspective`).
921
+
922
+ ### Ajouté
923
+
924
+ - **Trois cibles d'aperçu** dans « Prévisualiser » : Préprod · Brouillons (jaune
925
+ pastel), Préprod · En ligne (vert pastel), Prod · En ligne (vert plein)
926
+ (`previewTargets`). Plus de « Prod · Brouillons » ; l'onglet Pages force la prod en
927
+ ligne (`effectivePerspective`).
928
+ - **Session de préprod signée** (`ncf_preview_session`, HMAC, clé
929
+ `NCF_PREVIEW_SECRET` ou `SANITY_API_READ_TOKEN`) posée par `ncfEnableDraftMode`
930
+ après validation du secret par Sanity : Presentation affiche la préprod sans
931
+ laissez-passer ni connexion. Vérifiée localement par `ncfPreviewGuard`.
932
+ - Laissez-passer en `SameSite=None; Secure` : valable dans l'iframe de Presentation.
933
+
934
+ ### À faire dans un projet
935
+
936
+ - `presentationTool({previewUrl: {origin: <préprod>}})` : on édite sur la préprod.
937
+ - Route d'activation : `export const {GET} = ncfEnableDraftMode(defineEnableDraftMode(...))`.
938
+ - Remplacer `draftMode()` par `isDraftData()` / `dataPerspective()` hors routes /api.
939
+
940
+ ## 2.10.2 : pas de « Modifier l'instance principale » dans Presentation
941
+
942
+ ### Modifié
943
+
944
+ - Le bouton **« Modifier l'instance principale »** n'apparaît plus quand on édite une
945
+ instance de composant depuis Presentation (on y travaille sur la page, à côté de son
946
+ rendu). Il reste dans l'éditeur classique. Le nom de l'outil Presentation est lu dans
947
+ le workspace (renommage pris en compte).
948
+
949
+ ## 2.10.1 : vérification réelle de allowOrigins
950
+
951
+ ### Corrigé
952
+
953
+ - **Plus de fausse alerte « Pages fonctionne en mode dégradé »** dès qu'un projet
954
+ déclare plusieurs environnements d'aperçu. L'onglet Pages lit désormais les
955
+ `allowOrigins` de presentationTool et ne prévient que si une origine (production,
956
+ préproduction) y manque vraiment, en la nommant. Liste calculée par une fonction :
957
+ rien n'est signalé, faute de pouvoir vérifier. Le doctor garde son contrôle.
958
+
959
+ ## 2.10.0 : « Design system » dans la barre du Studio
960
+
961
+ ### Ajouté
962
+
963
+ - **Bouton « Design system »** dans la barre du Studio (outil `ncf-design-system`) :
964
+ ouvre la page `/design-system` du site dans Presentation, avec le document des
965
+ valeurs par défaut des composants à côté. Cliquer un composant sur la page ouvre
966
+ ses réglages globaux : un style changé ici change le composant partout où il
967
+ n'est pas surchargé. `tools: {designSystem: false}` pour le retirer.
968
+ - **`componentDefaultsMainDocuments()`** : lie `/design-system` et
969
+ `/design-system/composant` au document des valeurs par défaut (Presentation).
970
+ - **Menu « Plus »** rendu par le kit : Vision et la planification (« Scheduled
971
+ drafts » / Releases) y sont rangés par défaut (option `moreTools`). Le menu
972
+ d'outils écrit dans chaque projet n'est plus nécessaire (à supprimer : il
973
+ masquait le lanceur d'aperçu du kit, ou l'inverse).
974
+
975
+ ## 2.9.1 : « Modifier l'instance principale »
976
+
977
+ ### Ajouté
978
+
979
+ - **Bouton « Modifier l'instance principale »** en tête du formulaire de chaque
980
+ composant posé dans une page, un article ou les Réglages : il ouvre
981
+ Presentation sur ce composant (rendu réel + ses valeurs par défaut, qui
982
+ s'appliquent à toutes ses instances dont le champ est vide). Même destination
983
+ qu'un clic dans l'onglet Composants (logique partagée, testée).
984
+
985
+ ## 2.9.0 : valeurs par défaut des composants, tout dans le kit
986
+
987
+ ### Ajouté
988
+
989
+ Toute la gestion des composants (valeurs par défaut, instances, overrides,
990
+ preview) est dans le kit : un projet qui l'importe l'a sans recopier de code.
991
+
992
+ - **Studio** : `defineComponentDefaults({sections})` (document « Composants :
993
+ valeurs par défaut », généré depuis les sections), `requiredUnlessDefault` /
994
+ `requiredUnlessDefaultFor`, `defaultsFieldName`,
995
+ `componentDefaultsMainDocument` (Presentation : rendu réel + réglages).
996
+ - Nouvelle entrée `@nocode-factory/sanity-kit/schema` : ces outils de schéma
997
+ sans interface (fichiers de schéma, scripts `sanity exec`).
998
+ - **Site**, nouvelle entrée `@nocode-factory/sanity-kit/web/defaults` (neutre :
999
+ serveur, client et configuration du client Sanity) : `applyDefaults`,
1000
+ `inherit`, `componentDefaultsQuery`, `stegaFilter`, `isOptionValue`,
1001
+ `STEGA_OPTION_RULES`, `reattributeTo`.
1002
+ - **`ncf-kit doctor`** : rubrique « Valeurs par défaut des composants » (document,
1003
+ Presentation, champs de section préremplis, héritage côté site, filtre de
1004
+ preview, réétiquetage des textes hérités, page de rendu).
1005
+ - README : mise en place et API.
1006
+
1007
+ ## 2.8.3 : réinitialiser = hériter (le champ suit la valeur par défaut)
1008
+
1009
+ ### Corrigé
1010
+
1011
+ - **« Réinitialiser » copiait la valeur par défaut** (2.8.2) : le champ était
1012
+ figé et ne suivait plus les changements de la valeur par défaut du
1013
+ composant. Il remet désormais le champ en HÉRITAGE (vidé en base) : il suit
1014
+ la valeur par défaut, aujourd'hui comme après ses changements.
1015
+ - **Un champ qui hérite affiche la valeur par défaut** : grisée dans une zone
1016
+ de texte, en mention « Valeur par défaut du composant : … » sous les autres
1017
+ champs (choix, cases, couleurs, listes...). Il ne paraît plus vide.
1018
+ - Sans valeur par défaut, la pastille ouvre toujours le réglage du composant
1019
+ (un champ vidé n'afficherait rien). Dans un élément de liste, la valeur par
1020
+ défaut est recopiée (une liste remplie remplace celle du défaut en entier).
1021
+
1022
+ ## 2.8.2 : « Réinitialiser » applique la valeur par défaut
1023
+
1024
+ ### Corrigé
1025
+
1026
+ - **Réinitialiser vidait le champ** : sans valeur par défaut pour ce champ, le
1027
+ contenu disparaissait de la page (preview vide). La pastille APPLIQUE
1028
+ désormais la valeur par défaut du composant dans le champ, et ne vide jamais
1029
+ un champ. Sans valeur par défaut, elle l'indique et ouvre le réglage du
1030
+ composant.
1031
+ - **Au survol, la pastille affiche la valeur par défaut** qui sera appliquée
1032
+ (« ↺ « À la une » »), la bulle la donne en entier.
1033
+
1034
+ ## 2.8.1 : pastille d'override sur tous les champs
1035
+
1036
+ ### Corrigé
1037
+
1038
+ - **La pastille bleue manquait sur beaucoup de champs.** Elle n'apparaissait
1039
+ que si le composant avait une valeur par défaut pour le champ. Elle apparaît
1040
+ maintenant dès que la valeur du champ DIFFÈRE de la valeur par défaut du
1041
+ composant (valeur par défaut vide comprise), et plus du tout quand elle est
1042
+ identique.
1043
+ - **Champs des éléments de liste** (questions de FAQ, cartes, chiffres
1044
+ clés...) : comparés à l'élément de même rang de la valeur par défaut ;
1045
+ « Réinitialiser » y recopie la valeur par défaut (une liste remplie remplace
1046
+ celle du défaut en entier).
1047
+ - **Composant posé hors liste** (ex. CTA de fin d'article des Réglages) : ses
1048
+ champs portent aussi la pastille.
1049
+ - Comparaison avec la dernière version des valeurs par défaut, brouillon
1050
+ compris (la même que le formulaire du composant). Texte riche comparé comme
1051
+ un tout. Une case décochée vaut une case non renseignée.
1052
+
1053
+ ## 2.8.0 : pastille d'override et vue Map reliée aux composants
1054
+
1055
+ ### Ajouté
1056
+
1057
+ - **Pastille bleue sur les champs surchargés d'une instance de composant.**
1058
+ Dans le formulaire d'une page, un champ d'une instance qui a sa propre valeur
1059
+ alors que le composant a une valeur par défaut porte une pastille bleue. La
1060
+ bulle indique la valeur par défaut ; au survol, la pastille devient
1061
+ « ↺ Réinitialiser » : le champ est vidé et reprend la valeur par défaut. Les
1062
+ valeurs par défaut sont lues une fois et tenues à jour en direct.
1063
+ - **Vue Map** : le panneau d'un composant propose « Ouvrir le composant »
1064
+ (rendu réel et valeurs par défaut, comme la grille), et chaque page listée
1065
+ ouvre le formulaire directement sur l'instance du composant (nombre
1066
+ d'instances affiché quand la page en contient plusieurs).
1067
+ - `BlockOccurrence.locations` : emplacement de chaque instance (document et
1068
+ chemin dans le page builder).
1069
+
1070
+ ## 2.7.0 : Composants, rendu réel et valeurs par défaut
1071
+
1072
+ ### Ajouté
1073
+
1074
+ - **Un clic sur un composant de l'onglet Composants l'ouvre dans Presentation** :
1075
+ son rendu réel par le site à gauche, le champ de ses valeurs par défaut à
1076
+ droite, mis à jour en direct. Les valeurs par défaut s'appliquent à toutes
1077
+ les instances du composant dont le champ est vide ; un champ rempli dans une
1078
+ instance (override) n'est jamais écrasé.
1079
+
1080
+ Actif dès que le schéma contient le document des valeurs par défaut
1081
+ (`componentPreview.defaultsType`, `componentDefaults` par défaut) et que le
1082
+ site a la page de rendu (`componentPreview.live`,
1083
+ `/design-system/composant?type={name}` par défaut) : c'est le cas du starter.
1084
+ Sans ce document, le clic ouvre la démo du design system dans un nouvel
1085
+ onglet.
1086
+
1087
+ ## 2.6.2 : la garde de préversion ne bloque plus le poste local ni la CI
1088
+
1089
+ ### Corrigé
1090
+
1091
+ - **`next dev` / `next start` en local répondaient 401 « Cette version du site
1092
+ est privée »** sur toutes les pages, et le workflow « Captures des sections »
1093
+ du starter (site lancé en CI) ne photographiait que la page de refus.
1094
+ `ncfPreviewGuard` gardait tout ce qui n'était pas la production, y compris
1095
+ hors Vercel.
1096
+
1097
+ La garde ne protège plus que les préversions Vercel (`VERCEL_ENV` à
1098
+ `preview`, dont la préproduction `preview-<projet>.vercel.app`). En local et
1099
+ en CI il n'y a rien de privé à protéger. Le bandeau de préversion, lui, reste
1100
+ affiché hors production.
1101
+
1102
+ ## 2.6.1 — ouvrir une préversion en ligne, avec son laissez-passer
1103
+
1104
+ ### Corrigé
1105
+
1106
+ - **« Ouvrir en ligne » menait à « Cette version du site est privée »** sur une
1107
+ préproduction, même pour l'éditeur connecté au Studio. Le lanceur
1108
+ « Prévisualiser » (icône ↗), le chemin cliquable de la liste des Pages et le
1109
+ bouton « Voir en ligne » de la fiche ouvraient l'URL nue, alors que
1110
+ `ncfPreviewGuard` exige un laissez-passer.
1111
+
1112
+ Ils demandent maintenant un laissez-passer pour soi (le même service que
1113
+ « Partager la préversion », délivré seulement à qui a accès au projet
1114
+ Sanity), le réutilisent tant qu'il reste valide plus d'une heure, et le
1115
+ posent sur la page d'arrivée. En brouillons, il voyage dans le `redirect` de
1116
+ la route de bascule : c'est la page d'arrivée que la garde contrôle.
1117
+
1118
+ La production s'ouvre toujours par l'URL simple, sans laissez-passer.
1119
+
1120
+ ### Décisions
1121
+
1122
+ - **L'onglet s'ouvre avant l'appel au service**, puis reçoit l'adresse : un
1123
+ navigateur bloque une fenêtre ouverte après un `await`. En cas d'échec, la
1124
+ raison s'affiche dans l'onglet plutôt qu'une page blanche.
1125
+ - **Un laissez-passer d'un jour, libellé « Ouverture depuis le Studio »** :
1126
+ distinct des liens partagés dans le suivi, et court parce qu'il n'est fait
1127
+ que pour soi.
1128
+
1129
+
1130
+ ## 2.6.0 — `npx ncf-kit doctor`
1131
+
1132
+ ### Ajouté
1133
+
1134
+ - **`npx ncf-kit doctor`**, depuis le dossier du studio : dit si un projet est
1135
+ complet et quoi corriger. Registre et version, aperçu et préproduction,
1136
+ origines autorisées, clé du journal, kit côté site, bandeau, bascule, garde,
1137
+ workflow des captures, puis production et préproduction en ligne (garde
1138
+ active, pas de connexion Vercel). Sortie 1 s'il reste un ✖.
1139
+ - **README dans le paquet** : `files` le déclarait, il n'existait pas. Un
1140
+ projet qui n'est pas parti du starter n'avait aucune doc sous la main.
1141
+
1142
+ ### Corrigé
1143
+
1144
+ - **La doc d'installation envoyait encore vers GitHub Packages**, figé en
1145
+ 1.8.0 depuis le passage à npmjs (2.0.0). Un projet installé en la suivant
1146
+ restait en 1.8.0, sans préproduction ni bandeau. `INSTALL`, `NOUVEAU-PROJET`
1147
+ et `PUBLIER` pointent maintenant npmjs ; `doctor` signale l'ancien `.npmrc`.
1148
+ - **`NOUVEAU-PROJET` ne parlait que du Studio.** Le prompt couvre désormais la
1149
+ préproduction, le site (garde, bascule, bandeau), les captures et se
1150
+ termine par `doctor`.
1151
+
1152
+
1153
+ ## 2.5.0 — ouvrir dans le Studio ou en ligne
1154
+
1155
+ ### Changé
1156
+
1157
+ - **Le lanceur « Prévisualiser » propose deux gestes par ligne.** Cliquer sur
1158
+ le libellé ouvre l'aperçu **dans le Studio** (Presentation) ; l'icône ↗
1159
+ ouvre le **vrai site en ligne**, dans un nouvel onglet.
1160
+
1161
+ Les brouillons en ligne passent par la route de bascule du site, qui pose le
1162
+ cookie puis renvoie à l'accueil. La production ne montre jamais de
1163
+ brouillons : on y retombe sur l'URL simple.
1164
+
1165
+ ## 2.4.0 — savoir qu'une version plus récente existe
1166
+
1167
+ ### Ajouté
1168
+
1169
+ - **Un avis de mise à jour dans la barre du Studio**, à côté de
1170
+ « Prévisualiser ». Il compare la version exécutée à la dernière publiée sur
1171
+ npm, donne la commande, et renvoie au journal des versions.
1172
+
1173
+ ### Ce qu'il ne fait pas, et pourquoi
1174
+
1175
+ **Il ne met pas à jour.** Un Studio s'exécute dans un navigateur : il ne peut
1176
+ ni installer un paquet sur le poste qui le construit, ni se redéployer.
1177
+ Prétendre le contraire serait mentir sur ce qui se passe — le bouton dit ce
1178
+ qui manque et donne la commande, c'est tout ce qu'il peut honnêtement offrir.
1179
+
1180
+ ### Décisions
1181
+
1182
+ - **Invisible tant que le kit est à jour.** Un bouton permanent qui ne dit
1183
+ rien finit par ne plus être lu.
1184
+ - **Les pré-publications ne sont jamais proposées.**
1185
+ - La comparaison se fait nombre à nombre : `2.10.0` dépasse bien `2.9.0`, ce
1186
+ qu'une comparaison de chaînes manquerait.
1187
+ - Le registre npm est interrogé sans authentification — le paquet est public
1188
+ et le registre autorise les requêtes navigateur. L'échec est silencieux :
1189
+ ne pas savoir ne doit gêner personne.
1190
+
1191
+ ## 2.3.0 — prévisualiser depuis la barre du haut
1192
+
1193
+ ### Ajouté
1194
+
1195
+ - **« Prévisualiser » dans la barre du Studio**, à droite des outils. Un menu
1196
+ par environnement — Production, Préproduction — et pour chacun le choix
1197
+ entre brouillons et contenu en ligne. On choisit, on ouvre.
1198
+
1199
+ Posé par le plugin : rien à brancher dans la configuration d'un projet.
1200
+
1201
+ ### Décisions
1202
+
1203
+ - **Sans mémoire**, contrairement au sélecteur de l'onglet Pages : on lance
1204
+ une consultation, on ne règle pas un mode de travail. Un bouton de barre qui
1205
+ retiendrait un état finirait par mentir sur ce qu'on regarde ailleurs.
1206
+ - **Le menu des outils est rendu tel quel**, le lanceur s'ajoute à côté. Un
1207
+ plugin qui le remplacerait ferait disparaître « Plus » et tout ce qu'un autre
1208
+ y aurait mis.
1209
+ - Il suit la forme du menu : en ligne dans la barre, en colonne dans le volet
1210
+ latéral.
1211
+
1212
+ ## 2.2.2 — le garde laisse le middleware finir son travail
1213
+
1214
+ ### Corrigé
1215
+
1216
+ - **Toutes les pages tombaient en 404** sur une préversion dont l'accès était
1217
+ pourtant accordé. Depuis la 2.2.0, `ncfPreviewGuard` rendait une réponse
1218
+ quand le laissez-passer était valide — une valeur non nulle, qui faisait
1219
+ sortir le middleware hôte avant sa gestion des langues, ses redirections et
1220
+ ses en-têtes.
1221
+
1222
+ Il rend de nouveau `null` : le middleware poursuit son travail.
1223
+
1224
+ C'était le prix d'une bonne intention — poser `X-Robots-Tag` sur les pages
1225
+ laissées passer. L'interdiction d'indexation reste sur les réponses que le
1226
+ garde produit lui-même ; pour les autres, le `robots.ts` du site s'en charge
1227
+ déjà hors production.
1228
+
1229
+ ## 2.2.1 — pas de préproduction en double
1230
+
1231
+ ### Corrigé
1232
+
1233
+ - **Un projet déclarant sa préproduction à une adresse hors convention en
1234
+ obtenait deux**, portant le même identifiant `preprod` : la configuration
1235
+ devenait invalide et l'onglet Pages se désactivait.
1236
+
1237
+ La préproduction déduite n'écartait la déclarée que par comparaison d'URL.
1238
+ Elle compare aussi l'identifiant — un projet dont le domaine ne suit pas
1239
+ exactement la convention déclare bien un `preprod`, à une autre adresse.
1240
+
1241
+ La déclaration explicite fait foi, toujours.
1242
+
1243
+ ## 2.2.0 — la préproduction par convention
1244
+
1245
+ ### Ajouté
1246
+
1247
+ - **La préproduction est déduite de la production**, sans rien déclarer :
1248
+ `preview-<projet>.vercel.app`. Elle apparaît d'office dans le sélecteur
1249
+ d'environnement et dans le bouton de partage.
1250
+
1251
+ Fixe, parce qu'un lien de partage doit survivre au commit suivant : une URL
1252
+ de déploiement Vercel change à chaque poussée, un domaine assigné à une
1253
+ branche non.
1254
+
1255
+ `preprodUrl: false` la retire pour un projet qui n'en a pas.
1256
+
1257
+ - **Les réponses de préversion portent `X-Robots-Tag: noindex`** — y compris
1258
+ la page de refus. Une préproduction porte du contenu non publié et
1259
+ doublerait le site public en résultats de recherche ; le refus d'accès n'y
1260
+ suffit pas, un moteur peut avoir vu l'URL ailleurs.
1261
+
1262
+ ### Reste à faire une fois par projet
1263
+
1264
+ Créer le domaine dans Vercel (*Settings → Domains*) et l'assigner à la branche
1265
+ `preprod`. Le kit ne peut pas le faire à votre place.
1266
+
1267
+ ## 2.1.1 — ne pas proposer de partager le site public
1268
+
1269
+ ### Corrigé
1270
+
1271
+ - **Le bouton de partage fabriquait un lien vers la production**, l'environnement
1272
+ choisi valant « Production » par défaut. Le lien était valide mais ne montrait
1273
+ rien : le bandeau se masque sur le site public, et le mode brouillon y est
1274
+ refusé.
1275
+
1276
+ Il explique maintenant pourquoi il n'y a rien à partager là, et invite à
1277
+ choisir une préversion — déclarée, ou collée à la volée.
1278
+
1279
+ - Le site public est signalé dans le sélecteur d'environnement : *« site public
1280
+ — pas de préversion »*.
1281
+
1282
+ ## 2.1.0 — partager une préversion par un lien
1283
+
1284
+ ### Ajouté
1285
+
1286
+ - **« Partager la préversion »** dans la barre des Pages : délivre un lien que
1287
+ n'importe qui peut ouvrir, **sans compte Vercel ni Sanity**. Celui qui le
1288
+ reçoit voit le site de préproduction et peut y basculer entre brouillons et
1289
+ contenu en ligne.
1290
+
1291
+ - **`ncfPreviewGuard(request)`** pour le middleware du site : exige un
1292
+ laissez-passer hors production, mémorise celui de l'URL en cookie, et
1293
+ affiche une page de refus explicite plutôt qu'une page blanche.
1294
+
1295
+ ```ts
1296
+ // middleware.ts
1297
+ const guarded = await ncfPreviewGuard(request)
1298
+ if (guarded) return guarded
1299
+ ```
1300
+
1301
+ ### Comment l'autorisation tient
1302
+
1303
+ Le lien **est** l'autorisation : c'est lui qui se partage. Mais il n'est
1304
+ délivré qu'à qui a déjà accès au projet — le service interroge Sanity avec le
1305
+ jeton de l'éditeur, il ne croit pas le Studio sur parole. Un kit public ne
1306
+ prouve rien par lui-même.
1307
+
1308
+ Chaque laissez-passer est daté (7 jours par défaut, 30 au plus), révocable, et
1309
+ ses usages sont comptés : un partage plus large que prévu se voit dans la vue
1310
+ `preview_access`.
1311
+
1312
+ ### Décisions
1313
+
1314
+ - **L'accès au projet se juge par Sanity, pas par la liste `members`.** Un
1315
+ administrateur d'organisation y a accès sans y figurer nommément ; le
1316
+ rejeter aurait été faux.
1317
+ - **Le résultat d'une vérification n'est pas mis en cache.** Révoquer un lien
1318
+ doit couper l'accès tout de suite, pas à l'expiration d'un cache.
1319
+ - **Service injoignable vaut refus.** Une porte qui s'ouvre quand la serrure
1320
+ est en panne n'est pas une porte. C'est l'inverse du choix fait pour les
1321
+ outils du Studio, qui restent ouverts en cas de panne — là il s'agissait de
1322
+ ne pas bloquer un éditeur, ici d'empêcher une fuite.
1323
+ - Le paramètre est retiré de l'URL après mémorisation, pour ne pas traîner
1324
+ dans l'historique ni dans les liens repartagés depuis la page.
1325
+
1326
+ ## 2.0.0 — public sur npmjs
1327
+
1328
+ ### Changé
1329
+
1330
+ - **Le kit est publié publiquement sur npmjs**, plus sur GitHub Packages.
1331
+ `npm install @nocode-factory/sanity-kit` suffit : ni `.npmrc`, ni jeton, ni
1332
+ variable d'environnement — sur un poste, dans une CI, dans une préversion
1333
+ Vercel.
1334
+
1335
+ GitHub Packages exigeait un jeton **même pour un paquet public**. C'est ce
1336
+ qui cassait les préversions dès que le front dépendait du kit.
1337
+
1338
+ ### Ce que ça change pour les projets
1339
+
1340
+ Retirer la ligne `@nocode-factory:registry=…` des `.npmrc`, ou le fichier
1341
+ entier s'il ne servait qu'à ça. Rien d'autre.
1342
+
1343
+ ### Ce que ça ne change pas
1344
+
1345
+ Le registre d'usage voit toujours qui exécute le kit, et l'Historique reste
1346
+ une vraie frontière : il exige une clé de lecture délivrée par NoCode Factory,
1347
+ et son ingestion un secret de webhook. Un inconnu qui installerait le kit
1348
+ obtient Pages, Composants et le bandeau — jamais le journal.
1349
+
1350
+ Versions majeure parce que le registre change : une installation existante ne
1351
+ se met pas à jour toute seule.
1352
+
1353
+ ## 1.8.0 — le bandeau de préversion vient du kit
1354
+
1355
+ ### Ajouté
1356
+
1357
+ - **Deux points d'entrée front**, sans aucune dépendance au Studio :
1358
+
1359
+ ```tsx
1360
+ import {NcfPreviewBanner} from '@nocode-factory/sanity-kit/web'
1361
+ import {ncfDraftModeToggle, isPreviewSite} from '@nocode-factory/sanity-kit/web/server'
1362
+ ```
1363
+
1364
+ Le bandeau dit où l'on est et laisse choisir les données. La route bascule
1365
+ le mode brouillon et **refuse en production** : le contenu non publié ne doit
1366
+ jamais être atteignable en public.
1367
+
1368
+ ### Ce que ça demande au site
1369
+
1370
+ Deux lignes dans le layout et une route de trois lignes. **Un plugin de Studio
1371
+ ne peut pas injecter d'interface dans un site** — ce sont deux applications sur
1372
+ deux domaines. Le site doit importer quelque chose ; le kit réduit ce quelque
1373
+ chose au minimum.
1374
+
1375
+ ### Décisions
1376
+
1377
+ - **Client et serveur séparés.** Un même module ne peut pas importer
1378
+ `next/navigation` et `next/headers` : Next refuse le mélange. D'où `/web` et
1379
+ `/web/server`.
1380
+ - **Styles en ligne, pas de classes utilitaires.** Des classes obligeraient
1381
+ chaque site à déclarer le paquet dans ses globs de scan — une dépendance
1382
+ invisible dont l'oubli ne se verrait qu'à l'exécution, par un bandeau nu.
1383
+ - **`'use client'` est réinjecté après construction** : pkg-utils ne préserve
1384
+ pas les directives de module, et sans elle Next traite le bandeau comme un
1385
+ composant serveur.
1386
+ - `next` est une dépendance de pair **optionnelle** : un Studio qui n'utilise
1387
+ pas le front n'a rien à installer.
1388
+
1389
+ ## 1.7.0 — la bascule est dans l'aperçu
1390
+
1391
+ ### Corrigé
1392
+
1393
+ - **La bascule brouillons / en ligne n'était pas là où on regarde.** Elle
1394
+ vivait dans la barre de l'onglet Pages : une fois dans l'aperçu, il fallait
1395
+ en ressortir pour changer ce qu'on y voyait. Elle est désormais dans
1396
+ l'en-tête de Presentation, à côté de la page.
1397
+
1398
+ ### Ajouté
1399
+
1400
+ - `ncfPreviewComponents()` à passer à `presentationTool` :
1401
+
1402
+ ```ts
1403
+ presentationTool({components: ncfPreviewComponents(), previewUrl: …})
1404
+ ```
1405
+
1406
+ L'en-tête d'origine est conservé — la bascule s'y ajoute, elle ne le
1407
+ remplace pas.
1408
+
1409
+ ### Notes
1410
+
1411
+ - La perspective est écrite dans l'URL du Studio, que Presentation lit déjà.
1412
+ Une adresse partagée montre donc la même chose à qui l'ouvre.
1413
+
1414
+ ## 1.6.0 — coller l'adresse d'une préversion
1415
+
1416
+ ### Ajouté
1417
+
1418
+ - **Une adresse quelconque comme cible d'aperçu.** Toute URL qui n'est pas la
1419
+ production en est une autre version : une préversion par branche, parfois
1420
+ par commit. Les déclarer d'avance serait vain — on colle celle qu'on a sous
1421
+ les yeux, et elle est retenue jusqu'à ce qu'on l'oublie.
1422
+ - Une adresse inexploitable est refusée sur-le-champ plutôt que de charger une
1423
+ page blanche.
1424
+
1425
+ ### Notes
1426
+
1427
+ - `allowOrigins` accepte les jokers de sous-domaine :
1428
+ `https://*.vercel.app` couvre toutes les préversions d'un projet Vercel.
1429
+ Sans quoi l'aperçu s'affiche mais reste muet.
1430
+
1431
+ ## 1.5.0 — choisir ce que montre l'aperçu
1432
+
1433
+ ### Ajouté
1434
+
1435
+ - **Bascule Brouillons / En ligne** dans la barre des Pages. Elle répond à la
1436
+ question d'un relecteur : ce qui sortira quand il publiera, ou ce que voit
1437
+ le public aujourd'hui.
1438
+ - **Sélecteur d'environnement** quand plusieurs `environments` sont déclarés :
1439
+ la version du front chargée dans l'aperçu. Sanity permet déjà plusieurs
1440
+ fronts, mais le choix s'y fait par variable d'environnement au déploiement —
1441
+ ici il se fait à l'exécution, sans redéployer.
1442
+ - `ncfAllowedOrigins(config)` produit la liste pour `presentationTool`, depuis
1443
+ la même déclaration : une origine oubliée donne un aperçu muet, sans édition
1444
+ visuelle, et rien ne le signale.
1445
+
1446
+ ### Décisions
1447
+
1448
+ - **Les deux axes sont indépendants.** L'environnement porte le code, la
1449
+ perspective porte les données. Le dataset ne change jamais : voir le contenu
1450
+ de production dans le front d'une branche de recette est le cas d'usage, pas
1451
+ un effet de bord.
1452
+ - **Le choix vaut partout** — Presentation, lien du chemin dans le tableau,
1453
+ aperçus des cartes, bouton « Voir » de la fiche. Deux notions de « le site »
1454
+ dans une même vue seraient un piège.
1455
+ - **Retenu par navigateur et par projet**, pas dans le document de
1456
+ disposition : deux personnes relisant le même site peuvent vouloir regarder
1457
+ deux environnements sans se déranger.
1458
+ - Le sélecteur d'environnement n'apparaît qu'à partir de deux : un menu à une
1459
+ entrée prend la place sans rien offrir.
1460
+ - La perspective `drafts` est omise de l'URL, Presentation l'appliquant déjà
1461
+ par défaut.
1462
+
1463
+ ## 1.4.0 — installation en une commande, préfixes d'URL, onglet Plus
1464
+
1465
+ ### Ajouté
1466
+
1467
+ - **`npx ncf-kit setup`** : depuis le dossier du studio, active le projet
1468
+ chez NoCode Factory, écrit la clé de lecture dans `.env`
1469
+ (`SANITY_STUDIO_NCF_PROJECT_KEY`) et crée le webhook du journal avec la
1470
+ bonne forme (brouillons inclus, filtre, projection, secret). Ne supprime
1471
+ jamais un webhook : au quota, elle s'arrête et le dit.
1472
+ - **Fonction `activate`** : rend les clés à qui présente un jeton Sanity
1473
+ d'administrateur du projet. `register` continue de ne rien rendre : un
1474
+ projectId est public, le rôle d'administrateur ne l'est pas. Les sources
1475
+ des quatre fonctions vivent désormais dans `supabase/functions/`.
1476
+ - **`pathPrefix`** sur un type de page : `/blog/<slug>`, `/produits/<slug>`.
1477
+ Sans lui, les collections sous un répertoire s'affichaient à la racine et
1478
+ leur aperçu tombait en 404.
1479
+ - **`pageTypesFromSiteRoutes(routes)`** : les `pageTypes` déduits du registre
1480
+ `site-routes.json` du starter, accueil et préfixes compris.
1481
+ - **`withMoreTool(prev)`** : range Vision et Releases (ou toute liste) dans
1482
+ un onglet « Plus » en fin de barre, avec leurs composants d'origine.
1483
+
1484
+ ### Changé
1485
+
1486
+ - `history.projectKey` peut être vide ou absent : l'onglet Historique
1487
+ explique alors quoi lancer, au lieu d'une configuration en erreur.
1488
+ - Un projet découvert mais non activé l'annonce dans l'onglet Historique dès
1489
+ qu'une clé est configurée ; les messages « clé non reconnue » et « journal
1490
+ inactif » disent quoi faire.
1491
+ - Doc d'installation : prérequis Node (avertissement `EBADENGINE`), jeton
1492
+ `read:packages`, nouveau prompt de branchement.
1493
+
1494
+ ## 1.3.0 — brouillons journalisés, diff visuel
1495
+
1496
+ ### Corrigé
1497
+
1498
+ - **Modifier dans le Studio ne produisait rien.** Éditer écrit un brouillon,
1499
+ et le webhook n'écoutait que les publications. Les deux sont désormais
1500
+ enregistrés, et la frise dit lequel : « brouillon » ou « en ligne ».
1501
+ Un filtre permet de ne voir que ce qui est parti en ligne.
1502
+
1503
+ ### Ajouté
1504
+
1505
+ - **Le diff se lit comme un diff de code** : deux lignes signées `−` et `+`,
1506
+ sur des fonds rouge et vert discrets. Sur deux textes, le mot exactement
1507
+ remplacé est surligné — dire « ce champ a changé » ne dit pas *ce qui* a
1508
+ changé, et sur une meta description l'œil doit tomber sur les deux mots
1509
+ remplacés, pas relire la phrase.
1510
+ - Les fonds passent par `color-mix`, donc ils suivent le thème clair comme le
1511
+ thème sombre du Studio.
1512
+
1513
+ ### Notes
1514
+
1515
+ - Un brouillon se compare au brouillon précédent, une version publiée à la
1516
+ précédente : mêler les deux ferait passer pour un changement ce qui n'est
1517
+ qu'un travail non publié.
1518
+ - Le mot à mot est abandonné au-delà de 400 mots par côté — son coût est
1519
+ quadratique, et un champ démesuré ferait ramer le Studio.
1520
+
1521
+ ## 1.2.1 — la restauration écrit dans le brouillon
1522
+
1523
+ ### Corrigé
1524
+
1525
+ - **La restauration échouait sur un document supprimé** — c'est-à-dire
1526
+ précisément quand elle compte le plus. `patch` exige un document existant ;
1527
+ `createOrReplace` recrée ce qui n'est plus là.
1528
+ - **Elle écrivait par-dessus la version en ligne.** Elle vise désormais le
1529
+ brouillon : l'éditeur relit et publie. Une restauration ne doit pas remettre
1530
+ en ligne un état ancien sans que personne l'ait vu.
1531
+ - Les échecs disent ce qui s'est passé — droits insuffisants, schéma qui a
1532
+ changé depuis — au lieu d'un message unique.
1533
+
1534
+ ## 1.2.0 — phase 2, le journal des modifications
1535
+
1536
+ ### Ajouté
1537
+
1538
+ - **L'onglet Historique fonctionne.** Frise des changements du dataset —
1539
+ document, auteur, date, nature de l'opération — filtrable et paginée. Un clic
1540
+ ouvre le détail : chaque champ modifié avec son avant/après, et un bouton de
1541
+ restauration.
1542
+ - **Registre d'usage.** Chaque Studio se signale au démarrage : identifiant de
1543
+ projet, dataset, hôte, version du kit. Aucun contenu, aucune identité
1544
+ d'éditeur. `serviceEndpoint: false` coupe cet appel.
1545
+ - Backend Supabase : trois Edge Functions. `ingest` vérifie la signature
1546
+ HMAC-SHA256 des webhooks Sanity, `history` sert la lecture, `register`
1547
+ enregistre les Studios.
1548
+
1549
+ ### Décisions
1550
+
1551
+ - **Le diff se calcule dans le Studio**, à partir de deux instantanés. Le
1552
+ serveur n'a pas à connaître le schéma d'un client. Les tableaux sont indexés
1553
+ par `_key` : réordonner des sections ne se lit pas comme une réécriture.
1554
+ - **La restauration passe par le client du Studio**, donc par les droits de
1555
+ l'éditeur connecté. Le kit n'a jamais d'accès en écriture au contenu d'un
1556
+ client.
1557
+ - **Un projet suspendu n'est pas bloqué** pour Pages et Composants : ces outils
1558
+ ne lisent que le contenu du client, avec ses propres droits. Les bloquer ne
1559
+ protégerait rien et punirait un éditeur pour une question commerciale. Le
1560
+ journal, lui, s'arrête.
1561
+ - **En cas de panne du service, le Studio reste ouvert.** Notre indisponibilité
1562
+ ne doit pas empêcher un éditeur de travailler.
1563
+ - L'auteur d'un changement est stocké comme identifiant et résolu en nom par le
1564
+ Studio : un nom stocké se périme, et le résoudre côté serveur exigerait un
1565
+ jeton Sanity par client.
1566
+
1567
+ ### Sécurité
1568
+
1569
+ - La vue `project_usage` était lisible avec la clé publiable Supabase — les
1570
+ vues Postgres contournent RLS par défaut. Passée en `security_invoker`, et
1571
+ les droits révoqués pour `anon` et `authenticated`.
1572
+ - `register` ne rend plus la clé de lecture. Les identifiants de projet Sanity
1573
+ sont publics : n'importe qui pouvait réclamer celle d'un client.
1574
+
1575
+ ## 1.1.0 — colonnes tirées du schéma
1576
+
1577
+ ### Ajouté
1578
+
1579
+ - **Toutes les données stockées au niveau de la page sont proposées en
1580
+ colonnes**, tirées du schéma du client plutôt que d'une liste tenue à la
1581
+ main : chaînes, nombres, booléens, slugs, et un niveau d'objets imbriqués.
1582
+ Sur un schéma réel, `seo.metaDescription` apparaît en « SEO · Meta
1583
+ description », avec le titre déclaré dans le schéma.
1584
+ - **Le statut d'indexation** figure dans le sélecteur, sous le libellé
1585
+ « Indexable » et lu à l'endroit : « Indexable : oui » plutôt que « Noindex :
1586
+ non ». Un `noindex` non renseigné vaut indexable, ce qui est la valeur par
1587
+ défaut d'un site.
1588
+ - Un filtre apparaît dans le sélecteur au-delà de huit champs : sur un schéma
1589
+ fourni, on cherche un nom plutôt qu'on ne parcourt une liste.
1590
+
1591
+ ### Changé
1592
+
1593
+ - **`documentColumns` devient additif.** Le schéma fournit l'essentiel ; la
1594
+ configuration ne sert plus qu'à ce que le parcours ne sait pas exprimer — un
1595
+ chemin profond, ou plusieurs chemins fusionnés. Les deux colonnes par défaut
1596
+ codées en dur (meta description, titre SEO) disparaissent : le schéma les
1597
+ donne, et mieux nommées.
1598
+ - **La requête ne projette que les colonnes cochées.** Remonter tout le
1599
+ document de 500 pages pour des valeurs que personne ne regarde coûterait
1600
+ cher ; `usePages` prend désormais les colonnes affichées en argument.
1601
+
1602
+ ### Notes
1603
+
1604
+ - Tableaux, images, fichiers et références sont écartés : une cellule ne peut
1605
+ pas les rendre, et une référence demanderait une jointure.
1606
+ - Vérifié contre le schéma compilé d'un projet client, pas seulement sur des
1607
+ types construits pour le test.
1608
+
1609
+ ## 1.0.0 — renommage avant publication
1610
+
1611
+ ### Changé
1612
+
1613
+ - **Le paquet devient `@nocode-factory/sanity-kit`.** GitHub Packages exige que
1614
+ la portée corresponde exactement au propriétaire du dépôt, et l'organisation
1615
+ s'écrit `nocode-factory`. Rien n'étant encore publié, le renommage ne casse
1616
+ aucune installation existante — mais c'est la dernière occasion de le faire
1617
+ sans coût.
1618
+
1619
+ ## 0.9.0 — données de la page en colonnes
1620
+
1621
+ ### Ajouté
1622
+
1623
+ - **Les données du document s'affichent en colonnes.** Le sélecteur de colonnes
1624
+ propose une section « Données de la page » : meta description et titre SEO
1625
+ par défaut, remplaçables par `documentColumns` en configuration. Comme pour
1626
+ `noindexField`, chaque colonne essaie plusieurs chemins et retient le premier
1627
+ renseigné, les conventions de champ SEO variant d'un projet à l'autre.
1628
+ - **Les choix d'une colonne liste se gèrent depuis son en-tête**, là où on la
1629
+ vient de créer, et plus seulement depuis une cellule.
1630
+
1631
+ ### Changé
1632
+
1633
+ - L'ajout d'un choix passe par un bouton « Ajouter un choix » plutôt qu'un
1634
+ champ vide en permanence : au bas d'une liste, un champ vide se lit comme un
1635
+ choix existant.
1636
+ - Les colonnes de données sont masquées tant qu'on ne les coche pas. Un tableau
1637
+ de pages n'est pas un export SEO.
1638
+
1639
+ ### Corrigé
1640
+
1641
+ - Un panneau ouvert depuis une commande qui n'apparaît qu'au survol se fermait
1642
+ dès qu'on déplaçait la souris vers lui : le déclencheur se démontait sous le
1643
+ panneau. `InlinePopover` signale désormais son ouverture à son parent.
1644
+
1645
+ ### Notes
1646
+
1647
+ - Une valeur qui ne tient pas sur une ligne (objet, tableau de sections) laisse
1648
+ la cellule vide plutôt que d'afficher `[object Object]`.
1649
+ - Les chemins et les clés déclarés sont filtrés avant d'entrer dans la requête
1650
+ GROQ ; un chemin douteux projette `null` au lieu d'être interpolé.
1651
+
1652
+ ## 0.8.0 — choix de colonnes éditables
1653
+
1654
+ ### Ajouté
1655
+
1656
+ - **Les colonnes de type liste gèrent leurs choix là où on s'en sert.** Un clic
1657
+ sur la valeur ouvre la liste des choix : on en sélectionne un, on en ajoute
1658
+ un en le saisissant, on en supprime un, on lui donne une couleur. Plus besoin
1659
+ d'un réglage à part pour une opération qui appartient au moment où l'on
1660
+ remplit la case.
1661
+ - **Les colonnes de gestion interne sont éditables depuis le volet latéral**
1662
+ des vues Arbo et Cerveau, sous « Gestion interne ». Jusqu'ici le volet ne
1663
+ proposait que l'étiquette, alors que c'est souvent depuis la carte qu'on
1664
+ veut qualifier une page.
1665
+
1666
+ ### Changé
1667
+
1668
+ - Le tableau n'utilise plus un `<select>` natif pour les colonnes liste : le
1669
+ même composant sert dans le tableau et dans le volet, pour qu'on n'ait pas à
1670
+ apprendre deux interfaces pour une même donnée.
1671
+ - Hors tableau, un champ de valeur montre son cadre au repos. Dans une grille
1672
+ dense la bordure concurrence la donnée ; dans un volet, son absence cache
1673
+ qu'on peut écrire.
1674
+
1675
+ ### Notes
1676
+
1677
+ - Supprimer un choix vide la valeur de la page ouverte si elle le portait. Les
1678
+ autres pages gardent une référence orpheline, qui s'affiche « — » et se
1679
+ corrige au prochain passage.
1680
+
1681
+ ## 0.7.0 — passage de design
1682
+
1683
+ Passe complète en mode Operate : la couleur sert l'état, la donnée prime sur
1684
+ le décor, et la familiarité se gagne plutôt qu'elle ne s'invente.
1685
+
1686
+ ### Changé
1687
+
1688
+ - **Trois onglets de même niveau** : Liste, Arbo, Cerveau. L'arborescence et le
1689
+ cerveau étaient imbriqués dans un « Board » : un palier de navigation pour
1690
+ rien.
1691
+ - **Chemins lisibles** : chasse fixe, préfixe atténué, dernier segment appuyé.
1692
+ C'est l'identifiant que les éditeurs reconnaissent, pas le titre. Un clic
1693
+ ouvre la page sur le site en ligne ; le titre, lui, ouvre Presentation.
1694
+ - **Couleurs rendues au second plan** : teinte de fond à 7 % au lieu de 14 %,
1695
+ plus aucune bordure gauche colorée, et une pastille de 6 px porte le critère.
1696
+ - **Contrôles effacés** dans le tableau : les menus et les champs ne montrent
1697
+ leur cadre qu'au survol de la ligne ou au focus. Une bordure par cellule
1698
+ concurrençait la donnée.
1699
+ - **Filtres réduits** à la recherche. Type, statut et langue faisaient doublon
1700
+ avec le regroupement, qui distingue sans masquer.
1701
+ - **Ordre par défaut de la liste** : celui de la structure du Studio — les
1702
+ types dans l'ordre de `pageTypes`, puis les titres.
1703
+ - **Grille des composants dépouillée** : capture, nom, référence technique,
1704
+ compteur. Le détail appartient à la fiche, au clic. La référence apparaît
1705
+ aussi sur les tuiles du canvas.
1706
+ - **Cartes du board à la taille de leur capture** : le ratio de l'image mesuré
1707
+ au chargement donne la hauteur de la carte, et le placement se recalcule.
1708
+ Une page longue produit une carte haute, ce qui est déjà une information.
1709
+
1710
+ ### Ajouté
1711
+
1712
+ - Masquage des colonnes Statut, Blocs, Modifiée et Étiquette.
1713
+ - **Indexation** lue dans le CMS (`seo.noindex` puis `noindex` par défaut,
1714
+ configurable par `noindexField`), signalée par un badge quand elle bloque, et
1715
+ disponible comme critère de regroupement.
1716
+ - Étiquette modifiable au clic dans la liste, par un sélecteur flottant — et
1717
+ toujours depuis la fiche latérale de l'arbo et du cerveau.
1718
+ - Bouton « Voir sur le design system » sur la fiche d'un composant.
1719
+
1720
+ ### Corrigé
1721
+
1722
+ - Les glyphes Unicode qui tenaient lieu d'icônes (`✕`, `‹`, `▸`) sont remplacés
1723
+ par les icônes de `@sanity/icons`.
1724
+ - Chiffres et dates alignés en colonne (chasse tabulaire).
1725
+
1726
+ ## 0.6.3 — une seule source de colonnes
1727
+
1728
+ ### Corrigé
1729
+
1730
+ - **Le board colorait d'après la configuration, pas d'après tes colonnes.**
1731
+ « Colorer par » y proposait `internalFields` du code, donc des colonnes
1732
+ supprimées depuis et pas celles créées dans la liste. Les deux vues passent
1733
+ désormais par `useInternalColumns`, seul endroit qui arbitre entre le jeu de
1734
+ départ de la configuration et les colonnes réglées dans le document.
1735
+ - Supprimer la colonne servant à colorer laissait le sélecteur sur une valeur
1736
+ inexistante : `resolveColorBy` le ramène sur l'étiquette.
1737
+
1738
+ ## 0.6.2 — lisibilité et correction des colonnes
1739
+
1740
+ ### Corrigé
1741
+
1742
+ - **La suppression d'une colonne ne tenait pas.** Deux causes. D'une part,
1743
+ vider la dernière colonne faisait retomber la liste sur les valeurs par
1744
+ défaut de la configuration : un marqueur `columnsSet` distingue désormais
1745
+ « jamais réglé » de « volontairement vidé ». D'autre part, `useBoardLayout`
1746
+ était appelé dans trois composants, chacun avec son propre état ; comme le
1747
+ document est réécrit en entier à chaque enregistrement, une instance pouvait
1748
+ écraser les colonnes d'une autre. Il n'y en a plus qu'une, fournie par
1749
+ `BoardLayoutProvider`.
1750
+ - Le bas des cartes du board était rogné : le bloc de texte avait une hauteur
1751
+ calculée, que la contre-échelle du zoom faisait déborder. Il se dimensionne
1752
+ maintenant lui-même et l'aperçu prend la place restante.
1753
+
1754
+ ### Ajouté
1755
+
1756
+ - **Texte lisible à tout niveau de zoom** : la police des nœuds, des tuiles de
1757
+ sections et des annotations grandit à l'inverse du zoom, bornée à 2,4×.
1758
+ Dézoomé, le menu d'étiquette cède la place à son libellé en toutes lettres.
1759
+ - **Flèches sur les liens** du board : le sens se lit sans survol. Les ancres
1760
+ étaient déjà correctes — entrées en haut du nœud, sorties en bas — mais rien
1761
+ ne le signalait.
1762
+
1763
+ ## 0.6.1 — lecture du board
1764
+
1765
+ ### Changé
1766
+
1767
+ - **La mise en évidence suit la sélection.** Cliquer une page garde ses liens
1768
+ et ses voisines allumés ; le survol reste un état temporaire qui prime.
1769
+ Auparavant tout s'éteignait dès que la souris quittait le nœud, juste au
1770
+ moment où l'on consultait sa fiche.
1771
+ - **Carte simplifiée en vue arborescence** : plus de fond teinté ni de bord
1772
+ coloré, seulement la capture de la page et une pastille de couleur en haut.
1773
+ La couleur du critère informe sans concurrencer la capture.
1774
+
1775
+ ### Corrigé
1776
+
1777
+ - L'étiquette de la fiche s'affichait en texte clair sur fond clair : elle
1778
+ devient une pastille suivie de son libellé, dont le contraste ne dépend plus
1779
+ de la couleur choisie.
1780
+
1781
+ ## 0.6.0 — colonnes libres, annotations, lecture du maillage
1782
+
1783
+ ### Changé
1784
+
1785
+ - **Les colonnes de gestion interne se créent depuis l'interface**, comme dans
1786
+ un tableur : ajout, renommage, réordonnancement, suppression. Elles vivent
1787
+ désormais dans le document du kit et non plus dans la configuration, qui ne
1788
+ fournit plus qu'un jeu de départ. L'onglet séparé disparaît : tout se passe
1789
+ dans la liste des pages.
1790
+ - **Ouvrir une page mène à Presentation**, plus à la structure : on veut voir
1791
+ la page, pas remplir son formulaire. Sans `previewUrl`, on retombe sur
1792
+ l'édition. Le bouton « Modifier » reste disponible dans la fiche.
1793
+ - **Les liens du board sont des courbes libres**, plus des coudes à angle
1794
+ droit, qui se superposaient dès que le maillage se densifiait.
1795
+
1796
+ ### Ajouté
1797
+
1798
+ - **Regroupement repliable** : les groupes de la liste s'ouvrent et se ferment
1799
+ d'un clic.
1800
+ - **Couleur choisie sur la liste aussi**, teintant la ligne entière comme le
1801
+ board teinte la carte.
1802
+ - **Annotations sur les deux canvas** : notes et formes déplaçables,
1803
+ redimensionnables, éditables au double-clic, en cinq couleurs, posées
1804
+ derrière les nœuds.
1805
+ - **Lecture du maillage au survol**, façon graphe de connaissances : la page
1806
+ pointée et ses voisines directes restent nettes, ses liens s'allument, tout
1807
+ le reste s'efface.
1808
+ - 19 tests supplémentaires ; 190 au total.
1809
+
1810
+ ## 0.5.0 — captures, gestion interne, couleurs
1811
+
1812
+ ### Ajouté
1813
+
1814
+ - **Captures des pages publiées** : un script Playwright et un workflow GitHub
1815
+ Actions (`templates/page-screenshots/`) photographient chaque page en ligne,
1816
+ pleine hauteur, et les commitent dans `web/public/pages/`. Le board les
1817
+ affiche via `pageThumbnail`, et retombe sur l'aperçu iframe quand une capture
1818
+ manque. Les nœuds passent en portrait dès qu'une capture existe : une page
1819
+ fait couramment 1280 × 4000, elle serait illisible dans une carte paysage.
1820
+ - **Onglet « Gestion interne »** dans l'outil Pages : responsable, cible, rôle
1821
+ par défaut, et autant de colonnes qu'on veut via `internalFields` (texte ou
1822
+ liste de choix). Les valeurs vivent dans le document du kit.
1823
+ - **Regroupement de la liste** par étiquette, statut, type ou n'importe quel
1824
+ champ de gestion interne. Les groupes suivent l'ordre de la configuration,
1825
+ « Non renseigné » ferme la marche.
1826
+ - **Choix du critère de couleur** du board : étiquette, statut ou champ
1827
+ interne. Un champ libre reçoit une teinte déduite de sa valeur, stable d'une
1828
+ session à l'autre. La couleur teinte toute la carte, plus seulement son bord.
1829
+ - **Fiche de page** au clic sur un nœud, dans les deux vues : capture pleine
1830
+ page, statut, nombre de liens entrants et sortants, et changement
1831
+ d'étiquette — indispensable en vue cerveau, où une pastille ne peut rien
1832
+ porter.
1833
+ - **Carte des sections déplaçable**, positions enregistrées, et sélection au
1834
+ clic plutôt qu'au survol : un panneau qui disparaît au moindre mouvement
1835
+ interdisait de cliquer les pages qu'il listait.
1836
+ - Tri des composants **par type**, devenu l'ordre par défaut de la grille et de
1837
+ la carte.
1838
+ - 36 tests supplémentaires ; 171 au total.
1839
+
1840
+ ### Corrigé
1841
+
1842
+ - Le script de capture produisait `//a/b` quand un slug portait déjà un slash
1843
+ de tête — cas réel rencontré sur `/nous-choisir/a-propos`.
1844
+
1845
+ ## 0.4.0 — liens réels, étiquettes, tailles, cartes
1846
+
1847
+ ### Changé
1848
+
1849
+ - **Le board relie les pages par leurs liens réels**, plus par la hiérarchie
1850
+ des slugs. Une arête existe quand le contenu d'une page pointe vers une
1851
+ autre. Deux formes reconnues sans rien supposer du schéma : les chaînes de
1852
+ chemin (`href: "/contact"`), y compris dans les annotations de texte riche,
1853
+ et les références Sanity. Une page que rien ne lie apparaît isolée : c'est
1854
+ une information, pas un défaut.
1855
+
1856
+ ### Ajouté
1857
+
1858
+ - **Vue cerveau**, façon graphe de connaissances : pastilles dimensionnées par
1859
+ le nombre de liens, réparties par l'algorithme `stress` d'elkjs. Aucune
1860
+ dépendance supplémentaire.
1861
+ - **Étiquettes de suivi** posables sur chaque page — En cours, Fait, À relire,
1862
+ À refondre par défaut, remplaçables par `boardTags`. Elles colorent le nœud
1863
+ et la minimap, filtrent le board, et vivent dans le document du kit : aucun
1864
+ schéma client n'est modifié.
1865
+ - **Redimensionnement manuel** des nœuds, conservé avec la position.
1866
+ - **Carte des sections** dans l'outil Composants : tuiles dimensionnées par
1867
+ l'usage, et au survol d'une section le panneau liste les pages qui
1868
+ l'utilisent, cliquables, pendant que le reste s'estompe.
1869
+ - Une seule requête de contenu sert désormais au comptage des occurrences et à
1870
+ la détection des liens.
1871
+ - 40 tests supplémentaires ; 135 au total.
1872
+
1873
+ ### Corrigé
1874
+
1875
+ - Les tuiles de la carte laissaient un vide sous leur vignette : `Stack` de
1876
+ `@sanity/ui` est une grille, `flex: 1` n'y a aucun effet.
1877
+
1878
+ ## 0.3.0 — phase 4 (board)
1879
+
1880
+ ### Ajouté
1881
+
1882
+ - **Vue board** dans l'outil Pages, à côté de la liste : canvas React Flow avec
1883
+ déplacement, zoom, minimap, contrôles et vue d'ensemble.
1884
+ - Placement automatique par elkjs selon la hiérarchie des chemins. Une page se
1885
+ rattache à la page existante au chemin ancêtre le plus proche : un niveau
1886
+ intermédiaire manquant ne détache pas tout son sous-arbre.
1887
+ - Positions déplacées à la main enregistrées dans le singleton
1888
+ `ncfBoardLayout`, écrit après la fin du geste. « Réorganiser automatiquement »
1889
+ efface la disposition manuelle et recalcule.
1890
+ - Nœud = aperçu du site, titre, chemin, badge de statut et type. L'aperçu est
1891
+ une iframe live chargée au survol ou au zoom suffisant, jamais au chargement.
1892
+ - Minimap colorée par statut, double-clic pour ouvrir la page dans le Studio.
1893
+ - Signalement des chemins en double et des pages sans chemin calculable.
1894
+ - React Flow habillé via ses variables CSS pour suivre le thème du Studio.
1895
+ - elkjs (1,5 Mo) chargé par import dynamique, avec repli en grille si le calcul
1896
+ échoue.
1897
+ - 14 tests supplémentaires sur la construction du graphe et la fusion des
1898
+ positions ; 109 au total.
1899
+
1900
+ ### Corrigé
1901
+
1902
+ - L'aperçu du board rendait la version mobile du site : l'iframe était ramenée
1903
+ à la largeur du nœud par le contexte de mise en page. Largeur forcée à
1904
+ 1280 px, vérifié sur le style calculé.
1905
+
1906
+ ## 0.2.0 — phase 3 (Pages et Composants)
1907
+
1908
+ ### Ajouté
1909
+
1910
+ - **Outil Pages** : liste de toutes les pages, brouillons compris. Colonnes
1911
+ titre, type, chemin, statut, nombre de blocs, date de mise à jour ; tri par
1912
+ colonne, filtres par type, statut et langue, recherche insensible aux accents
1913
+ sur le titre et le chemin. Un clic ouvre le document dans le Studio.
1914
+ Pagination à 100 lignes et rafraîchissement automatique sur mutation.
1915
+ - **Outil Composants** : bibliothèque des blocs lue dans le schéma du Studio
1916
+ (jamais saisie à la main), avec vignette issue des captures du design system,
1917
+ nombre d'occurrences imbriquées comprises, pages où le bloc apparaît, et lien
1918
+ vers la page de démonstration. Tri par usage, mise en évidence des blocs
1919
+ jamais utilisés.
1920
+ - Utilitaires purs testés : comptage récursif des occurrences, découverte des
1921
+ types de blocs dans le schéma, construction des lignes de la liste, tri,
1922
+ filtres, et génération des requêtes GROQ.
1923
+ - 95 tests unitaires.
1924
+
1925
+ ### Vérifié
1926
+
1927
+ Chiffres d'occurrences confrontés à un script de comptage indépendant sur le
1928
+ jeu de données du playground : `hero 20, richText 14, cta 11, imageText 7,
1929
+ columns 5, faq 4`, blocs imbriqués dans `section.columns` compris.
1930
+
1931
+ ### Corrigé
1932
+
1933
+ - Le code en ligne des messages de configuration s'affichait en blocs pleine
1934
+ largeur (`Code` de `@sanity/ui` est un bloc).
1935
+
1936
+ ## 0.1.0 — phase 1 (socle)
1937
+
1938
+ ### Ajouté
1939
+
1940
+ - Monorepo pnpm : `packages/sanity-kit`, `apps/playground`, `supabase`, `docs`.
1941
+ - Plugin `ncfKit()` enregistrant trois outils dans le Studio : **Pages**,
1942
+ **Composants**, **Historique** (coquilles fonctionnelles).
1943
+ - Configuration typée, avec valeurs par défaut et validation au démarrage.
1944
+ Une option invalide n'empêche jamais le Studio de démarrer : l'onglet
1945
+ concerné affiche ce qu'il faut corriger, en distinguant erreur et
1946
+ avertissement.
1947
+ - Prise en charge des pages sans slug (`path` fixe) et des sites multilingues
1948
+ (`i18n`).
1949
+ - Type `ncfBoardLayout` déclaré par le plugin et retiré du menu « Créer ».
1950
+ - Utilitaires purs testés : résolution et validation de configuration,
1951
+ construction des chemins et URL, hiérarchie des slugs, conversion des noms de
1952
+ blocs et gabarits d'aperçu, fusion publié / brouillon / version de release.
1953
+ - Playground : Studio v6, 2 types de pages, 6 blocs dont un conteneur imbriqué,
1954
+ seed idempotent de 22 documents en deux langues et trois statuts.
1955
+ - 60 tests unitaires, build `pkg-utils`, CI GitHub Actions.
1956
+
1957
+ ### À savoir
1958
+
1959
+ - Le playground utilise le dataset `staging` du projet `xrwnc0un`
1960
+ (voir `docs/DECISIONS.md`, point 6).
1961
+ - Les trois outils n'affichent pas encore de données réelles : phases 2 à 4.