@intlayer/docs 8.12.4 → 9.0.0-canary.10

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook Dokumentation | solid-intlayer
+description: Erfahren Sie, wie Sie den usePathname Hook aus dem Paket solid-intlayer verwenden.
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalisierung
+  - Dokumentation
+  - Solid
+  - Solid.js
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - solid-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
+---
+
+# Solid Integration: `usePathname` Hook Dokumentation
+
+Der `usePathname` Hook gibt den aktuellen Browser-Pfadnamen (pathname) ohne das Locale-Segment als Solid `Accessor<string>` zurück. Dies ist nützlich für locale-sensitive Navigation — zum Beispiel um zu bestimmen, welches Navigationselement aktiv ist — ohne den Locale-Präfix manuell entfernen zu müssen.
+
+## Importieren von `usePathname` in Solid
+
+```typescript
+import { usePathname } from "solid-intlayer";
+```
+
+## Überblick
+
+`usePathname` erstellt ein reaktives Signal, das von `window.location.pathname` initialisiert wird, entfernt das Locale-Präfix über `getPathWithoutLocale` und aktualisiert das Signal, wann immer der Browser ein `popstate`-Ereignis auslöst (Zurück-/Vorwärtsnavigation). Der Ereignis-Listener wird automatisch über `onCleanup` bereinigt.
+
+## Nutzung
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { Component } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: Component<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+
+  return (
+    <a href={href} aria-current={pathname() === href ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## Rückgabewert
+
+| Typ                | Beschreibung                                                                                      |
+| ------------------ | ------------------------------------------------------------------------------------------------- |
+| `Accessor<string>` | Solid Accessor (reaktiver Getter), der den aktuellen Pfadnamen ohne das Locale-Präfix zurückgibt. |
+
+## Verhalten
+
+- **Locale-Entfernung**: Entfernt das führende Locale-Segment (z.B. `/de/dashboard` → `/dashboard`).
+- **Reaktiv**: Aktualisiert sich automatisch bei `popstate`-Ereignissen (Zurück / Vorwärts-Navigation im Browser).
+- **SSR-sicher**: Gibt `""` zurück, wenn `window` nicht verfügbar ist.
+- **Bereinigung**: Der `popstate`-Listener wird automatisch über Solids `onCleanup` entfernt.
+
+## Beispiel
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { Component } from "solid-js";
+import { For } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Dashboard" },
+  { href: "/settings", label: "Einstellungen" },
+];
+
+const Sidebar: Component = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <For each={links}>
+        {({ href, label }) => (
+          <a
+            href={href}
+            style={{ "font-weight": pathname() === href ? "bold" : "normal" }}
+          >
+            {label}
+          </a>
+        )}
+      </For>
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## Verwandte Dokumente
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/solid-intlayer/useLocale.md) — aktuelle Locale + Locale-Umschalter
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/intlayer/getPathWithoutLocale.md) — das zugrunde liegende Dienstprogramm, das von diesem Hook verwendet wird

package/docs/de/packages/solid-intlayer/useRewriteURL.md

@@ -14,6 +14,7 @@ slugs:
   - packages
   - solid-intlayer
   - useRewriteURL
+author: aymericzip
 ---
 
 # useRewriteURL-Hook

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

@@ -14,9 +14,13 @@ slugs:
   - svelte-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dienstprogramm usePathname hinzufügen"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Vereinheitlichte Dokumentation für alle Exporte"
+author: aymericzip
 ---
 
 # svelte-intlayer Paket
@@ -63,15 +67,16 @@ Importieren:
 import "svelte-intlayer";
 ```
 
-| Funktion               | Beschreibung                                                                                                                                 | Verwandte Doku                                                                                                           |
-| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `useIntlayer`          | Basierend auf `useDictionary`, injiziert jedoch eine optimierte Version des Dictionarys aus der generierten Deklaration.                     | -                                                                                                                        |
-| `useDictionary`        | Verarbeitet Objekte, die wie Dictionaries aufgebaut sind (key, content). Verarbeitet `t()`-Übersetzungen, enumerations, etc.                 | -                                                                                                                        |
-| `useDictionaryAsync`   | Wie `useDictionary`, behandelt jedoch asynchrone Dictionaries.                                                                               | -                                                                                                                        |
-| `useDictionaryDynamic` | Wie `useDictionary`, behandelt jedoch dynamische Dictionaries.                                                                               | -                                                                                                                        |
-| `useLocale`            | Gibt die aktuelle Locale zurück und eine Funktion, um sie zu setzen.                                                                         | -                                                                                                                        |
-| `useRewriteURL`        | Clientseitige Funktion zum Verwalten von URL-Rewrites. Aktualisiert die URL automatisch, wenn eine lokalisierte Rewrite-Regel vorhanden ist. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/svelte-intlayer/useRewriteURL.md) |
-| `useIntl`              | Gibt das Intl-Objekt für die aktuelle Locale zurück.                                                                                         | -                                                                                                                        |
+| Funktion               | Beschreibung                                                                                                                                    | Verwandte Doku                                                                                                           |
+| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `useIntlayer`          | Basierend auf `useDictionary`, injiziert jedoch eine optimierte Version des Dictionarys aus der generierten Deklaration.                        | -                                                                                                                        |
+| `useDictionary`        | Verarbeitet Objekte, die wie Dictionaries aufgebaut sind (key, content). Verarbeitet `t()`-Übersetzungen, enumerations, etc.                    | -                                                                                                                        |
+| `useDictionaryAsync`   | Wie `useDictionary`, behandelt jedoch asynchrone Dictionaries.                                                                                  | -                                                                                                                        |
+| `useDictionaryDynamic` | Wie `useDictionary`, behandelt jedoch dynamische Dictionaries.                                                                                  | -                                                                                                                        |
+| `useLocale`            | Gibt die aktuelle Locale zurück und eine Funktion, um sie zu setzen.                                                                            | -                                                                                                                        |
+| `usePathname`          | Gibt den aktuellen Pfadnamen (pathname) als `Readable<string>`-Store zurück, aus dem das Locale-Segment entfernt wurde. Reaktiv auf `popstate`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/svelte-intlayer/usePathname.md)     |
+| `useRewriteURL`        | Clientseitige Funktion zum Verwalten von URL-Rewrites. Aktualisiert die URL automatisch, wenn eine lokalisierte Rewrite-Regel vorhanden ist.    | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/svelte-intlayer/useRewriteURL.md) |
+| `useIntl`              | Gibt das Intl-Objekt für die aktuelle Locale zurück.                                                                                            | -                                                                                                                        |
 
 ### Markdown
 

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/svelte-intlayer/useRewriteURL.md

@@ -15,6 +15,7 @@ slugs:
   - packages
   - svelte-intlayer
   - useRewriteURL
+author: aymericzip
 ---
 
 # useRewriteURL-Hook

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

@@ -18,6 +18,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Vereinheitlichte Dokumentation für alle Exporte"
+author: aymericzip
 ---
 
 # Paket vite-intlayer

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

@@ -20,6 +20,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Dokumentation initialisiert"
+author: aymericzip
 ---
 
 # intlayer Vite Plugin Dokumentation

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.