@intlayer/docs 9.4.4 → 9.5.0

package/docs/it/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # CLI di Intlayer - Tutti i comandi della CLI di Intlayer per il tuo sito web multilingue
 
----
-
 ## Sommario
 
 <TOC/>
 
----
-
 ## Installazione del pacchetto
 
 Installa i pacchetti necessari utilizzando npm:

package/docs/it/cli/login.md

@@ -20,8 +20,6 @@ author: aymericzip
 
 # Comando Login CLI di Intlayer
 
----
-
 ## Descrizione
 
 Il comando `login` della CLI di Intlayer ti consente di autenticarti con il CMS di Intlayer. Questo comando apre automaticamente il tuo browser predefinito per completare il processo di autenticazione e ricevere le credenziali necessarie (Client ID e Client Secret) per utilizzare i servizi di Intlayer.

package/docs/it/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-06-23
+updatedAt: 2026-09-08
 title: Compiler Intlayer | Estrazione automatica dei contenuti per i18n
 description: Automatizza il tuo processo di internazionalizzazione con il compilatore Intlayer. Estrai contenuti direttamente dai tuoi componenti per un i18n più veloce ed efficiente in Vite, Next.js e altro.
 keywords:
@@ -68,7 +68,7 @@ Come alternativa, per automatizzare il tuo processo i18n mantenendo il pieno con
 
 ## Utilizzo
 
-> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+> Il modo più rapido per collegare il compilatore è il setup interattivo: esegui `npx intlayer init --interactive` e seleziona **Compiler**. Su Next.js e Vite, si attiva automaticamente una volta impostato `compiler.enabled` e configurato un percorso `compiler.output`.
 
 <Tabs>
  <Tab value='vite'>
