@intlayer/docs 9.3.3 → 9.4.0

package/docs/id/packages/intlayer/getIntlayer.md

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Dokumentasi Fungsi getIntlayer | intlayer
+description: Lihat cara menggunakan fungsi getIntlayer untuk package intlayer
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Dokumentasi: Fungsi `getIntlayer` di `intlayer`
+
+## Deskripsi
+
+Fungsi `getIntlayer` memilih satu kamus berdasarkan kuncinya dan mengembalikan isinya yang diinterpretasikan untuk lokal yang diberikan. Ini adalah pasangan yang independen dari kerangka kerja dari hook `useIntlayer`: konten yang sama, pemilih yang sama, tetapi dapat digunakan di mana pun konteks React tidak tersedia — skrip Node, fungsi server, pemuat rute, pembuat metadata, penangan Express/Fastify, tes.
+
+Ini membaca kamus yang dihasilkan oleh Intlayer di `.intlayer/`, jadi argumen `key` diketik dan selesai otomatis dari deklarasi konten Anda sendiri, dan objek yang dikembalikan sepenuhnya diketik hingga setiap daun.
+
+**Fitur Utama:**
+
+- Kunci kamus yang diketik dan konten yang dikembalikan diketik
+- Menginterpretasikan setiap node konten (`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- Menerima lokal atau objek pemilih (koleksi, varian)
+- Hasil di-cache per `key + locale + selector`
+- Kembali ke proksi yang aman dalam pengembangan ketika kamus hilang, alih-alih mengalami kegagalan
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // Wajib
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opsional
+  plugins?: Plugins[]                         // Opsional
+): DeepTransformContent<...>
+```
+
+---
+
+## Parameter
+
+- `key: DictionaryKeys`
+  - **Deskripsi**: Kunci kamus yang akan dibaca, seperti yang dideklarasikan dalam file konten Anda.
+  - **Tipe**: `DictionaryKeys` — sebuah union dari setiap kunci kamus yang dideklarasikan.
+  - **Diperlukan**: Ya
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Deskripsi**: Locale untuk menginterpretasi konten dengan, atau objek selector untuk [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md).
+    - `'fr'` — sebuah locale
+    - `{ item: 2 }` — sebuah [collection](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/collections.md) item (abaikan `item` untuk mendapatkan setiap item sebagai array)
+    - `{ variant: 'black-friday' }` — sebuah [variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/variants.md) bernama (abaikan untuk yang `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — sebuah variant terstruktur
+    - Setiap selector dapat membawa sebuah locale: `{ item: 2, locale: 'fr' }`
+  - **Tipe**: `LocalesValues | DictionarySelector`
+  - **Diperlukan**: Tidak (Opsional) — default ke `defaultLocale` yang dikonfigurasi.
+
+- `plugins: Plugins[]`
+  - **Deskripsi**: Custom node transformers menggantikan plugin interpreter dasar. Penggunaan lanjutan saja; abaikan ini untuk mempertahankan perilaku default.
+  - **Tipe**: `Plugins[]`
+  - **Diperlukan**: Tidak (Opsional)
+
+### Returns
+
+- **Type**: Konten dictionary yang diinterpretasi, diketik dari deklarasi Anda.
+- **Description**: Objek biasa yang mencerminkan bidang `content` dari dictionary Anda, di mana setiap node Intlayer telah diselesaikan ke nilai akhirnya untuk locale yang diminta.
+
+---
+
+## Contoh Penggunaan
+
+### Penggunaan Dasar
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      id: "Halo",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### Tanpa locale
+
+Menghilangkan locale menginterpretasi konten dengan `defaultLocale` yang dideklarasikan dalam [konfigurasi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md) Anda.
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // Diinterpretasi dengan locale default
+```
+
+### Di dalam server handler
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### Dengan selector (koleksi dan varian)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// Item koleksi tunggal
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// Setiap item dari koleksi, sebagai array yang terurut
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// Varian bernama
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## Catatan Perilaku
+
+### Caching
+
+Hasil disimpan dalam cache tingkat modul dengan kunci `key + locale + selector`. Memanggil `getIntlayer("app", "fr")` berulang kali menginterpretasi dictionary sekali dan mengembalikan objek yang sama setelahnya.
+
+### Kamus yang Hilang
+
+Dalam pengembangan, meminta kunci yang tidak memiliki kamus yang dihasilkan mencatat peringatan sekali dan mengembalikan proxy fallback yang aman: membaca `content.title` menghasilkan string `"app.title"` alih-alih melempar. Ini membuat halaman tetap dapat digunakan sementara deklarasi yang hilang diperbaiki. Jalankan build Intlayer (atau dev server) agar kamus dihasilkan.
+
+### Ukuran Bundle
+
+`getIntlayer` membaca dictionary yang digabungkan, yang menyimpan **setiap** locale. Dalam client bundles, [build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/bundle_optimization.md) menulis ulang panggilan sehingga hanya konten yang diperlukan yang dikirim. Ketika Anda membaca konten di luar rendering (metadata, loaders, server functions) dan ingin satu locale dimuat sesuai permintaan, gunakan [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayerAsync.md) sebagai gantinya.
+
+---
+
+## Fungsi Terkait
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayerAsync.md): Counterpart async yang memuat satu chunk locale.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getDictionary.md): Menginterpretasikan object dictionary yang Anda berikan sendiri, alih-alih yang dicari berdasarkan key.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/react-intlayer/useIntlayer.md): Equivalent React hook, membaca locale dari provider.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/id/packages/intlayer/getIntlayerAsync.md

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Dokumentasi Fungsi getIntlayerAsync | intlayer
+description: Lihat cara menggunakan fungsi getIntlayerAsync untuk package intlayer
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Dokumentasi: Fungsi `getIntlayerAsync` di `intlayer`
+
+## Deskripsi
+
+Fungsi `getIntlayerAsync` memilih satu kamus berdasarkan kuncinya dan menyelesaikan kontennya untuk locale yang diberikan, **memuat locale tersebut saja**.
+
+Ini adalah mitra asinkron dari [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayer.md), dimaksudkan untuk tempat-tempat di mana kamus dibaca di luar rendering — route `head` / pembangun metadata, loaders, server functions.
+
+Di mana `getIntlayer` menarik kamus gabungan yang menampung setiap locale, [plugin build](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`) menulis ulang panggilan ini menjadi `getDictionaryAsync(loaderMap, key, locale)`, mengarahkannya ke chunk per-locale di `.intlayer/dynamic_dictionaries/`. Bundle oleh karena itu hanya pernah membawa locale yang benar-benar diminta.
+
+Tanpa plugin tersebut — build yang tidak dioptimalkan — panggilan diselesaikan melalui registry kamus sinkron sebagai gantinya: konten yang sama, tanpa pemisahan per-locale.
+
+**Fitur Utama:**
+
+- Kunci, selektor dan konten yang dikembalikan sama dengan `getIntlayer`
+- Memuat hanya chunk locale yang diminta dalam build yang dioptimalkan
+- Panggilan bersamaan untuk chunk yang sama berbagi satu load
+- Aman digunakan dalam pembangun metadata `async`, loaders dan server functions
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // Diperlukan
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opsional
+  plugins?: Plugins[]                         // Opsional
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Parameters
+
+- `key: DictionaryKeys`
+  - **Description**: Kunci kamus yang akan dibaca, seperti yang dideklarasikan dalam file konten Anda.
+  - **Type**: `DictionaryKeys` — union dari setiap kunci kamus yang dideklarasikan.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Locale untuk menginterpretasi konten, atau objek selector untuk [kamus dinamis](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md).
+    - `'fr'` — sebuah locale
+    - `{ item: 2 }` — item [collection](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/collections.md) (abaikan `item` untuk mendapatkan setiap item sebagai array)
+    - `{ variant: 'black-friday' }` — [variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/variants.md) bernama (abaikan untuk yang `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — variant terstruktur
+    - Setiap selector dapat membawa locale: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — defaults ke `defaultLocale` yang dikonfigurasi.
+
+- `plugins: Plugins[]`
+  - **Description**: Custom node transformers yang menggantikan base interpreter plugins. Penggunaan advanced only.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Returns
+
+- **Type**: `Promise<Content>` — a promise yang resolve ke konten yang diinterpretasi dari dictionary, yang diketik dari declaration Anda.
+
+---
+
+## Contoh Penggunaan
+
+### Penggunaan Dasar
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` vs `getIntlayerAsync`
+
+|                    | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                                |
+| ------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| Returns            | Konten                                                                                                          | Janji dari konten                                 |
+| Dictionary loaded  | Dictionary yang digabungkan (semua locale)                                                                      | Chunk dari locale yang diminta saja               |
+| Best suited for    | Rendering, jalur kode sinkron                                                                                   | Metadata, loaders, fungsi server                  |
+| Requires a plugin? | Tidak                                                                                                           | Tidak — split per-locale memerlukan build plugins |
+
+Keduanya menerima argumen yang sama dan mengembalikan konten yang sama: beralih dari satu ke yang lain hanya mengubah **kapan** dan **berapa banyak** yang dimuat.
+
+---
+
+## Fungsi Terkait
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayer.md): Ekuivalen sinkron yang membaca dictionary yang sudah digabung.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getDictionaryAsync.md): Fungsi tingkat rendah yang plugin build tulis ulang menjadi panggilan ini.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getLocale.md): Mendeteksi locale dari request yang masuk.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/id/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Fungsi `getLocalizedPath` mengubah canonical path (path internal aplikasi) menjadi padanan yang dilokalkan berdasarkan locale dan aturan rewrite yang disediakan. Fungsi ini sangat berguna untuk menghasilkan URL ramah SEO yang berbeda menurut bahasa.
 
+Ini adalah padanan relatif dari [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getLocalizedUrl.md) — untuk input relatif keduanya mengembalikan nilai yang sama. Tidak seperti `getLocalizedUrl`, ini tidak pernah mengembalikan URL absolut: konfigurasi `domains` diabaikan, jadi locale yang disajikan dari domain-nya sendiri masih menghasilkan path. Input absolut diterima, tetapi asal-usulnya dijatuhkan — hanya path, query string, dan hash yang dipertahankan.
+
 **Fitur Utama:**
 
 - Mendukung parameter route dinamis menggunakan sintaks `[param]`.
@@ -60,18 +62,23 @@ getLocalizedPath(
   - **Tipe**: `string`
   - **Diperlukan**: Ya
 
-- `locale: Locales`
-  - **Deskripsi**: Locale target yang akan digunakan untuk melokalkan jalur.
-  - **Tipe**: `Locales`
-  - **Diperlukan**: Ya
-
 ### Parameter Opsional
 
+- `locale?: Locales`
+  - **Description**: Locale target untuk mana path harus dilokalisasi.
+  - **Type**: `Locales`
+  - **Default**: Locale default dari konfigurasi proyek Anda.
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Deskripsi**: Objek yang mendefinisikan aturan rewrite kustom. Jika tidak diberikan, akan menggunakan properti `routing.rewrite` dari konfigurasi proyek Anda.
   - **Tipe**: `RoutingConfig['rewrite']`
   - **Default**: `configuration.routing.rewrite`
 
+  - `options.locales?: Locales[]` — locale yang didukung. **Default**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — locale default. **Default**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — bagaimana locale muncul di path. **Default**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — custom rewrite rules. **Default**: `configuration.routing.rewrite`
+
 ---
 
 ## Pengembalian
@@ -79,6 +86,28 @@ getLocalizedPath(
 - **Tipe**: `string`
 - **Deskripsi**: Jalur yang telah dilokalkan untuk locale yang ditentukan.
 
+Jenis ini disempitkan dari aturan rewrite yang dideklarasikan dalam konfigurasi Anda, sehingga editor menampilkan jalur yang diselesaikan daripada `string` biasa:
+
+```typescript codeFormat="typescript"
+// Konfigurasi: mode 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (tidak ada aturan rewrite yang cocok, hanya prefix yang diterapkan)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Penyempitan yang sama mengalir ke dalam [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getLocalizedUrl.md), yang menerapkan aturan penulisan ulang sebelum memberi awalan locale.
+
+Dua kasus tetap meluas menjadi `string`, karena tidak dapat diselesaikan pada waktu kompilasi:
+
+- sebuah path yang bukan string literal (misalnya, yang dibangun dari variabel);
+- sebuah path yang cocok dengan rule menggunakan parameter multi-segment atau opsional (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Contoh Penggunaan
@@ -126,6 +155,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Keluaran: "/contactez-nous"
 ```
 
+### Menghilangkan Locale
+
+Ketika tidak ada locale yang diberikan, path dilokalisasi untuk locale default yang dikonfigurasi:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Konfigurasi: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Output: "/about"
+```
+
 ---
 
 ## Fungsi Terkait

package/docs/id/packages/intlayer/getLocalizedUrl.md

@@ -70,6 +70,11 @@ getLocalizedUrl(
 
 ### Parameter Opsional
 
+- `options?: object`
+  - **Description**: Objek konfigurasi untuk perilaku lokalisasi URL.
+  - **Type**: `object`
+  - **Required**: Tidak (Opsional)
+
 - `locales?: Locales[]`
   - **Deskripsi**: Array locale yang didukung. Jika tidak disediakan, menggunakan locale yang dikonfigurasi dari konfigurasi proyek Anda.
   - **Tipe**: `Locales[]`
@@ -112,38 +117,6 @@ getLocalizedUrl("/about", Locales.ENGLISH);
 // Output: "/about" atau "/en/about" (tergantung pada pengaturan prefixDefault Anda)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-// Secara eksplisit memberikan semua parameter opsional
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Output: "/fr/about" untuk locale Bahasa Perancis
-// Output: "/about" untuk locale default (Bahasa Inggris)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-// Secara eksplisit memberikan semua parameter opsional
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Output: "/fr/about" untuk locale Bahasa Perancis
-// Output: "/about" untuk locale default (Bahasa Inggris)
-```
-
 ### Penggunaan Lanjutan (Dengan Parameter Opsional)
 
 Anda dapat mengganti konfigurasi default dengan menyediakan parameter `options` opsional:
@@ -245,6 +218,12 @@ getLocalizedUrl(
 - **Locale Tidak Didukung:**
   - Untuk locale yang tidak tercantum dalam `locales`, fungsi tidak menerapkan prefix apapun.
 
+- **Mode Routing:**
+  - `'prefix-no-default'`: Locale default tidak memiliki prefix, yang lain memiliki (mis., `/about`, `/fr/about`)
+  - `'prefix-all'`: Semua locale memiliki prefix (mis., `/en/about`, `/fr/about`)
+  - `'no-prefix'`: Tidak ada prefix locale di URL (locale ditangani di tempat lain)
+  - `'search-params'`: Locale ditentukan melalui parameter query (mis., `/about?locale=fr`)
+
 ---
 
 ## Penggunaan dalam Aplikasi

package/docs/id/packages/intlayer/getMultilingualUrls.md

@@ -31,6 +31,14 @@ author: aymericzip
 
 Fungsi `getMultilingualUrls` menghasilkan pemetaan URL multibahasa dengan menambahkan prefix locale yang didukung pada URL yang diberikan. Fungsi ini dapat menangani URL absolut maupun relatif, dengan menerapkan prefix locale yang sesuai berdasarkan konfigurasi yang diberikan atau nilai default.
 
+**Fitur Utama:**
+
+- Hanya 1 parameter yang diperlukan: `url`
+- Object `options` opsional dengan `locales`, `defaultLocale`, dan `mode`
+- Menggunakan konfigurasi internasionalisasi proyek Anda sebagai default
+- Mendukung multiple routing modes: `prefix-no-default`, `prefix-all`, `no-prefix`, dan `search-params`
+- Mengembalikan mapping object dengan semua locale sebagai keys dan URL yang sesuai sebagai values
+
 ---
 
 ## Tanda Tangan Fungsi
@@ -139,8 +147,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Mode Routing Berbeda
 
 ```typescript
@@ -206,6 +212,12 @@ getMultilingualUrls("/dashboard", {
 - **Locale yang Tidak Didukung:**
   - Hanya locale yang disediakan dalam array `locales` yang dipertimbangkan untuk menghasilkan URL.
 
+- **Mode Routing:**
+  - `'prefix-no-default'`: Locale default tidak memiliki prefix, yang lain memiliki (mis., `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Semua locale memiliki prefix (mis., `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Tidak ada prefix locale di URL (semua locale mengembalikan URL yang sama)
+  - `'search-params'`: Locale ditentukan melalui parameter query (mis., `/dashboard?locale=fr`)
+
 ---
 
 ## Penggunaan dalam Aplikasi

package/docs/id/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Fungsi `getTranslationContent` mengambil konten yang sesuai dengan locale tertentu dari sekumpulan konten bahasa yang dapat disesuaikan. Jika locale yang ditentukan tidak ditemukan, fungsi ini akan mengembalikan konten untuk locale default yang dikonfigurasi dalam proyek.
 
+Untuk detail lebih lanjut tentang cara mendeklarasikan terjemahan, lihat [dokumentasi Translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dictionary/translation.md).
+
 ## Parameter
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/id/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ Dalam `next-intlayer`, locale saat ini dikelola melalui context providers: `Intl
 
 #### Contoh:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+</Tab>
+</Tabs>
+
 ---
 
 ## Kesalahan Umum dan Pemecahan Masalah

package/docs/id/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ Instruksi untuk mengatur file deklarasi konten tersedia [di sini](https://github
 
 Berikut cara mengimplementasikan hook `useIntlayer` dalam halaman Next.js untuk memuat konten yang dilokalkan secara dinamis berdasarkan locale aplikasi saat ini:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/id/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ Bagian ini memberikan panduan terperinci tentang penggunaan hook `useDictionary`
 
 ## Contoh Penggunaan di React
 
-Berikut adalah contoh cara menggunakan hook `useDictionary` dalam sebuah komponen React:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

package/docs/id/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ Semua kunci kamus harus dideklarasikan dalam file deklarasi konten untuk meningk
 
 Contoh penggunaan hook `useI18n` dalam komponen React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";