@intlayer/docs 9.5.4 → 9.5.5

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

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
-title: Dokumentation des astro-intlayer-Pakets
-description: Astro-Integration für Intlayer, die die Einrichtung für sprachenbasiertes Routing und Wörterbuchverwaltung bereitstellt.
+updatedAt: 2026-09-19
+title: Dokumentation des astro-intlayer Pakets
+description: Astro-Integration für Intlayer, die Setup für locale-basiertes Routing, Middleware, Hooks, Client-Store und Wörterbuchverwaltung bereitstellt.
 keywords:
   - astro-intlayer
   - astro
@@ -14,15 +14,18 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Dokumentation für useIntlayer, useDictionary, useLocale Hooks, Middleware und Formatierer hinzugefügt"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Vereinheitlichte Dokumentation für alle Exporte"
 author: aymericzip
 ---
 
-# astro-intlayer-Paket
+# astro-intlayer Paket
 
-Das `astro-intlayer`-Paket stellt die notwendigen Werkzeuge bereit, um Intlayer in Astro-Anwendungen zu integrieren. Es konfiguriert sprachenbasiertes Routing und die Verwaltung von Wörterbüchern.
+Das Paket `astro-intlayer` bietet die erforderlichen Werkzeuge zur Integration von Intlayer in Astro-Anwendungen. Es konfiguriert locale-basiertes Routing, Wörterbuchverwaltung, Seiten-Umschreiben während des Builds, Request-Middleware und Hooks für den Zugriff auf mehrsprachige Inhalte in serverseitig gerenderten `.astro`-Komponenten und clientseitigen Skripten.
 
 ## Installation
 
@@ -34,22 +37,171 @@ npm install astro-intlayer
 
 ### Integration
 
-Das Paket `astro-intlayer` stellt eine Astro-Integration bereit, um Intlayer in Ihrem Projekt einzurichten.
+Das Paket `astro-intlayer` bietet eine Astro-Integration, die Intlayer in Ihrem Projekt einrichtet.
 
