@intlayer/docs 9.5.4 → 9.5.6

package/docs/id/packages/astro-intlayer/exports.md

@@ -1,12 +1,12 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-09-19
 title: Dokumentasi Paket astro-intlayer
-description: Integrasi Astro untuk Intlayer, menyediakan pengaturan untuk routing berbasis locale dan manajemen kamus.
+description: Integrasi Astro untuk Intlayer, menyediakan konfigurasi perutean berbasis lokal, middleware, hooks, store klien, dan manajemen kamus.
 keywords:
   - astro-intlayer
   - astro
-  - internationalization
+  - internasionalisasi
   - i18n
 slugs:
   - doc
@@ -14,15 +14,18 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Menambahkan dokumentasi hook useIntlayer, useDictionary, useLocale, middleware, dan formatters"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "Unified documentation for all exports"
+    changes: "Dokumentasi terpadu untuk semua ekspor"
 author: aymericzip
 ---
 
 # Paket astro-intlayer
 
-Paket `astro-intlayer` menyediakan alat yang diperlukan untuk mengintegrasikan Intlayer ke dalam aplikasi Astro. Paket ini mengonfigurasi routing berbasis locale dan manajemen kamus.
+Paket `astro-intlayer` menyediakan alat yang diperlukan untuk mengintegrasikan Intlayer ke dalam aplikasi Astro. Paket ini mengonfigurasi perutean berbasis lokal, manajemen kamus, penulisan ulang halaman saat proses build, middleware permintaan, dan hooks untuk mengakses konten multibahasa di komponen `.astro` yang dirender di server maupun skrip sisi klien.
 
 ## Instalasi
 
@@ -34,22 +37,171 @@ npm install astro-intlayer
 
 ### Integrasi
 
-Paket `astro-intlayer` menyediakan integrasi Astro untuk menyiapkan Intlayer dalam proyek Anda.
+Paket `astro-intlayer` menyediakan integrasi Astro yang mengonfigurasi Intlayer dalam proyek Anda.
 
 Impor:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-atau menambahkannya ke `astro.config.mjs`:
