@intlayer/docs 9.5.4 → 9.5.6

package/docs/it/intlayer_with_vite+preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Preact i18n - Guida completa per tradurre la tua applicazione"
 description: "Niente più i18next. La guida 2026 per creare un'applicazione Vite + Preact multilingue (i18n). Traduci con agenti AI e ottimizza la dimensione del bundle, SEO e prestazioni."
 keywords:
@@ -862,8 +862,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilatore Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -878,6 +884,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila la tua applicazione per trasformare i tuoi componenti ed estrarre il contenuto
+
 ```bash packageManager="npm"
 npm run build # Oppure npm run dev
 ```
@@ -934,7 +945,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -947,7 +960,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1121,6 +1134,13 @@ Sì: [forme plurali](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
 Attraverso l'[editor visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md), che gira sulla tua infrastruttura e permette a chiunque di modificare il testo sul posto nell'app in esecuzione, o il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md), che esternalizza il contenuto così può cambiare senza un deployment.
 
+</Question>
+<Question title="Qual è il costo dell'editor visuale? È eccessivo se non ne ho bisogno?">
+
+L'[editor visuale di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) ha un **costo pari a zero** sulla tua applicazione se non viene configurato. La logica aggiuntiva viene caricata solo se esplicitamente abilitata e necessaria.
+
+Se abilitato, l'impatto è estremamente ridotto (+5 KB, caricato dinamicamente solo quando attivato) poiché la maggior parte della logica è gestita dal server editor su [app.intlayer.org](https://app.intlayer.org) o tramite il pacchetto `intlayer-editor`. Se hai solo bisogno di una soluzione di traduzione semplice senza editing visuale, Intlayer non aggiunge alcun overhead alla tua applicazione.
+
 </Question>
 <Question title="Intlayer è gratuito e open source?">
 

package/docs/it/intlayer_with_vite+react.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + React i18n - Guida completa per tradurre la tua applicazione"
 description: "Niente più i18next. La guida 2026 per creare un'applicazione Vite + React multilingue (i18n). Traduci con agenti AI e ottimizza la dimensione del bundle, SEO e prestazioni."
 keywords:
@@ -827,8 +827,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -843,6 +849,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila la tua applicazione per trasformare i tuoi componenti ed estrarre il contenuto
+
 ```bash packageManager="npm"
 npm run build # Oppure npm run dev
 ```
@@ -899,7 +910,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -912,7 +925,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1068,6 +1081,13 @@ Sì: [forme plurali](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
 Attraverso l'[editor visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md), auto-ospitato, che permette a chiunque di modificare il testo sul posto nell'app in esecuzione, o il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) per il contenuto che deve cambiare senza un deployment.
 
+</Question>
+<Question title="Qual è il costo dell'editor visuale? È eccessivo se non ne ho bisogno?">
+
+L'[editor visuale di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) ha un **costo pari a zero** sulla tua applicazione se non viene configurato. La logica aggiuntiva viene caricata solo se esplicitamente abilitata e necessaria.
+
+Se abilitato, l'impatto è estremamente ridotto (+5 KB, caricato dinamicamente solo quando attivato) poiché la maggior parte della logica è gestita dal server editor su [app.intlayer.org](https://app.intlayer.org) o tramite il pacchetto `intlayer-editor`. Se hai solo bisogno di una soluzione di traduzione semplice senza editing visuale, Intlayer non aggiunge alcun overhead alla tua applicazione.
+
 </Question>
 <Question title="Intlayer è gratuito e open source?">
 

package/docs/it/intlayer_with_vite+solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Solid i18n - Guida completa per tradurre la tua applicazione"
 description: "Niente più i18next. La guida 2026 per creare un'applicazione Vite + Solid multilingue (i18n). Traduci con agenti AI e ottimizza la dimensione del bundle, SEO e prestazioni."
 keywords:
@@ -583,8 +583,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilatore Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -599,6 +605,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila la tua applicazione per trasformare i tuoi componenti ed estrarre il contenuto
+
 ```bash packageManager="npm"
 npm run build # Oppure npm run dev
 ```
@@ -655,7 +666,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -668,7 +681,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -818,6 +831,13 @@ Sì: [forme plurali](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
 Attraverso l'[editor visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md), che gira sulla tua infrastruttura e permette a chiunque di modificare il testo sul posto nell'app in esecuzione, o il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md), che esternalizza il contenuto così può cambiare senza un deployment.
 
