@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/id/configuration.md

@@ -736,8 +736,6 @@ Mendefinisikan pengaturan yang terkait dengan editor terintegrasi, termasuk port
 | `liveSyncPort`               | Port server sinkronisasi langsung (live sync).                                                                                                                                           | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                                                     |
 | `liveSyncURL`                | URL server sinkronisasi langsung (live sync).                                                                                                                                            | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | Menunjuk ke localhost secara default; dapat diubah untuk server sinkronisasi langsung jarak jauh.                                                                                                                                                                   |
 
----
-
 ### Konfigurasi Analitik (Analytics)
 
 Menentukan pengaturan terkait analitik Intlayer: mengumpulkan konten apa yang sebenarnya ditampilkan kepada pengguna (tampilan halaman, eksposur konten) dan mendukung pengujian A/B pada konten.
@@ -989,6 +987,13 @@ Pengaturan yang terkait dengan path internal dan hasil output dari Intlayer. Pen
 
 Opsi yang mengontrol operasi kamus, termasuk perilaku pengisian otomatis dan pembuatan konten.
 
+Konfigurasi kamus ini melayani dua tujuan utama:
+
+1. **Nilai Default**: Tentukan nilai default saat membuat file deklarasi konten
+2. **Perilaku Fallback**: Berikan nilai fallback ketika field tertentu tidak didefinisikan, memungkinkan Anda menentukan perilaku operasi kamus secara global
+
+Untuk informasi lebih lanjut tentang file deklarasi konten dan bagaimana nilai konfigurasi diterapkan, lihat [Dokumentasi File Konten](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dictionary/content_file.md).
+
 | Bidang                      | Deskripsi                                                                                                                                                                  | Tipe                                                                                                            | Default         | Contoh                                                                                      | Catatan                                                                                                                                                                                                                                                                                                                                                                                                |
 | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `fill`                      | Mengontrol pembuatan file output pengisian otomatis (terjemahan AI).                                                                                                       | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`          | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: path default (file yang sama dengan sumber).<br/>• `false`: dinonaktifkan.<br/>• Pola string/fungsi memungkinkan pembuatan per-locale.<br/>• Objek per-locale: setiap locale memiliki pola sendiri; `false` mengecualikan locale.<br/>• Menyertakan `{{locale}}` memungkinkan pembuatan per-locale.<br/>• Pengaturan `fill` tingkat kamus selalu didahulukan daripada pengaturan global ini. |
@@ -1028,8 +1033,6 @@ Pengaturan untuk menyesuaikan output log Intlayer.
 | `mode`   | Menentukan mode logger.        | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`        | • `'verbose'`: Mencatat lebih banyak informasi untuk penelusuran kesalahan (debugging).<br/>• `'disabled'`: Menonaktifkan logging sepenuhnya. |
 | `prefix` | Prefiks untuk semua pesan log. | `string`                                                       | `'[intlayer] '` | `'[mój prefiks] '` |                                                                                                                                               |
 
----
-
 ### Konfigurasi AI (AI)
 
 Pengaturan untuk mengelola fitur-fitur AI dalam Intlayer, termasuk penyedia, model, dan kunci API.
@@ -1069,8 +1072,6 @@ Intlayer mendukung berbagai penyedia AI untuk memastikan fleksibilitas maksimal.
 | `baseURL`            | URL dasar untuk AI API.                                                                                                                         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Tidak ada   | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Dapat merujuk ke endpoint AI API lokal atau kustom.                                                                                                                                   |
 | `dataSerialization`  | Format serialisasi data untuk fitur AI.                                                                                                         | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined` | `'toon'`                                                      | • `'json'`: default, andal; menggunakan lebih banyak token.<br/>• `'toon'`: lebih sedikit token, kurang stabil.<br/>• Meneruskan parameter tambahan ke model (upaya penalaran, dll.). |
 
----
-
 ### Konfigurasi Build (Build)
 
 Pengaturan yang mengontrol bagaimana Intlayer mengoptimalkan dan mengompilasi internasionalisasi aplikasi Anda.
@@ -1108,8 +1109,6 @@ Mengontrol pengaturan kompiler Intlayer yang mengumpulkan kamus langsung dari ko
 | `noMetadata`          | Jika `true`, kompiler menghapus metadata kamus (key, content wrapper) dari output.                                                                                                                                                                                                                                 | `boolean`                                                                                                       | `false`     | `false` → `{"key":"my-key","content":{"key":"value"}}` <br/> `true` → `{"key":"value"}`                                                                  | • Berguna untuk output i18next per-locale atau ICU MessageFormat JSON.<br/>• Berfungsi baik dengan plugin `loadJSON`.                                                                                            |
 | `dictionaryKeyPrefix` | Prefix kunci kamus                                                                                                                                                                                                                                                                                                 | `string`                                                                                                        | `''`        |                                                                                                                                                          | Menambahkan prefix opsional ke kunci kamus yang diekstrak                                                                                                                                                        |
 
----
-
 ### Skema Kustom (Custom Schemas)
 
 | Bidang    | Deskripsi                                                                     | Tipe                        |

package/docs/id/custom_domains.md

@@ -138,6 +138,38 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 URL absolut ini siap digunakan dalam tag `<link rel="alternate" hreflang="...">` untuk SEO.
 
+## Inferensi Tipe
+
+`routing.domains` diserialisasi ke dalam augmentasi modul yang dihasilkan, sehingga
+`getLocalizedUrl` dan `getLocalizedPath` mempersempit jenis pengembalian mereka ke URL yang tepat
+yang diselesaikan oleh locale yang dirutekan domain — termasuk penekanan prefiks.
+
+```ts
+// routing: { mode: 'prefix-no-default', domains: { en: 'intlayer.org', zh: 'intlayer.zh' } }
+
+getLocalizedUrl("/about", "zh");
+//     ^? "https://intlayer.zh/about" | "/about"
+
+getLocalizedPath("/about", "zh");
+//     ^? "/about"   (tidak pernah merupakan origin, dan tidak ada prefiks /zh/)
+```
+
+Jenis URL adalah **union** dari dua nilai yang dapat dikembalikan oleh fungsi: URL
+absolut di domain locale, dan yang relatif dikembalikan ketika
+halaman yang sedang dirender sudah berada di domain tersebut. `getLocalizedPath` tidak memiliki
+ambiguitas seperti itu - tidak pernah memancarkan origin - jadi tetap menjadi literal tunggal.
+
+Locale yang berbagi domain menyimpan prefiks normal mereka dalam tipe juga:
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> Regenerasi tipe (`npx intlayer build`, atau menjalankan dev server apa pun) setelah
+> mengubah `routing.domains` - penyempitan berasal dari
+> `__RoutingRegistry` yang dihasilkan, bukan dari file konfigurasi itu sendiri.
+
 ## Perilaku Proksi
 
 ### Next.js
@@ -170,6 +202,8 @@ GET intlayer.zh/about
 
 Plugin Vite `intlayerProxy` menerapkan logika yang sama selama pengembangan:
 
+> Sejak Intlayer v9, `intlayerProxy()` digabungkan langsung ke dalam plugin `intlayer()` dan diaktifkan secara default melalui opsi `routing.enableProxy` (`true` secara default). Mendaftarkannya secara terpisah seperti yang ditunjukkan di bawah ini sekarang bersifat opsional — ini dipertahankan untuk kompatibilitas mundur dan untuk setup yang perlu mengontrol urutan plugin. Atur `routing.enableProxy: false` untuk memilih untuk tidak menggunakan. Lihat [catatan rilis v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/id/custom_url_rewrites.md

@@ -248,7 +248,7 @@ Untuk memastikan bilah alamat browser selalu mencerminkan URL terlokalisasi yang
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -263,7 +263,7 @@ Untuk memastikan bilah alamat browser selalu mencerminkan URL terlokalisasi yang
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -279,7 +279,7 @@ Untuk memastikan bilah alamat browser selalu mencerminkan URL terlokalisasi yang
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -291,7 +291,7 @@ Untuk memastikan bilah alamat browser selalu mencerminkan URL terlokalisasi yang
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -303,7 +303,7 @@ Untuk memastikan bilah alamat browser selalu mencerminkan URL terlokalisasi yang
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -340,6 +340,8 @@ export function middleware(request: NextRequest) {
 
 Untuk SolidJS, Vue, dan Svelte, plugin Vite `intlayerProxy` mengelola rewrite selama pengembangan.
 
+> Sejak Intlayer v9, `intlayerProxy()` digabungkan langsung ke dalam plugin `intlayer()` dan diaktifkan secara default melalui opsi `routing.enableProxy` (`true` secara default). Mendaftarkannya secara terpisah seperti yang ditunjukkan di bawah ini sekarang bersifat opsional — ini disimpan untuk kompatibilitas backward dan untuk setup yang perlu mengontrol urutan plugin. Atur `routing.enableProxy: false` untuk opt out. Lihat [catatan rilis v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/id/dictionary/content_file.md

@@ -885,35 +885,6 @@ content:
     subtitle: Build amazing applications with ease
 ```
 
-Anda juga dapat membuat file konten dalam format JSON:
-
-```json
-{
-  "key": "welcome-page",
-  "title": "Konten Halaman Selamat Datang",
-  "description": "Konten untuk halaman selamat datang utama",
-  "tags": ["halaman", "selamat datang"],
-  "content": {
-    "hero": {
-      "title": {
-        "nodeType": "translation",
-        "translation": {
-          "en": "Welcome to Our Platform",
-          "fr": "Bienvenue sur Notre Plateforme"
-        }
-      },
-      "subtitle": {
-        "nodeType": "translation",
-        "translation": {
-          "en": "Build amazing applications with ease",
-          "fr": "Construisez des applications incroyables avec facilité"
-        }
-      }
-    }
-  }
-}
-```
-
 ### File Konten Per-Locale
 
 Untuk kamus per-locale, tentukan properti `locale`:

package/docs/id/dictionary/file.md

@@ -29,174 +29,8 @@ Di Intlayer, fungsi `file` memungkinkan penyematan konten file eksternal ke dala
 
 ## Mengapa menggunakan `file` daripada `import`, `require`, atau `fs`?
 
-<Tabs group="framework">
-  <Tab label="React" value="react">
-
-To use embedded file content in a React component, import and use the `useIntlayer` hook from the `react-intlayer` package. This retrieves the content from the specified key and allows it to be displayed dynamically.
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const FileComponent: FC = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Next.js" value="nextjs">
-
 To use embedded file content in Next.js Client Components, retrieve it via the `useIntlayer` hook. Here's an example:
 
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-"use client";
-
-import type { FC } from "react";
-import { useIntlayer } from "next-intlayer";
-
-const FileComponent: FC = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Vue" value="vue">
-
-To use embedded file content in Vue components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```vue fileName="**/*.vue"
-<script setup lang="ts">
-import { useIntlayer } from "vue-intlayer";
-
-const { myFile } = useIntlayer("my_key");
-</script>
-
-<template>
-  <div>
-    <pre>{{ myFile }}</pre>
-  </div>
-</template>
-```
-
-  </Tab>
-  <Tab label="Svelte" value="svelte">
-
-To use embedded file content in Svelte components, retrieve it via the `useIntlayer` hook. The store is accessed with `$`. Here's an example:
-
-```svelte fileName="**/*.svelte"
-<script lang="ts">
-import { useIntlayer } from "svelte-intlayer";
-
-const content = useIntlayer("my_key");
-</script>
-
-<div>
-  <pre>{$content.myFile}</pre>
-</div>
-```
-
-  </Tab>
-  <Tab label="Preact" value="preact">
-
-To use embedded file content in Preact components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "preact";
-import { useIntlayer } from "preact-intlayer";
-
-const FileComponent: FC = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Solid" value="solid">
-
-To use embedded file content in SolidJS components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { Component } from "solid-js";
-import { useIntlayer } from "solid-intlayer";
-
-const FileComponent: Component = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Angular" value="angular">
-
-To use embedded file content in Angular components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="app.component.ts" codeFormat="typescript"
-import { Component } from "@angular/core";
-import { useIntlayer } from "angular-intlayer";
-
-@Component({
-  selector: "app-file",
-  template: `
-    <div>
-      <pre>{{ content().myFile }}</pre>
-    </div>
-  `,
-})
-export class FileComponent {
-  content = useIntlayer("my_key");
-}
-```
-
-  </Tab>
-  <Tab label="Vanilla JS" value="vanilla">
-
-To use embedded file content with `vanilla-intlayer`, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="**/*.ts" codeFormat={["typescript", "esm"]}
-import { installIntlayer, useIntlayer } from "vanilla-intlayer";
-
-installIntlayer();
-
-const content = useIntlayer("my_key").onChange((newContent) => {
-  document.getElementById("file-content")!.textContent = newContent.myFile;
-});
-
-// Initial render
-document.getElementById("file-content")!.textContent = content.myFile;
-```
-
-  </Tab>
-</Tabs>
 ## Menyiapkan Konten File
 
 Untuk menyematkan konten file dalam proyek Intlayer Anda, gunakan fungsi `file` dalam modul konten. Berikut adalah contoh yang menunjukkan berbagai implementasi.

package/docs/id/dictionary/gender.md

@@ -27,220 +27,8 @@ author: aymericzip
 
 ## Cara Kerja Gender
 
