@nocode-factory/sanity-kit 2.8.3 → 2.9.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/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,41 @@ 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 instance** : le bouton « Modifier l'instance principale »
58
+ ouvre les valeurs par défaut du composant (rendu réel + réglages).
59
+ - **Formulaire d'une page** : une pastille bleue marque tout champ d'instance
60
+ différent de la valeur par défaut. Au survol, elle affiche la valeur par défaut ;
61
+ au clic, le champ revient en héritage. Un champ qui hérite affiche la valeur par
62
+ défaut (grisée, ou en mention sous les choix).
63
+ - **Preview** : un clic sur un texte hérité ouvre le champ de l'instance.
64
+
65
+ 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`).
66
+
67
+ | API | Où | Rôle |
68
+ |---|---|---|
69
+ | `defineComponentDefaults({sections})` | `@nocode-factory/sanity-kit/schema` | type du document des valeurs par défaut |
70
+ | `requiredUnlessDefault` | `@nocode-factory/sanity-kit/schema` | obligatoire sauf valeur par défaut |
71
+ | `componentDefaultsMainDocument({language})` | `@nocode-factory/sanity-kit/schema` | Presentation : page de rendu = valeurs par défaut |
72
+ | `applyDefaults`, `inherit` | `@nocode-factory/sanity-kit/web/defaults` | héritage côté site |
73
+ | `componentDefaultsQuery` | `@nocode-factory/sanity-kit/web/defaults` | requête des valeurs par défaut |
74
+ | `stegaFilter`, `isOptionValue` | `@nocode-factory/sanity-kit/web/defaults` | preview : options jamais encodées |
75
+ | `reattributeTo(source, key)` | `@nocode-factory/sanity-kit/web/defaults` | preview : texte hérité cliquable vers l'instance |
76
+
77
+ `npx ncf-kit doctor` vérifie chaque branchement.
78
+
39
79
  ## Documentation
40
80
 
41
81
  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.3";
1295
+ export declare const KIT_VERSION = "2.9.1";
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,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-YFpAqFb4.js";
1
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";
@@ -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.3";
1309
+ const KIT_VERSION = "2.9.1";
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.3") > 0);
1620
+ let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.9.1") > 0);
1620
1621
  return {
1621
1622
  current: KIT_VERSION,
1622
1623
  latest,
@@ -5667,25 +5668,34 @@ function componentIntentParams(type, namespace, preview, documentId) {
5667
5668
  }
5668
5669
  /**
5669
5670
  * Ouvre un composant : Presentation avec son rendu réel et ses valeurs par
5670
- * défaut côte à côte. Sans document de valeurs par défaut dans le schéma : la
5671
- * démo du design system dans un nouvel onglet. `null` : rien à ouvrir.
5672
- * Partagé par la grille et la vue Map de l'onglet Composants.
5671
+ * défaut côte à côte (le document des valeurs par défaut, champ du composant).
5672
+ * Sans document de valeurs par défaut dans le schéma : la démo du design system
5673
+ * dans un nouvel onglet. Partagé par l'onglet Composants (grille, Map) et le
5674
+ * bouton « Modifier l'instance principale » des formulaires.
5673
5675
  */
5676
+ async function openComponentDefaults(options) {
5677
+ let { type, config, hasDefaults, client, navigateIntent } = options, preview = config.componentPreview;
5678
+ if (!hasDefaults) {
5679
+ config.previewUrl && window.open(`${config.previewUrl}${preview.path}#${fillTemplate(preview.anchor, type, config.blockNamespace)}`, "_blank", "noopener");
5680
+ return;
5681
+ }
5682
+ let lang = config.i18n?.defaultLocale ?? null, id = await client.fetch(`*[_type == $type] | order(select($lang != null && ${config.i18n?.field ?? "language"} == $lang => 0, 1))[0]._id`, {
5683
+ type: preview.defaultsType,
5684
+ lang
5685
+ }).catch(() => null);
5686
+ navigateIntent("edit", componentIntentParams(type, config.blockNamespace, preview, id ?? preview.defaultsType));
5687
+ }
5688
+ /** Ouvre un composant (voir openComponentDefaults). `null` : rien à ouvrir. */
5674
5689
  function useOpenComponent() {
5675
- let config = useKitConfig(), schema = useSchema(), router = useRouter(), client = useKitClient(), preview = config.componentPreview, hasDefaults = !!schema.get(preview.defaultsType), open = useCallback(async (type) => {
5676
- if (!hasDefaults) {
5677
- config.previewUrl && window.open(`${config.previewUrl}${preview.path}#${fillTemplate(preview.anchor, type, config.blockNamespace)}`, "_blank", "noopener");
5678
- return;
5679
- }
5680
- let lang = config.i18n?.defaultLocale ?? null, id = await client.fetch(`*[_type == $type] | order(select($lang != null && ${config.i18n?.field ?? "language"} == $lang => 0, 1))[0]._id`, {
5681
- type: preview.defaultsType,
5682
- lang
5683
- }).catch(() => null);
5684
- router.navigateIntent("edit", componentIntentParams(type, config.blockNamespace, preview, id ?? preview.defaultsType));
5685
- }, [
5690
+ let config = useKitConfig(), schema = useSchema(), router = useRouter(), client = useKitClient(), preview = config.componentPreview, hasDefaults = !!schema.get(preview.defaultsType), open = useCallback((type) => openComponentDefaults({
5691
+ type,
5692
+ config,
5693
+ hasDefaults,
5694
+ client,
5695
+ navigateIntent: (i, p) => router.navigateIntent(i, p)
5696
+ }), [
5686
5697
  hasDefaults,
5687
5698
  config,
5688
- preview,
5689
5699
  client,
5690
5700
  router
5691
5701
  ]);
@@ -7300,7 +7310,11 @@ function shortValue(value, max = 32) {
7300
7310
  function createOverrideInput(config) {
7301
7311
  let { defaultsType } = config.componentPreview, namespace = config.blockNamespace;
7302
7312
  function OverrideInput(props) {
7303
- let schema = useSchema(), path = props.path, keyed = firstKeyedIndex(path), anchor = keyed >= 0 ? keyed : 0, instance = useFormValue(path.slice(0, anchor + 1)), parent = useFormValue(path.length > 1 ? path.slice(0, -1) : path), resolved = resolveFieldPath(path, anchor, instance, namespace);
7313
+ let schema = useSchema(), path = props.path, keyed = firstKeyedIndex(path), anchor = keyed >= 0 ? keyed : 0, instance = useFormValue(path.slice(0, anchor + 1)), parent = useFormValue(path.length > 1 ? path.slice(0, -1) : path), resolved = resolveFieldPath(path, anchor, instance, namespace), own = props.value;
7314
+ if (props.schemaType.jsonType === "object" && typeof own?._type == "string" && own._type.startsWith(namespace) && props.path.length > 0 && schema.get(defaultsType)) return /* @__PURE__ */ jsx(WithMainInstance, {
7315
+ ...props,
7316
+ type: own._type
7317
+ });
7304
7318
  if (!resolved || !schema.get(defaultsType) || !carriesDot(props.schemaType)) return props.renderDefault(props);
7305
7319
  let shortName = blockName(instance._type, namespace);
7306
7320
  return /* @__PURE__ */ jsx(WithDot, {
@@ -7347,6 +7361,30 @@ function createOverrideInput(config) {
7347
7361
  })]
7348
7362
  });
7349
7363
  }
7364
+ function WithMainInstance(props) {
7365
+ let { type, ...inputProps } = props, client = useKitClient(), router = useRouter(), open = () => void openComponentDefaults({
7366
+ type,
7367
+ config,
7368
+ hasDefaults: !0,
7369
+ client,
7370
+ navigateIntent: (i, p) => router.navigateIntent(i, p)
7371
+ });
7372
+ return /* @__PURE__ */ jsxs(Stack, {
7373
+ gap: 3,
7374
+ children: [/* @__PURE__ */ jsx(Flex, {
7375
+ justify: "flex-end",
7376
+ children: /* @__PURE__ */ jsx(Button, {
7377
+ mode: "ghost",
7378
+ tone: "primary",
7379
+ fontSize: 1,
7380
+ padding: 2,
7381
+ text: "Modifier l'instance principale",
7382
+ title: "Valeurs par défaut du composant : elles s'appliquent à toutes ses instances dont le champ est vide",
7383
+ onClick: open
7384
+ })
7385
+ }), inputProps.renderDefault(inputProps)]
7386
+ });
7387
+ }
7350
7388
  return OverrideInput;
7351
7389
  }
7352
7390
  function carriesDot(schemaType) {
@@ -7642,6 +7680,6 @@ const NCF_PAGES_TOOL = "ncf-pages", NCF_COMPONENTS_TOOL = "ncf-components", NCF_
7642
7680
  form: { components: { input: createOverrideInput(config) } }
7643
7681
  };
7644
7682
  });
7645
- 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 };
7683
+ 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 };
7646
7684
 
7647
7685
  //# sourceMappingURL=index.js.map