@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/dist/index.d.ts +50 -2
- package/dist/index.js +242 -67
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/src/hooks/useKitUpdate.ts +56 -0
- package/src/index.ts +4 -0
- package/src/lib/version.ts +31 -0
- package/src/tools/navbar/KitUpdate.tsx +106 -0
- package/src/tools/navbar/PreviewLauncher.tsx +11 -1
- package/src/version.ts +1 -1
package/package.json
CHANGED
|
@@ -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)
|
|
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