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

package/docs/id/compat/i18n-js.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari i18n-js ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Anda dari i18n-js ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - i18n-js
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari i18n-js ke Intlayer
+
+Transisi dari library `i18n-js` ke Intlayer adalah migrasi yang sangat dioptimalkan, dirancang untuk memindahkan konfigurasi terjemahan besar ke sistem resolusi file terstruktur Intlayer.
+
+## Yang perlu dilakukan
+
+Jalankan perintah setup berikut di repositori Anda:
+
+```bash
+npx intlayer init
+```
+
+Setelah `intlayer.config.ts` disiapkan, Anda dapat menambahkan alias Intlayer ke konfigurasi bundler Anda sehingga impor apa pun dari `i18n-js` mengarah ke paket kompatibilitas `@intlayer/i18n-js`.
+
+## Yang terjadi di balik layar
+
+`i18n-js` mengakses namespace melalui ekspresi seperti `i18n.t('scope.key', {name})` bersama dengan fallback lokal dan pemetaan plural tertentu.
+
+Di balik layar:
+
+- **Interpolasi:** Adapter kompatibilitas dengan mudah mengurai pemetaan `%{name}` ke nilai kamus runtime yang ditargetkan.
+- **Pluralisasi:** Mengganti subkunci `one/other` dan memetakannya terhadap mekanisme plural yang mendasari Intlayer yang powerful (`Intl.PluralRules`), mengabstraksikan pemetaan manual.
+- **Lokal:** Alih-alih memuat payload bahasa monolitik saat bootstrap, kamus disajikan secara optimal berdasarkan pengaturan konteks saat ini melalui konfigurasi Intlayer native.

package/docs/id/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari i18next ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Vanilla JS/TS Anda dari i18next ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari i18next ke Intlayer
+
+Untuk tutorial langkah demi langkah yang terperinci, silakan lihat [Panduan Migrasi i18next](../migration_from_i18next_to_intlayer.md) lengkap kami.
+
+Intlayer mereplikasi dengan sempurna karakteristik runtime inti dari `i18next`. Dengan memanfaatkan paket kompatibilitas, aplikasi Vanilla Anda atau modul internal dapat terus menggunakan sintaks yang familiar.
+
+## Yang perlu dilakukan
+
+Untuk memulai, inisialisasi Intlayer di proyek Anda:
+
+```bash
+npx intlayer init
+```
+
+Jika Anda menggunakan Vite, sertakan plugin Intlayer untuk merutekan impor ke `@intlayer/i18next`:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## Yang terjadi di balik layar
+
+`i18nextVitePlugin` mengaliaskan impor `i18next` ke `@intlayer/i18next`, menghindari pembengkakan bundle dari penyertaan file JSON.
+
+Di balik layar:
+
+- **Konfigurasi instance:** `createInstance` dengan benar mengurai dan menerapkan fallback namespace sambil memanfaatkan pipeline kompilasi Intlayer untuk pengambilan kamus.
+- **Interpolasi:** Dukungan native untuk penggantian `{{name}}` dan nesting `$t(key)` secara rekursif.
+- **Konteks & Plural:** Mengidentifikasi dan menyelesaikan format sufiks seperti `key_male` dan `key_one`/`key_other` yang dievaluasi terhadap `Intl.PluralRules` standar.
+- **Mengembalikan objek:** Mode `returnObjects: true` dengan aman mengekstrak tree dari kamus Intlayer.

