@nocode-factory/sanity-kit 2.62.0 → 2.63.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 CHANGED
@@ -1,5 +1,59 @@
1
1
  # Journal des versions
2
2
 
3
+ ## 2.63.0 : PageSpeed, l'image LCP vérifiée sur chaque page (jamais lazy, fetchpriority=high)
4
+
5
+ ### Ajouté
6
+
7
+ - **`npx ncf-kit check-lcp`** : les deux alertes « essentielles » de PageSpeed Insights
8
+ (« les ressources LCP ne doivent pas utiliser loading=lazy », « fetchpriority=high doit
9
+ être appliqué ») vérifiées par une machine. Le site construit est démarré, les pages de
10
+ la sitemap ouvertes dans un vrai navigateur, en mobile et en ordinateur (écrans de
11
+ PageSpeed) ; l'élément LCP réel de chaque page doit être chargé tout de suite et en
12
+ priorité, sinon échec avec la page, l'écran et l'image en cause. `--url <adresse>`
13
+ pour auditer un site en ligne, `--all` pour toutes les pages. Constat à l'origine : sur
14
+ Société Paul Ricard, 45 alertes (22 pages sur 26 sans fetchpriority, 2 images LCP en
15
+ lazy) alors que la consigne était écrite ; Next 16 a déprécié `priority`, qui ne pose
16
+ plus fetchpriority.
17
+ - **`doctor`** : ✖ « PageSpeed : image LCP » tant que la CI du projet ne lance pas
18
+ `check-lcp` (ou que playwright manque au site).
19
+ - **En CI, `check-lcp` exige `NEXT_PUBLIC_SANITY_PROJECT_ID`**, dans l'étape ET dans le
20
+ build (l'identifiant doit figurer dans `.next` : Next fige les `NEXT_PUBLIC_*` à la
21
+ construction) : sans projet Sanity, le site construit n'a aucun contenu et le contrôle ne
22
+ prouverait rien (vu sur JAF).
23
+
24
+ ### Corrigé
25
+
26
+ - **`doctor` avec une version de test** (X.Y.Z-rc.N) plus récente que la dernière publiée :
27
+ il conseillait « npm install @latest », c'est-à-dire un retour en arrière. Il l'indique
28
+ désormais comme version de test, et le conseil de mise à jour passe par
29
+ `npx -y @nocode-factory/sanity-kit@latest upgrade`.
30
+ - **`upgrade --version <version de test>`** : la consigne de fin ne dit plus de déployer le
31
+ Studio ; elle dit de vérifier en local, sur une branche à part, sans fusionner.
32
+ - **`upgrade` depuis une version de test** (rc.1 -> rc.2, ou rc -> version finale) : la
33
+ rubrique « À brancher dans le projet » de cette version est réaffichée (elle n'affichait
34
+ rien, alors que la consigne avait pu changer).
35
+
36
+ ### À brancher dans le projet
37
+
38
+ - **CI** (`.github/workflows/ci.yml`, job du site, après `npm run build`, avec EXACTEMENT
39
+ les mêmes variables d'environnement que l'étape `npm run build`) : `npx playwright
40
+ install --with-deps chromium` puis `npx ncf-kit check-lcp`. `playwright` en devDependency
41
+ du site (le starter l'a). **Variable du dépôt GitHub `NEXT_PUBLIC_SANITY_PROJECT_ID`**
42
+ obligatoire (Settings > Secrets and variables > Actions > Variables ; pas un secret).
43
+ - **Image LCP hors de la 1re section** : dans `web/components/sections/index.tsx` du starter,
44
+ `lcpSectionIndex` donne aussi `priority` à la première section qui affiche une image quand
45
+ la 1re n'en a pas (texte seul, valeur par défaut absente dans une langue) ; une image
46
+ masquée par sa case (`hide<Champ>` cochée, `show<Champ>` décochée) ne compte pas.
47
+ Chaque section qui affiche une image et peut ouvrir une page applique sa prop `priority`.
48
+ - **Images du haut de page** : reprendre du starter `lcpImageProps` /
49
+ `aboveFoldImageProps` (`web/components/SanityImage.tsx`, `<SanityImage priority />`
50
+ ne passe plus `priority` à next/image), et dans chaque section qui peut être en haut de
51
+ page, appliquer la prop `priority` à ses grandes images (`{...lcpImageProps(priority)}`)
52
+ et `eager` aux petites. Remplacer tout `priority` / `preload` seul sur next/image.
53
+ Contrôle au build : règle 21 de `web/scripts/check-rules.mjs` du starter.
54
+ - **CLAUDE.md** : règle « IMAGE LCP » du starter (rubrique PageSpeed).
55
+ - Lancer `npx ncf-kit check-lcp` après un build local, corriger jusqu'à zéro ✖.
56
+
3
57
  ## 2.62.0 : le bouton de mise à jour du Studio copie la consigne complète pour Claude Code
4
58
 
5
59
  ### 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),
package/bin/changelog.mjs CHANGED
@@ -56,9 +56,12 @@ export const isNothing = (wiring) => !wiring || /^[-*\s]*rien\b/i.test(wiring.tr
56
56
  * Ce qu'il faut brancher en passant de `from` (exclue) à `to` (incluse), de la plus
57
57
  * ancienne à la plus récente, sans les versions qui n'ont rien à brancher.
58
58
  */
59
+ // Depuis une version de TEST (X.Y.Z-rc.N), la rubrique de X.Y.Z est réaffichée : une rc
60
+ // suivante, ou la version finale, peut en avoir changé la consigne (vu sur JAF, rc.1 -> rc.2).
59
61
  export function wiringBetween(entries, from, to) {
62
+ const since = (e) => compareVersions(e.version, from) === 1 || (String(from).includes('-') && compareVersions(e.version, from) === 0)
60
63
  return entries
61
- .filter((e) => (from ? compareVersions(e.version, from) === 1 : true) && compareVersions(e.version, to) !== 1)
64
+ .filter((e) => (from ? since(e) : true) && compareVersions(e.version, to) !== 1)
62
65
  .filter((e) => e.wiring !== null && !isNothing(e.wiring))
63
66
  .sort((a, b) => compareVersions(a.version, b.version))
64
67
  }
@@ -0,0 +1,218 @@
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, spawnSync } 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
+ // En CI, un site construit SANS projet Sanity n'a pas de contenu : le contrôle passerait
46
+ // sans rien prouver. La variable du dépôt NEXT_PUBLIC_SANITY_PROJECT_ID (publique, pas un
47
+ // secret) est exigée, comme pour le build.
48
+ if (!flag("url") && process.env.CI && !String(process.env.NEXT_PUBLIC_SANITY_PROJECT_ID ?? "").trim())
49
+ fail(
50
+ "NEXT_PUBLIC_SANITY_PROJECT_ID absent : le site construit en CI n'a aucun contenu, le contrôle ne prouverait rien.\n" +
51
+ " Ajouter la variable du dépôt GitHub NEXT_PUBLIC_SANITY_PROJECT_ID (Settings > Secrets and variables > Actions > Variables ; l'identifiant n'est pas un secret),\n" +
52
+ " et passer à cette étape les MÊMES variables d'environnement que l'étape `npm run build`.",
53
+ );
54
+
55
+ // Le BUILD doit lui aussi avoir reçu le projet : Next fige les NEXT_PUBLIC_* à la
56
+ // construction. Une étape check-lcp qui reçoit la variable après un build qui ne l'avait
57
+ // pas testerait encore un site vide (vu sur JAF) : l'identifiant doit figurer dans le build.
58
+ if (!flag("url") && process.env.CI && existsSync(".next/server")) {
59
+ const id = String(process.env.NEXT_PUBLIC_SANITY_PROJECT_ID).trim();
60
+ const found = spawnSync("grep", ["-rlqF", id, ".next/server", ".next/static"], { stdio: "ignore" }).status === 0;
61
+ if (!found)
62
+ fail(
63
+ `le build (.next) ne contient pas le projet Sanity ${id} : l'étape \`npm run build\` de la CI ne reçoit pas NEXT_PUBLIC_SANITY_PROJECT_ID.\n` +
64
+ " Lui passer les mêmes variables que cette étape (voir .github/workflows/ci.yml du starter).",
65
+ );
66
+ }
67
+
68
+ let chromium;
69
+ try {
70
+ ({ chromium } = createRequire(join(process.cwd(), "package.json"))("playwright"));
71
+ } catch {
72
+ fail("playwright absent du site. Ajouter la dépendance (npm i -D playwright), puis `npx playwright install --with-deps chromium`.");
73
+ }
74
+
75
+ const freePort = () =>
76
+ new Promise((resolve, reject) => {
77
+ const srv = createServer();
78
+ srv.once("error", reject);
79
+ srv.listen(0, () => {
80
+ const { port } = srv.address();
81
+ srv.close(() => resolve(port));
82
+ });
83
+ });
84
+
85
+ // Site construit démarré comme en CI : sans les variables internes de Vercel (avec
86
+ // elles, `next start` se croit derrière le routage Vercel et redirige en boucle).
87
+ async function startBuiltSite() {
88
+ if (!existsSync(".next/BUILD_ID")) fail("aucun build (.next) ici. Lancer après `next build`, depuis le dossier du site (ou passer --url).");
89
+ if (!existsSync("node_modules/next/dist/bin/next")) fail("lancer depuis le dossier du site Next.js (node_modules/next introuvable).");
90
+ const port = await freePort();
91
+ const env = Object.fromEntries(Object.entries(process.env).filter(([k]) => !/^(VERCEL|__VERCEL|NOW_|NEXT_PRIVATE|__NEXT_PRIVATE|NEXT_EDGE_RUNTIME_PROVIDER)/.test(k)));
92
+ const server = spawn(process.execPath, ["node_modules/next/dist/bin/next", "start", "-p", String(port)], { stdio: ["ignore", "pipe", "pipe"], env });
93
+ let log = "";
94
+ server.stdout.on("data", (d) => (log += d));
95
+ server.stderr.on("data", (d) => (log += d));
96
+ let exited = null;
97
+ server.on("exit", (c) => (exited = c));
98
+ const base = `http://localhost:${port}`;
99
+ const deadline = Date.now() + 90_000;
100
+ for (;;) {
101
+ try {
102
+ if ((await fetch(`${base}/robots.txt`)).ok) break;
103
+ } catch {
104
+ /* pas encore prêt */
105
+ }
106
+ if (exited !== null) fail(`le site s'est arrêté (code ${exited})\n${log.slice(-2000)}`);
107
+ if (Date.now() > deadline) fail(`le site construit ne répond pas\n${log.slice(-2000)}`);
108
+ await new Promise((r) => setTimeout(r, 1000));
109
+ }
110
+ return { base, stop: () => server.kill("SIGTERM") };
111
+ }
112
+
113
+ // Pages de la sitemap, ramenées sur le site testé (la sitemap porte l'adresse de prod).
114
+ // Par défaut, quelques pages par dossier : les fiches d'une collection partagent un gabarit.
115
+ async function pagesFromSitemap(base) {
116
+ const res = await fetch(`${base}/sitemap.xml`);
117
+ if (!res.ok) fail(`/sitemap.xml répond ${res.status}`);
118
+ const xml = await res.text();
119
+ const paths = [...new Set([...xml.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/g)].map((m) => new URL(m[1]).pathname || "/"))];
120
+ if (!paths.length) fail("sitemap vide : aucune page à tester.");
121
+ if (has("all")) return paths;
122
+ const groups = new Map();
123
+ for (const p of paths) {
124
+ const parts = p.split("/").filter(Boolean);
125
+ const key = parts.length > 1 ? parts.slice(0, -1).join("/") : "(racine)";
126
+ const list = groups.get(key) ?? [];
127
+ groups.set(key, list);
128
+ // Les pages à la racine (pages du Studio, gabarits variés) sont toutes testées.
129
+ if (key === "(racine)" || list.length < PER_GROUP) list.push(p);
130
+ }
131
+ return [...groups.values()].flat();
132
+ }
133
+
134
+ // Script injecté avant le chargement : garde le dernier candidat LCP du navigateur.
135
+ const OBSERVE_LCP = () => {
136
+ window.__ncfLcp = null;
137
+ try {
138
+ new PerformanceObserver((list) => {
139
+ const entries = list.getEntries();
140
+ window.__ncfLcp = entries[entries.length - 1];
141
+ }).observe({ type: "largest-contentful-paint", buffered: true });
142
+ } catch {
143
+ /* navigateur sans LCP */
144
+ }
145
+ };
146
+
147
+ // Description de l'élément LCP : image (img, image d'un <picture>), sinon texte / fond CSS.
148
+ const READ_LCP = () => {
149
+ const e = window.__ncfLcp;
150
+ if (!e) return null;
151
+ const el = e.element;
152
+ const img = el?.tagName === "IMG" ? el : null;
153
+ return {
154
+ tag: el?.tagName?.toLowerCase() ?? "(élément retiré)",
155
+ url: e.url || "",
156
+ size: Math.round(e.size),
157
+ img: img
158
+ ? {
159
+ loading: img.getAttribute("loading"),
160
+ fetchpriority: img.getAttribute("fetchpriority"),
161
+ alt: img.getAttribute("alt") ?? "",
162
+ src: (img.currentSrc || img.src || "").slice(0, 160),
163
+ }
164
+ : null,
165
+ };
166
+ };
167
+
168
+ const short = (s, n = 60) => (s.length > n ? `${s.slice(0, n - 1)}…` : s);
169
+
170
+ const remote = flag("url");
171
+ const site = remote ? { base: remote.replace(/\/$/, ""), stop: () => {} } : await startBuiltSite();
172
+ const browser = await chromium.launch().catch((error) =>
173
+ fail(`Chromium introuvable (${error.message.split("\n")[0]}). Installer : npx playwright install --with-deps chromium`),
174
+ );
175
+ const problems = [];
176
+ let checked = 0;
177
+ let images = 0;
178
+ try {
179
+ const pages = flags("page").length ? flags("page") : await pagesFromSitemap(site.base);
180
+ for (const vp of VIEWPORTS) {
181
+ const context = await browser.newContext({ viewport: vp.viewport, deviceScaleFactor: vp.deviceScaleFactor, isMobile: vp.isMobile, hasTouch: vp.hasTouch });
182
+ await context.addInitScript(OBSERVE_LCP);
183
+ const page = await context.newPage();
184
+ for (const path of pages) {
185
+ const res = await page.goto(`${site.base}${path}`, { waitUntil: "load", timeout: 60_000 }).catch((error) => error);
186
+ if (res instanceof Error || !res?.ok()) {
187
+ problems.push(`${path} (${vp.name}) : page non chargée (${res instanceof Error ? res.message.split("\n")[0] : `HTTP ${res?.status()}`})`);
188
+ continue;
189
+ }
190
+ // Le LCP est figé à la première interaction : on laisse finir images et polices, sans toucher la page.
191
+ await page.waitForLoadState("networkidle", { timeout: 10_000 }).catch(() => {});
192
+ await page.waitForTimeout(500);
193
+ const lcp = await page.evaluate(READ_LCP);
194
+ checked++;
195
+ if (!lcp?.img) continue; // texte ou fond CSS : pas d'attribut à vérifier
196
+ images++;
197
+ const what = `image « ${short(lcp.img.alt || lcp.img.src)} »`;
198
+ 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 »)`);
199
+ 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é »)`);
200
+ }
201
+ await context.close();
202
+ }
203
+ console.log(`Contrôle LCP : ${pages.length} page(s) x ${VIEWPORTS.length} écrans, ${images} élément(s) LCP image sur ${checked}.`);
204
+ } finally {
205
+ await browser.close();
206
+ site.stop();
207
+ }
208
+
209
+ if (problems.length) {
210
+ console.error(`✖ Contrôle LCP : ${problems.length} problème(s)\n ${problems.join("\n ")}`);
211
+ console.error(
212
+ " Correction : l'image du haut de page (celle qui s'affiche en premier, en grand) prend\n" +
213
+ ' <Image preload fetchPriority="high" loading="eager" /> (Next 16 : jamais `priority`, déprécié) ;\n' +
214
+ " la section la reçoit par sa prop `priority` (première section de la page). Toutes les autres restent en lazy.",
215
+ );
216
+ process.exit(1);
217
+ }
218
+ 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)
@@ -282,8 +283,17 @@ async function doctor() {
282
283
  const r = await probe(`https://registry.npmjs.org/${PKG}/latest`)
283
284
  if (r.status === 200) latest = (await (await fetch(`https://registry.npmjs.org/${PKG}/latest`)).json()).version
284
285
  }
