@nocode-factory/sanity-kit 2.62.0-rc.1 → 2.63.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,36 @@
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
+
20
+ ### À brancher dans le projet
21
+
22
+ - **CI** (`.github/workflows/ci.yml`, job du site, après `npm run build`, mêmes variables
23
+ d'environnement que le build) : `npx playwright install --with-deps chromium` puis
24
+ `npx ncf-kit check-lcp`. `playwright` en devDependency du site (le starter l'a).
25
+ - **Images du haut de page** : reprendre du starter `lcpImageProps` /
26
+ `aboveFoldImageProps` (`web/components/SanityImage.tsx`, `<SanityImage priority />`
27
+ ne passe plus `priority` à next/image), et dans chaque section qui peut être en haut de
28
+ page, appliquer la prop `priority` à ses grandes images (`{...lcpImageProps(priority)}`)
29
+ et `eager` aux petites. Remplacer tout `priority` / `preload` seul sur next/image.
30
+ Contrôle au build : règle 21 de `web/scripts/check-rules.mjs` du starter.
31
+ - **CLAUDE.md** : règle « IMAGE LCP » du starter (rubrique PageSpeed).
32
+ - Lancer `npx ncf-kit check-lcp` après un build local, corriger jusqu'à zéro ✖.
33
+
3
34
  ## 2.62.0 : le bouton de mise à jour du Studio copie la consigne complète pour Claude Code
4
35
 
5
36
  ### Changé
@@ -11,6 +42,9 @@
11
42
  copiait un `npm install` nu, qui n'affiche rien de ce qu'il reste à brancher : la
12
43
  nouveauté était installée mais invisible. `upgradePrompt()` et `UPGRADE_COMMAND`
13
44
  exportés.
45
+ - **La pastille reste toujours dans la barre du haut** : fenêtre étroite, quand Sanity
46
+ range les outils dans le menu ☰, elle reste visible à droite de la barre (fond blanc).
47
+ Composant `navbar` posé par le plugin (`NcfKitNavbar`, exporté).
14
48
 
15
49
  ### À brancher dans le projet
16
50
 
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)
@@ -522,6 +523,21 @@ async function doctor() {
522
523
  : 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
524
  }
524
525
 
526
+ /* PageSpeed, image LCP (kit >= 2.63.0) : les deux alertes « essentielles » de PageSpeed
527
+ Insights (image LCP jamais en lazy, fetchpriority="high") vérifiées en CI sur le vrai
528
+ élément LCP de chaque page, en mobile et en ordinateur. Il faut un navigateur : en CI,
529
+ pas dans le build Vercel. */
530
+ {
531
+ const wf = walk(join(root, '.github', 'workflows'))
532
+ const lcp = wf.find((f) => /ncf-kit check-lcp/.test(read(f)))
533
+ const webPkgText = read(join(web, 'package.json'))
534
+ if (!lcp)
535
+ 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).")
536
+ else if (webPkgText && !/"playwright"/.test(webPkgText))
537
+ ko('PageSpeed : image LCP', `${lcp.replace(root + '/', '')} lance check-lcp mais playwright manque au site : npm i -D playwright dans ${web.replace(root + '/', '')}.`)
538
+ else ok('PageSpeed : image LCP', `check-lcp en CI (${lcp.replace(root + '/', '')})`)
539
+ }
540
+
525
541
  /* Captures des composants */
526
542
  const workflows = walk(join(root, '.github', 'workflows'))
527
543
  const captures = workflows.find((f) => /public\/sections/.test(read(f)))