package/docs/id/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Adapter Kompatibilitas Intlayer"
+description: "Migrasikan solusi i18n Anda yang sudah ada ke Intlayer tanpa hambatan menggunakan adapter kompatibilitas."
+keywords:
+  - compat
+  - migration
+  - internationalization
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Adapter Kompatibilitas Intlayer
+
+Migrasi aplikasi besar ke library internasionalisasi baru bisa terasa berat. Untuk memudahkan transisi ini, Intlayer menyediakan **adapter kompatibilitas** untuk library i18n paling populer dalam ekosistem.
+
+Paket adapter ini mengekspos **API publik yang sama persis** dengan library i18n Anda yang sudah ada, namun mendelegasikan semua pekerjaan terjemahan ke Intlayer saat runtime.
+
+## Cara kerjanya
+
+Ketika Anda menggunakan adapter kompatibilitas, Anda tidak perlu menulis ulang impor aplikasi atau mengubah cara Anda menggunakan hook dan komponen terjemahan. Sebagai gantinya, plugin bundler Intlayer secara otomatis mengaliaskan impor yang ada ke paket kompatibilitas Intlayer.
+
+Sebagai contoh, seorang pengembang mengganti `import { useTranslation } from 'react-i18next'` dengan `import { useTranslation } from '@intlayer/react-i18next'` (dilakukan secara otomatis melalui plugin bundler), dan aplikasi terus bekerja dengan terjemahan yang kini disajikan dari kamus Intlayer. Kunci juga diketik terhadap kamus Intlayer Anda!
+
+## Adapter Kompatibilitas yang Tersedia
+
+Pilih library Anda yang sudah ada di bawah ini untuk melihat cara migrasi secara mulus:
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/id/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari Lingui ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Anda dari Lingui ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - lingui
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari Lingui ke Intlayer
+
+Jika proyek Anda saat ini mengandalkan kompilasi berbasis macro dari Lingui, transisi ke Intlayer memungkinkan Anda mempertahankan alur kerja macro yang powerful sambil mendukungnya secara native dengan strategi kompilasi JSON Intlayer.
+
+## Yang perlu dilakukan
+
+Untuk memulai, inisialisasi Intlayer di proyek Anda:
+
+```bash
+npx intlayer init
+```
+
+Ini akan membuat `intlayer.config.ts` Anda. Pastikan Anda tetap mempertahankan `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` di langkah build Anda untuk dijalankan _sebelum_ compiler Intlayer. Kemudian, gunakan alias plugin bundler untuk merutekan `@lingui/core` dan `@lingui/react` ke `@intlayer/lingui`.
+
+## Yang terjadi di balik layar
+
+Lingui menggunakan macro (seperti `` t`Hello ${name}` `` dan `<Trans>`) yang dikompilasi menjadi panggilan runtime seperti `i18n._(id, values)`.
+
+Di balik layar:
+
+- **Macro:** Mereka dikompilasi persis seperti sebelumnya, memastikan tidak ada gangguan dalam sintaks sumber Anda.
+- **Terjemahan runtime:** `i18n._()` yang dialiaskan menggunakan kamus Intlayer. ID yang diberi nama secara eksplisit maupun ID yang di-hash sepenuhnya dipetakan menggunakan plugin sinkronisasi `.po` Intlayer untuk mengagregasi dan memangkas kunci secara aman.
+- **Kemampuan ICU:** Dukungan untuk pluralisasi, seleksi, dan varian ICU tetap kuat berkat parser ICU terpadu Intlayer, memastikan output rendering yang identik.

package/docs/id/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari next-i18next ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Next.js Anda dari next-i18next ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari next-i18next ke Intlayer
+
+Untuk tutorial langkah demi langkah yang lengkap dan terperinci, silakan lihat [Panduan Migrasi next-i18next](../migration_from_next-i18next_to_intlayer.md) lengkap kami.
+
+Intlayer menangani semua implementasi Pages Router dan App Router Next.js secara transparan. Menggunakan adapter memungkinkan Anda migrasi implementasi `next-i18next` tanpa penulisan ulang kode sama sekali.
+
+## Yang perlu dilakukan
+
+Untuk memulai, jalankan:
+
+```bash
+npx intlayer init
+```
+
+Ini membuat file setup Intlayer yang diperlukan. Untuk beralih ke Intlayer di balik layar, perbarui `next.config.ts` Anda:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Yang terjadi di balik layar
+
+`createNextI18nPlugin` mengomposisikan perilaku native Next.js bersama plugin inti `next-intlayer`, menyuntikkan semua alias Webpack/Turbopack yang diperlukan untuk `next-i18next`, `react-i18next`, dan `i18next`.
+
+Di balik layar:
+
+- **`serverSideTranslations` & `appWithTranslation`:** Keduanya kini berfungsi sebagai wrapper untuk loader internal Intlayer, menghindari injeksi JSON statis yang besar.
+- **Hook klien:** Mendelegasikan langsung ke `@intlayer/react-i18next` yang mempertahankan semua fitur pemformatan, plural, dan namespace bersarang.

