Nuovo Intlayer v6 - Novità

Benvenuto in Intlayer v6! Questa versione si concentra su prestazioni, esperienza dello sviluppatore e affidabilità. Di seguito i punti salienti, con note di migrazione ed esempi da copiare e incollare.

Sommario

Punti salienti

• Nuovo comando: npx intlayer content test per rilevare le traduzioni mancanti
• Nuova opzione globale autoFill per generare automaticamente le traduzioni mancanti
• Il comando Fill salta per impostazione predefinita le traduzioni esistenti: npx intlayer fill
• Estensione VS Code: nuova Intlayer Activity Bar (Ricerca e Dizionari), azioni sulla toolbar/context, auto-rivelazione, comandi Fill/Test
• Build 10× più veloci grazie alla parallelizzazione delle promise
• Caching remoto del dizionario per evitare il refetch all'avvio dell'app
• Logging migliorato: imposta log.mode: 'verbose' per ispezionare il comportamento
• Validazione più rigorosa per prevenire crash dell'app su problemi di dizionario
• Aggiornamenti live con CMS usando build.importMode = 'fetch' e pnpm intlayer live
• Correzioni: integrazione Vue.js, adattatore Lynx, Visual Editor su Windows

Nuovo: Test delle traduzioni mancanti

Esegui rapidamente un audit del tuo progetto per trovare quali chiavi/locali mancano.

npx intlayer content test

Output:

pnpm intlayer content test
Traduzioni mancanti:
 - blog-data       - Giapponese (ja), Coreano (ko), Cinese (zh), Tedesco (de), Italiano (it) - src/components/BlogPage/blogData.content.ts
 - demo-page       - Francese (fr), Italiano (it)                                         - src/components/DemoPage/demo.content.ts
 - locale-switcher - Italiano (it), Portoghese (pt)                                       - src/components/LocaleSwitcher/localeSwitcher.content.ts
Locali: Inglese (en), Russo (ru), Giapponese (ja), Francese (fr), Coreano (ko), Cinese (zh), Spagnolo (es), Tedesco (de), Arabo (ar), Italiano (it), Inglese britannico (en-GB), Portoghese (pt), Hindi (hi)
Locali richieste: Inglese (en)
Locali mancanti: Giapponese (ja), Coreano (ko), Cinese (zh), Tedesco (de), Italiano (it), Francese (fr), Portoghese (pt)
Locali richieste mancanti: -
Totale locali mancanti: 7
Totale locali richiesti mancanti: 0

Consulta più opzioni nella documentazione CLI: Riferimento CLI → "Test traduzioni mancanti". Così come la guida Testing.

Novità: autoFill globale per completare le traduzioni mancanti

Ora puoi abilitare l'auto‑fill globalmente in modo che qualsiasi dizionario con traduzioni mancanti venga completato automaticamente.

import { type IntlayerConfig, Locales } from "intlayer";

const config: IntlayerConfig = {
  internationalization: {
    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
    defaultLocale: Locales.ENGLISH,
    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
  },
  content: {
    // Genera automaticamente le traduzioni mancanti per tutti i dizionari
    autoFill: "./{{fileName}}.content.ts",
    //
    // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
    //
    // autoFill: true, // genera automaticamente le traduzioni mancanti per tutti i dizionari come usando "./{{fileName}}.content.json"
    //
    // autoFill: {
    //   en: "./{{fileName}}.en.content.json",
    //   fr: "./{{fileName}}.fr.content.json",
    //   es: "./{{fileName}}.es.content.json",
    // },
  },
};

export default config;

Puoi ancora perfezionare per dizionario utilizzando il campo autoFill nei file di contenuto. Consulta la documentazione completa in doc/autoFill e doc/dictionary/content_file.

Puoi comunque affinare per dizionario utilizzando il campo autoFill nei file di contenuto. Intlayer considererà prima la configurazione per dizionario e poi farà un fallback alla configurazione globale. Consulta il riferimento completo in Auto-fill e Riferimento file di contenuto.

Comando fill: impostazioni predefinite più sicure

Il comando fill ora, per impostazione predefinita, riempie solo le traduzioni mancanti e salta il contenuto esistente.

