@intlayer/docs 9.0.0-canary.5 → 9.0.0-canary.7

package/docs/it/intlayer_with_vite+vanilla.md

@@ -205,7 +205,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -466,12 +472,15 @@ Innanzitutto, aggiungi `intlayerProxy` alla tua configurazione Vite:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // dovrebbe essere posizionato per primo
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -603,6 +612,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilatore Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -612,7 +623,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Aggiunge il plugin del compilatore
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/it/intlayer_with_vite+vue.md

@@ -622,14 +622,17 @@ Parallelamente, puoi anche utilizzare il `intlayerProxy` per aggiungere il routi
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -954,6 +957,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilatore Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -963,7 +968,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Aggiunge il plugin del compilatore
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/it/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Documentazione del pacchetto @intlayer/babel"
+description: Plugin Babel per Intlayer per gestire l'estrazione del contenuto, l'ottimizzazione dell'importazione, l'eliminazione dei campi non utilizzati e il mascheramento dei nomi dei campi durante la build.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - internazionalizzazione
+  - i18n
+  - compilatore
+  - ottimizzare
+  - eliminare
+  - minificare
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Documentazione unificata di tutte le esportazioni"
+author: aymericzip
+---
+
+# Pacchetto @intlayer/babel
+
+Il pacchetto `@intlayer/babel` fornisce un set di plugin Babel specializzati per Intlayer. Questi plugin coprono l'intero ciclo di build: estrazione delle dichiarazioni di contenuto, riscrittura delle chiamate `useIntlayer` / `getIntlayer` in importazioni di dizionario ottimizzate, eliminazione dei campi non utilizzati e minificazione dei nomi dei campi.
+
+## Installazione
+
+```bash
+npm install @intlayer/babel
+```
+
+## Esportazioni
+
+Importazione:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Plugin
+
+| Funzione / Classe              | Descrizione                                                                                                                                                                                                     |
+| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | Plugin Babel che estrae contenuti traducibili dai file sorgente e inserisce `useIntlayer` / `getIntlayer` hooks automaticamente. Progettato per l'uso con Next.js e strumenti di compilazione basati su Babel.  |
+| `intlayerOptimizeBabelPlugin`  | Plugin Babel che trasforma le chiamate `useIntlayer` e `getIntlayer` e riscrive le loro importazioni in importazioni di dizionari JSON ottimizzati (statici, dinamici o tramite fetch).                         |
+| `intlayerPurgeBabelPlugin`     | Plugin Babel che analizza i file sorgente e riscrive i file JSON del dizionario compilato per rimuovere i campi non utilizzati (`build.purge`) o rinominarli con alias brevi (`build.minify`).                  |
+| `intlayerMinifyBabelPlugin`    | Plugin Babel che riscrive i file sorgente per utilizzare gli alias di campo brevi assegnati durante la fase di minificazione (ad esempio `content.title` ← `content.a`). Dipende da `intlayerPurgeBabelPlugin`. |
+| `makeFieldRenameBabelPlugin`   | Funzione factory che produce un plugin Babel per rinominare gli accessi ai campi del contenuto del dizionario nei file sorgente in base alla `dictionaryKeyToFieldRenameMap` popolata nel `PruneContext`.       |
+| `makeUsageAnalyzerBabelPlugin` | Funzione factory che produce un plugin Babel per analizzare l'uso di `useIntlayer` / `getIntlayer` nel codice sorgente e aggregare i dati di utilizzo del campo nel `PruneContext` condiviso.                   |
+| `getSharedPruneContext`        | Funzione helper che restituisce l'oggetto `PruneContext` condiviso per la directory di base specificata, o `null` se non è stato ancora inizializzato.                                                          |
+
+---
+
+### Utilità di configurazione dei plugin
+
+| Funzione                   | Descrizione                                                                                                                                            |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `getExtractPluginOptions`  | Carica la configurazione Intlayer e restituisce le `ExtractPluginOptions` pronte per l'uso con `intlayerExtractBabelPlugin`.                           |
+| `getOptimizePluginOptions` | Carica la configurazione Intlayer e i dizionari compilati e restituisce le `OptimizePluginOptions` pronte per l'uso con `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Carica la configurazione Intlayer e restituisce le `PurgePluginOptions` pronte per l'uso con `intlayerPurgeBabelPlugin`.                               |
+| `getMinifyPluginOptions`   | Carica la configurazione Intlayer e restituisce le `MinifyPluginOptions` pronte per l'uso con `intlayerMinifyBabelPlugin`.                             |
+
+---
+
+### Tipi
+
+| Tipo                    | Descrizione                                                                                                                               |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Modalità del compilatore: `'dev'` per lo sviluppo con supporto HMR, o `'build'` per build di produzione.                                  |
+| `ExtractPluginOptions`  | Opzioni per `intlayerExtractBabelPlugin`: elenco di file, configurazione, callback `onExtract`, ecc.                                      |
+| `ExtractResult`         | Risultato dell'estrazione: chiave del dizionario, percorso del file, contenuto e lingua.                                                  |
+| `OptimizePluginOptions` | Opzioni per `intlayerOptimizeBabelPlugin`: percorsi del dizionario, modalità di importazione, mappa delle modalità per dizionario, ecc.   |
+| `PurgePluginOptions`    | Opzioni per `intlayerPurgeBabelPlugin`: directory di base, flag purge/minify/optimize, elenco di file dei componenti.                     |
+| `MinifyPluginOptions`   | Opzioni per `intlayerMinifyBabelPlugin`: directory di base, flag di minify/optimize/editorEnabled.                                        |
+| `PruneContext`          | Stato condiviso tra i plugin di analisi e potatura: mappe di utilizzo dei campi, mappe di ridenominazione, ecc.                           |
+| `DictionaryFieldUsage`  | Risultato dell'utilizzo dei campi per un singolo dizionario: `Set<string>` o `'all'` quando l'analisi statica non è conclusiva.           |
+| `NestedRenameEntry`     | Nodo nell'albero di ridenominazione: il `shortName` e la mappa dei figli.                                                                 |
+| `NestedRenameMap`       | Un livello nell'albero di ridenominazione: `Map<string, NestedRenameEntry>`.                                                              |
+| `CompatCallerConfig`    | Configurazione per un analizzatore di utilizzo compatibile per i pacchetti compat-adapter (nome del chiamante e opzioni di elaborazione). |
+| `ScriptBlock`           | Bloco de script estratto da un file SFC (Vue o Svelte): contenuto, offset iniziale e offset finale.                                       |
+
+---
+
+### Funzioni di utilità
+
+| Funzione                          | Descrizione                                                                                                                                                                          |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `generateShortFieldName`          | Converte un intero (a partire da zero) in un identificatore alfabetico breve: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, ecc.                                                         |
+| `buildNestedRenameMapFromContent` | Costruisce ricorsivamente una `NestedRenameMap` dal valore del contenuto di un dizionario compilato, rispettando le strutture dei nodi di Intlayer (translation, enumeration, ecc.). |
+| `createPruneContext`              | Crea un nuovo oggetto `PruneContext` vuoto inizializzato con i valori predefiniti.                                                                                                   |
+| `extractScriptBlocks`             | Estrae blocchi `<script>` dai file SFC (Vue / Svelte) per la successiva analisi Babel.                                                                                               |
+| `BABEL_PARSER_OPTIONS`            | Costante che rappresenta le opzioni del parser Babel che coprono i framework supportati (React/Vue/Svelte/Angular/...).                                                              |
+| `INTLAYER_CALLER_NAMES`           | Elenco costante dei nomi di chiamata originali di Intlayer: `['useIntlayer', 'getIntlayer']`.                                                                                        |
+
+---
+
+## Esempio di utilizzo
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Nota:** Il plugin `intlayerPurgeBabelPlugin` deve essere dichiarato **prima** del `intlayerMinifyBabelPlugin`, poiché quest'ultimo legge la mappa di ridenominazione creata dal primo. Inoltre, entrambi devono essere preceduti da `intlayerOptimizeBabelPlugin` in modo che possa vedere le chiavi del dizionario prima che le chiamate a `useIntlayer` vengano riscritte.