@@ -92,19 +92,13 @@ import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
+  plugins: [intlayer()],
 });
 ```
 
 > Il plugin standalone `intlayerCompiler()` è ancora esportato per configurazioni avanzate. Registrarlo insieme a `intlayer()` è sicuro — il compilatore si deduplica automaticamente ed esegue una sola volta.
 
-See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+See complete tutorial: [Translate Vite and React with Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react.md)
 
 #### Supporto per Framework
 
@@ -131,7 +125,33 @@ npm install @intlayer/svelte-compiler
  </Tab>
  <Tab value='nextjs'>
 
-### Next.js (Babel)
+### Next.js
+
+Su Next.js il compilatore funziona come bundler loader, `next-intlayer/extractor-loader`. `withIntlayer` lo registra per te **sia** su Turbopack che su webpack, non c'è alcun file `babel.config.js` da scrivere.
+
+#### Installazione
+
+```bash
+npm install @intlayer/babel
+```
+
+#### Configurazione
+
+Niente da configurare. Finché il tuo `next.config.ts` passa attraverso `withIntlayer`, l'installazione di `@intlayer/babel` è sufficiente per registrare il loader:
+
+```ts fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+
+export default withIntlayer({});
+```
+
+Il loader viene eseguito sui file `.tsx` e `.jsx`, prima di `next-swc-loader`, quindi legge il tuo JSX originale. Il contenuto dichiarato nei tuoi componenti viene estratto nei file `.content` e compilato in `.intlayer` man mano che il file viene compilato.
+
+</Tab>
+
+ <Tab value="Babel">
+
+### Babel
 
 Per Next.js o altre applicazioni basate su Webpack che utilizzano Babel, puoi configurare il compiler usando il plugin `@intlayer/babel`.
 
@@ -166,8 +186,6 @@ module.exports = {
 
 Questa configurazione garantisce che il contenuto dichiarato nei tuoi componenti venga estratto automaticamente e utilizzato per generare i dizionari durante il processo di build.
 
-See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
-
  </Tab>
 </Tabs>
 

package/docs/it/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 I file di configurazione di Intlayer consentono di personalizzare vari aspetti del plugin, come l'internazionalizzazione (i18n), il middleware e la gestione dei contenuti. Questo documento fornisce una descrizione dettagliata di ogni proprietà nella configurazione.
 
----
-
 ## Sommario
 
 <TOC/>
 
----
-
 ## Supporto File di Configurazione
 
 Intlayer accetta formati di file di configurazione JSON, JS, MJS e TS:
@@ -143,8 +139,6 @@ Intlayer accetta formati di file di configurazione JSON, JS, MJS e TS:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Esempio di File di Configurazione
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -699,14 +693,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Guida di Riferimento alla Configurazione
 
 Di seguito è riportata una descrizione dettagliata dei vari parametri di configurazione disponibili in Intlayer.
 
----
-
 ### Configurazione Internazionalizzazione (Internationalization)
 
 Definisce le impostazioni relative all'internazionalizzazione, inclusi i locale disponibili e il locale predefinito.
@@ -718,8 +708,6 @@ Definisce le impostazioni relative all'internazionalizzazione, inclusi i locale
 | `strictMode`      | Garantisce un'implementazione forte dei contenuti internazionalizzati utilizzando TypeScript. | `string`   | `'inclusive'`       |                      | • Se `"strict"`: La definizione di ogni locale dichiarato è obbligatoria per la funzione `t` - errore se mancante o non dichiarato.<br/>• Se `"inclusive"`: Avviso per i locale mancanti ma permette l'uso di locale esistenti non dichiarati.<br/>• Se `"loose"`: Accetta qualsiasi locale esistente. |
 | `defaultLocale`   | Locale predefinito utilizzato come fallback se il locale richiesto non è disponibile.         | `string`   | `Locales.ENGLISH`   | `'en'`               | Utilizzato per determinare il locale se non specificato nell'URL, nei cookie o negli header.                                                                                                                                                                                                           |
 
----
-
 ### Configurazione Editor (Editor)
 
 Definisce le impostazioni per l'editor visuale, incluse la porta del server e lo stato di abilitazione.
@@ -751,8 +739,6 @@ Gli analytics sono opt-out: sono abilitati per impostazione predefinita e inizia
 | `flushInterval` | Millisecondi tra gli invii automatici in batch al backend.                                             | `number`  | `20000`     | `10000` |                                                                                                                                                                                          |
 | `sampleRate`    | Frazione di sessioni da registrare, da `0` (nessuna) a `1` (tutte).                                    | `number`  | `1`         | `0.5`   | Il campionamento è deterministico per sessione, quindi una sessione registrata riporta tutti i suoi eventi (nessun funnel parziale).                                                     |
 
----
-
 ### Configurazione Routing (Routing)
 
 Impostazioni che controllano il comportamento del routing, inclusa la struttura dell'URL, lo storage del locale e la gestione del middleware.
@@ -954,8 +940,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### Configurazione Contenuto (Content)
 
 Impostazioni per come i contenuti sono gestiti nell'applicazione, inclusi i nomi delle directory, le estensioni dei file e le configurazioni derivate.
@@ -969,8 +953,6 @@ Impostazioni per come i contenuti sono gestiti nell'applicazione, inclusi i nomi
 | `excludedPath`   | Directory da escludere dalla scansione del contenuto.                                                               | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Attualmente non utilizzato; pianificato per il futuro.                                                                                                                                       |
 | `formatCommand`  | Comando per formattare i file di contenuto quando Intlayer li scrive localmente.                                    | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` sarà sostituito dal percorso del file.<br/>• Se non definito, Intlayer tenta di dedurlo (testando prettier, biome, eslint).                                                     |
 
----
-
 ### Configurazione del Sistema
 
 Impostazioni relative ai percorsi interni e ai risultati dell'output di Intlayer. Queste impostazioni sono tipicamente interne e non dovrebbero aver bisogno di essere modificate dall'utente.
@@ -1025,8 +1007,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Configurazione Logger (Log)
 
 Parametri per personalizzare l'output dei log di Intlayer.
@@ -1097,8 +1077,6 @@ Le opzioni di build sono applicate ai plugin `@intlayer/babel` e `@intlayer/swc`
 | `outputFormat`        | Controlla il formato di output per i dizionari.                                                                                                          | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | `traversePattern`     | Pattern che specifica i file da scansionare durante l'ottimizzazione.                                                                                    | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Limita l'ottimizzazione ai file rilevanti per migliorare le prestazioni del build.<br/>• Ignorato se `optimize` è disattivato.<br/>• Utilizza pattern glob.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 
----
-
 ### Configurazione Compilatore (Compiler)
 
 Impostazioni che controllano il compilatore Intlayer, che raccoglie i dizionari direttamente dai tuoi componenti.
@@ -1118,8 +1096,6 @@ Impostazioni che controllano il compilatore Intlayer, che raccoglie i dizionari
 | --------- | -------------------------------------------------------------------------------- | --------------------------- |
 | `schemas` | Consente di definire schemi Zod per convalidare la struttura dei tuoi dizionari. | `Record<string, ZodSchema>` |
 
----
-
 ### Plugin (Plugins)
 
 | Campo     | Descrizione                                 | Tipo               |
