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

package/docs/de/packages/svelte-intlayer/usePathname.md

@@ -0,0 +1,103 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Funktion Dokumentation | svelte-intlayer
+description: Sehen Sie, wie Sie die Funktion usePathname für das Paket svelte-intlayer verwenden
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalisierung
+  - Dokumentation
+  - Svelte
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dienstprogramm usePathname hinzufügen"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Historie initialisieren"
+author: aymericzip
+---
+
+# Svelte Integration: `usePathname` Dokumentation
+
+Die Funktion `usePathname` gibt den aktuellen Browser-Pfadnamen (pathname) ohne das Locale-Segment als einen Svelte `Readable<string>` Store zurück. Sie ist nützlich für den Aufbau einer Locale-bewussten Navigation — zum Beispiel, um festzustellen, welches Navigationselement aktiv ist —, ohne das Locale-Präfix manuell entfernen zu müssen.
+
+## Importieren von `usePathname` in Svelte
+
+```typescript
+import { usePathname } from "svelte-intlayer";
+```
+
+## Überblick
+
+`usePathname` erstellt einen lesbaren Svelte-Store, der `window.location.pathname` liest, das Locale-Präfix über `getPathWithoutLocale` entfernt und einen neuen Wert ausgibt, wenn der Browser ein `popstate`-Ereignis auslöst (Zurück/Vorwärts-Navigation). Abonnieren Sie diesen Store mit der `$` Store-Syntax in Komponenten.
+
+## Verwendung
+
+```svelte fileName="src/components/NavItem.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  export let href: string;
+  export let label: string;
+
+  const pathname = usePathname();
+</script>
+
+<a {href} aria-current={$pathname === href ? "page" : undefined}>
+  {label}
+</a>
+```
+
+## Rückgabewert
+
+| Typ                | Beschreibung                                                                       |
+| ------------------ | ---------------------------------------------------------------------------------- |
+| `Readable<string>` | Lesbarer Svelte-Store, der den aktuellen Pfadnamen ohne das Locale-Präfix enthält. |
+
+## Verhalten
+
+- **Entfernen des Locales**: Entfernt das führende Locale-Segment (z. B. `/de/dashboard` → `/dashboard`).
+- **Reaktiv**: Gibt bei jedem `popstate`-Ereignis (Zurück / Vorwärts im Browser) einen neuen Wert aus.
+- **SSR-sicher**: Gibt `""` zurück, wenn `window` nicht verfügbar ist.
+- **Bereinigung (Cleanup)**: Der `popstate`-Listener wird automatisch entfernt, wenn der letzte Abonnent sich abmeldet.
+
+## Beispiel
+
+```svelte fileName="src/components/Sidebar.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  const links = [
+    { href: "/dashboard", label: "Dashboard" },
+    { href: "/settings", label: "Einstellungen" },
+  ];
+
+  const pathname = usePathname();
+</script>
+
+<nav>
+  {#each links as link}
+    <a
+      href={link.href}
+      style:font-weight={$pathname === link.href ? "bold" : "normal"}
+    >
+      {link.label}
+    </a>
+  {/each}
+</nav>
+```
+
+## Verwandt
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/svelte-intlayer/useLocale.md) — aktuelle Locale + Locale-Umschalter
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/intlayer/getPathWithoutLocale.md) — das grundlegende Dienstprogramm, das von diesem Hook verwendet wird