package/docs/it/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Documentazione del pacchetto react-native-intlayer
-description: Supporto per React Native in Intlayer, fornendo provider e polyfill.
+description: Supporto per React Native in Intlayer, fornendo provider, hook, polyfill e configurazione Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Riesporta l'intera API react-intlayer (hook, utilità, subpath format/html/markdown) in modo che un'app React Native dipenda solo da react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Pacchetto react-native-intlayer
 
-Il pacchetto `react-native-intlayer` fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni React Native. Include un provider e polyfill per il supporto delle localizzazioni.
+Il pacchetto `react-native-intlayer` fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni React Native. Riesporta l'intera API `react-intlayer` (hook e utilità) con un `IntlayerProvider` pronto per React Native, oltre ai polyfill e alla configurazione Metro richiesti da React Native.
+
+> In un'app React Native, importa **tutto** da `react-native-intlayer`. Non è necessario installare o importare `react-intlayer` direttamente.
 
 ## Installazione
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Provider
 
-| Componente         | Descrizione                                                                          |
-| ------------------ | ------------------------------------------------------------------------------------ |
-| `IntlayerProvider` | Componente Provider che avvolge la tua applicazione e fornisce il contesto Intlayer. |
+| Componente         | Descrizione                                                                                                                        |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Componente Provider che avvolge la tua applicazione e fornisce il contesto Intlayer. Applica automaticamente i polyfill necessari. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Hook e utilità
+
+Questi sono riesportati da `react-intlayer`, quindi puoi importarli direttamente da `react-native-intlayer`:
 