@@ -1135,25 +1111,21 @@ Impostazioni che controllano il compilatore Intlayer, che raccoglie i dizionari
 Alla radice del tuo progetto, accanto a `package.json`. Intlayer accetta anche `intlayer.config.js`, `intlayer.config.mjs`, `intlayer.config.cjs` e JSON, così il file si adatta a qualunque sistema di moduli usi il tuo progetto.
 
 </Question>
-
 <Question title="Quanto aggiunge l'i18n alla dimensione del mio bundle?">
 
 Molto meno di una configurazione basata su namespace, perché una pagina non scarica mai un catalogo che non renderizza. Il markup renderizzato lato server risolve i suoi contenuti sul server, e il compilatore in fase di build sostituisce le chiamate `useIntlayer` con le esatte voci del dizionario che un componente utilizza, quindi le chiavi e le lingue non utilizzate vengono eliminate. I [dizionari dinamici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md) suddividono il resto per locale. Misurato rispetto alle alternative abituali, Intlayer riduce la dimensione del bundle e delle pagine fino al 50%. Vedi [ottimizzazione del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/bundle_optimization.md) e il [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/index.md).
 
 </Question>
-
 <Question title="Posso migrare da `i18next`, `next-intl` o `react-i18next` senza riscrivere i miei componenti?">
 
 Sì, e ci sono due percorsi. Puoi migrare il contenuto progressivamente con la [guida alla migrazione da i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/migration_from_i18next_to_intlayer.md) o la [guida alla migrazione da next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/migration_from_next-intl_to_intlayer.md). Oppure puoi mantenere interamente la tua API attuale: gli [adattatori di compatibilità](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md) espongono esattamente la stessa API di `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` e `Lingui`, ma servita dai dizionari Intlayer, quindi cambiano gli import e il codice dei componenti no.
 
 </Question>
-
 <Question title="Posso mantenere i miei file di traduzione JSON esistenti?">
 
 Sì. Il [plugin di sincronizzazione JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-json.md) mantiene i tuoi file `/messages/{locale}/{namespace}.json` come fonte di verità e genera dizionari Intlayer da essi, in entrambe le direzioni. Un [plugin di sincronizzazione PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-po.md) fa lo stesso per i cataloghi gettext, e i [file per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/per_locale_file.md) ti permettono di dividere il contenuto per lingua invece di raggruppare i locale in un unico file.
 
 </Question>
-
 <Question title="Devo spostare il mio contenuto chiave per chiave?">
 
 No. Esegui `npx intlayer extract` e Intlayer legge i tuoi file sorgente, estrae le stringhe visibili all'utente e scrive un file `.content` accanto a ciascuno, così puoi rivedere un diff invece di copiare le stringhe in un catalogo una alla volta. Vedi il [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/extract.md).
@@ -1161,7 +1133,6 @@ No. Esegui `npx intlayer extract` e Intlayer legge i tuoi file sorgente, estrae
 Per una pipeline completamente automatizzata, il [Compilatore Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compiler.md) fa lo stesso in fase di build sul codice sorgente JSX, TSX, Vue e Svelte, generando i dizionari ad ogni modifica così non ci sono chiavi da mantenere a mano. Funziona per analisi statica, quindi le stringhe che esistono solo a runtime restano fuori portata, e ha bisogno di alcune annotazioni per distinguere il testo visibile all'utente dalla logica applicativa.
 
 </Question>
-
 <Question title="Quali strumenti di editor e agenti AI sono disponibili?">
 
 Cinque componenti, tutti opzionali:
@@ -1173,49 +1144,41 @@ Cinque componenti, tutti opzionali:
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/eslint.md)**: `no-raw-text` segnala le stringhe hardcoded, con ulteriori regole per le chiavi statiche dei dizionari e i contenuti non utilizzati.
 
 </Question>
-
 <Question title="Come aggiungo una nuova lingua alla mia app?">
 
 Aggiungi la locale a `internationalization.locales`, poi esegui `npx intlayer fill` per tradurre il contenuto esistente in essa. I tipi generati si aggiornano contemporaneamente, quindi qualsiasi file di contenuto a cui manca la nuova locale diventa un errore di tipo invece di un fallback silenzioso.
 
 </Question>
