@nocode-factory/sanity-kit 2.62.0 → 2.64.0-rc.1

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 CHANGED
@@ -1,5 +1,81 @@
1
1
  # Journal des versions
2
2
 
3
+ ## 2.64.0 : Studio, la valeur qui s'applique est toujours cochée ; onglet Composants plus lisible
4
+
5
+ ### Ajouté
6
+
7
+ - **`withNcfChoiceInputs(types, options)`** (sanity.config.ts) : dans les sections, leurs
8
+ valeurs par défaut et les champs style / taille des liens, chaque liste de choix (fond,
9
+ position de l'image, mise en page, style et taille du bouton...) COCHE la valeur qui
10
+ s'applique : la valeur par défaut du composant (Réglages > Composants), sinon celle du
11
+ code (`options.ncfFallback`, sinon la première), marquée « (défaut) », sans l'enregistrer.
12
+ Choisir une autre valeur l'enregistre : la pastille bleue et sa croix de retour au défaut
13
+ apparaissent ; recliquer sur « (défaut) » revient à l'héritage. Avant, rien n'était coché
14
+ tant qu'on n'avait pas choisi : impossible de savoir ce qui s'affichait.
15
+ - **Niveaux de titre** (`options.ncfHeadingLevel`) : le niveau logique du composant
16
+ coché « (défaut) » (heading-levels.json, la même source que le site) ; titres des
17
+ éléments : un niveau sous le titre de la section, coché aussi. Option P (aspect de
18
+ titre, sans valeur de titre).
19
+ - **Carré de couleur** à côté du nom (`options.ncfSwatches`, jetons de design-tokens.json)
20
+ et **cartes illustrées** des mises en page (`options.ncfThumbs`, schéma SVG par valeur).
21
+ - **Curseur** pour un nombre avec `options.range` ({min, max, step, labels, unit}).
22
+ - **Texte d'un élément de liste vide** : « vide : rien ne s'affiche » dans le champ.
23
+ - **« Add item » sur une liste héritée** des valeurs par défaut : recopie d'abord les
24
+ éléments par défaut, la section ne disparaît plus de l'aperçu.
25
+ - Options : `colors`, `headingLevels`, `labels` (anglais par défaut), `fallbacks`
26
+ ({'secondary.style': 'secondary'}), `defaultsType`, `namespace`, `linkType`.
27
+ - **Onglet Composants** : vue par groupes, un groupe sur deux sur un fond teinté ; chaque
28
+ vignette montre d'abord la mosaïque de toutes les dispositions du composant
29
+ (`/sections/<nom>--dispositions.png`), sinon la capture simple.
30
+ - **`doctor`** : ✖ « Choix pré-cochés » tant que withNcfChoiceInputs n'est pas branché
31
+ (⚠ si le projet a encore sa propre copie, ex. Société Paul Ricard avant 2.64.0).
32
+
33
+ ### À brancher dans le projet
34
+
35
+ - **sanity.config.ts** : `types: ... withNcfChoiceInputs(schemaTypes, {colors: tokens.colors,
36
+ headingLevels, labels: {default: '(défaut)', reset: 'Réinitialiser', emptyItem: "Vide : rien
37
+ ne s'affiche"}})` (`tokens` = web/app/lib/design-tokens.json, `headingLevels` =
38
+ web/app/lib/heading-levels.json), au plus près des types (avant withNcfFormTabs).
39
+ - **Niveaux de titre** : `headingLevelField` / `itemHeadingLevelField` du starter avec
40
+ `options.ncfHeadingLevel` ({section: type} / {item: true}), sans `components.input` ni
41
+ `layout: 'radio'` ; supprimer `studio/schemaTypes/sections/HeadingLevelInput.tsx`.
42
+ - **Valeur du code** d'une liste dont le site ne prend pas la première valeur :
43
+ `options.ncfFallback` (sinon le Studio cocherait une autre valeur que celle affichée).
44
+ - **Mosaïques de l'onglet Composants** (facultatif) : `web/scripts/screenshot-sections.mjs`
45
+ du starter (produit `<nom>--dispositions.png` dans la CI des captures).
46
+ - Projet qui avait sa propre copie (Paul Ricard) : la remplacer par withNcfChoiceInputs.
47
+
48
+ ## 2.63.0 : PageSpeed, l'image LCP vérifiée sur chaque page (jamais lazy, fetchpriority=high)
49
+
50
+ ### Ajouté
51
+
52
+ - **`npx ncf-kit check-lcp`** : les deux alertes « essentielles » de PageSpeed Insights
53
+ (« les ressources LCP ne doivent pas utiliser loading=lazy », « fetchpriority=high doit
54
+ être appliqué ») vérifiées par une machine. Le site construit est démarré, les pages de
55
+ la sitemap ouvertes dans un vrai navigateur, en mobile et en ordinateur (écrans de
56
+ PageSpeed) ; l'élément LCP réel de chaque page doit être chargé tout de suite et en
57
+ priorité, sinon échec avec la page, l'écran et l'image en cause. `--url <adresse>`
58
+ pour auditer un site en ligne, `--all` pour toutes les pages. Constat à l'origine : sur
59
+ Société Paul Ricard, 45 alertes (22 pages sur 26 sans fetchpriority, 2 images LCP en
60
+ lazy) alors que la consigne était écrite ; Next 16 a déprécié `priority`, qui ne pose
61
+ plus fetchpriority.
62
+ - **`doctor`** : ✖ « PageSpeed : image LCP » tant que la CI du projet ne lance pas
63
+ `check-lcp` (ou que playwright manque au site).
64
+
65
+ ### À brancher dans le projet
66
+
67
+ - **CI** (`.github/workflows/ci.yml`, job du site, après `npm run build`, mêmes variables
68
+ d'environnement que le build) : `npx playwright install --with-deps chromium` puis
69
+ `npx ncf-kit check-lcp`. `playwright` en devDependency du site (le starter l'a).
70
+ - **Images du haut de page** : reprendre du starter `lcpImageProps` /
71
+ `aboveFoldImageProps` (`web/components/SanityImage.tsx`, `<SanityImage priority />`
72
+ ne passe plus `priority` à next/image), et dans chaque section qui peut être en haut de
73
+ page, appliquer la prop `priority` à ses grandes images (`{...lcpImageProps(priority)}`)
74
+ et `eager` aux petites. Remplacer tout `priority` / `preload` seul sur next/image.
75
+ Contrôle au build : règle 21 de `web/scripts/check-rules.mjs` du starter.
76
+ - **CLAUDE.md** : règle « IMAGE LCP » du starter (rubrique PageSpeed).
77
+ - Lancer `npx ncf-kit check-lcp` après un build local, corriger jusqu'à zéro ✖.
78
+
3
79
  ## 2.62.0 : le bouton de mise à jour du Studio copie la consigne complète pour Claude Code
4
80
 
5
81
  ### Changé
package/README.md CHANGED
@@ -239,6 +239,26 @@ Après chaque `next build` (donc à chaque déploiement Vercel), il démarre le
239
239
  en production puis en préproduction simulées et fait 25 contrôles. Un seul échec fait
240
240
  échouer le build : rien n'est mis en ligne. `--page <chemin>` choisit la page témoin.
241
241
 
242
+ ## PageSpeed : image LCP (CI)
243
+
244
+ Les deux alertes « essentielles » de PageSpeed Insights sur l'image LCP (la plus grande
245
+ image visible au chargement) : jamais `loading="lazy"`, toujours `fetchpriority="high"`.
246
+ `npx ncf-kit check-lcp`, depuis le dossier du site, après `next build` : démarre le site
247
+ construit, ouvre les pages de la sitemap dans Chromium (Playwright du site), en mobile
248
+ (412 x 823) et en ordinateur (1350 x 940), lit le vrai élément LCP et échoue au moindre
249
+ écart. En CI (il faut un navigateur, absent du build Vercel) :
250
+
251
+ ```yaml
252
+ - run: npx playwright install --with-deps chromium
253
+ - run: npx ncf-kit check-lcp
254
+ ```
255
+
256
+ Par défaut, toutes les pages à la racine et 5 pages par dossier (`--per-group <n>`) ;
257
+ `--all` pour toutes, `--page <chemin>` (répétable) pour une page, `--url <adresse>` pour
258
+ un site déjà en ligne. Côté site : `lcpImageProps(priority)` (preload + fetchPriority high
259
+ + eager) du starter, jamais `priority` de next/image (déprécié en Next 16, sans
260
+ fetchpriority). `doctor` vérifie l'étape de CI.
261
+
242
262
  ## Documentation
243
263
 
244
264
  Dans le dépôt `nocode-factory/ncf-sanity-kit` : `docs/INSTALL.md` (options),
@@ -0,0 +1,195 @@
1
+ // CONTRÔLE LCP (PageSpeed) : `npx ncf-kit check-lcp`, depuis le dossier du site, APRÈS
2
+ // `next build` (CI : il faut un navigateur, absent du build Vercel). Deux alertes
3
+ // « essentielles » de PageSpeed Insights, vérifiées sur le VRAI élément LCP de chaque
4
+ // page, en mobile et en ordinateur (mêmes écrans que PageSpeed) :
5
+ // 1. l'image LCP n'est jamais en loading="lazy" ;
6
+ // 2. l'image LCP porte fetchpriority="high".
7
+ // Côté site : <Image preload fetchPriority="high" /> (Next 16 : `priority` est déprécié
8
+ // et ne pose pas fetchpriority), sur l'image du haut de page seulement.
9
+ //
10
+ // Pages testées : celles de la sitemap du site construit (5 par dossier par défaut,
11
+ // une fiche de collection vaut ses voisines ; --all pour toutes).
12
+ // Options :
13
+ // --url <adresse> teste un site déjà en ligne au lieu de démarrer le build local
14
+ // --all toutes les pages de la sitemap
15
+ // --per-group <n> pages par dossier (défaut 5)
16
+ // --page <chemin> une seule page (répétable)
17
+ // Prérequis : playwright dans le site (devDependency) et Chromium
18
+ // (`npx playwright install --with-deps chromium`).
19
+ import { spawn } from "node:child_process";
20
+ import { createServer } from "node:net";
21
+ import { existsSync } from "node:fs";
22
+ import { createRequire } from "node:module";
23
+ import { join } from "node:path";
24
+
25
+ const args = process.argv.slice(2);
26
+ const flag = (name) => {
27
+ const i = args.indexOf(`--${name}`);
28
+ return i >= 0 ? args[i + 1] : undefined;
29
+ };
30
+ const flags = (name) => args.flatMap((a, i) => (a === `--${name}` && args[i + 1] ? [args[i + 1]] : []));
31
+ const has = (name) => args.includes(`--${name}`);
32
+ const PER_GROUP = Number(flag("per-group") ?? 5);
33
+
34
+ // Écrans de PageSpeed Insights (Lighthouse) : mobile et ordinateur.
35
+ const VIEWPORTS = [
36
+ { name: "mobile", viewport: { width: 412, height: 823 }, deviceScaleFactor: 1.75, isMobile: true, hasTouch: true },
37
+ { name: "ordinateur", viewport: { width: 1350, height: 940 }, deviceScaleFactor: 1, isMobile: false, hasTouch: false },
38
+ ];
39
+
40
+ const fail = (message) => {
41
+ console.error(`✖ Contrôle LCP : ${message}`);
42
+ process.exit(1);
43
+ };
44
+
45
+ let chromium;
46
+ try {
47
+ ({ chromium } = createRequire(join(process.cwd(), "package.json"))("playwright"));
48
+ } catch {
49
+ fail("playwright absent du site. Ajouter la dépendance (npm i -D playwright), puis `npx playwright install --with-deps chromium`.");
50
+ }
51
+
52
+ const freePort = () =>
53
+ new Promise((resolve, reject) => {
54
+ const srv = createServer();
55
+ srv.once("error", reject);
56
+ srv.listen(0, () => {
57
+ const { port } = srv.address();
58
+ srv.close(() => resolve(port));
59
+ });
60
+ });
61
+
62
+ // Site construit démarré comme en CI : sans les variables internes de Vercel (avec
63
+ // elles, `next start` se croit derrière le routage Vercel et redirige en boucle).
64
+ async function startBuiltSite() {
65
+ if (!existsSync(".next/BUILD_ID")) fail("aucun build (.next) ici. Lancer après `next build`, depuis le dossier du site (ou passer --url).");
66
+ if (!existsSync("node_modules/next/dist/bin/next")) fail("lancer depuis le dossier du site Next.js (node_modules/next introuvable).");
67
+ const port = await freePort();
68
+ const env = Object.fromEntries(Object.entries(process.env).filter(([k]) => !/^(VERCEL|__VERCEL|NOW_|NEXT_PRIVATE|__NEXT_PRIVATE|NEXT_EDGE_RUNTIME_PROVIDER)/.test(k)));
69
+ const server = spawn(process.execPath, ["node_modules/next/dist/bin/next", "start", "-p", String(port)], { stdio: ["ignore", "pipe", "pipe"], env });
70
+ let log = "";
71
+ server.stdout.on("data", (d) => (log += d));
72
+ server.stderr.on("data", (d) => (log += d));
73
+ let exited = null;
74
+ server.on("exit", (c) => (exited = c));
75
+ const base = `http://localhost:${port}`;
76
+ const deadline = Date.now() + 90_000;
77
+ for (;;) {
78
+ try {
79
+ if ((await fetch(`${base}/robots.txt`)).ok) break;
80
+ } catch {
81
+ /* pas encore prêt */
82
+ }
83
+ if (exited !== null) fail(`le site s'est arrêté (code ${exited})\n${log.slice(-2000)}`);
84
+ if (Date.now() > deadline) fail(`le site construit ne répond pas\n${log.slice(-2000)}`);
85
+ await new Promise((r) => setTimeout(r, 1000));
86
+ }
87
+ return { base, stop: () => server.kill("SIGTERM") };
88
+ }
89
+
90
+ // Pages de la sitemap, ramenées sur le site testé (la sitemap porte l'adresse de prod).
91
+ // Par défaut, quelques pages par dossier : les fiches d'une collection partagent un gabarit.
92
+ async function pagesFromSitemap(base) {
93
+ const res = await fetch(`${base}/sitemap.xml`);
94
+ if (!res.ok) fail(`/sitemap.xml répond ${res.status}`);
95
+ const xml = await res.text();
96
+ const paths = [...new Set([...xml.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/g)].map((m) => new URL(m[1]).pathname || "/"))];
97
+ if (!paths.length) fail("sitemap vide : aucune page à tester.");
98
+ if (has("all")) return paths;
99
+ const groups = new Map();
100
+ for (const p of paths) {
101
+ const parts = p.split("/").filter(Boolean);
102
+ const key = parts.length > 1 ? parts.slice(0, -1).join("/") : "(racine)";
103
+ const list = groups.get(key) ?? [];
104
+ groups.set(key, list);
105
+ // Les pages à la racine (pages du Studio, gabarits variés) sont toutes testées.
106
+ if (key === "(racine)" || list.length < PER_GROUP) list.push(p);
107
+ }
108
+ return [...groups.values()].flat();
109
+ }
110
+
111
+ // Script injecté avant le chargement : garde le dernier candidat LCP du navigateur.
112
+ const OBSERVE_LCP = () => {
113
+ window.__ncfLcp = null;
114
+ try {
115
+ new PerformanceObserver((list) => {
116
+ const entries = list.getEntries();
117
+ window.__ncfLcp = entries[entries.length - 1];
118
+ }).observe({ type: "largest-contentful-paint", buffered: true });
119
+ } catch {
120
+ /* navigateur sans LCP */
121
+ }
122
+ };
123
+
124
+ // Description de l'élément LCP : image (img, image d'un <picture>), sinon texte / fond CSS.
125
+ const READ_LCP = () => {
126
+ const e = window.__ncfLcp;
127
+ if (!e) return null;
128
+ const el = e.element;
129
+ const img = el?.tagName === "IMG" ? el : null;
130
+ return {
131
+ tag: el?.tagName?.toLowerCase() ?? "(élément retiré)",
132
+ url: e.url || "",
133
+ size: Math.round(e.size),
134
+ img: img
135
+ ? {
136
+ loading: img.getAttribute("loading"),
137
+ fetchpriority: img.getAttribute("fetchpriority"),
138
+ alt: img.getAttribute("alt") ?? "",
139
+ src: (img.currentSrc || img.src || "").slice(0, 160),
140
+ }
141
+ : null,
142
+ };
143
+ };
144
+
145
+ const short = (s, n = 60) => (s.length > n ? `${s.slice(0, n - 1)}…` : s);
146
+
147
+ const remote = flag("url");
148
+ const site = remote ? { base: remote.replace(/\/$/, ""), stop: () => {} } : await startBuiltSite();
149
+ const browser = await chromium.launch().catch((error) =>
150
+ fail(`Chromium introuvable (${error.message.split("\n")[0]}). Installer : npx playwright install --with-deps chromium`),
151
+ );
152
+ const problems = [];
153
+ let checked = 0;
154
+ let images = 0;
155
+ try {
156
+ const pages = flags("page").length ? flags("page") : await pagesFromSitemap(site.base);
157
+ for (const vp of VIEWPORTS) {
158
+ const context = await browser.newContext({ viewport: vp.viewport, deviceScaleFactor: vp.deviceScaleFactor, isMobile: vp.isMobile, hasTouch: vp.hasTouch });
159
+ await context.addInitScript(OBSERVE_LCP);
160
+ const page = await context.newPage();
161
+ for (const path of pages) {
162
+ const res = await page.goto(`${site.base}${path}`, { waitUntil: "load", timeout: 60_000 }).catch((error) => error);
163
+ if (res instanceof Error || !res?.ok()) {
164
+ problems.push(`${path} (${vp.name}) : page non chargée (${res instanceof Error ? res.message.split("\n")[0] : `HTTP ${res?.status()}`})`);
165
+ continue;
166
+ }
167
+ // Le LCP est figé à la première interaction : on laisse finir images et polices, sans toucher la page.
168
+ await page.waitForLoadState("networkidle", { timeout: 10_000 }).catch(() => {});
169
+ await page.waitForTimeout(500);
170
+ const lcp = await page.evaluate(READ_LCP);
171
+ checked++;
172
+ if (!lcp?.img) continue; // texte ou fond CSS : pas d'attribut à vérifier
173
+ images++;
174
+ const what = `image « ${short(lcp.img.alt || lcp.img.src)} »`;
175
+ if (lcp.img.loading === "lazy") problems.push(`${path} (${vp.name}) : ${what} est l'élément LCP mais en loading="lazy" (alerte PageSpeed « les ressources LCP ne doivent pas utiliser loading=lazy »)`);
176
+ if ((lcp.img.fetchpriority ?? "").toLowerCase() !== "high") problems.push(`${path} (${vp.name}) : ${what} est l'élément LCP sans fetchpriority="high" (alerte PageSpeed « fetchpriority=high doit être appliqué »)`);
177
+ }
178
+ await context.close();
179
+ }
180
+ console.log(`Contrôle LCP : ${pages.length} page(s) x ${VIEWPORTS.length} écrans, ${images} élément(s) LCP image sur ${checked}.`);
181
+ } finally {
182
+ await browser.close();
183
+ site.stop();
184
+ }
185
+
186
+ if (problems.length) {
187
+ console.error(`✖ Contrôle LCP : ${problems.length} problème(s)\n ${problems.join("\n ")}`);
188
+ console.error(
189
+ " Correction : l'image du haut de page (celle qui s'affiche en premier, en grand) prend\n" +
190
+ ' <Image preload fetchPriority="high" loading="eager" /> (Next 16 : jamais `priority`, déprécié) ;\n' +
191
+ " la section la reçoit par sa prop `priority` (première section de la page). Toutes les autres restent en lazy.",
192
+ );
193
+ process.exit(1);
194
+ }
195
+ console.log("✓ Contrôle LCP : aucune image LCP en lazy, fetchpriority=\"high\" partout.");
package/bin/ncf-kit.mjs CHANGED
@@ -37,6 +37,7 @@ function usage(code = 0) {
37
37
  npx ncf-kit upgrade [--version <v>] met le kit à jour (studio et web) + ce qu'il faut brancher + doctor
38
38
  npx ncf-kit doctor [--web <dossier>] [--offline] vérifie que le projet est complet
39
39
  npx ncf-kit check-environments [--page <chemin>] test prod / préprod, BLOQUANT (postbuild du site)
40
+ npx ncf-kit check-lcp [--url <adresse>] [--all] image LCP jamais lazy, fetchpriority=high (PageSpeed, CI du site)
40
41
  npx ncf-kit check-deploy [--skip-data] [--skip-doctor] avant sanity deploy : appId de CE projet, alerte _type et branchements
41
42
  npx ncf-kit translate-json [--from <langue>] [--apply] textes du site (messages/<langue>.json, titres du registre) traduits par IA
42
43
  npx ncf-kit translations [export] [--out <fichier>] champs « À traduire » → JSON (texte source et actuel)
@@ -351,6 +352,19 @@ async function doctor() {
351
352
  ? ok('Collections : vue tableur', 'ncfCollectionTable / ncfCollections dans la structure')
352
353
  : warn('Collections : vue tableur', "le kit propose une vue tableur des collections (tri, recherche, colonnes, export CSV, création) ; le projet ne la branche pas : dans la structure du Studio, .child(ncfCollectionTable(S, ncfOptions, type, {id, title})) sur chaque collection (voir collectionTable et byLanguage(..., asTable) dans studio/sanity.config.ts du starter). Les pages gardent la liste native.")
353
354
  }
355
+ // Saisies de choix (kit >= 2.64.0) : la valeur appliquée (valeur par défaut comprise)
356
+ // est toujours cochée, marquée « (défaut) », niveaux de titre compris. Branchement dans
357
+ // le projet : schema.types enveloppé par withNcfChoiceInputs (sanity.config.ts).
358
+ {
359
+ const studioSources = walk(studio).filter((f) => /\.(m?[jt]sx?)$/.test(f) && !f.includes('node_modules'))
360
+ const wired = studioSources.some((f) => /\bwithNcfChoiceInputs\(/.test(read(f)))
361
+ const local = studioSources.find((f) => /\bwithChoiceInputsOnTypes\(/.test(read(f)) && !/withChoiceInputsOnTypes\s*[=(][^\n]*=>|function withChoiceInputsOnTypes/.test(read(f)))
362
+ if (wired) ok('Choix pré-cochés', 'withNcfChoiceInputs (valeur par défaut cochée, niveaux de titre, curseurs)')
363
+ else if (local)
364
+ warn('Choix pré-cochés', `le projet a sa propre copie (${local.replace(root + '/', '')}) ; le kit la fournit désormais : remplacer withChoiceInputsOnTypes par withNcfChoiceInputs(types, {colors: tokens.colors, headingLevels, labels}) et supprimer studio/tools/design/{DefaultChoiceInput,HeadingLevelInput,ItemTextInput,InheritedListInput,RangeInput,choiceInputs,componentDefaults}.`)
365
+ else
366
+ ko('Choix pré-cochés', "le kit coche dans chaque liste de choix des sections (fond, style et taille du bouton, mise en page, niveau de titre...) la valeur qui s'applique, marquée « (défaut) » ; le projet ne le branche pas : dans sanity.config.ts, schema.types = withNcfChoiceInputs(types, {colors: tokens.colors, headingLevels, labels: {default: '(défaut)', reset: 'Réinitialiser', emptyItem: \"Vide : rien ne s'affiche\"}}) (voir le starter). Retirer la saisie propre au starter sur les niveaux de titre (HeadingLevelInput) au profit de options.ncfHeadingLevel.")
367
+ }
354
368
  if (!config.includes('ncfAllowedOrigins')) ko('Origines autorisées', "presentationTool sans allowOrigins: ncfAllowedOrigins(options) : l'aperçu de la préproduction s'affiche mais reste muet.")
355
369
  else ok('Origines autorisées', 'ncfAllowedOrigins')
356
370
  if (/preprodUrl\s*:\s*false/.test(config)) ko('Préproduction désactivée', "sanity.config contient preprodUrl: false : la préproduction conventionnelle est retirée. À n'utiliser que si le projet n'en a vraiment pas.")
@@ -522,6 +536,21 @@ async function doctor() {
522
536
  : warn('Schéma validé en CI', "le kit a besoin d'un schéma valide (valeurs par défaut des composants générées depuis les sections) ; le projet ne le vérifie pas : étape `npx sanity schema validate` dans .github/workflows/ci.yml (voir le starter). Sinon `sanity deploy` peut échouer sans prévenir.")
523
537
  }
524
538
 
539
+ /* PageSpeed, image LCP (kit >= 2.63.0) : les deux alertes « essentielles » de PageSpeed
540
+ Insights (image LCP jamais en lazy, fetchpriority="high") vérifiées en CI sur le vrai
541
+ élément LCP de chaque page, en mobile et en ordinateur. Il faut un navigateur : en CI,
542
+ pas dans le build Vercel. */
543
+ {
544
+ const wf = walk(join(root, '.github', 'workflows'))
545
+ const lcp = wf.find((f) => /ncf-kit check-lcp/.test(read(f)))
546
+ const webPkgText = read(join(web, 'package.json'))
547
+ if (!lcp)
548
+ ko('PageSpeed : image LCP', "le kit vérifie que l'image LCP de chaque page n'est jamais en loading=\"lazy\" et porte fetchpriority=\"high\" (alertes « essentielles » de PageSpeed) ; le projet ne le lance pas : dans .github/workflows/ci.yml, job du site, après `npm run build` : `npx playwright install --with-deps chromium` puis `npx ncf-kit check-lcp` (voir le starter). Corriger les images signalées : lcpImageProps / <SanityImage priority /> (components/SanityImage.tsx du starter).")
549
+ else if (webPkgText && !/"playwright"/.test(webPkgText))
550
+ ko('PageSpeed : image LCP', `${lcp.replace(root + '/', '')} lance check-lcp mais playwright manque au site : npm i -D playwright dans ${web.replace(root + '/', '')}.`)
551
+ else ok('PageSpeed : image LCP', `check-lcp en CI (${lcp.replace(root + '/', '')})`)
552
+ }
553
+
525
554
  /* Captures des composants */
526
555
  const workflows = walk(join(root, '.github', 'workflows'))
527
556
  const captures = workflows.find((f) => /public\/sections/.test(read(f)))
@@ -1119,6 +1148,9 @@ if (command === 'setup') {
1119
1148
  } else if (command === 'check-environments') {
1120
1149
  // Script autonome (il démarre le site construit) : chargé seulement à la demande.
1121
1150
  import('./check-environments.mjs').catch((error) => fail(error?.message ?? String(error)))
1151
+ } else if (command === 'check-lcp') {
1152
+ // Script autonome (navigateur Playwright du site) : chargé seulement à la demande.
1153
+ import('./check-lcp.mjs').catch((error) => fail(error?.message ?? String(error)))
1122
1154
  } else if (!command || command === 'help' || has('help')) {
1123
1155
  usage(command ? 0 : 1)
1124
1156
  } else {
package/dist/index.d.ts CHANGED
@@ -1290,6 +1290,50 @@ export declare function NcfKitNavbar(props: NavbarProps): import("react").JSX.El
1290
1290
  * feuille de style. Un seul `<style>` pour tout le Studio.
1291
1291
  */
1292
1292
  export declare function HelpTextStyle(props: LayoutProps): import("react").JSX.Element;
1293
+ /** Options de withNcfChoiceInputs (sanity.config.ts du projet). */
1294
+ interface NcfChoiceInputsOptions {
1295
+ /**
1296
+ * Couleurs de la charte, pour les carrés de couleur (options.ncfSwatches) : la clé
1297
+ * `colors` de web/app/lib/design-tokens.json ({jeton: {value: '#hex'}}).
1298
+ */
1299
+ colors?: Record<string, {
1300
+ value: string;
1301
+ }>;
1302
+ /**
1303
+ * Niveaux de titre logiques, la même source que le site : web/app/lib/heading-levels.json
1304
+ * ({default: 'h2', sections: {'section.hero': 'h1', ...}}).
1305
+ */
1306
+ headingLevels?: {
1307
+ default?: string;
1308
+ sections?: Record<string, string>;
1309
+ };
1310
+ /** Type du document des valeurs par défaut (défaut : componentDefaults). */
1311
+ defaultsType?: string;
1312
+ /** Préfixe des types de sections (défaut : « section. »). */
1313
+ namespace?: string;
1314
+ /** Type des liens dont les champs style et size reçoivent la saisie (défaut : link). */
1315
+ linkType?: string;
1316
+ /**
1317
+ * Repli propre à un emplacement, quand ni l'instance ni les valeurs par défaut ne
1318
+ * fixent la valeur : {'champParent.champ': valeur}. Ex. {'secondary.style': 'secondary'}
1319
+ * pour un bouton secondaire, comme le site (LinkButton defaultStyle).
1320
+ */
1321
+ fallbacks?: Record<string, string>;
1322
+ /** Libellés (interface du kit en anglais par défaut ; le starter les passe en français). */
1323
+ labels?: {
1324
+ default?: string;
1325
+ reset?: string;
1326
+ emptyItem?: string;
1327
+ };
1328
+ }
1329
+ /**
1330
+ * Saisies de choix du kit sur les types du projet (sanity.config.ts, `schema.types`) :
1331
+ * sections (et leur document de valeurs par défaut), champs style et size des liens.
1332
+ * Un champ qui a déjà sa propre saisie (components.input) n'est jamais remplacé.
1333
+ * Appliqué dans sanity.config.ts seulement : les scripts qui lisent les schémas
1334
+ * (npm run options, defaults:fill) n'importent aucun composant React.
1335
+ */
1336
+ export declare function withNcfChoiceInputs<T>(types: T[], options?: NcfChoiceInputsOptions): T[];
1293
1337
  /**
1294
1338
  * Comparaison de deux versions sémantiques.
1295
1339
  *
@@ -1438,7 +1482,7 @@ export declare function ActorName(props: {
1438
1482
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1439
1483
  * le vérifie.
1440
1484
  */
1441
- export declare const KIT_VERSION = "2.62.0";
1485
+ export declare const KIT_VERSION = "2.64.0-rc.1";
1442
1486
  /**
1443
1487
  * Données de la page proposées comme colonnes.
1444
1488
  *
@@ -2147,5 +2191,5 @@ export declare const NCF_DESIGN_SYSTEM_TOOL = "ncf-design-system";
2147
2191
  export declare const NCF_ASSETS_TOOL = "ncf-assets";
2148
2192
  export declare const NCF_TOOL_NAMES: readonly ["ncf-pages", "ncf-components", "ncf-history", "ncf-design-system", "ncf-assets"];
2149
2193
  export declare const ncfKit: import("sanity").Plugin<NcfKitConfig>;
2150
- export { type AddColumnInput, type Annotation, type AnnotationsState, type AssetAssignment, type AssetDoc, type AssetFolder, type AssetMetaState, type AssetSortKey, type AssetTypeFilter, type AssetUploadState, type AssetUsageFilter, type BlockOccurrence, type BlockTypeInfo, type BoardEdge, type BoardGraph, type BoardLayoutState, type BoardNode, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, type Change, type ChangeKind, CodeEditorInput, CodeEmbedInput, type CodeEmbedTypeOptions, type CodeLanguage, type CollectedLinks, type CollectionCell, type CollectionColumn, type CollectionColumnKind, type CollectionDoc, type CollectionFilters, type CollectionRow, type CollectionSort, type CollectionState, type ColorBy, type ColorOptions, type ComponentEntry, type ComponentGroup, type ComponentGrouping, type ConfigIssue, type CrossLanguageReport, DEFAULT_COMPONENT_DEFAULTS_TYPE, type DeriveOptions, type FolderSelection, type GroupBy, type GroupOptions, type HistoryDetail, type HistoryEvent, type IssueLevel, type KitContextValue, type KitUpdate, type LayoutMode, type MainDocumentRoute, type MergedDoc, type NcfBoardTag, type NcfCollectionsConfig, type NcfComponentPreviewConfig, type NcfDocumentColumn, type NcfEnvironment, type NcfHistoryConfig, type NcfI18nConfig, type NcfInternalField, type NcfInternalFieldOption, type NcfKitConfig, type NcfPageTypeConfig, type NcfPageTypeInput, type NcfToolName, type NcfToolsConfig, type NodeLayout, type NodePosition, type OccurrenceInput, type OccurrencePage, type OccurrencesState, type PageBuilderResolution, type PageContent, type PageContentsState, type PageDoc, type PageFilters, type PageRow, type PageStatus, type PagesState, type PathInput, type Positioned, type PresentationOptions, type PreviewGrant, type PreviewPerspective, type PreviewTargetState, type ProjectStatus, type Registration, type ResolvedCollections, type ResolvedComponentPreview, type ResolvedDocumentColumn, type ResolvedHistory, type ResolvedI18n, type ResolvedKitConfig, type ResolvedPageType, type RowColor, type RowGroup, type SchemaFieldLike, type SchemaTypeInfo, type SchemaTypeLike, type SectionLayout, type SectionMapNode, type SectionOrder, type SectionsMapOptions, type Segment, type SiteRoutesRegistry, type SortDirection, type SortKey, type ThumbnailInput, type VersionedDoc, codeEditorInput, componentDefaultsMainDocument, componentDefaultsMainDocuments, defaultsFieldName, defineCodeEmbedType, defineComponentDefaults, filterRows as filterCollectionRows, filterRows$1 as filterRows, fixCrossLanguageReferences, pageTypesFromSiteRoutes, requiredUnlessDefault, requiredUnlessDefaultFor, sortRows as sortCollectionRows, sortRows$1 as sortRows, withSameLanguageReferences };
2194
+ export { type AddColumnInput, type Annotation, type AnnotationsState, type AssetAssignment, type AssetDoc, type AssetFolder, type AssetMetaState, type AssetSortKey, type AssetTypeFilter, type AssetUploadState, type AssetUsageFilter, type BlockOccurrence, type BlockTypeInfo, type BoardEdge, type BoardGraph, type BoardLayoutState, type BoardNode, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, type Change, type ChangeKind, CodeEditorInput, CodeEmbedInput, type CodeEmbedTypeOptions, type CodeLanguage, type CollectedLinks, type CollectionCell, type CollectionColumn, type CollectionColumnKind, type CollectionDoc, type CollectionFilters, type CollectionRow, type CollectionSort, type CollectionState, type ColorBy, type ColorOptions, type ComponentEntry, type ComponentGroup, type ComponentGrouping, type ConfigIssue, type CrossLanguageReport, DEFAULT_COMPONENT_DEFAULTS_TYPE, type DeriveOptions, type FolderSelection, type GroupBy, type GroupOptions, type HistoryDetail, type HistoryEvent, type IssueLevel, type KitContextValue, type KitUpdate, type LayoutMode, type MainDocumentRoute, type MergedDoc, type NcfBoardTag, type NcfChoiceInputsOptions, type NcfCollectionsConfig, type NcfComponentPreviewConfig, type NcfDocumentColumn, type NcfEnvironment, type NcfHistoryConfig, type NcfI18nConfig, type NcfInternalField, type NcfInternalFieldOption, type NcfKitConfig, type NcfPageTypeConfig, type NcfPageTypeInput, type NcfToolName, type NcfToolsConfig, type NodeLayout, type NodePosition, type OccurrenceInput, type OccurrencePage, type OccurrencesState, type PageBuilderResolution, type PageContent, type PageContentsState, type PageDoc, type PageFilters, type PageRow, type PageStatus, type PagesState, type PathInput, type Positioned, type PresentationOptions, type PreviewGrant, type PreviewPerspective, type PreviewTargetState, type ProjectStatus, type Registration, type ResolvedCollections, type ResolvedComponentPreview, type ResolvedDocumentColumn, type ResolvedHistory, type ResolvedI18n, type ResolvedKitConfig, type ResolvedPageType, type RowColor, type RowGroup, type SchemaFieldLike, type SchemaTypeInfo, type SchemaTypeLike, type SectionLayout, type SectionMapNode, type SectionOrder, type SectionsMapOptions, type Segment, type SiteRoutesRegistry, type SortDirection, type SortKey, type ThumbnailInput, type VersionedDoc, codeEditorInput, componentDefaultsMainDocument, componentDefaultsMainDocuments, defaultsFieldName, defineCodeEmbedType, defineComponentDefaults, filterRows as filterCollectionRows, filterRows$1 as filterRows, fixCrossLanguageReferences, pageTypesFromSiteRoutes, requiredUnlessDefault, requiredUnlessDefaultFor, sortRows as sortCollectionRows, sortRows$1 as sortRows, withSameLanguageReferences };
2151
2195
  //# sourceMappingURL=index.d.ts.map