@nocode-factory/sanity-kit 2.8.0 → 2.8.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nocode-factory/sanity-kit",
3
- "version": "2.8.0",
3
+ "version": "2.8.2",
4
4
  "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -1,9 +1,10 @@
1
1
  import {useState, type ComponentType} from 'react'
2
- import {unset, useFormValue, useSchema, type InputProps} from 'sanity'
2
+ import {set, useFormValue, useSchema, type InputProps} from 'sanity'
3
+ import {useRouter} from 'sanity/router'
3
4
  import {Box, Flex, Text} from '@sanity/ui'
4
5
  import {Tooltip} from '@sanity/ui/tooltip'
5
6
  import type {ResolvedKitConfig} from '../config/types'
6
- import {blockName} from '../lib/blocks'
7
+ import {blockName, componentIntentParams} from '../lib/blocks'
7
8
  import {useKitClient} from '../hooks/useKitClient'
8
9
  import {useComponentDefaults} from '../hooks/useComponentDefaults'
9
10
  import {
@@ -11,18 +12,20 @@ import {
11
12
  describeValue,
12
13
  firstKeyedIndex,
13
14
  isOverride,
14
- relativeFieldPath,
15
- sameValue,
15
+ resetAction,
16
+ resolveFieldPath,
17
+ shortValue,
16
18
  type PathSegment,
17
19
  } from '../lib/overrides'
18
20
 
19
21
  /**
20
- * Pastille bleue sur un champ d'une instance de composant qui a sa PROPRE valeur
21
- * alors que le composant en a une par défaut (override). Au survol, elle devient
22
- * « Réinitialiser » : le champ est vidé et reprend la valeur par défaut du
23
- * composant. Seuls les champs « simples » en portent une (texte, nombre, choix,
24
- * case, liste, image, couleur...) ; un objet composé (lien) les porte sur ses
25
- * sous-champs.
22
+ * Pastille bleue sur tout champ d'une instance de composant dont la valeur
23
+ * DIFFÈRE de la valeur par défaut du composant (valeur par défaut vide comprise),
24
+ * éléments de liste compris (comparés à l'élément de même rang). Au survol, elle
25
+ * affiche la valeur par défaut ; au clic, elle l'APPLIQUE dans le champ (jamais
26
+ * un champ vide ; sans valeur par défaut, elle ouvre le réglage du composant). Les champs
27
+ * « simples » la portent (texte, nombre, choix, case, liste, image, référence,
28
+ * couleur...) ; un objet composé (lien) la porte sur ses sous-champs.
26
29
  */
27
30
  export function createOverrideInput(config: ResolvedKitConfig): ComponentType<InputProps> {
28
31
  const {defaultsType} = config.componentPreview
@@ -31,20 +34,22 @@ export function createOverrideInput(config: ResolvedKitConfig): ComponentType<In
31
34
  function OverrideInput(props: InputProps) {
32
35
  const schema = useSchema()
33
36
  const path = props.path as PathSegment[]
34
- const index = firstKeyedIndex(path)
35
- // Une seule lecture de valeur : l'instance de composant (premier élément de
36
- // liste du chemin) ; à défaut, la valeur du champ lui-même (bon marché).
37
- const instance = useFormValue(index >= 0 ? (path.slice(0, index + 1) as never) : (path as never))
37
+ // L'instance de composant : le premier élément de liste du chemin (page
38
+ // builder, corps d'article) ou, sinon, le champ de premier niveau (composant
39
+ // posé seul, ex. le CTA de fin d'article des Réglages).
40
+ const keyed = firstKeyedIndex(path)
41
+ const anchor = keyed >= 0 ? keyed : 0
42
+ const instance = useFormValue(path.slice(0, anchor + 1) as never)
38
43
  const parent = useFormValue((path.length > 1 ? path.slice(0, -1) : path) as never)
39
- const rel = index >= 0 ? relativeFieldPath(path, index, instance, namespace) : null
44
+ const resolved = resolveFieldPath(path, anchor, instance, namespace)
40
45
 
41
- if (!rel || !schema.get(defaultsType) || !carriesDot(props.schemaType)) return props.renderDefault(props)
46
+ if (!resolved || !schema.get(defaultsType) || !carriesDot(props.schemaType)) return props.renderDefault(props)
42
47
  const shortName = blockName((instance as {_type: string})._type, namespace)
43
- return <WithDot {...props} rel={rel} shortName={shortName} parent={parent} />
48
+ return <WithDot {...props} rel={resolved.path} inList={resolved.inList} shortName={shortName} parent={parent} />
44
49
  }
45
50
 
46
- function WithDot(props: InputProps & {rel: string[]; shortName: string; parent: unknown}) {
47
- const {rel, shortName, parent, ...inputProps} = props
51
+ function WithDot(props: InputProps & {rel: (string | number)[]; inList: boolean; shortName: string; parent: unknown}) {
52
+ const {rel, inList, shortName, parent, ...inputProps} = props
48
53
  const client = useKitClient()
49
54
  const languageField = config.i18n?.field ?? 'language'
50
55
  const language = (useFormValue([languageField]) as string | undefined) ?? null
@@ -52,17 +57,25 @@ export function createOverrideInput(config: ResolvedKitConfig): ComponentType<In
52
57
  const inherited = defaultValueAt(defaults, shortName, rel)
53
58
  const field = rel[rel.length - 1] ?? ''
54
59
 
60
+ const router = useRouter()
55
61
  if (!isOverride(inputProps.value, inherited, field, parent)) return inputProps.renderDefault(inputProps)
62
+ // « Réinitialiser » APPLIQUE la valeur par défaut dans le champ (jamais un
63
+ // champ vide). Sans valeur par défaut : ouvre le réglage du composant.
64
+ const action = resetAction(inherited)
65
+ const onClick =
66
+ action.kind === 'apply'
67
+ ? () => inputProps.onChange(set(action.value))
68
+ : () =>
69
+ router.navigateIntent(
70
+ 'edit',
71
+ componentIntentParams(`${namespace}${shortName}`, namespace, config.componentPreview, defaultsType),
72
+ )
56
73
  return (
57
74
  <Flex align="flex-start" gap={2}>
58
75
  <Box flex={1} style={{minWidth: 0}}>
59
76
  {inputProps.renderDefault(inputProps)}
60
77
  </Box>
61
- <OverrideDot
62
- inherited={describeValue(inherited)}
63
- same={sameValue(inputProps.value, inherited)}
64
- onReset={() => inputProps.onChange(unset())}
65
- />
78
+ <OverrideDot hasDefault={action.kind === 'apply'} full={describeValue(inherited)} short={shortValue(inherited)} onClick={onClick} />
66
79
  </Flex>
67
80
  )
68
81
  }
@@ -85,34 +98,39 @@ function carriesDot(schemaType: InputProps['schemaType']): boolean {
85
98
 
86
99
  const BLUE = 'var(--card-badge-primary-dot-color, #2276fc)'
87
100
 
88
- function OverrideDot(props: {inherited: string; same: boolean; onReset: () => void}) {
101
+ function OverrideDot(props: {hasDefault: boolean; full: string; short: string; onClick: () => void}) {
89
102
  const [hover, setHover] = useState(false)
103
+ const label = props.hasDefault ? `↺ ${props.short}` : 'Pas de valeur par défaut'
90
104
  return (
91
105
  <Tooltip
92
106
  portal
93
107
  placement="left"
94
108
  content={
95
- <Box padding={2} style={{maxWidth: 260}}>
109
+ <Box padding={2} style={{maxWidth: 280}}>
96
110
  <Text size={1}>
97
- Valeur propre à cette instance{props.same ? ' (identique au défaut, mais figée : elle ne suivra pas ses changements)' : ''}.
98
- Défaut du composant : {props.inherited}.
111
+ {props.hasDefault
112
+ ? `Différent de la valeur par défaut du composant. Cliquer pour appliquer la valeur par défaut : ${props.full}.`
113
+ : 'Ce composant n\'a pas de valeur par défaut pour ce champ. Cliquer pour la définir (Composants : valeurs par défaut).'}
99
114
  </Text>
100
115
  </Box>
101
116
  }
102
117
  >
103
118
  <button
104
119
  type="button"
105
- onClick={props.onReset}
120
+ onClick={props.onClick}
106
121
  onMouseEnter={() => setHover(true)}
107
122
  onMouseLeave={() => setHover(false)}
108
123
  onFocus={() => setHover(true)}
109
124
  onBlur={() => setHover(false)}
110
- aria-label="Réinitialiser à la valeur par défaut du composant"
125
+ aria-label={props.hasDefault ? `Appliquer la valeur par défaut du composant : ${props.full}` : 'Définir la valeur par défaut du composant'}
111
126
  style={{
112
127
  marginTop: 9,
113
128
  flex: 'none',
114
129
  height: hover ? 22 : 10,
115
130
  minWidth: 10,
131
+ maxWidth: 240,
132
+ overflow: 'hidden',
133
+ textOverflow: 'ellipsis',
116
134
  padding: hover ? '0 8px' : 0,
117
135
  borderRadius: 999,
118
136
  border: 0,
@@ -127,7 +145,7 @@ function OverrideDot(props: {inherited: string; same: boolean; onReset: () => vo
127
145
  transition: 'all 120ms ease',
128
146
  }}
129
147
  >
130
- {hover ? '↺ Réinitialiser' : ''}
148
+ {hover ? label : ''}
131
149
  </button>
132
150
  </Tooltip>
133
151
  )
@@ -2,8 +2,8 @@ import {useEffect, useSyncExternalStore} from 'react'
2
2
  import type {SanityClient} from 'sanity'
3
3
 
4
4
  /**
5
- * Valeurs par défaut des composants (document publié, dans la langue de
6
- * l'instance), lues UNE fois et tenues à jour en direct pour tous les champs du
5
+ * Valeurs par défaut des composants (dernière version, brouillon compris : la
6
+ * même que le formulaire du composant), dans la langue de l'instance, lues UNE fois et tenues à jour en direct pour tous les champs du
7
7
  * formulaire : une seule requête et une seule écoute, quel que soit le nombre de
8
8
  * pastilles affichées.
9
9
  */
@@ -25,10 +25,11 @@ function entryFor(client: SanityClient, type: string, languageField: string, lan
25
25
  }
26
26
  const e = entry
27
27
  if (!e.stop) {
28
- const filter = `_type == $type && !(_id in path("drafts.**")) && ($language == null || !defined(${languageField}) || ${languageField} == $language)`
28
+ const filter = `_type == $type && ($language == null || !defined(${languageField}) || ${languageField} == $language)`
29
29
  const params = {type, language}
30
+ const drafts = client.withConfig({perspective: 'drafts'})
30
31
  const load = () =>
31
- client
32
+ drafts
32
33
  .fetch<Defaults>(`*[${filter}][0]`, params)
33
34
  .then((value) => {
34
35
  e.value = value
@@ -27,49 +27,87 @@ export function firstKeyedIndex(path: readonly PathSegment[]): number {
27
27
  }
28
28
 
29
29
  /**
30
- * Chemin du champ à l'intérieur de l'instance (`['cta', 'style']`), si `instance`
31
- * est bien un composant de l'espace de noms et que le chemin ne traverse pas une
32
- * liste (une liste remplie remplace celle du défaut en entier : pas d'héritage
33
- * élément par élément).
30
+ * Chemin du champ à l'intérieur de l'instance, listes comprises : un élément de
31
+ * liste est repéré par son rang (`['items', 0, 'title']`), comparé à l'élément de
32
+ * même rang de la valeur par défaut. `inList` : le champ est dans un élément de
33
+ * liste (une liste remplie remplace celle du défaut en entier : réinitialiser
34
+ * RECOPIE la valeur par défaut au lieu de vider le champ). `null` : pas un
35
+ * composant de l'espace de noms.
34
36
  */
35
- export function relativeFieldPath(
37
+ export function resolveFieldPath(
36
38
  path: readonly PathSegment[],
37
39
  index: number,
38
40
  instance: unknown,
39
41
  namespace: string,
40
- ): string[] | null {
42
+ ): {path: (string | number)[]; inList: boolean} | null {
41
43
  const type = (instance as {_type?: unknown} | null)?._type
42
44
  if (index < 0 || typeof type !== 'string' || !type.startsWith(namespace)) return null
43
- const rel = path.slice(index + 1)
44
- if (rel.length === 0 || !rel.every((s) => typeof s === 'string')) return null
45
- return rel as string[]
45
+ const rest = path.slice(index + 1)
46
+ if (rest.length === 0) return null
47
+ const out: (string | number)[] = []
48
+ let inList = false
49
+ let node: unknown = instance
50
+ for (const seg of rest) {
51
+ if (typeof seg === 'string') {
52
+ out.push(seg)
53
+ node = node && typeof node === 'object' ? (node as Record<string, unknown>)[seg] : undefined
54
+ } else if (isKeyed(seg) || typeof seg === 'number') {
55
+ if (!Array.isArray(node)) return null
56
+ const i = typeof seg === 'number' ? seg : node.findIndex((item) => (item as {_key?: unknown})?._key === seg._key)
57
+ if (i < 0) return null
58
+ // Texte riche : comparé comme un tout (le champ), pas paragraphe par paragraphe.
59
+ if ((node[i] as {_type?: unknown} | null)?._type === 'block') return null
60
+ out.push(i)
61
+ inList = true
62
+ node = node[i]
63
+ } else return null
64
+ }
65
+ return {path: out, inList}
66
+ }
67
+
68
+ /** @deprecated Utiliser resolveFieldPath (listes comprises). */
69
+ export function relativeFieldPath(
70
+ path: readonly PathSegment[],
71
+ index: number,
72
+ instance: unknown,
73
+ namespace: string,
74
+ ): string[] | null {
75
+ const r = resolveFieldPath(path, index, instance, namespace)
76
+ return r && !r.inList ? (r.path as string[]) : null
46
77
  }
47
78
 
48
79
  /** Valeur par défaut d'un champ de composant. */
49
80
  export function defaultValueAt(
50
81
  defaults: Record<string, unknown> | null | undefined,
51
82
  blockShortName: string,
52
- relPath: readonly string[],
83
+ relPath: readonly (string | number)[],
53
84
  ): unknown {
54
85
  let node: unknown = defaults?.[blockShortName]
55
86
  for (const key of relPath) {
56
87
  if (!node || typeof node !== 'object') return undefined
57
- node = (node as Record<string, unknown>)[key]
88
+ node = (node as Record<string | number, unknown>)[key]
58
89
  }
59
90
  return node
60
91
  }
61
92
 
93
+ const hasLinkTarget = (link: unknown) => {
94
+ const l = (link ?? {}) as Record<string, unknown>
95
+ return LINK_TARGET_FIELDS.some((k) => (k === 'file' ? Boolean((l.file as {asset?: unknown} | undefined)?.asset) : !isEmptyValue(l[k])))
96
+ }
97
+
62
98
  /**
63
- * Le champ est-il un override ? Valeur propre à l'instance ET valeur par défaut
64
- * existante (sans défaut, il n'y a rien à surcharger). Le type d'un lien n'est
65
- * jamais signalé : il est prérempli par le Studio et ne compte que si le lien a
66
- * une cible.
99
+ * Le champ est-il un override ? Valeur propre à l'instance DIFFÉRENTE de la
100
+ * valeur par défaut du composant (y compris quand le composant n'a pas de valeur
101
+ * par défaut pour ce champ). Un champ vide hérite : jamais d'override. Une case
102
+ * décochée vaut une case non renseignée. Le type d'un lien ne compte que si le
103
+ * lien a sa propre cible (il est prérempli par le Studio).
67
104
  */
68
- export function isOverride(local: unknown, inherited: unknown, field: string, parent: unknown): boolean {
69
- if (isEmptyValue(local) || isEmptyValue(inherited)) return false
105
+ export function isOverride(local: unknown, inherited: unknown, field: string | number, parent: unknown): boolean {
106
+ if (isEmptyValue(local)) return false
107
+ if (local === false && isEmptyValue(inherited)) return false
70
108
  const parentType = (parent as {_type?: unknown} | null)?._type
71
- if (field === 'type' && typeof parentType === 'string' && LINK_TYPES.has(parentType)) return false
72
- return true
109
+ if (field === 'type' && typeof parentType === 'string' && LINK_TYPES.has(parentType) && !hasLinkTarget(parent)) return false
110
+ return !sameValue(local, inherited)
73
111
  }
74
112
 
75
113
  /** Égalité de valeurs (champ identique au défaut : override « figé »). */
@@ -91,6 +129,7 @@ export function sameValue(a: unknown, b: unknown): boolean {
91
129
 
92
130
  /** Valeur par défaut lisible, pour la bulle de la pastille. */
93
131
  export function describeValue(value: unknown): string {
132
+ if (isEmptyValue(value)) return 'vide (valeur du design system)'
94
133
  if (typeof value === 'string') return value.length > 60 ? `« ${value.slice(0, 57)}… »` : `« ${value} »`
95
134
  if (typeof value === 'boolean') return value ? 'Oui' : 'Non'
96
135
  if (typeof value === 'number') return String(value)
@@ -105,3 +144,20 @@ export function describeValue(value: unknown): string {
105
144
  }
106
145
  return 'une valeur'
107
146
  }
147
+
148
+ /**
149
+ * Ce que fait « Réinitialiser » : appliquer la valeur par défaut du composant
150
+ * dans le champ (jamais le vider : un champ vidé sans valeur par défaut ferait
151
+ * disparaître le contenu de la page). Sans valeur par défaut : rien à appliquer,
152
+ * la pastille renvoie au réglage du composant.
153
+ */
154
+ export function resetAction(inherited: unknown): {kind: 'apply'; value: unknown} | {kind: 'noDefault'} {
155
+ if (isEmptyValue(inherited)) return {kind: 'noDefault'}
156
+ return {kind: 'apply', value: structuredClone(inherited)}
157
+ }
158
+
159
+ /** Libellé court de la valeur par défaut, pour la pastille au survol. */
160
+ export function shortValue(value: unknown, max = 32): string {
161
+ const d = describeValue(value)
162
+ return d.length > max ? `${d.slice(0, max - 1)}…` : d
163
+ }
package/src/version.ts CHANGED
@@ -2,4 +2,4 @@
2
2
  * Version du kit, rapportée au service pour savoir quels projets tournent sur
3
3
  * quelle version. Tenue à jour avec `package.json`.
4
4
  */
5
- export const KIT_VERSION = '2.8.0'
5
+ export const KIT_VERSION = '2.8.2'