-
 <Question title="Come rimuovo il prefisso della locale dai miei URL?">
 
 Imposta `routing.mode`. Il valore predefinito `"prefix-no-default"` dà `/about` per la locale predefinita e `/fr/about` per le altre. `"prefix-all"` mette il prefisso su ogni locale. `"no-prefix"` tiene la locale completamente fuori dal percorso e la risolve da un cookie, un header o un dominio. `"search-params"` la mette nella query string come `/about?locale=fr`.
 
 </Question>
-
 <Question title="Posso servire ogni lingua dal proprio dominio?">
 
 Sì. `routing.domains` associa una locale a un hostname, per esempio `{ fr: 'example.fr', en: 'example.com' }`. Il dominio identifica la locale, quindi nessun prefisso viene aggiunto al percorso, e `getLocalizedUrl` restituisce un URL assoluto sul dominio giusto.
 
 </Question>
-
 <Question title="Come viene rilevata la lingua dell'utente?">
 
 Tramite `routing.storage`, che elenca le fonti da leggere in ordine, tipicamente l'URL, poi un cookie, poi l'header `Accept-Language`. Una scelta esplicita dell'utente viene persistita così prevale alla visita successiva.
 
 </Question>
-
 <Question title="Cosa fa routing.enableProxy?">
 
 Controlla il proxy di routing delle locale, il middleware che risolve prefissi e reindirizzamenti. Se lasciato non impostato, il proxy è attivo ma i server di sviluppo e di anteprima ignorano la locale memorizzata come fonte di reindirizzamento, il che evita di essere rimbalzati su una lingua che non stai testando; in produzione si comporta come se fosse `true`. Impostalo su `false` per gestire tu stesso il routing delle locale.
 
 </Question>
-
 <Question title="Qual è la differenza tra importMode static, dynamic e fetch?">
 
 `"static"`, il valore predefinito, importa i dizionari staticamente così vengono inclusi nel bundle e letti in modo sincrono. `"dynamic"` li importa tramite Suspense, quindi una locale viene scaricata solo quando un componente la renderizza, il che è ciò che vuoi per grandi insiemi di contenuti. `"fetch"` li recupera dall'API di sincronizzazione live e ricade su `"dynamic"` in caso di errore. Vedi [ottimizzazione del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/bundle_optimization.md) e [dizionari dinamici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md).
 
 </Question>
-
 <Question title="Dove imposto il provider AI e la API key per la traduzione automatica?">
 
 O nel file di configurazione o da riga di comando con `--provider`, `--model` e `--api-key`. La chiave resta tua: le chiamate di traduzione vanno dalla tua macchina o dal tuo runner CI al provider che hai scelto, quindi nulla viene instradato attraverso una terza parte. Vedi il [comando fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/fill.md).
 
 </Question>
-
 <Question title="Devo riavviare il dev server dopo aver cambiato la configurazione?">
 
 Di solito no. Il watcher di Intlayer osserva `intlayer.config.ts` stesso: al salvataggio ricarica la configurazione e prepara di nuovo i dizionari, così aggiungere una locale o cambiare una modalità di routing viene rilevato come una modifica di contenuto. Tuttavia la configurazione potrebbe essere memorizzata nella cache dai sistemi. Riavviare l'app può essere una buona soluzione.

package/docs/it/dictionary/html.md

