@intlayer/docs 9.5.4 → 9.5.5

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

@@ -0,0 +1,176 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentazione del pacchetto remix-intlayer
+description: Integrazione di Remix 3 per Intlayer, fornendo middleware, contesto, hook e formattatori per il routing basato sulla locale e la gestione dei contenuti.
+keywords:
+  - remix-intlayer
+  - remix
+  - remix-3
+  - internazionalizzazione
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - exports
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Documentazione unificata per tutte le esportazioni"
+author: aymericzip
+---
+
+# Pacchetto remix-intlayer
+
+Il pacchetto `remix-intlayer` fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni Remix 3. Costruito interamente sugli standard web (`Request`, `Response`, `Headers` e `URL`), offre un middleware di router per il routing basato sulla locale e riscritture interne, archiviazione del contesto, hook e utilità di formattazione per la gestione dei contenuti multilingue.
+
+## Installazione
+
+```bash
+npm install remix-intlayer
+```
+
+## Esportazioni
+
+### Middleware
+
+Importazione:
+
+```tsx
+import { intlayer } from "remix-intlayer";
+```
+
+| Funzione   | Descrizione                                                                                                                                                                                                                               | Doc correlata                                                                                                           |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Middleware del router Remix 3 che gestisce il routing basato sulla locale (reindirizzamenti e riscritture interne), risolve la locale della richiesta, la persiste nei cookie/header e inizializza l'ambito del contesto della richiesta. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/intlayerMiddleware.md) |
+
+### Contesto
+
+Importazione:
+
+```tsx
+import { Intlayer, INTLAYER_CONTEXT_PROPERTY } from "remix-intlayer";
+```
+
+| Esportazione                | Tipo         | Descrizione                                                                                                                                                 | Doc correlata                                                                                                 |
+| --------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `Intlayer`                  | `ContextKey` | Chiave di RequestContext contenente l'`IntlayerState` (`locale`, `defaultLocale`, `availableLocales`) per la richiesta corrente.                            | [Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/Intlayer.md) |
+| `INTLAYER_CONTEXT_PROPERTY` | `string`     | Nome della proprietà (`'intlayer'`) installata direttamente sul contesto della richiesta, accessibile tramite `context.intlayer` e `context.get(Intlayer)`. | -                                                                                                             |
+
+### Hook
+
+Importazione:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "remix-intlayer";
+```
+
+| Hook            | Descrizione                                                                                                                                                              | Doc correlata                                                                                                           |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Seleziona un dizionario tramite la sua chiave e restituisce il suo contenuto per la locale della richiesta corrente. Legge automaticamente dal contesto della richiesta. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useIntlayer.md)     |
+| `useDictionary` | Trasforma un oggetto dizionario importato e restituisce il suo contenuto per la locale della richiesta corrente. Supporta selettori.                                     | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useDictionary.md) |
+| `useLocale`     | Restituisce la locale risolta della richiesta corrente, insieme a `defaultLocale` e `availableLocales` configurate.                                                      | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useLocale.md)         |
+
+### Utilità
+
+Importazione:
+
+```tsx
+import { createLocaleRouting, getIntlayerState } from "remix-intlayer";
+```
+
+| Funzione              | Descrizione                                                                                                                      | Doc correlata |
+| --------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------- |
+| `createLocaleRouting` | Funzione pura che determina le azioni di routing (`redirect`, `rewrite` o `pass`) in base a richiesta, configurazione e opzioni. | -             |
+| `getIntlayerState`    | Legge l'`IntlayerState` corrente (`locale`, `defaultLocale`, `availableLocales`) dallo scope `AsyncLocalStorage`.                | -             |
+
+### Formattatori (remix-intlayer/format)
+
+Importazione:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "remix-intlayer/format";
+```
+
+| Hook              | Descrizione                                                                                                                     |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Restituisce un'istanza Intl associata alla locale della richiesta con funzionalità di caching e sottoscrizione.                 |
+| `useDate`         | Restituisce una funzione di formattazione della data associata alla locale della richiesta (`Intl.DateTimeFormat`).             |
+| `useNumber`       | Restituisce una funzione di formattazione dei numeri associata alla locale della richiesta (`Intl.NumberFormat`).               |
+| `useCurrency`     | Restituisce una funzione di formattazione della valuta associata alla locale della richiesta.                                   |
+| `usePercentage`   | Restituisce una funzione di formattazione percentuale associata alla locale della richiesta.                                    |
+| `useRelativeTime` | Restituisce una funzione di formattazione del tempo relativo associata alla locale della richiesta (`Intl.RelativeTimeFormat`). |
+| `useList`         | Restituisce una funzione di formattazione delle liste associata alla locale della richiesta (`Intl.ListFormat`).                |
+| `useUnit`         | Restituisce una funzione di formattazione delle unità associata alla locale della richiesta.                                    |
+| `useCompact`      | Restituisce una funzione di formattazione numerica compatta associata alla locale della richiesta (es. `1.5K`).                 |
+
+### Utilità HTML (remix-intlayer/html)
+
+Importazione:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "remix-intlayer/html";
+```
+
+| Esportazione      | Tipo       | Descrizione                                                                                     |
+| ----------------- | ---------- | ----------------------------------------------------------------------------------------------- |
+| `renderHTML`      | `Function` | Funzione di utilità per eseguire il rendering di nodi HTML all'esterno dell'interfaccia utente. |
+| `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 (remix-intlayer/markdown)
+
+Importazione:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "remix-intlayer/markdown";
+```
+
+| Esportazione          | Tipo       | Descrizione                                                          |
+| --------------------- | ---------- | -------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Compila stringhe markdown in una rappresentazione strutturata.       |
+| `renderMarkdown`      | `Function` | Esegue il rendering del contenuto markdown in nodi di output.        |
+| `parseMarkdown`       | `Function` | Analizza il contenuto markdown non elaborato in un AST.              |
+| `useMarkdown`         | `Hook`     | Hook per accedere al contesto del provider markdown.                 |
+| `useMarkdownRenderer` | `Hook`     | Hook per ottenere una funzione di rendering Markdown preconfigurata. |
+
+### Tipi
+
+Importazione:
+
+```tsx
+import type {
+  IntlayerState,
+  IntlayerMiddlewareOptions,
+  LocaleRoutingOptions,
+  LocaleRoutingAction,
+  LocaleRoutingRequest,
+  UseLocaleResult,
+} from "remix-intlayer";
+```
+
+| Tipo                        | Descrizione                                                                                                |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `IntlayerState`             | Oggetto di stato contenente `locale`, `defaultLocale` e `availableLocales` memorizzato nel contesto Remix. |
+| `IntlayerMiddlewareOptions` | Opzioni di configurazione passate al middleware `intlayer()`.                                              |
+| `LocaleRoutingOptions`      | Opzioni che personalizzano i prefissi di locale, il rilevamento e i reindirizzamenti.                      |
+| `LocaleRoutingAction`       | Unione discriminata che rappresenta la decisione di routing: `redirect`, `rewrite` o `pass`.               |
+| `LocaleRoutingRequest`      | Rappresentazione minima della richiesta richiesta da `createLocaleRouting`.                                |
+| `UseLocaleResult`           | Tipo restituito da `useLocale()`, contenente `locale`, `defaultLocale` e `availableLocales`.               |

package/docs/it/packages/remix-intlayer/intlayerMiddleware.md

@@ -0,0 +1,101 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentazione del middleware intlayer | remix-intlayer
+description: Scopri come utilizzare il middleware intlayer nelle applicazioni Remix 3 per il routing basato sulla locale e la gestione del contesto di richiesta.
+keywords:
+  - intlayer
+  - intlayerMiddleware
+  - remix
+  - remix-3
+  - middleware
+  - routing
+  - Internazionalizzazione
+  - Documentazione
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - intlayerMiddleware
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Init doc"
+author: aymericzip
+---
+
+# Documentazione del middleware Remix 3 intlayer
+
+Il middleware `intlayer` per Remix 3 gestisce il livello di internazionalizzazione nell'intera applicazione. Costruito su standard web (`Request` e `Response`), gestisce il routing basato sulla locale (reindirizzamenti e riscritture interne), rileva la locale della richiesta, la persiste nei cookie e nelle intestazioni e imposta un ambito `AsyncLocalStorage` in modo che gestori e componenti possano accedere alle traduzioni senza passare esplicitamente props.
+
+## Utilizzo
+
+Registra il middleware `intlayer` durante l'inizializzazione del router Remix 3:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, useIntlayer, useLocale } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+// Serve `/`, `/fr`, `/es`, la locale viene risolta dalla richiesta
+router.get("/", () => {
+  const { title } = useIntlayer("home");
+  return new Response(title);
+});
+```
+
+## Descrizione
+
+Il middleware `intlayer` esegue le seguenti attività:
+
+1. **Preparazione dei dizionari**: Esegue `prepareIntlayer` all'avvio per garantire che tutti i dizionari generati siano compilati e disponibili.
+2. **Routing basato sulla locale**: Valuta la richiesta rispetto alla strategia di routing configurata (`prefix_always`, `prefix_as_needed`, `no_prefix`):
+   - **Reindirizzamenti**: Se un utente visita `/about` e deve essere reindirizzato a un prefisso di locale (es. `/it/about`), il middleware invia una risposta di reindirizzamento con le intestazioni `location` e `Set-Cookie` appropriate.
+   - **Riscritture interne**: Quando un utente accede a `/it/about`, l'URL viene riscritto internamente in modo che il gestore corrisponda a `/about`, mentre la locale risolta viene catturata come `it`.
+   - **Alias URL localizzati**: Rispetta le regole di riscrittura URL definite in `intlayer.config.ts` (es. riscrittura da `/it/about` a `/it/chi-siamo`).
+3. **Risoluzione della locale**: Rileva la locale attiva in base al prefisso URL, cookie persistenti, intestazioni personalizzate o preferenze del browser `Accept-Language`.
+4. **Iniezione del contesto**:
+   - Associa `IntlayerState` (`locale`, `defaultLocale`, `availableLocales`) al `RequestContext` di Remix sotto la chiave `Intlayer` e `context.intlayer`.
+   - Esegue il resto della richiesta all'interno di un ambito `AsyncLocalStorage` (`requestStorage`), consentendo a `useIntlayer`, `useDictionary` e `useLocale` di essere richiamati in modo pulito in gestori, viste e componenti.
+5. **Persistenza**: Allega le intestazioni e i cookie della locale in uscita alla risposta HTTP finale per conservare la preferenza dell'utente.
+
+## Parametri
+
+La funzione `intlayer` accetta `IntlayerMiddlewareOptions` opzionali:
+
+```ts
+import { intlayer, type IntlayerMiddlewareOptions } from "remix-intlayer";
+
+const options: IntlayerMiddlewareOptions = {
+  // Sostituzioni di configurazione di routing personalizzate
+};
+
+const middleware = intlayer(options);
+```
+
+## Accesso diretto al contesto
+
+Oltre all'uso degli hook, puoi accedere direttamente all'`IntlayerState` risolto dal contesto della richiesta di Remix:
+
+```ts
+import { Intlayer } from "remix-intlayer";
+
+router.get("/api/locale", (context) => {
+  // Tramite context.get()
+  const state = context.get(Intlayer);
+
+  // Oppure tramite la proprietà diretta context.intlayer
+  const { locale } = context.intlayer;
+
+  return Response.json({ locale });
+});
+```
+
+## Documentazione correlata
+
+- [Contesto `Intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/Intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useLocale.md)

package/docs/it/packages/remix-intlayer/useDictionary.md

@@ -0,0 +1,94 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentazione dell'hook useDictionary | remix-intlayer
+description: Scopri come utilizzare l'hook useDictionary nelle applicazioni Remix 3 per risolvere oggetti dizionario per la locale della richiesta corrente.
+keywords:
+  - useDictionary
+  - dizionario
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - Internazionalizzazione
+  - Documentazione
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Init doc"
+author: aymericzip
+---
+
+# Documentazione dell'hook useDictionary
+
+L'hook `useDictionary` trasforma un oggetto dizionario importato o inline e restituisce il suo contenuto risolto per la locale della richiesta corrente nelle applicazioni Remix 3.
+
+A differenza di `useIntlayer`, che risolve i dizionari tramite la relativa chiave stringa dal registro globale dei dizionari, `useDictionary` accetta direttamente un oggetto dizionario.
+
+## Utilizzo
+
+```ts fileName="src/views/home.ts"
+import { useDictionary } from "remix-intlayer";
+import homeContent from "./home.content";
+
+export const HomeView = () => {
+  const content = useDictionary(homeContent);
+
+  return `
+    <div>
+      <h1>${content.title}</h1>
+      <p>${content.subtitle}</p>
+    </div>
+  `;
+};
+```
+
+Puoi anche passare dizionari inline definiti con `t()`:
+
+```ts
+import { useDictionary } from "remix-intlayer";
+import { t } from "intlayer";
+
+export const FooterView = () => {
+  const content = useDictionary({
+    key: "footer",
+    content: {
+      copyright: t({
+        it: "Tutti i diritti riservati.",
+        en: "All rights reserved.",
+        fr: "Tous droits réservés.",
+      }),
+    },
+  });
+
+  return `<footer>${content.copyright}</footer>`;
+};
+```
+
+## Parametri
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Un oggetto dizionario o gruppo di dizionari qualificato.
+2. **`localeOrSelector`** (opzionale): Una locale specifica o un oggetto selettore (`{ item }`, `{ variant }`, opzionalmente con `locale`).
+
+## Descrizione
+
+L'hook esegue le seguenti attività:
+
+1. **Rilevamento della locale**: Legge la locale attiva della richiesta dall'archivio `AsyncLocalStorage` creato dal middleware `intlayer()`.
+2. **Risoluzione dei contenuti**: Valuta traduzioni (`t()`), enumerazioni, condizioni e strutture nidificate in base alla locale risolta.
+3. **Elaborazione dei selettori**: Applica qualsiasi selettore di elemento o variante fornito negli argomenti.
+
+## Documentazione correlata
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useLocale.md)

package/docs/it/packages/remix-intlayer/useIntlayer.md

@@ -0,0 +1,94 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentazione dell'hook useIntlayer | remix-intlayer
+description: Scopri come utilizzare l'hook useIntlayer nelle applicazioni Remix 3 per accedere ai contenuti localizzati tramite chiave.
+keywords:
+  - useIntlayer
+  - dizionario
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - Internazionalizzazione
+  - Documentazione
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Init doc"
+author: aymericzip
+---
+
+# Documentazione dell'hook useIntlayer
+
+L'hook `useIntlayer` ti consente di recuperare contenuti localizzati da un dizionario Intlayer tramite chiave nelle applicazioni Remix 3.
+
+Legge automaticamente la locale attiva dal contesto della richiesta corrente (tramite `AsyncLocalStorage`), eliminando la necessità di passare manualmente la locale attraverso gestori di route, template di viste o componenti.
+
+## Utilizzo
+
+### Nei gestori di route
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, useIntlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/welcome", () => {
+  const content = useIntlayer("home");
+
+  return Response.json({
+    title: content.title,
+    subtitle: content.subtitle,
+  });
+});
+```
+
+### Nei template di vista / componenti
+
+```tsx fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `
+    <main>
+      <h1>${content.title}</h1>
+      <p>${content.subtitle}</p>
+    </main>
+  `;
+};
+```
+
+## Parametri
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: La chiave univoca del dizionario (definita nei file di dichiarazione `.content.ts`).
+2. **`localeOrSelector`** (opzionale): Una locale specifica o un oggetto selettore (`{ item }`, `{ variant }`, opzionalmente con `locale`). Se specificato, sovrascrive la locale rilevata dal contesto della richiesta.
+
+## Descrizione
+
+L'hook esegue le seguenti attività:
+
+1. **Rilevamento della locale del contesto**: Rileva la locale corrente dall'ambito `AsyncLocalStorage` associato alla richiesta stabilito dal middleware `intlayer()`.
+2. **Recupero del dizionario**: Recupera il dizionario precompilato corrispondente alla chiave fornita.
+3. **Elaborazione della traduzione**: Risolve traduzioni, enumerazioni, markdown e contenuti condizionali per la locale rilevata.
+4. **Gestione del fallback**: Se chiamato al di fuori di un contesto di richiesta HTTP attivo, ricade automaticamente sulla `defaultLocale` configurata.
+
+## Documentazione correlata
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useDictionary.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useLocale.md)

