@nocode-factory/sanity-kit 2.29.2 → 2.30.1
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/bin/ncf-kit.mjs +192 -0
- package/dist/index.d.ts +14 -1
- package/dist/index.js +753 -278
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/src/actions/PropagatePublish.tsx +63 -64
- package/src/form/TranslationTodoInput.tsx +2 -0
- package/src/lib/translateDocument.ts +202 -0
- package/src/lib/translationTrace.ts +55 -0
- package/src/schema/translationTodo.ts +10 -0
- package/src/tools/pages/LanguagesSync.tsx +262 -0
- package/src/tools/pages/PagesTool.tsx +5 -0
- package/src/version.ts +1 -1
|
@@ -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