@@ -122,8 +122,6 @@ const myContent = html(
 
 Quando si utilizza il metodo `.use()` su un nodo HTML, i componenti forniti verranno controllati rispetto alla definizione fornita nella funzione `html()` (se disponibile).
 
----
-
 ## Rendering dell'HTML
 
 Il rendering può essere gestito automaticamente dal sistema di contenuti di Intlayer o manualmente utilizzando strumenti specializzati.
@@ -477,8 +475,6 @@ Puoi configurare il rendering HTML a livello globale per l'intera applicazione.
   </Tab>
 </Tabs>
 
----
-
 ### Rendering manuale e strumenti avanzati
 
 Se hai bisogno di renderizzare stringhe HTML grezze o di avere un controllo maggiore sulla mappatura dei componenti, usa i seguenti strumenti.
@@ -651,8 +647,6 @@ Se hai bisogno di renderizzare stringhe HTML grezze o di avere un controllo magg
   </Tab>
 </Tabs>
 
----
-
 ## Riferimento delle opzioni
 
 Queste opzioni possono essere passate a `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer`, e `renderHTML`.

package/docs/it/dictionary/markdown.md

@@ -1172,8 +1172,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Rendering Lato Server (SSR) e Idratazione
 
 Rispetto ad altri parser Markdown come remark / rehype, Intlayer Markdown è privo di dipendenze e viene eseguito sia sul client che sul server.

package/docs/it/how_works_intlayer.md

@@ -269,25 +269,21 @@ Il pacchetto `@intlayer/backend` esporta tipi di backend e in futuro offrirà il
 In fase di build. Il plugin del bundler, o `npx intlayer build`, analizza i tuoi file `.content.ts`, li risolve in dizionari nella cartella `.intlayer` e genera i tipi TypeScript corrispondenti. A runtime i tuoi componenti si limitano a leggere il risultato, quindi nessun parsing o caricamento di file avviene sul percorso della richiesta.
 
 </Question>
-
 <Question title="Quanto aggiunge l'i18n alla dimensione del mio bundle?">
 
 Molto meno di una configurazione basata su namespace, perché una pagina non scarica mai un catalogo che non renderizza. Il markup renderizzato lato server risolve i suoi contenuti sul server, e il compilatore in fase di build sostituisce le chiamate `useIntlayer` con le esatte voci del dizionario che un componente utilizza, quindi le chiavi e le lingue non utilizzate vengono eliminate. I [dizionari dinamici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md) suddividono il resto per locale. Misurato rispetto alle alternative abituali, Intlayer riduce la dimensione del bundle e delle pagine fino al 50%. Vedi [ottimizzazione del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/bundle_optimization.md) e il [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/index.md).
 
 </Question>
-
 <Question title="Posso migrare da `i18next`, `next-intl` o `react-i18next` senza riscrivere i miei componenti?">
 
 Sì, e ci sono due percorsi. Puoi migrare il contenuto progressivamente con la [guida alla migrazione da i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/migration_from_i18next_to_intlayer.md) o la [guida alla migrazione da next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/migration_from_next-intl_to_intlayer.md). Oppure puoi mantenere interamente la tua API attuale: gli [adattatori di compatibilità](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md) espongono esattamente la stessa API di `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` e `Lingui`, ma servita dai dizionari Intlayer, quindi cambiano gli import e il codice dei componenti no.
 
 </Question>
-
 <Question title="Posso mantenere i miei file di traduzione JSON esistenti?">
 
 Sì. Il [plugin di sincronizzazione JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-json.md) mantiene i tuoi file `/messages/{locale}/{namespace}.json` come fonte di verità e genera dizionari Intlayer da essi, in entrambe le direzioni. Un [plugin di sincronizzazione PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-po.md) fa lo stesso per i cataloghi gettext, e i [file per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/per_locale_file.md) ti permettono di dividere il contenuto per lingua invece di raggruppare i locale in un unico file.
 
 </Question>
-
 <Question title="Devo spostare il mio contenuto chiave per chiave?">
 
 No. Esegui `npx intlayer extract` e Intlayer legge i tuoi file sorgente, estrae le stringhe visibili all'utente e scrive un file `.content` accanto a ciascuno, così puoi rivedere un diff invece di copiare le stringhe in un catalogo una alla volta. Vedi il [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/extract.md).
@@ -295,7 +291,6 @@ No. Esegui `npx intlayer extract` e Intlayer legge i tuoi file sorgente, estrae
 Per una pipeline completamente automatizzata, il [Compilatore Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compiler.md) fa lo stesso in fase di build sul codice sorgente JSX, TSX, Vue e Svelte, generando i dizionari ad ogni modifica così non ci sono chiavi da mantenere a mano. Funziona per analisi statica, quindi le stringhe che esistono solo a runtime restano fuori portata, e ha bisogno di alcune annotazioni per distinguere il testo visibile all'utente dalla logica applicativa.
 
 </Question>
-
 <Question title="Quali strumenti di editor e agenti AI sono disponibili?">
 
 Cinque componenti, tutti opzionali:
@@ -307,43 +302,36 @@ Cinque componenti, tutti opzionali:
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/eslint.md)**: `no-raw-text` segnala le stringhe hardcoded, con ulteriori regole per le chiavi statiche dei dizionari e i contenuti non utilizzati.
 
 </Question>
-
 <Question title="Cos'è la cartella .intlayer e dovrei committarla?">
 
 È l'output generato: i dizionari compilati e i tipi generati. È derivata dai tuoi file di contenuto, quindi dovrebbe essere elencata in `.gitignore` e ricostruita dal tuo passo di build, esattamente come una cartella `dist`.
 
 </Question>
-
 <Question title="Come viene determinata la locale attiva?">
 
 Dalle fonti elencate in `routing.storage`, in ordine: il prefisso dell'URL quando `routing.mode` ne usa uno, poi un cookie, poi l'header `Accept-Language`, poi la tua locale predefinita. Una locale scelta esplicitamente dall'utente viene persistita, quindi sopravvive alla visita successiva. Vedi il [riferimento di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
 
 </Question>