package/docs/de/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerCompiler Vite-Plugin-Dokumentation | vite-intlayer
+description: Vite-Plugin, das Inline-Intlayer-Inhaltsdeklarationen aus Komponentendateien extrahiert und sie während der Build-/Transformationszeit in Wörterbuch-JSON-Dateien schreibt.
+keywords:
+  - intlayerCompiler
+  - vite
+  - plugin
+  - compiler
+  - content
+  - dictionary
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "In intlayer() integriert; Dokumentation initialisiert"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` ist ein Vite-Plugin, das Komponenten-Quelldateien nach **Inline-Intlayer-Inhaltsdeklarationen** scannt — also Inhalten, die direkt in einer Komponente statt in einer separaten `.content.ts`-Datei definiert sind — und diese während der Transformationsphase in Wörterbuch-JSON-Dateien schreibt.
+
+> **Seit Intlayer v9** ist `intlayerCompiler` automatisch im Hauptplugin [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vite-intlayer/intlayer.md) enthalten, wenn sowohl `compiler.enabled` auf `true` gesetzt als auch `compiler.output` in Ihrer Intlayer-Konfiguration konfiguriert ist. Sie müssen es nur dann separat registrieren, wenn Sie die volle Kontrolle über die Compiler-spezifische Konfiguration wünschen.
+
+## Verwendung
+
+### Als Teil von `intlayer()` (empfohlen, v9+)
+
+Aktivieren Sie den Compiler in Ihrer Intlayer-Konfiguration:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // Ort, an den extrahierte Wörterbücher geschrieben werden
+  },
+});
+```
+
+Verwenden Sie dann das Standard-Plugin ohne zusätzliche Registrierung:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Standalone (falls erforderlich)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Optionen
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Option           | Typ                       | Beschreibung                                                                                              |
+| ---------------- | ------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Intlayer-Konfigurations-Overrides, die an `getConfiguration()` weitergeleitet werden.                     |
+| `compilerConfig` | `Partial<CompilerConfig>` | Overrides für den Compiler-spezifischen Konfigurationsabschnitt (z. B. `enabled`, `output`, `filesList`). |
+
+### Beispiel
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Funktionsweise
+
+### Transformationsphase
+
+Für jede Quelldatei, die auf `compiler.filesList` passt, führt das Compiler-Plugin folgende Schritte aus:
+
+1. Übergibt den Dateiinhalt an `extractContent` aus `@intlayer/babel`.
+2. Ruft für jede gefundene Deklaration `onExtract` auf, wodurch die resultierende Wörterbuch-JSON-Datei in `compiler.output` geschrieben wird.
+3. Gibt den transformierten Quellcode zurück, bei dem Inline-Deklarationen durch Standardaufrufe von `useIntlayer('key')` / `getIntlayer('key')` ersetzt wurden.
+
+Unterstützte Dateitypen: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Wenn eine Komponentendatei im Entwicklungsmodus gespeichert wird, führt der Compiler folgende Schritte aus:
+
+1. Erkennt die Dateiänderung über Vites `handleHotUpdate`-Hook.
+2. Extrahiert den Inhalt der aktualisierten Datei erneut.
+3. Schreibt die aktualisierte Wörterbuch-JSON-Datei.
+4. Löst einen vollständigen Seitenreload aus (`server.ws.send({ type: 'full-reload' })`).
+
+Ein Debounce von 500 ms verhindert, dass das Schreiben des Wörterbuchs selbst (das ebenfalls ein Dateiänderungsereignis auslöst) eine unendliche Extraktionsschleife verursacht.
+
+### Deduplizierung
+
+`intlayerCompiler` verwendet denselben Deduplizierungsmechanismus (`createPrimaryInstanceGuard`) wie die anderen gebündelten Plugins. Wenn sowohl `intlayer()` (das den Compiler bündelt) als auch ein manueller `intlayerCompiler()`-Aufruf vorhanden sind, wird nur die erste registrierte Instanz ausgeführt — es werden keine Wörterbücher doppelt geschrieben.

