@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/it/autoFill.md

@@ -25,8 +25,56 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Inizializzazione cronologia"
+author: aymericzip
 ---
 
+# Riempi le traduzioni dei file di dichiarazione del contenuto
+
+**L'autofill dei file di dichiarazione del contenuto** nella tua CI è un modo per accelerare il tuo workflow di sviluppo.
+
+## Comprensione del comportamento
+
+Il comando `fill` include due modalità:
+
+- **Complete**: Riempie automaticamente tutti i contenuti mancanti per ogni locale e modifica il file corrente, o un altro file se specificato. In altre parole, la modalità complete salterà la traduzione dei contenuti già esistenti, se già tradotti.
+- **Review**: Riempie automaticamente **tutti** i contenuti per ogni locale e genera per un file specifico, o un altro file se specificato.
+
+Il comando will elaborerà tutti i file di dichiarazione del contenuto locale. In altre parole, non elaborerà i tuoi contenuti remoti dal CMS. Il CMS include la propria gestione delle traduzioni.
+Se utilizzi plugin come `@intlayer/sync-json-plugin`, Intlayer trasformerà i file JSON in file di dichiarazione del contenuto locale. In altre parole, verranno elaborati dal comando `fill`.
+
+I nuovi file generati includono un'istruzione `filled` come metadati del dizionario. Questa istruzione verrà utilizzata da Intlayer per sapere se il file è stato riempito automaticamente o meno, e saltare questo file dalla traduzione nuovamente se presente.
+
+Intlayer considererà anche le seguenti istruzioni per il riempimento automatico:
+
+- Dal tuo `.content.{ts|js|json}` → istruzione `fill`
+- Dal tuo file di configurazione `.intlayer.config.ts` → istruzione `dictionary.fill`
+- Verrà impostato su `true` per impostazione predefinita altrimenti
+
+Per i file di dichiarazione del contenuto per locale, l'istruzione `true` verrà sostituita da `./{{fileName}}.fill.content.json`. Questo è perché un file di dichiarazione del contenuto per locale non può ricevere contenuti localizzati aggiuntivi. Quindi genererà un nuovo file per non sovrascrivere il file esistente.
+
+## Comportamento Predefinito
+
+Per impostazione predefinita, `fill` è impostato su `true` a livello globale, il che significa che Intlayer compilerà automaticamente tutti i file di contenuto e modificherà il file stesso. Questo comportamento può essere personalizzato in diversi modi:
+
+### Opzioni di Configurazione Globale
+
+1. **`fill: true` (default)** - Riempie automaticamente tutte le locale e modifica il file corrente
+2. **`fill: false`** - Disabilita il riempimento automatico per questo file di contenuto
+3. **`fill: "./relative/path/to/file"`** - Crea/aggiorna il file specificato senza modificare quello corrente puntando a un percorso relativo risolto in base alla posizione del file corrente
+4. **`fill: "/absolute/path/to/file"`** - Crea/aggiorna il file specificato senza modificare quello corrente puntando a un percorso relativo risolto in base alla posizione della directory base (campo `baseDir` nel file di configurazione `.intlayer.config.ts`)
+5. **`fill: "C:\\absolute\path\to\file"`** - Crea/aggiorna il file specificato senza modificare quello corrente puntando a un percorso assoluto risolto in base al tuo sistema operativo
+6. **`fill: { [key in Locales]?: string }`** - Crea/aggiorna il file specificato per ogni locale
+
+### Modifiche di comportamento in v7
+
+In v7, il comportamento del comando `fill` è stato aggiornato:
+
+- **`fill: true`** - Riscrive il file corrente con il contenuto compilato per tutte le lingue
+- **`fill: "path/to/file"`** - Compila il file specificato senza modificare il file corrente
+- **`fill: false`** - Disabilita completamente l'auto-compilazione
+
+Quando si utilizza un'opzione di percorso per scrivere in un altro file, il meccanismo di compilazione funziona attraverso una relazione _master-slave_ tra i file di dichiarazione del contenuto. Il file principale (master) funge da fonte di verità, e quando viene aggiornato, Intlayer applicherà automaticamente tali modifiche ai file di dichiarazione derivati (compilati) specificati dal percorso.
+
 # Traduzioni dei File di Dichiarazione del Contenuto con Compilazione Automatica
 
 I **file di dichiarazione del contenuto con compilazione automatica** sono un modo per velocizzare il tuo flusso di lavoro di sviluppo.