-
 <Question title="Qual è la differenza tra dizionari locali e remoti?">
 
 Un dizionario locale è dichiarato nel tuo codice e compilato con la tua applicazione. Un dizionario remoto è gestito nel [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) e risolto a runtime, quindi può cambiare senza un deployment. Entrambi vengono letti attraverso gli stessi hook, e il contenuto remoto ricade sulla dichiarazione locale quando non è disponibile.
 
 </Question>
-
 <Question title="Intlayer funziona senza TypeScript?">
 
 Sì. I file di contenuto possono essere scritti in TypeScript, JavaScript, ESM, CommonJS o JSON. TypeScript è ciò che sblocca i tipi generati e l'autocompletamento, quindi è la configurazione consigliata, ma non è obbligatorio.
 
 </Question>
-
 <Question title="Come fanno il rendering lato server e quello lato client a condividere lo stesso contenuto?">
 
 Il server risolve direttamente il contenuto dei componenti renderizzati lato server, quindi nessun dizionario viene inviato al client per quel markup. I componenti client leggono gli stessi dizionari attraverso il provider, che riceve la locale risolta sul server, quindi il primo render del client corrisponde all'HTML del server e non mostra un lampo di una lingua diversa.
 
 </Question>
-
 <Question title="Come evita Intlayer una discrepanza di idratazione sulla locale?">
 
 La locale viene risolta una volta sul server e passata al provider, invece di essere rilevata di nuovo nel browser. Poiché il client parte dalla stessa locale che il server ha renderizzato, il markup corrisponde, cosa che di solito si rompe con il rilevamento della locale lato client.
 
 </Question>
-
 <Question title="Devo ricostruire quando aggiungo una traduzione?">
 
 In sviluppo, no: il plugin osserva i tuoi file di contenuto e ricostruisce i dizionari interessati al salvataggio. In produzione i dizionari fanno parte della build, a meno che il contenuto non sia remoto, nel qual caso il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) e la [sincronizzazione live](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/live.md) applicano la modifica senza un deployment.

package/docs/it/interest_of_intlayer.md

@@ -44,43 +44,36 @@ Rispetto alle soluzioni principali come `next-intl` o `i18next`, Intlayer è una
 Invece di caricare enormi file JSON nelle tue pagine, carica solo il contenuto strettamente necessario. Intlayer aiuta a **ridurre la dimensione del bundle e delle pagine fino al 50%**.
 
 </Accordion>
-
 <Accordion header="Manutenibilità">
 
 Delineare il contenuto della tua applicazione a livello di componente **facilita la manutenzione** per applicazioni su larga scala. Puoi duplicare o eliminare una singola cartella di funzionalità senza il carico mentale di dover rivedere l'intera base di codice del contenuto. Inoltre, Intlayer è **completamente tipizzato** per garantire l'accuratezza del tuo contenuto.
 
 </Accordion>
-
 <Accordion header="Agente IA">
 
 Co-localizzare il contenuto **riduce il contesto necessario** per i modelli di linguaggio di grandi dimensioni (LLM). Intlayer include anche una suite di strumenti, come una **CLI** per verificare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)** e **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'esperienza sviluppatore (DX) ancora più fluida per gli agenti IA.
 
 </Accordion>
-
 <Accordion header="Funzionalità">
 
 Intlayer offre una serie di funzionalità aggiuntive che altre soluzioni i18n non hanno, come il [supporto per Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/markdown.md), il [recupero di contenuto esterno](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/function_fetching.md), il [caricamento del contenuto da file](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/file.md), l'[aggiornamento del contenuto in tempo reale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/live.md), l'[editor visuale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) e molto altro.
 
 </Accordion>
-
 <Accordion header="Automazione">
 
 Usa l'automazione per tradurre nella tua pipeline CI/CD utilizzando l'LLM che preferisci al costo del tuo fornitore di IA. Intlayer offre anche un **compilatore** per automatizzare l'estrazione del contenuto, oltre a una [piattaforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) per aiutarti a **tradurre in background**.
 
 </Accordion>
-
 <Accordion header="Prestazioni">
 
 Il collegamento di enormi file JSON ai componenti può causare problemi di prestazioni e reattività. Intlayer ottimizza il caricamento del contenuto in fase di compilazione (build).
 
 </Accordion>