-Importazione:
+| Esportazione                                                                                                      | Descrizione                                                    |
+| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Accedi al contenuto localizzato per una chiave del dizionario. |
+| `useLocale`                                                                                                       | Leggi e cambia la localizzazione corrente.                     |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Carica il contenuto del dizionario in vari modi.               |
+| `useI18n`                                                                                                         | Hook compatibile con i18next.                                  |
+| `t`                                                                                                               | Helper per la traduzione inline.                               |
+| `getIntlayer`, `getDictionary`                                                                                    | Getter imperativi del contenuto.                               |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Helper per la persistenza della localizzazione.                |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Polyfill
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Funzione che applica i polyfill necessari per React Native per supportare Intlayer. |
 
-Importazione:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Il polyfill viene applicato automaticamente quando importi `IntlayerProvider`. Chiama `intlayerPolyfill` manualmente solo se hai bisogno dei polyfill prima che il provider venga montato.
+
+### Formatter
+
+Gli hook di formattazione numerica, data e altri basati su Intl sono disponibili dal subpath `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Rendering Markdown e HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Configurazione Metro
@@ -66,8 +102,6 @@ Il pacchetto `react-native-intlayer` fornisce utilità di configurazione per Met
 | `configMetroIntlayerSync` | Funzione sincrona che unisce la configurazione di Metro senza preparare le risorse di Intlayer. |
 | `exclusionList`           | Crea un pattern RegExp per la blockList di Metro per escludere file di contenuto dal bundle.    |
 
-Import:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/it/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Documentazione del plugin Vite intlayerCompiler | vite-intlayer
+description: Plugin Vite che estrae le dichiarazioni di contenuto inline di Intlayer dai file dei componenti e le scrive in file JSON di dizionario durante la fase di build/transform.
+keywords:
+  - intlayerCompiler
+  - vite
+  - plugin
+  - compilatore
+  - contenuto
+  - dizionario
+  - internazionalizzazione
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Integrato in intlayer(); init doc"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` è un plugin Vite che scansiona i file sorgente dei componenti alla ricerca di **dichiarazioni di contenuto Intlayer inline** — contenuto definito direttamente all'interno di un componente anziché in un file `.content.ts` separato — e le scrive nei file JSON del dizionario durante la fase di trasformazione.
+
+> **A partire da Intlayer v9** `intlayerCompiler` è incluso automaticamente all'interno del plugin principale [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/vite-intlayer/intlayer.md) quando sia `compiler.enabled` è `true` sia `compiler.output` è impostato nella configurazione Intlayer. È necessario registrarlo separatamente solo se si desidera il controllo completo sulla configurazione specifica del compilatore.
+
+## Utilizzo
+
+### Come parte di `intlayer()` (consigliato, v9+)
+
+Abilita il compilatore tramite la configurazione di Intlayer:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // dove vengono scritti i dizionari estratti
+  },
+});
+```
+
+Quindi usa il plugin standard senza alcuna registrazione aggiuntiva:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Standalone (quando necessario)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Opzioni
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Opzione          | Tipo                      | Descrizione                                                                                                     |
+| ---------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Sostituzioni della configurazione Intlayer inoltrate a `getConfiguration()`.                                    |
+| `compilerConfig` | `Partial<CompilerConfig>` | Sostituzioni per la sezione di configurazione specifica del compilatore (es. `enabled`, `output`, `filesList`). |
+
+### Esempio
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Come funziona
+
+### Fase di trasformazione
+
+Per ogni file sorgente che corrisponde a `compiler.filesList`, il plugin del compilatore:
+
+1. Passa il contenuto del file attraverso `extractContent` da `@intlayer/babel`.
+2. Chiama `onExtract` per ogni dichiarazione trovata, scrivendo il JSON del dizionario risultante in `compiler.output`.
+3. Restituisce il codice sorgente trasformato con le dichiarazioni inline sostituite da chiamate standard `useIntlayer('key')` / `getIntlayer('key')`.
+
+Tipi di file supportati: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Quando un file di componente viene salvato in modalità di sviluppo, il compilatore:
+
+1. Rileva la modifica del file tramite l'hook `handleHotUpdate` di Vite.
+2. Estrae nuovamente il contenuto dal file aggiornato.
+3. Scrive il JSON del dizionario aggiornato.
+4. Attiva un ricaricamento completo della pagina (`server.ws.send({ type: 'full-reload' })`).
+
+Un debounce di 500 ms impedisce alla scrittura stessa del dizionario (che attiva anche un evento di modifica del file) di causare un ciclo di estrazione infinito.
+
+### Deduplica
+
+`intlayerCompiler` utilizza lo stesso meccanismo di deduplica `createPrimaryInstanceGuard` degli altri plugin inclusi. Quando sono presenti sia `intlayer()` (che include il compilatore) sia una chiamata manuale a `intlayerCompiler()`, viene eseguita solo la prima istanza registrata — nessun dizionario viene scritto due volte.

package/docs/it/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Documentazione del plugin Vite intlayerMinify | vite-intlayer
+description: Plugin Vite che minifica i file JSON del dizionario Intlayer compilati e opzionalmente maschera i nomi dei campi di contenuto per ridurre la dimensione del bundle.
+keywords:
+  - intlayerMinify
+  - vite
+  - plugin
+  - minify
+  - bundle size
+  - dizionario
+  - internazionalizzazione
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Init doc"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` è un plugin Vite che minifica i file JSON del dizionario compilato durante una build di produzione. Rimuove tutti gli spazi vuoti non necessari e, se combinato con `intlayerPrune`, rinomina opzionalmente i nomi dei campi di contenuto con brevi alias alfabetici (`a`, `b`, `c`, …) per ridurre ulteriormente la dimensione del bundle.
+
+> Il plugin è già incluso e configurato automaticamente quando usi [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/vite-intlayer/intlayer.md). Devi solo registrarlo manualmente se stai componendo lo stack di plugin da solo.
+
+## Utilizzo
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Condizioni di attivazione
+
+`intlayerMinify` è attivo **solo** quando sono soddisfatte tutte e tre le seguenti condizioni:
+
+1. Il comando Vite è `build` (non `serve` / dev).
+2. `build.optimize` è `true` (o `undefined`, che per impostazione predefinita è `true` per le build).
+3. `build.minify` è `true` nella tua configurazione Intlayer.
+
+Viene automaticamente **disattivato** quando `editor.enabled` è `true` perché l'editor ha bisogno del contenuto del dizionario completo e leggibile dall'uomo.
+
+## Cosa viene minificato
+
+Il plugin prende di mira due posizioni del dizionario (come risolto da `intlayer.system`):
+
+- `dictionariesDir` — dizionari statici per tutte le lingue (es. `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — dizionari dinamici per lingua
+
+> I dizionari in modalità fetch (`fetchDictionariesDir`) non vengono **mai** minificati perché sono serviti da un'API remota a runtime utilizzando i loro nomi di campo originali. La ridenominazione dei campi creerebbe una mancata corrispondenza tra la risposta del server e gli accessi alle proprietà lato client.
+
+## Mascheramento dei nomi dei campi (minificazione delle proprietà)
+
+Quando `intlayerPrune` ha analizzato la codebase e popolato `pruneContext.dictionaryKeyToFieldRenameMap`, `intlayerMinify` rinomina anche i nomi dei campi di contenuto in brevi alias. Ad esempio:
+
+```json
+// prima
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// dopo (con mascheramento)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+I corrispondenti accessi alle proprietà del file sorgente vengono rinominati dal passaggio Babel all'interno di `intlayerOptimize`, in modo che il comportamento a runtime rimanga invariato.
+
+I campi interni di Intlayer (`nodeType`, `translation`, ecc.) non vengono mai rinominati.
+
+## Dizionari di casi limite (Edge-cases)
+
+I dizionari contrassegnati in `pruneContext.dictionariesWithEdgeCases` (anomalie strutturali rilevate durante la fase di prune) vengono saltati completamente — né minificati né mascherati — per evitare di distribuire dati danneggiati.
+
+## Gruppi qualificati (collezioni / varianti / record meta)
+
+Per i dizionari con un array `qualifierTypes` (collezioni, varianti e record meta), il plugin preserva letteralmente l'array `qualifierTypes` e la mappa laterale `meta`. Solo per le voci di `content` viene eseguito il mascheramento dei nomi dei campi. Le chiavi composite (utilizzate per la corrispondenza dei selettori a runtime) non vengono mai toccate.