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