-
 <Accordion header="Collaborazione con non sviluppatori">
 
 Molto più di una semplice soluzione i18n, Intlayer fornisce un **[editor visuale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) auto-ospitato** e un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)** per aiutarti a gestire il tuo contenuto multilingue in **tempo reale**, rendendo fluida la collaborazione con traduttori, copywriter e altri membri del team. Il contenuto può essere memorizzato localmente e/o in remoto.
 
 </Accordion>
-
 <Accordion header="Design cross-framework">
 
 Se usi framework diversi per parti diverse della tua applicazione (es. React, React-native, Vue, Angular, Svelte, ecc.), Intlayer fornisce un modo per **utilizzare una sintassi e un'implementazione comuni su tutti i principali framework frontend**. Sarai anche in grado di condividere la dichiarazione del tuo contenuto all'interno del tuo design system, delle app, del backend, ecc.
@@ -282,8 +275,6 @@ Le stelle su GitHub sono un forte indicatore della popolarità di un progetto, d
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
----
-
 ## Interoperabilità
 
 `intlayer` può anche aiutare a gestire i namespace `react-intl`, `react-i18next`, `next-intl`, `next-i18next` e `vue-i18n`.
@@ -305,25 +296,21 @@ Coesistono tre generazioni:
 - **Librerie a livello di contenuto**: `Intlayer`. Il contenuto è dichiarato e compilato per componente, quindi tipizzazione, tree shaking, strumenti di modifica e traduzione AI provengono tutti dalle stesse dichiarazioni.
 
 </Question>
-
 <Question title="Quanto aggiunge l'i18n alla dimensione del mio bundle?">
 
 Molto meno di una configurazione basata su namespace, perché una pagina non scarica mai un catalogo che non renderizza. Il markup renderizzato lato server risolve i suoi contenuti sul server, e il compilatore in fase di build sostituisce le chiamate `useIntlayer` con le esatte voci del dizionario che un componente utilizza, quindi le chiavi e le lingue non utilizzate vengono eliminate. I [dizionari dinamici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md) suddividono il resto per locale. Misurato rispetto alle alternative abituali, Intlayer riduce la dimensione del bundle e delle pagine fino al 50%. Vedi [ottimizzazione del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/bundle_optimization.md) e il [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/index.md).
 
 </Question>
-
 <Question title="Posso migrare da `i18next`, `next-intl` o `react-i18next` senza riscrivere i miei componenti?">
 
 Sì, e ci sono due percorsi. Puoi migrare il contenuto progressivamente con la [guida alla migrazione da i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/migration_from_i18next_to_intlayer.md) o la [guida alla migrazione da next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/migration_from_next-intl_to_intlayer.md). Oppure puoi mantenere interamente la tua API attuale: gli [adattatori di compatibilità](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md) espongono esattamente la stessa API di `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` e `Lingui`, ma servita dai dizionari Intlayer, quindi cambiano gli import e il codice dei componenti no.
 
 </Question>
-
 <Question title="Posso mantenere i miei file di traduzione JSON esistenti?">
 
 Sì. Il [plugin di sincronizzazione JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-json.md) mantiene i tuoi file `/messages/{locale}/{namespace}.json` come fonte di verità e genera dizionari Intlayer da essi, in entrambe le direzioni. Un [plugin di sincronizzazione PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-po.md) fa lo stesso per i cataloghi gettext, e i [file per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/per_locale_file.md) ti permettono di dividere il contenuto per lingua invece di raggruppare i locale in un unico file.
 
 </Question>
-
 <Question title="Devo spostare il mio contenuto chiave per chiave?">
 
 No. Esegui `npx intlayer extract` e Intlayer legge i tuoi file sorgente, estrae le stringhe visibili all'utente e scrive un file `.content` accanto a ciascuno, così puoi rivedere un diff invece di copiare le stringhe in un catalogo una alla volta. Vedi il [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/extract.md).
@@ -331,7 +318,6 @@ No. Esegui `npx intlayer extract` e Intlayer legge i tuoi file sorgente, estrae
 Per una pipeline completamente automatizzata, il [Compilatore Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compiler.md) fa lo stesso in fase di build sul codice sorgente JSX, TSX, Vue e Svelte, generando i dizionari ad ogni modifica così non ci sono chiavi da mantenere a mano. Funziona per analisi statica, quindi le stringhe che esistono solo a runtime restano fuori portata, e ha bisogno di alcune annotazioni per distinguere il testo visibile all'utente dalla logica applicativa.
 
 </Question>
