@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.
- package/bin/ncf-kit.mjs +176 -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
package/bin/ncf-kit.mjs
CHANGED
|
@@ -35,6 +35,7 @@ function usage(code = 0) {
|
|
|
35
35
|
npx ncf-kit doctor [--web <dossier>] [--offline] vérifie que le projet est complet
|
|
36
36
|
npx ncf-kit check-environments [--page <chemin>] test prod / préprod, BLOQUANT (postbuild du site)
|
|
37
37
|
npx ncf-kit check-deploy avant sanity deploy : l'appId est bien le Studio de CE projet
|
|
38
|
+
npx ncf-kit translate-json [--apply] textes du site (messages/<langue>.json, titres du registre) traduits par IA
|
|
38
39
|
npx ncf-kit translations [export] [--out <fichier>] champs « À traduire » → JSON (texte source et actuel)
|
|
39
40
|
npx ncf-kit translations apply <fichier> écrit les traductions dans les brouillons
|
|
40
41
|
|
|
@@ -378,6 +379,37 @@ async function doctor() {
|
|
|
378
379
|
config.includes('ncfMainDocuments(')
|
|
379
380
|
? ok('Langues : panneau de Presentation', 'ncfMainDocuments')
|
|
380
381
|
: ko('Langues : panneau de Presentation', need('ncfMainDocuments dans presentationTool', 'en changeant de langue dans l\'aperçu, le panneau de droite doit éditer le document de cette langue', 'resolve: {mainDocuments: defineDocuments(ncfMainDocuments(ncfOptions, {siteRoutes: routes}))} (voir sanity.config.ts du starter).'))
|
|
382
|
+
// Textes du site par langue : un fichier de messages et un titre de registre par
|
|
383
|
+
// langue (sinon une langue s'afficherait dans la langue principale sans le dire).
|
|
384
|
+
if (webPkg) {
|
|
385
|
+
const webEnv = parseEnv(read(join(web, '.env.local')))
|
|
386
|
+
const webLocales = String(webEnv.NEXT_PUBLIC_LOCALES || '').split(',').map((l) => l.trim()).filter(Boolean)
|
|
387
|
+
if (webLocales.length && webLocales.join(',') !== locales.join(','))
|
|
388
|
+
ko('Langues : studio = site', `studio ${locales.join(',')} ≠ site (web/.env.local) ${webLocales.join(',')} : mêmes langues, même ordre (la 1re est la langue principale), aussi dans Vercel.`)
|
|
389
|
+
const messagesDir = join(web, 'i18n', 'messages')
|
|
390
|
+
if (existsSync(messagesDir)) {
|
|
391
|
+
const missingFiles = locales.filter((l) => !existsSync(join(messagesDir, `${l}.json`)))
|
|
392
|
+
missingFiles.length
|
|
393
|
+
? ko('Langues : textes du site', need(`un fichier de textes par langue (${missingFiles.map((l) => `messages/${l}.json`).join(', ')})`, 'sinon la langue s\'affiche dans la langue principale', 'npx ncf-kit translate-json --apply (depuis studio/), puis relire et committer.'))
|
|
394
|
+
: ok('Langues : textes du site', `messages/{${locales.join(',')}}.json`)
|
|
395
|
+
}
|
|
396
|
+
const routesFile = join(web, 'app', 'lib', 'site-routes.json')
|
|
397
|
+
if (existsSync(routesFile)) {
|
|
398
|
+
let missingTitles = 0
|
|
399
|
+
const visit = (v) => {
|
|
400
|
+
if (Array.isArray(v)) v.forEach(visit)
|
|
401
|
+
else if (v && typeof v === 'object') {
|
|
402
|
+
const keys = Object.keys(v)
|
|
403
|
+
if (keys.length && keys.includes(locales[0]) && keys.every((k) => /^[a-z]{2}(-[A-Za-z]{2})?$/.test(k))) missingTitles += locales.filter((l) => v[l] === undefined).length
|
|
404
|
+
else Object.values(v).forEach(visit)
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
visit(JSON.parse(read(routesFile) || '{}'))
|
|
408
|
+
missingTitles
|
|
409
|
+
? ko('Langues : titres du registre', need('un titre par langue dans site-routes.json', `${missingTitles} manquant(s)`, 'npx ncf-kit translate-json --apply.'))
|
|
410
|
+
: ok('Langues : titres du registre', 'complets')
|
|
411
|
+
}
|
|
412
|
+
}
|
|
381
413
|
const rules = read(join(root, 'CLAUDE.md'))
|
|
382
414
|
rules && !/trois règles/i.test(rules) && warn('Langues : consignes', need('les trois règles des langues dans CLAUDE.md', 'Claude ne les connaîtrait pas dans ce projet', 'recopier le bloc « LANGUES » du CLAUDE.md du starter.'))
|
|
383
415
|
}
|
|
@@ -430,6 +462,45 @@ async function doctor() {
|
|
|
430
462
|
const studioPkg = read(join(studio, 'package.json'))
|
|
431
463
|
if (studioPkg && !/ncf-kit check-deploy/.test(studioPkg)) warn('Studio à déployer', "le kit a besoin d'un contrôle avant chaque déploiement du Studio ; le projet ne l'a pas : \"deploy\": \"ncf-kit check-deploy && sanity deploy\" dans studio/package.json, et toujours `npm run deploy`.")
|
|
432
464
|
}
|
|
465
|
+
// Contenus par langue : chaque document de la langue principale a sa version dans
|
|
466
|
+
// chaque langue, et les valeurs par défaut des composants existent par langue.
|
|
467
|
+
{
|
|
468
|
+
const locales = String(env.SANITY_STUDIO_LOCALES || '').split(',').map((l) => l.trim()).filter(Boolean)
|
|
469
|
+
const projectId = env.SANITY_STUDIO_PROJECT_ID
|
|
470
|
+
const dataset = env.SANITY_STUDIO_DATASET || 'production'
|
|
471
|
+
const token = sanityToken()
|
|
472
|
+
if (locales.length > 1 && projectId && token) {
|
|
473
|
+
const q = async (query, params = {}) => {
|
|
474
|
+
const url = new URL(`https://${projectId}.api.sanity.io/v2025-02-19/data/query/${dataset}`)
|
|
475
|
+
url.searchParams.set('query', query)
|
|
476
|
+
url.searchParams.set('perspective', 'raw')
|
|
477
|
+
for (const [k, v] of Object.entries(params)) url.searchParams.set(`$${k}`, JSON.stringify(v))
|
|
478
|
+
const r = await request(url, {headers: {authorization: `Bearer ${token}`}})
|
|
479
|
+
return r.ok ? r.body.result : null
|
|
480
|
+
}
|
|
481
|
+
const main = locales[0]
|
|
482
|
+
const excluded = ['translation.metadata', 'ncfBoardLayout', 'ncfTranslationTodo', 'componentDefaults']
|
|
483
|
+
const sources = await q(`*[language == $main && !(_id in path("drafts.**")) && !(_type in $excluded)]._id`, {main, excluded})
|
|
484
|
+
const metas = await q(`*[_type == "translation.metadata"]{"refs": translations[]{"lang": coalesce(language, _key), "id": value._ref}}`)
|
|
485
|
+
if (Array.isArray(sources) && Array.isArray(metas)) {
|
|
486
|
+
const langsOf = new Map()
|
|
487
|
+
for (const m of metas) {
|
|
488
|
+
const langs = new Set((m.refs ?? []).map((r) => r.lang))
|
|
489
|
+
for (const r of m.refs ?? []) langsOf.set(r.id, langs)
|
|
490
|
+
}
|
|
491
|
+
const gaps = locales.slice(1).map((l) => [l, sources.filter((id) => !langsOf.get(id)?.has(l)).length]).filter(([, n]) => n)
|
|
492
|
+
gaps.length
|
|
493
|
+
? ko('Langues : contenus', `le kit a besoin que chaque langue ait toutes les pages de la langue principale (${main.toUpperCase()}) ; ${gaps.map(([l, n]) => `${l.toUpperCase()} : ${n} document(s) sans version`).join(', ')} : Studio → Pages → Languages → « Translate with AI and publish ».`)
|
|
494
|
+
: ok('Langues : contenus', `${sources.length} document(s) ${main.toUpperCase()}, chacun dans ${locales.length - 1} autre(s) langue(s)`)
|
|
495
|
+
const defaultsLangs = (await q(`*[_type == "componentDefaults" && !(_id in path("drafts.**"))].language`)) ?? []
|
|
496
|
+
const noDefaults = locales.filter((l) => !defaultsLangs.includes(l))
|
|
497
|
+
if (defaultsLangs.length)
|
|
498
|
+
noDefaults.length
|
|
499
|
+
? ko('Langues : valeurs par défaut', `valeurs par défaut des composants absentes en ${noDefaults.join(', ').toUpperCase()} : Studio → Pages → Languages (crée et traduit). Après un nouveau composant : npm run defaults:fill -- --apply, puis Languages.`)
|
|
500
|
+
: ok('Langues : valeurs par défaut', `une par langue (${locales.join(', ')})`)
|
|
501
|
+
}
|
|
502
|
+
}
|
|
503
|
+
}
|
|
433
504
|
// Purge du cache à la publication : webhook Sanity vers la PRODUCTION
|
|
434
505
|
// (/api/revalidate), qui relaie à la préprod. Sans lui, rien ne se met à jour
|
|
435
506
|
// sur le site avant le prochain build.
|
|
@@ -643,6 +714,109 @@ async function checkDeploy({quiet = false} = {}) {
|
|
|
643
714
|
return {level: 'ok', detail: `${app.appHost ?? appId}.sanity.studio`}
|
|
644
715
|
}
|
|
645
716
|
|
|
717
|
+
// ─── translate-json : textes du site (fichiers de messages, titres du registre) ───
|
|
718
|
+
// Complète par IA (service du kit, même clé de projet que le Studio) ce qui manque
|
|
719
|
+
// dans une langue, depuis la langue PRINCIPALE (1re de SANITY_STUDIO_LOCALES) :
|
|
720
|
+
// - web/i18n/messages/<langue>.json : clés absentes (les valeurs existantes ne sont
|
|
721
|
+
// jamais modifiées) ; fichier créé s'il n'existe pas ;
|
|
722
|
+
// - web/app/lib/site-routes.json : chaque objet par langue ({fr, en}) reçoit les
|
|
723
|
+
// langues manquantes.
|
|
724
|
+
// Par défaut : simulation ; --apply écrit. Depuis studio/ (lit son .env).
|
|
725
|
+
async function translateJson() {
|
|
726
|
+
const studioDir = resolve(flag('dir') ?? process.cwd())
|
|
727
|
+
const root = dirname(studioDir)
|
|
728
|
+
const web = resolve(flag('web') ?? join(root, 'web'))
|
|
729
|
+
const env = {...parseEnv(read(join(studioDir, '.env'))), ...parseEnv(read(join(studioDir, '.env.production.local')))}
|
|
730
|
+
const locales = String(flag('locales') ?? env.SANITY_STUDIO_LOCALES ?? '').split(',').map((l) => l.trim()).filter(Boolean)
|
|
731
|
+
const main = flag('main') ?? locales[0]
|
|
732
|
+
const apply = has('apply')
|
|
733
|
+
if (locales.length < 2 || !main) fail('Site monolingue (SANITY_STUDIO_LOCALES) : rien à traduire.')
|
|
734
|
+
const key = env.SANITY_STUDIO_NCF_PROJECT_KEY
|
|
735
|
+
if (!key) fail('SANITY_STUDIO_NCF_PROJECT_KEY absent : `npx ncf-kit setup` d\'abord (clé du service du kit).')
|
|
736
|
+
const endpoint = (flag('endpoint') ?? env.SANITY_STUDIO_NCF_ENDPOINT ?? DEFAULT_ENDPOINT).replace(/\/$/, '')
|
|
737
|
+
const translate = async (to, texts) => {
|
|
738
|
+
const out = []
|
|
739
|
+
for (let i = 0; i < texts.length; i += 200) {
|
|
740
|
+
const r = await request(`${endpoint}/translate`, {
|
|
741
|
+
method: 'POST',
|
|
742
|
+
headers: {'content-type': 'application/json'},
|
|
743
|
+
body: JSON.stringify({key, from: main, to, texts: texts.slice(i, i + 200)}),
|
|
744
|
+
})
|
|
745
|
+
if (!r.ok || !Array.isArray(r.body.texts)) fail(`Traduction refusée (${r.status}) : ${JSON.stringify(r.body).slice(0, 200)}`)
|
|
746
|
+
out.push(...r.body.texts)
|
|
747
|
+
}
|
|
748
|
+
return out
|
|
749
|
+
}
|
|
750
|
+
const isObj = (v) => v && typeof v === 'object' && !Array.isArray(v)
|
|
751
|
+
let changes = 0
|
|
752
|
+
|
|
753
|
+
// 1. Fichiers de messages.
|
|
754
|
+
const messagesDir = join(web, 'i18n', 'messages')
|
|
755
|
+
const mainFile = join(messagesDir, `${main}.json`)
|
|
756
|
+
if (existsSync(mainFile)) {
|
|
757
|
+
const source = JSON.parse(readFileSync(mainFile, 'utf8'))
|
|
758
|
+
for (const locale of locales.filter((l) => l !== main)) {
|
|
759
|
+
const file = join(messagesDir, `${locale}.json`)
|
|
760
|
+
const target = existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : {}
|
|
761
|
+
const missing = []
|
|
762
|
+
const walk = (src, tgt, path) => {
|
|
763
|
+
for (const [k, v] of Object.entries(src)) {
|
|
764
|
+
if (isObj(v)) {
|
|
765
|
+
if (!isObj(tgt[k])) tgt[k] = {}
|
|
766
|
+
walk(v, tgt[k], [...path, k])
|
|
767
|
+
} else if (Array.isArray(v)) {
|
|
768
|
+
if (!Array.isArray(tgt[k])) missing.push({holder: tgt, key: k, value: v})
|
|
769
|
+
} else if (tgt[k] === undefined) missing.push({holder: tgt, key: k, value: v})
|
|
770
|
+
}
|
|
771
|
+
}
|
|
772
|
+
walk(source, target, [])
|
|
773
|
+
if (!missing.length) continue
|
|
774
|
+
// Chaînes traduites ; tableaux de chaînes traduits élément par élément ; le reste recopié.
|
|
775
|
+
const strings = []
|
|
776
|
+
for (const m of missing) {
|
|
777
|
+
if (typeof m.value === 'string') strings.push(m.value)
|
|
778
|
+
else if (Array.isArray(m.value)) for (const x of m.value) if (typeof x === 'string') strings.push(x)
|
|
779
|
+
}
|
|
780
|
+
const translated = apply ? await translate(locale, strings) : strings
|
|
781
|
+
let n = 0
|
|
782
|
+
for (const m of missing) {
|
|
783
|
+
if (typeof m.value === 'string') m.holder[m.key] = translated[n++]
|
|
784
|
+
else if (Array.isArray(m.value)) m.holder[m.key] = m.value.map((x) => (typeof x === 'string' ? translated[n++] : x))
|
|
785
|
+
else m.holder[m.key] = m.value
|
|
786
|
+
}
|
|
787
|
+
changes += missing.length
|
|
788
|
+
console.log(`${apply ? '✔' : '•'} messages/${locale}.json : ${missing.length} texte(s) ${apply ? 'traduit(s)' : 'à traduire'}`)
|
|
789
|
+
if (apply) writeFileSync(file, `${JSON.stringify(target, null, 2)}\n`)
|
|
790
|
+
}
|
|
791
|
+
} else console.log(`(pas de ${mainFile.replace(root + '/', '')} : fichiers de messages ignorés)`)
|
|
792
|
+
|
|
793
|
+
// 2. Titres par langue du registre des pages.
|
|
794
|
+
const routesFile = join(web, 'app', 'lib', 'site-routes.json')
|
|
795
|
+
if (existsSync(routesFile)) {
|
|
796
|
+
const routes = JSON.parse(readFileSync(routesFile, 'utf8'))
|
|
797
|
+
const maps = []
|
|
798
|
+
const visit = (v) => {
|
|
799
|
+
if (Array.isArray(v)) v.forEach(visit)
|
|
800
|
+
else if (isObj(v)) {
|
|
801
|
+
const keys = Object.keys(v)
|
|
802
|
+
if (keys.length && keys.includes(main) && keys.every((k) => /^[a-z]{2}(-[A-Za-z]{2})?$/.test(k)) && typeof v[main] === 'string') maps.push(v)
|
|
803
|
+
else Object.values(v).forEach(visit)
|
|
804
|
+
}
|
|
805
|
+
}
|
|
806
|
+
visit(routes)
|
|
807
|
+
for (const locale of locales.filter((l) => l !== main)) {
|
|
808
|
+
const todo = maps.filter((m) => m[locale] === undefined)
|
|
809
|
+
if (!todo.length) continue
|
|
810
|
+
const translated = apply ? await translate(locale, todo.map((m) => m[main])) : todo.map((m) => m[main])
|
|
811
|
+
todo.forEach((m, i) => (m[locale] = translated[i]))
|
|
812
|
+
changes += todo.length
|
|
813
|
+
console.log(`${apply ? '✔' : '•'} site-routes.json : ${todo.length} titre(s) ${locale} ${apply ? 'traduit(s)' : 'à traduire'}`)
|
|
814
|
+
}
|
|
815
|
+
if (apply && changes) writeFileSync(routesFile, `${JSON.stringify(routes, null, 2)}\n`)
|
|
816
|
+
}
|
|
817
|
+
console.log(changes ? (apply ? '\nRelire le diff, puis committer.' : '\nSimulation : relancer avec --apply pour traduire et écrire.') : 'Rien à traduire : chaque langue est complète.')
|
|
818
|
+
}
|
|
819
|
+
|
|
646
820
|
if (command === 'setup') {
|
|
647
821
|
setup().catch((error) => fail(error?.message ?? String(error)))
|
|
648
822
|
} else if (command === 'doctor') {
|
|
@@ -655,6 +829,8 @@ if (command === 'setup') {
|
|
|
655
829
|
if (r.level === 'ko') process.exit(1)
|
|
656
830
|
})
|
|
657
831
|
.catch((error) => fail(error?.message ?? String(error)))
|
|
832
|
+
} else if (command === 'translate-json') {
|
|
833
|
+
translateJson().catch((error) => fail(error?.message ?? String(error)))
|
|
658
834
|
} else if (command === 'translations') {
|
|
659
835
|
translations().catch((error) => fail(error?.message ?? String(error)))
|
|
660
836
|
} else if (command === 'check-environments') {
|
package/dist/index.d.ts
CHANGED
|
@@ -418,6 +418,19 @@ export declare const kitSchemaTypes: ({
|
|
|
418
418
|
type: "string";
|
|
419
419
|
}[];
|
|
420
420
|
readOnly: true;
|
|
421
|
+
} | {
|
|
422
|
+
name: "machine";
|
|
423
|
+
title: string;
|
|
424
|
+
type: "array";
|
|
425
|
+
readOnly: true;
|
|
426
|
+
of: {
|
|
427
|
+
type: "object";
|
|
428
|
+
name: string;
|
|
429
|
+
fields: {
|
|
430
|
+
name: string;
|
|
431
|
+
type: "string";
|
|
432
|
+
}[];
|
|
433
|
+
}[];
|
|
421
434
|
})[];
|
|
422
435
|
preview: {
|
|
423
436
|
select: {
|
|
@@ -1348,7 +1361,7 @@ export declare function ActorName(props: {
|
|
|
1348
1361
|
* quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
|
|
1349
1362
|
* le vérifie.
|
|
1350
1363
|
*/
|
|
1351
|
-
export declare const KIT_VERSION = "2.
|
|
1364
|
+
export declare const KIT_VERSION = "2.30.0";
|
|
1352
1365
|
/**
|
|
1353
1366
|
* Données de la page proposées comme colonnes.
|
|
1354
1367
|
*
|