@nocode-factory/sanity-kit 2.2.2 → 2.4.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nocode-factory/sanity-kit",
3
- "version": "2.2.2",
3
+ "version": "2.4.0",
4
4
  "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -0,0 +1,56 @@
1
+ import {useEffect, useState} from 'react'
2
+ import {KIT_VERSION} from '../version'
3
+ import {compareVersions, isPrerelease} from '../lib/version'
4
+
5
+ const REGISTRY = 'https://registry.npmjs.org/@nocode-factory/sanity-kit/latest'
6
+ const PACKAGE = '@nocode-factory/sanity-kit'
7
+
8
+ export interface KitUpdate {
9
+ current: string
10
+ latest: string | null
11
+ /** Vrai seulement quand une version stable dépasse celle qui s'exécute. */
12
+ available: boolean
13
+ /** Commande à lancer, prête à copier. */
14
+ command: string
15
+ }
16
+
17
+ /**
18
+ * Compare la version exécutée à la dernière publiée.
19
+ *
20
+ * Un Studio tourne dans un navigateur : il ne peut ni installer un paquet ni
21
+ * se redéployer. Il peut en revanche dire qu'il est en retard, et donner la
22
+ * commande — c'est tout ce qu'un bouton peut honnêtement offrir ici.
23
+ *
24
+ * Le registre npm autorise les requêtes navigateur, et le paquet est public :
25
+ * aucune authentification n'est nécessaire.
26
+ *
27
+ * Échoue en silence : ne pas savoir si une mise à jour existe ne doit gêner
28
+ * personne.
29
+ */
30
+ export function useKitUpdate(): KitUpdate {
31
+ const [latest, setLatest] = useState<string | null>(null)
32
+
33
+ useEffect(() => {
34
+ const controller = new AbortController()
35
+ fetch(REGISTRY, {signal: controller.signal})
36
+ .then((response) => (response.ok ? response.json() : null))
37
+ .then((body: {version?: string} | null) => {
38
+ if (!controller.signal.aborted && body?.version) setLatest(body.version)
39
+ })
40
+ .catch(() => {
41
+ // Registre injoignable, navigation hors ligne : sans conséquence.
42
+ })
43
+ return () => controller.abort()
44
+ }, [])
45
+
46
+ const available = Boolean(
47
+ latest && !isPrerelease(latest) && compareVersions(latest, KIT_VERSION) > 0,
48
+ )
49
+
50
+ return {
51
+ current: KIT_VERSION,
52
+ latest,
53
+ available,
54
+ command: `npm install ${PACKAGE}@${latest ?? 'latest'}`,
55
+ }
56
+ }
package/src/index.ts CHANGED
@@ -6,6 +6,7 @@ import {DocumentsIcon} from '@sanity/icons/Documents'
6
6
  import {resolveConfig} from './config/resolve'
7
7
  import {validateConfig} from './config/validate'
8
8
  import {createToolComponent} from './tools/createToolComponent'
9
+ import {createPreviewLauncher} from './tools/navbar/PreviewLauncher'
9
10
  import {PagesTool} from './tools/pages/PagesTool'
10
11
  import {ComponentsTool} from './tools/components/ComponentsTool'
11
12
  import {HistoryTool} from './tools/history/HistoryTool'
@@ -100,6 +101,16 @@ export const ncfKit = definePlugin<NcfKitConfig>((options) => {
100
101
  newDocumentOptions: (prev) =>
101
102
  prev.filter((option) => option.templateId !== BOARD_LAYOUT_TYPE),
102
103
  },
104
+
105
+ // Le lanceur d'aperçu s'ajoute à droite des outils, dans la barre du haut
106
+ // comme dans le volet latéral. Posé par le plugin : il n'y a rien à
107
+ // brancher dans la configuration d'un projet.
108
+ //
109
+ // Le menu des outils est rendu tel quel — un plugin qui le remplacerait
110
+ // ferait disparaître « Plus » et tout ce qu'un autre y aurait mis.
111
+ studio: {
112
+ components: {toolMenu: createPreviewLauncher(config, issues)},
113
+ },
103
114
  }
104
115
  })
105
116
 