+</Question>
+<Question title="Qual è il costo dell'editor visuale? È eccessivo se non ne ho bisogno?">
+
+L'[editor visuale di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) ha un **costo pari a zero** sulla tua applicazione se non viene configurato. La logica aggiuntiva viene caricata solo se esplicitamente abilitata e necessaria.
+
+Se abilitato, l'impatto è estremamente ridotto (+5 KB, caricato dinamicamente solo quando attivato) poiché la maggior parte della logica è gestita dal server editor su [app.intlayer.org](https://app.intlayer.org) o tramite il pacchetto `intlayer-editor`. Se hai solo bisogno di una soluzione di traduzione semplice senza editing visuale, Intlayer non aggiunge alcun overhead alla tua applicazione.
+
 </Question>
 <Question title="Intlayer è gratuito e open source?">
 

package/docs/it/intlayer_with_vite+svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Svelte i18n - Guida completa per tradurre la tua applicazione"
 description: "Niente più i18next. La guida 2026 per creare un'applicazione Vite + Svelte multilingue (i18n). Traduci con agenti AI e ottimizza la dimensione del bundle, SEO e prestazioni."
 keywords:
@@ -590,8 +590,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilatore Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -606,6 +612,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila la tua applicazione per trasformare i tuoi componenti ed estrarre il contenuto
+
 ```bash packageManager="npm"
 npm run build # Oppure npm run dev
 ```
@@ -662,7 +673,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -675,7 +688,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/it/intlayer_with_vite+vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vanilla JS i18n - Guida completa per tradurre la tua applicazione"
 description: "Niente più i18next. La guida 2026 per creare un'applicazione Vite + Vanilla JS multilingue (i18n). Traduci con agenti AI e ottimizza la dimensione del bundle, SEO e prestazioni."
 keywords:
@@ -613,8 +613,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilatore Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -629,6 +635,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila la tua applicazione per trasformare i tuoi componenti ed estrarre il contenuto
+
 ```bash packageManager="npm"
 npm run build # O npm run dev
 ```
@@ -685,7 +696,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -698,7 +711,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/it/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vue i18n - Guida completa per tradurre la tua applicazione"
 description: "Niente più i18next. La guida 2026 per creare un'applicazione Vite + Vue multilingue (i18n). Traduci con agenti AI e ottimizza la dimensione del bundle, SEO e prestazioni."
 keywords:
@@ -977,8 +977,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilatore Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -993,6 +999,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila la tua applicazione per trasformare i tuoi componenti ed estrarre il contenuto
+
 ```bash packageManager="npm"
 npm run build # Oppure npm run dev
 ```
@@ -1049,7 +1060,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -1062,7 +1075,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/it/introduction.md

@@ -189,7 +189,6 @@ Abbiamo costruito Intlayer pensando alla flessibilità, offrendo un'integrazione
 - **[Intlayer con Astro + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_astro_solid.md)**
 - **[Intlayer con Astro + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_astro_preact.md)**
 - **[Intlayer con Astro + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_astro_lit.md)**
-- **[Intlayer con Astro + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_astro_vanilla.md)**
 - **[Intlayer con Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_vite+vue.md)**
 - **[Intlayer con Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nuxt.md)**
 - **[Intlayer con Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_vite+svelte.md)**

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

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-09-19
 title: Documentazione del pacchetto astro-intlayer
-description: Integrazione Astro per Intlayer, che fornisce la configurazione per il routing basato sulla locale e la gestione dei dizionari.
+description: Integrazione Astro per Intlayer, che fornisce configurazione per il routing basato su locale, middleware, hook, store client e gestione dei dizionari.
 keywords:
   - astro-intlayer
   - astro
@@ -14,6 +14,9 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Aggiunta documentazione degli hook useIntlayer, useDictionary, useLocale, del middleware e dei formattatori"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -22,7 +25,7 @@ author: aymericzip
 
 # Pacchetto astro-intlayer
 
-Il pacchetto `astro-intlayer` fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni Astro. Configura il routing basato sulla locale e la gestione dei dizionari.
+Il pacchetto `astro-intlayer` fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni Astro. Configura il routing basato su locale, la gestione dei dizionari, la riscrittura delle pagine in fase di compilazione, il middleware di richiesta e gli hook per accedere a contenuti multilingue sia nei componenti `.astro` renderizzati dal server sia negli script lato client.
 
 ## Installazione
 
