@intlayer/docs 9.1.3 → 9.3.0

package/docs/id/analytics.md

@@ -0,0 +1,223 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Intlayer Analytics | Lacak paparan konten dan jalankan pengujian A/B (A/B testing)
+description: Temukan bagaimana @intlayer/analytics melacak tampilan halaman/lokal dan paparan konten, dan bagaimana menggunakannya untuk menjalankan pengujian A/B (A/B testing) pada konten Intlayer Anda.
+keywords:
+  - Analytics (Analitik)
+  - A/B Testing (Pengujian A/B)
+  - Audience (Audiens)
+  - Internationalization (Internasionalisasi)
+  - Documentation (Dokumentasi)
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - analytics
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Init doc — paket @intlayer/analytics, pelacakan tingkat provider/node, pengujian A/B, dasbor"
+author: aymericzip
+---
+
+# Dokumentasi Intlayer Analytics
+
+`@intlayer/analytics` adalah paket pelengkap opsional yang memberi tahu Anda **konten mana yang benar-benar ditampilkan** kepada pengunjung Anda — halaman mana, dalam bahasa (locale) apa, dan bagian mana dari konten terjemahan yang spesifik — sehingga Anda dapat memahami audiens Anda dan menjalankan **pengujian A/B pada konten**.
+
+## Daftar Isi (Table of Contents)
+
+<TOC/>
+
+---
+
+## Apa yang dilacak (What it tracks)
+
+`@intlayer/analytics` menggabungkan tiga jenis peristiwa anonim dalam sebuah batch:
+
+| Peristiwa (Event)  | Di mana ditangkap                                 | Apa yang dikatakannya kepada Anda                                                                                                                       |
+| ------------------ | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `page_view`        | Tingkat Provider (`IntlayerProvider`)             | Halaman dan lokal (locale) mana yang dilihat oleh sesi (session), pada muat awal, perubahan rute, atau pergantian bahasa.                               |
+| `content_exposure` | Tingkat Node (`useIntlayer` / plugin interpreter) | Kunci kamus / jalur kunci mana yang benar-benar diselesaikan (resolved) dan ditampilkan — dan jika bagian dari sebuah eksperimen, **varian** yang mana. |
+| `conversion`       | Di mana pun Anda memanggil `useConversion()`      | Sebuah tujuan (goal) yang dicapai (pendaftaran, klik, pembelian...) yang diatribusikan ke varian A/B yang diekspos kepada sesi tersebut.                |
+
+Peristiwa (events) dikumpulkan di dalam memori dan dikirimkan sebagai **sebuah permintaan batch tunggal kira-kira setiap 20 detik** — tidak pernah pada setiap ketikan (keystroke) atau saat di-render (render) — sehingga analitik tidak pernah berdampak pada waktu rendering pertama (first render time) atau menambahkan sebuah request setiap interaksi.
+
+## Bagaimana hal ini mendukung pengujian A/B pada konten
+
+Intlayer telah memungkinkan Anda mendeklarasikan [Varian (Variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md) dari konten (misalnya kamus `hero-banner` yang memiliki varian `control` dan varian `black_friday`). `@intlayer/analytics` menutup siklus tersebut:
+
+1. `getVariant(experimentKey, variants)` secara deterministik (deterministically) menugaskan (assign) setiap sesi anonim ke dalam sebuah varian — ini merupakan murni sebuah fungsi (pure function) dari session id dan experiment key, sehingga tugas (assignment) ini **stabil (stable) di seluruh sesi** dan tidak memerlukan **satu siklus ke server (server round-trip)** sebelum proses rendering pertama selesai dilakukan (tidak ada kelap-kelip / flicker, dan juga layout shift).
+2. Setiap peristiwa `content_exposure` turut membawa `variant` yang dipertunjukkan tersebut.
+3. `useConversion()` memungkinkan Anda untuk mengatribusikan (attribute) sebuah tujuan (goal) (contohnya `"cta_click"`) ke arah varian tersebut.
+4. Titik-akhir (endpoint) terkait hasil eksperimen pada dasbor membandingkan tingkat konversi (conversion rates) dari setiap varian, termasuk dengan signifikansi statistik-nya (melalui z-test).
+
+## Instalasi (Installation)
+
+`@intlayer/analytics` adalah kebergantungan (dependency) yang bersifat **sepadan (peer), opsional** — dan paket framework mana pun tidak akan secara otomatis memasangnya. Anda perlu menambahkannya bersama dengan `intlayer`:
+
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/analytics
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/analytics
+```
+
+```bash packageManager="bun"
+bun add @intlayer/analytics
+```
+
+Bila Anda memutuskan untuk tak memasangnya, maka titik temu / integrasi (integration point) ini diselesaikan menjadi hal yang tidak beroperasi atau no-op — silakan periksa rincian dari [Tidak ada biaya apa pun ketika tidak dipasang (Zero-cost ketika tidak dipasang)](#nol-biaya-saat-tidak-diinstal) pada poin selanjutnya di bawah.
+
+## Konfigurasi (Configuration)
+
+Analytics **menggunakan ulang rancangan pengaturan / blok konfigurasi `editor` yang sudah ada** — jadi tak ada rincian pengaturan maupun bentuk bagan tersendiri (analytics config schema) untuk diisikan:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    backendURL: "https://back.intlayer.org", // Turut dipakai pula untuk keperluan analytics (berfungsi selaku analytics ingestion endpoint)
+    clientId: "your-client-id", // Juga dipakai pada fungsi kunci proyek analytics / analytics project key
+    clientSecret: "your-client-secret",
+  },
+};
+
+export default config;
+```
+
+- `editor.backendURL` — merupakan dasar (base) rujukan / acuan bagi URL saat peristiwa (event) analytics diantarkan ke sana (`POST {backendURL}/api/analytics/events`).
+- `editor.clientId` — merujuk terhadap pengunci (key) bagi proyek publik agar dipertautkan / diatribusikan ke beragam input data. Tak hanya itu fungsinya turut bertindak layaknya **pemicu aktivasi (enable switch)**: analitik sepenuhnya dibuat pada tingkatan non-aktif (dan dalam kondisi ter-tree-shaken, perhatikan penjabarannya di bawah) sampai kemudian di saat fungsi `clientId` ini ditata & dikonfigurasikan.
+
+Dalam situasi ketika melakukan hosting (self-host) mandiri akan halnya fungsi Intlayer ini, analitik bakal terpusat tanpa penyesuaian baru (otomatis) terhadap instalasi server Anda disebabkan rujukan pengaturannya adalah identik terhadap rujukan `editor.backendURL`.
+
+## Dukungan Framework (Framework support)
+
+Analytics sendiri disalurkan beriringan di saat mendayagunakan `IntlayerProvider` rujukan `react-intlayer`, dan pastinya ini membuatnya selalu sedia dipakai di belahan titik mana pun bilamana ia di-inisiasikan:
+
+| Framework                                                | Status                                                                                            |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| React                                                    | ✅ Tersedia                                                                                       |
+| Next.js (`next-intlayer`)                                | ✅ Tersedia (melalui `react-intlayer`)                                                            |
+| React Native / Expo (`react-native-intlayer`)            | ✅ Tersedia (melalui `react-intlayer`)                                                            |
+| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 Direncanakan (Planned) — klien yang serupa, dalam tingkatan binding berlandaskan rilis standar |
+
+## Penggunaan (Usage)
+
+### Pelacakan tingkat provider (Automatic provider-level tracking)
+
+Tidak perlu ada perubahan kode atau modifikasi koding apa pun. Setelah instalan dari `@intlayer/analytics` dipastikan, serta konfigurasinya mengacu terhadap `editor.clientId`, dengan cara yang langsung `IntlayerProvider` bertindak untuk:
+
+- Melakukan proses inisialisasi awal klien (analytics client) saat mounting awal (mount),
+- Mencatatkan satu rekam jejak rupa tampilan layar `page_view` sewaktu pemuatan yang pertama,
+- Menginisiasi kembali pelacakan `page_view` ini sewaktu perpindahan wilayah pilihan penggunaan (locale change),
+- Memunculkan mekanisme pusaran siklus (~20s flush loop) agar menyaring tuntas rincian atau pun serpihan yang melekat tanpa menunggu (unmount / tutupan pada tab halaman pengguna; yaitu memfungsikan `navigator.sendBeacon` yang bakal melakukan hal serupa disusul balikan perujukannya memakai `fetch(..., { keepalive: true })`).
+
+### Pelacakan otomatis tingkat Node (Automatic node-level tracking)
+
+Dalam segenap ragam resolusi muatan koding saat menampilkan serpihan / wujud konten pada panggilannya melewati rujukan pemakaian dari `useIntlayer`, interpreter di sistem melaporkan dan merekam serpihan data bertitelkan rujukan nama peristiwanya (event): `content_exposure` untuk paduan akurasi di hal penggunaan ini: `dictionaryKey` + arah pencariannya pada perincian jalan/aksesnya (key path) + daerah acuan pilihan pemakai (locale) — sekali lagi tak satu jengkal pun perubahan bentuk kode dilibatkan. Adanya wujud rentetan dari kemunculan satu buah referensi simpul penamaan (node) selama jangka tahapan pusar (flush window) maka keseluruhannya cuma dikumpulkan di dalam satu rangkuman catatan rujukan dan dibumbuhi tambahan catatan bilangan rekam-an `count`, ini menegaskan bahwasanya dari hal yang sama terulang dan memunculkan rupa ulang tampilan atau rendering tak-kurang-bahkan 50 kali sekalipun bukan berarti mengirimkan rincian berurutan dan mengada-adakan proses berulang (50 pengantaran yang diestimasikan terhitung secara manual).
+
+### Memantau hal rekam pencapaian / Konversi test A/B (Tracking conversions for A/B tests)
+
+Anda mesti menerapkan rincian `useConversion()` guna memandu sebuah tujuan akhir ke wujud sebuah variabel eksperimen dengan hasil pengamatan pengguna akhir (session):
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Mari kita memulainya (Get started)
+    </button>
+  );
+};
+```
+
+### Penyelesaian varian eksperimen klien secara internal (Resolving a variant client-side)
+
+```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
+import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
+
+const client = getGlobalAnalyticsClient();
+const variant = client?.getVariant("homepage-hero", [
+  "control",
+  "black_friday",
+]);
+```
+
+## Privasi dan Peforma (Privacy & performance)
+
+- **Anonim semenjak disajikan di dalam rancang bangun rancangan arsitektur** (Anonymous by design): keseluruhan lalu-lintas data pengguna hanya akan mempergunakan nama acak yang bergilir secara unik (rotating id); fungsi-fungsi bagian hulu dari mesin server (backend) tidak pernah (secara langsung & tak sadar) me-rekam hasil catatan rujukan dalam hal ini IP dari pengguna asalnya — namun alih-alih me-rekam atau men-sirkulasikannya pada **rangkaian fungsi Hash SHA-256 (SHA-256 hash)** demi tujuan keutuhan.
+- **Batasan dan acuan dari pemosisian sangat acak / menyeluruh (Location is coarse)**: rincian data disuplai melalui serangkaian fungsi pelacakan geo-posisi atau geolokasi di CDN headers (`cf-ipcountry`, `x-vercel-ip-country`, ...). Rangkaian tidak merekam data maupun menyalin posisi akurat IP penggunanya secara keseluruhan maupun sebagian di sepanjang lalu lalang dari setiap interaksi data di lapangan.
+- **Rujukan URL senantiasa tidak menyingkap serpihan/sandi atau referensinya (URLs exclude search params)** berkat penetapan bawaan sistem di balik layar (default settings) demi kemaslahatan fungsi yang menyeluruh dari pengguna saat men-skrining pelacakan referensi penyamaran yang berkesinambungan.
+- **Batasan perbandingan sampling (Sampling)**: `sampleRate` dapat diselaraskan atau diformat berdasarkan dari rentetan trafik atau kerumitan penelusuran demi fungsi kinerja tinggi aplikasi.
+- **Mekanisme antrian pengiriman rupa-upa (Batched)**: Pengaturan ini mengatur bahwasanya ada rujukan rentang acuan di `flushInterval` dalam interval taksiran pengantaran ± setiap 20 detik (kira-kira) atau pun bila terhambat di `maxBufferSize` maka sistem bereaksi dan beraksi menyuplai secara masal dari sekumpulan rincian (batched) itu ke dalam rujukan tanpa mencederai prinsip asasi yakni 'tak-ada satu-pun rekaman penelusuran untuk setiap transaksi / satu peristiwa dikirim sebagai laporan sendiri'.
+
+### Nol-biaya saat tidak diinstal (Zero-cost when not installed)
+
+Fungsi di belakang layer yang senantiasa berlaku dalam hal-ihwal perincian `@intlayer/analytics` sepenuhnya taat terhadap acuan yang lazim dipakai, tak-ubahnya seperti keberadaan pakem atau patokan yang biasa mendasari / membidani / menyelimuti referensi kebergantungan situasional (optional-dependency pattern) dalam serangkaian fungsi dari ranah operasional `@intlayer/editor`:
+
+- di setiap rupa kemunculan pada fase / titik pertautan (integration point) sistem senantiasa mendatangkan wujud dari kumpulan rujukan kodingnya dalam model penanganan kesalahan yaitu mendayagunakan blok rujukan di kerangka kodingan bersandikan **`try/catch` pada rangkaian perincian pemanggil model pemanggil dari fungsi / pola struktur pemrograman pemanggil dinamis `import()` (dynamic `import()`)** — Hal itu mengasumsikan bila ternyata sewaktu sistem di mana di satu aplikasi tak-menyematkan proses pasang modul / instal koding pendukung untuk instrumen ini (di kasus penggunaan rujukan spesifik bagi instalasi alat pelacak seperti instalasi di `@intlayer/analytics`) — itu sama sekali tak akan mengurangi sedikit pun ruang ketersediaan sistem penyedia data atau server karena sistem mengasumsikan penggunanya memang memandang sebelah mata perihal tersebut (yakni tak pernah merilis wujud dukungan alat operasional penganalisa data rujukan aplikasi untuk ukuran besar/bundel pada penyediaan / runtime di sisi sistem dan tidak perlu melihat kegagalan proses).
+- di kala perincian ini sedang berjalan pada fase proses sistem mempabrikasinya menjadi bagian tak-terpisahkan maka hal ini dapat difungsikan pada pengaturan (`INTLAYER_ANALYTICS_ENABLED`) rujukan lingkungan pemrograman bawaan / baku dari waktu-kompilasi.
+  Bentuk pengeset-an rupa-rupa di waktu-awal oleh koding pengatur yakni alat di lingkungan rancangan pemograman (`@intlayer/config`) menyelaraskannya seraya otomatis dikukuhkan kepada bentuk referensi bertuliskankan status `'false'` dan rujukan pengunci dari sisi / sisi koding pendefinisi tak ditemukan keberadaannya dari sisi koding acuan konfigurasi (`editor.clientId`). Proses berkesinambungan menyingkirkan elemen mati demi mencegah rupa serpihan sampah ini disebut sebagai — fitur pembuangan dari elemen kode mubazir (atau perlakuan ini dikenal di dunia sistem sebagai pemicu dalam fungsi acuan yang disebut hal **dead-code-eliminate**).
+
+## Dasbor (Dashboard): Halaman Analitik
+
+Saat di mana perancangan rupa proyek Anda secara sempurna rampung & mampu / bisa mengambil dan menyalin kejadian di ranahnya — perincian perujukan sistem dari pemanggil pada tautan **Analytics** pada tampilan di dasbor/pusat fungsi rujukan operasional pada antarmuka ([Intlayer dashboard](https://app.intlayer.org/analytics)) maka bagian tersebut senantiasa terbuka dan tampak bila pengguna menentukan opsi ke sebuah perwujudan pilihan atau proyek tertentu di dalam kolom-menu samping dari layar antar-muka operasional (sidebar) dan tampil perinciannya:
+
+- **Rujukan dari pengunjung atau pemakai / pelanggan atau pengguna-aktif harian** (Active users).
+- **Hasil catatan perihal rincian rujukan harian pengunjung / orang yang berlalu lalang (today & last 7 days)**.
+- Rangkaian catatan **halaman-halaman** sepanjang jeda hari (Page views) pada periode tertentu.
+- Acuan grafis visual yang menjelaskan laju/rekaman harian orang berkunjung.
+- Seksi-seksi pilihan untuk mengatur penjabaran berdasarkan perpaduan antara **wilayah/Daerah pilihan pengguna (Locales)** dari pengunjung & acuan per wilayah pemetaan ke-negara / geografi.
+
+## Referensi API Backend (Backend API reference)
+
+Untuk segenap rincian di dalam pangkalan yang bersinggungan langsung sewaktu proses perujukan atau pembacaan-data meniscayakan perlunya satu identifikasi atau rujukan data terpusat (authenticated); proses sebaliknya (pemasukan referensi / ingestion) dibebaskan dan dirujuk & diatur lewat sebaris kode (`clientId`) yang dideklarasikan secara tertanam di sekujur bentuk operasional rincian pembawa referensinya (body parameter).
+
+| Method | Endpoint                                    | Deskripsi                                                                                                      |
+| ------ | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `POST` | `/api/analytics/events`                     | Proses memasukkan referensi data per kumpulan data berantai (bersifat teruka, diatribusikan lewat `clientId`). |
+| `GET`  | `/api/analytics/overview`                   | Kalkulasi halaman (Page) / Daerah Bahasa (Locale) terhadap hasil perhitungan autentikasi keseluruhan.          |
+| `GET`  | `/api/analytics/audience?days=30`           | Menjabarkan serangkaian referensi harian untuk setiap ragam pengelompokannya berdasarkan rincian acuan.        |
+| `GET`  | `/api/analytics/content-stats`              | Kumpulan kalkulasi (total) untuk masing-masing wujud paparan / eksposur (berkelompok & dikategorikan).         |
+| `GET`  | `/api/analytics/experiments/:experimentKey` | Nilai atau serangkaian nilai / referensi A/B test (pengaruh eksperimental dari wujud tampilan pembanding).     |
+
+Fungsi SDK Intlayer secara otomatis menyalurkan ragam instrumen pada fungsi ini melalui jalur kode ter-automasi lewat pemrograman, hal tersebut senantiasa berpedoman kepada fungsi kodingan yang sama dari sumber SDK ini.
+Lihat / Pelajari selengkapnya seputar: [CMS SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_CMS.md):
+
+```ts fileName="analytics.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { analyticsEndpoint } from "@intlayer/api/analytics";
+
+const cms = createIntlayerCMS();
+
+const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
+```
+
+## Tautan Berguna (Useful links)
+
+- [Kamus Dinamis - Koleksi & Varian (Dynamic Dictionaries - Collections & Variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md)
+- [Intlayer CMS - CMS SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_CMS.md)
+- [Editor Visual Intlayer (Intlayer Visual Editor)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_visual_editor.md)
+- [Referensi Konfigurasi (Configuration Reference)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md)
+- [Panduan Hosting Mandiri (Self-Hosting Guide)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/self_hosting.md)

package/docs/id/bundle_optimization.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-11-25
-updatedAt: 2026-06-07
+updatedAt: 2026-08-09
 title: Optimasi Ukuran Bundle & Performa i18n
 description: Kurangi ukuran bundle aplikasi Anda dengan mengoptimalkan konten internasionalisasi (i18n). Pelajari cara memanfaatkan tree shaking dan lazy loading untuk kamus menggunakan Intlayer.
 keywords:
@@ -16,6 +16,12 @@ slugs:
   - concept
   - bundle-optimization
 history:
+  - version: 9.2.1
+    date: 2026-08-09
+    changes: "`purge` dan `minify` kini bekerja di Next.js melalui `@intlayer/swc` — tidak perlu `babel.config.js`"
+  - version: 8.12.0
+    date: 2026-06-24
+    changes: "Mencantumkan plugin Babel dalam urutan pipeline yang diperlukan (extract → purge → minify → optimize) pada tabel referensi"
   - version: 8.12.0
     date: 2026-06-07
     changes: "Menambahkan `intlayerPurgeBabelPlugin` dan `intlayerMinifyBabelPlugin` untuk Babel/Webpack; menjelaskan pipeline plugin"
@@ -191,12 +197,14 @@ Optimasi build dari Intlayer terbagi menjadi beberapa plugin terpisah yang masin
 
 Plugin-plugin ini digunakan secara langsung di dalam `babel.config.js` untuk setup berbasis Webpack (Next.js dengan Babel, CRA, kustom Webpack, dll).
 
+Tabel di bawah ini mencantumkannya dalam urutan pipeline yang diperlukan (urutan yang sama seperti yang harus muncul di `babel.config.js`):
+
 | Plugin                        | Apa yang dilakukannya                                                                                                  |
 | :---------------------------- | :--------------------------------------------------------------------------------------------------------------------- |
 | `intlayerExtractBabelPlugin`  | Memindai file `.content.ts` dan menulis kamus yang telah dikompilasi ke direktori `.intlayer/`                         |
-| `intlayerOptimizeBabelPlugin` | Menulis ulang `useIntlayer('key')` menjadi `useDictionary(hash)` dan menyuntikkan (injects) `import` kamus yang sesuai |
 | `intlayerPurgeBabelPlugin`    | Memindai semua file source, menghapus **field konten yang tidak terpakai** dari file kamus `.intlayer/**/*.json`       |
 | `intlayerMinifyBabelPlugin`   | **Mengganti nama kunci (keys) konten** menjadi alias alfabet yang pendek (`title` → `a`) di file JSON maupun source    |
+| `intlayerOptimizeBabelPlugin` | Menulis ulang `useIntlayer('key')` menjadi `useDictionary(hash)` dan menyuntikkan (injects) `import` kamus yang sesuai |
 
 > **Urutan plugin sangat penting.** Di dalam `babel.config.js`, plugin purge dan minify harus ditempatkan **sebelum** plugin optimize. Langkah optimize menggantikan `useIntlayer('key')` dengan pemanggilan `useDictionary(hash)` yang menyembunyikan informasi 'key' dari kamus. Informasi 'key' ini sangat diperlukan oleh tahap purge dan minify untuk mengidentifikasi field mana yang dipakai.
 
@@ -205,9 +213,9 @@ Setiap plugin Babel memiliki "options helper" yang berhubungan untuk membaca `in
 | Options helper               | Digunakan dengan              |
 | :--------------------------- | :---------------------------- |
 | `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 | `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
 | `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 
 ### Plugin Vite (`vite-intlayer`)
 
@@ -220,6 +228,20 @@ Pengguna Vite **tidak pernah mengonfigurasi ini secara langsung**. Plugin ini te
 | Dictionary minify    | Sama seperti pass penulisan JSON dari `intlayerMinifyBabelPlugin`                                   |
 | Babel transform      | Sama seperti penggantian nama kode dari `intlayerMinifyBabelPlugin` + `intlayerOptimizeBabelPlugin` |
 
+### Plugin SWC (`@intlayer/swc`)
+
+Pengguna Next.js juga **tidak pernah mengonfigurasi ini secara langsung**. Sejak **v9.2.1**, `withIntlayer()` di `next.config.ts` menjalankan seluruh pipeline — purge, minify, dan penulisan ulang import — hanya berdasarkan flag `build.purge` dan `build.minify`.
+
+Pekerjaan dibagi menjadi dua, karena plugin Wasm SWC mentransformasi satu berkas dalam satu waktu dan tidak memiliki akses ke sistem berkas:
+
+| Tahap                                           | Di mana dijalankan              | Apa yang dilakukan                                                                                              |
+| :---------------------------------------------- | :------------------------------ | :-------------------------------------------------------------------------------------------------------------- |
+| Analisis penggunaan + purge/minify JSON         | Node, di dalam `withIntlayer()` | Membaca setiap berkas sumber komponen, menulis ulang `.intlayer/**/*.json`, menghasilkan tabel penggantian nama |
+| Penulisan ulang sumber (`content.title` → `.a`) | `@intlayer/swc` (Wasm)          | Menerapkan tabel penggantian nama pada akses properti yang sesuai di kode Anda                                  |
+| Penulisan ulang import (`useIntlayer` → dict)   | `@intlayer/swc` (Wasm)          | Sama seperti `intlayerOptimizeBabelPlugin`                                                                      |
+
+Menentukan _bidang mana_ yang tidak terpakai dan _alias apa_ yang diterima masing-masing memerlukan status lintas berkas dan I/O berkas, sehingga separuh itu berjalan di Node; plugin SWC hanya menerima tabel hasilnya.
+
 ## Setup berdasarkan Platform
 
 <Tabs>
@@ -227,10 +249,12 @@ Pengguna Vite **tidak pernah mengonfigurasi ini secara langsung**. Plugin ini te
 
 ### Next.js
 
-Next.js memerlukan plugin `@intlayer/swc` untuk optimasi pass (menulis ulang import), karena Next.js menggunakan SWC untuk proses build-nya.
+Next.js memerlukan plugin `@intlayer/swc`, karena Next.js menggunakan SWC untuk build. Sejak **v9.2.1**, satu paket ini mencakup seluruh pipeline — optimasi (penulisan ulang import), purge, dan minify.
 
 > Plugin ini tidak terpasang secara default karena plugin SWC masih berada pada tahap eksperimental untuk Next.js. Hal ini dapat berubah di masa yang akan datang.
 
+> **Next.js 16.1.0 adalah versi minimum.** Ini adalah rilis pertama yang dibangun di atas ABI plugin Wasm SWC yang kompatibel ke depan; rilis sebelumnya menolak plugin tersebut. `withIntlayer` membaca versi Next.js proyek Anda dan tidak mendaftarkan plugin sama sekali di bawah 16.1.0 — build tersebut tetap berhasil, hanya saja berjalan tanpa optimasi bundle.
+
 <Tabs>
  <Tab value="npm">
 
@@ -265,33 +289,40 @@ intlayer-swc-plugin = "*"
 
 Setelah dipasang, Intlayer akan mendeteksi dan menggunakan plugin ini secara otomatis.
 
-Untuk langkah **purge dan minify** (menghapus field dan mengganti nama field), instal `@intlayer/babel` bersamanya dan tambahkan plugin Babel tersebut. Walaupun Next.js menggunakan SWC untuk proses transformasi namun ia tetap mengevaluasi `babel.config.js` untuk plugin config, jadi plugin Babel ini berjalan sebagai pra-langkah sebelum SWC dieksekusi.
+Tahap **purge dan minify** (penghapusan dan penggantian nama bidang) tidak memerlukan paket tambahan maupun `babel.config.js`. Bungkus konfigurasi Anda dengan `withIntlayer` dan aktifkan flag di `intlayer.config.ts`:
 
-```bash packageManager="npm"
-npm install -D @intlayer/babel
+```typescript fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {/* konfigurasi Anda */};
+
+export default withIntlayer(nextConfig);
 ```
 