package/docs/id/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari next-intl ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Next.js Anda dari next-intl ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari next-intl ke Intlayer
+
+Untuk tutorial langkah demi langkah yang lengkap dan terperinci, silakan lihat [Panduan Migrasi next-intl](../migration_from_next-intl_to_intlayer.md) lengkap kami.
+
+Migrasi dari `next-intl` ke Intlayer memungkinkan Anda mempertahankan routing aplikasi dan sintaks Anda sepenuhnya tanpa gangguan.
+
+## Yang perlu dilakukan
+
+Jalankan perintah berikut di repositori Anda:
+
+```bash
+npx intlayer init
+```
+
+Ini akan membuat `intlayer.config.ts`. Di `next.config.ts` Anda, gunakan wrapper plugin untuk menyuntikkan alias `next-intl` ke `@intlayer/next-intl` secara mulus.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Yang terjadi di balik layar
+
+Wrapper bundler mengganti terjemahan, tetapi **membiarkan fitur `next-intl/navigation` tetap utuh** (misalnya `Link`, `redirect`, `usePathname`).
+
+Di balik layar:
+
+- **Runtime ICU:** Plural (`=0`, `one`, `other`), select/selectordinal, argumen `#`, dan argumen terformat (`{ts, date, long}`) berjalan dengan benar menggunakan resolver `resolveMessage(..., 'icu')` bersama.
+- **`useTranslations()` & `getTranslations()`:** Panggilan scope bare mengekstrak segmen kunci pertama sebagai pengenal kamus yang benar. Namespace bersarang secara elegan dibagi menjadi jalur kamus dan prefiks.
+- **Pemformatan kaya:** Baik `t.rich()` maupun `t.markup()` diimplementasikan secara native sepenuhnya, mengonversi node mirip HTML menjadi chunk React yang dirender.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange`, dan format bernama dari konfigurasi dijembatani ke formatter `Intl` native inti.

package/docs/id/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari Next Translate ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Next.js Anda dari next-translate ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari Next Translate ke Intlayer
+
+Migrasi dari `next-translate` ke Intlayer adalah penggantian drop-in yang hampir sempurna yang mempertahankan sintaks dan tag yang ada.
+
+## Yang perlu dilakukan
+
+Inisialisasi Intlayer di proyek Anda:
+
+```bash
+npx intlayer init
+```
+
+CLI akan membuat scaffolding konfigurasi Anda. Anda kemudian dapat menerapkan plugin Intlayer di `next.config.ts` Anda, yang menyuntikkan alias subpath waktu build yang memetakan `next-translate/useTranslation` ke `@intlayer/next-translate`.
+
+## Yang terjadi di balik layar
+
+`next-translate` menyediakan hook seperti `useTranslation('ns')`, `t('ns:key.path')`, dan komponen `<Trans>`.
+
+Di balik layar:
+
+- **Interpolasi & Plural:** Ini sangat bergantung pada perilaku adapter `react-i18next`. Placeholder `{{var}}` dan pluralisasi yang dipetakan dari sufiks seperti `key_0`, `key_one`, dan `key_other` ditangani secara dinamis.
+- **Komponen `<Trans>`:** Didukung langsung untuk parsing tag mirip HTML bersama prop `components` berbasis array.
+- **Namespace:** Aliasing subpath memastikan bahwa `useTranslation` Anda mereferensikan namespace kamus internal yang benar tanpa modifikasi manual.

package/docs/id/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari NGX-Translate ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Angular Anda dari ngx-translate ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari NGX-Translate ke Intlayer
+
+Migrasi aplikasi Angular Anda dari `ngx-translate` ke Intlayer mudah dilakukan dengan adapter kompatibilitas, memungkinkan Anda melewati kebutuhan untuk menulis ulang semua template Anda.
+
+## Yang perlu dilakukan
+
+Mulai dengan menjalankan:
+
+```bash
+npx intlayer init
+```
+
+Ini menyiapkan `intlayer.config.ts`. Ganti pengaturan `TranslateModule.forRoot()` Anda dan impor alias yang sesuai untuk menunjuk ke `@intlayer/ngx-translate`.
+
+## Yang terjadi di balik layar
+
+`ngx-translate` menggunakan `TranslateService` (`instant`, `get`, `stream`) bersama pipe `{{ 'KEY' | translate:params }}` dan direktif `[translate]`.
+
+Di balik layar:
+
+- **Layanan:** `TranslateService` membungkus `getIntlayer` dan observable lokal, menyediakan metode yang sama persis.
+- **Pipe & Direktif:** Diimplementasikan ulang untuk menyelesaikan langsung terhadap kamus Intlayer.
+- **Loader:** Pengaturan `TranslateHttpLoader` dikonversi menjadi stub peringatan karena Intlayer secara inheren menyelesaikan dan membundel kamus Anda saat waktu build (atau melalui dynamic import standar), sepenuhnya menghilangkan kebutuhan akan HTTP loader.

package/docs/id/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari NuxtJS I18n ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Nuxt.js Anda dari @nuxtjs/i18n ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari NuxtJS I18n ke Intlayer
+
+Migrasi aplikasi Nuxt Anda dari `@nuxtjs/i18n` ke Intlayer adalah proses yang mulus menggunakan modul adapter Nuxt.
+
+## Yang perlu dilakukan
+
+Untuk menginisialisasi proyek, jalankan:
+
+```bash
+npx intlayer init
+```
+
+Ini akan menyiapkan `intlayer.config.ts`. Kemudian, tambahkan modul Nuxt Intlayer (misalnya `@intlayer/nuxt-i18n`) di array modules `nuxt.config.ts` Anda. Ini secara otomatis menerapkan konfigurasi kompatibilitas untuk aplikasi Anda.
+
+## Yang terjadi di balik layar
+
+`@nuxtjs/i18n` membungkus `vue-i18n` sambil menyediakan composable routing khusus Nuxt (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Di balik layar:
+
+- **Terjemahan:** Bergantung secara native pada lapisan kompatibilitas `@intlayer/vue-i18n` untuk semua tugas terjemahan string (mendukung sepenuhnya format `vue-i18n`, plural pipe, dan reaktivitas).
+- **Routing:** Mencerminkan composable routing menggunakan helper URL yang dilokalisasi Intlayer.
+- **Konfigurasi:** Membaca `availableLocales` dan pengaturan default langsung dari `intlayer.config.ts` Anda untuk mengkoordinasikan halaman Nuxt secara otomatis.

package/docs/id/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari Polyglot.js ke Intlayer"
+description: "Pelajari cara migrasi dari Polyglot.js ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari Polyglot.js ke Intlayer
+
+Jika Anda menggunakan Polyglot.js dari Airbnb, migrasi ke Intlayer sangat mudah menggunakan lapisan kompatibilitas.
+
+## Yang perlu dilakukan
+
+Cukup jalankan perintah inisialisasi di proyek Anda:
+
+```bash
+npx intlayer init
+```
+
+Ini menghasilkan `intlayer.config.ts`. Anda kemudian dapat menggunakan alias plugin bundler untuk secara transparan mengalihkan impor Polyglot ke `@intlayer/polyglot`.
+
+## Yang terjadi di balik layar
+
+Sintaks Polyglot.js biasanya bergantung pada `polyglot.t('key', {name})` dengan interpolasi `%{name}` dan plural `smart_count` yang dipisahkan oleh `"singular |||| plural"`.
+
+Di balik layar:
+
+- **Interpolasi:** Lapisan kompatibilitas menangani placeholder `%{var}` secara native.
+- **Plural:** String dibagi pada `||||` dan dievaluasi terhadap `Intl.PluralRules` native sesuai dengan lokal aktif, mencerminkan urutan bucket Polyglot sendiri per lokal.
+- **Kamus:** Anda melewati kebutuhan untuk menyediakan konfigurasi JSON yang besar ke `new Polyglot()` - Intlayer menangani kamus secara dinamis dan memangkasnya secara otomatis.

package/docs/id/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari react-i18next ke Intlayer"
+description: "Pelajari cara migrasi aplikasi React Anda dari react-i18next ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari react-i18next ke Intlayer
+
+Untuk tutorial langkah demi langkah yang lengkap dan terperinci, silakan lihat [Panduan Migrasi react-i18next](../migration_from_react-i18next_to_intlayer.md) lengkap kami.
+
+Menggunakan adapter kompatibilitas Intlayer memungkinkan Anda migrasi dari `react-i18next` tanpa perubahan apa pun pada impor kode sumber Anda.
+
+## Yang perlu dilakukan
+
+Untuk menginisialisasi proyek, jalankan:
+
+```bash
+npx intlayer init
+```
+
+Selama inisialisasi, Intlayer akan menginstal `@intlayer/react-i18next` dan membuat `intlayer.config.ts`. Di bundler Anda (seperti Vite), terapkan plugin Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Yang terjadi di balik layar
+
+`reactI18nextVitePlugin` membungkus plugin inti `vite-intlayer` dan menyuntikkan alias resolve untuk `react-i18next` dan `i18next`, mengalihkannya ke `@intlayer/react-i18next` dan `@intlayer/i18next`.
+
+Di balik layar:
+
+- **`useTranslation` & `withTranslation`:** Ditulis ulang untuk menggunakan hook native Intlayer, memberikan Anda penyelesaian TypeScript otomatis untuk kunci kamus Anda. Ini mendukung namespace dengan mulus (misalnya `t('namespace:key')`).
+- **Plural & Konteks:** Menangani pluralisasi berbasis sufiks i18next (`key_one`, `key_other`) menggunakan `Intl.PluralRules` native dan sufiks konteks (`key_male`).
+- **Komponen `<Trans>`:** Diimplementasikan ulang untuk mendukung prop `components`, bentuk objek dan array, serta tag bernomor `<1>...</1>` yang langsung dipetakan ke node React Anda.
+- **Instance `i18n`:** Menyelesaikan kunci langsung dari Intlayer tanpa mengambil file JSON yang besar, menghasilkan ukuran bundle yang jauh lebih kecil.

package/docs/id/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari React Intl ke Intlayer"
+description: "Pelajari cara migrasi aplikasi React Anda dari react-intl ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari React Intl ke Intlayer
+
+Jika aplikasi React Anda menggunakan `react-intl` (FormatJS), transisi ke Intlayer sangat mudah. Lapisan kompatibilitas kami menangani ICU MessageFormat dan semua komponen `Formatted*` yang ada secara mulus.
+
+## Yang perlu dilakukan
+
+Mulai dengan menjalankan perintah inisialisasi di proyek Anda:
+
+```bash
+npx intlayer init
+```
+
+Kemudian, siapkan plugin Vite atau Next.js Intlayer di konfigurasi Anda. Plugin ini menyuntikkan alias waktu build untuk mengalihkan impor `react-intl` ke `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Yang terjadi di balik layar
+
+Plugin bundler mengaliaskan `react-intl` ke `@intlayer/react-intl`. Alih-alih mengurai file JSON yang besar secara manual dan membungkus aplikasi Anda dalam `IntlProvider`, plugin Intlayer mengekstrak kunci secara statis dan menggunakan kamus Intlayer saat runtime.
+
+Di balik layar:
+
+- **ICU MessageFormat:** Intlayer menggunakan resolver `resolveMessage(..., 'icu')` yang mendukung sepenuhnya pluralisasi ICU, seleksi, pemformatan tanggal/angka, dan tag teks kaya secara native.
+- **Pemanggil method & JSX:** `intl.formatMessage({ id: 'a.b' })` dan `<FormattedMessage id="a.b">` diidentifikasi oleh plugin compiler Intlayer (`@intlayer/babel` / `@intlayer/swc`), mengonversi kunci bertitik datar sehingga segmen pertama dengan benar menyelesaikan kunci kamus Intlayer.
+- **Formatter:** `<FormattedNumber>`, `<FormattedDate>`, dll., dijembatani ke `core/formatters` native menggunakan `Intl`.

