@nocode-factory/sanity-kit 2.8.2 → 2.9.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/README.md CHANGED
@@ -27,6 +27,11 @@ reste d'avant la 2.0.0 (figé en 1.8.0) : le retirer.
27
27
  | layout racine du site | `{isPreviewSite() && <NcfPreviewBanner isDraft={isDraft} />}` |
28
28
  | `.github/workflows/` | captures `public/sections/<bloc>.png` (workflow du starter) |
29
29
  | Studio | `npx ncf-kit setup --types <types de pages>` (journal), puis `npx sanity deploy` |
30
+ | Studio, schéma | `defineComponentDefaults({sections: SECTION_TYPES})` dans `schema.types` (singleton « Composants : valeurs par défaut ») ; champs obligatoires des sections en `requiredUnlessDefault`, jamais d'`initialValue` sur un champ de section |
31
+ | Studio, Presentation | `resolve: {mainDocuments: defineDocuments([componentDefaultsMainDocument({language})])}` |
32
+ | Site, client Sanity | `stega: {studioUrl, filter: stegaFilter}` |
33
+ | Site, rendu des sections | `applyDefaults(section, defaults, isDraft ? reattributeTo(source, section._key) : undefined)` ; défauts lus avec `componentDefaultsQuery(types, projection)` |
34
+ | Site, design system | page `/design-system/composant?type=<nom>` (rendu réel d'un composant, voir le starter) |
30
35
 
31
36
  Puis, depuis `studio/` :
32
37
 
@@ -36,6 +41,39 @@ npx ncf-kit doctor
36
41
 
37
42
  Zéro ✖ = projet complet. Sortie 1 sinon (utilisable en CI).
38
43
 
44
+ ## Composants : valeurs par défaut, instances et overrides
45
+
46
+ Chaque composant (section du page builder) a des **valeurs par défaut**, réglées
47
+ dans le document « 🧩 Composants : valeurs par défaut » (un bloc par composant,
48
+ généré depuis les schémas). Une **instance** (le composant posé sur une page)
49
+ dont un champ est **vide hérite** de la valeur par défaut, et la suit quand elle
50
+ change. Un champ **rempli** est un **override**, jamais écrasé.
51
+
52
+ Dans le Studio :
53
+
54
+ - **Onglet Composants** : un clic sur un composant (grille ou vue Map) ouvre
55
+ Presentation avec son rendu réel et ses valeurs par défaut côte à côte. Depuis
56
+ la Map, chaque page listée ouvre le formulaire sur l'instance.
57
+ - **Formulaire d'une page** : une pastille bleue marque tout champ d'instance
58
+ différent de la valeur par défaut. Au survol, elle affiche la valeur par défaut ;
59
+ au clic, le champ revient en héritage. Un champ qui hérite affiche la valeur par
60
+ défaut (grisée, ou en mention sous les choix).
61
+ - **Preview** : un clic sur un texte hérité ouvre le champ de l'instance.
62
+
63
+ Les outils de schéma sont aussi dans l'entrée `@nocode-factory/sanity-kit/schema`, sans interface : c'est elle qu'importent les fichiers de schéma et les scripts (`sanity exec`).
64
+
65
+ | API | Où | Rôle |
66
+ |---|---|---|
67
+ | `defineComponentDefaults({sections})` | `@nocode-factory/sanity-kit/schema` | type du document des valeurs par défaut |
68
+ | `requiredUnlessDefault` | `@nocode-factory/sanity-kit/schema` | obligatoire sauf valeur par défaut |
69
+ | `componentDefaultsMainDocument({language})` | `@nocode-factory/sanity-kit/schema` | Presentation : page de rendu = valeurs par défaut |
70
+ | `applyDefaults`, `inherit` | `@nocode-factory/sanity-kit/web/defaults` | héritage côté site |
71
+ | `componentDefaultsQuery` | `@nocode-factory/sanity-kit/web/defaults` | requête des valeurs par défaut |
72
+ | `stegaFilter`, `isOptionValue` | `@nocode-factory/sanity-kit/web/defaults` | preview : options jamais encodées |
73
+ | `reattributeTo(source, key)` | `@nocode-factory/sanity-kit/web/defaults` | preview : texte hérité cliquable vers l'instance |
74
+
75
+ `npx ncf-kit doctor` vérifie chaque branchement.
76
+
39
77
  ## Documentation
40
78
 
41
79
  Dans le dépôt `nocode-factory/ncf-sanity-kit` : `docs/INSTALL.md` (options),
package/bin/ncf-kit.mjs CHANGED
@@ -313,6 +313,36 @@ async function doctor() {
313
313
  guard ? ok('Garde de préproduction', guard.replace(root + '/', '')) : ko('Garde de préproduction', 'ncfPreviewGuard absent de proxy.ts (ou middleware.ts) : la préproduction serait publique.')
314
314
  }
315
315
 
316
+ /* Valeurs par défaut des composants : instances, overrides, preview */
317
+ {
318
+ const studioFiles = walk(studio)
319
+ const hasDefaults = studioFiles.some((f) => /defineComponentDefaults\(|name:\s*['"]componentDefaults['"]/.test(read(f)))
320
+ if (!hasDefaults) {
321
+ warn(
322
+ 'Valeurs par défaut des composants',
323
+ "aucun document de valeurs par défaut : schema.types += defineComponentDefaults({sections: SECTION_TYPES}) (sanity-kit), champs obligatoires des sections en requiredUnlessDefault, jamais d'initialValue sur un champ de section. Sans lui, l'onglet Composants n'ouvre que la démo et la pastille d'override est absente.",
324
+ )
325
+ } else {
326
+ ok('Valeurs par défaut des composants', 'document présent')
327
+ if (!/componentDefaultsMainDocument\(|\/design-system\/composant/.test(config))
328
+ warn('Composants : rendu réel', "presentationTool sans resolve.mainDocuments: defineDocuments([componentDefaultsMainDocument({language})]) : un clic dans l'onglet Composants ouvre la page de rendu sans le document à côté.")
329
+ const initialValues = studioFiles.filter((f) => /schemaTypes\/sections\//.test(f) && /\binitialValue\b/.test(read(f)))
330
+ if (initialValues.length)
331
+ ko('Champs de section préremplis', `${initialValues.map((f) => f.replace(root + '/', '')).join(', ')} : un initialValue est un override involontaire, le composant n'héritera jamais de sa valeur par défaut.`)
332
+ if (webPkg) {
333
+ const files = walk(web)
334
+ const apply = findUsage(files, 'applyDefaults(')
335
+ apply ? ok('Héritage côté site', apply.replace(root + '/', '')) : ko('Héritage côté site', "applyDefaults(section, defaults) absent du rendu des sections (@nocode-factory/sanity-kit/web/defaults) : les valeurs par défaut ne s'affichent pas.")
336
+ const filter = findUsage(files, 'stegaFilter')
337
+ filter ? ok('Preview des options', filter.replace(root + '/', '')) : ko('Preview des options', "client Sanity sans stega: {studioUrl, filter: stegaFilter} : en preview, une taille de bouton, un fond ou une texture modifiés ne s'affichent pas.")
338
+ const retag = findUsage(files, 'reattributeTo(')
339
+ retag ? ok('Preview des valeurs héritées', retag.replace(root + '/', '')) : warn('Preview des valeurs héritées', "applyDefaults sans reattributeTo(source, key) en mode brouillon : un clic sur un texte hérité ouvre les valeurs par défaut au lieu de l'instance.")
340
+ const page = files.find((f) => /design-system\/composant\/page\.tsx$/.test(f))
341
+ page ? ok('Page de rendu d\'un composant', page.replace(root + '/', '')) : warn('Page de rendu d\'un composant', "web/app/[locale]/design-system/composant/page.tsx absente : l'onglet Composants n'a rien à afficher à côté des réglages (voir le starter).")
342
+ }
343
+ }
344
+ }
345
+
316
346
  /* Captures des composants */
317
347
  const workflows = walk(join(root, '.github', 'workflows'))
318
348
  const captures = workflows.find((f) => /public\/sections/.test(read(f)))
@@ -0,0 +1,62 @@
1
+ declare const DEFAULT_COMPONENT_DEFAULTS_TYPE = "componentDefaults";
2
+ /** Nom du champ d'un composant dans le document des valeurs par défaut : `section.cta` -> `cta`. */
3
+ declare function defaultsFieldName(type: string, namespace?: string): string;
4
+ /** Document « Composants : valeurs par défaut », généré depuis les sections. */
5
+ declare function defineComponentDefaults(options: {
6
+ sections: readonly unknown[];
7
+ name?: string;
8
+ title?: string;
9
+ namespace?: string;
10
+ }): {
11
+ name: string;
12
+ title: string;
13
+ type: "document";
14
+ description: string;
15
+ fields: {
16
+ name: string;
17
+ title: string;
18
+ type: "object";
19
+ description: string;
20
+ options: {
21
+ collapsible: true;
22
+ collapsed: true;
23
+ };
24
+ fields: never;
25
+ }[];
26
+ preview: {
27
+ prepare: () => {
28
+ title: string;
29
+ };
30
+ };
31
+ };
32
+ /**
33
+ * Règle « obligatoire SAUF si le composant a une valeur par défaut » pour un autre
34
+ * type de document des valeurs par défaut ou un autre espace de noms.
35
+ * `validation: requiredUnlessDefaultFor({type: 'mesDefauts'})`
36
+ */
37
+ declare function requiredUnlessDefaultFor(options?: {
38
+ type?: string;
39
+ namespace?: string;
40
+ }): <R>(rule: R) => R;
41
+ /**
42
+ * Champ de section obligatoire, SAUF si le composant a une valeur par défaut
43
+ * pour ce champ (elle s'affichera). Tout type de champ.
44
+ * `validation: requiredUnlessDefault`
45
+ */
46
+ declare const requiredUnlessDefault: <R>(rule: R) => R;
47
+ /**
48
+ * Presentation : la page qui rend un composant seul (par défaut
49
+ * `/design-system/composant`) a pour document principal les valeurs par défaut.
50
+ * Rendu réel et réglages côte à côte, en direct.
51
+ * `presentationTool({resolve: {mainDocuments: defineDocuments([componentDefaultsMainDocument({language: 'fr'})])}})`
52
+ */
53
+ declare function componentDefaultsMainDocument(options?: {
54
+ language?: string;
55
+ route?: string;
56
+ type?: string;
57
+ }): {
58
+ route: string;
59
+ filter: string;
60
+ };
61
+ export { requiredUnlessDefault as a, defineComponentDefaults as i, componentDefaultsMainDocument as n, requiredUnlessDefaultFor as o, defaultsFieldName as r, DEFAULT_COMPONENT_DEFAULTS_TYPE as t };
62
+ //# sourceMappingURL=componentDefaults-CbOXLaYE.d.ts.map
@@ -0,0 +1,77 @@
1
+ import { defineField, defineType } from "sanity";
2
+ const DEFAULT_COMPONENT_DEFAULTS_TYPE = "componentDefaults";
3
+ /** Nom du champ d'un composant dans le document des valeurs par défaut : `section.cta` -> `cta`. */
4
+ function defaultsFieldName(type, namespace = "section.") {
5
+ return type.startsWith(namespace) ? type.slice(namespace.length) : type;
6
+ }
7
+ const relax = (f) => {
8
+ let { validation: _v, initialValue: _i, ...rest } = f;
9
+ return {
10
+ ...rest,
11
+ ...rest.fields ? { fields: rest.fields.map(relax) } : {},
12
+ ...rest.of ? { of: rest.of.map(relax) } : {}
13
+ };
14
+ };
15
+ /** Document « Composants : valeurs par défaut », généré depuis les sections. */
16
+ function defineComponentDefaults(options) {
17
+ let { name = DEFAULT_COMPONENT_DEFAULTS_TYPE, title = "🧩 Composants : valeurs par défaut", namespace = "section." } = options;
18
+ return defineType({
19
+ name,
20
+ title,
21
+ type: "document",
22
+ description: "Valeurs appliquées à chaque instance d'un composant dont le champ est vide. Un champ rempli dans une instance reste prioritaire (override).",
23
+ fields: options.sections.map((t) => defineField({
24
+ name: defaultsFieldName(t.name, namespace),
25
+ title: t.title || t.name,
26
+ type: "object",
27
+ description: "Valeurs par défaut de ce composant. Vide = valeur du design system.",
28
+ options: {
29
+ collapsible: !0,
30
+ collapsed: !0
31
+ },
32
+ fields: t.fields.map(relax)
33
+ })),
34
+ preview: { prepare: () => ({ title: title.replace(/^\S+\s/, "") }) }
35
+ });
36
+ }
37
+ const isEmpty = (v) => v == null || v === "" || Array.isArray(v) && v.length === 0;
38
+ /**
39
+ * Règle « obligatoire SAUF si le composant a une valeur par défaut » pour un autre
40
+ * type de document des valeurs par défaut ou un autre espace de noms.
41
+ * `validation: requiredUnlessDefaultFor({type: 'mesDefauts'})`
42
+ */
43
+ function requiredUnlessDefaultFor(options = {}) {
44
+ let { type: defaultsType = DEFAULT_COMPONENT_DEFAULTS_TYPE, namespace = "section." } = options;
45
+ return (rule) => rule.custom(async (value, context) => {
46
+ if (!isEmpty(value)) return !0;
47
+ let type = context.parent?._type, field = context.path?.[context.path.length - 1], name = type ? defaultsFieldName(type, namespace) : "";
48
+ if (!type?.startsWith(namespace) || typeof field != "string" || !/^\w+$/.test(name) || !/^\w+$/.test(field)) return "Obligatoire.";
49
+ let language = context.document?.language ?? null, inherited = await context.getClient({ apiVersion: "2024-10-01" }).fetch(`*[_type == $defaultsType && !(_id in path("drafts.**")) && ($language == null || language == $language)][0].${name}.${field}`, {
50
+ defaultsType,
51
+ language
52
+ });
53
+ return !isEmpty(inherited) || "Obligatoire (ou à définir dans Composants > valeurs par défaut).";
54
+ });
55
+ }
56
+ /**
57
+ * Champ de section obligatoire, SAUF si le composant a une valeur par défaut
58
+ * pour ce champ (elle s'affichera). Tout type de champ.
59
+ * `validation: requiredUnlessDefault`
60
+ */
61
+ const requiredUnlessDefault = requiredUnlessDefaultFor();
62
+ /**
63
+ * Presentation : la page qui rend un composant seul (par défaut
64
+ * `/design-system/composant`) a pour document principal les valeurs par défaut.
65
+ * Rendu réel et réglages côte à côte, en direct.
66
+ * `presentationTool({resolve: {mainDocuments: defineDocuments([componentDefaultsMainDocument({language: 'fr'})])}})`
67
+ */
68
+ function componentDefaultsMainDocument(options = {}) {
69
+ let { language, route = "/design-system/composant", type = DEFAULT_COMPONENT_DEFAULTS_TYPE } = options, safeLang = language && /^[a-z]{2}(-[A-Za-z]{2})?$/.test(language) ? language : null;
70
+ return {
71
+ route,
72
+ filter: `_type == "${type}"${safeLang ? ` && language == "${safeLang}"` : ""}`
73
+ };
74
+ }
75
+ export { requiredUnlessDefault as a, defineComponentDefaults as i, componentDefaultsMainDocument as n, requiredUnlessDefaultFor as o, defaultsFieldName as r, DEFAULT_COMPONENT_DEFAULTS_TYPE as t };
76
+
77
+ //# sourceMappingURL=componentDefaults-YFpAqFb4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"componentDefaults-YFpAqFb4.js","names":[],"sources":["../src/schema/componentDefaults.ts"],"sourcesContent":["import {defineField, defineType, type Rule} from 'sanity'\n\n/**\n * VALEURS PAR DÉFAUT DES COMPOSANTS, côté Studio.\n *\n * Un document (un par langue) avec un bloc par composant de la bibliothèque,\n * GÉNÉRÉ depuis les schémas des sections : une section ajoutée y apparaît sans\n * rien faire. Une instance dont un champ est vide affiche la valeur par défaut ;\n * un champ rempli (override) n'est jamais écrasé. Côté site :\n * `@nocode-factory/sanity-kit/web/defaults`. Dans le Studio, l'onglet Composants\n * ouvre chaque composant (rendu réel + réglages), et une pastille bleue marque\n * chaque champ d'instance qui diffère de la valeur par défaut.\n *\n * Deux règles pour les champs de section, qui en découlent :\n * - jamais d'`initialValue` (ce serait un override involontaire) ;\n * - « obligatoire » = `requiredUnlessDefault`.\n */\n\ntype FieldDef = {name: string; type: string; validation?: unknown; initialValue?: unknown; fields?: FieldDef[]; of?: FieldDef[]; [k: string]: unknown}\ntype SectionDef = {name: string; title?: string; fields: FieldDef[]}\n\nexport const DEFAULT_COMPONENT_DEFAULTS_TYPE = 'componentDefaults'\n\n/** Nom du champ d'un composant dans le document des valeurs par défaut : `section.cta` -> `cta`. */\nexport function defaultsFieldName(type: string, namespace = 'section.'): string {\n return type.startsWith(namespace) ? type.slice(namespace.length) : type\n}\n\n// Dans les valeurs par défaut, rien n'est obligatoire et rien n'est prérempli.\nconst relax = (f: FieldDef): FieldDef => {\n const {validation: _v, initialValue: _i, ...rest} = f\n return {\n ...rest,\n ...(rest.fields ? {fields: rest.fields.map(relax)} : {}),\n ...(rest.of ? {of: rest.of.map(relax)} : {}),\n }\n}\n\n/** Document « Composants : valeurs par défaut », généré depuis les sections. */\nexport function defineComponentDefaults(options: {sections: readonly unknown[]; name?: string; title?: string; namespace?: string}) {\n const {name = DEFAULT_COMPONENT_DEFAULTS_TYPE, title = '🧩 Composants : valeurs par défaut', namespace = 'section.'} = options\n return defineType({\n name,\n title,\n type: 'document',\n description:\n 'Valeurs appliquées à chaque instance d\\'un composant dont le champ est vide. Un champ rempli dans une instance reste prioritaire (override).',\n fields: (options.sections as SectionDef[]).map((t) =>\n defineField({\n name: defaultsFieldName(t.name, namespace),\n title: t.title || t.name,\n type: 'object',\n description: 'Valeurs par défaut de ce composant. Vide = valeur du design system.',\n options: {collapsible: true, collapsed: true},\n fields: t.fields.map(relax) as never,\n }),\n ),\n preview: {prepare: () => ({title: title.replace(/^\\S+\\s/, '')})},\n })\n}\n\nconst isEmpty = (v: unknown) => v === undefined || v === null || v === '' || (Array.isArray(v) && v.length === 0)\n\n/**\n * Règle « obligatoire SAUF si le composant a une valeur par défaut » pour un autre\n * type de document des valeurs par défaut ou un autre espace de noms.\n * `validation: requiredUnlessDefaultFor({type: 'mesDefauts'})`\n */\nexport function requiredUnlessDefaultFor(options: {type?: string; namespace?: string} = {}) {\n const {type: defaultsType = DEFAULT_COMPONENT_DEFAULTS_TYPE, namespace = 'section.'} = options\n return <R>(rule: R): R =>\n (rule as unknown as Rule).custom(async (value, context) => {\n if (!isEmpty(value)) return true\n const type = (context.parent as {_type?: string} | undefined)?._type\n const field = context.path?.[context.path.length - 1]\n const name = type ? defaultsFieldName(type, namespace) : ''\n if (!type?.startsWith(namespace) || typeof field !== 'string' || !/^\\w+$/.test(name) || !/^\\w+$/.test(field)) return 'Obligatoire.'\n const language = (context.document as {language?: string} | undefined)?.language ?? null\n const inherited = await context\n .getClient({apiVersion: '2024-10-01'})\n .fetch(\n `*[_type == $defaultsType && !(_id in path(\"drafts.**\")) && ($language == null || language == $language)][0].${name}.${field}`,\n {defaultsType, language},\n )\n return isEmpty(inherited) ? 'Obligatoire (ou à définir dans Composants > valeurs par défaut).' : true\n }) as unknown as R\n}\n\n/**\n * Champ de section obligatoire, SAUF si le composant a une valeur par défaut\n * pour ce champ (elle s'affichera). Tout type de champ.\n * `validation: requiredUnlessDefault`\n */\nexport const requiredUnlessDefault: <R>(rule: R) => R = requiredUnlessDefaultFor()\n\n/**\n * Presentation : la page qui rend un composant seul (par défaut\n * `/design-system/composant`) a pour document principal les valeurs par défaut.\n * Rendu réel et réglages côte à côte, en direct.\n * `presentationTool({resolve: {mainDocuments: defineDocuments([componentDefaultsMainDocument({language: 'fr'})])}})`\n */\nexport function componentDefaultsMainDocument(options: {language?: string; route?: string; type?: string} = {}): {route: string; filter: string} {\n const {language, route = '/design-system/composant', type = DEFAULT_COMPONENT_DEFAULTS_TYPE} = options\n const safeLang = language && /^[a-z]{2}(-[A-Za-z]{2})?$/.test(language) ? language : null\n return {route, filter: `_type == \"${type}\"${safeLang ? ` && language == \"${safeLang}\"` : ''}`}\n}\n"],"mappings":";AAqBA,MAAa,kCAAkC;;AAG/C,SAAgB,kBAAkB,MAAc,YAAY,YAAoB;CAC9E,OAAO,KAAK,WAAW,SAAS,IAAI,KAAK,MAAM,UAAU,MAAM,IAAI;AACrE;AAGA,MAAM,SAAS,MAA0B;CACvC,IAAM,EAAC,YAAY,IAAI,cAAc,IAAI,GAAG,SAAQ;CACpD,OAAO;EACL,GAAG;EACH,GAAI,KAAK,SAAS,EAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,EAAC,IAAI,CAAC;EACtD,GAAI,KAAK,KAAK,EAAC,IAAI,KAAK,GAAG,IAAI,KAAK,EAAC,IAAI,CAAC;CAC5C;AACF;;AAGA,SAAgB,wBAAwB,SAA4F;CAClI,IAAM,EAAC,OAAO,iCAAiC,QAAQ,sCAAsC,YAAY,eAAc;CACvH,OAAO,WAAW;EAChB;EACA;EACA,MAAM;EACN,aACE;EACF,QAAS,QAAQ,SAA0B,KAAK,MAC9C,YAAY;GACV,MAAM,kBAAkB,EAAE,MAAM,SAAS;GACzC,OAAO,EAAE,SAAS,EAAE;GACpB,MAAM;GACN,aAAa;GACb,SAAS;IAAC,aAAa;IAAM,WAAW;GAAI;GAC5C,QAAQ,EAAE,OAAO,IAAI,KAAK;EAC5B,CAAC,CACH;EACA,SAAS,EAAC,gBAAgB,EAAC,OAAO,MAAM,QAAQ,UAAU,EAAE,EAAC,GAAE;CACjE,CAAC;AACH;AAEA,MAAM,WAAW,MAAe,KAAyB,QAAQ,MAAM,MAAO,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW;;;;;;AAO/G,SAAgB,yBAAyB,UAA+C,CAAC,GAAG;CAC1F,IAAM,EAAC,MAAM,eAAe,iCAAiC,YAAY,eAAc;CACvF,QAAW,SACR,KAAyB,OAAO,OAAO,OAAO,YAAY;EACzD,IAAI,CAAC,QAAQ,KAAK,GAAG,OAAO;EAC5B,IAAM,OAAQ,QAAQ,QAAyC,OACzD,QAAQ,QAAQ,OAAO,QAAQ,KAAK,SAAS,IAC7C,OAAO,OAAO,kBAAkB,MAAM,SAAS,IAAI;EACzD,IAAI,CAAC,MAAM,WAAW,SAAS,KAAK,OAAO,SAAU,YAAY,CAAC,QAAQ,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,GAAG,OAAO;EACrH,IAAM,WAAY,QAAQ,UAA8C,YAAY,MAC9E,YAAY,MAAM,QACrB,UAAU,EAAC,YAAY,aAAY,CAAC,CAAC,CACrC,MACC,+GAA+G,KAAK,GAAG,SACvH;GAAC;GAAc;EAAQ,CACzB;EACF,OAAO,SAAQ,SAAS,KAAI;CAC9B,CAAC;AACL;;;;;;AAOA,MAAa,wBAA2C,yBAAyB;;;;;;;AAQjF,SAAgB,8BAA8B,UAA8D,CAAC,GAAoC;CAC/I,IAAM,EAAC,UAAU,QAAQ,4BAA4B,OAAO,oCAAmC,SACzF,WAAW,YAAY,4BAA4B,KAAK,QAAQ,IAAI,WAAW;CACrF,OAAO;EAAC;EAAO,QAAQ,aAAa,KAAK,GAAG,WAAW,oBAAoB,SAAS,KAAK;CAAI;AAC/F"}
package/dist/index.d.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { a as requiredUnlessDefault, i as defineComponentDefaults, n as componentDefaultsMainDocument, o as requiredUnlessDefaultFor, r as defaultsFieldName, t as DEFAULT_COMPONENT_DEFAULTS_TYPE } from "./componentDefaults-CbOXLaYE.js";
1
2
  import { SanityClient, Schema, Tool, ToolMenuProps } from "sanity";
2
3
  import { ReactNode } from "react";
3
4
  import { PreviewHeaderProps } from "sanity/presentation";
@@ -1291,7 +1292,7 @@ export declare function ActorName(props: {
1291
1292
  * Version du kit, rapportée au service pour savoir quels projets tournent sur
1292
1293
  * quelle version. Tenue à jour avec `package.json`.
1293
1294
  */
1294
- export declare const KIT_VERSION = "2.8.2";
1295
+ export declare const KIT_VERSION = "2.9.0";
1295
1296
  /**
1296
1297
  * Données de la page proposées comme colonnes.
1297
1298
  *
@@ -1761,5 +1762,5 @@ export declare const NCF_COMPONENTS_TOOL = "ncf-components";
1761
1762
  export declare const NCF_HISTORY_TOOL = "ncf-history";
1762
1763
  export declare const NCF_TOOL_NAMES: readonly ["ncf-pages", "ncf-components", "ncf-history"];
1763
1764
  export declare const ncfKit: import("sanity").Plugin<NcfKitConfig>;
1764
- export { type AddColumnInput, type Annotation, type AnnotationsState, type BlockOccurrence, type BlockTypeInfo, type BoardEdge, type BoardGraph, type BoardLayoutState, type BoardNode, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, type Change, type ChangeKind, type CollectedLinks, type ColorBy, type ColorOptions, type ConfigIssue, type DeriveOptions, type GroupBy, type GroupOptions, type HistoryDetail, type HistoryEvent, type IssueLevel, type KitContextValue, type KitUpdate, type LayoutMode, type MergedDoc, type NcfBoardTag, 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 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 ResolvedComponentPreview, type ResolvedDocumentColumn, type ResolvedHistory, type ResolvedI18n, type ResolvedKitConfig, type ResolvedPageType, type RowColor, type RowGroup, type SchemaFieldLike, type SchemaTypeLike, type SectionLayout, type SectionMapNode, type SectionOrder, type SectionsMapOptions, type Segment, type SiteRoutesRegistry, type SortDirection, type SortKey, type ThumbnailInput, type VersionedDoc };
1765
+ export { type AddColumnInput, type Annotation, type AnnotationsState, type BlockOccurrence, type BlockTypeInfo, type BoardEdge, type BoardGraph, type BoardLayoutState, type BoardNode, CONTENT_SCAN_LIMIT as OCCURRENCE_SCAN_LIMIT, type Change, type ChangeKind, type CollectedLinks, type ColorBy, type ColorOptions, type ConfigIssue, DEFAULT_COMPONENT_DEFAULTS_TYPE, type DeriveOptions, type GroupBy, type GroupOptions, type HistoryDetail, type HistoryEvent, type IssueLevel, type KitContextValue, type KitUpdate, type LayoutMode, type MergedDoc, type NcfBoardTag, 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 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 ResolvedComponentPreview, type ResolvedDocumentColumn, type ResolvedHistory, type ResolvedI18n, type ResolvedKitConfig, type ResolvedPageType, type RowColor, type RowGroup, type SchemaFieldLike, type SchemaTypeLike, type SectionLayout, type SectionMapNode, type SectionOrder, type SectionsMapOptions, type Segment, type SiteRoutesRegistry, type SortDirection, type SortKey, type ThumbnailInput, type VersionedDoc, componentDefaultsMainDocument, defaultsFieldName, defineComponentDefaults, requiredUnlessDefault, requiredUnlessDefaultFor };
1765
1766
  //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -1,4 +1,5 @@
1
- import { defineField, definePlugin, defineType, pathToString, set, useClient, useCurrentUser, useFormValue, useSchema, useUser } from "sanity";
1
+ import { a as requiredUnlessDefault, i as defineComponentDefaults, n as componentDefaultsMainDocument, o as requiredUnlessDefaultFor, r as defaultsFieldName, t as DEFAULT_COMPONENT_DEFAULTS_TYPE } from "./componentDefaults-YFpAqFb4.js";
2
+ import { defineField, definePlugin, defineType, pathToString, set, unset, useClient, useCurrentUser, useFormValue, useSchema, useUser } from "sanity";
2
3
  import { ClockIcon } from "@sanity/icons/Clock";
3
4
  import { ComponentIcon } from "@sanity/icons/Component";
4
5
  import { DocumentsIcon } from "@sanity/icons/Documents";
@@ -1305,7 +1306,7 @@ function explainGrantError(error) {
1305
1306
  * Version du kit, rapportée au service pour savoir quels projets tournent sur
1306
1307
  * quelle version. Tenue à jour avec `package.json`.
1307
1308
  */
1308
- const KIT_VERSION = "2.8.2";
1309
+ const KIT_VERSION = "2.9.0";
1309
1310
  /**
1310
1311
  * Signale ce Studio au service du kit, une fois par montage.
1311
1312
  *
@@ -1616,7 +1617,7 @@ function useKitUpdate() {
1616
1617
  !controller.signal.aborted && body?.version && setLatest(body.version);
1617
1618
  }).catch(() => {}), () => controller.abort();
1618
1619
  }, []);
1619
- let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.8.2") > 0);
1620
+ let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.9.0") > 0);
1620
1621
  return {
1621
1622
  current: KIT_VERSION,
1622
1623
  latest,
@@ -7269,16 +7270,18 @@ function describeValue(value) {
7269
7270
  return "une valeur";
7270
7271
  }
7271
7272
  /**
7272
- * Ce que fait « Réinitialiser » : appliquer la valeur par défaut du composant
7273
- * dans le champ (jamais le vider : un champ vidé sans valeur par défaut ferait
7274
- * disparaître le contenu de la page). Sans valeur par défaut : rien à appliquer,
7275
- * la pastille renvoie au réglage du composant.
7273
+ * Ce que fait « Réinitialiser » : remettre le champ en HÉRITAGE (le vider en
7274
+ * base). Il suit alors la valeur par défaut du composant, aujourd'hui comme
7275
+ * après ses changements (une copie serait figée). Le champ affiche la valeur
7276
+ * héritée (grisée). Sans valeur par défaut, rien à hériter : le champ resterait
7277
+ * vide, la pastille renvoie donc au réglage du composant.
7276
7278
  */
7277
7279
  function resetAction(inherited) {
7278
- return isEmptyValue(inherited) ? { kind: "noDefault" } : {
7279
- kind: "apply",
7280
- value: structuredClone(inherited)
7281
- };
7280
+ return isEmptyValue(inherited) ? { kind: "noDefault" } : { kind: "inherit" };
7281
+ }
7282
+ /** Texte grisé d'un champ texte vide qui hérite de la valeur par défaut. */
7283
+ function inheritedPlaceholder(value) {
7284
+ return typeof value == "string" && value.trim() ? value : typeof value == "number" ? String(value) : null;
7282
7285
  }
7283
7286
  /** Libellé court de la valeur par défaut, pour la pastille au survol. */
7284
7287
  function shortValue(value, max = 32) {
@@ -7289,8 +7292,9 @@ function shortValue(value, max = 32) {
7289
7292
  * Pastille bleue sur tout champ d'une instance de composant dont la valeur
7290
7293
  * DIFFÈRE de la valeur par défaut du composant (valeur par défaut vide comprise),
7291
7294
  * éléments de liste compris (comparés à l'élément de même rang). Au survol, elle
7292
- * affiche la valeur par défaut ; au clic, elle l'APPLIQUE dans le champ (jamais
7293
- * un champ vide ; sans valeur par défaut, elle ouvre le réglage du composant). Les champs
7295
+ * affiche la valeur par défaut ; au clic, le champ revient en HÉRITAGE et suit la
7296
+ * valeur par défaut, même quand elle change (sans valeur par défaut, elle ouvre
7297
+ * le réglage du composant). Un champ vide affiche la valeur héritée. Les champs
7294
7298
  * « simples » la portent (texte, nombre, choix, case, liste, image, référence,
7295
7299
  * couleur...) ; un objet composé (lien) la porte sur ses sous-champs.
7296
7300
  */
@@ -7310,8 +7314,25 @@ function createOverrideInput(config) {
7310
7314
  }
7311
7315
  function WithDot(props) {
7312
7316
  let { rel, inList, shortName, parent, ...inputProps } = props, client = useKitClient(), languageField = config.i18n?.field ?? "language", language = useFormValue([languageField]) ?? null, inherited = defaultValueAt(useComponentDefaults(client, defaultsType, languageField, language), shortName, rel), field = rel[rel.length - 1] ?? "", router = useRouter();
7317
+ if (isEmptyValue(inputProps.value) && !isEmptyValue(inherited)) {
7318
+ let st = inputProps.schemaType, placeholder = (st.jsonType === "string" || st.jsonType === "number") && !st.options?.list?.length ? inheritedPlaceholder(inherited) : null, withPlaceholder = placeholder === null ? inputProps : {
7319
+ ...inputProps,
7320
+ elementProps: {
7321
+ ...inputProps.elementProps,
7322
+ placeholder
7323
+ }
7324
+ };
7325
+ return /* @__PURE__ */ jsxs(Stack, {
7326
+ gap: 2,
7327
+ children: [inputProps.renderDefault(withPlaceholder), placeholder === null && /* @__PURE__ */ jsxs(Text, {
7328
+ size: 0,
7329
+ muted: !0,
7330
+ children: ["Valeur par défaut du composant : ", describeValue(inherited)]
7331
+ })]
7332
+ });
7333
+ }
7313
7334
  if (!isOverride(inputProps.value, inherited, field, parent)) return inputProps.renderDefault(inputProps);
7314
- let action = resetAction(inherited), onClick = action.kind === "apply" ? () => inputProps.onChange(set(action.value)) : () => router.navigateIntent("edit", componentIntentParams(`${namespace}${shortName}`, namespace, config.componentPreview, defaultsType));
7335
+ let action = resetAction(inherited), onClick = action.kind === "noDefault" ? () => router.navigateIntent("edit", componentIntentParams(`${namespace}${shortName}`, namespace, config.componentPreview, defaultsType)) : inList ? () => inputProps.onChange(set(structuredClone(inherited))) : () => inputProps.onChange(unset());
7315
7336
  return /* @__PURE__ */ jsxs(Flex, {
7316
7337
  align: "flex-start",
7317
7338
  gap: 2,
@@ -7320,7 +7341,7 @@ function createOverrideInput(config) {
7320
7341
  style: { minWidth: 0 },
7321
7342
  children: inputProps.renderDefault(inputProps)
7322
7343
  }), /* @__PURE__ */ jsx(OverrideDot, {
7323
- hasDefault: action.kind === "apply",
7344
+ hasDefault: action.kind !== "noDefault",
7324
7345
  full: describeValue(inherited),
7325
7346
  short: shortValue(inherited),
7326
7347
  onClick
@@ -7348,7 +7369,7 @@ function OverrideDot(props) {
7348
7369
  style: { maxWidth: 280 },
7349
7370
  children: /* @__PURE__ */ jsx(Text, {
7350
7371
  size: 1,
7351
- children: props.hasDefault ? `Différent de la valeur par défaut du composant. Cliquer pour appliquer la valeur par défaut : ${props.full}.` : "Ce composant n'a pas de valeur par défaut pour ce champ. Cliquer pour la définir (Composants : valeurs par défaut)."
7372
+ children: props.hasDefault ? `Différent de la valeur par défaut du composant (${props.full}). Cliquer pour revenir à la valeur par défaut : le champ la suivra, même si elle change.` : "Ce composant n'a pas de valeur par défaut pour ce champ. Cliquer pour la définir (Composants : valeurs par défaut)."
7352
7373
  })
7353
7374
  }),
7354
7375
  children: /* @__PURE__ */ jsx("button", {
@@ -7358,7 +7379,7 @@ function OverrideDot(props) {
7358
7379
  onMouseLeave: () => setHover(!1),
7359
7380
  onFocus: () => setHover(!0),
7360
7381
  onBlur: () => setHover(!1),
7361
- "aria-label": props.hasDefault ? `Appliquer la valeur par défaut du composant : ${props.full}` : "Définir la valeur par défaut du composant",
7382
+ "aria-label": props.hasDefault ? `Revenir à la valeur par défaut du composant : ${props.full}` : "Définir la valeur par défaut du composant",
7362
7383
  style: {
7363
7384
  marginTop: 9,
7364
7385
  flex: "none",
@@ -7622,6 +7643,6 @@ const NCF_PAGES_TOOL = "ncf-pages", NCF_COMPONENTS_TOOL = "ncf-components", NCF_
7622
7643
  form: { components: { input: createOverrideInput(config) } }
7623
7644
  };
7624
7645
  });
7625
- export { ANNOTATION_TYPE, ActorName, 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, DATA_PREFIX, DEFAULT_BOARD_TAGS, DEFAULT_COMPONENT_PREVIEW, DEFAULT_I18N, DEFAULT_INTERNAL_FIELDS, DEFAULT_MORE_TOOLS, DEFAULT_PAGE_BUILDER_FIELD, DEFAULT_SLUG_FIELD, DEFAULT_TITLE_FIELD, KIT_API_VERSION, KIT_VERSION, NCF_COMPONENTS_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, addColumn, addColumnOption, announce, applySavedPositions, baseId, blockName, blockTypesFromSchema, buildContentsQuery, buildLinkGraph, buildPageRows, buildPagesQuery, collectLinks, collectOccurrences, colorForRow, colorFromString, columnId, compareVersions, createPreviewLauncher, customEnvironment, defaultNodeSize, depth, deriveDocumentColumns, diffDocuments, diffWords, editIntentPath, explainGrantError, fallbackLayout, fetchDetail, fetchTimeline, fillTemplate, filterRows, flatten, formatDocumentValue, groupPageRows, groupValue, hasBlockingIssue, humanizeBlockName, isDraftId, isKitType, isPrerelease, isSafeColumnKey, isSafeFieldPath, isTextChange, isVersionId, issuesForTool, keyForPath, kitSchemaTypes, layoutGraph, layoutSectionsMap, localesInRows, mergeVersions, missingPageTypes, moveColumn, ncfAllowedOrigins, ncfKit, ncfPreviewComponents, normalizeInternalPath, normalizePath, occurrencesForTypes, pageThumbnailUrl, pageTypeFor, pageTypesFromSiteRoutes, pageTypesWithoutBuilder, parentPath, presentationPath, pruneSavedPositions, releaseId, removeColumn, renameColumn, requestPreviewGrant, resolveColorBy, resolveConfig, segments, slugKey, sortRows, summarize, toKebabCase, toPath, toUrl, topLevelBlockCount, uniqueColumnId, upsertLayout, urlOn, useAnnotations, useBoardLayout, useDocumentColumns, useHistory, useInternalColumns, useKitClient, useKitConfig, useKitContext, useKitUpdate, useOccurrences, usePageContents, usePages, usePreviewTarget, useRegistration, validateConfig, withAlpha, withMoreTool };
7646
+ export { ANNOTATION_TYPE, ActorName, 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, 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, KIT_API_VERSION, KIT_VERSION, NCF_COMPONENTS_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, addColumn, addColumnOption, announce, applySavedPositions, baseId, blockName, blockTypesFromSchema, buildContentsQuery, buildLinkGraph, buildPageRows, buildPagesQuery, collectLinks, collectOccurrences, colorForRow, colorFromString, columnId, compareVersions, componentDefaultsMainDocument, createPreviewLauncher, customEnvironment, defaultNodeSize, defaultsFieldName, defineComponentDefaults, depth, deriveDocumentColumns, diffDocuments, diffWords, editIntentPath, explainGrantError, fallbackLayout, fetchDetail, fetchTimeline, fillTemplate, filterRows, flatten, formatDocumentValue, groupPageRows, groupValue, hasBlockingIssue, humanizeBlockName, isDraftId, isKitType, isPrerelease, isSafeColumnKey, isSafeFieldPath, isTextChange, isVersionId, issuesForTool, keyForPath, kitSchemaTypes, layoutGraph, layoutSectionsMap, localesInRows, mergeVersions, missingPageTypes, moveColumn, ncfAllowedOrigins, ncfKit, ncfPreviewComponents, normalizeInternalPath, normalizePath, occurrencesForTypes, pageThumbnailUrl, pageTypeFor, pageTypesFromSiteRoutes, pageTypesWithoutBuilder, parentPath, presentationPath, pruneSavedPositions, releaseId, removeColumn, renameColumn, requestPreviewGrant, requiredUnlessDefault, requiredUnlessDefaultFor, resolveColorBy, resolveConfig, segments, slugKey, sortRows, summarize, toKebabCase, toPath, toUrl, topLevelBlockCount, uniqueColumnId, upsertLayout, urlOn, useAnnotations, useBoardLayout, useDocumentColumns, useHistory, useInternalColumns, useKitClient, useKitConfig, useKitContext, useKitUpdate, useOccurrences, usePageContents, usePages, usePreviewTarget, useRegistration, validateConfig, withAlpha, withMoreTool };
7626
7647
 
7627
7648
  //# sourceMappingURL=index.js.map