@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

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

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

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

@@ -14,6 +14,9 @@ slugs:
   - angular-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Aggiunta utilità usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -46,15 +49,16 @@ import "angular-intlayer";
 
 ### Hooks
 
-| Hook                   | Descrizione                                                                                                   | Doc correlato |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------- | ------------- |
-| `useIntlayer`          | Basato su `useDictionary`, ma inietta una versione ottimizzata del dizionario dalla dichiarazione generata.   | -             |
-| `useDictionary`        | Elabora oggetti che assomigliano a dizionari (key, content). Gestisce le traduzioni `t()`, enumerazioni, ecc. | -             |
-| `useDictionaryAsync`   | Come `useDictionary`, ma gestisce dizionari asincroni.                                                        | -             |
-| `useDictionaryDynamic` | Come `useDictionary`, ma gestisce dizionari dinamici.                                                         | -             |
-| `useLocale`            | Restituisce la locale corrente e una funzione per impostarla.                                                 | -             |
-| `useIntl`              | Restituisce l'oggetto Intl per la locale corrente.                                                            | -             |
-| `useLoadDynamic`       | Hook per caricare dizionari dinamici.                                                                         | -             |
+| Hook                   | Descrizione                                                                                                                        | Doc correlato                                                                                                         |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | Basato su `useDictionary`, ma inietta una versione ottimizzata del dizionario dalla dichiarazione generata.                        | -                                                                                                                     |
+| `useDictionary`        | Elabora oggetti che assomigliano a dizionari (key, content). Gestisce le traduzioni `t()`, enumerazioni, ecc.                      | -                                                                                                                     |
+| `useDictionaryAsync`   | Come `useDictionary`, ma gestisce dizionari asincroni.                                                                             | -                                                                                                                     |
+| `useDictionaryDynamic` | Come `useDictionary`, ma gestisce dizionari dinamici.                                                                              | -                                                                                                                     |
+| `useLocale`            | Restituisce la locale corrente e una funzione per impostarla.                                                                      | -                                                                                                                     |
+| `usePathname`          | Restituisce il pathname corrente come `Signal<string>` con il segmento locale rimosso. Reattivo a `popstate` tramite `DestroyRef`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | Restituisce l'oggetto Intl per la locale corrente.                                                                                 | -                                                                                                                     |
+| `useLoadDynamic`       | Hook per caricare dizionari dinamici.                                                                                              | -                                                                                                                     |
 
 ### Componenti
 