-Importieren:
+Import:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-oder zur Datei `astro.config.mjs` hinzufügen:
+oder Standard-Import in `astro.config.mjs`:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| Funktion   | Beschreibung                                                 |
-| ---------- | ------------------------------------------------------------ |
-| `intlayer` | Astro-Integration, die Intlayer in Ihrem Projekt einrichtet. |
+| Funktion   | Beschreibung                                                                                                                                                                                                          | Zugehörige Dokumentation                                                                                      |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Astro-Integration, die Wörterbücher vorbereitet, Vite-Plugins konfiguriert (Aliase, Routing-Proxy, Bereinigung), Request-Middleware automatisch registriert und vorgerenderte Seiten an umgeschriebenen URLs ausgibt. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/intlayer.md) |
+
+### Hooks (Server und Client)
+
+Import:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| Hook            | Beschreibung                                                                                                                                                                                               | Zugehörige Dokumentation                                                                                                |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Wählt ein Wörterbuch anhand seines Schlüssels aus und gibt dessen lokalisierten Inhalt zurück. Im `.astro`-Frontmatter liest es das Anfrage-Locale aus `Astro.locals`. Im `<script>` aus dem Client-Store. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | Transformiert ein Wörterbuchobjekt und gibt den Inhalt für das aufgelöste Locale zurück. Funktioniert im Frontmatter und in Client-Skripten.                                                               | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | Gibt das aktuelle Locale, das Standard-Locale, die verfügbaren Locales und eine Funktion zum Aktualisieren des Locales zurück.                                                                             | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useLocale.md)         |
+
+### Middleware (astro-intlayer/middleware)
+
+Import:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| Export      | Typ                 | Beschreibung                                                                                                                                                                 | Zugehörige Dokumentation                                                                                        |
+| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | Astro-Middleware, die das Anfrage-Locale erkennt und `Astro.locals.intlayer` anhängt. Wird automatisch von `intlayer()` registriert oder manuell zur Komposition importiert. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/onRequest.md) |
+
+### Dienstprogramme
+
+Import:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| Funktion            | Beschreibung                                                                                                                   | Zugehörige Dokumentation |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------ |
+| `getIntlayerLocals` | Hilfsfunktion zum Abrufen des aktuellen `IntlayerLocals`-Objekts aus dem Request-Speicherbereich außerhalb von `Astro.locals`. | -                        |
+
+### Client-Dienstprogramme (astro-intlayer/client)
+
+Import:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+Beim Import im Browser oder in Client-`<script>`-Tags verweist `astro-intlayer` automatisch auf `astro-intlayer/client` (bereitgestellt von `vanilla-intlayer`), was clientseitige Wörterbuch-Getter, Store-Abonnenten und Locale-Persistenz-Werkzeuge bereitstellt.
+
+### Formatierer (astro-intlayer/format)
+
+Import:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| Hook              | Beschreibung                                                                                                     |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Gibt eine Intl-Instanz gebunden an das Locale zurück mit Caching- und Abonnementfunktionen.                      |
+| `useDate`         | Gibt eine Datumsformatierungsfunktion gebunden an das aktuelle Locale zurück (`Intl.DateTimeFormat`).            |
+| `useNumber`       | Gibt eine Zahlenformatierungsfunktion gebunden an das aktuelle Locale zurück (`Intl.NumberFormat`).              |
+| `useCurrency`     | Gibt eine Währungsformatierungsfunktion gebunden an das aktuelle Locale zurück.                                  |
+| `usePercentage`   | Gibt eine Prozentformatierungsfunktion gebunden an das aktuelle Locale zurück.                                   |
+| `useRelativeTime` | Gibt eine relative Zeitformatierungsfunktion gebunden an das aktuelle Locale zurück (`Intl.RelativeTimeFormat`). |
+| `useList`         | Gibt eine Listenformatierungsfunktion gebunden an das aktuelle Locale zurück (`Intl.ListFormat`).                |
+| `useUnit`         | Gibt eine Einheitenformatierungsfunktion gebunden an das aktuelle Locale zurück.                                 |
+| `useCompact`      | Gibt eine kompakte Zahlenformatierungsfunktion gebunden an das aktuelle Locale zurück (z. B. `1.5K`).            |
+
+### HTML-Dienstprogramme (astro-intlayer/html)
+
+Import:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| Export            | Typ        | Beschreibung                                                       |
+| ----------------- | ---------- | ------------------------------------------------------------------ |
+| `renderHTML`      | `Function` | Eigenständige Hilfsfunktion zum Rendern von HTML-Knoten.           |
+| `useHTML`         | `Hook`     | Hook zum Abrufen des HTML-Provider-Kontexts und der Konfiguration. |
+| `useHTMLRenderer` | `Hook`     | Hook zum Abrufen einer vorkonfigurierten HTML-Renderer-Funktion.   |
+
+### Markdown-Dienstprogramme (astro-intlayer/markdown)
+
+Import:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| Export                | Typ        | Beschreibung                                                         |
+| --------------------- | ---------- | -------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Kompiliert Markdown-Zeichenfolgen in eine strukturierte Darstellung. |
+| `renderMarkdown`      | `Function` | Rendert Markdown-Inhalt in Ausgabeknoten.                            |
+| `parseMarkdown`       | `Function` | Analysiert rohen Markdown-Inhalt in einen AST.                       |
+| `useMarkdown`         | `Hook`     | Hook zum Abrufen des Markdown-Provider-Kontexts.                     |
+| `useMarkdownRenderer` | `Hook`     | Hook zum Abrufen einer vorkonfigurierten Markdown-Renderer-Funktion. |
+
+### Typen
+
+Import:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| Typ               | Beschreibung                                                                                           |
+| ----------------- | ------------------------------------------------------------------------------------------------------ |
+| `IntlayerLocals`  | Das an `Astro.locals.intlayer` angehängte Objekt mit `locale`, `defaultLocale` und `availableLocales`. |
+| `UseLocaleProps`  | Optionale Konfigurationseigenschaften, die von `useLocale()` akzeptiert werden.                        |
+| `UseLocaleResult` | Der Rückgabetyp von `useLocale()`, der Locale-Eigenschaften und Aktualisierungsmethoden bereitstellt.  |

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: intlayer Integrationsdokumentation | astro-intlayer
+description: Erfahren Sie, wie Sie die intlayer Astro-Integration in astro.config.mjs konfigurieren und verwenden.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - integration
+  - i18n
+  - Internationalisierung
+  - Dokumentation
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Integrationsdokumentation mit Middleware- und Hooks-Details aktualisiert"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "Initiale Dokumentation"
+author: aymericzip
+---
+
+# intlayer Astro Integrationsdokumentation
+
+Die `intlayer`-Integration für Astro konfiguriert Ihr Projekt für mehrsprachige Internationalisierung (i18n). Sie übernimmt die Wörterbuchvorbereitung zur Build-Zeit, die Injektion von Vite-Plugins, die automatische Registrierung der Request-Middleware und die Ausgabe lokalisierter vorgerenderter Seiten.
+
+## Verwendung
+
+Fügen Sie `intlayer()` zu Ihrer `astro.config.mjs` hinzu:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Das Codemod der Astro CLI (`astro add astro-intlayer`) generiert ebenfalls einen Standard-Import, der unterstützt wird:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## Beschreibung
+
+Die Integration bindet sich in den Build- und Laufzeit-Lebenszyklus von Astro ein:
+
+1. **Konfigurations-Setup (`astro:config:setup`)**:
+   - **Wörterbuchvorbereitung**: Bereitet Intlayer-Wörterbücher und generierte Typen vor dem Build-Lauf vor.
+   - **Vite-Plugins**: Injiziert Plugins für Vite-Aliase (für nahtlose Wörterbuchimporte), Locale-Routing-Proxys und Build-Bereinigung.
+   - **Middleware-Registrierung**: Injiziert automatisch `astro-intlayer/middleware` in die Middleware-Kette Ihres Projekts und füllt `Astro.locals.intlayer` bei jeder eingehenden Anfrage.
+2. **Build abgeschlossen (`astro:build:done`)**:
+   - **Seiten-Umschreibungen**: Überprüft lokalisierte URL-Umschreibungsregeln und gibt vorgerenderte HTML-Seiten an ihren entsprechenden lokalisierten Pfaden aus.
+
+## Was standardmäßig bereitgestellt wird
+
+Nach der Konfiguration kann Ihre Astro-Anwendung sofort Folgendes nutzen:
+
+- Die Hooks `useIntlayer`, `useDictionary` und `useLocale` im Frontmatter von `.astro`-Komponenten.
+- Das Objekt `Astro.locals.intlayer` in Astro-Endpunkten und -Seiten.
+- Clientseitige Importe in `<script>`-Blöcken, die dieselbe API mit reaktiven Updates widerspiegeln.
+- Integrierte Formatierer unter `astro-intlayer/format` (`useDate`, `useNumber`, `useCurrency`, etc.).
+
+## Zugehörige Dokumentation
+
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useLocale.md)
+- [Middleware `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/onRequest.md)

package/docs/de/packages/astro-intlayer/onRequest.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: onRequest Middleware Dokumentation | astro-intlayer
+description: Erfahren Sie, wie Sie die onRequest Middleware in Astro-Anwendungen verwenden, um das Anfrage-Locale aufzulösen und Astro.locals.intlayer zu füllen.
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - Internationalisierung
+  - Dokumentation
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Initiale Dokumentation"
+author: aymericzip
+---
+
+# onRequest Astro Middleware Dokumentation
+
+Die `onRequest`-Middleware aus `astro-intlayer/middleware` löst das Locale jeder eingehenden HTTP-Anfrage auf und füllt `Astro.locals.intlayer`.
+
+Wenn Sie die `intlayer()`-Integration in `astro.config.mjs` registrieren, wird diese Middleware automatisch injiziert. Sie müssen sie nur direkt importieren, wenn Sie Astro-Middleware manuell mit `sequence(...)` zusammenstellen.
+
+## Verwendung
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // Zugriff auf das aufgelöste Locale in Ihrer benutzerdefinierten Middleware
+  const { locale } = context.locals.intlayer;
+  console.log(`Bearbeite Anfrage für Locale: ${locale}`);
+
+  return next();
+});
+```
+
+## Beschreibung
+
+Die Middleware führt folgende Aufgaben aus:
+
+1. **Locale-Erkennung**:
+   - **URL**: Analysiert das URL-Pfadpräfix oder den Suchparameter `?locale=` (außer wenn `routing.mode` auf `no-prefix` gesetzt ist).
+   - **Cookies / Header**: Prüft gespeicherte Locale-Cookies oder benutzerdefinierte Header-Werte.
+   - **Accept-Language**: Verwendet als Fallback die bevorzugte Sprachverhandlung des Browsers.
+   - Für vorgerenderte Seiten (`context.isPrerendered`) wird das Locale ausschließlich aus der URL extrahiert, um Astro-Build-Warnungen zu vermeiden.
+2. **Kontext-Befüllung**: Füllt `Astro.locals.intlayer` mit:
+   - `locale`: Das aufgelöste Locale.
+   - `defaultLocale`: Das standardmäßige Fallback-Locale.
+   - `availableLocales`: Das Array der konfigurierten Locales.
+3. **AsyncLocalStorage-Bereich**: Bettet die nachfolgende Anforderungsverarbeitung in einen `AsyncLocalStorage`-Bereich ein, sodass `useIntlayer()`, `useDictionary()` und `useLocale()` auf den Anfragezustand zugreifen können, ohne Argumente zu übergeben.
+
+## Typ `IntlayerLocals`
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## Zugehörige Dokumentation
+
+- [`intlayer` Integration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useLocale.md)

package/docs/de/packages/astro-intlayer/useDictionary.md

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useDictionary Hook Dokumentation | astro-intlayer
+description: Erfahren Sie, wie Sie den useDictionary Hook in Astro-Komponenten und Skripten verwenden, um Wörterbuchobjekte aufzulösen.
+keywords:
+  - useDictionary
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - Internationalisierung
+  - Dokumentation
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Initiale Dokumentation"
+author: aymericzip
+---
+
+# useDictionary Hook Dokumentation
+
+Der `useDictionary`-Hook löst ein importiertes oder Inline-Wörterbuchobjekt auf und gibt seinen Inhalt für das aktuelle Locale in Astro-Anwendungen zurück.
+
+Im Gegensatz zu `useIntlayer`, das Wörterbücher nach Schlüssel aus der globalen Wörterbuchregistrierung abruft, arbeitet `useDictionary` direkt mit einem Wörterbuchobjekt.
+
+## Verwendung
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+Sie können auch mit `t()` definierte Inline-Wörterbücher übergeben:
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      de: "Alle Rechte vorbehalten.",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+      es: "Todos los derechos reservados.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## Parameter
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Ein Wörterbuchobjekt oder eine qualifizierte Wörterbuchgruppe.
+2. **`localeOrSelector`** (optional): Ein bestimmtes Locale oder Selektorobjekt (`{ item }`, `{ variant }`, optional mit `locale`).
+
+## Beschreibung
+
+Der Hook führt folgende Aufgaben aus:
+
+1. **Locale-Erkennung**: Auf dem Server bezieht er das Locale aus `Astro.locals.intlayer`. Im Browser verwendet er das Locale des Client-Stores.
+2. **Inhaltsverarbeitung**: Löst Übersetzungen (`t()`), Aufzählungen, Bedingungen und verschachtelte Strukturen gemäß dem aufgelösten Locale auf.
+3. **Selektoren**: Wendet alle in den Argumenten angegebenen Element- oder Variantenselektoren an.
+
+## Zugehörige Dokumentation
+
+- [`intlayer` Integration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useLocale.md)

package/docs/de/packages/astro-intlayer/useIntlayer.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useIntlayer Hook Dokumentation | astro-intlayer
+description: Erfahren Sie, wie Sie den useIntlayer Hook in Astro-Komponenten und Client-Skripten verwenden, um auf lokalisierte Inhalte zuzugreifen.
+keywords:
+  - useIntlayer
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - Internationalisierung
+  - Dokumentation
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Initiale Dokumentation"
+author: aymericzip
+---
+
+# useIntlayer Hook Dokumentation
+
+Mit dem Hook `useIntlayer` können Sie in Astro-Anwendungen lokalisierte Wörterbuchinhalte anhand eines Schlüssels abrufen.
+
+Er kann in zwei verschiedenen Kontexten unter demselben Importpfad aufgerufen werden:
+
+1. **Server / Frontmatter**: Innerhalb von `.astro`-Dateien löst er Inhalte automatisch unter Verwendung des in `Astro.locals.intlayer` gespeicherten Anfrage-Locales auf.
+2. **Browser / Client-`<script>`**: In Client-Skripten oder UI-Framework-Komponenten greift er auf die clientseitige Store-Implementierung zu (`vanilla-intlayer`).
+
+## Verwendung
+
+### Im Frontmatter von Astro-Komponenten
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### In Client-`<script>`-Blöcken
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## Parameter
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: Der eindeutige Schlüssel des Wörterbuchs (wie in Ihren `.content.ts`-Deklarationsdateien definiert).
+2. **`localeOrSelector`** (optional): Ein bestimmtes Locale oder ein Selektorobjekt (`{ item }`, `{ variant }`, optional mit `locale`). Falls angegeben, überschreibt dies das aus dem Anforderungskontext oder Client-Store ermittelte Locale.
+
+## Beschreibung
+
+Der Hook führt folgende Aufgaben aus:
+
+1. **Locale-Auflösung**:
+   - Auf dem Server liest er das aktive Locale aus `Astro.locals.intlayer` über einen von `astro-intlayer/middleware` initialisierten `AsyncLocalStorage`-Bereich.
+   - Im Browser liest er das aktive Locale aus dem Client-Speicher/Store.
+2. **Wörterbuch-Abruf**: Injiziert den Wörterbuchinhalt, der dem angegebenen Schlüssel entspricht.
+3. **Übersetzungsverarbeitung**: Löst Übersetzungen (`t()`), Aufzählungen, Bedingungen und Markdown in darstellungsfertigen Inhalt auf.
+
+## Zugehörige Dokumentation
+
+- [`intlayer` Integration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/intlayer.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useDictionary.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/astro-intlayer/useLocale.md)