@intlayer/docs 9.4.0-canary.0 → 9.4.0

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

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Dokumentasi Fungsi getDictionary | intlayer
+description: Lihat cara menggunakan fungsi getDictionary untuk paket intlayer
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Documentation: Fungsi `getDictionary` dalam `intlayer`
+
+## Deskripsi
+
+Fungsi `getDictionary` menginterpretasi objek dictionary **yang Anda berikan sendiri** dan mengembalikan konten yang telah diselesaikan untuk locale tertentu. Fungsi ini berjalan melalui konten dalam satu pass dan menerapkan setiap plugin interpreter sesuai kebutuhan, menyelesaikan translasi `t()`, enumerations, conditions, insertions, nesting, markdown, HTML dan file nodes.
+
+Berbeda dengan [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayer.md), yang mencari dictionary berdasarkan key dalam registry yang dihasilkan, `getDictionary` mengambil dictionary itu sendiri. Hal ini menjadikannya alat yang tepat untuk konten yang dibangun pada saat runtime, diambil dari API atau CMS, atau dideklarasikan secara inline dalam test.
+
+**Fitur Utama:**
+
+- Bekerja dengan objek apa pun yang mengikuti struktur dictionary (`{ key, content }`)
+- Juga menerima dictionary group yang qualified (collections, variants) bersama dengan selector
+- Fully typed: objek yang dikembalikan mencerminkan `content` yang Anda berikan
+- Menerima plugin interpreter kustom
+
+---
+
+## Function Signature
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // Diperlukan
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opsional
+  plugins?: Plugins[]                                // Opsional
+): DeepTransformContent<...>
+```
+
+---
+
+## Parameters
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **Description**: Kamus (atau kelompok kamus yang memenuhi syarat) yang akan ditafsirkan.
+  - **Type**: `Dictionary | QualifiedDictionaryGroup`
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Locale untuk menafsirkan konten, atau objek selector (`{ item }`, `{ variant }`, secara opsional dengan `locale`). Lihat [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md).
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — defaults to the configured `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Array node transformers yang menentukan bagaimana node yang dikenali ditafsirkan. Jika dihilangkan, set default interpreter plugins digunakan.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Pengembalian
+
+- **Type**: Konten yang ditafsirkan dari kamus.
+- **Description**: `content` yang Anda berikan, dengan setiap node Intlayer diselesaikan untuk lokal yang diminta. Untuk grup koleksi tanpa pemilih `item`, array terurut dari entri yang ditafsirkan dikembalikan; `null` dikembalikan ketika pemilih tidak menargetkan apa pun.
+
+---
+
+## Contoh Penggunaan
+
+### Penggunaan Dasar
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        id: "Halo",
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "id"
+);
+
+console.log(content.greeting); // "Halo"
+```
+
+### Menginterpretasikan konten yang diambil saat runtime
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### Dengan selector
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// Grup dictionary yang qualified diuraikan menjadi satu entry…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …atau ke array yang terurut ketika tidak ada `item` yang diberikan
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## Fungsi Terkait
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayer.md): Interpretasi yang sama, tetapi kamus dicari berdasarkan kunci dalam registry yang dihasilkan.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getDictionaryAsync.md): Rekan untuk peta loader per-locale.
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/react-intlayer/useDictionary.md): Setara dengan React hook, membaca locale dari provider.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

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

@@ -0,0 +1,166 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Dokumentasi Fungsi getDictionaryAsync | intlayer
+description: Lihat cara menggunakan fungsi getDictionaryAsync untuk paket intlayer
+keywords:
+  - getDictionaryAsync
+  - dictionary
+  - dynamic dictionaries
+  - loader map
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionaryAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Dokumentasi: Fungsi `getDictionaryAsync` di `intlayer`
+
+## Deskripsi
+
+Fungsi `getDictionaryAsync` memuat **chunk locale tunggal** dari sebuah dictionary dan mengembalikan konten yang sudah diinterpretasi.
+
+Ini adalah padanan dari [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getDictionary.md) untuk per-locale loader maps yang dipancarkan di `.intlayer/dynamic_dictionaries/`: daripada menerima dictionary yang berisi setiap locale, ia menerima loader map dan hanya menunggu chunk yang dibutuhkan locale yang diminta.
+
+> Dalam kode aplikasi Anda biasanya memanggil [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayerAsync.md), bukan fungsi ini. [Build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/bundle_optimization.md) menulis ulang setiap panggilan `getIntlayerAsync('key', locale)` menjadi `getDictionaryAsync(loaderMap, 'key', locale)`. `getDictionaryAsync` diekspor untuk custom loaders dan untuk tooling yang membangun loader maps-nya sendiri.
+
+**Fitur Utama:**
+
+- Memuat hanya chunk locale yang diminta
+- Mendukung plain (`locale → loader`) dan qualified (`locale → qualifierId → loader`) loader maps
+- Menghilangkan duplikasi concurrent loads dari chunk yang sama, dan menyimpan konten yang sudah direspon dalam cache
+- Failed loads dihapus dari cache sehingga panggilan nanti mencoba ulang chunk
+
+---
+
+## Signature Fungsi
+
+```typescript
+getDictionaryAsync(
+  dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap, // Wajib
+  key: string,                                           // Wajib
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opsional
+  plugins?: Plugins[]                                    // Opsional
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Parameter
+
+- `dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap`
+  - **Description**: Peta loader per-locale. Peta biasa menghubungkan locale dengan loader; peta qualified (digunakan oleh collections dan variants) menghubungkan locale dengan qualifier id, kemudian dengan loader. Untuk peta qualified, hanya chunk(s) yang ditargetkan oleh selector yang dimuat.
+  - **Type**: `PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap`
+  - **Required**: Yes
+
+- `key: string`
+  - **Description**: Kunci dictionary, digunakan untuk namespace chunk cache.
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Locale untuk menginterpretasikan konten dengan, atau objek selector (`{ item }`, `{ variant }`, opsional dengan `locale`). Lihat [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md).
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — defaults to the configured `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Node transformers. Defaults to the base interpreter set.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Returns
+
+- **Type**: `Promise<Content>` — a promise resolving to the interpreted content of the loaded chunk.
+- **Description**: Resolves to `null` when the map emits no chunk for the requested locale nor for any of its fallbacks, mirroring how a missing qualified coordinate resolves.
+
+---
+
+## Contoh Penggunaan
+
+### Dengan peta loader yang dihasilkan
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionaryAsync } from "intlayer";
+import appLoaderMap from "../.intlayer/dynamic_dictionaries/app";
+
+const { title } = await getDictionaryAsync(appLoaderMap, "app", "fr");
+```
+
+### Dengan peta loader kustom
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const loaderMap = {
+  en: () => import("./banner.en.json").then((mod) => mod.default),
+  fr: () => import("./banner.fr.json").then((mod) => mod.default),
+};
+
+const banner = await getDictionaryAsync(loaderMap, "banner", "fr");
+```
+
+### Dengan selector pada qualified map
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const promoBanner = await getDictionaryAsync(bannerLoaderMap, "banner", {
+  variant: "black-friday",
+  locale: "fr",
+});
+```
+
+---
+
+## Catatan Perilaku
+
+### Caching and deduplication
+
+The cache stores the **promise** of each `key + locale + selector` triple, so concurrent calls for the same chunk await a single load. A rejected load is removed from the cache, so a failing chunk is retried on the next call instead of replaying the same failure forever.
+
+### Locale fallback
+
+Peta loader biasa berjalan sepanjang rantai fallback yang sama seperti mode sinkron: lokal yang diminta terlebih dahulu, kemudian fallback-nya, kemudian `null` jika tidak ada yang memancarkan chunk.
+
+---
+
+## Fungsi Terkait
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getIntlayerAsync.md): Fungsi yang dipanggil aplikasi; plugin build menulisnya kembali menjadi `getDictionaryAsync`.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/intlayer/getDictionary.md): Rekan sinkron yang menerima kamus lengkap.
+- [Dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md): Koleksi dan varian, serta peta loader yang mereka hasilkan.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionaryAsync<
+  const T extends Dictionary,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionaryLoaders: PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap,
+  key: string,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    T["content"],
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 Fungsi `getEnumeration` mengambil konten yang sesuai dengan kuantitas tertentu berdasarkan kondisi yang telah ditentukan dalam objek enumerasi. Kondisi-kondisi tersebut didefinisikan sebagai kunci, dan prioritasnya ditentukan oleh urutan mereka dalam objek.
 
+Untuk detail lebih lanjut tentang cara mendeklarasikan enumerasi, lihat [dokumentasi Enumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dictionary/enumeration.md).
+
 ## Parameter
 
 - `enumerationContent: QuantityContent<Content>`

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>
+  >
+>;
+```