@@ -34,22 +37,171 @@ npm install astro-intlayer
 
 ### Integrazione
 
-Il pacchetto `astro-intlayer` fornisce un'integrazione per Astro per configurare Intlayer nel tuo progetto.
+Il pacchetto `astro-intlayer` fornisce un'integrazione Astro che configura Intlayer nel tuo progetto.
 
 Importazione:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-oppure aggiungendolo a `astro.config.mjs`:
+o importazione predefinita in `astro.config.mjs`:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| Funzione   | Descrizione                                                 |
-| ---------- | ----------------------------------------------------------- |
-| `intlayer` | Integrazione Astro che configura Intlayer nel tuo progetto. |
+| Funzione   | Descrizione                                                                                                                                                                                                          | Documentazione correlata                                                                                      |
+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Integrazione Astro che prepara i dizionari, configura i plugin Vite (alias, proxy di routing, eliminazione), registra automaticamente il middleware di richiesta ed emette pagine pre-renderizzate su URL riscritti. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/intlayer.md) |
+
+### Hook (Server e Client)
+
+Importazione:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| Hook            | Descrizione                                                                                                                                                                                                  | Documentazione correlata                                                                                                |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Seleziona un dizionario tramite la sua chiave e restituisce il suo contenuto localizzato. Nel frontmatter `.astro`, legge il locale di richiesta da `Astro.locals`. In `<script>`, legge dallo store client. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | Trasforma un oggetto dizionario e restituisce il contenuto per il locale risolto. Funziona nel frontmatter e negli script client.                                                                            | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | Restituisce il locale corrente, il locale predefinito, i locale disponibili e una funzione per aggiornare il locale.                                                                                         | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/useLocale.md)         |
+
+### Middleware (astro-intlayer/middleware)
+
+Importazione:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| Esportazione | Tipo                | Descrizione                                                                                                                                                                      | Documentazione correlata                                                                                        |
+| ------------ | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest`  | `MiddlewareHandler` | Middleware Astro che rileva il locale della richiesta e allega `Astro.locals.intlayer`. Registrato automaticamente da `intlayer()`, o importato manualmente per essere composto. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/onRequest.md) |
+
+### Utilità
+
+Importazione:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| Funzione            | Descrizione                                                                                                                              | Documentazione correlata |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
+| `getIntlayerLocals` | Funzione helper per recuperare l'oggetto `IntlayerLocals` corrente dall'ambito di archiviazione della richiesta fuori da `Astro.locals`. | -                        |
+
+### Utilità Client (astro-intlayer/client)
+
+Importazione:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+Quando importato nel browser o all'interno dei tag client `<script>`, `astro-intlayer` si mappa automaticamente su `astro-intlayer/client` (alimentato da `vanilla-intlayer`), fornendo getter di dizionario lato client, sottoscrittori dello store e strumenti di persistenza del locale.
+
+### Formattatori (astro-intlayer/format)
+
+Importazione:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| Hook              | Descrizione                                                                                                            |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Restituisce un'istanza Intl associata al locale con funzionalità di memorizzazione nella cache e iscrizione.           |
+| `useDate`         | Restituisce una funzione di formattazione della data associata al locale corrente (`Intl.DateTimeFormat`).             |
+| `useNumber`       | Restituisce una funzione di formattazione numerica associata al locale corrente (`Intl.NumberFormat`).                 |
+| `useCurrency`     | Restituisce una funzione di formattazione della valuta associata al locale corrente.                                   |
+| `usePercentage`   | Restituisce una funzione di formattazione della percentuale associata al locale corrente.                              |
+| `useRelativeTime` | Restituisce una funzione di formattazione del tempo relativo associata al locale corrente (`Intl.RelativeTimeFormat`). |
+| `useList`         | Restituisce una funzione di formattazione di elenchi associata al locale corrente (`Intl.ListFormat`).                 |
+| `useUnit`         | Restituisce una funzione di formattazione delle unità associata al locale corrente.                                    |
+| `useCompact`      | Restituisce una funzione di formattazione numerica compatta associata al locale corrente (es. `1.5K`).                 |
+
+### Utilità HTML (astro-intlayer/html)
+
+Importazione:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| Esportazione      | Tipo       | Descrizione                                                          |
+| ----------------- | ---------- | -------------------------------------------------------------------- |
+| `renderHTML`      | `Function` | Funzione di utilità autonoma per il rendering dei nodi HTML.         |
+| `useHTML`         | `Hook`     | Hook per ottenere il contesto e la configurazione del provider HTML. |
+| `useHTMLRenderer` | `Hook`     | Hook per ottenere una funzione di rendering HTML preconfigurata.     |
+
+### Utilità Markdown (astro-intlayer/markdown)
+
+Importazione:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| Esportazione          | Tipo       | Descrizione                                                          |
+| --------------------- | ---------- | -------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Compila stringhe markdown in una rappresentazione strutturata.       |
+| `renderMarkdown`      | `Function` | Renderizza il contenuto markdown in nodi di output.                  |
+| `parseMarkdown`       | `Function` | Analizza il contenuto markdown non elaborato in un AST.              |
+| `useMarkdown`         | `Hook`     | Hook per ottenere il contesto del provider markdown.                 |
+| `useMarkdownRenderer` | `Hook`     | Hook per ottenere una funzione di rendering Markdown preconfigurata. |
+
+### Tipi
+
+Importazione:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| Tipo              | Descrizione                                                                                             |
+| ----------------- | ------------------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | L'oggetto allegato a `Astro.locals.intlayer` contenente `locale`, `defaultLocale` e `availableLocales`. |
+| `UseLocaleProps`  | Proprietà di configurazione opzionali accettate da `useLocale()`.                                       |
+| `UseLocaleResult` | Il tipo restituito da `useLocale()`, che fornisce proprietà del locale e metodi di aggiornamento.       |

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: Documentazione dell'integrazione intlayer | astro-intlayer
+description: Scopri come configurare e utilizzare l'integrazione Astro intlayer in astro.config.mjs.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - integrazione
+  - i18n
+  - internazionalizzazione
+  - documentazione
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Aggiornata documentazione dell'integrazione con dettagli su middleware e hook"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "Doc iniziale"
+author: aymericzip
+---
+
+# Documentazione dell'integrazione Astro intlayer
+
+L'integrazione `intlayer` per Astro configura il tuo progetto per l'internazionalizzazione (i18n) multilingue. Gestisce la preparazione dei dizionari in fase di compilazione, l'inserimento dei plugin Vite, la registrazione automatica del middleware di richiesta e l'emissione di pagine pre-renderizzate localizzate.
+
+## Utilizzo
+
+Aggiungi `intlayer()` a `astro.config.mjs`:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Il codemod dell'Astro CLI (`astro add astro-intlayer`) genera anche un'importazione predefinita supportata:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## Descrizione
+
+L'integrazione si inserisce nel ciclo di vita di compilazione ed esecuzione di Astro:
+
+1. **Configurazione iniziale (`astro:config:setup`)**:
+   - **Preparazione dizionari**: Prepara i dizionari Intlayer e i tipi generati prima dell'esecuzione della compilazione.
+   - **Plugin Vite**: Inserisce i plugin per gli alias Vite (abilitando importazioni dirette dei dizionari), proxy di routing dei locale e rimozione degli elementi superflui della compilazione.
+   - **Registrazione middleware**: Inserisce automaticamente `astro-intlayer/middleware` nella catena di middleware del progetto, popolando `Astro.locals.intlayer` a ogni richiesta in arrivo.
+2. **Compilazione completata (`astro:build:done`)**:
+   - **Riscritture di pagina**: Ispeziona le regole di riscrittura degli URL localizzati ed emette pagine HTML pre-renderizzate nei rispettivi percorsi localizzati.
+
+## Cosa viene fornito out-of-the-box
+
+Una volta configurata, la tua applicazione Astro può utilizzare immediatamente:
+
+- Gli hook `useIntlayer`, `useDictionary` e `useLocale` nel frontmatter dei componenti `.astro`.
+- L'oggetto `Astro.locals.intlayer` negli endpoint e nelle pagine Astro.
+- Importazioni lato client nei blocchi `<script>` che rispecchiano la stessa API con aggiornamenti reattivi.
+- Formattatori integrati sotto `astro-intlayer/format` (`useDate`, `useNumber`, `useCurrency`, ecc.).
+
+## Documentazione correlata
+
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/useLocale.md)
+- [Middleware `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/astro-intlayer/onRequest.md)