package/docs/de/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerMinify Vite-Plugin-Dokumentation | vite-intlayer
+description: Vite-Plugin, das kompilierte Intlayer-Wörterbuch-JSON-Dateien minifiziert und optional Inhaltsfeldnamen maskiert, um die Bundle-Größe zu reduzieren.
+keywords:
+  - intlayerMinify
+  - vite
+  - plugin
+  - minify
+  - bundle size
+  - dictionary
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Dokumentation initialisiert"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` ist ein Vite-Plugin, das kompilierte Wörterbuch-JSON-Dateien während eines Produktions-Builds minifiziert. Es entfernt alle unnötigen Leerzeichen und benennt in Kombination mit `intlayerPrune` optional Inhaltsfeldnamen in kurze alphabetische Aliase (`a`, `b`, `c`, …) um, um die Bundle-Größe weiter zu reduzieren.
+
+> Das Plugin ist bereits automatisch enthalten und konfiguriert, wenn Sie [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vite-intlayer/intlayer.md) verwenden. Sie müssen es nur dann manuell registrieren, wenn Sie den Plugin-Stack selbst zusammenstellen.
+
+## Verwendung
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Aktivierungsbedingungen
+
+`intlayerMinify` ist **nur** aktiv, wenn alle drei folgenden Bedingungen erfüllt sind:
+
+1. Der Vite-Befehl lautet `build` (nicht `serve` / dev).
+2. `build.optimize` ist `true` (oder `undefined`, was standardmäßig `true` für Builds ist).
+3. `build.minify` ist in Ihrer Intlayer-Konfiguration auf `true` gesetzt.
+
+Es wird automatisch **deaktiviert**, wenn `editor.enabled` auf `true` gesetzt ist, da der Editor den vollständigen, für Menschen lesbaren Wörterbuchinhalt benötigt.
+
+## Was wird minifiziert
+
+Das Plugin zielt auf zwei Wörterbuchverzeichnisse ab (wie in `intlayer.system` aufgelöst):
+
+- `dictionariesDir` — statische Wörterbücher für alle Sprachen (z. B. `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — dynamische Wörterbücher pro Sprache
+
+> Wörterbücher im Fetch-Modus (`fetchDictionariesDir`) werden **nie** minifiziert, da sie zur Laufzeit von einer Remote-API unter ihren ursprünglichen Feldnamen bereitgestellt werden. Das Umbenennen von Feldern würde eine Diskrepanz zwischen der Serverantwort und den clientseitigen Eigenschaftszugriffen verursachen.
+
+## Feldnamen-Maskierung (Eigenschafts-Minifizierung)
+
+Wenn `intlayerPrune` die Codebasis analysiert und `pruneContext.dictionaryKeyToFieldRenameMap` befüllt hat, benennt `intlayerMinify` auch Inhaltsfeldnamen in kurze Aliase um. Zum Beispiel:
+
+```json
+// vorher
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// nachher (mit Maskierung)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Die entsprechenden Eigenschaftszugriffe in den Quelldateien werden durch den Babel-Durchlauf in `intlayerOptimize` umbenannt, sodass das Laufzeitverhalten unverändert bleibt.
+
+Interne Intlayer-Felder (`nodeType`, `translation` usw.) werden niemals umbenannt.
+
+## Edge-Case-Wörterbücher
+
+Wörterbücher, die in `pruneContext.dictionariesWithEdgeCases` gekennzeichnet sind (strukturelle Anomalien, die während der Prune-Phase festgestellt wurden), werden vollständig übersprungen — weder minifiziert noch maskiert —, um die Auslieferung fehlerhafter Daten zu vermeiden.
+
+## Qualifizierte Gruppen (Sammlungen / Varianten / Meta-Einträge)
+
+Bei Wörterbüchern mit einem `qualifierTypes`-Array (Sammlungen, Varianten und Meta-Einträge) behält das Plugin das `qualifierTypes`-Array und das `meta`-Side-Map wortwörtlich bei. Nur die `content`-Einträge werden in ihren Feldnamen maskiert. Die zusammengesetzten Schlüssel (die für den Selektor-Abgleich zur Laufzeit verwendet werden) werden niemals berührt.

package/docs/de/packages/vite-intlayer/intlayerProxy.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerProxy Vite-Plugin-Dokumentation | vite-intlayer
+description: Sprach-Routing-Middleware für Vite-Entwicklungs-/Vorschau-Server und Produktions-SSR. Verwaltet Spracherkennung, URL-Redirections und interne Rewrites.
+keywords:
+  - intlayerProxy
+  - vite
+  - plugin
+  - middleware
+  - locale
+  - routing
+  - internationalization
+  - i18n
+  - SSR
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerProxy
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "configOptions in ein einzelnes Option-Objekt zusammengeführt; Proxy in intlayer() gebündelt"
+author: aymericzip
+---
+
+# intlayerProxy
+
+`intlayerProxy` ist ein Vite-Plugin, das eine Sprach-Routing-Middleware für **jede Umgebung** registriert: Entwicklungs-Server, Vorschau-Server und Produktions-SSR (Nitro / TanStack Start).
+
+> **Seit Intlayer v9** ist `intlayerProxy` automatisch im Hauptplugin [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vite-intlayer/intlayer.md) enthalten und standardmäßig über `routing.enableProxy: true` aktiviert. Sie müssen es nur separat registrieren, wenn Sie eine Kontrolle auf niedrigerer Ebene benötigen oder es außerhalb des Standard-Setups von `intlayer()` verwenden.
+
+## Verwendung
+
+### Als Teil von `intlayer()` (empfohlen, v9+)
+
+Übergeben Sie `proxy`-Optionen an das Hauptplugin, anstatt `intlayerProxy` separat zu registrieren:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+### Standalone (falls erforderlich)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+## Optionen
+
+```ts
+import type { IntlayerProxyPluginOptions } from "vite-intlayer";
+```
+
+Alle Optionen sind optional und werden als einzelnes Objekt übergeben:
+
+| Option          | Typ                                 | Beschreibung                                                                                                                                                                                     |
+| --------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `ignore`        | `(req: IncomingMessage) => boolean` | Prädikat, das Anfragen vom Sprach-Routing ausschließt. Gibt `true` zurück, um eine Anfrage zu überspringen (z. B. API-Routen, Health-Checks).                                                    |
+| `configOptions` | `GetConfigurationOptions`           | Intlayer-Konfigurations-Overrides, die an `getConfiguration()` weitergeleitet werden. Verwenden Sie dies, wenn der Proxy eine bestimmte Konfigurationsdatei lesen oder Werte überschreiben soll. |
+
+### Beispiel
+
+```ts
+intlayerProxy({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+```
+
+## createIntlayerProxyHandler
+
+`createIntlayerProxyHandler` erstellt eine eigenständige, Framework-agnostische Node.js-Middleware `(req, res, next)`, die die gesamte Sprach-Routing-Logik enthält. Sie ist nützlich in Umgebungen, in denen die Vite-Plugin-API nicht verfügbar ist (z. B. ein reiner Node.js-Server oder ein benutzerdefiniertes Nitro-Modul).
+
+```ts
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+const handler = createIntlayerProxyHandler({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+
+// Express / Connect
+app.use(handler);
+```
+
+### Produktions-SSR (TanStack Start / Nitro über h3)
+
+```ts
+// server/middleware/intlayerProxy.ts
+import { fromNodeMiddleware } from "h3";
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+export default fromNodeMiddleware(
+  createIntlayerProxyHandler({
+    ignore: (req) => req.url?.startsWith("/api"),
+  })
+);
+```
+
+## Routing-Verhalten
+
+Die Middleware spiegelt die Routing-Logik der `next-intlayer`-Middleware wider und unterstützt alle Intlayer-Routing-Modi.
+
+### Routing-Modi
+
+| Modus           | URL im Browser sichtbar  | Verhalten                                                                                                                                        |
+| --------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `prefix`        | `/de/about`              | Standard. Sprachpräfix in der URL. Die Standardsprache leitet auf die URL ohne Präfix um, es sei denn, `prefix-all` ist aktiv.                   |
+| `prefix-all`    | `/en/about`, `/de/about` | Alle Sprachen — einschließlich der Standardsprache — sind immer präfigiert.                                                                      |
+| `no-prefix`     | `/about`                 | Keine Sprache in der URL. Die Sprache wird nur in Cookies gespeichert; URL-Rewrites erfolgen intern.                                             |
+| `search-params` | `/about?locale=de`       | Sprache wird als Query-Parameter übergeben. Leitet um, um den `locale`-Parameter hinzuzufügen/zu aktualisieren, wenn er fehlt oder veraltet ist. |
+
+### Erkennungspriorität
+
+1. URL-Pfadpräfix (z. B. `/de/about` → `de`).
+2. Cookie- / localStorage-Wert (`intlayer-locale`).
+3. `Accept-Language`-Header.
+4. `defaultLocale` aus der Konfiguration.
+
+### Automatischer Bypass
+
+Die Middleware leitet diese Anfragen immer direkt und ohne Sprachbehandlung weiter:
+
+- Anfragen, die dem `ignore`-Prädikat entsprechen.
+- `/node_modules/**`
+- `/@**` – Vite-Interna (`@vite/`, `@fs/`, `@id/` usw.).
+- `/_**` – Server-Interna (`__vite_ping`, `__manifest` usw.).
+- Anfragen, deren Pfad mit einer Dateiendung endet (statische Assets). Wenn ein Sprachpräfix im Pfad eines statischen Assets vorhanden ist (z. B. `/de/logo.png`), wird es entfernt, damit die Datei korrekt ausgeliefert werden kann.
+
+### Domain-Routing
+
+Wenn `routing.domains` in Ihrer Intlayer-Konfiguration konfiguriert ist, verarbeitet die Middleware das domänenübergreifende Sprach-Routing:
+
+- Eine Anfrage für `/zh/about` auf `intlayer.org` wird an `https://intlayer.zh/about` weitergeleitet, wenn `domains.zh = "intlayer.zh"`.
+- Eine Anfrage an `intlayer.zh/about` wird intern in `/zh/about` umgeschrieben, sodass der Routing-Parameter `[locale]` befüllt wird.
+
+### Schutz vor Redirect-Schleifen
+
+Die Middleware verfolgt die Anzahl der Weiterleitungen pro `originalUrl → newUrl`-Paar innerhalb eines gleitenden 2-Sekunden-Fensters. Mehr als 10 Weiterleitungen innerhalb dieses Fensters geben eine `500`-Antwort mit einem beschreibenden Fehler zurück, anstatt ewig im Kreis zu leiten.
+
+## Nitro / Produktions-SSR (automatische Injektion, v9+)
+
+Wenn `intlayerProxy` als Vite-Plugin verwendet wird, trägt es eine `.nitro`-Eigenschaft. Das Build-Plugin `nitro/vite` liest diese Eigenschaft und fügt sie in `nitroConfig.modules` ein, sodass `intlayerNitroHandler` automatisch als Nitro-Server-Middleware registriert wird — für das Produktions-SSR ist keine manuelle Konfiguration erforderlich.
+
+Der Nitro-Handler verwendet das Web Fetch API-Ereignismodell von h3 v2 (nicht `fromNodeMiddleware`), sodass er mit allen Nitro-Presets kompatibel ist: Node, Bun, Deno, Edge-Laufzeiten.
+
+## Veraltete Aliase
+
+| Veralteter Export          | Ersatz          |
+| -------------------------- | --------------- |
+| `intlayerMiddleware`       | `intlayerProxy` |
+| `intLayerMiddlewarePlugin` | `intlayerProxy` |

package/docs/de/packages/vue-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - vue-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname-Dienstprogramm hinzufügen"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Vereinheitlichte Dokumentation für alle Exporte"
@@ -59,6 +62,7 @@ import "vue-intlayer";
 | `useDictionaryAsync`   | Wie `useDictionary`, behandelt aber asynchrone Wörterbücher.                                                                                            | -                                                                                                                     |
 | `useDictionaryDynamic` | Wie `useDictionary`, behandelt aber dynamische Wörterbücher.                                                                                            | -                                                                                                                     |
 | `useLocale`            | Gibt die aktuelle Locale und eine Funktion zurück, um sie zu setzen.                                                                                    | -                                                                                                                     |
+| `usePathname`          | Gibt den aktuellen Pfadnamen (pathname) als `ComputedRef<string>` zurück, bei dem das Locale-Segment entfernt wurde. Reaktiv auf `popstate`.            | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vue-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Clientseitiges Composable zur Verwaltung von URL-Umschreibungen. Aktualisiert die URL automatisch, wenn eine lokalisierte Umschreibregel vorhanden ist. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vue-intlayer/useRewriteURL.md) |
 | `useIntl`              | Gibt das Intl-Objekt für die aktuelle Locale zurück.                                                                                                    | -                                                                                                                     |
 | `useLoadDynamic`       | Composable zum Laden dynamischer Wörterbücher.                                                                                                          | -                                                                                                                     |

