@intlayer/docs 9.4.1 → 9.4.3

package/docs/id/bundle_optimization.md

@@ -43,139 +43,6 @@ Sebagai contoh, sebuah aplikasi dengan 10 halaman yang diterjemahkan ke dalam 10
 
 <TOC />
 
-## Analisis bundle Anda
-
-Menganalisis bundle Anda adalah langkah pertama untuk mengidentifikasi file JSON yang "berat" dan mencari peluang code-splitting. Alat-alat ini menghasilkan treemap visual dari kode aplikasi Anda yang sudah dikompilasi, memungkinkan Anda melihat persis pustaka mana yang menghabiskan ruang paling banyak.
-
-<Tabs>
- <Tab value="vite">
-
-### Vite / Rollup
-
-Vite menggunakan Rollup di balik layar. Plugin `rollup-plugin-visualizer` menghasilkan file HTML interaktif yang menunjukkan ukuran setiap modul dalam graf Anda.
-
-```bash
-npm install -D rollup-plugin-visualizer
-```
-
-```typescript fileName="vite.config.ts"
-import { defineConfig } from "vite";
-import { visualizer } from "rollup-plugin-visualizer";
-
-export default defineConfig({
-  plugins: [
-    visualizer({
-      open: true, // Buka laporan secara otomatis di browser Anda
-      filename: "stats.html",
-      gzipSize: true,
-      brotliSize: true,
-    }),
-  ],
-});
-```
-
- </Tab>
- <Tab value="nextjs (turbopack)">
-
-### Next.js (Turbopack)
-
-Untuk proyek yang menggunakan App Router dan Turbopack, Next.js menyediakan analyzer eksperimental bawaan yang tidak memerlukan dependensi ekstra.
-
-```bash packageManager='npm'
-npx next experimental-analyze
-```
-
-```bash packageManager='yarn'
-yarn next experimental-analyze
-```
-
-```bash packageManager='pnpm'
-pnpm next experimental-analyze
-```
-
-```bash packageManager='bun'
-bun next experimental-analyze
-```
-
- </Tab>
- <Tab value="nextjs (Webpack)">
-
-### Next.js (Webpack)
-
-Jika Anda menggunakan bundler Webpack default di Next.js, gunakan bundle analyzer resminya. Pemicu jalannya alat ini bisa diatur menggunakan environment variable selama proses build.
-
-```bash packageManager='npm'
-npm install -D @next/bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D @next/bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D @next/bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d @next/bundle-analyzer
-```
-
-```javascript fileName="next.config.js"
-const withBundleAnalyzer = require("@next/bundle-analyzer")({
-  enabled: process.env.ANALYZE === "true",
-});
-
-module.exports = withBundleAnalyzer({
-  // Konfigurasi Next.js Anda
-});
-```
-
-**Penggunaan:**
-
-```bash
-ANALYZE=true npm run build
-```
-
- </Tab>
- <Tab value="Webpack (CRA / Angular / etc)">
-
-### Standard Webpack
-
-Untuk Create React App (ejected), Angular, atau setup kustom Webpack, gunakan standar industri `webpack-bundle-analyzer`.
-
-```bash packageManager='npm'
-npm install -D webpack-bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d webpack-bundle-analyzer
-```
-
-```typescript fileName="webpack.config.ts"
-import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
-
-export default {
-  plugins: [
-    new BundleAnalyzerPlugin({
-      analyzerMode: "static",
-      reportFilename: "bundle-analyzer.html",
-      openAnalyzer: false,
-    }),
-  ],
-};
-```
-
- </Tab>
-</Tabs>
-
 ## Bagaimana cara kerjanya
 
 Intlayer menggunakan pendekatan **per komponen (per-component)**. Berbeda dengan file JSON global, konten Anda didefinisikan bersamaan dengan atau di dalam komponen Anda. Selama proses build, Intlayer akan:
@@ -189,59 +56,6 @@ Hal ini memastikan bahwa:
 - Jika komponen tidak diimpor, kontennya tidak disertakan dalam bundle (Dead Code Elimination).
 - Jika komponen dimuat secara lazy (lazy-loaded), kontennya juga dimuat secara lazy.
 
-## Referensi Plugin
-
-Optimasi build dari Intlayer terbagi menjadi beberapa plugin terpisah yang masing-masing memiliki satu tanggung jawab saja. Memahami apa yang dilakukan oleh setiap plugin akan mencegah kebingungan saat mengonfigurasikannya.
-
-### Plugin Babel (`@intlayer/babel`)
-
-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/`                         |
-| `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.
-
-Setiap plugin Babel memiliki "options helper" yang berhubungan untuk membaca `intlayer.config.ts` Anda hanya sekali pada saat memuat konfigurasi, lalu mengembalikan nilai-nilai (values) yang sudah diselesaikan (resolved):
-
-| Options helper               | Digunakan dengan              |
-| :--------------------------- | :---------------------------- |
-| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
-| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
-
-### Plugin Vite (`vite-intlayer`)
-
-Pengguna Vite **tidak pernah mengonfigurasi ini secara langsung**. Plugin ini terpasang secara otomatis ketika Anda memanggil `withIntlayer()` di dalam `vite.config.ts`. Flag (penanda) `build.purge` dan `build.minify` di `intlayer.config.ts` dapat menghidupkan/mematikan perilakunya tanpa perlu me-register plugin tambahan apa pun.
-
-| Plugin Vite Internal | Perilaku ekuivalen                                                                                  |
-| :------------------- | :-------------------------------------------------------------------------------------------------- |
-| Usage analyzer       | Sama seperti pass analisis (analyse) dari `intlayerPurgeBabelPlugin`                                |
-| Dictionary prune     | Sama seperti pass penulisan JSON dari `intlayerPurgeBabelPlugin`                                    |
-| 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>
@@ -405,6 +219,59 @@ module.exports = {
  </Tab>
 </Tabs>
 
+## Referensi Plugin
+
+Optimasi build dari Intlayer terbagi menjadi beberapa plugin terpisah yang masing-masing memiliki satu tanggung jawab saja. Memahami apa yang dilakukan oleh setiap plugin akan mencegah kebingungan saat mengonfigurasikannya.
+
+### Plugin Babel (`@intlayer/babel`)
+
+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/`                         |
+| `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.
+
+Setiap plugin Babel memiliki "options helper" yang berhubungan untuk membaca `intlayer.config.ts` Anda hanya sekali pada saat memuat konfigurasi, lalu mengembalikan nilai-nilai (values) yang sudah diselesaikan (resolved):
+
+| Options helper               | Digunakan dengan              |
+| :--------------------------- | :---------------------------- |
+| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
+| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
+| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
+
+### Plugin Vite (`vite-intlayer`)
+
+Pengguna Vite **tidak pernah mengonfigurasi ini secara langsung**. Plugin ini terpasang secara otomatis ketika Anda memanggil `withIntlayer()` di dalam `vite.config.ts`. Flag (penanda) `build.purge` dan `build.minify` di `intlayer.config.ts` dapat menghidupkan/mematikan perilakunya tanpa perlu me-register plugin tambahan apa pun.
+
+| Plugin Vite Internal | Perilaku ekuivalen                                                                                  |
+| :------------------- | :-------------------------------------------------------------------------------------------------- |
+| Usage analyzer       | Sama seperti pass analisis (analyse) dari `intlayerPurgeBabelPlugin`                                |
+| Dictionary prune     | Sama seperti pass penulisan JSON dari `intlayerPurgeBabelPlugin`                                    |
+| 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.
+
 ## Konfigurasi
 
 Anda dapat mengontrol cara Intlayer mengoptimalkan bundle Anda menggunakan properti `build` di file `intlayer.config.ts` Anda.
@@ -650,3 +517,136 @@ const content = useDictionaryAsync({
 | **Ketergantungan Network**         | 0 penarikan tambahan (bebas jaringan)              | 1 penarikan per satuan key dictionary    |
 | **Pemotongan file (Tree Shaking)** | Hanya di ranah komponen                            | Menyortir per komponen + wilayah lokal   |
 | **Skema Target Terbaik**           | Tombol navigasi (UI), Situs SPA Kecil              | Artikel berat/banyak, Beragam terjemahan |
+
+## Analisis bundle Anda
+
+Menganalisis bundle Anda adalah cara paling langsung untuk mengidentifikasi file JSON yang "berat" dan mencari peluang code-splitting. Alat-alat ini menghasilkan treemap visual dari kode aplikasi Anda yang sudah dikompilasi, memungkinkan Anda melihat persis pustaka mana yang menghabiskan ruang paling banyak.
+
+<Tabs>
+ <Tab value="vite">
+
+### Vite / Rollup
+
+Vite menggunakan Rollup di balik layar. Plugin `rollup-plugin-visualizer` menghasilkan file HTML interaktif yang menunjukkan ukuran setiap modul dalam graf Anda.
+
+```bash
+npm install -D rollup-plugin-visualizer
+```
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { visualizer } from "rollup-plugin-visualizer";
+
+export default defineConfig({
+  plugins: [
+    visualizer({
+      open: true, // Buka laporan secara otomatis di browser Anda
+      filename: "stats.html",
+      gzipSize: true,
+      brotliSize: true,
+    }),
+  ],
+});
+```
+
+ </Tab>
+ <Tab value="nextjs (turbopack)">
+
+### Next.js (Turbopack)
+
+Untuk proyek yang menggunakan App Router dan Turbopack, Next.js menyediakan analyzer eksperimental bawaan yang tidak memerlukan dependensi ekstra.
+
+```bash packageManager='npm'
+npx next experimental-analyze
+```
+
+```bash packageManager='yarn'
+yarn next experimental-analyze
+```
+
+```bash packageManager='pnpm'
+pnpm next experimental-analyze
+```
+
+```bash packageManager='bun'
+bun next experimental-analyze
+```
+
+ </Tab>
+ <Tab value="nextjs (Webpack)">
+
+### Next.js (Webpack)
+
+Jika Anda menggunakan bundler Webpack default di Next.js, gunakan bundle analyzer resminya. Pemicu jalannya alat ini bisa diatur menggunakan environment variable selama proses build.
+
+```bash packageManager='npm'
+npm install -D @next/bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D @next/bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D @next/bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d @next/bundle-analyzer
+```
+
+```javascript fileName="next.config.js"
+const withBundleAnalyzer = require("@next/bundle-analyzer")({
+  enabled: process.env.ANALYZE === "true",
+});
+
+module.exports = withBundleAnalyzer({
+  // Konfigurasi Next.js Anda
+});
+```
+
+**Penggunaan:**
+
+```bash
+ANALYZE=true npm run build
+```
+
+ </Tab>
+ <Tab value="Webpack (CRA / Angular / etc)">
+
+### Standard Webpack
+
+Untuk Create React App (ejected), Angular, atau setup kustom Webpack, gunakan standar industri `webpack-bundle-analyzer`.
+
+```bash packageManager='npm'
+npm install -D webpack-bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d webpack-bundle-analyzer
+```
+
+```typescript fileName="webpack.config.ts"
+import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
+
+export default {
+  plugins: [
+    new BundleAnalyzerPlugin({
+      analyzerMode: "static",
+      reportFilename: "bundle-analyzer.html",
+      openAnalyzer: false,
+    }),
+  ],
+};
+```
+
+ </Tab>
+</Tabs>

package/docs/id/configuration.md

@@ -1122,3 +1122,101 @@ Mengontrol pengaturan kompiler Intlayer yang mengumpulkan kamus langsung dari ko
 | Bidang    | Deskripsi                                    | Tipe               |
 | --------- | -------------------------------------------- | ------------------ |
 | `plugins` | Daftar plugin Intlayer yang akan disertakan. | `IntlayerPlugin[]` |
+
+## Pertanyaan yang Sering Diajukan
+
+<FAQ>
+
+<Question title="Di mana file intlayer.config.ts harus berada?">
+
+Di root project Anda, di sebelah `package.json`. Intlayer memindai direktori kerja dan direktori induk untuk mencari `intlayer.config.ts`, `intlayer.config.js`, `intlayer.config.mjs`, atau `intlayer.config.cjs`. Anda juga dapat menentukan path khusus melalui flag `--config` pada perintah CLI.
+
+</Question>
+
+<Question title="Berapa banyak i18n menambah ukuran bundle saya?">
+
+Jauh lebih sedikit daripada pengaturan berbasis namespace, karena halaman tidak pernah mengunduh katalog yang tidak di-render. Markup yang dirender di server menyelesaikan kontennya di server, dan kompilator build time mengganti panggilan `useIntlayer` dengan entri kamus persis yang digunakan komponen, sehingga kunci dan bahasa yang tidak digunakan dibuang. [Kamus dinamis](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md) membagi sisanya per locale. Dibandingkan dengan alternatif konvensional, Intlayer mengurangi ukuran bundle dan halaman hingga 50%. Lihat [optimasi bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/bundle_optimization.md) dan [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/benchmark/index.md).
+
+</Question>
+
+<Question title="Bisakah saya bermigrasi dari i18next, next-intl atau react-i18next tanpa menulis ulang komponen saya?">
+
+Ya, dan ada dua jalur. Anda dapat memigrasikan konten secara bertahap dengan [panduan migrasi i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/migration_from_i18next_to_intlayer.md) atau [panduan migrasi next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/migration_from_next-intl_to_intlayer.md). Atau Anda dapat mempertahankan API Anda saat ini sepenuhnya: [adapter kompatibilitas](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/compat/index.md) mengekspos API yang sama persis dengan `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` dan `Lingui`, tetapi ditenagai oleh kamus Intlayer, sehingga hanya import yang berubah dan kode komponen tetap sama.
+
+</Question>
+
+<Question title="Bisakah saya menyimpan file terjemahan JSON yang sudah ada?">
+
+Ya. Plugin [sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/plugins/sync-json.md) menjaga file `/messages/{locale}/{namespace}.json` Anda sebagai sumber kebenaran dan menghasilkan kamus Intlayer darinya, di kedua arah. Plugin [sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/plugins/sync-po.md) melakukan hal yang sama untuk katalog gettext, dan [file per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/per_locale_file.md) memungkinkan Anda membagi konten berdasarkan bahasa daripada mengelompokkan lokal dalam satu file.
+
+</Question>
+
+<Question title="Apakah saya harus memindahkan konten saya key by key?">
+
+Tidak. Jalankan `npx intlayer extract` dan Intlayer membaca file sumber Anda, mengeluarkan string yang dihadapi pengguna, dan menulis file `.content` di sebelah masing-masing, sehingga Anda meninjau diff alih-alih menyalin string ke dalam katalog satu per satu. Lihat [perintah extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/extract.md).
+
+Untuk alur kerja yang sepenuhnya otomatis, [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/compiler.md) melakukan hal yang sama saat build time pada kode JSX, TSX, Vue dan Svelte, menghasilkan kamus pada setiap perubahan sehingga tidak ada kunci yang perlu dikelola secara manual. Karena bekerja melalui analisis statis, string yang hanya ada di runtime berada di luar jangkauannya.
+
+</Question>
+
+<Question title="Apa tooling editor dan agen AI yang tersedia?">
+
+Lima bagian, semuanya opsional:
+
+- **[Ekstensi VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/vs_code_extension.md)**: lompat dari kunci `useIntlayer` ke file konten yang mendeklarasikannya, ekstrak konten dari komponen, dan jalankan build, fill, test, push dan pull dari command palette atau tab Intlayer.
+- **[Server LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/lsp.md)**: kesadaran yang sama di editor mana pun yang mendukung LSP, dengan go to definition, hover preview dari nilai terjemahan, autocompletion kunci, dan peringatan ketika kunci tidak dideklarasikan di mana pun. Ini juga menyelesaikan panggilan `i18next`, `react-i18next`, `next-intl` dan `use-intl`.
+- **[Server MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/mcp_server.md)**: mengekspos dokumentasi Intlayer dan CLI ke Cursor, VS Code, Claude Desktop, Claude Code dan ChatGPT.
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/agent_skills.md)**: keahlian terfokus seperti `intlayer-config`, `intlayer-cli` dan `intlayer-content`.
+- **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/eslint.md)**: aturan `no-raw-text` menandai string hardcoded.
+
+</Question>
+
+<Question title="Bagaimana cara menambahkan bahasa baru ke aplikasi saya?">
+
+Tambahkan kode locale ke array `internationalization.locales`, lalu jalankan `npx intlayer fill` untuk menerjemahkan konten yang ada secara otomatis. Compiler akan menyertakan bahasa baru pada build berikutnya.
+
+</Question>
+
+<Question title="Bagaimana cara menghapus prefix locale dari URL saya?">
+
+Atur `routing.mode`. Nilai `"no-prefix"` menghapus prefix untuk semua bahasa, menentukan locale melalui cookie, header, atau domain. Nilai `"prefix-no-default"` (default) menghapus prefix hanya untuk bahasa utama.
+
+</Question>
+
+<Question title="Bisakah saya menyajikan setiap bahasa dari domainnya sendiri?">
+
+Ya. Opsi `routing.domains` memetakan setiap locale ke hostname, misalnya `{ id: 'example.co.id', en: 'example.com' }`. Deteksi domain didahulukan daripada prefix path, dan `getMultilingualUrls` menghasilkan URL lengkap untuk `hreflang`.
+
+</Question>
+
+<Question title="Bagaimana bahasa pengguna dideteksi?">
+
+Melalui `routing.storage`, yang mencantumkan sumber sesuai urutan prioritas: biasanya URL terlebih dahulu, lalu cookie, kemudian header `Accept-Language`, dan beralih ke bahasa default jika tidak ditemukan.
+
+</Question>
+
+<Question title="Apa yang dilakukan routing.enableProxy?">
+
+Mengontrol proxy routing locale, middleware yang menyelesaikan prefix dan redirect. Secara default proxy aktif di mode dev dan produksi. Jika disetel ke `false`, proxy dinonaktifkan sepenuhnya.
+
+</Question>
+
+<Question title="Apa perbedaan antara importMode static, dynamic dan fetch?">
+
+`"static"` (default) mengimpor kamus secara statis sehingga dibundel dan dibaca secara sinkron. `"dynamic"` mengimpor kamus secara asinkron per bahasa untuk meringankan bundle awal. `"fetch"` mengambil kamus dari server atau CMS saat runtime.
+
+</Question>
+
+<Question title="Di mana saya mengatur AI provider dan API key untuk terjemahan otomatis?">
+
+Di file konfigurasi pada bagian `ai` atau di baris perintah menggunakan flag `--provider`, `--model`, dan `--api-key`. API key tetap berada di lokal dan tidak pernah meninggalkan lingkungan Anda. Lihat [referensi konfigurasi AI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md).
+
+</Question>
+
+<Question title="Apakah saya perlu me-restart server pengembangan setelah mengubah konfigurasi?">
+
+Biasanya tidak. Watcher Intlayer memantau file `intlayer.config.ts`: saat disimpan, ia memuat ulang konfigurasi dan memperbarui kamus di latar belakang.
+
+</Question>
+
+</FAQ>

package/docs/id/dictionary/content_file.md

@@ -366,15 +366,15 @@ Mengubah kamus menjadi kamus per-locale di mana setiap field yang dideklarasikan
 
 **Contoh:**
 
-```json
+```jsonc
 // Kamus per-lokasi
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // Ini menjadi node terjemahan untuk 'en'
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -444,7 +444,7 @@ Instruksi untuk mengisi konten kamus secara otomatis dari sumber eksternal. Ini
 
 **Contoh:**
 
-```json
+```jsonc
 // Menonaktifkan pengisian
 {
   "fill": false

package/docs/id/dictionary/markdown.md

@@ -51,6 +51,7 @@ Anda dapat mendeklarasikan konten Markdown menggunakan fungsi `md` atau cukup se
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     Mulai dari versi `8.10.0`, Anda dapat mendeklarasikan konten Markdown langsung di dalam file `.content.md`. Intlayer akan secara otomatis mendeteksi dan mem-parsing konten Markdown.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ Anda dapat mendeklarasikan konten Markdown menggunakan fungsi `md` atau cukup se
     ```
 
   </Tab>
+
   <Tab label="File Eksternal" value="external-files">
     Impor file `.md` secara langsung menggunakan fungsi `file`.
 
@@ -129,6 +131,7 @@ Anda dapat mendeklarasikan konten Markdown menggunakan fungsi `md` atau cukup se
     ```
 
   </Tab>
+
 </Tabs>
 
 ## Merender Markdown

package/docs/id/dictionary/plurial.md

@@ -35,9 +35,12 @@ Berbeda dengan [`enu`](https://github.com/aymericzip/intlayer/blob/main/docs/doc
 
 ## Kapan Menggunakan `plural` vs `enu`
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Kasus penggunaan                                                          | Pembantu |
+| ------------------------------------------------------------------------- | -------- |
+| Bentuk jamak tata bahasa yang peka terhadap locale (satu apel / dua apel) | `plural` |
+| Rentang angka kustom (`<5`, `>=10`) atau kategori non-CLDR                | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Jika Anda hanya menargetkan bahasa Inggris (yang hanya memiliki `one` / `other`), keduanya berfungsi. Untuk bahasa apa pun dengan perbedaan `few` / `many` / `two`, lebih disukai `plural`.
 
 ## Menyiapkan Konten Jamak