+atau impor default di `astro.config.mjs`:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| Fungsi     | Deskripsi                                                   |
-| ---------- | ----------------------------------------------------------- |
-| `intlayer` | Integrasi Astro yang menyiapkan Intlayer dalam proyek Anda. |
+| Fungsi     | Deskripsi                                                                                                                                                                                                             | Dokumentasi Terkait                                                                                           |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Integrasi Astro yang menyiapkan kamus, mengonfigurasi plugin Vite (alias, proksi perutean, pemangkasan build), mendaftarkan middleware permintaan secara otomatis, dan menghasilkan halaman prerender pada URL lokal. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/intlayer.md) |
+
+### Hooks (Server & Klien)
+
+Impor:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| Hook            | Deskripsi                                                                                                                                                                                | Dokumentasi Terkait                                                                                                     |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Memilih satu kamus berdasarkan kuncinya dan mengembalikan konten yang dilokalisasi. Di frontmatter `.astro`, membaca lokal dari `Astro.locals`. Di `<script>` klien, membaca dari store. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | Mentransformasikan objek kamus dan mengembalikan konten untuk lokal yang ditentukan. Berfungsi di frontmatter dan skrip klien.                                                           | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | Mengembalikan lokal saat ini, lokal default, lokal yang tersedia, dan fungsi untuk memperbarui lokal.                                                                                    | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useLocale.md)         |
+
+### Middleware (astro-intlayer/middleware)
+
+Impor:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| Ekspor      | Tipe                | Deskripsi                                                                                                                                                              | Dokumentasi Terkait                                                                                             |
+| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | Middleware Astro yang mendeteksi lokal permintaan dan melampirkan `Astro.locals.intlayer`. Didaftarkan otomatis oleh `intlayer()` atau diimpor manual untuk komposisi. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/onRequest.md) |
+
+### Utilitas
+
+Impor:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| Fungsi              | Deskripsi                                                                                                                 | Dokumentasi Terkait |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------- |
+| `getIntlayerLocals` | Fungsi pembantu untuk mengambil objek `IntlayerLocals` saat ini dari cakupan penyimpanan permintaan di luar Astro.locals. | -                   |
+
+### Utilitas Klien (astro-intlayer/client)
+
+Impor:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+Ketika diimpor di browser atau di dalam tag `<script>` klien, `astro-intlayer` secara otomatis memetakan ke `astro-intlayer/client` (didukung oleh `vanilla-intlayer`), menyediakan pengambil kamus sisi klien, pelanggan store, dan alat persistensi lokal.
+
+### Formatter (astro-intlayer/format)
+
+Impor:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| Hook              | Deskripsi                                                                                                    |
+| ----------------- | ------------------------------------------------------------------------------------------------------------ |
+| `useIntl`         | Mengembalikan instans Intl yang terikat pada lokal permintaan atau klien dengan kemampuan caching.           |
+| `useDate`         | Mengembalikan fungsi pemformatan tanggal yang terikat pada lokal saat ini (`Intl.DateTimeFormat`).           |
+| `useNumber`       | Mengembalikan fungsi pemformatan angka yang terikat pada lokal saat ini (`Intl.NumberFormat`).               |
+| `useCurrency`     | Mengembalikan fungsi pemformatan mata uang yang terikat pada lokal saat ini.                                 |
+| `usePercentage`   | Mengembalikan fungsi pemformatan persentase yang terikat pada lokal saat ini.                                |
+| `useRelativeTime` | Mengembalikan fungsi pemformatan waktu relatif yang terikat pada lokal saat ini (`Intl.RelativeTimeFormat`). |
+| `useList`         | Mengembalikan fungsi pemformatan daftar yang terikat pada lokal saat ini (`Intl.ListFormat`).                |
+| `useUnit`         | Mengembalikan fungsi pemformatan unit yang terikat pada lokal saat ini.                                      |
+| `useCompact`      | Mengembalikan fungsi pemformatan angka ringkas yang terikat pada lokal saat ini (misalnya `1.5K`).           |
+
+### Utilitas HTML (astro-intlayer/html)
+
+Impor:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| Ekspor            | Tipe       | Deskripsi                                                             |
+| ----------------- | ---------- | --------------------------------------------------------------------- |
+| `renderHTML`      | `Function` | Fungsi utilitas mandiri untuk merender node HTML.                     |
+| `useHTML`         | `Hook`     | Hook untuk mendapatkan konteks dan konfigurasi penyedia HTML.         |
+| `useHTMLRenderer` | `Hook`     | Hook untuk mendapatkan fungsi perender HTML yang telah dikonfigurasi. |
+
+### Utilitas Markdown (astro-intlayer/markdown)
+
+Impor:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| Ekspor                | Tipe       | Deskripsi                                                                 |
+| --------------------- | ---------- | ------------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Mengompilasi string markdown ke dalam representasi terstruktur.           |
+| `renderMarkdown`      | `Function` | Merender konten markdown ke node keluaran.                                |
+| `parseMarkdown`       | `Function` | Mengurai konten markdown mentah ke dalam AST.                             |
+| `useMarkdown`         | `Hook`     | Hook untuk mendapatkan konteks penyedia markdown.                         |
+| `useMarkdownRenderer` | `Hook`     | Hook untuk mendapatkan fungsi perender Markdown yang telah dikonfigurasi. |
+
+### Tipe
+
+Impor:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| Tipe              | Deskripsi                                                                                                          |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `IntlayerLocals`  | Objek yang dilampirkan pada `Astro.locals.intlayer` yang berisi `locale`, `defaultLocale`, dan `availableLocales`. |
+| `UseLocaleProps`  | Properti konfigurasi opsional yang diterima oleh `useLocale()`.                                                    |
+| `UseLocaleResult` | Tipe pengembalian dari `useLocale()`, menyediakan properti lokal dan metode pembaruan.                             |

