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