@nocode-factory/sanity-kit 2.29.2 → 2.30.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.
@@ -0,0 +1,262 @@
1
+ import {useCallback, useState} from 'react'
2
+ import {Box, Button, Card, Dialog, Flex, Spinner, Stack, Text} from '@sanity/ui'
3
+ import {useSchema} from 'sanity'
4
+ import {TranslateIcon} from '@sanity/icons/Translate'
5
+ import {useKitConfig} from '../../context/KitContext'
6
+ import {useKitClient} from '../../hooks/useKitClient'
7
+ import type {SchemaTypeLike} from '../../lib/propagate'
8
+ import {createTranslatedVersion, fillTranslation, untranslatedPaths} from '../../lib/translateDocument'
9
+ import {recordTrace} from '../../lib/translationTrace'
10
+ import {BOARD_LAYOUT_TYPE} from '../../schema/boardLayout'
11
+ import {TRANSLATION_TODO_TYPE} from '../../schema/translationTodo'
12
+
13
+ type Doc = Record<string, unknown>
14
+
15
+ interface Plan {
16
+ /** Documents de la langue principale sans version dans une langue. */
17
+ missing: {language: string; docs: {_id: string; _type: string}[]}[]
18
+ /** Valeurs par défaut des composants : document absent, ou textes à traduire, par langue. */
19
+ defaults: {language: string; exists: boolean; texts: number; from: string}[]
20
+ }
21
+
22
+ const EXCLUDED = ['translation.metadata', BOARD_LAYOUT_TYPE, TRANSLATION_TODO_TYPE]
23
+
24
+ /**
25
+ * Langues du site : met chaque langue au niveau de la langue principale, en UN clic
26
+ * explicite (jamais tout seul). Utile à l'ajout d'une langue (« de » : toutes les
27
+ * pages en allemand) et après l'ajout d'un composant (valeurs par défaut traduites
28
+ * dans chaque langue).
29
+ * - Documents : chaque document publié de la langue principale sans version dans
30
+ * une langue reçoit sa version, traduite par l'IA, publiée et reliée.
31
+ * - Valeurs par défaut des composants : langue source (anglais en général), puis
32
+ * chaque langue ; un document absent est créé ; seuls les textes vides ou restés
33
+ * identiques au texte source sont traduits (jamais un texte traduit à la main).
34
+ */
35
+ export function LanguagesSync() {
36
+ const config = useKitConfig()
37
+ const client = useKitClient()
38
+ const schema = useSchema()
39
+ const [open, setOpen] = useState(false)
40
+ const [plan, setPlan] = useState<Plan | null>(null)
41
+ const [busy, setBusy] = useState(false)
42
+ const [progress, setProgress] = useState<string | null>(null)
43
+ const [report, setReport] = useState<string[] | null>(null)
44
+ const i18n = config.i18n
45
+ const field = i18n?.field ?? 'language'
46
+ const defaultsType = config.componentPreview.defaultsType
47
+ const typeOf = (name: string) => schema.get(name) as unknown as SchemaTypeLike | undefined
48
+
49
+ const analyse = useCallback(async () => {
50
+ if (!i18n) return
51
+ setPlan(null)
52
+ setReport(null)
53
+ const main = i18n.defaultLocale
54
+ const sources = await client.fetch<{_id: string; _type: string}[]>(
55
+ `*[defined(${field}) && ${field} == $main && !(_id in path("drafts.**")) && !(_type in $excluded)]{_id, _type}`,
56
+ {main, excluded: [...EXCLUDED, defaultsType]},
57
+ )
58
+ const metas = await client.fetch<{refs: {lang?: string; id?: string}[] | null}[]>(
59
+ `*[_type == "translation.metadata"]{"refs": translations[]{"lang": coalesce(language, _key), "id": value._ref}}`,
60
+ )
61
+ const langsOf = new Map<string, Set<string>>()
62
+ for (const m of metas) {
63
+ const langs = new Set((m.refs ?? []).map((r) => r.lang ?? ''))
64
+ for (const r of m.refs ?? []) if (r.id) langsOf.set(r.id, langs)
65
+ }
66
+ const others = i18n.locales.filter((l) => l !== main)
67
+ const missing = others.map((language) => ({language, docs: sources.filter((d) => !langsOf.get(d._id)?.has(language))}))
68
+
69
+ const defaultsDocs = await client.fetch<Doc[]>(`*[_type == $type && !(_id in path("drafts.**"))]`, {type: defaultsType})
70
+ const byLang = (lang: string) => defaultsDocs.find((d) => d[field] === lang) ?? null
71
+ const sourceLang = byLang(i18n.defaultsSourceLocale) ? i18n.defaultsSourceLocale : main
72
+ const sourceDoc = byLang(sourceLang)
73
+ const mainDoc = byLang(main)
74
+ const defaults: Plan['defaults'] = []
75
+ // 1. Un nouveau composant est rempli dans la langue principale (démo, pages) :
76
+ // la langue source (anglais) est d'abord complétée depuis elle.
77
+ if (sourceDoc && mainDoc && sourceLang !== main) {
78
+ const texts = untranslatedPaths(mainDoc, sourceDoc, typeOf(defaultsType)).length
79
+ if (texts) defaults.push({language: sourceLang, exists: true, texts, from: main})
80
+ }
81
+ // 2. Puis chaque autre langue depuis la langue source.
82
+ if (sourceDoc)
83
+ for (const language of i18n.locales.filter((l) => l !== sourceLang)) {
84
+ const doc = byLang(language)
85
+ defaults.push({language, exists: Boolean(doc), texts: untranslatedPaths(sourceDoc, doc, typeOf(defaultsType)).length, from: sourceLang})
86
+ }
87
+ setPlan({missing, defaults})
88
+ }, [client, defaultsType, field, i18n]) // eslint-disable-line react-hooks/exhaustive-deps
89
+
90
+ const run = async () => {
91
+ if (!plan || !i18n) return
92
+ setBusy(true)
93
+ const lines: string[] = []
94
+ try {
95
+ // 1. Documents manquants (pages, collections, réglages par langue).
96
+ const total = plan.missing.reduce((n, m) => n + m.docs.length, 0)
97
+ let n = 0
98
+ for (const m of plan.missing) {
99
+ let ok = 0
100
+ let drafts = 0
101
+ for (const d of m.docs) {
102
+ n++
103
+ setProgress(`Documents ${n}/${total} (${m.language.toUpperCase()})`)
104
+ const source = await client.getDocument<Doc>(d._id)
105
+ if (!source) continue
106
+ try {
107
+ const created = await createTranslatedVersion({
108
+ client,
109
+ config,
110
+ type: d._type,
111
+ schemaType: typeOf(d._type),
112
+ source,
113
+ sourceId: d._id,
114
+ sourceLanguage: i18n.defaultLocale,
115
+ language: m.language,
116
+ ai: true,
117
+ })
118
+ if (created.published) ok++
119
+ else drafts++
120
+ } catch (cause) {
121
+ lines.push(`${m.language.toUpperCase()} ${d._id}: ${cause instanceof Error ? cause.message : String(cause)}`)
122
+ }
123
+ }
124
+ if (m.docs.length) lines.unshift(`${m.language.toUpperCase()}: ${ok} published${drafts ? `, ${drafts} saved as drafts (texts to translate)` : ''}`)
125
+ }
126
+ // 2. Valeurs par défaut des composants.
127
+ for (const d of plan.defaults) {
128
+ if (d.exists && !d.texts) continue
129
+ // Relu à chaque étape : l'étape 1 vient peut-être de compléter la source.
130
+ const src = await client.fetch<Doc | null>(`*[_type == $type && ${field} == $lang && !(_id in path("drafts.**"))][0]`, {type: defaultsType, lang: d.from})
131
+ if (!src) continue
132
+ const sourceLang = d.from
133
+ setProgress(`Component defaults (${d.language.toUpperCase()})`)
134
+ if (!d.exists) {
135
+ await createTranslatedVersion({
136
+ client,
137
+ config,
138
+ type: defaultsType,
139
+ schemaType: typeOf(defaultsType),
140
+ source: src,
141
+ sourceId: String(src._id),
142
+ sourceLanguage: sourceLang,
143
+ language: d.language,
144
+ ai: true,
145
+ })
146
+ lines.push(`Component defaults ${d.language.toUpperCase()}: created`)
147
+ continue
148
+ }
149
+ const target = await client.fetch<Doc | null>(`*[_type == $type && ${field} == $lang && !(_id in path("drafts.**"))][0]`, {
150
+ type: defaultsType,
151
+ lang: d.language,
152
+ })
153
+ if (!target) continue
154
+ const filled = await fillTranslation({config, schemaType: typeOf(defaultsType), source: src, target, sourceLanguage: sourceLang, language: d.language})
155
+ const {_rev, _updatedAt, _createdAt, ...doc} = filled.document
156
+ const tx = client.transaction().createOrReplace(doc as {_id: string; _type: string})
157
+ // Brouillon en cours : complété aussi, pour que sa publication ne défasse rien.
158
+ const draft = await client.getDocument<Doc>(`drafts.${String(target._id)}`)
159
+ if (draft) {
160
+ const fd = await fillTranslation({config, schemaType: typeOf(defaultsType), source: src, target: draft, sourceLanguage: sourceLang, language: d.language})
161
+ const {_rev: r2, _updatedAt: u2, _createdAt: c2, ...dd} = fd.document
162
+ tx.createOrReplace(dd as {_id: string; _type: string})
163
+ }
164
+ await tx.commit()
165
+ await recordTrace(client, String(target._id), filled.written, {sourceId: String(src._id), sourceLanguage: sourceLang})
166
+ lines.push(`Component defaults ${d.language.toUpperCase()}: ${filled.translated} text${filled.translated > 1 ? 's' : ''} translated`)
167
+ }
168
+ } catch (cause) {
169
+ lines.push(`Stopped: ${cause instanceof Error ? cause.message : String(cause)}`)
170
+ } finally {
171
+ setBusy(false)
172
+ setProgress(null)
173
+ setReport(lines.length ? lines : ['Everything was already up to date.'])
174
+ void analyse()
175
+ }
176
+ }
177
+
178
+ if (!i18n || !config.history) return null
179
+ const pendingDocs = plan?.missing.reduce((n, m) => n + m.docs.length, 0) ?? 0
180
+ const pendingDefaults = plan?.defaults.filter((d) => !d.exists || d.texts).length ?? 0
181
+
182
+ return (
183
+ <>
184
+ <Button
185
+ icon={TranslateIcon}
186
+ text="Languages"
187
+ mode="ghost"
188
+ fontSize={1}
189
+ padding={2}
190
+ onClick={() => {
191
+ setOpen(true)
192
+ void analyse()
193
+ }}
194
+ />
195
+ {open && (
196
+ <Dialog id="ncf-languages" header="Languages" width={1} onClose={() => !busy && setOpen(false)}>
197
+ <Stack gap={4} padding={4}>
198
+ <Text size={1} muted>
199
+ Brings every language to the level of the main language ({i18n.defaultLocale.toUpperCase()}): missing pages and
200
+ documents are created, translated with AI and published; component defaults are translated from{' '}
201
+ {i18n.defaultsSourceLocale.toUpperCase()}. Texts already translated (even by hand) are never changed.
202
+ </Text>
203
+ {!plan ? (
204
+ <Flex align="center" gap={2}>
205
+ <Spinner muted />
206
+ <Text size={1} muted>
207
+ Checking…
208
+ </Text>
209
+ </Flex>
210
+ ) : (
211
+ <Stack gap={3}>
212
+ {plan.missing.map((m) => (
213
+ <Card key={m.language} padding={3} radius={2} border tone={m.docs.length ? 'caution' : 'positive'}>
214
+ <Text size={1}>
215
+ {m.language.toUpperCase()}: {m.docs.length ? `${m.docs.length} document${m.docs.length > 1 ? 's' : ''} without a version` : 'all documents have a version'}
216
+ </Text>
217
+ </Card>
218
+ ))}
219
+ {plan.defaults.map((d) => (
220
+ <Card key={`d-${d.language}`} padding={3} radius={2} border tone={!d.exists || d.texts ? 'caution' : 'positive'}>
221
+ <Text size={1}>
222
+ Component defaults {d.language.toUpperCase()}:{' '}
223
+ {!d.exists ? 'missing (will be created)' : d.texts ? `${d.texts} text${d.texts > 1 ? 's' : ''} to translate` : 'translated'}
224
+ </Text>
225
+ </Card>
226
+ ))}
227
+ </Stack>
228
+ )}
229
+ {progress && (
230
+ <Flex align="center" gap={2}>
231
+ <Spinner muted />
232
+ <Text size={1}>{progress}</Text>
233
+ </Flex>
234
+ )}
235
+ {report && (
236
+ <Card padding={3} radius={2} tone="primary">
237
+ <Stack gap={2}>
238
+ {report.map((line, i) => (
239
+ <Text key={i} size={1}>
240
+ {line}
241
+ </Text>
242
+ ))}
243
+ </Stack>
244
+ </Card>
245
+ )}
246
+ <Flex justify="flex-end" gap={2}>
247
+ <Button text="Close" mode="ghost" disabled={busy} onClick={() => setOpen(false)} />
248
+ <Box>
249
+ <Button
250
+ tone="primary"
251
+ text={busy ? 'Working…' : 'Translate with AI and publish'}
252
+ disabled={busy || !plan || (!pendingDocs && !pendingDefaults)}
253
+ onClick={() => void run()}
254
+ />
255
+ </Box>
256
+ </Flex>
257
+ </Stack>
258
+ </Dialog>
259
+ )}
260
+ </>
261
+ )
262
+ }
@@ -9,6 +9,7 @@ import {useDocumentColumns} from '../../hooks/useDocumentColumns'
9
9
  import {usePreviewTarget} from '../../context/PreviewTargetContext'
10
10
  import {PreviewTarget} from './PreviewTarget'
11
11
  import {SharePreview} from './SharePreview'
12
+ import {LanguagesSync} from './LanguagesSync'
12
13
  import {useTranslationTodos} from '../../hooks/useTranslationTodos'
13
14
  import {filterRows, localesInRows, sortRows, type PageRow, type SortDirection, type SortKey} from '../../lib/pages'
14
15
  import {groupPageRows, type GroupBy} from '../../lib/grouping'
@@ -186,6 +187,10 @@ export function PagesTool() {
186
187
  <SharePreview />
187
188
  </Box>
188
189
 
190
+ <Box style={{flex: 'none', paddingBottom: 2}}>
191
+ <LanguagesSync />
192
+ </Box>
193
+
189
194
  {view === 'list' && (
190
195
  <Box style={{flex: 'none', paddingBottom: 2}}>
191
196
  <ColumnVisibility
package/src/version.ts CHANGED
@@ -3,4 +3,4 @@
3
3
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
4
4
  * le vérifie.
5
5
  */
6
- export const KIT_VERSION = '2.29.2'
6
+ export const KIT_VERSION = '2.30.0'