-```javascript fileName="babel.config.js"
-const {
-  intlayerPurgeBabelPlugin,
-  intlayerMinifyBabelPlugin,
-  getPurgePluginOptions,
-  getMinifyPluginOptions,
-} = require("@intlayer/babel");
+```typescript fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
 
-module.exports = {
-  presets: ["next/babel"],
-  plugins: [
-    // Purge: menghapus field konten yang tidak digunakan dari .intlayer/**/*.json
-    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
-    // Minify: mengubah nama field konten di JSON + source code
-    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
-    // Catatan: intlayerOptimizeBabelPlugin TIDAK DIBUTUHKAN di sini karena
-    // @intlayer/swc yang menangani penggantian useIntlayer → useDictionary.
-  ],
+const config: IntlayerConfig = {
+  build: {
+    purge: true, // menghapus bidang konten yang tidak terpakai dari JSON yang dibundel
+    minify: true, // mengganti nama kunci bidang konten menjadi alias pendek
+  },
 };
+
+export default config;
 ```
 
+Selama `next build`, `withIntlayer` menganalisis sumber Anda, menulis ulang kamus yang telah dikompilasi, dan meneruskan tabel penggantian nama bidang yang dihasilkan ke `@intlayer/swc`, yang memperbarui akses properti yang sesuai di kode Anda.
+
+> Gunakan `withIntlayer` yang asinkron, bukan `withIntlayerSync`. Varian sinkron tidak menjalankan pipeline analisis, jadi purge dan minify tidak berpengaruh dengannya.
+
+> Purge dan minify hanya berjalan pada `next build` — pipeline optimasi dimatikan selama `next dev`.
+
+> Keduanya juga dinonaktifkan ketika pemanggil adapter kompatibilitas dikonfigurasi (`swcExtraCallers`, disetel oleh paket kompatibilitas seperti `@intlayer/next-intl` atau `@intlayer/react-i18next`): titik panggilan tersebut tidak terlihat oleh penganalisis penggunaan, sehingga purge akan menghapus bidang yang masih dibaca oleh kode. Penulisan ulang import tetap aktif.
+
+**Versi sebelumnya (sebelum 9.2.1)** memerlukan `@intlayer/babel` dan sebuah `babel.config.js` yang mendeklarasikan `intlayerPurgeBabelPlugin` dan `intlayerMinifyBabelPlugin`. Berkas itu tidak lagi diperlukan dan dapat dihapus.
+
  </Tab>
  <Tab value="vite">
 
@@ -447,6 +478,8 @@ export default config;
 
 > Minifikasi akan dilompati (skipped) bila `optimize` disetel menjadi `false` atau `editor.enabled` bernilai `true` (Visual editor sangat memerlukan nama field asli untuk mode pengeditan).
 
+> Di Next.js, minifikasi juga dilewati ketika `@intlayer/swc` tidak terpasang atau tidak dapat dimuat (Next.js di bawah 16.1.0). Plugin inilah separuh yang menulis ulang akses di kode sumber, sehingga mengganti nama kamus tanpa plugin tersebut akan membuat kode Anda membaca nama bidang yang sudah tidak ada.
+
 > Proses minifikasi ini juga akan dihiraukan jika file kamus dipanggil lewat `importMode: 'fetch'` karena file JSON tersebut dikirim dari API terpencil menggunakan nama struktur kunci originalnya. Apabila client mencoba melakukan minifikasi maka jembatan kontrak server/client akan rusak.
 
 ### Purging (penghapusan field konten tak terpakai)
@@ -475,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Purge akan dilompati ketika `optimize` bernilai `false` atau `editor.enabled` adalah `true`.
+> Purge akan dilompati ketika `optimize` bernilai `false` atau `editor.enabled` adalah `true`. Di Next.js, ia juga dilewati ketika `@intlayer/swc` tidak tersedia dan ketika pemanggil adapter kompatibilitas dikonfigurasi.
 
 > Secara konservatif, proses purge tidak akan dilaksanakan jika file asal (source file) gagal dipindai, atau pemanggilan `useIntlayer` disimpan di variabel untuk lalu disebarluaskan di mana proses pindaian statik tak mampu melacak jejaknya (contoh lewat spread function atau pengiriman prop secara untuh). Jika skenario ini terjadi, file kamus tak akan disentuh.
 

package/docs/id/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-07-11
+updatedAt: 2026-08-06
 title: Konfigurasi
 description: Pelajari cara mengonfigurasi Intlayer untuk aplikasi Anda. Pahami berbagai pengaturan dan opsi yang tersedia untuk menyesuaikan Intlayer sesuai kebutuhan Anda.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.1.3
+    date: 2026-08-06
+    changes: "Menjadikan `routing.enableProxy` tiga keadaan: tidak diatur (auto), `true`, `false`"
   - version: 9.0.0
     date: 2026-07-11
     changes: "Menambahkan konfigurasi `analytics`"
@@ -235,6 +238,19 @@ const config: IntlayerConfig = {
      */
     mode: "prefix-no-default",
 
+    /**
+     * Mengaktifkan proxy perutean locale Intlayer (middleware).
+     * Menangani deteksi locale, pengalihan, dan penulisan ulang di dev, preview, dan SSR.
+     * - tidak diatur (auto): server dev dan preview menjaga perutean tetap digerakkan URL
+     *   dengan mengabaikan locale yang tersimpan di cookie dan header. Prefiks tetap
+     *   diselesaikan, locale tetap disimpan, dan deteksi Accept-Language tetap berlaku.
+     *   Di produksi berperilaku seperti `true`.
+     * - true: perilaku penuh di setiap lingkungan.
+     * - false: tanpa perutean locale.
+     * Default: undefined (auto)
+     */
+    enableProxy: undefined,
+
     /**
      * Tempat menyimpan locale yang dipilih pengguna.
      * Opsi: 'cookie', 'localStorage', 'sessionStorage', 'header', atau array dari opsi ini.
@@ -713,13 +729,14 @@ Analitik bersifat opt-in secara ketat: tidak ada yang dikumpulkan kecuali `analy
 
 Pengaturan yang mengontrol perilaku routing, termasuk struktur URL, penyimpanan locale, dan penanganan middleware.
 
-| Bidang     | Deskripsi                                                                                                                                                                                                            | Tipe                                                                                                                                                                                                         | Default                | Contoh                                                                                                                                                                                            | Catatan                                                                                                                                                                                                                                                                                                          |
-| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`     | Mode routing URL untuk penanganan locale.                                                                                                                                                                            | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) atau `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: locale ditangani melalui cara lain. `'search-params'`: `/dashboard?locale=fr` | Tidak berdampak pada manajemen cookie atau penyimpanan locale.                                                                                                                                                                                                                                                   |
-| `storage`  | Konfigurasi untuk menyimpan locale di klien.                                                                                                                                                                         | `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 }]`                                                                                                                | Lihat tabel Opsi Penyimpanan di bawah.                                                                                                                                                                                                                                                                           |
-| `basePath` | Path dasar untuk URL aplikasi.                                                                                                                                                                                       | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                       | Jika aplikasi berada di `https://example.com/my-app, basePath adalah `'/my-app'`dan URL menjadi`https://example.com/my-app/en`.                                                                                                                                                                                  |
-| `rewrite`  | Aturan penulisan ulang URL kustom yang mengesampingkan mode routing default untuk path tertentu. Mendukung parameter dinamis `[param]`.                                                                              | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | Lihat contoh di bawah                                                                                                                                                                             | • Aturan penulisan ulang (rewrite) didahulukan daripada `mode`.<br/>• Berfungsi dengan Next.js dan Vite.<br/>• `getLocalizedUrl()` secara otomatis menerapkan aturan yang cocok.<br/>• Lihat [Penulisan Ulang URL Kustom](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
-| `domains`  | Memetakan locale ke nama host domain untuk routing berbasis domain. Jika diatur, URL untuk locale tersebut menggunakan domain ini sebagai basis (URL absolut) dan tidak ada prefiks locale yang ditambahkan ke path. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                       | • Protokol default adalah `https://` jika tidak disertakan dalam hostname.<br/>• Domain itu sendiri mengidentifikasi locale, sehingga prefiks `/zh/` tidak ditambahkan.<br/>• `getLocalizedUrl('/', 'zh')` mengembalikan `https://intlayer.zh/`.                                                                 |
+| Bidang        | Deskripsi                                                                                                                                                                                                            | Tipe                                                                                                                                                                                                         | Default                | Contoh                                                                                                                                                                                            | Catatan                                                                                                                                                                                                                                                                                                                                                                             |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`        | Mode routing URL untuk penanganan locale.                                                                                                                                                                            | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) atau `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: locale ditangani melalui cara lain. `'search-params'`: `/dashboard?locale=fr` | Tidak berdampak pada manajemen cookie atau penyimpanan locale.                                                                                                                                                                                                                                                                                                                      |
+| `enableProxy` | Mengaktifkan proxy perutean locale Intlayer (middleware).                                                                                                                                                            | `boolean` &#124; <br/> `undefined`                                                                                                                                                                           | `undefined` (auto)     | `true`                                                                                                                                                                                            | • Tidak diatur (auto): server dev dan preview mengabaikan locale yang tersimpan di cookie/header sebagai sumber pengalihan; prefiks, penyimpanan, dan deteksi `Accept-Language` tetap berlaku. Di produksi berperilaku seperti `true`.<br/>• `true`: perilaku penuh di mana pun.<br/>• `false`: tanpa perutean locale. Di Next.js, middleware `intlayerProxy` menjadi pass-through. |
+| `storage`     | Konfigurasi untuk menyimpan locale di klien.                                                                                                                                                                         | `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 }]`                                                                                                                | Lihat tabel Opsi Penyimpanan di bawah.                                                                                                                                                                                                                                                                                                                                              |
+| `basePath`    | Path dasar untuk URL aplikasi.                                                                                                                                                                                       | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                       | Jika aplikasi berada di `https://example.com/my-app, basePath adalah `'/my-app'`dan URL menjadi`https://example.com/my-app/en`.                                                                                                                                                                                                                                                     |
+| `rewrite`     | Aturan penulisan ulang URL kustom yang mengesampingkan mode routing default untuk path tertentu. Mendukung parameter dinamis `[param]`.                                                                              | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | Lihat contoh di bawah                                                                                                                                                                             | • Aturan penulisan ulang (rewrite) didahulukan daripada `mode`.<br/>• Berfungsi dengan Next.js dan Vite.<br/>• `getLocalizedUrl()` secara otomatis menerapkan aturan yang cocok.<br/>• Lihat [Penulisan Ulang URL Kustom](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md).                                                                    |
+| `domains`     | Memetakan locale ke nama host domain untuk routing berbasis domain. Jika diatur, URL untuk locale tersebut menggunakan domain ini sebagai basis (URL absolut) dan tidak ada prefiks locale yang ditambahkan ke path. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                       | • Protokol default adalah `https://` jika tidak disertakan dalam hostname.<br/>• Domain itu sendiri mengidentifikasi locale, sehingga prefiks `/zh/` tidak ditambahkan.<br/>• `getLocalizedUrl('/', 'zh')` mengembalikan `https://intlayer.zh/`.                                                                                                                                    |
 
 **Contoh `rewrite`**: