@intlayer/docs 8.6.0 → 8.6.10

package/docs/nl/cli/init.md

@@ -0,0 +1,96 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: Initialiseer Intlayer
+description: Leer hoe u Intlayer in uw project kunt initialiseren.
+keywords:
+  - Initialiseren
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - init
+history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "Optie --no-gitignore toegevoegd"
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: "Commando init toegevoegd"
+---
+
+# Initialiseer Intlayer
+
+```bash
+npx intlayer init
+```
+
+Het `init` commando configureert Intlayer automatisch in uw project door de benodigde bestanden en instellingen aan te maken. Dit is de aanbevolen manier om met Intlayer aan de slag te gaan.
+
+## Aliassen:
+
+- `npx intlayer init`
+
+## Argumenten:
+
+- `--project-root [projectRoot]` - Optioneel. Specificeer de hoofdmap van het project. Indien niet opgegeven, zoekt het commando naar de projectmap vanaf de huidige werkmap.
+- `--no-gitignore` - Optioneel. Slaat het automatisch bijwerken van het `.gitignore`-bestand over. Als deze vlag is ingesteld, wordt `.intlayer` niet toegevoegd aan `.gitignore`.
+
+## Wat het doet:
+
+Het `init` commando voert de volgende configuratietaken uit:
+
+1. **Valideert projectstructuur** - Garandeert dat u zich in een geldige projectmap bevindt met een `package.json` bestand.
+2. **Werkt `.gitignore` bij** - Voegt `.intlayer` toe aan uw `.gitignore` bestand om gegenereerde bestanden uit te sluiten van versiebeheer (kan worden overgeslagen met `--no-gitignore`).
+3. **Configureert TypeScript** - Werkt eventuele `tsconfig.json` bestanden bij om Intlayer type-definities op te nemen (`.intlayer/**/*.ts`).
+4. **Maakt configuratiebestand aan** - Genereert een `intlayer.config.ts` (voor TypeScript-projecten) of `intlayer.config.mjs` (voor JavaScript-projecten) met standaardinstellingen.
+5. **Werkt Vite-config bij** - Indien een Vite-configuratiebestand wordt gedetecteerd, wordt de import voor de `vite-intlayer` plugin toegevoegd.
+6. **Werkt Next.js-config bij** - Indien een Next.js-configuratiebestand wordt gedetecteerd, wordt de import voor de `next-intlayer` plugin toegevoegd.
+
+## Voorbeelden:
+
+### Basis initialisatie:
+
+```bash
+npx intlayer init
+```
+
+Dit initialiseert Intlayer in de huidige map en detecteert automatisch de hoofdmap van het project.
+
+### Initialiseren met aangepaste projectmap:
+
+```bash
+npx intlayer init --project-root ./mijn-project
+```
+
+Dit initialiseert Intlayer in de opgegeven directory.
+
+### Initialiseren zonder .gitignore bij te werken:
+
+```bash
+npx intlayer init --no-gitignore
+```
+
+Dit configureert alle configuratiebestanden maar wijzigt uw `.gitignore` niet.
+
+## Voorbeeld van uitvoer:
+
+```bash
+npx intlayer init
+Checking Intlayer configuration...
+✓ Added .intlayer to .gitignore
+✓ Updated tsconfig.json to include intlayer types
+✓ Created intlayer.config.ts
+✓ Injected import into vite.config.ts
+✓ Intlayer init setup complete.
+```
+
+## Opmerkingen:
+
+- Het commando is idempotent - u kunt het veilig meerdere keren uitvoeren. Reeds geconfigureerde stappen worden overgeslagen.
+- Indien er al een configuratiebestand bestaat, wordt dit niet overschreven.
+- TypeScript-configuratiebestanden zonder een `include` array (bijv. solution-style configuraties met references) worden overgeslagen.
+- Het commando stopt met een foutmelding als er geen `package.json` wordt gevonden in de hoofdmap van het project.

package/docs/nl/cli/standalone.md

@@ -0,0 +1,91 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2026-03-31
+title: Standalone Bundel
+description: Leer hoe u een zelfstandige JavaScript-bundel van de applicatie-inhoud kunt maken.
+keywords:
+  - Standalone
+  - Bundel
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - standalone
+history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "Initialisatie van de documentatie voor het standalone commando"
+---
+
+# Standalone Bundel
+
+Met het `standalone` commando kunt u een zelfstandige JavaScript-bundel maken die Intlayer en eventuele andere gespecificeerde pakketten bevat. Dit is met name handig voor het gebruik van Intlayer in omgevingen zonder pakketbeheerder of bundler, zoals een eenvoudige HTML/JS-applicatie.
+
+De bundel maakt gebruik van [esbuild](https://esbuild.github.io/) om de gevraagde pakketten en hun afhankelijkheden te combineren in een enkel bestand dat eenvoudig in elk webproject kan worden geïmporteerd.
+
+## Gebruik
+
+```bash
+npx intlayer standalone --packages [pakketten...] [opties]
+```
+
+## Opties
+
+- `-o, --outfile [outfile]` - Optioneel. De naam van het uitvoerbestand. Standaard: `intlayer-bundle.js`.
+- `--packages [pakketten...]` - Vereist. Een lijst met pakketten die in de bundel moeten worden opgenomen (bijv. `intlayer`, `vanilla-intlayer`).
+- `--version [version]` - Optioneel. De versie van de pakketten die gebundeld moeten worden. Indien niet gespecificeerd, wordt standaard de versie van de Intlayer CLI gebruikt.
+- `--minify` - Optioneel. Of de uitvoer moet worden geminimaliseerd. Standaard: `true`.
+- `--platform [platform]` - Optioneel. Het doelplatform voor de bundel (bijv. `browser`, `node`). Standaard: `browser`.
+- `--format [format]` - Optioneel. Het uitvoerformaat voor de bundel (bijv. `esm`, `cjs`, `iife`). Standaard: `esm`.
+
+## Algemene Opties
+
+- `--env-file [envFile]` - Omgevingsbestand.
+- `-e, --env [env]` - Omgeving.
+- `--base-dir [baseDir]` - Basisdirectory.
+- `--no-cache` - Cache uitschakelen.
+- `--verbose` - Gedetailleerde uitvoer.
+
+## Voorbeelden:
+
+### Een bundel maken voor Vanilla JS:
+
+```bash
+npx intlayer standalone --packages intlayer vanilla-intlayer --outfile intlayer.js
+```
+
+Dit maakt een bestand `intlayer.js` aan met daarin zowel de `intlayer` als `vanilla-intlayer` pakketten, geminimaliseerd en in ESM-formaat, klaar voor gebruik in een browser via een `<script>` tag.
+
+### Een specifieke versie bundelen:
+
+```bash
+npx intlayer standalone --packages intlayer --version 8.6.4
+```
+
+### Bundelen met een ander formaat:
+
+```bash
+npx intlayer standalone --packages intlayer --format iife
+```
+
+## Wat het doet:
+
+1. **Maakt een tijdelijke omgeving aan** - Richt een tijdelijke directory in om afhankelijkheden te beheren.
+2. **Installeert pakketten** - Gebruikt `npm` of `bun` (indien beschikbaar) om de gevraagde pakketten en hun afhankelijkheden te installeren.
+3. **Genereert een toegangspunt** - Maakt een tijdelijk toegangspuntbestand aan dat alle gevraagde pakketten exporteert en ze blootstelt als globale variabelen bij uitvoering in een browser.
+4. **Bundelt met esbuild** - Gebruikt esbuild om alles te combineren in een enkel bestand, met toepassing van minimalisatie en formatering zoals gevraagd.
+5. **Genereert het bestand** - Schrijft de resulterende bundel naar het opgegeven uitvoerpad.
+
+## Globale Variabelen
+
+Wanneer de bundel in een browser wordt geladen, stelt deze de gevraagde pakketten bloot als globale variabelen op het `window` object. De variabelenamen zijn gebaseerd op de pakketnamen (bijv. `intlayer` wordt `Intlayer`, `vanilla-intlayer` wordt `VanillaIntlayer`).
+
+```javascript
+// Toegang tot Intlayer vanuit de bundel
+const { getLocaleName } = window.Intlayer;
+const { installIntlayer, useIntlayer } = window.VanillaIntlayer;
+```

package/docs/nl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-20
+updatedAt: 2026-04-08
 title: Configuratie (Configuration)
 description: Leer hoe u Intlayer configureert voor uw applicatie. Begrijp de verschillende instellingen en opties die beschikbaar zijn om Intlayer aan uw behoeften aan te passen.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.7.0
+    date: 2026-04-08
+    changes: "Opties `prune` en `minify` toegevoegd aan de buildconfiguratie"
+  - version: 8.7.0
+    date: 2026-04-03
+    changes: "`currentDomain` optie toegevoegd"
   - version: 8.4.0
     date: 2026-03-20
     changes: "Objectnotatie per locale toegevoegd voor 'compiler.output' en 'dictionary.fill'"
@@ -237,6 +243,17 @@ const config: IntlayerConfig = {
         fr: "/[locale]/a-propos",
       },
     }),
