@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/hi/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: इंटलेयर को सेल्फ-होस्ट करना
+description: एक ही कमांड से अपने स्वयं के इंफ्रास्ट्रक्चर पर एक पूर्ण इंटलेयर इंस्टेंस चलाएँ। इंटलेयर क्लाउड अकाउंट की कोई आवश्यकता नहीं है।
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# इंटलेयर को सेल्फ-होस्ट करना
+
+इंटलेयर पूरी तरह से आपके अपने इंफ्रास्ट्रक्चर पर चल सकता है - इसके लिए इंटलेयर क्लाउड खाते की आवश्यकता नहीं है। एक ही कमांड एक उत्पादन-तैयार स्टैक को बूट करता है:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+इंस्टॉलर एक `docker-compose.yml` और एक `.env` डाउनलोड करता है, आवश्यक सीक्रेट्स को स्वतः जेनरेट करता है, और `docker compose up -d` के साथ सभी कंटेनरों को शुरू करता है।
+
+## विषय-सूची
+
+<TOC/>
+
+---
+
+## आर्किटेक्चर
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+क्रोमियम (Puppeteer स्क्रीनशॉट जनरेशन के लिए उपयोग किया जाता है) बैकएंड इमेज के अंदर बंडल किया गया है - किसी अलग कंटेनर की आवश्यकता नहीं है।
+
+---
+
+## पूर्व-आवश्यकताएँ
+
+- **डॉकर** ≥ 24 और **डॉकर कंपोज** ≥ v2। यदि इनमें से कोई भी गायब है, तो इंस्टॉलर इंस्टॉल लिंक प्रिंट करता है और बाहर निकल जाता है।
+- होस्ट पर पोर्ट `3000`, `3100`, `8025`, `9000`, और `9001` उपलब्ध होने चाहिए।
+- एक Linux या macOS होस्ट (या Windows पर WSL2)।
+
+---
+
+## त्वरित शुरुआत
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+इंस्टॉलर क्या करता है:
+
+1.  जांचता है कि `docker` और `docker compose` मौजूद हैं या नहीं।
+2.  `docker-compose.yml` और `.env.example` को `./intlayer/` में डाउनलोड करता है।
+3.  यदि कोई `.env` मौजूद नहीं है, तो उदाहरण कॉपी करता है और `openssl rand` के माध्यम से `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID`, और `S3_SECRET_ACCESS_KEY` के लिए रैंडम सीक्रेट्स जेनरेट करता है।
+4.  `docker compose pull` + `docker compose up -d` चलाता है।
+5.  URL प्रिंट करता है: डैशबोर्ड `:3000`, API `:3100`, ईमेल UI `:8025`, MinIO कंसोल `:9001`।
+
+स्टैक के चालू होने के बाद, **http://localhost:3000** खोलें और अपना पहला अकाउंट बनाएँ।
+
+---
+
+## सेवाएँ
+
+| सर्विस      | इमेज                                 | होस्ट पोर्ट(s)                 | उद्देश्य                                            |
+| ----------- | ------------------------------------ | ------------------------------ | --------------------------------------------------- |
+| **app**     | `apps/app/Dockerfile` से निर्मित     | `3000`                         | TanStack Start डैशबोर्ड (CMS UI)                    |
+| **backend** | `apps/backend/Dockerfile` से निर्मित | `3100`                         | Fastify REST API (`/health` एंडपॉइंट)               |
+| **mongo**   | `mongo:7`                            | आंतरिक                         | सिंगल-नोड रेप्लिका सेट (`rs0`)                      |
+| **redis**   | `redis:7-alpine`                     | आंतरिक                         | जॉब क्यू (BullMQ) और कैशिंग (ioredis)               |
+| **minio**   | `minio/minio`                        | `9000` (S3), `9001` (कंसोल)    | अवतार और स्क्रीनशॉट के लिए S3-संगत ऑब्जेक्ट स्टोरेज |
+| **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (वेब UI) | लोकल ट्रांजैक्शनल ईमेल सिंक                         |
+
+आंतरिक पोर्ट (mongo, redis) डिफ़ॉल्ट रूप से होस्ट पर एक्सपोज़ नहीं किए जाते हैं।
+
+> MinIO पोर्ट `9000` ब्राउज़र द्वारा पहुँच योग्य होना चाहिए क्योंकि अपलोड किए गए एसेट (अवतार, स्क्रीनशॉट) सीधे `S3_PUBLIC_URL=http://localhost:9000/intlayer` से लोड होते हैं।
+
+---
+
+## एनवायरनमेंट वेरिएबल
+
+इंस्टॉलर एक तैयार-से-उपयोग `.env` जेनरेट करता है। नीचे दी गई तालिका प्रत्येक वेरिएबल का वर्णन करती है।
+
+### आवश्यक (स्वतः जेनरेटेड या प्रॉम्प्टेड)
+
+| वेरिएबल                | उदाहरण                                          | विवरण                                              |
+| ---------------------- | ----------------------------------------------- | -------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | रनटाइम एनवायरनमेंट                                 |
+| `PORT`                 | `3100`                                          | बैकएंड लिसनिंग पोर्ट                               |
+| `BACKEND_URL`          | `http://localhost:3100`                         | बैकएंड API का पब्लिक URL                           |
+| `APP_URL`              | `http://localhost:3000`                         | डैशबोर्ड का पब्लिक URL                             |
+| `DOMAIN`               | `localhost`                                     | कुकी डोमेन                                         |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | पूर्ण MongoDB कनेक्शन URI                          |
+| `REDIS_URL`            | `redis://redis:6379`                            | Redis कनेक्शन URL                                  |
+| `BETTER_AUTH_SECRET`   | _(जेनरेटेड)_                                    | सेशन साइनिंग के लिए 32-बाइट सीक्रेट                |
+| `MAIL_PROVIDER`        | `smtp`                                          | मेल ट्रांसपोर्ट: `smtp` या `resend`                |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | SMTP होस्टनेम (मेलपिट कंटेनर नाम)                  |
+| `MAIL_SMTP_PORT`       | `1025`                                          | SMTP पोर्ट                                         |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | प्रेषक पता                                         |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3-संगत एंडपॉइंट                                   |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | ब्राउज़र एसेट लोडिंग के लिए पब्लिक URL             |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | बकेट नाम                                           |
+| `S3_ACCESS_KEY_ID`     | _(जेनरेटेड)_                                    | MinIO एक्सेस की                                    |
+| `S3_SECRET_ACCESS_KEY` | _(जेनरेटेड)_                                    | MinIO सीक्रेट की                                   |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | बिल्ड टाइम पर डैशबोर्ड में बेक किया गया बैकएंड URL |
+| `VITE_DOMAIN`          | `localhost`                                     | बिल्ड टाइम पर डैशबोर्ड में बेक किया गया डोमेन      |
+
+### वैकल्पिक (अनुपस्थिति में फीचर धीरे-धीरे खराब हो जाते हैं)
+
+| वेरिएबल                                                  | फीचर                                                                          |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | AI-सहायता प्राप्त अनुवाद और कंटेंट ऑडिट                                       |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | बिलिंग और सब्सक्रिप्शन प्रबंधन                                                |
+| `RESEND_API_KEY`                                         | रीसेंड के माध्यम से ट्रांजैक्शनल ईमेल (सेट होने पर मेलपिट को ओवरराइड करता है) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | GitHub OAuth लॉगिन                                                            |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Google OAuth लॉगिन                                                            |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | GitLab OAuth लॉगिन                                                            |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Microsoft OAuth लॉगिन                                                         |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth लॉगिन                                                          |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth लॉगिन                                                         |
+
+---
+
+## अपने इंटलेयर प्रोजेक्ट को कनेक्ट करना
+
+एक बार जब स्टैक चल रहा हो, तो अपने प्रोजेक्ट को `intlayer.org` के बजाय सेल्फ-होस्टेड बैकएंड और डैशबोर्ड पर पॉइंट करें।
+
+### प्रोजेक्ट कॉन्फ़िगरेशन
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * सेल्फ-होस्टेड CMS डैशबोर्ड का URL।
+     * डिफ़ॉल्ट: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // उदाहरण के लिए http://localhost:3000
+
+    /**
+     * सेल्फ-होस्टेड बैकएंड API का URL।
+     * डिफ़ॉल्ट: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // उदाहरण के लिए http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+अपने प्रोजेक्ट के `.env` में एनवायरनमेंट वेरिएबल सेट करें:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+अपने सेल्फ-होस्टेड डैशबोर्ड में `http://localhost:3000/projects` पर **प्रोजेक्ट्स → एक्सेस कीज़** के अंतर्गत एक्सेस क्रेडेंशियल बनाएँ।
+
+### `@intlayer/api` SDK
+
+प्रोग्रामेटिक रूप से `@intlayer/api` SDK का उपयोग करते समय, `backendURL` को स्पष्ट रूप से पास करें:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## अपग्रेड करना
+
+मौजूदा डिप्लॉयमेंट पर इंस्टॉलर को फिर से चलाने से रोलिंग अपग्रेड होता है:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+यह नवीनतम इमेज को खींचता है और `docker compose pull && docker compose up -d` के साथ कंटेनरों को रीस्टार्ट करता है। मौजूदा वॉल्यूम (`mongo-data`, `redis-data`, `minio-data`) संरक्षित रहते हैं - कोई डेटा हानि नहीं होती है।
+
+`./intlayer/` डायरेक्टरी के अंदर से मैन्युअल रूप से अपग्रेड करने के लिए:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## बैकअप और रीस्टोर
+
+सभी स्थायी डेटा तीन नामित डॉकर वॉल्यूम में रहते हैं।
+
+### बैकअप
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### रीस्टोर
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# redis-data और minio-data के लिए दोहराएँ
+```
+
+---
+
+## रिवर्स प्रॉक्सी (Nginx / Caddy) का उपयोग करना
+
+प्रोडक्शन डिप्लॉयमेंट के लिए, ऐप और बैकएंड कंटेनरों को सीधे एक्सपोज़ करने के बजाय उनके सामने एक रिवर्स प्रॉक्सी रखें।
+
+### Nginx उदाहरण
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+अपने पब्लिक डोमेन से मेल खाने के लिए निम्नलिखित `.env` वेरिएबल को अपडेट करें:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> `VITE_*` वेरिएबल बिल्ड टाइम पर डैशबोर्ड इमेज में बेक किए जाते हैं। यदि आप इमेज बनने के बाद उन्हें बदलते हैं, तो आपको `app` इमेज (`docker compose build app`) को फिर से बनाना होगा या रनटाइम कॉन्फ़िग इंजेक्शन का उपयोग करना होगा।
+
+---
+
+## समस्या निवारण
+
+### पहली शुरुआत में बैकएंड क्रैश-लूप करता है
+
+बैकएंड शुरू होने से पहले MongoDB और Redis स्वस्थ होने चाहिए। कंपोज़ फ़ाइल `condition: service_healthy` के साथ `depends_on` का उपयोग करती है। यदि आप बार-बार बैकएंड रीस्टार्ट देखते हैं, तो जांचें कि `mongo` और `redis` हेल्थचेक पास हो गए हैं या नहीं:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### डैशबोर्ड API तक नहीं पहुँच सकता
+
+सत्यापित करें कि `VITE_BACKEND_URL` उस URL से मेल खाता है जहाँ बैकएंड **ब्राउज़र** से (डॉकर नेटवर्क से नहीं) पहुँच योग्य है। यदि आपने बैकएंड पोर्ट बदला है या एक रिवर्स प्रॉक्सी जोड़ा है, तो डैशबोर्ड इमेज को फिर से बनाएँ:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### ईमेल नहीं भेजा जा रहा है
+
+डिफ़ॉल्ट रूप से, सभी आउटबाउंड ईमेल मेलपिट द्वारा कैप्चर किए जाते हैं। भेजे गए संदेशों को देखने के लिए `http://localhost:8025` खोलें। वास्तविक ईमेल भेजने के लिए, `.env` में `MAIL_PROVIDER=resend` और `RESEND_API_KEY=<your-key>` सेट करें, फिर बैकएंड को रीस्टार्ट करें:
+
+```sh
+docker compose restart backend
+```
+
+### MinIO बकेट गायब है
+
+यदि `minio-init` वन-शॉट सर्विस नहीं चली (या MinIO के तैयार होने से पहले चली), तो बकेट को मैन्युअल रूप से बनाएँ:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## उपयोगी लिंक
+
+- [इंटलेयर सीएमएस डॉक्यूमेंटेशन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md)
+- [कॉन्फ़िगरेशन संदर्भ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md)
+- [सीएमएस SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)

package/docs/id/autoFill.md

@@ -35,6 +35,26 @@ author: aymericzip
 
 **File deklarasi isi otomatis** dalam CI Anda adalah cara untuk mempercepat alur kerja pengembangan Anda.
 
+## Memahami perilaku
+
+Perintah `fill` mencakup dua mode:
+
+- **Complete**: Secara otomatis mengisi semua konten yang hilang untuk setiap locale dan mengedit file saat ini, atau file lain jika ditentukan. Artinya, mode complete akan melewatkan penerjemahan konten yang sudah ada, jika sudah diterjemahkan.
+- **Review**: Secara otomatis mengisi **semua** konten untuk setiap locale dan menghasilkan untuk file tertentu, atau file lain jika ditentukan.
+
+Perintah will akan memproses semua file deklarasi konten locale Anda. Artinya, tidak akan memproses konten jarak jauh dari CMS. CMS mencakup manajemen terjemahan sendiri.
+Jika Anda menggunakan plugin seperti `@intlayer/sync-json-plugin`, Intlayer akan mengubah file JSON menjadi file deklarasi konten locale. Artinya, file-file tersebut akan diproses oleh perintah `fill`.
+
+File yang baru dihasilkan mencakup instruksi `filled` sebagai metadata kamus. Instruksi ini akan digunakan oleh Intlayer untuk mengetahui apakah file telah diisi secara otomatis atau tidak, dan melewati file ini dari penerjemahan lagi jika ada.
+
+Intlayer juga akan mempertimbangkan instruksi berikut untuk pengisian otomatis:
+
+- Dari `.content.{ts|js|json}` Anda → instruksi `fill`
+- Dari file konfigurasi `.intlayer.config.ts` Anda → instruksi `dictionary.fill`
+- Akan diatur ke `true` secara default sebaliknya
+
+Untuk file deklarasi konten per-locale, instruksi `true` akan diganti dengan `./{{fileName}}.fill.content.json`. Ini karena file deklarasi konten per-locale tidak dapat menerima konten terlokalisasi tambahan. Jadi akan menghasilkan file baru untuk tidak menimpa file yang ada.
+
 ## Perilaku Default
 
 Secara default, `fill` diatur ke `true` secara global, yang berarti Intlayer akan secara otomatis mengisi semua file konten dan mengedit file itu sendiri. Perilaku ini dapat disesuaikan dengan beberapa cara:

package/docs/id/benchmark/solid.md

@@ -118,6 +118,28 @@ Kami membandingkan **empat strategi pemuatan**:
 - **Scoped static**: Menjaga kode tetap teratur (pemisahan logis) tanpa permintaan jaringan ekstra yang kompleks.
 - **Scoped dynamic**: Pendekatan terbaik untuk _code splitting_ dan performa. Meminimalkan memori dengan hanya memuat apa yang dibutuhkan oleh tampilan saat ini dan bahasa yang aktif.
 
+### Apa yang saya ukur:
+
+Saya menjalankan aplikasi multibahasa yang sama di browser nyata untuk setiap stack, kemudian mencatat apa yang benar-benar muncul di wire dan berapa lama waktu yang dibutuhkan. Ukuran dilaporkan **setelah kompresi web normal**, karena itu lebih dekat dengan apa yang orang-orang unduh daripada penghitungan sumber mentah.
+
+- **Ukuran library internationalization**: Setelah bundling, tree-shaking dan minification, ukuran library i18n adalah ukuran providers + hooks/primitives code dalam komponen kosong. Ini tidak termasuk loading file terjemahan. Ini menjawab betapa mahalnya library sebelum konten Anda memasuki gambar.
+
+- **JavaScript per halaman**: Untuk setiap rute benchmark, berapa banyak script yang browser tarik untuk kunjungan itu, rata-rata di seluruh halaman dalam suite (dan di seluruh locale di mana laporan menggabungkannya). Halaman berat adalah halaman lambat.
+
+- **Leakage dari locale lain**: Ini adalah konten halaman yang sama tetapi dalam bahasa lain yang akan dimuat secara tidak disengaja di halaman yang diaudit. Konten ini tidak perlu dan harus dihindari. (mis. konten halaman `/fr/about` dalam bundle halaman `/en/about`)
+
+- **Leakage dari rute lain**: Ide yang sama untuk **layar lain** dalam aplikasi: apakah salinannya berjalan bersama saat Anda hanya membuka satu halaman. (mis. konten halaman `/en/about` dalam bundle halaman `/en/contact`). Skor tinggi menunjukkan splitting yang lemah atau bundle yang terlalu luas.
+
+- **Ukuran bundle komponen rata-rata**: Piece UI umum diukur **satu per satu** alih-alih menyembunyikan dalam satu angka aplikasi raksasa. Ini menunjukkan apakah internationalization diam-diam mengobarkan komponen sehari-hari. Misalnya, jika komponen Anda di-rerender, itu akan memuat semua data itu dari memori. Melampirkan JSON besar ke komponen apa pun seperti menghubungkan toko besar data yang tidak digunakan yang akan memperlambat kinerja komponen Anda.
+
+- **Responsivitas pengalihan bahasa**: Saya membalik bahasa menggunakan kontrol aplikasi sendiri dan mencatat berapa lama waktu yang dibutuhkan sampai halaman jelas beralih, apa yang akan diperhatikan pengunjung, bukan langkah mikro lab.
+
+- **Rendering work setelah perubahan bahasa**: Tindak lanjut yang lebih sempit: berapa banyak upaya yang diambil interface untuk repaint untuk bahasa baru setelah switch dalam penerbangan. Berguna ketika waktu "terasa" dan biaya framework berbeda.
+
+- **Waktu loading halaman awal**: Dari navigasi ke browser mempertimbangkan halaman sepenuhnya dimuat untuk skenario yang saya uji. Baik untuk membandingkan cold start.
+
+- **Waktu hydration**: Ketika aplikasi mengeksposnya, berapa lama client menghabiskan waktu mengubah server HTML menjadi sesuatu yang benar-benar dapat Anda klik. Dash dalam tabel berarti implementasi itu tidak memberikan angka hydration yang andal dalam benchmark ini.
+
 ## Bintang GitHub
 
 Bintang GitHub adalah indikator kuat dari popularitas proyek, kepercayaan komunitas, dan relevansi jangka panjang. Meskipun bukan ukuran langsung dari kualitas teknis, bintang-bintang tersebut mencerminkan berapa banyak pengembang yang menganggap proyek tersebut berguna, mengikuti kemajuannya, dan kemungkinan akan mengadopsinya. Untuk memperkirakan nilai suatu proyek, bintang membantu membandingkan daya tarik di berbagai alternatif dan memberikan wawasan tentang pertumbuhan ekosistem.

package/docs/id/benchmark/svelte.md

@@ -116,6 +116,28 @@ Kami membandingkan **empat strategi pemuatan**:
 - **Scoped static**: Menjaga kode tetap teratur (pemisahan logis) tanpa permintaan jaringan ekstra yang kompleks.
 - **Scoped dynamic**: Pendekatan terbaik untuk _code splitting_ dan performa. Meminimalkan memori dengan hanya memuat apa yang dibutuhkan oleh tampilan saat ini dan bahasa yang aktif.
 
+### Apa yang saya ukur:
+
+Saya menjalankan aplikasi multibahasa yang sama di browser nyata untuk setiap stack, kemudian mencatat apa yang sebenarnya muncul di wire dan berapa lama waktu yang dibutuhkan. Ukuran dilaporkan **setelah kompresi web normal**, karena itu lebih dekat dengan apa yang orang unduh daripada hitungan sumber mentah.
+
+- **Ukuran library internationalization**: Setelah bundling, tree-shaking dan minification, ukuran library i18n adalah ukuran kode providers + stores dalam komponen kosong. Ini tidak termasuk pemuatan file terjemahan. Ini menjawab seberapa mahal library sebelum konten Anda memasuki gambaran.
+
+- **JavaScript per halaman**: Untuk setiap rute benchmark, berapa banyak script yang browser tarik untuk kunjungan itu, dirata-ratakan di seluruh halaman dalam suite (dan di seluruh locale di mana laporan menggabungkannya). Halaman berat adalah halaman lambat.
+
+- **Kebocoran dari locale lain**: Ini adalah konten halaman yang sama tetapi dalam bahasa lain yang akan dimuat secara tidak sengaja di halaman yang diaudit. Konten ini tidak perlu dan harus dihindari. (misalnya, konten halaman `/fr/about` dalam bundel halaman `/en/about`)
+
+- **Kebocoran dari rute lain**: Ide yang sama untuk **layar lain** di aplikasi: apakah salinannya ikut ketika Anda hanya membuka satu halaman. (misalnya, konten halaman `/en/about` dalam bundel halaman `/en/contact`). Skor tinggi menunjukkan pemisahan lemah atau bundel yang terlalu luas.
+
+- **Ukuran bundel komponen rata-rata**: Piece UI umum diukur **satu per satu** daripada bersembunyi di dalam satu angka aplikasi raksasa. Ini menunjukkan apakah internationalization diam-diam membengkak komponen sehari-hari. Misalnya, jika komponen Anda merender ulang, komponen akan memuat semua data itu dari memori. Melampirkan JSON raksasa ke komponen apa pun seperti menghubungkan penyimpanan data yang tidak digunakan yang akan memperlambat kinerja komponen Anda.
+
+- **Responsivitas switch bahasa**: Saya membalik bahasa menggunakan kontrol aplikasi sendiri dan mengukur berapa lama waktu yang dibutuhkan hingga halaman telah jelas beralih, apa yang akan diperhatikan pengunjung, bukan micro-step lab.
+
+- **Rendering work setelah perubahan bahasa**: Tindak lanjut yang lebih sempit: seberapa banyak upaya yang dibutuhkan antarmuka untuk melukis ulang bahasa baru setelah switch sedang berlangsung. Berguna ketika "terasa" waktu dan biaya framework menyimpang.
+
+- **Waktu pemuatan halaman awal**: Dari navigasi ke browser menganggap halaman sepenuhnya dimuat untuk skenario yang saya uji. Baik untuk membandingkan cold start.
+
+- **Waktu hydration**: Ketika aplikasi memperlihatkannya, berapa lama klien menghabiskan waktu mengubah HTML server menjadi sesuatu yang benar-benar bisa Anda klik. Tanda garis dalam tabel berarti implementasi itu tidak memberikan gambar hydration yang dapat diandalkan dalam benchmark ini.
+
 ## Bintang GitHub
 
 Bintang GitHub adalah indikator kuat dari popularitas proyek, kepercayaan komunitas, dan relevansi jangka panjang. Meskipun bukan ukuran langsung dari kualitas teknis, bintang-bintang tersebut mencerminkan berapa banyak pengembang yang menganggap proyek tersebut berguna, mengikuti kemajuannya, dan kemungkinan akan mengadopsinya. Untuk memperkirakan nilai suatu proyek, bintang membantu membandingkan daya tarik di berbagai alternatif dan memberikan wawasan tentang pertumbuhan ekosistem.

package/docs/id/benchmark/tanstack.md

@@ -124,6 +124,28 @@ Kami membandingkan **empat strategi pemuatan**:
 - **Scoped static**: Menjaga kode tetap teratur (pemisahan logis) tanpa permintaan jaringan ekstra yang kompleks.
 - **Scoped dynamic**: Pendekatan terbaik untuk _code splitting_ dan performa. Meminimalkan memori dengan memuat hanya apa yang dibutuhkan tampilan saat ini dan lokal yang aktif.
 
+### Apa yang saya ukur:
+
+Saya menjalankan aplikasi multibahasa yang sama di browser nyata untuk setiap stack, kemudian mencatat apa yang sebenarnya muncul di kabel dan berapa lama waktu yang dibutuhkan. Ukuran dilaporkan **setelah kompresi web normal**, karena itu lebih dekat dengan apa yang orang unduh daripada hitungan sumber mentah.
+
+- **Ukuran library Internationalization**: Setelah bundling, tree-shaking dan minification, ukuran library i18n adalah ukuran providers (misalnya `NextIntlClientProvider`) + hooks (misalnya `useTranslations`) code dalam komponen kosong. Ini tidak termasuk loading file terjemahan. Ini menjawab betapa mahalnya library sebelum konten Anda masuk ke dalam gambar.
+
+- **JavaScript per halaman**: Untuk setiap rute benchmark, berapa banyak script yang browser tarik dalam kunjungan itu, rata-rata di seluruh halaman dalam suite (dan di seluruh locale di mana laporan menggabungkannya). Halaman yang berat adalah halaman yang lambat.
+
+- **Leakage dari locale lain**: Ini adalah konten halaman yang sama tetapi dalam bahasa lain yang akan dimuat secara tidak sengaja di halaman yang diaudit. Konten ini tidak perlu dan harus dihindari. (misalnya konten halaman `/fr/about` dalam bundle halaman `/en/about`)
+
+- **Leakage dari rute lain**: Ide yang sama untuk **layar lain** di aplikasi: apakah copy mereka berjalan ketika Anda hanya membuka satu halaman. (misalnya konten halaman `/en/about` dalam bundle halaman `/en/contact`). Skor tinggi mengisyaratkan pemisahan yang lemah atau bundle yang terlalu luas.
+
+- **Ukuran bundle komponen rata-rata**: Piece UI umum diukur **satu per satu** daripada bersembunyi di dalam satu angka aplikasi raksasa. Ini menunjukkan apakah internationalization secara diam-diam menginflasi komponen sehari-hari. Misalnya, jika komponen Anda merender ulang, akan memuat semua data itu dari memori. Melampirkan JSON besar ke komponen apa pun seperti menghubungkan toko besar data yang tidak digunakan yang akan memperlambat performa komponen Anda.
+
+- **Responsivitas switch bahasa**: Saya membalik bahasa menggunakan kontrol aplikasi sendiri dan mengukur berapa lama hingga halaman telah jelas berubah, apa yang akan diperhatikan pengunjung, bukan langkah mikro lab.
+
+- **Rendering work setelah perubahan bahasa**: Follow-up yang lebih sempit: berapa banyak effort yang dibutuhkan interface untuk mengecat ulang untuk bahasa baru setelah switch sedang berlangsung. Berguna ketika waktu "felt" dan biaya framework berbeda.
+
+- **Waktu loading halaman awal**: Dari navigasi ke browser yang menganggap halaman sepenuhnya dimuat untuk skenario yang saya uji. Bagus untuk membandingkan cold starts.
+
+- **Hydration time**: Ketika aplikasi memamerkannya, berapa lama klien menghabiskan waktu mengubah server HTML menjadi sesuatu yang benar-benar bisa Anda klik. Dash dalam tabel berarti implementasi itu tidak memberikan angka hydration yang dapat diandalkan dalam benchmark ini.
+
 ## Bintang GitHub
 
 Bintang GitHub adalah indikator kuat dari popularitas proyek, kepercayaan komunitas, dan relevansi jangka panjang. Meskipun bukan ukuran langsung dari kualitas teknis, bintang-bintang tersebut mencerminkan berapa banyak pengembang yang menganggap proyek tersebut berguna, mengikuti kemajuannya, dan kemungkinan akan mengadopsinya. Untuk memperkirakan nilai suatu proyek, bintang membantu membandingkan daya tarik di berbagai alternatif dan memberikan wawasan tentang pertumbuhan ekosistem.

package/docs/id/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## GitHub Actions yang Dihasilkan
+
+Ketika Anda menjalankan `intlayer init`, Intlayer mendeteksi package manager Anda (npm, yarn, pnpm, atau bun) dan membuat dua workflow GitHub Actions di bawah `.github/workflows/`, dengan perintah yang sesuai dengan package manager tersebut:
+
+- **`intlayer-fill.yml`** — Pada setiap pull request, membangun kamus dan menjalankan `intlayer fill --git-diff --mode complete` untuk menghasilkan terjemahan yang hilang untuk kamus yang berubah, kemudian melakukan commit hasilnya kembali ke branch PR.
+- **`intlayer-test.yml`** — Pada setiap pull request, membangun kamus dan menjalankan `intlayer test`, gagal pada pemeriksaan ketika locale yang diperlukan kehilangan terjemahan.
+
+File workflow yang ada tidak pernah ditimpa. Untuk melewati scaffolding sepenuhnya, jalankan:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Memberikan akses AI ke alur kerja fill
+
+`intlayer-fill.yml` yang telah digenerate memerlukan akses AI. Dua opsi tersedia (dikonfigurasi di blok `env` workflow):
+
+1. **Kunci penyedia AI Anda sendiri** — Tambahkan secret `AI_API_KEY` di pengaturan repository Anda (Settings → Secrets and variables → Actions). Workflow meneruskannya melalui `--provider`, `--model`, dan `--api-key`.
+2. **Kunci akses Intlayer CMS** — Tambahkan secret `INTLAYER_CLIENT_ID` dan `INTLAYER_CLIENT_SECRET` dan integrasikan ke dalam bagian `editor` `intlayer.config` Anda. Kunci akses CMS memberikan akses AI melalui backend Intlayer.
+
+Workflow `intlayer-test.yml` tidak memerlukan akses AI apa pun.
+
 ## Penanganan Kesalahan
 
 - Jika `INTLAYER_PROJECT_CREDENTIALS` tidak disetel, perintah akan keluar dengan kesalahan.

package/docs/id/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Tinjau Dokumen
 description: Pelajari cara meninjau file dokumentasi untuk kualitas, konsistensi, dan kelengkapan di berbagai lokal.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Tambahkan opsi --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ Untuk sebagian besar kasus penggunaan,
 
 ## Argumen:
 
-Perintah `doc review` menerima argumen yang sama seperti `doc translate`, memungkinkan Anda untuk meninjau file dokumentasi tertentu dan menerapkan pemeriksaan kualitas.
+**Opsi daftar file:**
 
-Jika Anda mengaktifkan salah satu opsi git, perintah hanya akan meninjau bagian dari file yang mengalami perubahan. Skrip akan memproses dengan membagi file menjadi chunk dan meninjau setiap chunk. Jika tidak ada perubahan pada chunk tersebut, skrip akan melewatinya untuk mempercepat proses review dan membatasi biaya API Penyedia AI.
+- **`--doc-pattern [docPattern...]`**: Pola glob untuk mencocokkan file dokumentasi yang akan ditinjau.
 
-- Untuk daftar lengkap argumen, lihat dokumentasi perintah [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/doc-translate.md).
+  > Contoh: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Pola glob untuk mengecualikan file dari peninjauan.
+
+  > Contoh: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Lewati file jika telah dimodifikasi sebelum waktu yang diberikan.
+  - Bisa berupa waktu absolut seperti "2025-12-05" (string atau Date)
+  - Bisa berupa waktu relatif dalam ms `1 * 60 * 60 * 1000` (1 jam)
+  - Opsi ini memeriksa waktu pembaruan file menggunakan metode `fs.stat`. Jadi bisa terpengaruh oleh Git atau alat lain yang memodifikasi file.
+
+  > Contoh: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Lewati file jika telah dimodifikasi dalam waktu yang diberikan.
+  - Bisa berupa waktu absolut seperti "2025-12-05" (string atau Date)
+  - Bisa berupa waktu relatif dalam ms `1 * 60 * 60 * 1000` (1 jam)
+  - Opsi ini memeriksa waktu pembaruan file menggunakan metode `fs.stat`. Jadi bisa terpengaruh oleh Git atau alat lain yang memodifikasi file.
+
+  > Contoh: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Lewati file jika file tersebut sudah ada.
+
+  > Contoh: `npx intlayer doc review --skip-if-exists`
+
+**Opsi mode peninjauan:**
+
+- **`--log`**: Mode hanya log. Jangan menerjemahkan dengan AI; alih-alih log blok yang memerlukan perhatian (dengan nomor baris dan konten) untuk lokal dasar dan target, untuk membantu agen lain menghasilkan terjemahan.
+
+  > Contoh: `npx intlayer doc review --log`
+
+**Opsi output entri:**
+
+- **`--locales [locales...]`**: Lokalisasi target untuk meninjau dokumentasi.
+
+  > Contoh: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Lokalisasi sumber (dokumen dasar) untuk dibandingkan.
+
+  > Contoh: `npx intlayer doc review --base-locale en`
+
+**Opsi pemrosesan file:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Jumlah file yang diproses secara bersamaan untuk peninjauan.
+
+  > Contoh: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Opsi AI:**
+
+- **`--model [model]`**: Model AI yang digunakan untuk peninjauan (misalnya, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Penyedia AI yang digunakan untuk peninjauan.
+- **`--temperature [temperature]`**: Pengaturan temperature untuk model AI.
+- **`--api-key [apiKey]`**: Berikan API key Anda sendiri untuk layanan AI.
+- **`--application-context [applicationContext]`**: Berikan konteks tambahan untuk peninjauan AI.
+- **`--data-serialization [dataSerialization]`**: Format serialisasi data yang digunakan untuk fitur AI Intlayer. Opsi: `json` (standar, andal), `toon` (lebih sedikit token, kurang konsisten).
+- **`--custom-prompt [prompt]`**: Sesuaikan prompt dasar yang digunakan untuk peninjauan. (Catatan: Untuk sebagian besar kasus penggunaan, opsi `--custom-instructions` lebih disarankan karena memberikan kontrol yang lebih baik.)
+
+  > Contoh: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Opsi variabel lingkungan:**
+
+- **`--env`**: Tentukan lingkungan (misalnya, `development`, `production`).
+- **`--env-file [envFile]`**: Berikan file lingkungan khusus untuk memuat variabel.
+- **`--base-dir`**: Tentukan direktori dasar untuk proyek.
+- **`--no-cache`**: Nonaktifkan cache.
+
+  > Contoh: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Opsi log:**
+
+- **`--verbose`**: Aktifkan logging verbose untuk debugging. (default true saat menggunakan CLI)
+
+  > Contoh: `npx intlayer doc review --verbose`
+
+**Opsi instruksi khusus:**
+
+- **`--custom-instructions [customInstructions]`**: Instruksi khusus yang ditambahkan ke prompt. Berguna untuk menerapkan aturan spesifik terkait format, penerjemahan URL, etc.
+
+  > Contoh: `npx intlayer doc review --custom-instructions "Hindari menerjemahkan url, dan pertahankan format markdown"`
+
+  > Contoh: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Opsi Git:**
+
+- **`--git-diff`**: Hanya jalankan pada file yang mencakup perubahan dari base (default `origin/main`) ke cabang saat ini (default: `HEAD`).
+- **`--git-diff-base`**: Tentukan referensi base untuk git diff (default `origin/main`).
+- **`--git-diff-current`**: Tentukan referensi saat ini untuk git diff (default: `HEAD`).
+- **`--uncommitted`**: Sertakan perubahan yang belum dikomit.
+- **`--unpushed`**: Sertakan perubahan yang belum dipush.
+- **`--untracked`**: Sertakan file yang belum terlacak.
+
+  > Contoh: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Contoh: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Perlu diperhatikan bahwa jalur file keluaran akan ditentukan dengan mengganti pola-pola berikut:
+>
+> - `/{{baseLocale}}/` menjadi `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` menjadi `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` menjadi `_{{locale}}.`
+> - `{{baseLocale}}_` menjadi `{{locale}}_`
+> - `.{{baseLocaleName}}.` menjadi `.{{localeName}}.`
+>
+> Jika pola tidak ditemukan, file keluaran akan menambahkan `.{{locale}}` pada ekstensi file. Misalnya `./my/file.md` akan ditinjau dan diperbarui menjadi `./my/file.fr.md` untuk locale Prancis.