package/docs/id/packages/astro-intlayer/intlayer.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: Dokumentasi Integrasi intlayer | astro-intlayer
+description: Pelajari cara mengonfigurasi dan menggunakan integrasi Astro intlayer di astro.config.mjs.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - integrasi
+  - i18n
+  - Internasionalisasi
+  - Dokumentasi
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Memperbarui dokumentasi integrasi dengan detail middleware dan hooks"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "Inisialisasi dokumen"
+author: aymericzip
+---
+
+# Dokumentasi Integrasi Astro intlayer
+
+Integrasi `intlayer` untuk Astro mengonfigurasi proyek Anda untuk internasionalisasi multibahasa (i18n). Integrasi ini menangani persiapan kamus saat build, injeksi plugin Vite, pendaftaran middleware permintaan otomatis, serta pembuatan halaman prerender yang dilokalisasi.
+
+## Penggunaan
+
+Tambahkan `intlayer()` ke `astro.config.mjs` Anda:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Codemod Astro CLI (`astro add astro-intlayer`) juga menghasilkan impor default yang didukung:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## Deskripsi
+
+Integrasi terhubung ke dalam siklus proses build dan runtime Astro:
+
+1. **Konfigurasi Setup (`astro:config:setup`)**:
+   - **Persiapan Kamus**: Menyiapkan kamus Intlayer dan tipe yang dihasilkan sebelum proses build berjalan.
+   - **Plugin Vite**: Menyuntikkan plugin untuk alias Vite (memungkinkan impor kamus yang lancar), proksi perutean lokal, dan pemangkasan build.
+   - **Pendaftaran Middleware**: Secara otomatis menyuntikkan `astro-intlayer/middleware` ke dalam rantai middleware proyek Anda, mengisi `Astro.locals.intlayer` pada setiap permintaan yang masuk.
+2. **Build Selesai (`astro:build:done`)**:
+   - **Penulisan Ulang Halaman**: Memeriksa aturan penulisan ulang URL lokal dan menghasilkan halaman HTML yang diprerender di jalur lokal yang sesuai.
+
+## Apa yang Disediakan Secara Langsung
+
+Setelah dikonfigurasi, aplikasi Astro Anda dapat langsung menggunakan:
+
+- Hook `useIntlayer`, `useDictionary`, dan `useLocale` di dalam frontmatter komponen `.astro`.
+- Objek `Astro.locals.intlayer` di endpoint dan halaman Astro.
+- Impor sisi klien dalam blok `<script>` yang mencerminkan API yang sama dengan pembaruan reaktif.
+- Formatter bawaan di bawah `astro-intlayer/format` (`useDate`, `useNumber`, `useCurrency`, dll.).
+
+## Dokumentasi Terkait
+
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useLocale.md)
+- [Middleware `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/onRequest.md)

package/docs/id/packages/astro-intlayer/onRequest.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentasi Middleware onRequest | astro-intlayer
+description: Pelajari cara menggunakan middleware onRequest di aplikasi Astro untuk menentukan lokal permintaan dan mengisi Astro.locals.intlayer.
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - Internasionalisasi
+  - Dokumentasi
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Inisialisasi dokumen"
+author: aymericzip
+---
+
+# Dokumentasi Middleware Astro onRequest
+
+Middleware `onRequest` dari `astro-intlayer/middleware` menentukan lokal dari setiap permintaan HTTP yang masuk dan mengisi `Astro.locals.intlayer`.
+
+Ketika Anda mendaftarkan integrasi `intlayer()` di `astro.config.mjs`, middleware ini disuntikkan secara otomatis. Anda hanya perlu mengimpornya secara langsung jika menyusun middleware Astro secara manual menggunakan `sequence(...)`.
+
+## Penggunaan
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // Akses lokal yang ditentukan dalam middleware kustom Anda
+  const { locale } = context.locals.intlayer;
+  console.log(`Menangani permintaan untuk lokal: ${locale}`);
+
+  return next();
+});
+```
+
+## Deskripsi
+
+Middleware melakukan operasi berikut:
+
+1. **Deteksi Lokal**:
+   - **URL**: Menganalisis awalan jalur URL atau parameter pencarian `?locale=` (kecuali jika `routing.mode` diatur ke `no-prefix`).
+   - **Cookie / Header**: Memeriksa cookie lokal yang disimpan atau nilai header khusus.
+   - **Accept-Language**: Menggunakan negosiasi bahasa preferensi browser jika tidak ada nilai sebelumnya.
+   - Untuk halaman yang diprerender (`context.isPrerendered`), lokal diekstraksi secara ketat dari URL untuk mencegah peringatan proses build Astro.
+2. **Pengisian Konteks**: Mengisi `Astro.locals.intlayer` dengan:
+   - `locale`: Lokal yang ditentukan.
+   - `defaultLocale`: Lokal fallback default.
+   - `availableLocales`: Array dari lokal yang dikonfigurasi.
+3. **Cakupan AsyncLocalStorage**: Membungkus pemrosesan permintaan hilir di dalam cakupan `AsyncLocalStorage`, memungkinkan `useIntlayer()`, `useDictionary()`, dan `useLocale()` mengakses status permintaan tanpa meneruskan argumen.
+
+## Tipe `IntlayerLocals`
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## Dokumentasi Terkait
+
+- [Integrasi `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,94 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentasi Hook useDictionary | astro-intlayer
+description: Pelajari cara menggunakan hook useDictionary dalam komponen dan skrip Astro untuk menyelesaikan objek kamus.
+keywords:
+  - useDictionary
+  - kamus
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - Internasionalisasi
+  - Dokumentasi
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Inisialisasi dokumen"
+author: aymericzip
+---
+
+# Dokumentasi Hook useDictionary
+
+Hook `useDictionary` menyelesaikan objek kamus yang diimpor atau didefinisikan secara inline dan mengembalikan kontennya untuk lokal saat ini dalam aplikasi Astro.
+
+Berbeda dengan `useIntlayer`, yang mengambil kamus berdasarkan kunci dari registri kamus global, `useDictionary` bekerja langsung dengan objek kamus.
+
+## Penggunaan
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+Anda juga dapat meneruskan kamus inline yang didefinisikan dengan `t()`:
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      id: "Hak cipta dilindungi undang-undang.",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## Parameter
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Objek kamus atau grup kamus yang memenuhi syarat.
+2. **`localeOrSelector`** (opsional): Lokal tertentu atau objek pemilih (`{ item }`, `{ variant }`, secara opsional dengan `locale`).
+
+## Deskripsi
+
+Hook ini melakukan tugas-tugas berikut:
+
+1. **Deteksi Lokal**: Di server, mendapatkan lokal dari `Astro.locals.intlayer`. Di browser, menggunakan lokal store sisi klien.
+2. **Pemrosesan Konten**: Menyelesaikan terjemahan (`t()`), enumerasi, kondisi, dan struktur bersarang sesuai dengan lokal yang ditentukan.
+3. **Pemilih**: Menerapkan pemilih item atau varian apa pun yang disediakan dalam argumen.
+
+## Dokumentasi Terkait
+
+- [Integrasi `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentasi Hook useIntlayer | astro-intlayer
+description: Pelajari cara menggunakan hook useIntlayer dalam komponen Astro dan skrip klien untuk mengakses konten yang dilokalisasi.
+keywords:
+  - useIntlayer
+  - kamus
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - Internasionalisasi
+  - Dokumentasi
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Inisialisasi dokumen"
+author: aymericzip
+---
+
+# Dokumentasi Hook useIntlayer
+
+Hook `useIntlayer` memungkinkan Anda mengambil konten kamus yang dilokalisasi berdasarkan kunci dalam aplikasi Astro.
+
+Hook ini dapat dipanggil dalam dua konteks berbeda menggunakan jalur impor yang sama:
+
+1. **Server / Frontmatter**: Di dalam file `.astro`, hook ini secara otomatis menentukan konten menggunakan lokal permintaan yang disimpan di `Astro.locals.intlayer`.
+2. **Browser / Skrip Klien `<script>`**: Di dalam skrip klien atau komponen kerangka kerja UI, hook ini menggunakan implementasi store sisi klien (`vanilla-intlayer`).
+
+## Penggunaan
+
+### Di Frontmatter Komponen Astro
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### Di Blok `<script>` Klien
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## Parameter
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: Kunci unik kamus (sebagaimana ditentukan dalam file deklarasi `.content.ts` Anda).
+2. **`localeOrSelector`** (opsional): Lokal tertentu atau objek pemilih (`{ item }`, `{ variant }`, secara opsional dengan `locale`). Jika disediakan, parameter ini akan menimpa lokal yang terdeteksi dari konteks permintaan atau store klien.
+
+## Deskripsi
+
+Hook ini melakukan tugas-tugas berikut:
+
+1. **Resolusi Lokal**:
+   - Di server, membaca lokal aktif dari `Astro.locals.intlayer` melalui cakupan `AsyncLocalStorage` yang diinisialisasi oleh `astro-intlayer/middleware`.
+   - Di browser, membaca lokal aktif dari penyimpanan atau store klien.
+2. **Pengambilan Kamus**: Menyuntikkan konten kamus yang cocok dengan kunci yang ditentukan.
+3. **Pemrosesan Terjemahan**: Menyelesaikan terjemahan (`t()`), enumerasi, kondisi, dan markdown menjadi konten yang siap dirender.
+
+## Dokumentasi Terkait
+
+- [Integrasi `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/intlayer.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useDictionary.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/astro-intlayer/useLocale.md)