@@ -172,6 +183,11 @@ export {
172
183
  export type {PreviewPerspective, PresentationOptions} from './lib/studioLinks'
173
184
  export {usePreviewTarget} from './context/PreviewTargetContext'
174
185
  export {NcfPreviewHeader, ncfPreviewComponents} from './tools/presentation/PreviewHeader'
186
+ export {NcfPreviewLauncher, createPreviewLauncher} from './tools/navbar/PreviewLauncher'
187
+ export {NcfKitUpdate} from './tools/navbar/KitUpdate'
188
+ export {useKitUpdate} from './hooks/useKitUpdate'
189
+ export type {KitUpdate} from './hooks/useKitUpdate'
190
+ export {compareVersions, isPrerelease} from './lib/version'
175
191
  export {SharePreview} from './tools/pages/SharePreview'
176
192
  export {requestPreviewGrant, explainGrantError} from './lib/service'
177
193
  export type {PreviewGrant} from './lib/service'
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Comparaison de deux versions sémantiques.
3
+ *
4
+ * Suffisant pour ce qu'on en fait — savoir si une version publiée dépasse
5
+ * celle qu'on exécute. Les mentions de pré-publication (`2.4.0-rc.1`) sont
6
+ * ignorées : on ne propose jamais d'y passer.
7
+ *
8
+ * Rend 1 si `a` est postérieure, -1 si antérieure, 0 si égales.
9
+ */
10
+ export function compareVersions(a: string, b: string): number {
11
+ const parse = (v: string) =>
12
+ v
13
+ .trim()
14
+ .replace(/^v/, '')
15
+ .split('-')[0]!
16
+ .split('.')
17
+ .map((part) => Number.parseInt(part, 10) || 0)
18
+
19
+ const left = parse(a)
20
+ const right = parse(b)
21
+
22
+ for (let i = 0; i < 3; i += 1) {
23
+ const l = left[i] ?? 0
24
+ const r = right[i] ?? 0
25
+ if (l !== r) return l > r ? 1 : -1
26
+ }
27
+ return 0
28
+ }
29
+
30
+ /** Une version de pré-publication ne se propose pas. */
31
+ export const isPrerelease = (version: string): boolean => version.includes('-')
@@ -0,0 +1,106 @@
1
+ import {useState} from 'react'
2
+ import {Box, Button, Card, Flex, Stack, Text} from '@sanity/ui'
3
+ import {ArrowUpIcon} from '@sanity/icons/ArrowUp'
4
+ import {CheckmarkIcon} from '@sanity/icons/Checkmark'
5
+ import {CopyIcon} from '@sanity/icons/Copy'
6
+ import {InlinePopover} from '../../ui/Popover'
7
+ import {useKitUpdate} from '../../hooks/useKitUpdate'
8
+ import {BORDER, MONO} from '../../ui/tokens'
9
+
10
+ const CHANGELOG = 'https://github.com/nocode-factory/ncf-sanity-kit/blob/main/docs/CHANGELOG.md'
11
+
12
+ /**
13
+ * Signale qu'une version plus récente du kit existe.
14
+ *
15
+ * **Il ne met pas à jour.** Un Studio tourne dans un navigateur : il ne peut
16
+ * ni installer un paquet sur le poste d'un développeur, ni se redéployer. Ce
17
+ * bouton dit ce qui manque et donne la commande — prétendre faire plus serait
18
+ * mentir sur ce qui se passe.
19
+ *
20
+ * Invisible tant que le kit est à jour : un bouton permanent qui ne dit rien
21
+ * finit par ne plus être lu.
22
+ */
23
+ export function NcfKitUpdate(props: {inline?: boolean}) {
24
+ const update = useKitUpdate()
25
+ const [copied, setCopied] = useState(false)
26
+
27
+ if (!update.available) return null
28
+
29
+ const copy = async () => {
30
+ try {
31
+ await navigator.clipboard.writeText(update.command)
32
+ setCopied(true)
33
+ } catch {
34
+ // Presse-papiers refusé : la commande reste sélectionnable à la main.
35
+ setCopied(false)
36
+ }
37
+ }
38
+
39
+ return (
40
+ <InlinePopover
41
+ width={318}
42
+ trigger={({toggle}) => (
43
+ <Button
44
+ mode="bleed"
45
+ tone="primary"
46
+ fontSize={1}
47
+ padding={props.inline ? 2 : 3}
48
+ icon={ArrowUpIcon}
49
+ text={`Kit ${update.latest}`}
50
+ title={`Une version plus récente du kit est disponible (vous exécutez la ${update.current})`}
51
+ justify={props.inline ? undefined : 'flex-start'}
52
+ onClick={toggle}
53
+ />
54
+ )}
55
+ >
56
+ {() => (
57
+ <Stack gap={3} padding={2}>
58
+ <Stack gap={2}>
59
+ <Text size={1} weight="semibold">
60
+ Kit {update.latest} disponible
61
+ </Text>
62
+ <Text size={0} muted>
63
+ Vous exécutez la {update.current}.
64
+ </Text>
65
+ </Stack>
66
+
67
+ <Card padding={2} radius={2} style={{border: `1px solid ${BORDER}`}}>
68
+ <Text size={0} style={{...MONO, wordBreak: 'break-all'}}>
69
+ {update.command}
70
+ </Text>
71
+ </Card>
72
+
73
+ <Flex gap={2} wrap="wrap">
74
+ <Button
75
+ mode="default"
76
+ tone="primary"
77
+ fontSize={1}
78
+ padding={2}
79
+ icon={copied ? CheckmarkIcon : CopyIcon}
80
+ text={copied ? 'Copié' : 'Copier la commande'}
81
+ onClick={copy}
82
+ />
83
+ <Button
84
+ as="a"
85
+ href={CHANGELOG}
86
+ target="_blank"
87
+ rel="noreferrer"
88
+ mode="bleed"
89
+ fontSize={1}
90
+ padding={2}
91
+ text="Nouveautés"
92
+ />
93
+ </Flex>
94
+
95
+ <Box style={{borderTop: `1px solid ${BORDER}`, paddingTop: 10}}>
96
+ <Text size={0} muted>
97
+ À lancer dans <code>studio/</code> puis <code>web/</code>, suivi d'un{' '}
98
+ <code>npx sanity deploy</code>. Le Studio ne peut pas le faire lui-même : il
99
+ s'exécute dans votre navigateur, pas sur la machine qui le construit.
100
+ </Text>
101
+ </Box>
102
+ </Stack>
103
+ )}
104
+ </InlinePopover>
105
+ )
106
+ }
@@ -0,0 +1,139 @@
1
+ import {Box, Button, Flex, Stack, Text} from '@sanity/ui'
2
+ import {useRouter} from 'sanity/router'
3
+ import type {ToolMenuProps} from 'sanity'
4
+ import {InlinePopover} from '../../ui/Popover'
5
+ import {KitProvider, useKitConfig} from '../../context/KitContext'
6
+ import {presentationPath, PERSPECTIVES, type PreviewPerspective} from '../../lib/studioLinks'
7
+ import type {ConfigIssue, NcfEnvironment, ResolvedKitConfig} from '../../config/types'
8
+ import {EyeOpenIcon} from '@sanity/icons/EyeOpen'
9
+ import {LaunchIcon} from '@sanity/icons/Launch'
10
+ import {BORDER} from '../../ui/tokens'
11
+ import {NcfKitUpdate} from './KitUpdate'
12
+
13
+ /**
14
+ * Lanceur d'aperçu, posé dans la barre du haut à droite des outils.
15
+ *
16
+ * Deux questions, une seule poignée : **quelle version du site**, et **quel
17
+ * état du contenu**. On choisit, on ouvre.
18
+ *
19
+ * Volontairement sans mémoire, contrairement au sélecteur de l'onglet Pages :
20
+ * ici on lance une consultation, on ne règle pas un mode de travail. Un
21
+ * bouton de barre qui retiendrait un état finirait par mentir sur ce qu'on
22
+ * regarde ailleurs.
23
+ */
24
+ export function NcfPreviewLauncher(props: ToolMenuProps) {
25
+ const config = useKitConfig()
26
+ const router = useRouter()
27
+ const environments = config.environments
28
+
29
+ if (environments.length === 0) {
30
+ return (
31
+ <Flex align="center" gap={2}>
32
+ {props.renderDefault(props)}
33
+ <NcfKitUpdate inline={props.context === 'topbar'} />
34
+ </Flex>
35
+ )
36
+ }
37
+
38
+ const open = (environment: NcfEnvironment, perspective: PreviewPerspective) => {
39
+ const path = presentationPath(environment.url, {environment, perspective})
40
+ if (path) router.navigateUrl({path})
41
+ }
42
+
43
+ // En colonne dans le volet latéral, en ligne dans la barre : le menu des
44
+ // outils change de forme selon la place, le lanceur doit suivre.
45
+ const inline = props.context === 'topbar'
46
+
47
+ return (
48
+ <Flex
49
+ align={inline ? 'center' : 'stretch'}
50
+ direction={inline ? 'row' : 'column'}
51
+ gap={inline ? 2 : 1}
52
+ >
53
+ {props.renderDefault(props)}
54
+
55
+ <NcfKitUpdate inline={inline} />
56
+
57
+ <InlinePopover
58
+ width={248}
59
+ trigger={({toggle}) => (
60
+ <Button
61
+ mode="bleed"
62
+ fontSize={1}
63
+ padding={inline ? 2 : 3}
64
+ icon={EyeOpenIcon}
65
+ text="Prévisualiser"
66
+ title="Ouvrir le site dans l'aperçu"
67
+ justify={inline ? undefined : 'flex-start'}
68
+ onClick={toggle}
69
+ />
70
+ )}
71
+ >
72
+ {({close}) => (
73
+ <Stack gap={1}>
74
+ {environments.map((environment, index) => (
75
+ <Box
76
+ key={environment.id}
77
+ paddingTop={index === 0 ? 1 : 3}
78
+ style={
79
+ index === 0 ? undefined : {borderTop: `1px solid ${BORDER}`, marginTop: 4}
80
+ }
81
+ >
82
+ <Box paddingX={2} paddingBottom={1}>
83
+ <Text size={0} weight="semibold" muted textOverflow="ellipsis">
84
+ {environment.label}
85
+ </Text>
86
+ </Box>
87
+ {PERSPECTIVES.map((option) => (
88
+ <Flex
89
+ key={option.id}
90
+ align="center"
91
+ gap={2}
92
+ padding={2}
93
+ onClick={() => {
94
+ open(environment, option.id)
95
+ close()
96
+ }}
97
+ style={{cursor: 'pointer', borderRadius: 3}}
98
+ onMouseEnter={(event) => {
99
+ event.currentTarget.style.background =
100
+ 'var(--card-muted-bg-color, rgba(127,127,127,0.12))'
101
+ }}
102
+ onMouseLeave={(event) => {
103
+ event.currentTarget.style.background = 'transparent'
104
+ }}
105
+ >
106
+ <Stack gap={1} flex={1} style={{minWidth: 0}}>
107
+ <Text size={1}>{option.label}</Text>
108
+ <Text size={0} muted textOverflow="ellipsis">
109
+ {option.hint}
110
+ </Text>
111
+ </Stack>
112
+ <LaunchIcon style={{fontSize: 14, opacity: 0.5, flex: 'none'}} />
113
+ </Flex>
114
+ ))}
115
+ </Box>
116
+ ))}
117
+ </Stack>
118
+ )}
119
+ </InlinePopover>
120
+ </Flex>
121
+ )
122
+ }
123
+
124
+
125
+ /**
126
+ * Le lanceur, muni de la configuration du kit.
127
+ *
128
+ * Le menu des outils est rendu hors de l'arbre des outils : il n'hérite donc
129
+ * d'aucun de leurs contextes, et doit porter le sien.
130
+ */
131
+ export function createPreviewLauncher(config: ResolvedKitConfig, issues: ConfigIssue[]) {
132
+ return function NcfToolMenu(props: ToolMenuProps) {
133
+ return (
134
+ <KitProvider config={config} issues={issues}>
135
+ <NcfPreviewLauncher {...props} />
136
+ </KitProvider>
137
+ )
138
+ }
139
+ }
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.2.2'
5
+ export const KIT_VERSION = '2.4.0'