-<Tabs group="framework">
-  <Tab label="React" value="react">
-
-To utilize gender-based content within a React component, import and use the `useIntlayer` hook from the `react-intlayer` package. This hook fetches the content for the specified key and allows you to pass in a gender to select the appropriate output.
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const GenderComponent: FC = () => {
-  const { myGender } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <p>
-        {
-          /* Output: my content for male users */
-          myGender("male")
-        }
-      </p>
-      <p>
-        {
-          /* Output: my content for female users */
-          myGender("female")
-        }
-      </p>
-      <p>
-        {
-          /* Output: my content for male users */
-          myGender("m")
-        }
-      </p>
-      <p>
-        {
-          /* Output: my content for female users */
-          myGender("f")
-        }
-      </p>
-      <p>
-        {
-          /* Output: my content when gender is not specified */
-          myGender("")
-        }
-      </p>
-      <p>
-        {
-          /* Output: my content when gender is not specified */
-          myGender(undefined)
-        }
-      </p>
-    </div>
-  );
-};
-
-export default GenderComponent;
-```
-
-  </Tab>
-  <Tab label="Next.js" value="nextjs">
-
 To utilize gender-based content in Next.js Client Components, retrieve it via the `useIntlayer` hook. Here's an example:
 
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-"use client";
-
-import type { FC } from "react";
-import { useIntlayer } from "next-intlayer";
-
-const GenderComponent: FC = () => {
-  const { myGender } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <p>{myGender("male")}</p>
-      <p>{myGender("female")}</p>
-    </div>
-  );
-};
-
-export default GenderComponent;
-```
-
-  </Tab>
-  <Tab label="Vue" value="vue">
-
-To utilize gender-based content in Vue components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```vue fileName="**/*.vue"
-<script setup lang="ts">
-import { useIntlayer } from "vue-intlayer";
-
-const { myGender } = useIntlayer("my_key");
-</script>
-
-<template>
-  <div>
-    <p>{{ myGender("male") }}</p>
-    <p>{{ myGender("female") }}</p>
-  </div>
-</template>
-```
-
-  </Tab>
-  <Tab label="Svelte" value="svelte">
-
-To utilize gender-based content in Svelte components, retrieve it via the `useIntlayer` hook. The store is accessed with `$`. Here's an example:
-
-```svelte fileName="**/*.svelte"
-<script lang="ts">
-import { useIntlayer } from "svelte-intlayer";
-
-const content = useIntlayer("my_key");
-</script>
-
-<div>
-  <p>{$content.myGender("male")}</p>
-  <p>{$content.myGender("female")}</p>
-</div>
-```
-
-  </Tab>
-  <Tab label="Preact" value="preact">
-
-To utilize gender-based content in Preact components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "preact";
-import { useIntlayer } from "preact-intlayer";
-
-const GenderComponent: FC = () => {
-  const { myGender } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <p>{myGender("male")}</p>
-      <p>{myGender("female")}</p>
-    </div>
-  );
-};
-
-export default GenderComponent;
-```
-
-  </Tab>
-  <Tab label="Solid" value="solid">
-
-To utilize gender-based content in SolidJS components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { Component } from "solid-js";
-import { useIntlayer } from "solid-intlayer";
-
-const GenderComponent: Component = () => {
-  const { myGender } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <p>{myGender("male")}</p>
-      <p>{myGender("female")}</p>
-    </div>
-  );
-};
-
-export default GenderComponent;
-```
-
-  </Tab>
-  <Tab label="Angular" value="angular">
-
-To utilize gender-based content in Angular components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="app.component.ts" codeFormat="typescript"
-import { Component } from "@angular/core";
-import { useIntlayer } from "angular-intlayer";
-
-@Component({
-  selector: "app-gender",
-  template: `
-    <div>
-      <p>{{ content().myGender("male") }}</p>
-      <p>{{ content().myGender("female") }}</p>
-    </div>
-  `,
-})
-export class GenderComponent {
-  content = useIntlayer("my_key");
-}
-```
-
-  </Tab>
-  <Tab label="Vanilla JS" value="vanilla">
-
-To utilize gender-based content with `vanilla-intlayer`, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="**/*.ts" codeFormat={["typescript", "esm"]}
-import { installIntlayer, useIntlayer } from "vanilla-intlayer";
-
-installIntlayer();
-
-const content = useIntlayer("my_key").onChange((newContent) => {
-  document.getElementById("gender-male")!.textContent =
-    newContent.myGender("male");
-  document.getElementById("gender-female")!.textContent =
-    newContent.myGender("female");
-});
-
-// Initial render
-document.getElementById("gender-male")!.textContent = content.myGender("male");
-document.getElementById("gender-female")!.textContent =
-  content.myGender("female");
-```
-
-  </Tab>
-</Tabs>
 ## Menyiapkan Konten Berdasarkan Gender
 
 Untuk menyiapkan konten berdasarkan gender dalam proyek Intlayer Anda, buat modul konten yang mencakup definisi spesifik gender Anda. Berikut adalah contoh dalam berbagai format.