npx intlayer fill

Chiavi del dizionario interessate per l'elaborazione: access-key-creation-form-schema, doc-search-metadata, doc-search-page
  - [access-key-creation-form-schema]      Il dizionario non ha un percorso file. Saltando.
  - [access-key-creation-form-schema]      Elaborazione della dichiarazione di contenuto: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts
  - [access-key-creation-form-schema]      Nessuna locale da riempire - Dizionario saltato
  - [doc-search-metadata]                  Il dizionario non ha un percorso file. Saltato.
  - [doc-search-metadata]                  Elaborazione della dichiarazione di contenuto: src/app/[locale]/(docs)/doc/search/metadata.content.ts
  - [doc-search-metadata]                  Nessuna localizzazione da riempire - Dizionario saltato
  - [doc-search-page]                      Il dizionario non ha un percorso file. Saltato.
  - [doc-search-page]                      Elaborazione della dichiarazione di contenuto: src/app/[locale]/(docs)/doc/search/page.content.ts
  - [doc-search-page]                     [Russo (ru)]                   Preparazione della traduzione per il dizionario da Inglese (en) a Russo (ru)
[intlayer]  Applicata la formattazione Prettier a src/app/[locale]/(docs)/doc/search/page.content.ts
  - [doc-search-page]                      Dichiarazione di contenuto scritta in src/app/[locale]/(docs)/doc/search/page.content.ts

Esempi di CI sono disponibili in CI/CD.

Estensione VS Code aggiornata

L'estensione ora include una scheda Intlayer dedicata nella Barra delle Attività e diversi miglioramenti del flusso di lavoro:

• Barra delle Attività Intlayer con due viste:
  • Webview di ricerca (intlayer.searchBar) per la ricerca live nel dizionario/contenuto
  • Albero dei dizionari (intlayer.dictionaries) che elenca ambienti, dizionari e file contributori
• Barra degli strumenti nella vista Dizionari: Build, Pull, Push, Fill, Refresh, Test, Create Dictionary File
• Menu contestuali: Pull/Push sui dizionari; Fill sui file
• Rilevamento automatico: il file corrente nell'editor è evidenziato nell'albero dei Dizionari quando applicabile
• Nuovi comandi disponibili dalla Command Palette: Riempi Dizionari e Testa Dizionari

Consulta i dettagli nella documentazione della Estensione Ufficiale per VS Code.

Aggiornato il server MCP per supportare le nuove funzionalità.

• Compilazione automatica
• Test delle traduzioni mancanti
• Aggiornamenti in tempo reale
• Logging
• Validazione
• Note sulla migrazione
• Documentazione

Il server MCP aiuta nell'automazione dei progetti che utilizzano Intlayer. Verifica le traduzioni mancanti per il codice autogenerato. Aiuta a comprendere la tua configurazione e incorpora la documentazione di Intlayer nel tuo IDE.

Prestazioni: 10× più veloce

• Risoluzione parallela dei dizionari locali e remoti
• I dizionari remoti sono memorizzati nella cache per evitare di essere recuperati nuovamente all'avvio dell'app

npx intlayer build

Output:

[intlayer]  Preparazione di Intlayer (v6.0.1)
[intlayer]  Dizionari:
[intlayer]  ✓ Contenuto locale: 163/163
[intlayer]  ✓ Contenuto remoto: 100/100
[intlayer]   - access-key-creation-form             [locale: ✔ costruito] [remoto: ✔ importato]
[intlayer]   - access-key-creation-form-schema      [local: ✔ built] [distant: ✔ imported]
[intlayer]   - access-key-form                      [local: ✔ built] [distant: ✔ imported]
[intlayer]   - ai-ab-testing-section                                 [distant: ✔ imported]
[intlayer]   - application-not-running-view         [local: ✔ built] [distant: ✔ imported]
[intlayer]   - application-template-message         [local: ✔ built] [distant: ✔ fetched]
[intlayer]   - aside-navigation                     [local: ✔ built] [distant: ✔ imported]
[intlayer]   - ask-reset-password                   [local: ✔ built] [distant: ✔ imported]
[intlayer]   - ask-reset-password-schema            [local: ✔ built] [distant: ✔ imported]
[intlayer]   - sezione-autocompletamento               [local: ✔ built] [distant: ✔ fetched]
[intlayer]   - sezione-tecnologie-disponibili           [local: ✔ built] [distant: ✔ imported]
[intlayer]   - dati-blog                               [local: ✔ built]
[intlayer]   - metadati-blog                           [local: ✔ built]
[intlayer]   - lista-navigazione-blog                   [local: ✔ built] [distant: ✔ imported]
[intlayer]   - pagina-blog                                             [distant: ✔ fetched]
[intlayer]   - metadati-ricerca-blog                    [local: ✔ built] [distant: ✔ imported]
[intlayer]   - pagina-ricerca-blog                      [local: ✔ built] [distant: ✔ imported]
...
[intlayer]  Contenuto caricato  (Totale: 8401ms - Locale: 4050ms - Remoto: 4222ms)

