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

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
@@ -38,7 +38,12 @@
38
38
  web/app/lib/heading-levels.json), au plus près des types (avant withNcfFormTabs).
39
39
  - **Niveaux de titre** : `headingLevelField` / `itemHeadingLevelField` du starter avec
40
40
  `options.ncfHeadingLevel` ({section: type} / {item: true}), sans `components.input` ni
41
- `layout: 'radio'` ; supprimer `studio/schemaTypes/sections/HeadingLevelInput.tsx`.
41
+ `layout: 'radio'`.
42
+ - **Supprimer les saisies de choix propres au projet** : `doctor` liste les fichiers
43
+ présents dans CE projet (selon son âge : `studio/schemaTypes/sections/HeadingLevelInput.tsx`
44
+ du starter, ou une copie dans `studio/tools/design/`).
45
+ - Bouton secondaire : rien à faire, le kit coche « secondaire » pour un champ `secondary`
46
+ (option `fallbacks`, à compléter si le projet a d'autres conventions).
42
47
  - **Valeur du code** d'une liste dont le site ne prend pas la première valeur :
43
48
  `options.ncfFallback` (sinon le Studio cocherait une autre valeur que celle affichée).
44
49
  - **Mosaïques de l'onglet Composants** (facultatif) : `web/scripts/screenshot-sections.mjs`
@@ -61,12 +66,29 @@
61
66
  plus fetchpriority.
62
67
  - **`doctor`** : ✖ « PageSpeed : image LCP » tant que la CI du projet ne lance pas
63
68
  `check-lcp` (ou que playwright manque au site).
69
+ - **En CI, `check-lcp` exige `NEXT_PUBLIC_SANITY_PROJECT_ID`** : sans projet Sanity, le site
70
+ construit n'a aucun contenu et le contrôle ne prouverait rien (vu sur JAF).
71
+
72
+ ### Corrigé
73
+
74
+ - **`doctor` avec une version de test** (X.Y.Z-rc.N) plus récente que la dernière publiée :
75
+ il conseillait « npm install @latest », c'est-à-dire un retour en arrière. Il l'indique
76
+ désormais comme version de test, et le conseil de mise à jour passe par
77
+ `npx -y @nocode-factory/sanity-kit@latest upgrade`.
78
+ - **`upgrade --version <version de test>`** : la consigne de fin ne dit plus de déployer le
79
+ Studio ; elle dit de vérifier en local, sur une branche à part, sans fusionner.
64
80
 
65
81
  ### À brancher dans le projet
66
82
 
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).
83
+ - **CI** (`.github/workflows/ci.yml`, job du site, après `npm run build`, avec EXACTEMENT
84
+ les mêmes variables d'environnement que l'étape `npm run build`) : `npx playwright
85
+ install --with-deps chromium` puis `npx ncf-kit check-lcp`. `playwright` en devDependency
86
+ du site (le starter l'a). **Variable du dépôt GitHub `NEXT_PUBLIC_SANITY_PROJECT_ID`**
87
+ obligatoire (Settings > Secrets and variables > Actions > Variables ; pas un secret).
88
+ - **Image LCP hors de la 1re section** : dans `web/components/sections/index.tsx` du starter,
89
+ `lcpSectionIndex` donne aussi `priority` à la première des 3 premières sections qui affiche
90
+ une image quand la 1re n'en a pas (texte seul, valeur par défaut absente dans une langue).
91
+ Chaque section qui affiche une image et peut ouvrir une page applique sa prop `priority`.
70
92
  - **Images du haut de page** : reprendre du starter `lcpImageProps` /
71
93
  `aboveFoldImageProps` (`web/components/SanityImage.tsx`, `<SanityImage priority />`
72
94
  ne passe plus `priority` à next/image), et dans chaque section qui peut être en haut de
package/bin/check-lcp.mjs CHANGED
@@ -42,6 +42,16 @@ const fail = (message) => {
42
42
  process.exit(1);
43
43
  };
44
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
+
45
55
  let chromium;
46
56
  try {
47
57
  ({ chromium } = createRequire(join(process.cwd(), "package.json"))("playwright"));
package/bin/ncf-kit.mjs CHANGED
@@ -283,8 +283,17 @@ async function doctor() {
283
283
  const r = await probe(`https://registry.npmjs.org/${PKG}/latest`)
284
284
  if (r.status === 200) latest = (await (await fetch(`https://registry.npmjs.org/${PKG}/latest`)).json()).version
285
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
+ }
286
294
  if (!version) ko('Version du kit', 'non installé dans le studio')
287
- 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/)`)
288
297
  else ok('Version du kit', version)
289
298
  // Le site embarque aussi le kit (bandeau, garde, liens, valeurs par défaut) : une
290
299
  // version différente du Studio = corrections du kit absentes d'un côté.
@@ -359,9 +368,14 @@ async function doctor() {
359
368
  const studioSources = walk(studio).filter((f) => /\.(m?[jt]sx?)$/.test(f) && !f.includes('node_modules'))
360
369
  const wired = studioSources.some((f) => /\bwithNcfChoiceInputs\(/.test(read(f)))
361
370
  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)')
371
+ // Fichiers d'une copie locale (Paul Ricard, projets qui l'ont reprise) ou de l'ancienne
372
+ // saisie du starter : listés tels qu'ils existent dans CE projet.
373
+ const COPY = /(^|\/)(DefaultChoiceInput|HeadingLevelInput|ItemTextInput|InheritedListInput|RangeInput|choiceInputs|componentDefaults)\.tsx?$/
374
+ const copies = studioSources.filter((f) => COPY.test(f) && !/schemaTypes\/componentDefaults/.test(f) && /\b(StringInputProps|ArrayOfObjectsInputProps|NumberInputProps|useInheritedValue|withChoiceInputsOnTypes)\b/.test(read(f))).map((f) => f.replace(root + '/', ''))
375
+ const leftovers = copies.length ? ` Fichiers à supprimer ici : ${copies.join(', ')}.` : ''
376
+ if (wired) copies.length ? warn('Choix pré-cochés', `withNcfChoiceInputs branché, mais des saisies propres au projet restent.${leftovers}`) : ok('Choix pré-cochés', 'withNcfChoiceInputs (valeur par défaut cochée, niveaux de titre, curseurs)')
363
377
  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}.`)