286
+ // Version de TEST (X.Y.Z-rc.N, canal next) plus récente que la dernière publiée : jamais
287
+ // de conseil de « mise à jour » vers @latest, ce serait un retour en arrière.
288
+ const core = (v) => v.split('-')[0].split('.').map((n) => Number.parseInt(n, 10) || 0)
289
+ const newer = (a, b) => {
290
+ const [x, y] = [core(a), core(b)]
291
+ for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] > y[i]
292
+ return false
293
+ }
285
294
  if (!version) ko('Version du kit', 'non installé dans le studio')
286
- else if (latest && version !== latest) warn('Version du kit', `${version} installée, ${latest} disponible : npm install ${PKG}@latest (studio et site)`)
295
+ else if (latest && version.includes('-') && newer(version, latest)) ok('Version du kit', `${version} (version de test, plus récente que ${latest} : à remplacer par la version finale dès sa sortie)`)
296
+ else if (latest && version !== latest) warn('Version du kit', `${version} installée, ${latest} disponible : npx -y ${PKG}@latest upgrade (depuis studio/)`)
287
297
  else ok('Version du kit', version)
288
298
  // Le site embarque aussi le kit (bandeau, garde, liens, valeurs par défaut) : une
289
299
  // version différente du Studio = corrections du kit absentes d'un côté.