+
+    /**
+     * Koppelt locales aan domeinhastnamen voor domeingebaseerde routing.
+     * URL's voor deze locales zullen absoluut zijn (bijv. https://intlayer.cn/).
+     * Het domein impliceert de locale, dus er wordt geen locale-voorvoegsel aan het pad toegevoegd.
+     * Standaard: undefined
+     */
+    domains: {
+      en: "intlayer.org",
+      zh: "intlayer.cn",
+    },
   },
 
   /**
@@ -388,6 +405,25 @@ const config: IntlayerConfig = {
      */
     optimize: true,
 
+    /**
+     * Minimaliseer de woordenboeken om de bundelgrootte te verkleinen.
+     * Standaard: false
+     *
+     * Opmerking:
+     * - Deze optie wordt genegeerd als `optimize` is uitgeschakeld.
+     * - Deze optie wordt genegeerd als `editor.enabled` op true staat.
+     */
+    minify: true,
+
+    /**
+     * Verwijder ongebruikte sleutels in woordenboeken.
+     * Standaard: false
+     *
+     * Opmerking:
+     * - Deze optie wordt genegeerd als `optimize` is uitgeschakeld.
+     */
+    purge: true,
+
     /**
      * Uitvoerformaat voor gegenereerde woordenboekbestanden.
      * Standaard: ['cjs', 'esm']
@@ -597,12 +633,13 @@ Definieert de instellingen voor de ingebouwde visuele editor, inclusief de serve
 
 Instellingen die het gedrag van routing regelen, inclusief URL-structuur, opslag van locales en beheer van middleware.
 
-| Veld       | Beschrijving                                                                                                                                    | Type                                                                                                                                                                                                         | Standaard              | Voorbeeld                                                                                                                                                                                            | Opmerking                                                                                                                                                                                                                                                                         |
-| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`     | URL routingmodus voor het beheer van locales.                                                                                                   | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) of `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: locale wordt op andere manieren beheerd. `'search-params'`: `/dashboard?locale=fr` | Heeft geen invloed op het beheer van cookies of opslag van locales.                                                                                                                                                                                                               |
-| `storage`  | Configuratie van de opslag van de locale op de client.                                                                                          | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                   | Zie de tabel met opslagparameters hieronder.                                                                                                                                                                                                                                      |
-| `basePath` | Basispad voor de URL's van de applicatie.                                                                                                       | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                          | Als de applicatie op het adres `https://example.com/my-app` werkt, is basePath `'/my-app'` en worden URL's `https://example.com/my-app/en`.                                                                                                                                       |
-| `rewrite`  | Aangepaste URL-herschrijfregels die de standaard routingmodus overschrijven voor specifieke paden. Ondersteunt dynamische parameters `[param]`. | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | Zie voorbeeld hieronder                                                                                                                                                                              | • Herschrijfregels hebben voorrang op `mode`.<br/>• Werkt met Next.js en Vite.<br/>• `getLocalizedUrl()` past automatisch de juiste regels toe.<br/>• Zie [Aangepaste URL-herschrijvingen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
+| Veld       | Beschrijving                                                                                                                                                                                                          | Type                                                                                                                                                                                                         | Standaard              | Voorbeeld                                                                                                                                                                                            | Opmerking                                                                                                                                                                                                                                                                         |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`     | URL routingmodus voor het beheer van locales.                                                                                                                                                                         | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) of `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: locale wordt op andere manieren beheerd. `'search-params'`: `/dashboard?locale=fr` | Heeft geen invloed op het beheer van cookies of opslag van locales.                                                                                                                                                                                                               |
+| `storage`  | Configuratie van de opslag van de locale op de client.                                                                                                                                                                | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                   | Zie de tabel met opslagparameters hieronder.                                                                                                                                                                                                                                      |
+| `basePath` | Basispad voor de URL's van de applicatie.                                                                                                                                                                             | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                          | Als de applicatie op het adres `https://example.com/my-app` werkt, is basePath `'/my-app'` en worden URL's `https://example.com/my-app/en`.                                                                                                                                       |
+| `rewrite`  | Aangepaste URL-herschrijfregels die de standaard routingmodus overschrijven voor specifieke paden. Ondersteunt dynamische parameters `[param]`.                                                                       | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | Zie voorbeeld hieronder                                                                                                                                                                              | • Herschrijfregels hebben voorrang op `mode`.<br/>• Werkt met Next.js en Vite.<br/>• `getLocalizedUrl()` past automatisch de juiste regels toe.<br/>• Zie [Aangepaste URL-herschrijvingen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
+| `domains`  | Koppelt locales aan domeinhastnamen voor domeingebaseerde routing. Wanneer ingesteld, gebruiken URL's voor die locale dat domein als basis (absolute URL) en wordt er geen locale-voorvoegsel aan het pad toegevoegd. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                          | • Het standaardprotocol is `https://` wanneer dit niet in de hostnaam is opgenomen.<br/>• Het domein zelf identificeert de locale, dus er wordt geen `/zh/` voorvoegsel toegevoegd.<br/>• `getLocalizedUrl('/', 'zh')` retourneert `https://intlayer.zh/`.                        |
 
 **Voorbeeld `rewrite`**:
 
@@ -906,6 +943,8 @@ Build-opties worden toegepast op de plug-ins `@intlayer/babel` en `@intlayer/swc
 | ----------------- | --------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `mode`            | Beheert de buildmodus.                                                                  | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: de build wordt automatisch gestart tijdens de build van de applicatie.<br/>• `'manual'`: wordt alleen uitgevoerd bij een expliciete build-opdracht.<br/>• Kan worden gebruikt om de build van woordenboeken uit te schakelen (bijv. om uitvoering in Node.js-omgevingen te stoppen).                                                      |
 | `optimize`        | Beheert of er build-optimalisatie moet plaatsvinden.                                    | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Indien niet gedefinieerd, wordt optimalisatie gestart bij de build van het framework (Vite/Next.js).<br/>• `true` forceert optimalisatie zelfs in dev-modus.<br/>• `false` schakelt het uit.<br/>• Indien ingeschakeld, vervangt het woordenboekaanroepen voor chunking-optimalisatie.<br/>• Vereist plug-ins `@intlayer/babel` en `@intlayer/swc`. |
+| `minify`          | Minimaliseer de woordenboeken om de bundelgrootte te verkleinen.                        | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Geeft aan of de bundel moet worden geminimaliseerd.<br/>• Standaard: `true` in productie.<br/>• Deze optie wordt genegeerd als `optimize` is uitgeschakeld.<br/>• Deze optie wordt genegeerd als `editor.enabled` is waar.                                                                                                                          |
+| `purge`           | Verwijder ongebruikte sleutels in woordenboeken.                                        | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Geeft aan of de bundel moet worden opgeschoond.<br/>• Standaard: `true` in productie.<br/>• Deze optie wordt genegeerd als `optimize` is uitgeschakeld.                                                                                                                                                                                             |
 | `checkTypes`      | Geeft aan of de build TypeScript types moet controleren en fouten moet loggen.          | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Kan het buildproces vertragen.                                                                                                                                                                                                                                                                                                                        |
 | `outputFormat`    | Beheert het uitvoerformaat van woordenboeken.                                           | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                       |
 | `traversePattern` | Patronen die definieren welke bestanden tijdens de optimalisatie moeten worden gescand. | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Beperk de optimalisatie tot relevante bestanden voor het verhogen van de buildprestaties.<br/>• Zou worden genegeerd als `optimize` was uitgeschakeld.<br/>• Gebruikt glob-patronen.                                                                                                                                                                |

package/docs/nl/custom_domains.md

@@ -0,0 +1,250 @@
+---
+createdAt: 2026-04-02
+updatedAt: 2026-04-02
+title: Aangepaste domeinen
+description: Leer hoe u domeingebaseerde locale routing configureert in Intlayer om verschillende locales te bedienen vanaf speciale hostnames.
+keywords:
+  - Aangepaste domeinen
+  - Domeinrouting
+  - Routing
+  - Internationalisering
+  - i18n
+slugs:
+  - doc
+  - concept
+  - custom_domains
+history:
+  - version: 8.5.0
+    date: 2026-04-02
+    changes: "Domeingebaseerde locale routing toegevoegd via de routing.domains-configuratie."
+---
+
+# Aangepaste domeinen
+
+Intlayer ondersteunt domeingebaseerde locale routing, waardoor u specifieke locales kunt bedienen vanaf speciale hostnames. Chinese bezoekers kunnen bijvoorbeeld worden doorgeleid naar `intlayer.zh` in plaats van `intlayer.org/zh`.
+
+## Hoe het werkt
+
+De `domains`-map in `routing` koppelt elke locale aan een hostname. Intlayer gebruikt deze map op twee plaatsen:
+
+1. **URL-generatie** (`getLocalizedUrl`): wanneer de doel-locale op een _ander_ domein staat dan de huidige pagina, wordt een absolute URL geretourneerd (bijv. `https://intlayer.zh/about`). Wanneer beide domeinen overeenkomen, wordt een relatieve URL geretourneerd (bijv. `/fr/about`).
+2. **Serverproxy** (Next.js & Vite): inkomende verzoeken worden omgeleid of herschreven op basis van het domein waarop ze binnenkomen.
+
+### Exclusieve vs. gedeelde domeinen
+
+Het belangrijkste onderscheid is **exclusiviteit**:
+
+- **Exclusief domein** — er is slechts één locale aan die hostname gekoppeld (bijv. `zh → intlayer.zh`). Het domein zelf identificeert de locale, dus er wordt geen locale-prefix aan het pad toegevoegd. `https://intlayer.zh/about` bedient Chinese inhoud.
+- **Gedeeld domein** — er zijn meerdere locales aan dezelfde hostname gekoppeld (bijv. zowel `en` als `fr` zijn gekoppeld aan `intlayer.org`). Normale prefixgebaseerde routing is van toepassing. `intlayer.org/fr/about` bedient Franse inhoud.
+
+## Configuratie
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH,
+      Locales.CHINESE,
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    mode: "prefix-no-default",
+    domains: {
+      // Gedeeld domein — en en fr gebruiken prefix-routing op intlayer.org
+      en: "intlayer.org",
+      // Exclusief domein — zh heeft een eigen hostname, geen /zh/-prefix nodig
+      zh: "intlayer.zh",
+    },
+  },
+};
+
+export default config;
+```
+
+Locales die niet in `domains` staan, blijven de standaard prefix-routing gebruiken zonder domeinoverschrijving.
+
+## URL-generatie
+
+`getLocalizedUrl` genereert automatisch het juiste URL-type op basis van de aanroepende context.
+
+### Dezelfde-domein locale (relatieve URL)
+
+```ts
+// Huidige pagina: intlayer.org/about
+getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.org" });
+// → "/fr/about"
+
+getLocalizedUrl("/about", "en", { currentDomain: "intlayer.org" });
+// → "/about"  (standaard locale, geen prefix)
+```
+
+### Domeinoverschrijdende locale (absolute URL)
+
+```ts
+// Huidige pagina: intlayer.org/about
+getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.org" });
+// → "https://intlayer.zh/about"  (exclusief domein, geen /zh/-prefix)
+```
+
+### Bedienen vanaf het eigen domein van de locale
+
+```ts
+// Huidige pagina: intlayer.zh/about
+getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.zh" });
+// → "/about"  (al op het juiste domein — relatieve URL)
+
+getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
+// → "https://intlayer.org/fr/about"  (domeinoverschrijdende link terug naar intlayer.org)
+```
+
+### Automatische detectie van het huidige domein
+
+`currentDomain` is optioneel. Indien weggelaten, lost `getLocalizedUrl` dit in deze volgorde op:
+
+1. De hostname van een absolute input-URL (bijv. `https://intlayer.org/about` → `intlayer.org`).
+2. `window.location.hostname` in browseromgevingen.
+3. Als geen van beide beschikbaar is (SSR zonder expliciete optie), wordt een relatieve URL geretourneerd voor locales op hetzelfde domein en wordt er geen absolute URL gegenereerd — dit is de veilige fallback.
+
+```ts
+// Browser — window.location.hostname === 'intlayer.org'
+getLocalizedUrl("/about", "zh");
+// → "https://intlayer.zh/about"  (automatisch gedetecteerd door window)
+
+// Vanaf een absolute URL — domein automatisch gedetecteerd
+getLocalizedUrl("https://intlayer.org/about", "zh");
+// → "https://intlayer.zh/about"
+```
+
+### `getMultilingualUrls` met domeinen
+
+`getMultilingualUrls` roept `getLocalizedUrl` aan voor elke locale, dus het genereert een mix van relatieve en absolute URL's afhankelijk van het domein van de aanroeper:
+
+```ts
+// currentDomain: 'intlayer.org'
+getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
+// {
+//   en: "/about",
+//   fr: "/fr/about",
+//   es: "/es/about",
+//   zh: "https://intlayer.zh/about",
+// }
+```
+
+Deze absolute URL's zijn klaar voor gebruik in `<link rel="alternate" hreflang="...">` tags voor SEO.
+
+## Proxy-gedrag
+
+### Next.js
+
+De `intlayerProxy`-middleware handelt domeinrouting automatisch af. Voeg deze toe aan uw `middleware.ts`:
+
+```typescript fileName="middleware.ts"
+export { intlayerProxy as default } from "next-intlayer/proxy";
+
+export const config = {
+  matcher: "/((?!api|static|assets|robots|sitemap|.*\\..*|_next).*)",
+};
+```
+
+**Redirect** — verzoek komt binnen op het verkeerde domein voor een gegeven locale-prefix:
+
+```
+GET intlayer.org/zh/about
+→ 301 https://intlayer.zh/about
+```
+
+**Rewrite** — verzoek komt binnen op het exclusieve domein van de locale zonder prefix:
+
+```
+GET intlayer.zh/about
+→ herschrijven naar /zh/about  (alleen interne Next.js-routing, URL blijft schoon)
+```
+
+### Vite
+
+De `intlayerProxy` Vite-plugin past dezelfde logica toe tijdens ontwikkeling:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayerProxy } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerProxy()],
+});
+```
+
+> **Opmerking**: bij lokale ontwikkeling bevindt u zich meestal op `localhost`, dus domeinoverschrijdende omleidingen verwijzen naar de live domeinen in plaats van naar een andere lokale poort. Gebruik een hosts-bestandsoverschrijving (bijv. `127.0.0.1 intlayer.zh`) of een reverse proxy als u multidomeinrouting lokaal wilt testen.
+
+## Locale-kiezer (Locale Switcher)
+
+De `useLocale`-hook van `next-intlayer` handelt domeinbewuste navigatie automatisch af. Wanneer een gebruiker overschakelt naar een locale op een ander domein, voert de hook een volledige paginanavigatie uit (`window.location.href`) in plaats van een client-side routerpush, omdat de Next.js-router geen cross-origin navigatie kan uitvoeren.
+
+```tsx fileName="components/LocaleSwitcher.tsx"
+"use client";
+
+import { useLocale } from "next-intlayer";
+
+export const LocaleSwitcher = () => {
+  const { availableLocales, locale, setLocale } = useLocale();
+
+  return (
+    <ul>
+      {availableLocales.map((localeEl) => (
+        <li key={localeEl}>
+          <button
+            onClick={() => setLocale(localeEl)}
+            aria-current={localeEl === locale ? "true" : undefined}
+          >
+            {l.toUpperCase()}
+          </button>
+        </li>
+      ))}
+    </ul>
+  );
+};
+```
+
+Er is geen extra configuratie vereist — `useLocale` detecteert intern `window.location.hostname` en beslist tussen `router.replace` (hetzelfde domein) en `window.location.href` (ander domein).
+
+## SEO: `hreflang` alternatieve links
+
+Domeingebaseerde routing wordt vaak gebruikt in combinatie met `hreflang` om zoekmachines te laten weten welke URL ze moeten indexeren voor elke taal. Gebruik `getMultilingualUrls` om de volledige set alternatieve URL's te genereren:
+
+```tsx fileName="app/[locale]/layout.tsx"
+import { getMultilingualUrls } from "intlayer";
+import type { Metadata } from "next";
+
+export const generateMetadata = (): Metadata => {
+  const alternates = getMultilingualUrls("/", {
+    currentDomain: process.env.NEXT_PUBLIC_DOMAIN, // bijv. "intlayer.org"
+  });
+
+  return {
+    alternates: {
+      languages: alternates,
+    },
+  };
+};
+```
+
+Dit genereert:
+
+```html
+<link rel="alternate" hreflang="en" href="https://intlayer.org/" />
+<link rel="alternate" hreflang="fr" href="https://intlayer.org/fr/" />
+<link rel="alternate" hreflang="es" href="https://intlayer.org/es/" />
+<link rel="alternate" hreflang="zh" href="https://intlayer.zh/" />
+```
+
+## Kern-utilities
+
+| Utility                                           | Beschrijving                                                                                                          |
+| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `getLocalizedUrl(url, locale, { currentDomain })` | Retourneert relatieve of absolute URL, afhankelijk van of de doel-locale op het huidige domein staat.                 |
+| `getMultilingualUrls(url, { currentDomain })`     | Retourneert een locale-keyed map van gelokaliseerde URL's, waarbij relatief en absoluut naar behoefte worden gemengd. |
+| `getPrefix(locale, { domains })`                  | Retourneert een lege prefix voor exclusieve domeinlocales, anders de normale prefix.                                  |