@nocode-factory/sanity-kit 2.3.0 → 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.3.0",
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
@@ -184,6 +184,10 @@ export type {PreviewPerspective, PresentationOptions} from './lib/studioLinks'
184
184
  export {usePreviewTarget} from './context/PreviewTargetContext'
185
185
  export {NcfPreviewHeader, ncfPreviewComponents} from './tools/presentation/PreviewHeader'
186
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'
187
191
  export {SharePreview} from './tools/pages/SharePreview'
188
192
  export {requestPreviewGrant, explainGrantError} from './lib/service'
189
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
+ }
@@ -8,6 +8,7 @@ import type {ConfigIssue, NcfEnvironment, ResolvedKitConfig} from '../../config/
8
8
  import {EyeOpenIcon} from '@sanity/icons/EyeOpen'
9
9
  import {LaunchIcon} from '@sanity/icons/Launch'
10
10
  import {BORDER} from '../../ui/tokens'
11
+ import {NcfKitUpdate} from './KitUpdate'
11
12
 
12
13
  /**
13
14
  * Lanceur d'aperçu, posé dans la barre du haut à droite des outils.
@@ -25,7 +26,14 @@ export function NcfPreviewLauncher(props: ToolMenuProps) {
25
26
  const router = useRouter()
26
27
  const environments = config.environments
27
28
 
28
- if (environments.length === 0) return props.renderDefault(props)
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
+ }
29
37
 
30
38
  const open = (environment: NcfEnvironment, perspective: PreviewPerspective) => {
31
39
  const path = presentationPath(environment.url, {environment, perspective})
@@ -44,6 +52,8 @@ export function NcfPreviewLauncher(props: ToolMenuProps) {
44
52
  >
45
53
  {props.renderDefault(props)}
46
54
 
55
+ <NcfKitUpdate inline={inline} />
56
+
47
57
  <InlinePopover
48
58
  width={248}
49
59
  trigger={({toggle}) => (
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.3.0'
5
+ export const KIT_VERSION = '2.4.0'