@@ -522,6 +532,21 @@ async function doctor() {
522
532
  : 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
533
  }
524
534
 
535
+ /* PageSpeed, image LCP (kit >= 2.63.0) : les deux alertes « essentielles » de PageSpeed
536
+ Insights (image LCP jamais en lazy, fetchpriority="high") vérifiées en CI sur le vrai
537
+ élément LCP de chaque page, en mobile et en ordinateur. Il faut un navigateur : en CI,
538
+ pas dans le build Vercel. */
539
+ {
540
+ const wf = walk(join(root, '.github', 'workflows'))
541
+ const lcp = wf.find((f) => /ncf-kit check-lcp/.test(read(f)))
542
+ const webPkgText = read(join(web, 'package.json'))
543
+ if (!lcp)
544
+ 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).")
545
+ else if (webPkgText && !/"playwright"/.test(webPkgText))
546
+ ko('PageSpeed : image LCP', `${lcp.replace(root + '/', '')} lance check-lcp mais playwright manque au site : npm i -D playwright dans ${web.replace(root + '/', '')}.`)
547
+ else ok('PageSpeed : image LCP', `check-lcp en CI (${lcp.replace(root + '/', '')})`)
548
+ }
549
+
525
550
  /* Captures des composants */
526
551
  const workflows = walk(join(root, '.github', 'workflows'))