package/docs/it/packages/angular-intlayer/usePathname.md

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentazione dell'Hook usePathname | angular-intlayer
+description: Scopri come utilizzare l'hook usePathname per il pacchetto angular-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Angular
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Aggiunta utilità usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inizializzazione della cronologia"
+author: aymericzip
+---
+
+# Integrazione Angular: Documentazione dell'Hook `usePathname`
+
+L'hook `usePathname` restituisce il percorso del browser corrente con il segmento della locale rimosso, sotto forma di `Signal<string>` Angular. È utile per creare una navigazione consapevole della locale — ad esempio, per determinare quale voce di navigazione è attiva — senza dover rimuovere manualmente il prefisso della locale.
+
+## Importare `usePathname` in Angular
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## Panoramica
+
+`usePathname` legge `window.location.pathname`, rimuove il prefisso della locale tramite `getPathWithoutLocale` e aggiorna il segnale ogni volta che il browser attiva un evento `popstate` (navigazione indietro/avanti). Utilizza il `DestroyRef` di Angular per pulire automaticamente il listener di eventi quando il componente viene distrutto.
+
+## Utilizzo
+
+```typescript fileName="src/app/nav-item.component.ts"
+import { Component, input } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-nav-item",
+  template: `
+    <a
+      [href]="href()"
+      [attr.aria-current]="pathname() === href() ? 'page' : null"
+    >
+      {{ label() }}
+    </a>
+  `,
+})
+export class NavItemComponent {
+  readonly href = input.required<string>();
+  readonly label = input.required<string>();
+
+  readonly pathname = usePathname();
+}
+```
+
+## Valore di ritorno
+
+| Tipo             | Descrizione                                                                     |
+| ---------------- | ------------------------------------------------------------------------------- |
+| `Signal<string>` | Segnale Angular contenente il percorso corrente senza il prefisso della locale. |
+
+## Comportamento
+
+- **Rimozione della locale**: Rimuove il segmento iniziale della locale (es. `/it/dashboard` → `/dashboard`).
+- **Reattivo**: Si aggiorna automaticamente in seguito a eventi `popstate` (navigazione indietro / avanti del browser).
+- **Sicuro per SSR**: Restituisce `""` quando `window` non è disponibile.
+- **Pulizia**: Il listener `popstate` viene rimosso tramite `DestroyRef.onDestroy` quando il componente host viene distrutto.
+
+## Esempio
+
+```typescript fileName="src/app/sidebar.component.ts"
+import { Component } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-sidebar",
+  template: `
+    <nav>
+      @for (link of links; track link.href) {
+        <a
+          [href]="link.href"
+          [style.font-weight]="pathname() === link.href ? 'bold' : 'normal'"
+        >
+          {{ link.label }}
+        </a>
+      }
+    </nav>
+  `,
+})
+export class SidebarComponent {
+  readonly links = [
+    { href: "/dashboard", label: "Dashboard" },
+    { href: "/settings", label: "Impostazioni" },
+  ];
+
+  readonly pathname = usePathname();
+}
+```
+
+## Correlati
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/angular-intlayer/exports.md) — locale corrente + selettore della locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) — l'utilità sottostante utilizzata da questo hook

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentazione della funzione comparePaths | intlayer
+description: Scopri come utilizzare la funzione comparePaths per il pacchetto intlayer
+keywords:
+  - comparePaths
+  - normalizePath
+  - link attivo
+  - navigazione
+  - Intlayer
+  - intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "Documentazione iniziale"
+author: aymericzip
+---
+
+# Documentazione: Funzione `comparePaths` in `intlayer`
+
+## Descrizione
+
+La funzione `comparePaths` confronta due URL o percorsi per verificarne l'uguaglianza ignorando il segmento locale, il protocollo/host, la query string, l'hash e le barre finali. È il metodo consigliato per determinare se un link di navigazione punta alla pagina corrente — ad esempio per evidenziare il link attivo — senza dover creare una logica di normalizzazione personalizzata (soggetta a errori).
+
+Internamente riutilizza [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) per rimuovere il segmento locale, in modo da rispettare la modalità di routing e i locale configurati.
+
+Il pacchetto esporta anche l'utility sottostante [`normalizePath`](#normalizepath), che restituisce il percorso canonico, indipendente dal locale, utilizzato per il confronto.
+
+**Funzionalità chiave:**
+
+- Confronto indipendente dal locale (`/it/about` corrisponde a `/about`)
+- Funziona sia con URL assoluti che con percorsi relativi
+- Ignora query string, hash e barre finali
+- Tollera l'assenza di barre iniziali e valori vuoti (normalizzato a `/`)
+- Leggero — basato su `getPathWithoutLocale`
+
+---
+
+## Firma della funzione
+
+```typescript
+comparePaths(
+  pathname: string,  // Richiesto
+  href: string,      // Richiesto
+  locales?: Locales[] // Opzionale
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Richiesto
+  locales?: Locales[] // Opzionale
+): string
+```
+
+---
+
+## Parametri
+
+- `pathname: string`
+  - **Descrizione**: La prima stringa URL o percorso da confrontare (in genere il percorso corrente).
+  - **Tipo**: `string`
+  - **Richiesto**: Sì
+
+- `href: string`
+  - **Descrizione**: La seconda stringa URL o percorso da confrontare (in genere l'`href` di un link di navigazione).
+  - **Tipo**: `string`
+  - **Richiesto**: Sì
+
+- `locales: Locales[]`
+  - **Descrizione**: Array opzionale di locale supportati. Per impostazione predefinita, i locale configurati nel progetto.
+  - **Tipo**: `Locales[]`
+  - **Richiesto**: No (Opzionale)
+
+### Restituisce
+
+- **Tipo**: `boolean`
+- **Descrizione**: `true` quando entrambi gli input si risolvono allo stesso percorso indipendente dal locale, altrimenti `false`.
+
+---
+
+## Esempio di utilizzo
+
+### Utilizzo di base
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { comparePaths } from "intlayer";
+
+comparePaths("/ru/path", "/path"); // true
+comparePaths("/ru/path/", "/path"); // true
+comparePaths("/ru/path", "/path/"); // true
+comparePaths("/ru/", "/"); // true
+comparePaths("/ru", "/"); // true
+comparePaths("ru/path", "/path"); // true
+comparePaths("", "/"); // true
+comparePaths("/ru", ""); // true
+comparePaths("/ru/path", "/other"); // false
+```
+
+### URL assoluti e relativi
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### Evidenziare il link di navigazione attivo
+
+```tsx
+import { comparePaths } from "intlayer";
+import { useLocation } from "react-router";
+
+const NavLink = ({ href, children }) => {
+  const { pathname } = useLocation();
+  const isActive = comparePaths(pathname, href);
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {children}
+    </a>
+  );
+};
+```
+
+---
+
+## normalizePath
+
+`normalizePath` restituisce il percorso canonico e indipendente dal locale utilizzato da `comparePaths`. Rimuove il segmento locale, il protocollo/host, la query string e l'hash, assicura la presenza di una singola barra iniziale, rimuove qualsiasi barra finale (tranne che per la root) e utilizza `/` come fallback per i valori vuoti.
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { normalizePath } from "intlayer";
+
+normalizePath("/ru/path"); // "/path"
+normalizePath("/ru/path/"); // "/path"
+normalizePath("ru/path"); // "/path"
+normalizePath("/ru/"); // "/"
+normalizePath("/ru"); // "/"
+normalizePath(""); // "/"
+normalizePath("https://example.com/ru/path"); // "/path"
+```
+
+---
+
+## Funzioni correlate
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md): Rimuove il segmento locale da un URL o percorso.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPrefix.md): Determina il prefisso URL per un dato locale.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedUrl.md): Genera un URL localizzato per uno specifico locale.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "Aggiunta l'utilità comparePaths"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -108,19 +111,21 @@ Importazione:
 import "intlayer";
 ```
 
-| Funzione               | Tipo       | Descrizione                                               | Doc correlata                                                                                                                   |
-| ---------------------- | ---------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `getLocale`            | `Function` | Rileva la locale da una stringa o da un percorso.         | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocale.md)                       |
-| `getLocaleLang`        | `Function` | Estrae la parte lingua di una locale.                     | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleLang.md)               |
-| `getLocaleName`        | `Function` | Restituisce il nome di visualizzazione di una locale.     | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleName.md)               |
-| `getLocalizedPath`     | `Function` | Converte un percorso canonico in un percorso localizzato. | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedPath.md)         |
-| `getCanonicalPath`     | `Function` | Risolve un percorso localizzato nella forma canonica.     | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getCanonicalPath.md)         |
-| `getLocalizedUrl`      | `Function` | Genera un URL localizzato.                                | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedUrl.md)           |
-| `getMultilingualUrls`  | `Function` | Genera URL per tutte le locali supportate.                | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getMultilingualUrls.md)   |
-| `getPathWithoutLocale` | `Function` | Rimuove il prefisso locale da un percorso.                | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) |
-| `getPrefix`            | `Function` | Ottiene il prefisso locale da un percorso.                | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPrefix.md)                       |
-| `getHTMLTextDir`       | `Function` | Ottiene la direzione del testo (LTR/RTL).                 | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getHTMLTextDir.md)             |
-| `validatePrefix`       | `Function` | Valida un prefisso locale.                                | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/validatePrefix.md)             |
+| Funzione               | Tipo       | Descrizione                                                  | Doc correlata                                                                                                                   |
+| ---------------------- | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| `getLocale`            | `Function` | Rileva la locale da una stringa o da un percorso.            | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocale.md)                       |
+| `getLocaleLang`        | `Function` | Estrae la parte lingua di una locale.                        | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleLang.md)               |
+| `getLocaleName`        | `Function` | Restituisce il nome di visualizzazione di una locale.        | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleName.md)               |
+| `getLocalizedPath`     | `Function` | Converte un percorso canonico in un percorso localizzato.    | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedPath.md)         |
+| `getCanonicalPath`     | `Function` | Risolve un percorso localizzato nella forma canonica.        | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getCanonicalPath.md)         |
+| `getLocalizedUrl`      | `Function` | Genera un URL localizzato.                                   | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedUrl.md)           |
+| `getMultilingualUrls`  | `Function` | Genera URL per tutte le locali supportate.                   | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getMultilingualUrls.md)   |
+| `getPathWithoutLocale` | `Function` | Rimuove il prefisso locale da un percorso.                   | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) |
+| `getPrefix`            | `Function` | Ottiene il prefisso locale da un percorso.                   | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | Confronta due percorsi ignorando la lingua (locale).         | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | Normalizza un percorso rendendolo indipendente dalla lingua. | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/comparePaths.md)                 |
+| `getHTMLTextDir`       | `Function` | Ottiene la direzione del testo (LTR/RTL).                    | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getHTMLTextDir.md)             |
+| `validatePrefix`       | `Function` | Valida un prefisso locale.                                   | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/validatePrefix.md)             |
 
 ### Utility del browser
 

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

@@ -29,6 +29,38 @@ author: aymericzip
 
 ## Descrizione
 
+La funzione `getLocalizedUrl` genera un URL localizzato aggiungendo un prefisso locale all'URL fornito. Gestisce sia gli URL assoluti che relativi, garantendo che il corretto prefisso locale sia applicato in base alla configurazione.
+
+**Caratteristiche principali:**
+
+- Solo 2 parametri sono obbligatori: `url` e `currentLocale`
+- Oggetto `options` facoltativo con `locales`, `defaultLocale` e `mode`
+- Utilizza la configurazione di internazionalizzazione del tuo progetto come impostazioni predefinite
+- Può essere utilizzato con parametri minimi per casi semplici o completamente personalizzato per scenari complessi
+- Supporta più modalità di routing: `prefix-no-default`, `prefix-all`, `no-prefix` e `search-params`
+
+---
+
+## Firma della Funzione
+
+```typescript
+getLocalizedUrl(
+  url: string,                   // Obbligatorio
+  currentLocale: Locales,        // Obbligatorio
+  options?: {                    // Opzionale
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): string
+```
+
+---
+
+## Parametri
+
+## Descrizione
+
 La funzione `getLocalizedUrl` genera un URL localizzato anteponendo all'URL fornito la locale specificata. Gestisce sia URL assoluti che relativi, assicurando che il prefisso della locale corretta venga applicato in base alla configurazione.
 
 ---
@@ -67,6 +99,25 @@ La funzione `getLocalizedUrl` genera un URL localizzato anteponendo all'URL forn
 
 ## Esempio di Utilizzo
 
+### Utilizzo di Base (Solo Parametri Obbligatori)
+
+Quando hai configurato il tuo progetto con le impostazioni di internazionalizzazione, puoi utilizzare la funzione con solo i parametri obbligatori:
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Utilizza la configurazione del tuo progetto per locales, defaultLocale e mode
+getLocalizedUrl("/about", Locales.FRENCH);
+// Output: "/fr/about" (assumendo che il francese sia supportato e mode sia 'prefix-no-default')
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// Output: "/about" o "/en/about" (a seconda dell'impostazione di mode)
+```
+
+### Advanced Usage (With Optional Parameters)
+
+You can override the default configuration by providing the optional `options` parameter:
+
 ### URL Relativi
 
 ```typescript codeFormat={["typescript", "esm"]}
@@ -114,6 +165,30 @@ getLocalizedUrl(
 // Output: "/about" per la locale predefinita (inglese)
 ```
 
+### Override parziale della configurazione
+
+Puoi fornire anche solo alcuni dei parametri opzionali. La funzione utilizzerà la configurazione del tuo progetto per qualsiasi parametro non specificato:
+
+```typescript codeFormat="typescript"
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Sovrascrivi solo le locales, usa la config del progetto per defaultLocale e mode
+getLocalizedUrl("/about", Locales.SPANISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+});
+
+// Sovrascrivi solo mode, usa la config del progetto per locales e defaultLocale
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  mode: "prefix-all", // Forza il prefisso per tutte le locales inclusa quella predefinita
+});
+
+// Sovrascrivi più opzioni
+getLocalizedUrl("/about", Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params", // Usa parametri di query: /about?locale=fr
+});
+```
+
 ### URL Assoluti
 
 ```typescript