package/docs/de/packages/vue-intlayer/usePathname.md

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Funktion Dokumentation | vue-intlayer
+description: Erfahren Sie, wie Sie die usePathname Funktion aus dem vue-intlayer Paket nutzen
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalisierung
+  - Dokumentation
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname-Dienstprogramm hinzufügen"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Init history"
+author: aymericzip
+---
+
+# Vue Integration: `usePathname` Dokumentation
+
+Die `usePathname` Funktion gibt den aktuellen Browser-Pfad (pathname) ohne das Locale-Segment als eine `ComputedRef<string>` in Vue zurück. Dies ist nützlich für den Aufbau einer Locale-basierten Navigation – zum Beispiel, um festzustellen, welcher Navigationspunkt aktiv ist – ohne den Locale-Präfix manuell entfernen zu müssen.
+
+## Importieren von `usePathname` in Vue
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## Übersicht
+
+`usePathname` erstellt eine berechnete Referenz (computed ref) in Vue, die `window.location.pathname` liest, das Locale-Präfix mittels `getPathWithoutLocale` entfernt und ihren Wert aktualisiert, wann immer der Browser ein `popstate` Ereignis auslöst (Zurück/Vorwärts-Navigation). Der Wert kann direkt in Ihren Vue-Templates oder Setup-Funktionen verwendet werden.
+
+## Verwendung
+
+```vue fileName="src/components/NavItem.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const props = defineProps<{
+  href: string;
+  label: string;
+}>();
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
+    {{ label }}
+  </a>
+</template>
+```
+
+## Rückgabewert
+
+| Typ                   | Beschreibung                                                                                     |
+| --------------------- | ------------------------------------------------------------------------------------------------ |
+| `ComputedRef<string>` | Vue Computed Ref, die den aktuellen Browser-Pfadnamen (pathname) ohne das Locale-Präfix enthält. |
+
+## Verhalten
+
+- **Locale-Bereinigung**: Entfernt das führende Locale-Segment (z.B. `/de/dashboard` → `/dashboard`).
+- **Reaktiv**: Aktualisiert den Wert bei jedem `popstate` Event (Browser-Vor/Zurück-Navigation).
+- **SSR-sicher**: Gibt `""` zurück, wenn `window` nicht verfügbar ist.
+- **Bereinigung (Cleanup)**: Der `popstate` Event-Listener wird bei Initialisierung global hinzugefügt und erfordert aufgrund der Verwaltung des Lebenszyklus durch Vue in der Regel keine manuelle komponentenspezifische Bereinigung.
+
+## Beispiel
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Dashboard" },
+  { href: "/settings", label: "Einstellungen" },
+];
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <nav>
+    <a
+      v-for="link in links"
+      :key="link.href"
+      :href="link.href"
+      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
+    >
+      {{ link.label }}
+    </a>
+  </nav>
+</template>
+```
+
+## Verwandt
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vue-intlayer/useLocale.md) — aktuelles Locale + Locale-Umschalter
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/intlayer/getPathWithoutLocale.md) — das von diesem Hook intern verwendete Hilfswerkzeug