527
552
  const captures = workflows.find((f) => /public\/sections/.test(read(f)))
@@ -820,7 +845,9 @@ async function upgrade() {
820
845
 
821
846
  console.log('\n• Contrôle du projet (doctor --offline) :')
822
847
  spawnSync(process.execPath, [new URL(import.meta.url).pathname, 'doctor', '--offline', '--dir', studio, '--web', web], {stdio: 'inherit'})
823
- console.log('\nEnsuite : brancher ce qui est listé, `npx ncf-kit doctor` (zéro ✖), redéployer le Studio (`npm run deploy` dans studio/), vérifier sur la préprod, committer.')
848
+ if (String(to ?? target).includes('-'))
849
+ console.log('\nVersion de TEST : brancher ce qui est listé, `npx ncf-kit doctor` (zéro ✖), vérifier en local (Studio : `npm run dev` dans studio/), committer sur une branche à part. Ne pas déployer le Studio ni fusionner avant la version finale.')
850
+ else console.log('\nEnsuite : brancher ce qui est listé, `npx ncf-kit doctor` (zéro ✖), redéployer le Studio (`npm run deploy` dans studio/), vérifier sur la préprod, committer.')
824
851
  }
825
852
 
826
853
  async function translations() {
@@ -1119,6 +1146,9 @@ if (command === 'setup') {
1119
1146
  } else if (command === 'check-environments') {
1120
1147
  // Script autonome (il démarre le site construit) : chargé seulement à la demande.
1121
1148
  import('./check-environments.mjs').catch((error) => fail(error?.message ?? String(error)))
1149
+ } else if (command === 'check-lcp') {
1150
+ // Script autonome (navigateur Playwright du site) : chargé seulement à la demande.
1151
+ import('./check-lcp.mjs').catch((error) => fail(error?.message ?? String(error)))
1122
1152
  } else if (!command || command === 'help' || has('help')) {
1123
1153
  usage(command ? 0 : 1)
1124
1154
  } else {
package/dist/index.d.ts CHANGED
@@ -1438,7 +1438,7 @@ export declare function ActorName(props: {
1438
1438
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1439
1439
  * le vérifie.
1440
1440
  */
1441
- export declare const KIT_VERSION = "2.62.0";
1441
+ export declare const KIT_VERSION = "2.63.0";
1442
1442
  /**
1443
1443
  * Données de la page proposées comme colonnes.
1444
1444
  *
package/dist/index.js CHANGED
@@ -1423,7 +1423,7 @@ function explainGrantError(error) {
1423
1423
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1424
1424
  * le vérifie.
1425
1425
  */
1426
- const KIT_VERSION = "2.62.0";
1426
+ const KIT_VERSION = "2.63.0";
1427
1427
  /**
1428
1428
  * Signale ce Studio au service du kit, une fois par montage.
1429
1429
  *
@@ -1931,7 +1931,7 @@ function useKitUpdate() {
1931
1931
  !controller.signal.aborted && body?.version && setLatest(body.version);
1932
1932
  }).catch(() => {}), () => controller.abort();
1933
1933
  }, []);
1934
- let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.62.0") > 0);
1934
+ let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.63.0") > 0);
1935
1935
  return {
1936
1936
  current: KIT_VERSION,
1937
1937
  latest,