@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.8

package/docs/id/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentasi Plugin Vite intlayerCompiler | vite-intlayer
+description: Plugin Vite yang mengekstrak deklarasi konten Intlayer inline dari file komponen dan menulisnya ke file JSON kamus pada waktu build/transform.
+keywords:
+  - intlayerCompiler
+  - vite
+  - plugin
+  - kompilator
+  - konten
+  - kamus
+  - internasionalisasi
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Dibundel ke dalam intlayer(); inisialisasi dokumen"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` adalah plugin Vite yang memindai file sumber komponen untuk **deklarasi konten Intlayer inline** — konten yang ditentukan secara langsung di dalam komponen alih-alih di file `.content.ts` terpisah — dan menulisnya ke file JSON kamus selama fase transform.
+
+> **Sejak Intlayer v9** `intlayerCompiler` secara otomatis disertakan di dalam plugin utama [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/vite-intlayer/intlayer.md) ketika `compiler.enabled` bernilai `true` dan `compiler.output` diatur dalam konfigurasi Intlayer Anda. Anda hanya perlu mendaftarkannya secara terpisah ketika Anda ingin kontrol penuh atas konfigurasi khusus kompilator.
+
+## Penggunaan
+
+### Sebagai bagian dari `intlayer()` (direkomendasikan, v9+)
+
+Aktifkan kompilator melalui konfigurasi Intlayer Anda:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // tempat kamus yang diekstrak ditulis
+  },
+});
+```
+
+Kemudian gunakan plugin standar tanpa registrasi tambahan:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Mandiri (bila diperlukan)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Opsi
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Opsi             | Tipe                      | Deskripsi                                                                                        |
+| ---------------- | ------------------------- | ------------------------------------------------------------------------------------------------ |
+| `configOptions`  | `GetConfigurationOptions` | Override konfigurasi Intlayer yang diteruskan ke `getConfiguration()`.                           |
+| `compilerConfig` | `Partial<CompilerConfig>` | Override untuk bagian konfigurasi khusus kompilator (misalnya `enabled`, `output`, `filesList`). |
+
+### Contoh
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Cara kerjanya
+
+### Fase Transform
+
+Untuk setiap file sumber yang cocok dengan `compiler.filesList`, plugin kompilator:
+
+1. Meneruskan konten file melalui `extractContent` dari `@intlayer/babel`.
+2. Memanggil `onExtract` untuk setiap deklarasi yang ditemukan, yang menulis JSON kamus yang dihasilkan ke `compiler.output`.
+3. Mengembalikan kode sumber yang ditransformasikan dengan deklarasi inline yang digantikan oleh panggilan standar `useIntlayer('key')` / `getIntlayer('key')`.
+
+Jenis file yang didukung: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Ketika file komponen disimpan dalam mode pengembangan, kompilator:
+
+1. Mendeteksi perubahan file melalui hook `handleHotUpdate` Vite.
+2. Mengekstrak kembali konten dari file yang diperbarui.
+3. Menulis JSON kamus yang diperbarui.
+4. Memicu pemuatan ulang halaman penuh (`server.ws.send({ type: 'full-reload' })`).
+
+Debounce 500 ms mencegah penulisan kamus itu sendiri (yang juga memicu event perubahan file) menyebabkan lingkaran ekstraksi ulang yang tak terbatas.
+
+### Deduplikasi
+
+`intlayerCompiler` menggunakan mekanisme deduplikasi `createPrimaryInstanceGuard` yang sama dengan plugin bawaan lainnya. Ketika panggilan `intlayer()` (yang membundel kompilator) dan panggilan manual `intlayerCompiler()` ada, hanya instans terdaftar pertama yang berjalan — tidak ada kamus yang ditulis dua kali.

package/docs/id/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentasi Plugin Vite intlayerMinify | vite-intlayer
+description: Plugin Vite yang meminifikasi file JSON kamus Intlayer yang dikompilasi dan secara opsional mengaburkan nama bidang konten untuk mengurangi ukuran bundel.
+keywords:
+  - intlayerMinify
+  - vite
+  - plugin
+  - minify
+  - bundle size
+  - kamus
+  - internasionalisasi
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Inisialisasi dokumen"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` adalah plugin Vite yang meminifikasi file JSON kamus yang dikompilasi selama build produksi. Ini menghapus semua whitespace yang tidak perlu dan, ketika digabungkan dengan `intlayerPrune`, secara opsional mengganti nama bidang konten menjadi alias alfabet pendek (`a`, `b`, `c`, …) untuk lebih mengurangi ukuran bundel.
+
+> Plugin ini sudah disertakan dan dikonfigurasi secara otomatis saat Anda menggunakan [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/vite-intlayer/intlayer.md). Anda hanya perlu mendaftarkannya secara manual jika Anda menyusun plugin stack sendiri.
+
+## Penggunaan
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Kondisi aktivasi
+
+`intlayerMinify` aktif **hanya** jika ketiga hal berikut bernilai true:
+
+1. Perintah Vite adalah `build` (bukan `serve` / dev).
+2. `build.optimize` bernilai `true` (atau `undefined`, yang secara default bernilai `true` untuk build).
+3. `build.minify` bernilai `true` dalam konfigurasi Intlayer Anda.
+
+Ini secara otomatis **dinonaktifkan** ketika `editor.enabled` bernilai `true` karena editor memerlukan konten kamus yang lengkap dan dapat dibaca manusia.
+
+## Apa yang diminifikasi
+
+Plugin ini menargetkan dua lokasi kamus (seperti yang diselesaikan dari `intlayer.system`):
+
+- `dictionariesDir` — kamus semua-bahasa statis (misalnya `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — kamus dinamis per-bahasa
+
+> Kamus mode ambil (`fetchDictionariesDir`) **tidak pernah** diminifikasi karena disajikan dari API jarak jauh saat runtime menggunakan nama bidang asli mereka. Mengganti nama bidang akan membuat ketidakcocokan antara respons server dan akses properti di sisi klien.
+
+## Pengaburan nama bidang (minifikasi properti)
+
+Ketika `intlayerPrune` telah menganalisis codebase dan mengisi `pruneContext.dictionaryKeyToFieldRenameMap`, `intlayerMinify` juga mengganti nama bidang konten menjadi alias pendek. Sebagai contoh:
+
+```json
+// sebelum
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// sesudah (dengan pengaburan)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Akses properti file sumber yang sesuai diganti namanya oleh proses Babel di dalam `intlayerOptimize`, sehingga perilaku runtime tidak berubah.
+
+Bidang internal Intlayer (`nodeType`, `translation`, dll.) tidak pernah diganti namanya.
+
+## Kamus kasus khusus (Edge-cases)
+
+Kamus yang ditandai dalam `pruneContext.dictionariesWithEdgeCases` (anomali struktural yang terdeteksi selama fase prune) dilewati sepenuhnya — tidak diminifikasi maupun dikaburkan — untuk menghindari pengiriman data yang rusak.
+
+## Grup berkualifikasi (koleksi / varian / rekaman meta)
+
+Untuk kamus dengan array `qualifierTypes` (koleksi, varian, dan rekaman meta), plugin mempertahankan array `qualifierTypes` dan peta samping `meta` secara harfiah. Hanya entri `content` yang nama bidangnya dikaburkan. Kunci komposit (yang digunakan untuk pencocokan selektor saat runtime) tidak pernah disentuh.

package/docs/id/packages/vite-intlayer/intlayerProxy.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentasi Plugin Vite intlayerProxy | vite-intlayer
+description: Middleware perutean bahasa untuk server dev/preview Vite dan SSR produksi. Menangani deteksi bahasa, pengalihan URL, dan penulisan ulang internal.
+keywords:
+  - intlayerProxy
+  - vite
+  - plugin
+  - middleware
+  - bahasa
+  - perutean
+  - internasionalisasi
+  - i18n
+  - SSR
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerProxy
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Menggabungkan configOptions ke dalam satu objek options; proxy dibundel ke dalam intlayer()"
+author: aymericzip
+---
+
+# intlayerProxy
+
+`intlayerProxy` adalah plugin Vite yang mendaftarkan middleware perutean bahasa untuk **setiap lingkungan**: server dev, server preview, dan SSR produksi (Nitro / TanStack Start).
+
+> **Sejak Intlayer v9** `intlayerProxy` secara otomatis disertakan di dalam plugin utama [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/vite-intlayer/intlayer.md) dan diaktifkan secara default melalui `routing.enableProxy: true`. Anda hanya perlu mendaftarkannya secara terpisah jika Anda memerlukan kontrol tingkat yang lebih rendah atau menggunakannya di luar setup `intlayer()` standar.
+
+## Penggunaan
+
+### Sebagai bagian dari `intlayer()` (direkomendasikan, v9+)
+
+Teruskan opsi `proxy` ke plugin utama alih-alih mendaftarkan `intlayerProxy` secara terpisah:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+### Mandiri (bila diperlukan)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+## Opsi
+
+```ts
+import type { IntlayerProxyPluginOptions } from "vite-intlayer";
+```
+
+Semua opsi bersifat opsional dan diteruskan sebagai satu objek:
+
+| Opsi            | Tipe                                | Deskripsi                                                                                                                                                                 |
+| --------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ignore`        | `(req: IncomingMessage) => boolean` | Predikat yang mengecualikan permintaan dari perutean bahasa. Kembalikan `true` untuk melewati permintaan (misalnya rute API, pemeriksaan kesehatan).                      |
+| `configOptions` | `GetConfigurationOptions`           | Override konfigurasi Intlayer yang diteruskan ke `getConfiguration()`. Gunakan saat Anda memerlukan proxy untuk membaca file konfigurasi tertentu atau mengabaikan nilai. |
+
+### Contoh
+
+```ts
+intlayerProxy({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+```
+
+## createIntlayerProxyHandler
+
+`createIntlayerProxyHandler` membuat middleware Node.js `(req, res, next)` yang mandiri dan tidak bergantung pada framework yang berisi semua logika perutean bahasa. Berguna dalam lingkungan di mana API plugin Vite tidak tersedia (misalnya server Node.js biasa atau modul Nitro khusus).
+
+```ts
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+const handler = createIntlayerProxyHandler({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+
+// Express / Connect
+app.use(handler);
+```
+
+### SSR Produksi (TanStack Start / Nitro melalui h3)
+
+```ts
+// server/middleware/intlayerProxy.ts
+import { fromNodeMiddleware } from "h3";
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+export default fromNodeMiddleware(
+  createIntlayerProxyHandler({
+    ignore: (req) => req.url?.startsWith("/api"),
+  })
+);
+```
+
+## Perilaku perutean
+
+Middleware ini mencerminkan logika perutean dari middleware `next-intlayer` dan mendukung semua mode perutean Intlayer.
+
+### Mode perutean
+
+| Mode            | URL terlihat di browser  | Perilaku                                                                                                                                |
+| --------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `prefix`        | `/id/about`              | Default. Prefiks bahasa di URL. Bahasa default dialihkan ke URL tanpa prefiks kecuali `prefix-all` aktif.                               |
+| `prefix-all`    | `/en/about`, `/id/about` | Semua bahasa — termasuk default — selalu diberi prefiks.                                                                                |
+| `no-prefix`     | `/about`                 | Tidak ada bahasa di URL. Bahasa hanya disimpan di cookie; penulisan ulang URL terjadi secara internal.                                  |
+| `search-params` | `/about?locale=id`       | Bahasa diteruskan sebagai parameter kueri. Mengalihkan untuk menambahkan/memperbarui parameter `locale` ketika hilang atau kedaluwarsa. |
+
+### Prioritas deteksi
+
+1. Prefiks jalur URL (misalnya `/id/about` → `id`).
+2. Nilai cookie / localStorage (`intlayer-locale`).
+3. Header `Accept-Language`.
+4. `defaultLocale` dari konfigurasi.
+
+### Bypass otomatis
+
+Middleware selalu meloloskan permintaan ini secara langsung tanpa penanganan bahasa:
+
+- Permintaan yang cocok dengan predikat `ignore`.
+- `/node_modules/**`
+- `/@**` – Internal Vite (`@vite/`, `@fs/`, `@id/`, dll.).
+- `/_**` – Internal server (`__vite_ping`, `__manifest`, dll.).
+- Permintaan yang jalurnya diakhiri dengan ekstensi file (aset statis). Jika prefiks bahasa ada pada jalur aset statik (misalnya `/id/logo.png`), prefiks tersebut akan dilucuti agar file dapat disajikan dengan benar.
+
+### Perutean domain
+
+Ketika `routing.domains` dikonfigurasi dalam konfigurasi Intlayer Anda, middleware menangani perutean bahasa lintas domain:
+
+- Permintaan untuk `/zh/about` di `intlayer.org` dialihkan ke `https://intlayer.zh/about` ketika `domains.zh = "intlayer.zh"`.
+- Permintaan ke `intlayer.zh/about` ditulis ulang secara internal ke `/zh/about` sehingga parameter rute `[locale]` terisi.
+
+### Perlindungan pengalihan tak terbatas (Redirect loop protection)
+
+Middleware melacak jumlah pengalihan per pasangan `originalUrl → newUrl` dalam jendela geser 2 detik. Lebih dari 10 pengalihan dalam jendela tersebut akan mengembalikan respons `500` dengan deskripsi kesalahan alih-alih mengulang selamanya.
+
+## Nitro / SSR produksi (injeksi otomatis, v9+)
+
+Ketika `intlayerProxy` digunakan sebagai plugin Vite, ia membawa properti `.nitro`. Plugin build `nitro/vite` membaca properti ini dan memasukkannya ke dalam `nitroConfig.modules`, sehingga `intlayerNitroHandler` terdaftar sebagai middleware server Nitro secara otomatis — tidak diperlukan konfigurasi manual untuk SSR produksi.
+
+Handler Nitro menggunakan model event Web Fetch API h3 v2 (bukan `fromNodeMiddleware`) sehingga kompatibel dengan semua preset Nitro: Node, Bun, Deno, edge runtimes.
+
+## Alias yang tidak digunakan lagi (Deprecated)
+
+| Ekspor yang tidak digunakan lagi | Pengganti       |
+| -------------------------------- | --------------- |
+| `intlayerMiddleware`             | `intlayerProxy` |
+| `intLayerMiddlewarePlugin`       | `intlayerProxy` |

package/docs/id/plugins/sync-json.md

@@ -108,7 +108,6 @@ const config: IntlayerConfig = {
      * Will load, and write the output and translations back to the JSON files in the locales directory
      */
     syncJSON({
-      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       priority: 0,
       format: "i18next",

package/docs/id/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-23
+updatedAt: 2026-06-26
 title: Intlayer v9 Baru - Apa yang baru?
-description: Temukan apa yang baru di Intlayer v9. Memperkenalkan paket kompatibilitas drop-in untuk pustaka i18n populer dan dukungan untuk Collections, Variants, dan Dynamic Records.
+description: Temukan apa yang baru di Intlayer v9. Memperkenalkan paket kompatibilitas drop-in untuk pustaka i18n populer dan dukungan untuk Collections dan Variants.
 keywords:
   - Intlayer
   - Kompatibilitas
   - Migrasi
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # Intlayer v9 Baru - Apa yang baru?
 
-Selamat datang di Intlayer v9! Rilis besar ini menandai tonggak sejarah besar dalam menyederhanakan jalur migrasi ke Intlayer dengan **Compat Adapter Packages** untuk pustaka i18n utama (`react-i18next`, `next-intl`, `vue-i18n`, dll.) dan menambahkan dukungan untuk struktur konten yang kaya: **Collections**, **Variants**, dan **Dynamic Records**.
+Selamat datang di Intlayer v9! Rilis besar ini menandai tonggak sejarah besar dalam menyederhanakan jalur migrasi ke Intlayer dengan **Compat Adapter Packages** untuk pustaka i18n utama (`react-i18next`, `next-intl`, `vue-i18n`, dll.) dan menambahkan dukungan untuk struktur konten yang kaya: **Collections** dan **Variants**.
 
 ## Daftar Isi
 
@@ -41,8 +40,10 @@ Dengan mengganti impor, Anda mendapatkan semua manfaat Intlayer (termasuk type s
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Sebagai contoh, cukup ubah:
 
@@ -100,7 +101,7 @@ Semua compat adapter sekarang merutekan resolusi terjemahan melalui satu parser
 
 ---
 
-## Spesifikasi Fitur: Collections, Variants & Dynamic Records
+## Spesifikasi Fitur: Collections & Variants
 
 Intlayer v9 berkembang melampaui objek key-value statis, memungkinkan dictionary untuk mendeklarasikan struktur tata letak dinamis yang sepenuhnya bertipe (fully typed) dari ujung ke ujung (end-to-end).
 
@@ -144,6 +145,8 @@ const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: s
 
 Sajikan pengujian A/B (A/B tests), header musiman, feature flags, atau landing page kustom:
 
+#### Varian string (misal, pengujian A/B)
+
 ```ts fileName="hero.content.ts"
 import { t, type Dictionary } from "intlayer";
 
@@ -167,16 +170,14 @@ export default {
 const banner = useIntlayer("hero-banner", { variant: "black_friday" });
 ```
 
-### 3. Dynamic Records
-
-Definisikan dictionary yang entrinya dimuat secara dinamis pada saat runtime melalui ID kueri:
+#### Varian objek (misal, Dynamic Records)
 
 ```ts fileName="product.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "product-copy",
-  meta: {
+  variant: {
     id: "prod_123",
     category: "books",
   },
@@ -229,7 +230,7 @@ export default defineConfig({
 });
 ```
 
-- **Compiler**: Diaktifkan secara otomatis ketika `compiler.enabled` diatur dan jalur `compiler.output` dikonfigurasi. Anda tidak lagi perlu mendaftarkan `intlayerCompiler()` secara terpisah.
+- **Compiler**: Diaktifkan secara otomatis ketika `compiler.enabled` diatur ke `true` dan jalur `compiler.output` dikonfigurasi. Anda tidak lagi perlu mendaftarkan `intlayerCompiler()` secara terpisah.
 - **Proxy**: Diaktifkan secara otomatis berdasarkan opsi `routing.enableProxy` yang baru (`true` secara default). Ini menghubungkan middleware deteksi locale / redirect / rewrite dalam pengembangan, preview, dan SSR produksi. Anda tidak lagi perlu mendaftarkan `intlayerProxy()` secara terpisah.
 
 ### Opsi `routing.enableProxy`
@@ -252,17 +253,61 @@ Plugin standalone `intlayerCompiler()` dan `intlayerProxy()` tetap diekspor untu
 
 ---
 
+## Compiler dinonaktifkan secara default
+
+Mulai dari Intlayer v9, **compiler dinonaktifkan secara default** (`compiler.enabled` sekarang default-nya `false`). Untuk mengaktifkan ekstraksi file `.content.ts` Anda pada saat build, atur `compiler.enabled: true` di konfigurasi Anda:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Default: false — diperlukan untuk mengaktifkan compiler sejak v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Ketika compiler dinonaktifkan, Intlayer melewati langkah ekstraksi saat build dan mengandalkan dictionary yang sudah Anda deklarasikan. Aktifkan hanya ketika Anda ingin plugin bundler (`@intlayer/swc`, `@intlayer/babel`, atau plugin Vite `intlayer()`) mengekstrak konten secara otomatis.
+
+---
+
+## React Native: impor paket tunggal
+
+Dalam aplikasi React Native atau Expo, Anda tidak perlu lagi beralih antara `react-intlayer` dan `react-native-intlayer`. Paket `react-native-intlayer` sekarang **mengekspor ulang seluruh API `react-intlayer`** (hooks, utilitas, dan subjalur `/format`, `/html`, dan `/markdown`), dan `IntlayerProvider`-nya secara otomatis menerapkan polyfill React Native.
+
+Impor semuanya dari paket tunggal `react-native-intlayer`:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> Mengimpor dari `react-intlayer` tetap berfungsi, tetapi `react-native-intlayer` sekarang adalah titik masuk tunggal yang direkomendasikan untuk React Native — provider-nya menyediakan polyfill yang tidak dimiliki oleh provider `react-intlayer` yang berorientasi web.
+
+---
+
 ## Catatan migrasi dari v8
 
 Jika Anda memperbarui dari v8, perhatikan bahwa v9 tidak menyertakan breaking changes (perubahan yang merusak). Namun berikut adalah perubahan utamanya:
 
+- **Compiler dinonaktifkan secara default**: `compiler.enabled` sekarang default-nya `false`. Jika Anda mengandalkan ekstraksi file `.content.ts` saat build, atur `compiler.enabled: true` di `intlayer.config.ts` Anda.
 - **Locales & Dialects**: Jika menggunakan dependensi i18n eksternal, tambahkan plugin compat adapter masing-masing dalam konfigurasi atau pengaturan bundler Anda untuk menulis ulang impor secara otomatis.
-- **Custom Selectors**: Saat memanggil `useIntlayer`, parameter kedua sekarang dicadangkan untuk objek opsi yang berisi `{ locale, item, variant, id }`. Jika sebelumnya Anda meneruskan string locale secara langsung, Anda masih dapat melakukannya, tetapi menggunakan objek opsi sangat direkomendasikan untuk pemilihan tingkat lanjut.
+- **Custom Selectors**: Saat memanggil `useIntlayer`, parameter kedua sekarang dicadangkan untuk objek opsi yang berisi `{ locale, item, variant }`. Jika sebelumnya Anda meneruskan string locale secara langsung, Anda masih dapat melakukannya, tetapi menggunakan objek opsi sangat direkomendasikan untuk pemilihan tingkat lanjut.
 
 ---
 
 ## Tautan berguna
 
 - [Panduan Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/compat/index.md)
-- [Dynamic Dictionaries - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md)
+- [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md)
 - [Referensi Konfigurasi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md)

package/docs/it/compiler.md

@@ -81,12 +81,15 @@ Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Aggiunge il plugin del compiler
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/it/custom_domains.md

@@ -172,10 +172,16 @@ Il plugin Vite `intlayerProxy` applica la stessa logica durante lo sviluppo:
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/it/custom_url_rewrites.md

@@ -342,10 +342,16 @@ Per SolidJS, Vue e Svelte, il plugin Vite `intlayerProxy` gestisce le riscrittur
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```