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

package/docs/hi/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: नया Intlayer v9 - क्या नया है?
 description: जानें कि Intlayer v9 में क्या नया है। लोकप्रिय i18n लाइब्रेरीज़ के लिए ड्रॉप-इन कम्पैटिबिलिटी पैकेजेस और Collections, Variants, और Dynamic Records के लिए सपोर्ट का परिचय।
 keywords:
@@ -216,6 +216,42 @@ export default {
 
 ---
 
+## Vite Plugin: बंडल्ड Compiler & Proxy
+
+`intlayer()` Vite plugin अब **compiler** और **locale-routing proxy** को सीधे बंडल करता है, इसलिए अधिकांश projects को `vite.config.ts` में केवल एक ही plugin की आवश्यकता है:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: जब `compiler.enabled` सेट होता है और `compiler.output` path कॉन्फ़िगर की जाती है तो स्वचालित रूप से सक्रिय हो जाता है। आपको अब `intlayerCompiler()` को अलग से रजिस्टर करने की आवश्यकता नहीं है।
+- **Proxy**: नए `routing.enableProxy` option (`true` डिफ़ॉल्ट रूप से) के आधार पर स्वचालित रूप से सक्रिय हो जाता है। यह development, preview, और production SSR में locale detection / redirect / rewrite middleware को wire करता है। आपको अब `intlayerProxy()` को अलग से रजिस्टर करने की आवश्यकता नहीं है।
+
+### `routing.enableProxy` विकल्प
+
+एक नया `routing.enableProxy` विकल्प नियंत्रित करता है कि locale-routing proxy को plug किया गया है या नहीं। यह डिफ़ॉल्ट रूप से `true` होता है। इसे disable करें जब आप locale routing को स्वयं handle करना चाहते हैं:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // डिफ़ॉल्ट: true
+  },
+};
+
+export default config;
+```
+
+स्टैंडअलोन `intlayerCompiler()` और `intlayerProxy()` plugins advanced setups के लिए exported रहते हैं। उन्हें `intlayer()` के साथ register करना सुरक्षित है — प्रत्येक plugin स्वयं को deduplicate करता है और केवल एक बार चलता है।
+
+---
+
 ## v8 से माइग्रेशन नोट्स
 
 यदि आप v8 से अपग्रेड कर रहे हैं, तो ध्यान दें कि v9 में कोई ब्रेकिंग बदलाव (breaking changes) शामिल नहीं हैं। लेकिन यहाँ मुख्य बदलाव दिए गए हैं:

package/docs/hi/roadmap.md

@@ -29,6 +29,12 @@ Intlayer एक सामग्री प्रबंधन और अंतर
 
 ---
 
+## विषय-सूची
+
+<TOC/>
+
+---
+
 ## वर्तमान सुविधाएँ
 
 ### 1. सामग्री घोषणा

package/docs/id/autoFill.md

@@ -35,6 +35,26 @@ author: aymericzip
 
 **File deklarasi isi otomatis** dalam CI Anda adalah cara untuk mempercepat alur kerja pengembangan Anda.
 
+## Memahami perilaku
+
+Perintah `fill` mencakup dua mode:
+
+- **Complete**: Secara otomatis mengisi semua konten yang hilang untuk setiap locale dan mengedit file saat ini, atau file lain jika ditentukan. Artinya, mode complete akan melewatkan penerjemahan konten yang sudah ada, jika sudah diterjemahkan.
+- **Review**: Secara otomatis mengisi **semua** konten untuk setiap locale dan menghasilkan untuk file tertentu, atau file lain jika ditentukan.
+
+Perintah will akan memproses semua file deklarasi konten locale Anda. Artinya, tidak akan memproses konten jarak jauh dari CMS. CMS mencakup manajemen terjemahan sendiri.
+Jika Anda menggunakan plugin seperti `@intlayer/sync-json-plugin`, Intlayer akan mengubah file JSON menjadi file deklarasi konten locale. Artinya, file-file tersebut akan diproses oleh perintah `fill`.
+
+File yang baru dihasilkan mencakup instruksi `filled` sebagai metadata kamus. Instruksi ini akan digunakan oleh Intlayer untuk mengetahui apakah file telah diisi secara otomatis atau tidak, dan melewati file ini dari penerjemahan lagi jika ada.
+
+Intlayer juga akan mempertimbangkan instruksi berikut untuk pengisian otomatis:
+
+- Dari `.content.{ts|js|json}` Anda → instruksi `fill`
+- Dari file konfigurasi `.intlayer.config.ts` Anda → instruksi `dictionary.fill`
+- Akan diatur ke `true` secara default sebaliknya
+
+Untuk file deklarasi konten per-locale, instruksi `true` akan diganti dengan `./{{fileName}}.fill.content.json`. Ini karena file deklarasi konten per-locale tidak dapat menerima konten terlokalisasi tambahan. Jadi akan menghasilkan file baru untuk tidak menimpa file yang ada.
+
 ## Perilaku Default
 
 Secara default, `fill` diatur ke `true` secara global, yang berarti Intlayer akan secara otomatis mengisi semua file konten dan mengedit file itu sendiri. Perilaku ini dapat disesuaikan dengan beberapa cara:

package/docs/id/benchmark/solid.md

@@ -118,6 +118,28 @@ Kami membandingkan **empat strategi pemuatan**:
 - **Scoped static**: Menjaga kode tetap teratur (pemisahan logis) tanpa permintaan jaringan ekstra yang kompleks.
 - **Scoped dynamic**: Pendekatan terbaik untuk _code splitting_ dan performa. Meminimalkan memori dengan hanya memuat apa yang dibutuhkan oleh tampilan saat ini dan bahasa yang aktif.
 
+### Apa yang saya ukur:
+
+Saya menjalankan aplikasi multibahasa yang sama di browser nyata untuk setiap stack, kemudian mencatat apa yang benar-benar muncul di wire dan berapa lama waktu yang dibutuhkan. Ukuran dilaporkan **setelah kompresi web normal**, karena itu lebih dekat dengan apa yang orang-orang unduh daripada penghitungan sumber mentah.
+
+- **Ukuran library internationalization**: Setelah bundling, tree-shaking dan minification, ukuran library i18n adalah ukuran providers + hooks/primitives code dalam komponen kosong. Ini tidak termasuk loading file terjemahan. Ini menjawab betapa mahalnya library sebelum konten Anda memasuki gambar.
+
+- **JavaScript per halaman**: Untuk setiap rute benchmark, berapa banyak script yang browser tarik untuk kunjungan itu, rata-rata di seluruh halaman dalam suite (dan di seluruh locale di mana laporan menggabungkannya). Halaman berat adalah halaman lambat.
+
+- **Leakage dari locale lain**: Ini adalah konten halaman yang sama tetapi dalam bahasa lain yang akan dimuat secara tidak disengaja di halaman yang diaudit. Konten ini tidak perlu dan harus dihindari. (mis. konten halaman `/fr/about` dalam bundle halaman `/en/about`)
+
+- **Leakage dari rute lain**: Ide yang sama untuk **layar lain** dalam aplikasi: apakah salinannya berjalan bersama saat Anda hanya membuka satu halaman. (mis. konten halaman `/en/about` dalam bundle halaman `/en/contact`). Skor tinggi menunjukkan splitting yang lemah atau bundle yang terlalu luas.
+
+- **Ukuran bundle komponen rata-rata**: Piece UI umum diukur **satu per satu** alih-alih menyembunyikan dalam satu angka aplikasi raksasa. Ini menunjukkan apakah internationalization diam-diam mengobarkan komponen sehari-hari. Misalnya, jika komponen Anda di-rerender, itu akan memuat semua data itu dari memori. Melampirkan JSON besar ke komponen apa pun seperti menghubungkan toko besar data yang tidak digunakan yang akan memperlambat kinerja komponen Anda.
+
+- **Responsivitas pengalihan bahasa**: Saya membalik bahasa menggunakan kontrol aplikasi sendiri dan mencatat berapa lama waktu yang dibutuhkan sampai halaman jelas beralih, apa yang akan diperhatikan pengunjung, bukan langkah mikro lab.
+
+- **Rendering work setelah perubahan bahasa**: Tindak lanjut yang lebih sempit: berapa banyak upaya yang diambil interface untuk repaint untuk bahasa baru setelah switch dalam penerbangan. Berguna ketika waktu "terasa" dan biaya framework berbeda.
+
+- **Waktu loading halaman awal**: Dari navigasi ke browser mempertimbangkan halaman sepenuhnya dimuat untuk skenario yang saya uji. Baik untuk membandingkan cold start.
+
+- **Waktu hydration**: Ketika aplikasi mengeksposnya, berapa lama client menghabiskan waktu mengubah server HTML menjadi sesuatu yang benar-benar dapat Anda klik. Dash dalam tabel berarti implementasi itu tidak memberikan angka hydration yang andal dalam benchmark ini.
+
 ## Bintang GitHub
 
 Bintang GitHub adalah indikator kuat dari popularitas proyek, kepercayaan komunitas, dan relevansi jangka panjang. Meskipun bukan ukuran langsung dari kualitas teknis, bintang-bintang tersebut mencerminkan berapa banyak pengembang yang menganggap proyek tersebut berguna, mengikuti kemajuannya, dan kemungkinan akan mengadopsinya. Untuk memperkirakan nilai suatu proyek, bintang membantu membandingkan daya tarik di berbagai alternatif dan memberikan wawasan tentang pertumbuhan ekosistem.

package/docs/id/benchmark/svelte.md

@@ -116,6 +116,28 @@ Kami membandingkan **empat strategi pemuatan**:
 - **Scoped static**: Menjaga kode tetap teratur (pemisahan logis) tanpa permintaan jaringan ekstra yang kompleks.
 - **Scoped dynamic**: Pendekatan terbaik untuk _code splitting_ dan performa. Meminimalkan memori dengan hanya memuat apa yang dibutuhkan oleh tampilan saat ini dan bahasa yang aktif.
 
+### Apa yang saya ukur:
+
+Saya menjalankan aplikasi multibahasa yang sama di browser nyata untuk setiap stack, kemudian mencatat apa yang sebenarnya muncul di wire dan berapa lama waktu yang dibutuhkan. Ukuran dilaporkan **setelah kompresi web normal**, karena itu lebih dekat dengan apa yang orang unduh daripada hitungan sumber mentah.
+
+- **Ukuran library internationalization**: Setelah bundling, tree-shaking dan minification, ukuran library i18n adalah ukuran kode providers + stores dalam komponen kosong. Ini tidak termasuk pemuatan file terjemahan. Ini menjawab seberapa mahal library sebelum konten Anda memasuki gambaran.
+
+- **JavaScript per halaman**: Untuk setiap rute benchmark, berapa banyak script yang browser tarik untuk kunjungan itu, dirata-ratakan di seluruh halaman dalam suite (dan di seluruh locale di mana laporan menggabungkannya). Halaman berat adalah halaman lambat.
+
+- **Kebocoran dari locale lain**: Ini adalah konten halaman yang sama tetapi dalam bahasa lain yang akan dimuat secara tidak sengaja di halaman yang diaudit. Konten ini tidak perlu dan harus dihindari. (misalnya, konten halaman `/fr/about` dalam bundel halaman `/en/about`)
+
+- **Kebocoran dari rute lain**: Ide yang sama untuk **layar lain** di aplikasi: apakah salinannya ikut ketika Anda hanya membuka satu halaman. (misalnya, konten halaman `/en/about` dalam bundel halaman `/en/contact`). Skor tinggi menunjukkan pemisahan lemah atau bundel yang terlalu luas.
+
+- **Ukuran bundel komponen rata-rata**: Piece UI umum diukur **satu per satu** daripada bersembunyi di dalam satu angka aplikasi raksasa. Ini menunjukkan apakah internationalization diam-diam membengkak komponen sehari-hari. Misalnya, jika komponen Anda merender ulang, komponen akan memuat semua data itu dari memori. Melampirkan JSON raksasa ke komponen apa pun seperti menghubungkan penyimpanan data yang tidak digunakan yang akan memperlambat kinerja komponen Anda.
+
+- **Responsivitas switch bahasa**: Saya membalik bahasa menggunakan kontrol aplikasi sendiri dan mengukur berapa lama waktu yang dibutuhkan hingga halaman telah jelas beralih, apa yang akan diperhatikan pengunjung, bukan micro-step lab.
+
+- **Rendering work setelah perubahan bahasa**: Tindak lanjut yang lebih sempit: seberapa banyak upaya yang dibutuhkan antarmuka untuk melukis ulang bahasa baru setelah switch sedang berlangsung. Berguna ketika "terasa" waktu dan biaya framework menyimpang.
+
+- **Waktu pemuatan halaman awal**: Dari navigasi ke browser menganggap halaman sepenuhnya dimuat untuk skenario yang saya uji. Baik untuk membandingkan cold start.
+
+- **Waktu hydration**: Ketika aplikasi memperlihatkannya, berapa lama klien menghabiskan waktu mengubah HTML server menjadi sesuatu yang benar-benar bisa Anda klik. Tanda garis dalam tabel berarti implementasi itu tidak memberikan gambar hydration yang dapat diandalkan dalam benchmark ini.
+
 ## Bintang GitHub
 
 Bintang GitHub adalah indikator kuat dari popularitas proyek, kepercayaan komunitas, dan relevansi jangka panjang. Meskipun bukan ukuran langsung dari kualitas teknis, bintang-bintang tersebut mencerminkan berapa banyak pengembang yang menganggap proyek tersebut berguna, mengikuti kemajuannya, dan kemungkinan akan mengadopsinya. Untuk memperkirakan nilai suatu proyek, bintang membantu membandingkan daya tarik di berbagai alternatif dan memberikan wawasan tentang pertumbuhan ekosistem.

package/docs/id/benchmark/tanstack.md

@@ -124,6 +124,28 @@ Kami membandingkan **empat strategi pemuatan**:
 - **Scoped static**: Menjaga kode tetap teratur (pemisahan logis) tanpa permintaan jaringan ekstra yang kompleks.
 - **Scoped dynamic**: Pendekatan terbaik untuk _code splitting_ dan performa. Meminimalkan memori dengan memuat hanya apa yang dibutuhkan tampilan saat ini dan lokal yang aktif.
 
+### Apa yang saya ukur:
+
+Saya menjalankan aplikasi multibahasa yang sama di browser nyata untuk setiap stack, kemudian mencatat apa yang sebenarnya muncul di kabel dan berapa lama waktu yang dibutuhkan. Ukuran dilaporkan **setelah kompresi web normal**, karena itu lebih dekat dengan apa yang orang unduh daripada hitungan sumber mentah.
+
+- **Ukuran library Internationalization**: Setelah bundling, tree-shaking dan minification, ukuran library i18n adalah ukuran providers (misalnya `NextIntlClientProvider`) + hooks (misalnya `useTranslations`) code dalam komponen kosong. Ini tidak termasuk loading file terjemahan. Ini menjawab betapa mahalnya library sebelum konten Anda masuk ke dalam gambar.
+
+- **JavaScript per halaman**: Untuk setiap rute benchmark, berapa banyak script yang browser tarik dalam kunjungan itu, rata-rata di seluruh halaman dalam suite (dan di seluruh locale di mana laporan menggabungkannya). Halaman yang berat adalah halaman yang lambat.
+
+- **Leakage dari locale lain**: Ini adalah konten halaman yang sama tetapi dalam bahasa lain yang akan dimuat secara tidak sengaja di halaman yang diaudit. Konten ini tidak perlu dan harus dihindari. (misalnya konten halaman `/fr/about` dalam bundle halaman `/en/about`)
+
+- **Leakage dari rute lain**: Ide yang sama untuk **layar lain** di aplikasi: apakah copy mereka berjalan ketika Anda hanya membuka satu halaman. (misalnya konten halaman `/en/about` dalam bundle halaman `/en/contact`). Skor tinggi mengisyaratkan pemisahan yang lemah atau bundle yang terlalu luas.
+
+- **Ukuran bundle komponen rata-rata**: Piece UI umum diukur **satu per satu** daripada bersembunyi di dalam satu angka aplikasi raksasa. Ini menunjukkan apakah internationalization secara diam-diam menginflasi komponen sehari-hari. Misalnya, jika komponen Anda merender ulang, akan memuat semua data itu dari memori. Melampirkan JSON besar ke komponen apa pun seperti menghubungkan toko besar data yang tidak digunakan yang akan memperlambat performa komponen Anda.
+
+- **Responsivitas switch bahasa**: Saya membalik bahasa menggunakan kontrol aplikasi sendiri dan mengukur berapa lama hingga halaman telah jelas berubah, apa yang akan diperhatikan pengunjung, bukan langkah mikro lab.
+
+- **Rendering work setelah perubahan bahasa**: Follow-up yang lebih sempit: berapa banyak effort yang dibutuhkan interface untuk mengecat ulang untuk bahasa baru setelah switch sedang berlangsung. Berguna ketika waktu "felt" dan biaya framework berbeda.
+
+- **Waktu loading halaman awal**: Dari navigasi ke browser yang menganggap halaman sepenuhnya dimuat untuk skenario yang saya uji. Bagus untuk membandingkan cold starts.
+
+- **Hydration time**: Ketika aplikasi memamerkannya, berapa lama klien menghabiskan waktu mengubah server HTML menjadi sesuatu yang benar-benar bisa Anda klik. Dash dalam tabel berarti implementasi itu tidak memberikan angka hydration yang dapat diandalkan dalam benchmark ini.
+
 ## Bintang GitHub
 
 Bintang GitHub adalah indikator kuat dari popularitas proyek, kepercayaan komunitas, dan relevansi jangka panjang. Meskipun bukan ukuran langsung dari kualitas teknis, bintang-bintang tersebut mencerminkan berapa banyak pengembang yang menganggap proyek tersebut berguna, mengikuti kemajuannya, dan kemungkinan akan mengadopsinya. Untuk memperkirakan nilai suatu proyek, bintang membantu membandingkan daya tarik di berbagai alternatif dan memberikan wawasan tentang pertumbuhan ekosistem.

package/docs/id/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## GitHub Actions yang Dihasilkan
+
+Ketika Anda menjalankan `intlayer init`, Intlayer mendeteksi package manager Anda (npm, yarn, pnpm, atau bun) dan membuat dua workflow GitHub Actions di bawah `.github/workflows/`, dengan perintah yang sesuai dengan package manager tersebut:
+
+- **`intlayer-fill.yml`** — Pada setiap pull request, membangun kamus dan menjalankan `intlayer fill --git-diff --mode complete` untuk menghasilkan terjemahan yang hilang untuk kamus yang berubah, kemudian melakukan commit hasilnya kembali ke branch PR.
+- **`intlayer-test.yml`** — Pada setiap pull request, membangun kamus dan menjalankan `intlayer test`, gagal pada pemeriksaan ketika locale yang diperlukan kehilangan terjemahan.
+
+File workflow yang ada tidak pernah ditimpa. Untuk melewati scaffolding sepenuhnya, jalankan:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Memberikan akses AI ke alur kerja fill
+
+`intlayer-fill.yml` yang telah digenerate memerlukan akses AI. Dua opsi tersedia (dikonfigurasi di blok `env` workflow):
+
+1. **Kunci penyedia AI Anda sendiri** — Tambahkan secret `AI_API_KEY` di pengaturan repository Anda (Settings → Secrets and variables → Actions). Workflow meneruskannya melalui `--provider`, `--model`, dan `--api-key`.
+2. **Kunci akses Intlayer CMS** — Tambahkan secret `INTLAYER_CLIENT_ID` dan `INTLAYER_CLIENT_SECRET` dan integrasikan ke dalam bagian `editor` `intlayer.config` Anda. Kunci akses CMS memberikan akses AI melalui backend Intlayer.
+
+Workflow `intlayer-test.yml` tidak memerlukan akses AI apa pun.
+
 ## Penanganan Kesalahan
 
 - Jika `INTLAYER_PROJECT_CREDENTIALS` tidak disetel, perintah akan keluar dengan kesalahan.

package/docs/id/cli/fill.md

@@ -47,6 +47,14 @@ Poin-poin penting:
 - Mempertahankan terjemahan yang ada dengan tidak menimpa mereka.
 - Memproses file, potongan, dan locale secara paralel menggunakan sistem antrian untuk meningkatkan kecepatan.
 
+## Poin-Poin Kunci:
+
+- Membagi file JSON besar menjadi chunk untuk tetap berada dalam batas jendela konteks model AI.
+- Mencoba ulang terjemahan jika format output salah.
+- Menggabungkan konteks spesifik aplikasi dan file untuk meningkatkan akurasi terjemahan.
+- Mempertahankan terjemahan yang ada dengan tidak menimpanya.
+- Memproses file, chunk, dan locale secara paralel menggunakan sistem antrian untuk meningkatkan kecepatan.
+
 ## Alias:
 
 - `npx intlayer dictionaries fill`

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.