@@ -1119,6 +1135,9 @@ if (command === 'setup') {
1119
1135
  } else if (command === 'check-environments') {
1120
1136
  // Script autonome (il démarre le site construit) : chargé seulement à la demande.
1121
1137
  import('./check-environments.mjs').catch((error) => fail(error?.message ?? String(error)))
1138
+ } else if (command === 'check-lcp') {
1139
+ // Script autonome (navigateur Playwright du site) : chargé seulement à la demande.
1140
+ import('./check-lcp.mjs').catch((error) => fail(error?.message ?? String(error)))
1122
1141
  } else if (!command || command === 'help' || has('help')) {
1123
1142
  usage(command ? 0 : 1)
1124
1143
  } else {
package/dist/index.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { a as CodeEmbedTypeOptions, i as codeEditorInput, n as CodeEditorInput, o as defineCodeEmbedType, r as CodeLanguage, t as CodeEmbedInput } from "./CodeEmbedInput-CobMRQ5s.js";
2
2
  import { A as ResolvedCollections, C as NcfInternalField, D as NcfPageTypeInput, E as NcfPageTypeConfig, F as ResolvedKitConfig, I as ResolvedPageType, M as ResolvedDocumentColumn, N as ResolvedHistory, O as NcfToolName, P as ResolvedI18n, S as NcfI18nConfig, T as NcfKitConfig, _ as NcfCollectionsConfig, a as pageTypesFromSiteRoutes, b as NcfEnvironment, c as componentDefaultsMainDocuments, d as requiredUnlessDefault, f as requiredUnlessDefaultFor, g as NcfBoardTag, h as KitContextValue, i as SiteRoutesRegistry, j as ResolvedComponentPreview, k as NcfToolsConfig, l as defaultsFieldName, m as IssueLevel, n as fixCrossLanguageReferences, o as DEFAULT_COMPONENT_DEFAULTS_TYPE, p as ConfigIssue, r as withSameLanguageReferences, s as componentDefaultsMainDocument, t as CrossLanguageReport, u as defineComponentDefaults, v as NcfComponentPreviewConfig, w as NcfInternalFieldOption, x as NcfHistoryConfig, y as NcfDocumentColumn } from "./fixCrossLanguageReferences-CfFDSTD5.js";
3
3
  import { ComponentType, ReactNode } from "react";
4
- import { AssetSourceComponentProps, LayoutProps, SanityClient, Schema, Tool, ToolMenuProps } from "sanity";
4
+ import { AssetSourceComponentProps, LayoutProps, NavbarProps, SanityClient, Schema, Tool, ToolMenuProps } from "sanity";
5
5
  import { PreviewHeaderProps } from "sanity/presentation";
6
6
  import { ListItemBuilder, StructureBuilder, StructureResolverContext } from "sanity/structure";
7
7
  /** Garantit un chemin absolu ('accueil' -> '/accueil', '' -> '/'). */
@@ -1238,25 +1238,6 @@ export declare function NcfPreviewLauncher(props: ToolMenuProps): import("react"
1238
1238
  * d'aucun de leurs contextes, et doit porter le sien.
1239
1239
  */
1240
1240
  export declare function createPreviewLauncher(config: ResolvedKitConfig, issues: ConfigIssue[]): (props: ToolMenuProps) => import("react").JSX.Element;
1241
- /**
1242
- * Signale qu'une version plus récente du kit existe.
1243
- *
1244
- * **Il ne met pas à jour.** Un Studio tourne dans un navigateur : il ne peut
1245
- * ni installer un paquet sur le poste d'un développeur, ni se redéployer. Ce
1246
- * bouton dit ce qui manque et copie la consigne complète à donner à Claude Code
1247
- * (mise à jour, branchements, corrections, déploiement) : une seule action.
1248
- *
1249
- * Invisible tant que le kit est à jour : un bouton permanent qui ne dit rien
1250
- * finit par ne plus être lu.
1251
- */
1252
- export declare function NcfKitUpdate(props: {
1253
- inline?: boolean;
1254
- }): import("react").JSX.Element | null;
1255
- /**
1256
- * Posé sur `studio.components.layout` : rend le Studio tel quel, et ajoute la
1257
- * feuille de style. Un seul `<style>` pour tout le Studio.
1258
- */
1259
- export declare function HelpTextStyle(props: LayoutProps): import("react").JSX.Element;
1260
1241
  interface KitUpdate {
1261
1242
  current: string;
1262
1243
  latest: string | null;
@@ -1288,6 +1269,27 @@ export declare function upgradePrompt(latest: string | null): string;
1288
1269
  * personne.
1289
1270
  */
1290
1271
  export declare function useKitUpdate(): KitUpdate;
1272
+ /**
1273
+ * Signale qu'une version plus récente du kit existe.
1274
+ *
1275
+ * **Il ne met pas à jour.** Un Studio tourne dans un navigateur : il ne peut
1276
+ * ni installer un paquet sur le poste d'un développeur, ni se redéployer. Ce
1277
+ * bouton dit ce qui manque et copie la consigne complète à donner à Claude Code
1278
+ * (mise à jour, branchements, corrections, déploiement) : une seule action.
1279
+ *
1280
+ * Invisible tant que le kit est à jour : un bouton permanent qui ne dit rien
1281
+ * finit par ne plus être lu.
1282
+ */
1283
+ export declare function NcfKitUpdate(props: {
1284
+ inline?: boolean;
1285
+ update?: KitUpdate;
1286
+ }): import("react").JSX.Element | null;
1287
+ export declare function NcfKitNavbar(props: NavbarProps): import("react").JSX.Element;
1288
+ /**
1289
+ * Posé sur `studio.components.layout` : rend le Studio tel quel, et ajoute la
1290
+ * feuille de style. Un seul `<style>` pour tout le Studio.
1291
+ */
1292
+ export declare function HelpTextStyle(props: LayoutProps): import("react").JSX.Element;
1291
1293
  /**
1292
1294
  * Comparaison de deux versions sémantiques.
1293
1295
  *
@@ -1436,7 +1438,7 @@ export declare function ActorName(props: {
1436
1438
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1437
1439
  * le vérifie.
1438
1440
  */
1439
- export declare const KIT_VERSION = "2.62.0-rc.1";
1441
+ export declare const KIT_VERSION = "2.63.0-rc.1";
1440
1442
  /**
1441
1443
  * Données de la page proposées comme colonnes.
1442
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-rc.1";
1426
+ const KIT_VERSION = "2.63.0-rc.1";
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-rc.1") > 0);
1934
+ let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.63.0-rc.1") > 0);
1935
1935
  return {
1936
1936
  current: KIT_VERSION,
1937
1937
  latest,
@@ -1952,7 +1952,7 @@ function useKitUpdate() {
1952
1952
  * finit par ne plus être lu.
1953
1953
  */
1954
1954
  function NcfKitUpdate(props) {
1955
- let update = useKitUpdate(), [copied, setCopied] = useState(!1);
1955
+ let own = useKitUpdate(), update = props.update ?? own, [copied, setCopied] = useState(!1);
1956
1956
  if (!update.available) return null;
1957
1957
  let copy = async () => {
1958
1958
  try {
@@ -2036,6 +2036,48 @@ function NcfKitUpdate(props) {
2036
2036
  });
2037
2037
  }
2038
2038
  /**
2039
+ * La pastille de mise à jour du kit reste TOUJOURS dans la barre du haut.
2040
+ *
2041
+ * Fenêtre large : elle est dans la barre des outils (à côté de « Preview »).
2042
+ * Fenêtre étroite : Sanity range les outils dans le menu ☰ ; la pastille, elle,
2043
+ * reste visible à droite de la barre (fond blanc, même bordure). Une mise à jour en
2044
+ * attente ne doit jamais être cachée dans un menu.
2045
+ */
2046
+ let inToolbar = 0;
2047
+ const listeners = /* @__PURE__ */ new Set(), emit = () => listeners.forEach((l) => l()), subscribe = (l) => (listeners.add(l), () => listeners.delete(l));
2048
+ /** Monté par la barre des outils quand elle s'affiche dans la barre du haut. */
2049
+ function useKitUpdateInToolbar(active) {
2050
+ useEffect(() => {
2051
+ if (active) return inToolbar++, emit(), () => {
2052
+ inToolbar--, emit();
2053
+ };
2054
+ }, [active]);
2055
+ }
2056
+ function NcfKitNavbar(props) {
2057
+ let shownInToolbar = useSyncExternalStore(subscribe, () => inToolbar > 0, () => !1), update = useKitUpdate(), pinned = update.available && !shownInToolbar;
2058
+ return /* @__PURE__ */ jsxs(Flex, {
2059
+ align: "stretch",
2060
+ children: [/* @__PURE__ */ jsx(Box, {
2061
+ flex: 1,
2062
+ style: { minWidth: 0 },
2063
+ children: props.renderDefault(props)
2064
+ }), pinned && /* @__PURE__ */ jsx(Card, {
2065
+ borderBottom: !0,
2066
+ tone: "default",
2067
+ paddingX: 2,
2068
+ style: {
2069
+ display: "flex",
2070
+ alignItems: "center",
2071
+ background: "#ffffff"
2072
+ },
2073
+ children: /* @__PURE__ */ jsx(NcfKitUpdate, {
2074
+ inline: !0,
2075
+ update
2076
+ })
2077
+ })]
2078
+ });
2079
+ }
2080
+ /**
2039
2081
  * Sépare les outils de la barre : ceux du quotidien restent en boutons, les outils
2040
2082
  * techniques (`more`) passent dans le menu « Plus ». L'ordre d'origine est gardé.
2041
2083
  */
@@ -2131,14 +2173,14 @@ const TARGET_TONES = {
2131
2173
  * regarde ailleurs.
2132
2174
  */
2133
2175
  function NcfPreviewLauncher(props) {
2134
- let config = useKitConfig(), router = useRouter(), open = useOpenOnline(), environments = config.environments;
2135
- if (environments.length === 0) return /* @__PURE__ */ jsxs(Flex, {
2176
+ let config = useKitConfig(), router = useRouter(), open = useOpenOnline(), environments = config.environments, topbar = props.context === "topbar";
2177
+ if (useKitUpdateInToolbar(topbar), environments.length === 0) return /* @__PURE__ */ jsxs(Flex, {
2136
2178
  align: "center",
2137
2179
  gap: 2,
2138
2180
  children: [/* @__PURE__ */ jsx(NcfToolButtons, {
2139
2181
  ...props,
2140
2182
  more: config.moreTools
2141
- }), /* @__PURE__ */ jsx(NcfKitUpdate, { inline: props.context === "topbar" })]
2183
+ }), topbar && /* @__PURE__ */ jsx(NcfKitUpdate, { inline: !0 })]
2142
2184
  });
2143
2185
  let openInStudio = (environment, perspective) => {
2144
2186
  let target = editableEnvironment(environment, environments, config.previewUrl) ?? environment, shown = isPublicEnvironment(environment, config.previewUrl) ? "published" : perspective, path = presentationPath((typeof window > "u" ? null : previewPathFromLocation(window.location.search)) ?? target.url, {
@@ -2162,7 +2204,7 @@ function NcfPreviewLauncher(props) {
2162
2204
  ...props,
2163
2205
  more: config.moreTools
2164
2206
  }),
2165
- /* @__PURE__ */ jsx(NcfKitUpdate, { inline }),
2207
+ inline && /* @__PURE__ */ jsx(NcfKitUpdate, { inline: !0 }),
2166
2208
  /* @__PURE__ */ jsx(InlinePopover, {
2167
2209
  width: 248,
2168
2210
  trigger: ({ toggle }) => /* @__PURE__ */ jsx(Button, {
@@ -14009,6 +14051,7 @@ const ncfKit = definePlugin((options) => {
14009
14051
  },
14010
14052
  studio: { components: {
14011
14053
  toolMenu: createPreviewLauncher(config, issues),
14054
+ navbar: NcfKitNavbar,
14012
14055
  layout: createKitLayout(ncfAllowedOrigins(config), config.componentPreview.defaultsType)
14013
14056
  } },
14014
14057
  form: {
@@ -14025,6 +14068,6 @@ function hasLanguageField(schemaType, field) {
14025
14068
  let fields = schemaType?.fields;
14026
14069
  return Array.isArray(fields) && fields.some((f) => f?.name === field);
14027
14070
  }
14028
- export { ANNOTATION_TYPE, ActorName, AssetSourceBrowser, AssetsTool, BOARD_LAYOUT_ID, BOARD_LAYOUT_TYPE, BRAIN_NODE_SIZE, BoardLayoutProvider, COLUMN_TYPE, CONTENT_SCAN_LIMIT, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, CUSTOM_ENVIRONMENT_ID, CodeEditorInput, CodeEmbedInput, CollectionTable, DATA_PREFIX, DEFAULT_BOARD_TAGS, DEFAULT_COMPONENT_DEFAULTS_TYPE, DEFAULT_COMPONENT_PREVIEW, DEFAULT_I18N, DEFAULT_INTERNAL_FIELDS, DEFAULT_MORE_TOOLS, DEFAULT_PAGE_BUILDER_FIELD, DEFAULT_SLUG_FIELD, DEFAULT_TITLE_FIELD, HelpTextStyle, KIT_API_VERSION, KIT_VERSION, NCF_ASSETS_TOOL, NCF_COMPONENTS_TOOL, NCF_DESIGN_SYSTEM_TOOL, NCF_HIDDEN_TYPES, NCF_HISTORY_TOOL, NCF_MORE_TOOL, NCF_PAGES_TOOL, NCF_TOOL_NAMES, NODE_FIELD_TYPE, NODE_HEIGHT, NODE_WIDTH, NcfKitUpdate, NcfPreviewHeader, NcfPreviewLauncher, PERSPECTIVES, PROJECTION, SECTION_NODE_TYPE, STATUS_COLORS, STATUS_LABELS, SharePreview, UNSET_LABEL, UPGRADE_COMMAND, addColumn, addColumnOption, announce, applySavedPositions, assetName, assetsInFolder, assignmentMap, baseId, blockName, blockTypesFromSchema, buildCollectionQuery, buildCollectionRows, buildContentsQuery, buildLinkGraph, buildPageRows, buildPagesQuery, codeEditorInput, collectLinks, collectOccurrences, colorForRow, colorFromString, columnId, compareVersions, componentDefaultsMainDocument, componentDefaultsMainDocuments, countByFolder, createPreviewLauncher, customEnvironment, defaultNodeSize, defaultsFieldName, defineCodeEmbedType, defineComponentDefaults, depth, deriveCollectionColumns, deriveDocumentColumns, detectPageBuilderField, diffDocuments, diffWords, discoverCollectionTypes, downloadText, editIntentPath, explainGrantError, fallbackLayout, fetchDetail, fetchTimeline, fillTemplate, filterAssets, filterRows as filterCollectionRows, filterRows$1 as filterRows, fixCrossLanguageReferences, flatten, formatBytes, formatDocumentValue, groupComponents, groupMap, groupPageRows, groupValue, hasBlockingIssue, humanizeBlockName, isDraftId, isImageAsset, isKitType, isPrerelease, isSafeColumnKey, isSafeFieldPath, isTextChange, isVersionId, issuesForTool, keyForPath, kitSchemaTypes, layoutGraph, layoutSectionsMap, localesInRows, mergeVersions, missingPageTypes, moveColumn, nameMap, ncfAllowedOrigins, ncfCollectionTable, ncfCollections, ncfKit, ncfMainDocuments, ncfPresentationComponents, ncfPreviewComponents, normalizeInternalPath, normalizePath, occurrencesForTypes, pageThumbnailUrl, pageTypeFor, pageTypesFromSiteRoutes, pageTypesWithoutBuilder, parentPath, presentationPath, pruneSavedPositions, releaseId, removeColumn, renameColumn, requestPreviewGrant, requiredUnlessDefault, requiredUnlessDefaultFor, resolveColorBy, resolveConfig, resolvePageBuilderField, sectionNamesFromDefaults, segments, slugKey, sortAssets, sortRows as sortCollectionRows, sortRows$1 as sortRows, summarize, thumbnailUrl, titleColumn, toCsv, toKebabCase, toPath, toUrl, topLevelBlockCount, uniqueColumnId, upgradePrompt, upsertLayout, urlOn, useAnnotations, useAssetMeta, useAssetUpload, useAssets, useBoardLayout, useCollection, useComponentNames, useDocumentColumns, useHistory, useInternalColumns, useKitClient, useKitConfig, useKitContext, useKitUpdate, useOccurrences, useOptionalKitConfig, useOptionalKitContext, usePageBuilder, usePageContents, usePages, usePreviewTarget, useRegistration, validateConfig, withAlpha, withCustomNames, withMoreTool, withSameLanguageReferences };
14071
+ export { ANNOTATION_TYPE, ActorName, AssetSourceBrowser, AssetsTool, BOARD_LAYOUT_ID, BOARD_LAYOUT_TYPE, BRAIN_NODE_SIZE, BoardLayoutProvider, COLUMN_TYPE, CONTENT_SCAN_LIMIT, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, CUSTOM_ENVIRONMENT_ID, CodeEditorInput, CodeEmbedInput, CollectionTable, DATA_PREFIX, DEFAULT_BOARD_TAGS, DEFAULT_COMPONENT_DEFAULTS_TYPE, DEFAULT_COMPONENT_PREVIEW, DEFAULT_I18N, DEFAULT_INTERNAL_FIELDS, DEFAULT_MORE_TOOLS, DEFAULT_PAGE_BUILDER_FIELD, DEFAULT_SLUG_FIELD, DEFAULT_TITLE_FIELD, HelpTextStyle, KIT_API_VERSION, KIT_VERSION, NCF_ASSETS_TOOL, NCF_COMPONENTS_TOOL, NCF_DESIGN_SYSTEM_TOOL, NCF_HIDDEN_TYPES, NCF_HISTORY_TOOL, NCF_MORE_TOOL, NCF_PAGES_TOOL, NCF_TOOL_NAMES, NODE_FIELD_TYPE, NODE_HEIGHT, NODE_WIDTH, NcfKitNavbar, NcfKitUpdate, NcfPreviewHeader, NcfPreviewLauncher, PERSPECTIVES, PROJECTION, SECTION_NODE_TYPE, STATUS_COLORS, STATUS_LABELS, SharePreview, UNSET_LABEL, UPGRADE_COMMAND, addColumn, addColumnOption, announce, applySavedPositions, assetName, assetsInFolder, assignmentMap, baseId, blockName, blockTypesFromSchema, buildCollectionQuery, buildCollectionRows, buildContentsQuery, buildLinkGraph, buildPageRows, buildPagesQuery, codeEditorInput, collectLinks, collectOccurrences, colorForRow, colorFromString, columnId, compareVersions, componentDefaultsMainDocument, componentDefaultsMainDocuments, countByFolder, createPreviewLauncher, customEnvironment, defaultNodeSize, defaultsFieldName, defineCodeEmbedType, defineComponentDefaults, depth, deriveCollectionColumns, deriveDocumentColumns, detectPageBuilderField, diffDocuments, diffWords, discoverCollectionTypes, downloadText, editIntentPath, explainGrantError, fallbackLayout, fetchDetail, fetchTimeline, fillTemplate, filterAssets, filterRows as filterCollectionRows, filterRows$1 as filterRows, fixCrossLanguageReferences, flatten, formatBytes, formatDocumentValue, groupComponents, groupMap, groupPageRows, groupValue, hasBlockingIssue, humanizeBlockName, isDraftId, isImageAsset, isKitType, isPrerelease, isSafeColumnKey, isSafeFieldPath, isTextChange, isVersionId, issuesForTool, keyForPath, kitSchemaTypes, layoutGraph, layoutSectionsMap, localesInRows, mergeVersions, missingPageTypes, moveColumn, nameMap, ncfAllowedOrigins, ncfCollectionTable, ncfCollections, ncfKit, ncfMainDocuments, ncfPresentationComponents, ncfPreviewComponents, normalizeInternalPath, normalizePath, occurrencesForTypes, pageThumbnailUrl, pageTypeFor, pageTypesFromSiteRoutes, pageTypesWithoutBuilder, parentPath, presentationPath, pruneSavedPositions, releaseId, removeColumn, renameColumn, requestPreviewGrant, requiredUnlessDefault, requiredUnlessDefaultFor, resolveColorBy, resolveConfig, resolvePageBuilderField, sectionNamesFromDefaults, segments, slugKey, sortAssets, sortRows as sortCollectionRows, sortRows$1 as sortRows, summarize, thumbnailUrl, titleColumn, toCsv, toKebabCase, toPath, toUrl, topLevelBlockCount, uniqueColumnId, upgradePrompt, upsertLayout, urlOn, useAnnotations, useAssetMeta, useAssetUpload, useAssets, useBoardLayout, useCollection, useComponentNames, useDocumentColumns, useHistory, useInternalColumns, useKitClient, useKitConfig, useKitContext, useKitUpdate, useOccurrences, useOptionalKitConfig, useOptionalKitContext, usePageBuilder, usePageContents, usePages, usePreviewTarget, useRegistration, validateConfig, withAlpha, withCustomNames, withMoreTool, withSameLanguageReferences };
14029
14072
 
14030
14073
  //# sourceMappingURL=index.js.map