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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,50 @@
1
1
  # Journal des versions
2
2
 
3
+ ## 2.64.0 : Studio, la valeur qui s'applique est toujours cochée ; onglet Composants plus lisible
4
+
5
+ ### Ajouté
6
+
7
+ - **`withNcfChoiceInputs(types, options)`** (sanity.config.ts) : dans les sections, leurs
8
+ valeurs par défaut et les champs style / taille des liens, chaque liste de choix (fond,
9
+ position de l'image, mise en page, style et taille du bouton...) COCHE la valeur qui
10
+ s'applique : la valeur par défaut du composant (Réglages > Composants), sinon celle du
11
+ code (`options.ncfFallback`, sinon la première), marquée « (défaut) », sans l'enregistrer.
12
+ Choisir une autre valeur l'enregistre : la pastille bleue et sa croix de retour au défaut
13
+ apparaissent ; recliquer sur « (défaut) » revient à l'héritage. Avant, rien n'était coché
14
+ tant qu'on n'avait pas choisi : impossible de savoir ce qui s'affichait.
15
+ - **Niveaux de titre** (`options.ncfHeadingLevel`) : le niveau logique du composant
16
+ coché « (défaut) » (heading-levels.json, la même source que le site) ; titres des
17
+ éléments : un niveau sous le titre de la section, coché aussi. Option P (aspect de
18
+ titre, sans valeur de titre).
19
+ - **Carré de couleur** à côté du nom (`options.ncfSwatches`, jetons de design-tokens.json)
20
+ et **cartes illustrées** des mises en page (`options.ncfThumbs`, schéma SVG par valeur).
21
+ - **Curseur** pour un nombre avec `options.range` ({min, max, step, labels, unit}).
22
+ - **Texte d'un élément de liste vide** : « vide : rien ne s'affiche » dans le champ.
23
+ - **« Add item » sur une liste héritée** des valeurs par défaut : recopie d'abord les
24
+ éléments par défaut, la section ne disparaît plus de l'aperçu.
25
+ - Options : `colors`, `headingLevels`, `labels` (anglais par défaut), `fallbacks`
26
+ ({'secondary.style': 'secondary'}), `defaultsType`, `namespace`, `linkType`.
27
+ - **Onglet Composants** : vue par groupes, un groupe sur deux sur un fond teinté ; chaque
28
+ vignette montre d'abord la mosaïque de toutes les dispositions du composant
29
+ (`/sections/<nom>--dispositions.png`), sinon la capture simple.
30
+ - **`doctor`** : ✖ « Choix pré-cochés » tant que withNcfChoiceInputs n'est pas branché
31
+ (⚠ si le projet a encore sa propre copie, ex. Société Paul Ricard avant 2.64.0).
32
+
33
+ ### À brancher dans le projet
34
+
35
+ - **sanity.config.ts** : `types: ... withNcfChoiceInputs(schemaTypes, {colors: tokens.colors,
36
+ headingLevels, labels: {default: '(défaut)', reset: 'Réinitialiser', emptyItem: "Vide : rien
37
+ ne s'affiche"}})` (`tokens` = web/app/lib/design-tokens.json, `headingLevels` =
38
+ web/app/lib/heading-levels.json), au plus près des types (avant withNcfFormTabs).
39
+ - **Niveaux de titre** : `headingLevelField` / `itemHeadingLevelField` du starter avec
40
+ `options.ncfHeadingLevel` ({section: type} / {item: true}), sans `components.input` ni
41
+ `layout: 'radio'` ; supprimer `studio/schemaTypes/sections/HeadingLevelInput.tsx`.
42
+ - **Valeur du code** d'une liste dont le site ne prend pas la première valeur :
43
+ `options.ncfFallback` (sinon le Studio cocherait une autre valeur que celle affichée).
44
+ - **Mosaïques de l'onglet Composants** (facultatif) : `web/scripts/screenshot-sections.mjs`
45
+ du starter (produit `<nom>--dispositions.png` dans la CI des captures).
46
+ - Projet qui avait sa propre copie (Paul Ricard) : la remplacer par withNcfChoiceInputs.
47
+
3
48
  ## 2.63.0 : PageSpeed, l'image LCP vérifiée sur chaque page (jamais lazy, fetchpriority=high)
4
49
 
5
50
  ### Ajouté
package/bin/ncf-kit.mjs CHANGED
@@ -352,6 +352,19 @@ async function doctor() {
352
352
  ? ok('Collections : vue tableur', 'ncfCollectionTable / ncfCollections dans la structure')
353
353
  : warn('Collections : vue tableur', "le kit propose une vue tableur des collections (tri, recherche, colonnes, export CSV, création) ; le projet ne la branche pas : dans la structure du Studio, .child(ncfCollectionTable(S, ncfOptions, type, {id, title})) sur chaque collection (voir collectionTable et byLanguage(..., asTable) dans studio/sanity.config.ts du starter). Les pages gardent la liste native.")
354
354
  }
355
+ // Saisies de choix (kit >= 2.64.0) : la valeur appliquée (valeur par défaut comprise)
356
+ // est toujours cochée, marquée « (défaut) », niveaux de titre compris. Branchement dans
357
+ // le projet : schema.types enveloppé par withNcfChoiceInputs (sanity.config.ts).
358
+ {
359
+ const studioSources = walk(studio).filter((f) => /\.(m?[jt]sx?)$/.test(f) && !f.includes('node_modules'))
360
+ const wired = studioSources.some((f) => /\bwithNcfChoiceInputs\(/.test(read(f)))
361
+ const local = studioSources.find((f) => /\bwithChoiceInputsOnTypes\(/.test(read(f)) && !/withChoiceInputsOnTypes\s*[=(][^\n]*=>|function withChoiceInputsOnTypes/.test(read(f)))
362
+ if (wired) ok('Choix pré-cochés', 'withNcfChoiceInputs (valeur par défaut cochée, niveaux de titre, curseurs)')
363
+ else if (local)
364
+ warn('Choix pré-cochés', `le projet a sa propre copie (${local.replace(root + '/', '')}) ; le kit la fournit désormais : remplacer withChoiceInputsOnTypes par withNcfChoiceInputs(types, {colors: tokens.colors, headingLevels, labels}) et supprimer studio/tools/design/{DefaultChoiceInput,HeadingLevelInput,ItemTextInput,InheritedListInput,RangeInput,choiceInputs,componentDefaults}.`)
365
+ else
366
+ ko('Choix pré-cochés', "le kit coche dans chaque liste de choix des sections (fond, style et taille du bouton, mise en page, niveau de titre...) la valeur qui s'applique, marquée « (défaut) » ; le projet ne le branche pas : dans sanity.config.ts, schema.types = withNcfChoiceInputs(types, {colors: tokens.colors, headingLevels, labels: {default: '(défaut)', reset: 'Réinitialiser', emptyItem: \"Vide : rien ne s'affiche\"}}) (voir le starter). Retirer la saisie propre au starter sur les niveaux de titre (HeadingLevelInput) au profit de options.ncfHeadingLevel.")
367
+ }
355
368
  if (!config.includes('ncfAllowedOrigins')) ko('Origines autorisées', "presentationTool sans allowOrigins: ncfAllowedOrigins(options) : l'aperçu de la préproduction s'affiche mais reste muet.")
356
369
  else ok('Origines autorisées', 'ncfAllowedOrigins')
357
370
  if (/preprodUrl\s*:\s*false/.test(config)) ko('Préproduction désactivée', "sanity.config contient preprodUrl: false : la préproduction conventionnelle est retirée. À n'utiliser que si le projet n'en a vraiment pas.")
package/dist/index.d.ts CHANGED
@@ -1290,6 +1290,50 @@ export declare function NcfKitNavbar(props: NavbarProps): import("react").JSX.El
1290
1290
  * feuille de style. Un seul `<style>` pour tout le Studio.
1291
1291
  */
1292
1292
  export declare function HelpTextStyle(props: LayoutProps): import("react").JSX.Element;
1293
+ /** Options de withNcfChoiceInputs (sanity.config.ts du projet). */
1294
+ interface NcfChoiceInputsOptions {
1295
+ /**
1296
+ * Couleurs de la charte, pour les carrés de couleur (options.ncfSwatches) : la clé
1297
+ * `colors` de web/app/lib/design-tokens.json ({jeton: {value: '#hex'}}).
1298
+ */
1299
+ colors?: Record<string, {
1300
+ value: string;
1301
+ }>;
1302
+ /**
1303
+ * Niveaux de titre logiques, la même source que le site : web/app/lib/heading-levels.json
1304
+ * ({default: 'h2', sections: {'section.hero': 'h1', ...}}).
1305
+ */
1306
+ headingLevels?: {
1307
+ default?: string;
1308
+ sections?: Record<string, string>;
1309
+ };
1310
+ /** Type du document des valeurs par défaut (défaut : componentDefaults). */
1311
+ defaultsType?: string;
1312
+ /** Préfixe des types de sections (défaut : « section. »). */
1313
+ namespace?: string;
1314
+ /** Type des liens dont les champs style et size reçoivent la saisie (défaut : link). */
1315
+ linkType?: string;
1316
+ /**
1317
+ * Repli propre à un emplacement, quand ni l'instance ni les valeurs par défaut ne
1318
+ * fixent la valeur : {'champParent.champ': valeur}. Ex. {'secondary.style': 'secondary'}
1319
+ * pour un bouton secondaire, comme le site (LinkButton defaultStyle).
1320
+ */
1321
+ fallbacks?: Record<string, string>;
1322
+ /** Libellés (interface du kit en anglais par défaut ; le starter les passe en français). */
1323
+ labels?: {
1324
+ default?: string;
1325
+ reset?: string;
1326
+ emptyItem?: string;
1327
+ };
1328
+ }
1329
+ /**
1330
+ * Saisies de choix du kit sur les types du projet (sanity.config.ts, `schema.types`) :
1331
+ * sections (et leur document de valeurs par défaut), champs style et size des liens.
1332
+ * Un champ qui a déjà sa propre saisie (components.input) n'est jamais remplacé.
1333
+ * Appliqué dans sanity.config.ts seulement : les scripts qui lisent les schémas
1334
+ * (npm run options, defaults:fill) n'importent aucun composant React.
1335
+ */
1336
+ export declare function withNcfChoiceInputs<T>(types: T[], options?: NcfChoiceInputsOptions): T[];
1293
1337
  /**
1294
1338
  * Comparaison de deux versions sémantiques.
1295
1339
  *
@@ -1438,7 +1482,7 @@ export declare function ActorName(props: {
1438
1482
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1439
1483
  * le vérifie.
1440
1484
  */
1441
- export declare const KIT_VERSION = "2.63.0-rc.1";
1485
+ export declare const KIT_VERSION = "2.64.0-rc.1";
1442
1486
  /**
1443
1487
  * Données de la page proposées comme colonnes.
1444
1488
  *
@@ -2147,5 +2191,5 @@ export declare const NCF_DESIGN_SYSTEM_TOOL = "ncf-design-system";
2147
2191
  export declare const NCF_ASSETS_TOOL = "ncf-assets";
2148
2192
  export declare const NCF_TOOL_NAMES: readonly ["ncf-pages", "ncf-components", "ncf-history", "ncf-design-system", "ncf-assets"];
2149
2193
  export declare const ncfKit: import("sanity").Plugin<NcfKitConfig>;
2150
- export { type AddColumnInput, type Annotation, type AnnotationsState, type AssetAssignment, type AssetDoc, type AssetFolder, type AssetMetaState, type AssetSortKey, type AssetTypeFilter, type AssetUploadState, type AssetUsageFilter, type BlockOccurrence, type BlockTypeInfo, type BoardEdge, type BoardGraph, type BoardLayoutState, type BoardNode, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, type Change, type ChangeKind, CodeEditorInput, CodeEmbedInput, type CodeEmbedTypeOptions, type CodeLanguage, type CollectedLinks, type CollectionCell, type CollectionColumn, type CollectionColumnKind, type CollectionDoc, type CollectionFilters, type CollectionRow, type CollectionSort, type CollectionState, type ColorBy, type ColorOptions, type ComponentEntry, type ComponentGroup, type ComponentGrouping, type ConfigIssue, type CrossLanguageReport, DEFAULT_COMPONENT_DEFAULTS_TYPE, type DeriveOptions, type FolderSelection, type GroupBy, type GroupOptions, type HistoryDetail, type HistoryEvent, type IssueLevel, type KitContextValue, type KitUpdate, type LayoutMode, type MainDocumentRoute, type MergedDoc, type NcfBoardTag, type NcfCollectionsConfig, type NcfComponentPreviewConfig, type NcfDocumentColumn, type NcfEnvironment, type NcfHistoryConfig, type NcfI18nConfig, type NcfInternalField, type NcfInternalFieldOption, type NcfKitConfig, type NcfPageTypeConfig, type NcfPageTypeInput, type NcfToolName, type NcfToolsConfig, type NodeLayout, type NodePosition, type OccurrenceInput, type OccurrencePage, type OccurrencesState, type PageBuilderResolution, type PageContent, type PageContentsState, type PageDoc, type PageFilters, type PageRow, type PageStatus, type PagesState, type PathInput, type Positioned, type PresentationOptions, type PreviewGrant, type PreviewPerspective, type PreviewTargetState, type ProjectStatus, type Registration, type ResolvedCollections, type ResolvedComponentPreview, type ResolvedDocumentColumn, type ResolvedHistory, type ResolvedI18n, type ResolvedKitConfig, type ResolvedPageType, type RowColor, type RowGroup, type SchemaFieldLike, type SchemaTypeInfo, type SchemaTypeLike, type SectionLayout, type SectionMapNode, type SectionOrder, type SectionsMapOptions, type Segment, type SiteRoutesRegistry, type SortDirection, type SortKey, type ThumbnailInput, type VersionedDoc, codeEditorInput, componentDefaultsMainDocument, componentDefaultsMainDocuments, defaultsFieldName, defineCodeEmbedType, defineComponentDefaults, filterRows as filterCollectionRows, filterRows$1 as filterRows, fixCrossLanguageReferences, pageTypesFromSiteRoutes, requiredUnlessDefault, requiredUnlessDefaultFor, sortRows as sortCollectionRows, sortRows$1 as sortRows, withSameLanguageReferences };
2194
+ export { type AddColumnInput, type Annotation, type AnnotationsState, type AssetAssignment, type AssetDoc, type AssetFolder, type AssetMetaState, type AssetSortKey, type AssetTypeFilter, type AssetUploadState, type AssetUsageFilter, type BlockOccurrence, type BlockTypeInfo, type BoardEdge, type BoardGraph, type BoardLayoutState, type BoardNode, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, type Change, type ChangeKind, CodeEditorInput, CodeEmbedInput, type CodeEmbedTypeOptions, type CodeLanguage, type CollectedLinks, type CollectionCell, type CollectionColumn, type CollectionColumnKind, type CollectionDoc, type CollectionFilters, type CollectionRow, type CollectionSort, type CollectionState, type ColorBy, type ColorOptions, type ComponentEntry, type ComponentGroup, type ComponentGrouping, type ConfigIssue, type CrossLanguageReport, DEFAULT_COMPONENT_DEFAULTS_TYPE, type DeriveOptions, type FolderSelection, type GroupBy, type GroupOptions, type HistoryDetail, type HistoryEvent, type IssueLevel, type KitContextValue, type KitUpdate, type LayoutMode, type MainDocumentRoute, type MergedDoc, type NcfBoardTag, type NcfChoiceInputsOptions, type NcfCollectionsConfig, type NcfComponentPreviewConfig, type NcfDocumentColumn, type NcfEnvironment, type NcfHistoryConfig, type NcfI18nConfig, type NcfInternalField, type NcfInternalFieldOption, type NcfKitConfig, type NcfPageTypeConfig, type NcfPageTypeInput, type NcfToolName, type NcfToolsConfig, type NodeLayout, type NodePosition, type OccurrenceInput, type OccurrencePage, type OccurrencesState, type PageBuilderResolution, type PageContent, type PageContentsState, type PageDoc, type PageFilters, type PageRow, type PageStatus, type PagesState, type PathInput, type Positioned, type PresentationOptions, type PreviewGrant, type PreviewPerspective, type PreviewTargetState, type ProjectStatus, type Registration, type ResolvedCollections, type ResolvedComponentPreview, type ResolvedDocumentColumn, type ResolvedHistory, type ResolvedI18n, type ResolvedKitConfig, type ResolvedPageType, type RowColor, type RowGroup, type SchemaFieldLike, type SchemaTypeInfo, type SchemaTypeLike, type SectionLayout, type SectionMapNode, type SectionOrder, type SectionsMapOptions, type Segment, type SiteRoutesRegistry, type SortDirection, type SortKey, type ThumbnailInput, type VersionedDoc, codeEditorInput, componentDefaultsMainDocument, componentDefaultsMainDocuments, defaultsFieldName, defineCodeEmbedType, defineComponentDefaults, filterRows as filterCollectionRows, filterRows$1 as filterRows, fixCrossLanguageReferences, pageTypesFromSiteRoutes, requiredUnlessDefault, requiredUnlessDefaultFor, sortRows as sortCollectionRows, sortRows$1 as sortRows, withSameLanguageReferences };
2151
2195
  //# sourceMappingURL=index.d.ts.map