-
 <Question title="Quali strumenti di editor e agenti AI sono disponibili?">
 
 Cinque componenti, tutti opzionali:
@@ -343,43 +329,36 @@ Cinque componenti, tutti opzionali:
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/eslint.md)**: `no-raw-text` segnala le stringhe hardcoded, con ulteriori regole per le chiavi statiche dei dizionari e i contenuti non utilizzati.
 
 </Question>
-
 <Question title="In cosa Intlayer è diverso da next-intl?">
 
 `next-intl` è un livello di messaggi per Next.js: mantieni file JSON di messaggi per locale e li leggi attraverso `useTranslations`. Intlayer è un livello di contenuto: le dichiarazioni vivono accanto al componente, sono tipizzate dalla dichiarazione stessa e sono compilate per componente così una pagina invia solo ciò che renderizza. Intlayer copre anche ciò che `next-intl` lascia a te, ossia la traduzione AI, un editor visivo, un CMS e i controlli delle traduzioni mancanti in CI. Se vuoi mantenere l'API di `next-intl`, l'[adattatore di compatibilità](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md) la serve dai dizionari Intlayer.
 
 </Question>
-
 <Question title="In cosa Intlayer è diverso da i18next e react-i18next?">
 
 `i18next` risolve le chiavi stringa contro i namespace a runtime, il che significa che una chiave rinominata o scritta male fallisce silenziosamente e ogni namespace toccato da una pagina viene scaricato per intero. Intlayer risolve il contenuto in fase di build contro i tipi generati, quindi una chiave errata è un errore di compilazione, e solo le voci che un componente renderizza raggiungono il bundle. `i18next` ha l'ecosistema di plugin più grande e una storia più lunga; Intlayer ha la tipizzazione, la dimensione del bundle e gli strumenti di modifica e automazione. Vedi la [guida alla migrazione da i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/migration_from_i18next_to_intlayer.md) o l'[adattatore di compatibilità](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md).
 
 </Question>
-
 <Question title="Intlayer è più veloce o più leggero delle alternative?">
 
 Su bundle e dimensione delle pagine, sì: non caricare cataloghi che una pagina non renderizza riduce la dimensione del bundle e delle pagine fino al 50% rispetto alle configurazioni basate su namespace. Il [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/index.md) pubblica il metodo e i numeri per framework, inclusi [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/nextjs.md), [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/tanstack.md), [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/vue.md) e [Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/benchmark/svelte.md), così puoi riprodurli invece di prendere l'affermazione per buona.
 
 </Question>
-
 <Question title="Vale la pena migrare un'app esistente?">
 
 Dipende da cosa fa male oggi. Se il tuo problema è la dimensione del bundle, le traduzioni mancanti silenziose, o i traduttori che non possono lavorare senza uno sviluppatore, la migrazione si ripaga da sola. Se i tuoi cataloghi sono piccoli e stabili, il guadagno è minore. In ogni caso la migrazione non deve essere una riscrittura: gli [adattatori di compatibilità](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md) mantengono la tua API attuale, e il [plugin di sincronizzazione JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/plugins/sync-json.md) mantiene i tuoi file JSON esistenti come fonte di verità mentre entrambi i livelli coesistono.
 
 </Question>
-
 <Question title="Cosa offre Intlayer che le altre librerie i18n non offrono?">
 
 [Contenuto Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/markdown.md), [contenuto recuperato da una fonte esterna](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md), caricamento di contenuto da file, [aggiornamenti di contenuto live](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/live.md), un [editor visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md), un [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md), un [compilatore](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compiler.md) che estrae il contenuto dai componenti esistenti, [varianti di contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/variants.md) per l'A/B testing, [analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/analytics.md) sull'esposizione dei contenuti, un [server MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md), un [LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md) e le [agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md).
 
 </Question>
-
 <Question title="Posso usare Intlayer solo come gestore di traduzioni e mantenere la mia libreria attuale?">
 
 Sì. Intlayer può generare i tuoi namespace nel formato e nella posizione che la tua libreria attuale si aspetta, per esempio `/messages/{locale}/{namespace}.json`, così ottieni la traduzione AI, l'editor e i controlli in CI mentre il codice della tua applicazione continua a usare la sua libreria i18n esistente.
 
 </Question>
-
 <Question title="Intlayer è gratuito e open source?">
 
 Sì, sotto licenza Apache 2.0, uso commerciale incluso. Il CMS ospitato è un servizio a pagamento opzionale che può anche essere [auto-ospitato](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md).