@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.8

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.

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

@@ -0,0 +1,172 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Documentazione del plugin Vite intlayerProxy | vite-intlayer
+description: Middleware di routing locale per server dev/preview di Vite e SSR in produzione. Gestisce il rilevamento della lingua, i reindirizzamenti URL e le riscritture interne.
+keywords:
+  - intlayerProxy
+  - vite
+  - plugin
+  - middleware
+  - lingua
+  - routing
+  - internazionalizzazione
+  - i18n
+  - SSR
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerProxy
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Fusi configOptions in un unico oggetto opzioni; proxy incluso in intlayer()"
+author: aymericzip
+---
+
+# intlayerProxy
+
+`intlayerProxy` è un plugin Vite che registra un middleware di routing locale per **ogni ambiente**: server di sviluppo, server di anteprima e SSR in produzione (Nitro / TanStack Start).
+
+> **A partire da Intlayer v9** `intlayerProxy` è incluso automaticamente all'interno del plugin principale [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/vite-intlayer/intlayer.md) ed abilitato per impostazione predefinita tramite `routing.enableProxy: true`. È necessario registrarlo separatamente solo se si ha bisogno di un controllo di livello inferiore o se lo si utilizza al di fuori della configurazione standard di `intlayer()`.
+
+## Utilizzo
+
+### Come parte di `intlayer()` (consigliato, v9+)
+
+Passa le opzioni `proxy` al plugin principale invece di registrare `intlayerProxy` separatamente:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+### Standalone (quando necessario)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+## Opzioni
+
+```ts
+import type { IntlayerProxyPluginOptions } from "vite-intlayer";
+```
+
+Tutte le opzioni sono facoltative e passate come un singolo oggetto:
+
+| Opzione         | Tipo                                | Descrizione                                                                                                                                                                                |
+| --------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `ignore`        | `(req: IncomingMessage) => boolean` | Predicato che esclude le richieste dal routing locale. Restituisci `true` per saltare una richiesta (es. rotte API, controlli di integrità).                                               |
+| `configOptions` | `GetConfigurationOptions`           | Sostituzioni della configurazione Intlayer inoltrate a `getConfiguration()`. Utilizzare quando si ha bisogno che il proxy legga uno specifico file di configurazione o sovrascriva valori. |
+
+### Esempio
+
+```ts
+intlayerProxy({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+```
+
+## createIntlayerProxyHandler
+
+`createIntlayerProxyHandler` crea un middleware Node.js `(req, res, next)` autonomo e indipendente dal framework che contiene tutta la logica di routing locale. È utile in ambienti in cui l'API del plugin Vite non è disponibile (es. un server Node.js semplice o un modulo Nitro personalizzato).
+
+```ts
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+const handler = createIntlayerProxyHandler({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+
+// Express / Connect
+app.use(handler);
+```
+
+### SSR in produzione (TanStack Start / Nitro via h3)
+
+```ts
+// server/middleware/intlayerProxy.ts
+import { fromNodeMiddleware } from "h3";
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+export default fromNodeMiddleware(
+  createIntlayerProxyHandler({
+    ignore: (req) => req.url?.startsWith("/api"),
+  })
+);
+```
+
+## Comportamento del routing
+
+Il middleware rispecchia la logica di routing del middleware `next-intlayer` e supporta tutte le modalità di routing di Intlayer.
+
+### Modalità di routing
+
+| Modalità        | URL visibile nel browser | Comportamento                                                                                                                                 |
+| --------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `prefix`        | `/it/about`              | Predefinito. Prefisso della lingua nell'URL. La lingua predefinita reindirizza all'URL senza prefisso a meno che non sia attivo `prefix-all`. |
+| `prefix-all`    | `/en/about`, `/it/about` | Tutte le lingue — compresa quella predefinita — hanno sempre il prefisso.                                                                     |
+| `no-prefix`     | `/about`                 | Nessuna lingua nell'URL. La lingua viene memorizzata solo nei cookie; le riscritture URL avvengono internamente.                              |
+| `search-params` | `/about?locale=it`       | Lingua passata come parametro di query. Reindirizza per aggiungere/aggiornare il parametro `locale` quando mancante o obsoleto.               |
+
+### Priorità di rilevamento
+
+1. Prefisso del percorso URL (es. `/it/about` → `it`).
+2. Valore del cookie / localStorage (`intlayer-locale`).
+3. Intestazione `Accept-Language`.
+4. `defaultLocale` dalla configurazione.
+
+### Bypass automatico
+
+Il middleware fa passare sempre queste richieste direttamente senza gestione della lingua:
+
+- Richieste corrispondenti al predicato `ignore`.
+- `/node_modules/**`
+- `/@**` – Componenti interni di Vite (`@vite/`, `@fs/`, `@id/`, ecc.).
+- `/_**` – Componenti interni del server (`__vite_ping`, `__manifest`, ecc.).
+- Richieste il cui percorso termina con un'estensione di file (risorse statiche). Se è presente un prefisso della lingua sul percorso di una risorsa statica (es. `/it/logo.png`), questo viene rimosso in modo che il file possa essere servito correttamente.
+
+### Routing del dominio
+
+Quando `routing.domains` è configurato nella tua configurazione Intlayer, il middleware gestisce il routing di lingua interdominio:
+
+- Una richiesta per `/zh/about` su `intlayer.org` viene reindirizzata a `https://intlayer.zh/about` quando `domains.zh = "intlayer.zh"`.
+- Una richiesta a `intlayer.zh/about` viene riscritta internamente in `/zh/about` in modo che il parametro di rotta `[locale]` venga popolato.
+
+### Protezione dal ciclo di reindirizzamento
+
+Il middleware tiene traccia dei conteggi di reindirizzamento per coppia `originalUrl → newUrl` entro una finestra temporale mobile di 2 secondi. Più di 10 reindirizzamenti all'interno di quella finestra restituiscono una risposta `500` con un errore descrittivo anziché creare un loop infinito.
+
+## Nitro / SSR in produzione (iniezione automatica, v9+)
+
+Quando `intlayerProxy` viene utilizzato come plugin Vite, include una proprietà `.nitro`. Il plugin di compilazione `nitro/vite` legge questa proprietà e la inserisce in `nitroConfig.modules`, quindi `intlayerNitroHandler` viene registrato automaticamente come middleware del server Nitro — nessuna configurazione manuale è necessaria per il SSR in produzione.
+
+Il gestore Nitro utilizza il modello di eventi della Web Fetch API di h3 v2 (non `fromNodeMiddleware`) quindi è compatibile con tutti i preset di Nitro: Node, Bun, Deno, runtime edge.
+
+## Alias obsoleti
+
+| Esportazione obsoleta      | Sostituzione    |
+| -------------------------- | --------------- |
+| `intlayerMiddleware`       | `intlayerProxy` |
+| `intLayerMiddlewarePlugin` | `intlayerProxy` |