Miglioramenti al sistema di logging

Il sistema di logging è stato migliorato per fornire informazioni più dettagliate su ciò che accade durante le trasformazioni in fase di build e runtime.

Abilita i log dettagliati per comprendere meglio cosa accade durante le trasformazioni in fase di build e runtime.

export default {
  log: {
    mode: "verbose", // opzioni: "default" | "verbose" | "disabled"
  },
};

Consulta la Configurazione per tutte le opzioni di logging.

Validazione più rigorosa

Il processo di gestione dei dizionari ora esegue una validazione più robusta. Quando un dizionario non riesce a essere processato, Intlayer evita di interrompere la tua applicazione e mostra errori azionabili.

Aggiornamenti live con CMS (Sicuro per la produzione)

Fornisci aggiornamenti di contenuto in tempo reale (ad esempio, aggiornamenti editoriali) in produzione senza ricostruire la tua applicazione.

1. Abilita la modalità di importazione live:

import { type IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  build: {
    importMode: "fetch", // "static" | "dynamic" | "live"
  },
  editor: {
    liveSync: true, // abilita la sincronizzazione live lato server
  },
};

export default config;

2. Esegui la tua app e il processo live affiancati:

npx intlayer live --with 'vite preview'

Note:

• Solo i dizionari contrassegnati per usare la modalità live saranno recuperati in tempo reale. Gli altri sono ottimizzati per le prestazioni.
• Torna all'importazione dinamica se l'API live non è raggiungibile.

Vedi CMS e Live Sync e Configurazione per una guida completa.

Processo parallelo per monitorare i file su turbopack

Quando si utilizza Turbopack su Next.js 14 e versioni successive come server di sviluppo con il comando next dev --turbopack, le modifiche al dizionario non verranno rilevate automaticamente per impostazione predefinita.

Questa limitazione si verifica perché Turbopack non può eseguire plugin webpack in parallelo per monitorare le modifiche nei file di contenuto.

Per aggirare questo problema, abbiamo utilizzato il comando intlayer watch, usando l'opzione --with per eseguire contemporaneamente sia il server di sviluppo che il watcher di build di Intlayer.

{
  "scripts": {
    "dev": "npx intlayer watch --with 'next dev --turbopack'",
  },
}

Note sulla migrazione

• Rimosso: dictionaryOutput (precedentemente i18next o next-intl). Tornerà come adattatori pluggabili nelle versioni future. Rimuovi il campo dalla tua configurazione.
• Rimozione correlata: i18nextResourcesDir (vedi changelog in doc/configuration).
• Preferisci la nuova opzione globale content.autoFill per generare traduzioni mancanti su larga scala.
• Usa npx intlayer content test per bloccare le PR in caso di traduzioni mancanti.
• Per una diagnostica dettagliata, imposta log.mode = 'verbose'.

Correzioni

• Stabilità dell'integrazione con Vue.js
• Miglioramenti all'adattatore Lynx
• Editor Visivo su Windows

Note sulla migrazione da v6 a v7

Consulta le note sulla migrazione da v6 a v7 per ulteriori informazioni.

Link utili

• Riferimento CLI
• Compilazione automatica
• Configurazione
• Riferimento file di contenuto
• Estensione ufficiale per VS Code
• CMS e Sincronizzazione Live