@intlayer/docs 9.3.3 → 9.4.0

package/docs/it/migration_from_next-i18next_to_intlayer.md

@@ -47,7 +47,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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 **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_next-intl_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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 **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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 **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_react-i18next_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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 **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_vue-i18n_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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 **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare 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) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/packages/elysia-intlayer/exports.md

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Documentazione del pacchetto elysia-intlayer
+description: Plugin Elysia per Intlayer, che fornisce funzioni di traduzione e rilevamento della locale.
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Documentazione unificata per tutte le esportazioni"
+author: aymericzip
+---
+
+# Pacchetto elysia-intlayer
+
+Il pacchetto `elysia-intlayer` fornisce un plugin per applicazioni Elysia per gestire l'internazionalizzazione. Rileva la locale dell'utente e inietta un oggetto `intlayer` nel contesto della route.
+
+## Installazione
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia` è una peer dependency (`>=1.0.0`). Elysia è pensato per il runtime **Bun**.
+
+## Esportazioni
+
+### Plugin
+
+Importazione:
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| Funzione   | Descrizione                                                                                                                                                                                                                                                                                                                                  | Documento correlato                                                                                            |
+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Plugin Elysia che integra Intlayer nella tua applicazione Elysia. Gestisce il rilevamento della locale dallo storage (cookie, header) e poi da `Accept-Language`, inietta un oggetto `intlayer` che espone `locale`, `t`, `getIntlayer` e `getDictionary` nel contesto della route e configura il contesto di richiesta `AsyncLocalStorage`. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/elysia-intlayer/intlayer.md) |
+
+### Funzioni
+
+Importazione:
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| Funzione        | Descrizione                                                                                                                                                                                                                                                                                       | Documento correlato                                                                                    |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `t`             | Funzione di traduzione globale che recupera il contenuto per la locale corrente in Elysia. Utilizza `AsyncLocalStorage` per accedere al contesto di richiesta configurato dal plugin `intlayer` e ricade sulla locale predefinita al di fuori di esso. Accessibile anche tramite `intlayer.t`.    | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md) |
+| `getIntlayer`   | Recupera un dizionario tramite la sua chiave dalla dichiarazione generata e ne restituisce il contenuto per la locale corrente. Versione ottimizzata di `getDictionary`. Utilizza `AsyncLocalStorage` per accedere al contesto della richiesta. Accessibile anche tramite `intlayer.getIntlayer`. | -                                                                                                      |
+| `getDictionary` | Elabora gli oggetti dizionario e restituisce il contenuto per la locale corrente. Elabora traduzioni `t()`, enumerazioni, markdown, HTML, ecc. Utilizza `AsyncLocalStorage` per accedere al contesto della richiesta. Accessibile anche tramite `intlayer.getDictionary`.                         | -                                                                                                      |
+
+### Tipi
+
+Importazione:
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| Tipo                | Descrizione                                                                                                                                                             |
+| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerContext`   | Forma dell'oggetto `intlayer` iniettato in ogni contesto di route: `locale`, `locale_storage`, `locale_detected`, `defaultLocale`, `t`, `getIntlayer`, `getDictionary`. |
+| `TranslateFunction` | Firma della funzione di traduzione, che traduce una locale map nel contenuto corrispondente alla locale della richiesta corrente.                                       |
+
+## Utilizzo
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // Carica il plugin di internazionalizzazione
+  .use(intlayer())
+  // Leggi la locale e gli helper dal contesto della route
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      it: "Ciao",
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // Oppure usa gli helper standalone, legati alla richiesta corrente
+  .get("/t_example", () =>
+    t({
+      it: "Esempio di contenuto restituito in italiano",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> Il plugin registra il proprio contesto tramite un `derive` **globale**, che Elysia tipizza come `Partial<{ intlayer: IntlayerContext }>`. A runtime il valore è sempre presente per le route registrate dopo `.use(intlayer())`, quindi usa la non-null assertion (`intlayer!.locale`) — oppure l'optional chaining — per soddisfare TypeScript in modalità `strict`.
+
+## Documentazione correlata
+
+- [Elysia i18n - Guida completa per tradurre la tua app](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_elysia.md)
+- [Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)

package/docs/it/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Documentazione del plugin intlayer per Elysia | elysia-intlayer
+description: Scopri come utilizzare il plugin intlayer del pacchetto elysia-intlayer
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - Internazionalizzazione
+  - Documentazione
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Inizializzazione della documentazione"
+author: aymericzip
+---
+
+# Documentazione del plugin intlayer per Elysia
+
+Il plugin `intlayer` per Elysia rileva la locale dell'utente e inietta un oggetto `intlayer` nel contesto della route. Consente inoltre l'uso di funzioni di traduzione globali all'interno del contesto della richiesta.
+
+## Utilizzo
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    it: "Ciao",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> Il plugin registra il proprio contesto tramite un `derive` **globale**, che Elysia tipizza come `Partial<{ intlayer: IntlayerContext }>`. A runtime il valore è sempre presente per le route registrate dopo `.use(intlayer())`, quindi usa la non-null assertion (`intlayer!.t`) — oppure l'optional chaining — per soddisfare TypeScript in modalità `strict`.
+
+Gli stessi helper sono disponibili come export autonomi, così puoi richiamarli senza destrutturare il contesto della route:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    it: "Ciao",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## Descrizione
+
+Il plugin esegue le seguenti operazioni:
+
+1. **Rilevamento della locale**: Legge la locale impostata esplicitamente dal client dallo storage (cookie, header), quindi ricade sulla locale negoziata a partire dall'header `Accept-Language`.
+2. **Iniezione nel contesto**: Aggiunge una proprietà `intlayer` al contesto della route di Elysia (vedi la tabella Contesto della route qui sotto).
+3. **Gestione del contesto**: Utilizza `AsyncLocalStorage` per gestire un contesto asincrono, consentendo alle funzioni globali di Intlayer (`t`, `getIntlayer`, `getDictionary`) di accedere alla locale specifica della richiesta senza dover passare l'oggetto di contesto.
+4. **Preparazione dei dizionari**: Richiama `prepareIntlayer` alla creazione del plugin, così i dizionari vengono costruiti all'avvio dell'applicazione.
+
+### Contesto della route
+
+| Proprietà         | Tipo                   | Descrizione                                                                                              |
+| ----------------- | ---------------------- | -------------------------------------------------------------------------------------------------------- |
+| `locale`          | `Locale`               | La locale da usare per questa richiesta, con `locale_storage` che ha la precedenza su `locale_detected`. |
+| `locale_storage`  | `Locale` (opzionale)   | La locale richiesta esplicitamente dal client tramite un cookie o un header.                             |
+| `locale_detected` | `Locale`               | La locale negoziata a partire dagli header della richiesta.                                              |
+| `defaultLocale`   | `Locale`               | La locale configurata come fallback in `intlayer.config.ts`.                                             |
+| `t`               | `TranslateFunction`    | Una funzione di traduzione.                                                                              |
+| `getIntlayer`     | `typeof getIntlayer`   | Una funzione per recuperare i dizionari tramite chiave.                                                  |
+| `getDictionary`   | `typeof getDictionary` | Una funzione per elaborare gli oggetti dizionario.                                                       |
+
+> A differenza dei plugin Intlayer basati su Node, `elysia-intlayer` si affida ad `AsyncLocalStorage` anziché a `cls-hooked`, poiché `cls-hooked` dipende da `async_hooks.createHook`, che Bun non implementa.
+
+Il contesto della richiesta viene rilasciato una volta mappata la risposta, così gli helper autonomi non si risolvono mai su una richiesta già terminata. Quando vengono chiamati al di fuori di una richiesta gestita dal plugin, ricadono sulla locale predefinita configurata.
+
+## Ordine di risoluzione della locale
+
+Per impostazione predefinita, il plugin risolve la locale in questo ordine:
+
+1. Il cookie `INTLAYER_LOCALE`.
+2. L'header `x-intlayer-locale`.
+3. La negoziazione dell'header `Accept-Language`.
+4. La `defaultLocale` configurata.
+
+```bash
+# Negoziata da `Accept-Language`
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# Il cookie ha la precedenza su `Accept-Language`
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# L'header ha la precedenza su `Accept-Language`
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## Configurazione
+
+Il plugin legge il tuo file `intlayer.config.ts`. Puoi personalizzare il cookie e l'header utilizzati per il rilevamento della locale:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> Per maggiori informazioni sulla configurazione, consulta la [documentazione di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+
+## Documentazione correlata
+
+- [Documentazione del pacchetto elysia-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - Guida completa per tradurre la tua app](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_elysia.md)

package/docs/it/packages/intlayer/getDictionary.md

@@ -0,0 +1,154 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Documentazione della Funzione getDictionary | intlayer
+description: Scopri come utilizzare la funzione getDictionary per il package intlayer
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Documentazione iniziale"
+author: aymericzip
+---
+
+# Documentazione: Funzione `getDictionary` in `intlayer`
+
+## Descrizione
+
+La funzione `getDictionary` interpreta un oggetto dizionario **che passi tu stesso** e restituisce il suo contenuto risolto per una determinata locale. Percorre il contenuto in un singolo passaggio e applica ogni plugin interprete secondo necessità, risolvendo traduzioni `t()`, enumerazioni, condizioni, inserimenti, annidamento, markdown, HTML e nodi di file.
+
+A differenza di [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getIntlayer.md), che cerca un dizionario per chiave nel registro generato, `getDictionary` accetta il dizionario stesso. Questo lo rende lo strumento giusto per contenuti costruiti a runtime, recuperati da un'API o un CMS, o dichiarati inline in un test.
+
+**Caratteristiche principali:**
+
+- Funziona con qualsiasi oggetto che segua la struttura del dizionario (`{ key, content }`)
+- Accetta anche un gruppo di dizionari qualificato (collezioni, varianti) insieme a un selettore
+- Completamente tipizzato: l'oggetto restituito rispecchia il `content` che hai passato
+- Accetta plugin interpreti personalizzati
+
+---
+
+## Function Signature
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // Obbligatorio
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opzionale
+  plugins?: Plugins[]                                // Opzionale
+): DeepTransformContent<...>
+```
+
+---
+
+## Parametri
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **Descrizione**: Il dizionario (o il gruppo di dizionari qualificati) da interpretare.
+  - **Tipo**: `Dictionary | QualifiedDictionaryGroup`
+  - **Richiesto**: Sì
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Descrizione**: La locale per interpretare il contenuto, o un oggetto selettore (`{ item }`, `{ variant }`, opzionalmente con `locale`). Vedi [dizionari dinamici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md).
+  - **Tipo**: `LocalesValues | DictionarySelector`
+  - **Richiesto**: No (Opzionale) — predefinito su `defaultLocale` configurato.
+
+- `plugins: Plugins[]`
+  - **Descrizione**: Un array di trasformatori di nodi che definiscono come i nodi riconosciuti vengono interpretati. Se omesso, viene utilizzato il set predefinito di plugin dell'interprete.
+  - **Tipo**: `Plugins[]`
+  - **Richiesto**: No (Opzionale)
+
+### Restituisce
+
+- **Type**: Il contenuto interpretato del dizionario.
+- **Description**: Il `content` che hai passato, con ogni nodo Intlayer risolto per la locale richiesta. Per un gruppo di raccolta senza un selettore `item`, viene restituito un array ordinato di voci interpretate; `null` viene restituito quando il selettore non trova nulla.
+
+---
+
+## Utilizzo di Esempio
+
+### Utilizzo di base
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "fr"
+);
+
+console.log(content.greeting); // "Bonjour"
+```
+
+### Interpretazione del contenuto recuperato a runtime
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### Con un selettore
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// Un gruppo di dizionario qualificato viene risolto a una singola voce…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …o a un array ordinato quando nessun `item` è fornito
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## Funzioni Correlate
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getIntlayer.md): Stessa interpretazione, ma il dizionario viene cercato per chiave nel registro generato.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getDictionaryAsync.md): Controparte per mappe di loader per locale.
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useDictionary.md): L'equivalente hook React, che legge la locale dal provider.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/it/packages/intlayer/getDictionaryAsync.md

@@ -0,0 +1,166 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Documentazione della funzione getDictionaryAsync | intlayer
+description: Scopri come utilizzare la funzione getDictionaryAsync del package intlayer
+keywords:
+  - getDictionaryAsync
+  - dictionary
+  - dynamic dictionaries
+  - loader map
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionaryAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Documentation: funzione `getDictionaryAsync` in `intlayer`
+
+## Descrizione
+
+La funzione `getDictionaryAsync` carica un **singolo chunk di locale** di un dizionario e restituisce il suo contenuto interpretato.
+
+È l'equivalente di [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getDictionary.md) per le mappe di loader per-locale emesse in `.intlayer/dynamic_dictionaries/`: invece di ricevere un dizionario che contiene ogni locale, riceve la mappa di loader e attende solo il chunk di cui ha bisogno il locale richiesto.
+
+> Nel codice dell'applicazione normalmente chiami [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getIntlayerAsync.md), non questa funzione. I [plugin di build](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/bundle_optimization.md) riscrivono ogni chiamata `getIntlayerAsync('key', locale)` in una `getDictionaryAsync(loaderMap, 'key', locale)`. `getDictionaryAsync` è esportato per custom loader e per strumenti che costruiscono le proprie mappe di loader.
+
+**Caratteristiche principali:**
+
+- Carica solo il chunk di locale richiesto
+- Supporta mappe di loader semplici (`locale → loader`) e qualificate (`locale → qualifierId → loader`)
+- Deduplica i caricamenti concorrenti dello stesso chunk e mette in cache il contenuto risolto
+- I caricamenti non riusciti vengono rimossi dalla cache in modo che una chiamata successiva riprovi il chunk
+
+---
+
+## Firma della Funzione
+
+```typescript
+getDictionaryAsync(
+  dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap, // Obbligatorio
+  key: string,                                           // Obbligatorio
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opzionale
+  plugins?: Plugins[]                                    // Opzionale
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Parametri
+
+- `dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap`
+  - **Description**: La mappa dei loader per locale. Le mappe semplici associano una locale a un loader; le mappe qualificate (utilizzate da collezioni e varianti) associano una locale a un id qualificatore, quindi a un loader. Per una mappa qualificata, vengono caricati solo i chunk che il selettore target.
+  - **Type**: `PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap`
+  - **Required**: Yes
+
+- `key: string`
+  - **Description**: La chiave del dizionario, utilizzata per namespace la cache dei chunk.
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: La locale per interpretare il contenuto, oppure un oggetto selettore (`{ item }`, `{ variant }`, opzionalmente con `locale`). Vedi [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md).
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — defaults to the configured `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Node transformers. Defaults to the base interpreter set.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Restituzioni
+
+- **Type**: `Promise<Content>` — una promise che si risolve nel contenuto interpretato del chunk caricato.
+- **Description**: Si risolve a `null` quando la mappa non emette alcun chunk per la locale richiesta né per nessuno dei suoi fallback, rispecchiando come una coordinata qualificata mancante si risolve.
+
+---
+
+## Utilizzo di esempio
+
+### Con una mappa di loader generata
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionaryAsync } from "intlayer";
+import appLoaderMap from "../.intlayer/dynamic_dictionaries/app";
+
+const { title } = await getDictionaryAsync(appLoaderMap, "app", "fr");
+```
+
+### Con una mappa di loader personalizzata
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const loaderMap = {
+  en: () => import("./banner.en.json").then((mod) => mod.default),
+  fr: () => import("./banner.fr.json").then((mod) => mod.default),
+};
+
+const banner = await getDictionaryAsync(loaderMap, "banner", "fr");
+```
+
+### Con un selettore su una mappa qualificata
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const promoBanner = await getDictionaryAsync(bannerLoaderMap, "banner", {
+  variant: "black-friday",
+  locale: "fr",
+});
+```
+
+---
+
+## Note sul comportamento
+
+### Caching and deduplication
+
+La cache memorizza la **promise** di ogni tripla `key + locale + selector`, quindi le chiamate concorrenti per lo stesso chunk attendono un singolo caricamento. Un caricamento rifiutato viene rimosso dalla cache, quindi un chunk che fallisce viene ritentato alla chiamata successiva invece di riprodurre lo stesso errore per sempre.
+
+### Fallback della locale
+
+Una plain loader map viene attraversata seguendo la stessa fallback chain della modalità sincrona: la locale richiesta per prima, poi i suoi fallback, poi `null` se nessuno ha emesso un chunk.
+
+---
+
+## Funzioni Correlate
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getIntlayerAsync.md): La funzione che le applicazioni chiamano; i plugin di build la riscrivono in `getDictionaryAsync`.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getDictionary.md): Controparte sincrona che accetta un dizionario completo.
+- [Dizionari dinamici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md): Collezioni e varianti, e le mappe dei loader che generano.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionaryAsync<
+  const T extends Dictionary,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionaryLoaders: PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap,
+  key: string,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    T["content"],
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/it/packages/intlayer/getEnumeration.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 La funzione `getEnumeration` recupera il contenuto corrispondente a una quantità specifica basata su condizioni predefinite in un oggetto di enumerazione. Le condizioni sono definite come chiavi e la loro priorità è determinata dall'ordine nell'oggetto.
 
+Per maggiori dettagli su come dichiarare le enumerazioni, consulta la [documentazione Enumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/enumeration.md).
+
 ## Parametri
 
 - `enumerationContent: QuantityContent<Content>`