@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.4

package/docs/it/intlayer_with_vite+solid.md

@@ -120,28 +120,44 @@ Più di una semplice soluzione i18n, Intlayer fornisce un **[editor visivo](http
 
 Installa i pacchetti necessari usando npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer solid-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer solid-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer solid-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer solid-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/it/intlayer_with_vite+svelte.md

@@ -132,28 +132,44 @@ Consulta il [Template dell'Applicazione](https://github.com/aymericzip/intlayer-
 
 Installa i pacchetti necessari usando npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer svelte-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer svelte-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer svelte-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer svelte-intlayer
 bun add vite-intlayer --save-dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/it/intlayer_with_vite+vanilla.md

@@ -118,28 +118,44 @@ Più di una semplice soluzione i18n, Intlayer fornisce un **[editor visivo](http
 
 Installa i pacchetti necessari utilizzando npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer vanilla-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vanilla-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vanilla-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vanilla-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/it/intlayer_with_vite+vue.md

@@ -111,28 +111,44 @@ Vedi il [Modello di Applicazione](https://github.com/aymericzip/intlayer-vite-vu
 
 Installa i pacchetti necessari usando npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/it/migration_from_i18next_to_intlayer.md

@@ -98,24 +98,40 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Puoi mantenere installato `i18next` in modo sicuro — l'adattatore di compatibilità lo usa come `devDependency` / `peerDependency` per i tipi TypeScript.

package/docs/it/migration_from_next-i18next_to_intlayer.md

@@ -101,24 +101,40 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 
 Installa i pacchetti principali di Intlayer e gli adattatori di compatibilità:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Puoi mantenere in modo sicuro l'installazione di `next-i18next`, `react-i18next` e `i18next` durante la migrazione finché non vengono configurati gli alias.

package/docs/it/migration_from_next-intl_to_intlayer.md

@@ -97,24 +97,40 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità `@intlayer/next-intl`:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Tieni installato `next-intl` — è ancora richiesto per il **routing degli URL** (`createNavigation`, `createMiddleware`, `Link`, `redirect`, `usePathname`, `useRouter`). L'adattatore di compatibilità **non** sostituisce il layer di routing.

package/docs/it/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -100,24 +100,40 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Puoi mantenere in modo sicuro l'installazione di `@nuxtjs/i18n` durante la migrazione (lo rimuoveremo dalla configurazione di Nuxt a breve).

package/docs/it/migration_from_react-i18next_to_intlayer.md

@@ -100,24 +100,40 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Puoi mantenere installato in modo sicuro `react-i18next` e `i18next` — l'adattatore di compatibilità li usa come `devDependencies` / `peerDependencies` opzionali per i tipi TypeScript. Non devi modificare alcuna dipendenza peer nel tuo `package.json`.

package/docs/it/migration_from_vue-i18n_to_intlayer.md

@@ -99,24 +99,40 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
+
+> Questo comando rileverà il tuo ambiente e installerà i pacchetti richiesti. Ad esempio:
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Puoi mantenere installato in modo sicuro `vue-i18n` — l'adattatore di compatibilità lo usa come `devDependency` / `peerDependency` per i tipi TypeScript.

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