package/docs/it/packages/remix-intlayer/useLocale.md

@@ -0,0 +1,104 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentazione dell'hook useLocale | remix-intlayer
+description: Scopri come utilizzare l'hook useLocale nelle applicazioni Remix 3 per ottenere la locale della richiesta corrente, la locale predefinita e le locale disponibili.
+keywords:
+  - useLocale
+  - locale
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - Internazionalizzazione
+  - Documentazione
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Init doc"
+author: aymericzip
+---
+
+# Documentazione dell'hook useLocale
+
+L'hook `useLocale` di `remix-intlayer` fornisce l'accesso alla locale della richiesta HTTP attualmente in fase di elaborazione, insieme alla locale predefinita e alle locale disponibili configurate nel progetto.
+
+## Utilizzo
+
+In un componente Remix (ad esempio un selettore di lingua):
+
+```tsx fileName="src/components/LocaleSwitcher.tsx"
+import { type FC } from "react";
+import { Link } from "@remix-run/react";
+import { useLocale } from "remix-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+export const LocaleSwitcher: FC = () => {
+  const { locale, availableLocales } = useLocale();
+  const pathWithoutLocale = getPathWithoutLocale();
+
+  return (
+    <nav>
+      <ul>
+        {availableLocales.map((localeItem) => (
+          <li key={localeItem} className="p-1">
+            <Link
+              href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+              aria-current={localeItem === locale ? "page" : undefined}
+            >
+              {localeItem.toUpperCase()}
+            </Link>
+          </li>
+        ))}
+      </ul>
+    </nav>
+  );
+};
+```
+
+In un gestore di route:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, useLocale } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/locale-info", () => {
+  const { locale, defaultLocale, availableLocales } = useLocale();
+
+  return Response.json({
+    locale,
+    defaultLocale,
+    availableLocales,
+  });
+});
+```
+
+## Valori restituiti
+
+L'hook restituisce un oggetto di tipo `UseLocaleResult`:
+
+| Proprietà          | Tipo                | Descrizione                                                               |
+| ------------------ | ------------------- | ------------------------------------------------------------------------- |
+| `locale`           | `DeclaredLocales`   | La locale risolta per la richiesta corrente.                              |
+| `defaultLocale`    | `DeclaredLocales`   | La locale di fallback predefinita configurata in `intlayer.config.ts`.    |
+| `availableLocales` | `DeclaredLocales[]` | Array di tutte le locale disponibili configurate in `intlayer.config.ts`. |
+
+## Descrizione
+
+1. **Risoluzione con ambito di richiesta**: In una richiesta attiva gestita dal middleware `intlayer()`, `useLocale` legge la locale risolta dall'archiviazione della richiesta.
+2. **Fallback pulito**: Se chiamato al di fuori di un contesto di richiesta, ricade per impostazione predefinita sulla `defaultLocale` configurata.
+
+## Documentazione correlata
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useIntlayer.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/remix-intlayer/useDictionary.md)

package/docs/it/readme.md

@@ -199,7 +199,8 @@ Esplora la nostra documentazione esaustiva per iniziare con Intlayer e imparare
   <li><a href="https://intlayer.org/doc/environment/create-react-app" rel=''>React CRA</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React utilizzando il compilatore</a></li>
-  <li><a href="https://intlayer.org/doc/environment/vite-and-react/compiler" rel=''>React-router-v7</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react/react-router-v7" rel=''>React-router-v7</a></li>
+  <li><a href="https://intlayer.org/doc/environment/remix-3" rel=''>Remix 3</a></li>
   <li><a href="https://intlayer.org/doc/environment/tanstack-start" rel=''>Tanstack start</a>
     <ul>
       <li><a href="https://intlayer.org/doc/environment/tanstack-start/solid" rel=''>Solid</a></li>