@@ -87,6 +135,40 @@ Intlayer genererà automaticamente il file di dichiarazione derivato in `src/com
 
 Successivamente, entrambi i file di dichiarazione saranno uniti in un unico dizionario, accessibile tramite il consueto hook `useIntlayer("example")` (react) / composable (vue).
 
+## Configurazione Globale
+
+Puoi configurare la configurazione di riempimento automatico globale nel file `intlayer.config.ts`.
+
+```ts fileName="intlayer.config.ts"
+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],
+  },
+  dictionary: {
+    // Genera automaticamente le traduzioni mancanti per tutti i dizionari
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // genera automaticamente le traduzioni mancanti per tutti i dizionari come se usassi "./{{fileName}}.content.json"
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+Puoi comunque mettere a punto per singolo dizionario utilizzando il campo `fill` nei file di contenuto. Intlayer considererà prima la configurazione per singolo dizionario e poi ricorrerà alla configurazione globale.
+
 ## Formato del File Compilato Automaticamente
 
 Il formato consigliato per i file di dichiarazione compilati automaticamente è **JSON**, che aiuta a evitare vincoli di formattazione. Tuttavia, Intlayer supporta anche i formati `.ts`, `.js`, `.mjs`, `.cjs` e altri.

package/docs/it/benchmark/index.md

@@ -17,6 +17,7 @@ history:
   - version: 8.7.5
     date: 2026-01-06
     changes: "Inizializzazione benchmark"
+author: aymericzip
 ---
 
 # Benchmark - Rapporto

package/docs/it/benchmark/nextjs.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - nextjs
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
   - version: 8.9.8

package/docs/it/benchmark/solid.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - solid
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
 history:
   - version: 8.9.8
@@ -118,6 +118,28 @@ Abbiamo confrontato **quattro strategie di caricamento**:
 - **Scoped static**: Mantiene il codice organizzato (separazione logica) senza complesse richieste di rete extra.
 - **Scoped dynamic**: Il miglior approccio per il _code splitting_ e le prestazioni. Minimizza la memoria caricando solo ciò di cui la vista corrente e la lingua attiva hanno bisogno.
 
+### Ciò che ho misurato:
+
+Ho eseguito la stessa app multilingue in un vero browser per ogni stack, quindi ho annotato ciò che è effettivamente apparso sulla rete e quanto tempo ha impiegato. Le dimensioni sono riportate **dopo la normale compressione web**, perché è più vicino a ciò che le persone scaricano rispetto ai conteggi grezzi delle sorgenti.
+
+- **Internationalization library size**: Dopo il bundling, tree-shaking e minification, la dimensione della libreria i18n è la dimensione dei provider + codice hooks/primitives in un componente vuoto. Non include il caricamento dei file di traduzione. Risponde a quanto è costosa la libreria prima che il tuo contenuto entri in gioco.
+
+- **JavaScript per page**: Per ogni rotta di benchmark, quanti script il browser scarica per quella visita, mediati tra le pagine della suite (e tra le lingue dove il rapporto le raggruppa). Le pagine pesanti sono pagine lente.
+
+- **Leakage from other locales**: È il contenuto della stessa pagina ma in un'altra lingua che verrebbe caricato per errore nella pagina sottoposta a audit. Questo contenuto è inutile e dovrebbe essere evitato. (ad es. contenuto della pagina `/fr/about` nel bundle della pagina `/en/about`)
+
+- **Leakage from other routes**: La stessa idea per **altri schermi** nell'app: se la loro copia si carica insieme quando hai aperto solo una pagina. (ad es. contenuto della pagina `/en/about` nel bundle della pagina `/en/contact`). Un punteggio elevato suggerisce uno splitting debole o bundle troppo ampi.
+
+- **Average component bundle size**: I pezzi UI comuni sono misurati **uno alla volta** invece di nascondersi in un numero gigante dell'app. Mostra se l'internazionalizzazione aumenta silenziosamente i componenti quotidiani. Ad esempio, se il tuo componente viene ripetuto, caricherà tutti i dati dalla memoria. Allegare un giant JSON a qualsiasi componente è come collegare un grande archivio di dati non utilizzati che rallenterà le prestazioni dei tuoi componenti.
+
+- **Language switch responsiveness**: Cambio la lingua usando il controllo dell'app e cronometro quanto tempo ci vuole prima che la pagina sia chiaramente cambiata, quello che un visitatore noterebbe, non un micro-step di laboratorio.
+
+- **Rendering work after a language change**: Un follow-up più mirato: quanto sforzo ha richiesto all'interfaccia di ridipingere per la nuova lingua una volta che lo switch è in volo. Utile quando il tempo "percepito" e il costo del framework divergono.
+
+- **Initial page load time**: Dalla navigazione al browser che considera la pagina completamente caricata per gli scenari che ho testato. Buono per confrontare i cold start.
+
+- **Hydration time**: Quando l'app lo espone, quanto tempo il client spende a trasformare l'HTML del server in qualcosa su cui puoi effettivamente fare clic. Un trattino nelle tabelle significa che quella implementazione non ha fornito una figura di hydration affidabile in questo benchmark.
+
 ## Stelle di GitHub
 
 Le stelle di GitHub sono un forte indicatore della popolarità di un progetto, della fiducia della comunità e della pertinenza a lungo termine. Sebbene non siano una misura diretta della qualità tecnica, riflettono quanti sviluppatori trovano il progetto utile, ne seguono i progressi e sono propensi ad adottarlo. Per stimare il valore di un progetto, le stelle aiutano a confrontare la trazione tra le alternative e forniscono approfondimenti sulla crescita dell'ecosistema.

package/docs/it/benchmark/svelte.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - svelte
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
   - version: 8.9.8
@@ -116,6 +116,28 @@ Abbiamo confrontato **quattro strategie di caricamento**:
 - **Scoped static**: Mantiene il codice organizzato (separazione logica) senza complesse richieste di rete extra.
 - **Scoped dynamic**: Il miglior approccio per il _code splitting_ e le prestazioni. Minimizza la memoria caricando solo ciò di cui la vista corrente e la lingua attiva hanno bisogno.
 
+### Cosa ho misurato:
+
+Ho eseguito la stessa app multilingue in un vero browser per ogni stack, quindi ho annotato cosa è effettivamente apparso sulla rete e quanto tempo ci è voluto. Le dimensioni sono riportate **dopo la normale compressione web**, perché è più vicino a quello che le persone scaricano rispetto ai conteggi del codice sorgente grezzo.
+
+- **Dimensione della libreria di internazionalizzazione**: Dopo il bundling, il tree-shaking e la minificazione, la dimensione della libreria i18n è la dimensione del codice dei provider + store in un componente vuoto. Non include il caricamento dei file di traduzione. Risponde a quanto è costosa la libreria prima che il tuo contenuto entri in gioco.
+
+- **JavaScript per pagina**: Per ogni route di benchmark, quanto script il browser estrae per quella visita, in media nelle pagine della suite (e tra i locale dove il rapporto li raggruppa). Le pagine pesanti sono pagine lente.
+
+- **Perdita da altri locale**: È il contenuto della stessa pagina ma in un'altra lingua che verrebbe caricato per errore nella pagina controllata. Questo contenuto è non necessario e dovrebbe essere evitato. (ad es. il contenuto della pagina `/fr/about` nel bundle della pagina `/en/about`)
+
+- **Perdita da altri percorsi**: La stessa idea per **altri schermi** nell'app: se il loro contenuto viene trasportato quando hai aperto solo una pagina. (ad es. il contenuto della pagina `/en/about` nel bundle della pagina `/en/contact`). Un punteggio alto suggerisce uno splitting debole o bundle troppo ampi.
+
+- **Dimensione media del bundle dei componenti**: I pezzi comuni dell'interfaccia utente vengono misurati **uno alla volta** invece di nascondersi in un gigantesco numero di app. Mostra se l'internazionalizzazione gonfia silenziosamente i componenti quotidiani. Ad esempio, se il tuo componente esegue il rerender, caricherà tutti quei dati dalla memoria. Allegare un JSON gigante a qualsiasi componente è come collegare un grande negozio di dati inutilizzati che rallenterà le prestazioni dei tuoi componenti.
+
+- **Reattività del cambio di lingua**: Cambio la lingua usando il controllo dell'app e cronometro quanto tempo impiega fino a quando la pagina non si è chiaramente cambiata, quello che un visitatore noterebbe, non un micro-step di laboratorio.
+
+- **Lavoro di rendering dopo un cambio di lingua**: Un seguito più ristretto: quanta fatica l'interfaccia ha impiegato per dipingere di nuovo per la nuova lingua una volta che il cambio è in corso. Utile quando il tempo "percepito" e il costo del framework divergono.
+
+- **Tempo di caricamento della pagina iniziale**: Dalla navigazione al browser considerando la pagina completamente caricata per gli scenari che ho testato. Buono per confrontare i cold start.
+
+- **Tempo di idratazione**: Quando l'app lo espone, quanto tempo il client impiega a trasformare l'HTML del server in qualcosa che puoi effettivamente cliccare. Un trattino nelle tabelle significa che quella implementazione non ha fornito una figura di idratazione affidabile in questo benchmark.
+
 ## Stelle di GitHub
 
 Le stelle di GitHub sono un forte indicatore della popolarità di un progetto, della fiducia della comunità e della pertinenza a lungo termine. Sebbene non siano una misura diretta della qualità tecnica, riflettono quanti sviluppatori trovano il progetto utile, ne seguono i progressi e sono propensi ad adottarlo. Per stimare il valore di un progetto, le stelle aiutano a confrontare la trazione tra le alternative e forniscono approfondimenti sulla crescita dell'ecosistema.

package/docs/it/benchmark/tanstack.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - tanstack
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
   - version: 8.9.8
@@ -124,6 +124,28 @@ Abbiamo confrontato **quattro strategie di caricamento**:
 - **Scoped static**: Mantiene il codice organizzato (separazione logica) senza requisiti di rete complessi.
 - **Scoped dynamic**: Il miglior approccio per il _code splitting_ e le prestazioni. Riduce al minimo la memoria caricando solo ciò di cui la vista corrente e la lingua attiva hanno bisogno.
 
+### Cosa ho misurato:
+
+Ho eseguito la stessa app multilingue in un vero browser per ogni stack, quindi ho annotato cosa è effettivamente apparso sulla rete e quanto tempo ha impiegato. Le dimensioni sono riportate **dopo la normale compressione web**, perché è più vicino a quello che le persone scaricano rispetto ai conteggi del codice sorgente grezzo.
+
+- **Dimensione della libreria di internazionalizzazione**: Dopo il bundling, tree-shaking e minification, la dimensione della libreria i18n è la dimensione dei provider (ad es. `NextIntlClientProvider`) + il codice degli hook (ad es. `useTranslations`) in un componente vuoto. Non include il caricamento dei file di traduzione. Risponde a quanto è costosa la libreria prima che il tuo contenuto entri in gioco.
+
+- **JavaScript per pagina**: Per ogni route di benchmark, quanto script il browser scarica in quella visita, mediato tra le pagine della suite (e tra le lingue dove il rapporto le raggruppa). Le pagine pesanti sono pagine lente.
+
+- **Perdita da altre lingue**: È il contenuto della stessa pagina ma in un'altra lingua che verrebbe caricato per errore nella pagina controllata. Questo contenuto è non necessario e dovrebbe essere evitato. (ad es. il contenuto della pagina `/fr/about` nel bundle della pagina `/en/about`)
+
+- **Perdita da altre route**: La stessa idea per **altri schermi** nell'app: se la loro copia viene trascinata quando apri solo una pagina. (ad es. il contenuto della pagina `/en/about` nel bundle della pagina `/en/contact`). Un punteggio alto suggerisce uno splitting debole o bundle troppo ampi.
+
+- **Dimensione media del bundle del componente**: I pezzi comuni dell'interfaccia utente vengono misurati **uno alla volta** invece di nascondersi all'interno di un numero gigante dell'app. Mostra se l'internazionalizzazione gonfia silenziosamente i componenti di tutti i giorni. Ad esempio, se il tuo componente si rirenderizza, caricherà tutti questi dati dalla memoria. Allegare un JSON gigante a qualsiasi componente è come collegare un grande archivio di dati inutilizzati che rallenterà le prestazioni dei tuoi componenti.
+
+- **Reattività del cambio di lingua**: Cambio la lingua usando il controllo dell'app e misuro quanto tempo impiega fino a quando la pagina non è chiaramente cambiata, quello che un visitatore noterebbe, non un micro-step di laboratorio.
+
+- **Lavoro di rendering dopo un cambio di lingua**: Un follow-up più ristretto: quanto sforzo ha impiegato l'interfaccia per ridisegnare la nuova lingua una volta che lo switch è in volo. Utile quando il tempo "percepito" e il costo del framework divergono.
+
+- **Tempo di caricamento iniziale della pagina**: Dalla navigazione al browser che considera la pagina completamente caricata per gli scenari che ho testato. Buono per confrontare i cold start.
+
+- **Tempo di idratazione**: Quando l'app lo espone, quanto tempo il client spende a trasformare l'HTML del server in qualcosa su cui puoi effettivamente fare clic. Un trattino nelle tabelle significa che l'implementazione non ha fornito una cifra di idratazione affidabile in questo benchmark.
+
 ## Stelle di GitHub
 
 Le stelle di GitHub sono un forte indicatore della popolarità di un progetto, della fiducia della comunità e della pertinenza a lungo termine. Sebbene non siano una misura diretta della qualità tecnica, riflettono quanti sviluppatori trovano il progetto utile, ne seguono i progressi e sono propensi ad adottarlo. Per stimare il valore di un progetto, le stelle aiutano a confrontare la trazione tra le alternative e forniscono approfondimenti sulla crescita dell'ecosistema.

package/docs/it/benchmark/vue.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - vue
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
   - version: 8.9.8

package/docs/it/bundle_optimization.md

@@ -22,6 +22,7 @@ history:
   - version: 8.7.0
     date: 2026-04-08
     changes: "Aggiunte le opzioni `minify` e `purge` alla configurazione di build"
+author: aymericzip
 ---
 
 # Ottimizzazione delle dimensioni e delle prestazioni del bundle i18n
@@ -396,11 +397,11 @@ export default config;
 
 ### Opzioni di Build
 
-| Proprietà      | Tipo                   | Default     | Descrizione                                                                                                                                                                                                  |
-| :------------- | :--------------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`optimize`** | `boolean \| undefined` | `undefined` | Abilita il passaggio di riscrittura degli import. `undefined` = attivo solo nelle build di produzione. `false` disabilita anche purge e minify.                                                              |
-| **`minify`**   | `boolean`              | `false`     | Rinomina chiavi dei campi di contenuto nei file JSON compilati usando brevi alias alfabetici. Riscrive anche gli accessi a tali proprietà nel codice sorgente. Non ha alcun effetto se `optimize` è `false`. |
-| **`purge`**    | `boolean`              | `false`     | Rimuove i campi di contenuto a cui non si accede mai in modo statico dal codice sorgente all'interno dei file JSON. Non ha alcun effetto se `optimize` è `false`.                                            |
+| Proprietà      | Tipo                  | Default     | Descrizione                                                                                                                                                                                                  |
+| :------------- | :-------------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`optimize`** | `boolean / undefined` | `undefined` | Abilita il passaggio di riscrittura degli import. `undefined` = attivo solo nelle build di produzione. `false` disabilita anche purge e minify.                                                              |
+| **`minify`**   | `boolean`             | `false`     | Rinomina chiavi dei campi di contenuto nei file JSON compilati usando brevi alias alfabetici. Riscrive anche gli accessi a tali proprietà nel codice sorgente. Non ha alcun effetto se `optimize` è `false`. |
+| **`purge`**    | `boolean`             | `false`     | Rimuove i campi di contenuto a cui non si accede mai in modo statico dal codice sorgente all'interno dei file JSON. Non ha alcun effetto se `optimize` è `false`.                                            |
 
 ### Minificazione (ridenominazione chiave dei campi)
 

package/docs/it/cli/build.md

@@ -17,6 +17,7 @@ history:
   - version: 8.1.5
     date: 2026-02-23
     changes: "Aggiungi opzione checkTypes"
+author: aymericzip
 ---
 
 # Costruire Dizionari

package/docs/it/cli/ci.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.11
     date: 2026-01-06
     changes: "Aggiungere comando CI"
+author: aymericzip
 ---
 
 # Comando CI
@@ -139,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## GitHub Actions scaffoldati
+
+Quando esegui `intlayer init`, Intlayer rileva il tuo package manager (npm, yarn, pnpm, o bun) e scaffolda due workflow GitHub Actions in `.github/workflows/`, con comandi che corrispondono a quel package manager:
+
+- **`intlayer-fill.yml`** — Su ogni pull request, costruisce i dizionari ed esegue `intlayer fill --git-diff --mode complete` per generare le traduzioni mancanti per i dizionari modificati, quindi esegue il commit del risultato nel branch della PR.
+- **`intlayer-test.yml`** — Su ogni pull request, costruisce i dizionari ed esegue `intlayer test`, fallendo il check quando le locale richieste hanno traduzioni mancanti.
+
+I file di workflow esistenti non vengono mai sovrascritti. Per saltare completamente lo scaffolding, esegui:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Fornire accesso AI al workflow di fill
+
+Il file `intlayer-fill.yml` scaffoldato richiede accesso AI. Sono disponibili due opzioni (configurate nel blocco `env` del workflow):
+
+1. **La tua chiave di provider AI** — Aggiungi un secret `AI_API_KEY` nelle impostazioni del repository (Settings → Secrets and variables → Actions). Il workflow la inoltra tramite `--provider`, `--model`, e `--api-key`.
+2. **Chiavi di accesso Intlayer CMS** — Aggiungi i secret `INTLAYER_CLIENT_ID` e `INTLAYER_CLIENT_SECRET` e collegali alla sezione `editor` del tuo `intlayer.config`. Le chiavi di accesso CMS concedono accesso AI tramite il backend di Intlayer.
+
+Il workflow `intlayer-test.yml` non richiede alcun accesso AI.
+
 ## Gestione degli errori
 
 - Se `INTLAYER_PROJECT_CREDENTIALS` non è impostata, il comando terminerà con un errore.

package/docs/it/cli/configuration.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - configuration
+author: aymericzip
 ---
 
 # Gestire la Configurazione

package/docs/it/cli/debug.md

@@ -13,6 +13,7 @@ slugs:
   - concept
   - cli
   - debug
+author: aymericzip
 ---
 
 # Debug del comando intlayer

package/docs/it/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Revisione Documento
 description: Scopri come revisionare i file di documentazione per qualità, coerenza e completezza tra diverse localizzazioni.
 keywords:
@@ -15,6 +15,11 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Aggiunta opzione --log"
+author: aymericzip
 ---
 
 # Revisione Documento
@@ -54,8 +59,110 @@ Per la maggior parte dei casi d'uso,
 
 ## Argomenti:
 
-Il comando `doc review` accetta gli stessi argomenti di `doc translate`, permettendoti di revisionare file di documentazione specifici e applicare controlli di qualità.
+**Opzioni lista file:**
 
-Se hai attivato una delle opzioni git, il comando revisionerà solo la parte dei file che viene modificata. Lo script processerà il file suddividendolo in chunk e revisionerà ogni chunk. Se non ci sono modifiche nel chunk, lo script lo salterà per velocizzare il processo di revisione e limitare il costo dell'API del provider AI.
+- **`--doc-pattern [docPattern...]`**: Pattern glob per selezionare i file di documentazione da revisionare.
 
-Per un elenco completo degli argomenti, consulta la documentazione del comando [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/doc-translate.md).
+  > Esempio: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Pattern glob da escludere dalla revisione.
+
+  > Esempio: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Salta il file se è stato modificato prima del tempo indicato.
+  - Può essere un tempo assoluto como "2025-12-05" (stringa o Date)
+  - Può essere un tempo relativo in ms `1 * 60 * 60 * 1000` (1 ora)
+  - Questa opzione controlla il tempo di aggiornamento del file usando il metodo `fs.stat`. Quindi potrebbe essere influenzata da Git o altri strumenti che modificano il file.
+
+  > Esempio: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Salta il file se è stato modificato entro il tempo indicato.
+  - Può essere un tempo assoluto como "2025-12-05" (stringa o Date)
+  - Può essere un tempo relativo in ms `1 * 60 * 60 * 1000` (1 ora)
+  - Cette opzione controlla il tempo di aggiornamento del file usando il metodo `fs.stat`. Quindi potrebbe essere influenzata da Git o altri strumenti che modificano il file.
+
+  > Esempio: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Salta il file se esiste già.
+
+  > Esempio: `npx intlayer doc review --skip-if-exists`
+
+**Opzioni di modalità di revisione:**
+
+- **`--log`**: Modalità solo log. Non traduce con l'IA; registra invece i blocchi che richiedono attenzione (con numeri di riga e contenuto) per i locali base e target, per aiutare un altro agente a generare le traduzioni.
+
+  > Esempio: `npx intlayer doc review --log`
+
+**Opzioni di output delle voci:**
+
+- **`--locales [locales...]`**: Locales di destinazione per revisionare la documentazione.
+
+  > Esempio: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Locale sorgente (documento base) con cui confrontare.
+
+  > Esempio: `npx intlayer doc review --base-locale en`
+
+**Opzioni di elaborazione dei file:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Numero di file da processare simultaneamente per la revisione.
+
+  > Esempio: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Opzioni AI:**
+
+- **`--model [model]`**: Il modello AI da utilizzare per la revisione (es. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Il provider AI da utilizzare per la revisione.
+- **`--temperature [temperature]`**: Impostazione della temperatura per il modello AI.
+- **`--api-key [apiKey]`**: Fornisci la tua chiave API per il servizio AI.
+- **`--application-context [applicationContext]`**: Fornisci un contesto aggiuntivo per la revisione AI.
+- **`--data-serialization [dataSerialization]`**: Il formato di serializzazione dei dati da utilizzare per le funzionalità AI di Intlayer. Opzioni: `json` (standard, affidabile), `toon` (meno token, meno coerente).
+- **`--custom-prompt [prompt]`**: Personalizza il prompt base utilizzato per la revisione. (Nota: per la maggior parte dei casi d'uso, si consiglia invece l'opzione `--custom-instructions` in quanto offre un controllo migliore.)
+
+  > Esempio: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "La mia applicazione è un negozio di gatti"`
+
+**Opzioni variabili d'ambiente:**
+
+- **`--env`**: Specifica l'ambiente (es. `development`, `production`).
+- **`--env-file [envFile]`**: Fornisce un file ambiente personalizzato da cui caricare le variabili.
+- **`--base-dir`**: Specifica la directory base per il progetto.
+- **`--no-cache`**: Disabilita la cache.
+
+  > Esempio: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Opzioni di log:**
+
+- **`--verbose`**: Abilita il logging dettagliato per il debugging. (impostazione predefinita a true usando la CLI)
+
+  > Esempio: `npx intlayer doc review --verbose`
+
+**Opzioni istruzioni personalizzate:**
+
+- **`--custom-instructions [customInstructions]`**: Istruzioni personalizzate aggiunte al prompt. Utile per applicare regole specifiche riguardo al formato, alla traduzione degli URL, ecc.
+
+  > Esempio: `npx intlayer doc review --custom-instructions "Evita di tradurre gli URL e mantieni il formato markdown"`
+
+  > Esempio: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Opzioni Git:**
+
+- **`--git-diff`**: Esegui solo sui file che includono modifiche dalla base (predefinita `origin/main`) al branch corrente (predefinito: `HEAD`).
+- **`--git-diff-base`**: Specifica il riferimento base per il git diff (predefinito `origin/main`).
+- **`--git-diff-current`**: Specifica il riferimento corrente per il git diff (predefinito `HEAD`).
+- **`--uncommitted`**: Includi le modifiche non committate.
+- **`--unpushed`**: Includi le modifiche non pushate.
+- **`--untracked`**: Includi i file non tracciati.
+
+  > Esempio: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Esempio: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Nota che il percorso del file di output sarà determinato sostituendo i seguenti pattern:
+>
+> - `/{{baseLocale}}/` con `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` con `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` con `_{{locale}}.`
+> - `{{baseLocale}}_` con `{{locale}}_`
+> - `.{{baseLocaleName}}.` con `.{{localeName}}.`
+>
+> Se il pattern non viene trovato, il file di output aggiungerà `.{{locale}}` all'estensione del file. `./my/file.md` sarà revisionato e aggiornato in `./my/file.fr.md` per la localizzazione francese.

package/docs/it/cli/doc-translate.md

@@ -15,6 +15,7 @@ slugs:
   - concept
   - cli
   - doc-translate
+author: aymericzip
 ---
 
 # Traduci Documento

package/docs/it/cli/editor.md

@@ -13,6 +13,7 @@ slugs:
   - concept
   - cli
   - editor
+author: aymericzip
 ---
 
 # Comandi dell'editor

package/docs/it/cli/extract.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - extract
+author: aymericzip
 ---
 
 # Estrai stringhe

package/docs/it/cli/fill.md

@@ -16,6 +16,7 @@ slugs:
   - concept
   - cli
   - fill
+author: aymericzip
 ---
 
 # Riempire / controllare / tradurre dizionari
@@ -46,6 +47,14 @@ Punti chiave:
 - Preserva le traduzioni esistenti non sovrascrivendole.
 - Elabora file, parti e locali in parallelo utilizzando un sistema di code per aumentare la velocità.
 
+## Punti Chiave:
+
+- Divide i file JSON di grandi dimensioni in chunk per rispettare i limiti della finestra di contesto del modello di IA.
+- Riprova la traduzione se il formato dell'output è errato.
+- Incorpora il contesto specifico dell'applicazione e del file per migliorare l'accuratezza della traduzione.
+- Preserva le traduzioni esistenti senza sovrascriverle.
+- Elabora file, chunk e locale in parallelo utilizzando un sistema di queue per aumentare la velocità.
+
 ## Alias:
 
 - `npx intlayer dictionaries fill`

package/docs/it/cli/index.md

@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.0.0
+    date: 2026-06-11
+    changes: "Aggiunto comando scan"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Aggiunto comando standalone"
@@ -62,6 +65,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Inizializzazione cronologia"
+author: aymericzip
 ---
 
 # CLI di Intlayer - Tutti i comandi della CLI di Intlayer per il tuo sito web multilingue
@@ -162,6 +166,10 @@ Per vedere come configurare le lingue disponibili o altri parametri, fai riferim
 
 - **[Comando CI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/ci.md)** - Esegui i comandi di Intlayer con credenziali auto-iniettate per le pipeline CI/CD
 
+### Controllo & Diagnostica
+
+- **[Scansiona il sito web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/scan.md)** - Misura la dimensione della pagina e controlla la salute i18n/SEO di qualsiasi URL pubblico
+
 ### Strumenti di sviluppo
 
 - **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/sdk.md)** - Usa l'SDK della CLI di Intlayer nel tuo codice
@@ -184,7 +192,8 @@ Per vedere come configurare le lingue disponibili o altri parametri, fai riferim
   "intlayer:extract": "npx intlayer extract",
   "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
-  "intlayer:doc:review": "npx intlayer doc review"
+  "intlayer:doc:review": "npx intlayer doc review",
+  "intlayer:scan": "npx intlayer scan https://example.com"
 }
 ```
 

package/docs/it/cli/init.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.9
     date: 2025-12-30
     changes: "Aggiunto comando init"
+author: aymericzip
 ---
 
 # Inizializza Intlayer

package/docs/it/cli/list.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.11
     date: 2026-01-06
     changes: "Aggiunta opzione di output JSON al comando list"
+author: aymericzip
 ---
 
 # Elencare i file di dichiarazione del contenuto

package/docs/it/cli/list_projects.md

@@ -18,6 +18,7 @@ history:
   - version: 7.5.12
     date: 2026-01-06
     changes: "Aggiungere opzione di output assoluto al comando list projects"
+author: aymericzip
 ---
 
 # Elencare i progetti Intlayer

package/docs/it/cli/live.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - live
+author: aymericzip
 ---
 
 # Comandi Live Sync

package/docs/it/cli/login.md

@@ -15,6 +15,7 @@ slugs:
   - concept
   - cli
   - login
+author: aymericzip
 ---
 
 # Comando Login CLI di Intlayer

package/docs/it/cli/pull.md

@@ -15,6 +15,7 @@ slugs:
   - concept
   - cli
   - pull
+author: aymericzip
 ---
 
 # Estrazione Dizionari Remoti

package/docs/it/cli/push.md

@@ -15,6 +15,7 @@ slugs:
   - concept
   - cli
   - push
+author: aymericzip
 ---
 
 # Push Dizionari