378
+ 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}).${leftovers}`)
365
379
  else
366
380
  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
381
  }
@@ -849,7 +863,9 @@ async function upgrade() {
849
863
 
850
864
  console.log('\n• Contrôle du projet (doctor --offline) :')
851
865
  spawnSync(process.execPath, [new URL(import.meta.url).pathname, 'doctor', '--offline', '--dir', studio, '--web', web], {stdio: 'inherit'})
852
- 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.')
866
+ if (String(to ?? target).includes('-'))
867
+ 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.')
868
+ 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.')
853
869
  }
854
870
 
855
871
  async function translations() {
package/dist/index.d.ts CHANGED
@@ -1315,8 +1315,9 @@ interface NcfChoiceInputsOptions {
1315
1315
  linkType?: string;
1316
1316
  /**
1317
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).
1318
+ * fixent la valeur : {'champParent.champ': valeur}, ajouté aux replis du kit. Par défaut
1319
+ * (convention du starter) : {'secondary.style': 'secondary'}, le bouton « secondary »
1320
+ * d'une section est secondaire, comme sur le site (LinkButton defaultStyle).
1320
1321
  */
1321
1322
  fallbacks?: Record<string, string>;
1322
1323
  /** Libellés (interface du kit en anglais par défaut ; le starter les passe en français). */
@@ -1482,7 +1483,7 @@ export declare function ActorName(props: {
1482
1483
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1483
1484
  * le vérifie.
1484
1485
  */
1485
- export declare const KIT_VERSION = "2.64.0-rc.1";
1486
+ export declare const KIT_VERSION = "2.64.0-rc.2";
1486
1487
  /**
1487
1488
  * Données de la page proposées comme colonnes.
1488
1489
  *
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.64.0-rc.1";
1426
+ const KIT_VERSION = "2.64.0-rc.2";
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.64.0-rc.1") > 0);
1934
+ let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.64.0-rc.2") > 0);
1935
1935
  return {
1936
1936
  current: KIT_VERSION,
1937
1937
  latest,
@@ -13258,7 +13258,7 @@ function createChoiceInputs(o) {
13258
13258
  RangeInput
13259
13259
  };
13260
13260
  }
13261
- const RANGE_CSS = "\n.ncf-range{-webkit-appearance:none;appearance:none;flex:1;height:24px;margin:0;background:transparent;cursor:pointer}\n.ncf-range:disabled{cursor:default;opacity:.5}\n.ncf-range::-webkit-slider-runnable-track{height:2px;border-radius:2px;background:var(--card-muted-fg-color,#8a8a8a)}\n.ncf-range::-moz-range-track{height:2px;border-radius:2px;background:var(--card-muted-fg-color,#8a8a8a)}\n.ncf-range::-webkit-slider-thumb{-webkit-appearance:none;width:18px;height:18px;margin-top:-8px;border-radius:50%;background:var(--card-focus-ring-color,#2276fc);border:2px solid var(--card-bg-color,#fff);box-shadow:0 0 0 1px var(--card-focus-ring-color,#2276fc)}\n.ncf-range::-moz-range-thumb{width:14px;height:14px;border-radius:50%;background:var(--card-focus-ring-color,#2276fc);border:2px solid var(--card-bg-color,#fff);box-shadow:0 0 0 1px var(--card-focus-ring-color,#2276fc)}\n.ncf-range:focus-visible{outline:2px solid var(--card-focus-ring-color,#2276fc);outline-offset:4px;border-radius:4px}\n.ncf-range-wrap{position:relative;flex:1;display:flex;align-items:center}\n.ncf-range-wrap::before{content:\"\";position:absolute;left:50%;top:50%;width:2px;height:12px;margin:-6px 0 0 -1px;border-radius:1px;background:var(--card-muted-fg-color,#8a8a8a);pointer-events:none}\n";
13261
+ const RANGE_CSS = "\n.ncf-range{-webkit-appearance:none;appearance:none;flex:1;height:24px;margin:0;background:transparent;cursor:pointer}\n.ncf-range:disabled{cursor:default;opacity:.5}\n.ncf-range::-webkit-slider-runnable-track{height:2px;border-radius:2px;background:var(--card-muted-fg-color,#8a8a8a)}\n.ncf-range::-moz-range-track{height:2px;border-radius:2px;background:var(--card-muted-fg-color,#8a8a8a)}\n.ncf-range::-webkit-slider-thumb{-webkit-appearance:none;width:18px;height:18px;margin-top:-8px;border-radius:50%;background:var(--card-focus-ring-color,#2276fc);border:2px solid var(--card-bg-color,#fff);box-shadow:0 0 0 1px var(--card-focus-ring-color,#2276fc)}\n.ncf-range::-moz-range-thumb{width:14px;height:14px;border-radius:50%;background:var(--card-focus-ring-color,#2276fc);border:2px solid var(--card-bg-color,#fff);box-shadow:0 0 0 1px var(--card-focus-ring-color,#2276fc)}\n.ncf-range:focus-visible{outline:2px solid var(--card-focus-ring-color,#2276fc);outline-offset:4px;border-radius:4px}\n.ncf-range-wrap{position:relative;flex:1;display:flex;align-items:center}\n.ncf-range-wrap::before{content:\"\";position:absolute;left:50%;top:50%;width:2px;height:12px;margin:-6px 0 0 -1px;border-radius:1px;background:var(--card-muted-fg-color,#8a8a8a);pointer-events:none}\n", DEFAULT_FALLBACKS = { "secondary.style": "secondary" };
13262
13262
  function resolveChoiceInputsOptions(input = {}) {
13263
13263
  return {
13264
13264
  colors: input.colors ?? {},
@@ -13269,7 +13269,10 @@ function resolveChoiceInputsOptions(input = {}) {
13269
13269
  defaultsType: input.defaultsType ?? "componentDefaults",
13270
13270
  namespace: input.namespace ?? "section.",
13271
13271
  linkType: input.linkType ?? "link",
13272
- fallbacks: input.fallbacks ?? {},
13272
+ fallbacks: {
13273
+ ...DEFAULT_FALLBACKS,
13274
+ ...input.fallbacks
13275
+ },
13273
13276
  labels: {
13274
13277
  default: input.labels?.default ?? "(default)",
13275
13278
  reset: input.labels?.reset ?? "Reset",