package/docs/it/plugins/sync-json.md

@@ -108,7 +108,6 @@ const config: IntlayerConfig = {
      * Caricherà e scriverà l'output e le traduzioni nei file JSON nella directory locales
      */
     syncJSON({
-      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       priority: 0,
       format: "i18next",

package/docs/it/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-23
+updatedAt: 2026-06-26
 title: Nuovo Intlayer v9 - Cosa c'è di nuovo?
-description: Scopri le novità di Intlayer v9. Introduzione di package di compatibilità drop-in per le più diffuse librerie i18n e supporto per Collections, Variants e Dynamic Records.
+description: Scopri le novità di Intlayer v9. Introduzione di package di compatibilità drop-in per le più diffuse librerie i18n e supporto per Collections e Variants.
 keywords:
   - Intlayer
   - Compatibilità
   - Migrazione
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # Nuovo Intlayer v9 - Cosa c'è di nuovo?
 
-Benvenuti a Intlayer v9! Questa major release segna un'enorme pietra miliare nella semplificazione del percorso di migrazione a Intlayer con i **Compat Adapter Packages** per le principali librerie i18n (`react-i18next`, `next-intl`, `vue-i18n`, ecc.) e aggiunge il supporto per strutture di contenuto ricche: **Collections**, **Variants** e **Dynamic Records**.
+Benvenuti a Intlayer v9! Questa major release segna un'enorme pietra miliare nella semplificazione del percorso di migrazione a Intlayer con i **Compat Adapter Packages** per le principali librerie i18n (`react-i18next`, `next-intl`, `vue-i18n`, ecc.) e aggiunge il supporto per strutture di contenuto ricche: **Collections** e **Variants**.
 
 ## Indice
 
@@ -41,8 +40,10 @@ Sostituendo gli import, ottieni tutti i vantaggi di Intlayer (inclusa la type sa
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Ad esempio, è sufficiente cambiare:
 
@@ -100,7 +101,7 @@ Tutti i compat adapter ora instradano la risoluzione delle traduzioni attraverso
 
 ---
 
-## Specifica delle Funzionalità: Collections, Variants & Dynamic Records
+## Specifica delle Funzionalità: Collections & Variants
 
 Intlayer v9 si espande oltre gli oggetti chiave-valore statici, consentendo ai dizionari di dichiarare strutture di layout dinamiche che sono completamente tipizzate end-to-end.
 
@@ -144,6 +145,8 @@ const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: s
 
 Fornisci A/B test, header stagionali, feature flag o landing page personalizzate:
 
+#### Varianti stringa (es. test A/B)
+
 ```ts fileName="hero.content.ts"
 import { t, type Dictionary } from "intlayer";
 
@@ -167,16 +170,14 @@ export default {
 const banner = useIntlayer("hero-banner", { variant: "black_friday" });
 ```
 
-### 3. Dynamic Records
-
-Definisci dizionari le cui voci vengono caricate dinamicamente a runtime tramite ID di query:
+#### Varianti oggetto (es. Dynamic Records)
 
 ```ts fileName="product.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "product-copy",
-  meta: {
+  variant: {
     id: "prod_123",
     category: "books",
   },
@@ -229,7 +230,7 @@ export default defineConfig({
 });
 ```
 
-- **Compiler**: Si attiva automaticamente quando `compiler.enabled` è impostato e un percorso `compiler.output` è configurato. Non è più necessario registrare `intlayerCompiler()` separatamente.
+- **Compiler**: Si attiva automaticamente quando `compiler.enabled` è impostato su `true` e un percorso `compiler.output` è configurato. Non è più necessario registrare `intlayerCompiler()` separatamente.
 - **Proxy**: Si attiva automaticamente in base alla nuova opzione `routing.enableProxy` (`true` per impostazione predefinita). Collega il middleware di rilevamento locale / reindirizzamento / riscrittura in sviluppo, anteprima e SSR in produzione. Non è più necessario registrare `intlayerProxy()` separatamente.
 
 ### Opzione `routing.enableProxy`
@@ -252,17 +253,61 @@ I plugin standalone `intlayerCompiler()` e `intlayerProxy()` rimangono esportati
 
 ---
 
+## Compilatore disabilitato per impostazione predefinita
+
+A partire da Intlayer v9, il **compilatore è disabilitato per impostazione predefinita** (`compiler.enabled` ora ha come valore predefinito `false`). Per abilitare l'estrazione dei tuoi file `.content.ts` in fase di build, imposta `compiler.enabled: true` nella tua configurazione:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Predefinito: false — richiesto per abilitare il compilatore dalla v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Quando il compilatore è disabilitato, Intlayer salta il passaggio di estrazione in fase di build e si basa sui dizionari che hai già dichiarato. Abilitalo solo quando vuoi che il plugin del bundler (`@intlayer/swc`, `@intlayer/babel` o il plugin Vite `intlayer()`) estragga il contenuto automaticamente.
+
+---
+
+## React Native: importazioni da un unico pacchetto
+
+In un'app React Native o Expo, non è più necessario destreggiarsi tra `react-intlayer` e `react-native-intlayer`. Il pacchetto `react-native-intlayer` ora **riesporta l'intera API `react-intlayer`** (hook, utility e i sottopercorsi `/format`, `/html` e `/markdown`), e il suo `IntlayerProvider` applica automaticamente i polyfill di React Native.
+
+Importa tutto dal pacchetto singolo `react-native-intlayer`:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> L'importazione da `react-intlayer` continua a funzionare, ma `react-native-intlayer` è ora il punto di ingresso singolo consigliato per React Native: il suo provider include i polyfill che il provider orientato al web `react-intlayer` non ha.
+
+---
+
 ## Note di migrazione da v8
 
 Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking changes. Ma ecco le modifiche chiave:
 
+- **Compilatore disabilitato per impostazione predefinita**: `compiler.enabled` ora ha come valore predefinito `false`. Se dipendi dall'estrazione dei tuoi file `.content.ts` in fase di build, imposta `compiler.enabled: true` nel tuo `intlayer.config.ts`.
 - **Locales & Dialects**: Se utilizzi dipendenze i18n esterne, aggiungi i rispettivi compat adapter plugin nella tua configurazione o setup del bundler per riscrivere automaticamente gli import.
-- **Custom Selectors**: Quando chiami `useIntlayer`, il secondo parametro è ora riservato a un oggetto di opzioni contenente `{ locale, item, variant, id }`. Se in precedenza passavi direttamente una stringa locale, puoi ancora farlo, ma l'utilizzo dell'oggetto di opzioni è consigliato per selezioni avanzate.
+- **Custom Selectors**: Quando chiami `useIntlayer`, il secondo parametro è ora riservato a un oggetto di opzioni contenente `{ locale, item, variant }`. Se in precedenza passavi direttamente una stringa locale, puoi ancora farlo, ma l'utilizzo dell'oggetto di opzioni è consigliato per selezioni avanzate.
 
 ---
 
 ## Link utili
 
 - [Guida ai Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md)
-- [Dizionari Dinamici - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md)
+- [Dizionari Dinamici - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md)
 - [Riferimento alla Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)

package/docs/ja/compiler.md

@@ -81,12 +81,15 @@ npm install vite-intlayer
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // コンパイラープラグインを追加
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/ja/custom_domains.md

@@ -172,10 +172,16 @@ GET intlayer.zh/about
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/ja/custom_url_rewrites.md

@@ -342,10 +342,16 @@ SolidJS、Vue、Svelte 向けに、開発中のリライトは `intlayerProxy` V
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```