@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 +54 -0
- package/README.md +20 -0
- package/bin/changelog.mjs +4 -1
- package/bin/check-lcp.mjs +218 -0
- package/bin/ncf-kit.mjs +32 -2
- package/dist/index.d.ts +1 -1
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/src/version.ts +1 -1
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 ?
|
|
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
|
|
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
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
1934
|
+
let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.63.0") > 0);
|
|
1935
1935
|
return {
|
|
1936
1936
|
current: KIT_VERSION,
|
|
1937
1937
|
latest,
|