package/docs/id/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrasi dari Svelte I18n ke Intlayer"
+description: "Pelajari cara migrasi aplikasi Svelte Anda dari svelte-i18n ke Intlayer menggunakan adapter kompatibilitas."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inisialisasi riwayat"
+author: aymericzip
+---
+
+# Migrasi dari Svelte I18n ke Intlayer
+
+Memindahkan aplikasi Svelte Anda dari `svelte-i18n` ke Intlayer hanya membutuhkan sebentar menggunakan adapter kompatibilitas.
+
+## Yang perlu dilakukan
+
+Cukup jalankan perintah inisialisasi di proyek Anda:
+
+```bash
+npx intlayer init
+```
+
+Ini menghasilkan `intlayer.config.ts`. Pastikan plugin SvelteKit / Vite Anda dibungkus dengan plugin alias Intlayer untuk memetakan `svelte-i18n` ke `@intlayer/svelte-i18n` secara mulus.
+
+## Yang terjadi di balik layar
+
+Svelte-i18n mengandalkan store yang banyak digunakan (`$_`, `$t`, `$format`, dll.) dan ICU MessageFormat.
+
+Di balik layar:
+
+- **Store:** Intlayer mem-proxy store `svelte-i18n`. `$_` menjadi derived store dari lokal saat ini yang mengembalikan resolver Intlayer.
+- **Kunci:** Kunci datar Anda (misalnya `$_('home.title')`) dievaluasi sehingga segmen jalur pertama mewakili kamus Intlayer.
+- **Sintaks ICU:** Ditangani sepenuhnya oleh resolver ICU bersama (parsing setara `intl-messageformat`).
+- **Formatter:** Panggilan `$date`, `$time`, `$number` dialihkan dengan aman ke formatter inti native Intlayer.
+- **Analisis Babel/SWC:** Analyzer Intlayer membaca pemanggil store Svelte (`$_`) di dalam file sumber `.svelte` Anda sebelum kompilasi untuk secara otomatis membangun chunk kamus yang relevan.