@intlayer/docs 9.4.0-canary.0 → 9.4.0

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

@@ -73,6 +73,34 @@ author: aymericzip
 
 React कंपोनेंट्स के भीतर `useI18n` हुक का उपयोग करने के उदाहरण:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -97,6 +125,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/hi/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ author: aymericzip
 
 ## React में उदाहरण उपयोग
 
-React कंपोनेंट के भीतर `useIntlayer` हुक का प्रदर्शन:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/hi/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 `intlayerPrune` Vite प्लगइन का उपयोग आपकी एप्लिकेशन बंडल से उपयोग में न आने वाले डिक्शनरीज़ को ट्री-शेक और प्रून (हटाने) करने के लिए किया जाता है। यह केवल आवश्यक बहुभाषी सामग्री को ही शामिल करके अंतिम बंडल आकार को कम करने में मदद करता है।
 
+> जब आप [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/vite-intlayer/intlayer.md) का उपयोग करते हैं तो plugin स्वचालित रूप से शामिल और कॉन्फ़िगर किया जाता है। यदि आप plugin stack को स्वयं compose कर रहे हैं तो आपको इसे मैन्युअल रूप से रजिस्टर करने की आवश्यकता है।
+
 ## उपयोग
 
 ### `intlayer()` के भाग के रूप में (अनुशंसित)

package/docs/hi/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.hi.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "hi", // महत्वपूर्ण
+  "content": {
+    "multilingualContent": "मेरे कंपोनेंट का शीर्षक",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -93,6 +104,8 @@ module.exports = helloWorldContent;
 }
 ```
 
+> महत्वपूर्ण: सुनिश्चित करें कि locale फ़ील्ड परिभाषित है। यह Intlayer को बताता है कि फ़ाइल किस भाषा का प्रतिनिधित्व करती है।
+
 > अनुशंसित: यह प्रारूप तब सबसे अच्छा होता है जब आप Intlayer के विज़ुअल एडिटर का उपयोग कर रहे हों या सीधे कोड में अनुवादों का प्रबंधन कर रहे हों।
 
 ### प्रति-लोकेल फ़ाइलों के लिए ग्लोबल कॉन्फ़िगरेशन
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // महत्वपूर्ण
-  "content": {
-    "multilingualContent": "मेरे घटक का शीर्षक",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > महत्वपूर्ण: सुनिश्चित करें कि locale फ़ील्ड परिभाषित है। यह Intlayer को बताता है कि फ़ाइल किस भाषा का प्रतिनिधित्व करती है।
 
-> नोट: दोनों मामलों में, सामग्री घोषणा फ़ाइल को नामकरण पैटर्न `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` का पालन करना चाहिए ताकि Intlayer द्वारा पहचाना जा सके। `.[locale]` प्रत्यय वैकल्पिक है और केवल नामकरण सम्मेलन के रूप में उपयोग किया जाता है।
-
 ## प्रारूपों का मिश्रण
 
 आप एक ही सामग्री कुंजी के लिए दोनों घोषणा दृष्टिकोणों को संयोजित कर सकते हैं। उदाहरण के लिए:

package/docs/hi/readme.md

@@ -225,8 +225,8 @@ Intlayer के साथ शुरुआत करने और इसे अ
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>बैकएंड</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Intlayer के साथ शुरुआत करने और इसे अ
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/hi/releases/v6.md

@@ -116,6 +116,8 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
+`npx intlayer fill` कमांड का उपयोग करके अपने गायब अनुवादों को स्वचालित रूप से भरें।
+
 आप अभी भी कंटेंट फ़ाइलों में `autoFill` फ़ील्ड का उपयोग करके प्रति शब्दकोश सूक्ष्म समायोजन कर सकते हैं। पूर्ण संदर्भ के लिए `doc/autoFill` और `doc/dictionary/content_file` देखें।
 
 ---
@@ -175,6 +177,20 @@ CI उदाहरण [CI/CD](https://github.com/aymericzip/intlayer/blob/main/d
 
 ---
 
+MCP सर्वर को नई features को support करने के लिए update किया गया है।
+
+- स्वचालित भरण
+- अनुपलब्ध अनुवाद परीक्षण करें
+- लाइव अपडेट
+- लॉगिंग
+- सत्यापन
+- माइग्रेशन नोट्स
+- प्रलेखन
+
+> MCP server Intlayer का उपयोग करके परियोजनाओं के स्वचालन में मदद करता है। ऑटोजेनरेटेड कोड के लिए लापता अनुवादों का परीक्षण करता है। यह आपके config को समझने और अपने IDE में Intlayer के दस्तावेज़ को एम्बेड करने में मदद करता है।
+
+---
+
 ## प्रदर्शन: 10× तेज़
 
 - स्थानीय और दूरस्थ डिक्शनरीज़ का समानांतर समाधान
@@ -296,8 +312,6 @@ bun x intlayer live --with 'vite preview'
 
 पूरा मार्गदर्शन प्राप्त करने के लिए [CMS और लाइव सिंक](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) देखें।
 
----
-
 ## Turbopack पर फ़ाइलों को देखने के लिए समानांतर प्रक्रिया
 
 जब आप अपने development server के रूप में `next dev --turbopack` कमांड के साथ Next.js 14 और उससे ऊपर पर Turbopack का उपयोग कर रहे हों, तो dictionary में होने वाले परिवर्तन डिफ़ॉल्ट रूप से स्वचालित रूप से पहचाने नहीं जाएंगे।

package/docs/hi/releases/v9.md

@@ -374,6 +374,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 इंस्टॉलर एक `docker-compose.yml` और एक `.env` डाउनलोड करता है, आवश्यक सीक्रेट्स (secrets) को स्वचालित रूप से जनरेट करता है, और `docker compose up -d` चलाता है। सब कुछ — डैशबोर्ड, API, डेटाबेस, ऑब्जेक्ट स्टोरेज, और ट्रांजेक्शनल ईमेल — कंटेनर्स में स्थानीय रूप से चलता है।
 
+---
+
 ## v8 से माइग्रेशन नोट्स
 
 यदि आप v8 से अपग्रेड कर रहे हैं, तो ध्यान दें कि v9 में कोई ब्रेकिंग बदलाव (breaking changes) शामिल नहीं हैं। लेकिन यहाँ मुख्य बदलाव दिए गए हैं:

package/docs/hi/self_hosting.md

@@ -19,12 +19,16 @@ author: aymericzip
 
 # इंटलेयर को सेल्फ-होस्ट करना
 
+Intlayer आपके स्वयं के infrastructure पर चल सकता है। कोई Intlayer Cloud खाता आवश्यक नहीं है। एक single all-in-one Docker image dashboard, API, और स्थानीय datastores (Redis और MinIO) को bundle करता है जिसकी इसे आवश्यकता है, [s6-overlay](https://github.com/just-containers/s6-overlay) द्वारा supervised।
+
 इंटलेयर पूरी तरह से आपके अपने इंफ्रास्ट्रक्चर पर चल सकता है - इसके लिए इंटलेयर क्लाउड खाते की आवश्यकता नहीं है। एक ही कमांड एक उत्पादन-तैयार स्टैक को बूट करता है:
 
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
+इंस्टॉलर Docker की जांच करता है (इसे इंस्टॉल करने की पेशकश करते हुए), `intlayer.env` फ़ाइल लिखता है जिसमें आपके सीक्रेट पहले से ही जेनरेट हो चुके होते हैं, और इमेज को पुल करता है। फिर यह आपको अपनी क्रेडेंशियल भरने के लिए कहता है और `docker run` कमांड प्रिंट करता है — [क्विक स्टार्ट](#quick-start) देखें।
+
 इंस्टॉलर एक `docker-compose.yml` और एक `.env` डाउनलोड करता है, आवश्यक सीक्रेट्स को स्वतः जेनरेट करता है, और `docker compose up -d` के साथ सभी कंटेनरों को शुरू करता है।
 
 ## विषय-सूची
@@ -54,29 +58,85 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 ---
 
-## पूर्व-आवश्यकताएँ
+## त्वरित शुरुआत
 
-- **डॉकर** ≥ 24 और **डॉकर कंपोज** ≥ v2। यदि इनमें से कोई भी गायब है, तो इंस्टॉलर इंस्टॉल लिंक प्रिंट करता है और बाहर निकल जाता है।
-- होस्ट पर पोर्ट `3000`, `3100`, `8025`, `9000`, और `9001` उपलब्ध होने चाहिए।
-- एक Linux या macOS होस्ट (या Windows पर WSL2)।
+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** खोलें और अपना पहला अकाउंट बनाएँ।
 
 ---
 
-## त्वरित शुरुआत
+## क्विक स्टार्ट
+
+### 1. इंस्टॉलर चलाएँ
 
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-इंस्टॉलर क्या करता है:
+यह Docker इंस्टॉल है और चल रहा है, यह सत्यापित करता है, `./intlayer.env` को `BETTER_AUTH_SECRET` और `S3_SECRET_ACCESS_KEY` के साथ पहले से ही जेनरेट किए गए लिखता है, और इमेज को पुल करता है। यह कंटेनर शुरू नहीं करता है — बैकएंड आपके डेटाबेस क्रेडेंशियल्स के बिना बूट नहीं कर सकता।
 
-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`।
+इंस्टॉलर को फिर से चलाना सुरक्षित है: एक मौजूदा `intlayer.env` को कभी भी ओवरराइट नहीं किया जाता है, इसलिए यह अपग्रेड पथ के रूप में दोहरी भूमिका निभाता है।
 
-स्टैक के चालू होने के बाद, **http://localhost:3000** खोलें और अपना पहला अकाउंट बनाएँ।
+### 2. अपनी साख भरें
+
+`intlayer.env` खोलें और `TODO` से चिह्नित मानों को पूरा करें:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+फाइल में वैकल्पिक सुविधाओं के लिए comment किए गए ब्लॉक भी हैं — [SMTP mailer](#global-mailer), `OPENAI_API_KEY`, और OAuth providers। जो आपको चाहिए उसे uncomment करें।
+
+> फाइल को `docker run --env-file` द्वारा पढ़ा जाता है, जो quotes को strip नहीं करता और `=` के बाद सब कुछ को मान के रूप में मानता है। bare values लिखें, और comments को उनकी अपनी lines पर रखें।
+
+### 3. कंटेनर शुरू करें
+
+यह वह कमांड है जो इंस्टॉलर समाप्त होने पर प्रिंट करता है:
+
+```sh
+docker run -d --name intlayer \
+  --restart unless-stopped \
+  -p 3000:3000 \
+  -p 3100:3100 \
+  -p 9000:9000 \
+  -p 9001:9001 \
+  -v intlayer-data:/data \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+फिर **http://localhost:3000** खोलें। पहली बूट डेटास्टोर को initialize करती है, इसलिए इसे एक मिनट दें।
+
+> डैशबोर्ड `localhost` पर सर्व किया जाता है। [Limitations](#limitations) देखें — कस्टम डोमेन प्रकाशित image द्वारा समर्थित नहीं हैं।
+
+### इंस्टॉलर सेटिंग्स
+
+इंस्टॉलर कुछ environment variables को पढ़ता है। क्योंकि यह `sh` में piped है, उन्हें `curl` के बजाय shell में pass करें:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| Variable                  | Default                                       | Description                     |
+| ------------------------- | --------------------------------------------- | ------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | खींचने के लिए Image             |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | env file लिखने के लिए जगह       |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Container का नाम                |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | `/data` पर mounted named volume |
+| `INTLAYER_APP_PORT`       | `3000`                                        | dashboard के लिए Host port      |
+| `INTLAYER_API_PORT`       | `3100`                                        | API के लिए Host port            |
+| `INTLAYER_S3_PORT`        | `9000`                                        | MinIO S3 API के लिए Host port   |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | MinIO console के लिए Host port  |
+
+> चार port variables केवल `docker run` command में printed mapping के **host** side को बदलते हैं। प्रकाशित image में `http://localhost:3000`, `http://localhost:3100` और `http://localhost:9000` build time पर dashboard bundle में compiled हैं, इसलिए उन्हें remapping करने से browser पुराने ports की ओर इशारा करता है। जब तक आप अपना खुद का image बिल्ड नहीं कर रहे हैं, तब तक defaults को रखें — [Limitations](#limitations) देखें।
 
 ---
 
@@ -103,8 +163,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **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` से लोड होते हैं।
 
 ---
@@ -159,6 +217,10 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 ### वैकल्पिक (अनुपस्थिति में फीचर धीरे-धीरे खराब हो जाते हैं)
 
+डिफ़ॉल्ट रूप से, सभी transactional ईमेल `RESEND_API_KEY` का उपयोग करके Resend के माध्यम से भेजे जाते हैं। Self-hosted deployments इसके बजाय **प्रत्येक** ईमेल — non-organization ईमेल जैसे कि password resets और magic links सहित — को environment variables के साथ कॉन्फ़िगर किए गए global mailer के माध्यम से route कर सकते हैं।
+
+`MAIL_PROVIDER` को सेट करें इसे सक्रिय करने के लिए। जब यह सेट नहीं है, तो डिफ़ॉल्ट Resend mailer का उपयोग किया जाता है।
+
 | वेरिएबल                                                  | फीचर                                                                          |
 | -------------------------------------------------------- | ----------------------------------------------------------------------------- |
 | `OPENAI_API_KEY`                                         | AI-सहायता प्राप्त अनुवाद और कंटेंट ऑडिट                                       |
@@ -171,6 +233,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth लॉगिन                                                          |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth लॉगिन                                                         |
 
+> प्राधिकार: एक संगठन का अपना mailer (**Organization** dashboard से कॉन्फ़िगर किया गया) global mailer को प्राथमिकता देता है, जो बदले में default Resend key को प्राथमिकता देता है।
+
 ---
 
 ## अपने इंटलेयर प्रोजेक्ट को कनेक्ट करना
@@ -238,14 +302,6 @@ 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
@@ -311,14 +367,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+लॉग के शीर्ष के पास `MongoDB connection error` खोजें।
+
 ### ईमेल नहीं भेजा जा रहा है
 
 डिफ़ॉल्ट रूप से, सभी आउटबाउंड ईमेल मेलपिट द्वारा कैप्चर किए जाते हैं। भेजे गए संदेशों को देखने के लिए `http://localhost:8025` खोलें। वास्तविक ईमेल भेजने के लिए, `.env` में `MAIL_PROVIDER=resend` और `RESEND_API_KEY=<your-key>` सेट करें, फिर बैकएंड को रीस्टार्ट करें:
 
-```sh
-docker compose restart backend
-```
-
 ### MinIO बकेट गायब है
 
 यदि `minio-init` वन-शॉट सर्विस नहीं चली (या MinIO के तैयार होने से पहले चली), तो बकेट को मैन्युअल रूप से बनाएँ:

package/docs/id/benchmark/tanstack.md

@@ -194,6 +194,8 @@ Ide di balik `Wuchale` menarik tetapi belum menjadi solusi yang layak. Saya mene
 
 `Tolgee` mengatasi banyak masalah yang disebutkan sebelumnya. Saya merasa lebih sulit untuk memulai adopsi Tolgee dibandingkan alat lain dengan pendekatan serupa. Ia tidak memberikan type safety, yang juga membuat pendeteksian kunci yang hilang saat compile time jauh lebih sulit. Saya harus membungkus API Tolgee dengan API saya sendiri untuk menambahkan deteksi kunci yang hilang.
 
+Package ini cukup berat (~11.1kb, yang merupakan lebih dari 2× `react-intlayer`).
+
 Pada TanStack Start saya juga memiliki masalah reaktivitas: saat lokal berubah, saya harus memaksa provider untuk me-render ulang dan berlangganan ke event perubahan lokal sehingga pemuatan dalam bahasa lain berperilaku dengan benar.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ Pada TanStack Start Anda menghindari jebakan khusus Next.js (`setRequestLocale`,
 
 Namun, ia memiliki kelemahan utama yang sama dengan stack yang dibangun di atas `t('a.b.c')`: optimasi dimungkinkan tetapi sangat memakan waktu, dan proyek besar berisiko jatuh ke dalam praktik buruk (namespace + pemuatan dinamis + tipe).
 
+Paket ini sangat berat (~17.3kb, yang merupakan sekitar 3.5× `react-intlayer`).
+
 Format pesan juga berbeda: `use-intl` menggunakan ICU MessageFormat, sementara `i18next` menggunakan formatnya sendiri-yang memperumit tooling atau migrasi jika Anda mencampurnya.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ Format pesan juga berbeda: `use-intl` menggunakan ICU MessageFormat, sementara `
 
 `react-intl` adalah implementasi performa dari tim Format.js. DX-nya tetap verbose: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` menambah kompleksitas, kerja JavaScript ekstra, dan mengikat instance i18n global ke banyak node di tree React.
 
+Package juga cukup berat (~14.4kb, yang sekitar 3× `react-intlayer`).
+
 ### 4 - Rekomendasi
 
 Benchmark TanStack Start ini tidak memiliki padanan langsung untuk `next-translate` (plugin Next.js + `getStaticProps`). Bagi tim yang benar-benar menginginkan API `t()` dengan ekosistem yang matang, `react-i18next` dan `use-intl` tetap menjadi pilihan yang "masuk akal", tetapi bersiaplah untuk menghabiskan banyak waktu mengoptimalkan untuk menghindari kebocoran.

package/docs/id/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Menggunakan di pipeline CI/CD
 
+Menjalankan `intlayer init` membuat dua workflow GitHub Actions yang siap digunakan untuk Anda (lihat [Scaffolded GitHub Actions](#scaffolded-github-actions) di bawah). Contoh di sini menunjukkan setup yang setara menggunakan perintah `ci` untuk monorepo, di mana credentials disuntikkan per project dari `INTLAYER_PROJECT_CREDENTIALS`.
+
 Dalam konfigurasi CI/CD Anda (misalnya, GitHub Actions, GitLab CI), setel `INTLAYER_PROJECT_CREDENTIALS` sebagai rahasia:
 
 ```yaml

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

@@ -91,7 +91,15 @@ Untuk sebagian besar kasus penggunaan,
 
 - **`--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`
+- ✅ Konten bahasa Inggris (BLOCK 1 of 3)
+- ✅ Konten bahasa Indonesia saat ini (BLOCK 2 of 3)
+- ✅ Mode operasi yang diinginkan (`apply`, `report`, atau `synthesis`)
+
+> Contoh: `npx intlayer doc review --mode report`
+
+> Contoh: `npx intlayer doc review --log`
+
+Apa pun modusnya, proses run berakhir dengan sintesis yang mencantumkan dokumen yang selaras dengan dokumen dasarnya dan dokumen yang masih memiliki blok untuk diedit.
 
 **Opsi output entri:**
 

package/docs/id/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Perintah ini menganalisis file deklarasi konten Anda untuk potensi masalah seperti terjemahan yang hilang, ketidakkonsistenan struktural, atau ketidakcocokan tipe. Jika ditemukan masalah, **intlayer fill** akan mengusulkan atau menerapkan pembaruan untuk menjaga kamus Anda tetap konsisten dan lengkap.
 
-Poin-poin penting:
-
-- Membagi file JSON besar menjadi potongan-potongan untuk tetap berada dalam batas jendela konteks model AI.
-- Mencoba ulang terjemahan jika format output tidak benar.
-- Menggabungkan konteks spesifik aplikasi dan file untuk meningkatkan akurasi terjemahan.
-- Mempertahankan terjemahan yang ada dengan tidak menimpa mereka.
-- Memproses file, potongan, dan locale secara paralel menggunakan sistem antrian untuk meningkatkan kecepatan.
-
 ## Poin-Poin Kunci:
 
 - Membagi file JSON besar menjadi chunk untuk tetap berada dalam batas jendela konteks model AI.

package/docs/id/cli/index.md

@@ -127,6 +127,8 @@ Untuk mempelajari cara mengonfigurasi bahasa yang tersedia atau parameter lainny
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/login.md)** - Autentikasi dengan Intlayer CMS dan dapatkan kredensial akses
 
+> `intlayer login` mengeluarkan sebuah **access key** (`clientId` / `clientSecret`) yang digunakan oleh setiap perintah yang memerlukan kredensial. Secret adalah kredensial sisi server dan tidak pernah mencapai client bundle Anda — lihat [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/login.md#keeping-the-access-key-safe).
+
 ### Perintah Utama
 
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/build.md)** - Bangun kamus Anda dari file deklarasi konten

package/docs/id/cli/login.md

@@ -118,6 +118,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Menjaga akses key tetap aman
+
+`intlayer login` mengeluarkan **access key**: pasangan `clientId` / `clientSecret` yang digunakan oleh setiap perintah terautentikasi (`push`, `pull`, `fill`, `configuration push`, `live`, …) untuk autentikasi.
+
+```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,
+  },
+};
+
+export default config;
+```
+
+> **`clientSecret` adalah kredensial sisi server.** Ini memberikan akses API penuh yang dibatasi proyek — membaca dan menulis kamus Anda, proyek, dan organisasi Anda. Simpan di `.env` (git-ignored) atau penyimpanan rahasia CI Anda, dan jangan pernah inline-kan di file konfigurasi.
+
+Intlayer memberlakukan ini daripada hanya mendokumentasikannya:
+
+- `clientSecret` adalah **dihapus dari konfigurasi yang bundler Anda inline**, sehingga tidak dapat mencapai bundle browser apa pun integrasi framework yang Anda gunakan. Ini hanya pernah dibaca sisi server, saat runtime, dari lingkungan.
+- `clientId` berbeda: ini adalah **kunci proyek publik**, aman untuk dikirim, dan digunakan oleh [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/analytics.md#how-events-are-authenticated) untuk mendapatkan token berumur pendek dan ingest-only.
+
+Mengomentari `clientId` sudah cukup untuk menonaktifkan setiap perilaku terautentikasi — pengambilan kamus jarak jauh, akses CMS, analytics — bahkan ketika variabel lingkungan masih didefinisikan.
+
+Untuk pipeline CI, lebih suka [`ci` command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/ci.md), yang menyuntikkan kredensial untuk durasi satu run alih-alih mempertahankannya.
+
 ## Konfigurasi Manual
 
 Jika browser tidak terbuka secara otomatis, Anda dapat mengunjungi URL yang ditampilkan di terminal secara manual.

package/docs/id/compiler.md

@@ -40,6 +40,12 @@ author: aymericzip
 
 ## Mengapa Menggunakan Intlayer Compiler?
 
+- **Otomatisasi**: Menghilangkan penyalinan konten manual ke dalam kamus.
+
+- **Kecepatan**: Ekstraksi konten yang dioptimalkan memastikan proses build Anda tetap cepat.
+
+- **Developer Experience**: Jaga deklarasi konten tetap berada di tempat penggunaannya, meningkatkan maintainability.
+
 - **Otomatisasi**: Menghilangkan penyalinan konten secara manual ke dalam kamus.
 - **Kecepatan**: Ekstraksi konten yang dioptimalkan memastikan proses build Anda tetap cepat.
 - **Pengalaman Pengembang**: Menjaga deklarasi konten tepat di tempat mereka digunakan, meningkatkan pemeliharaan.
@@ -54,6 +60,8 @@ Meskipun compiler menawarkan pengalaman "langsung bekerja" yang sangat baik, com
 - **Ambiguitas heuristik**: Compiler harus menebak apa yang merupakan konten yang ditujukan untuk pengguna versus logika aplikasi (misalnya, `className="active"`, kode status, ID produk). Dalam codebase yang kompleks, ini dapat menyebabkan false positive atau string yang terlewat yang memerlukan anotasi manual dan pengecualian.
 - **Ekstraksi hanya statis**: Ekstraksi berbasis compiler bergantung pada analisis statis. String yang hanya ada saat runtime (kode kesalahan API, field CMS, dll.) tidak dapat ditemukan atau diterjemahkan oleh compiler saja, jadi Anda masih memerlukan strategi i18n runtime yang melengkapi.
 
+- **Ekstraksi statis saja**: Ekstraksi berbasis compiler mengandalkan analisis statis. String yang hanya ada saat runtime (kode error API, field CMS, dll.) tidak dapat ditemukan atau diterjemahkan oleh compiler saja, jadi Anda masih memerlukan strategi i18n runtime yang komplementer.
+
 Untuk perbandingan arsitektur yang lebih mendalam, lihat posting blog [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/id/compiler_vs_declarative_i18n.md).
 
 Sebagai alternatif, untuk mengotomatisasi proses i18n Anda sambil mempertahankan kontrol penuh atas konten Anda, Intlayer juga menyediakan perintah auto-ekstraksi `intlayer extract` (lihat [dokumentasi CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/extract.md)), atau perintah `Intlayer: extract content to Dictionary` dari ekstensi Intlayer VS Code (lihat [dokumentasi ekstensi VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/vs_code_extension.md)).
@@ -94,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> Plugin `intlayerCompiler()` standalone masih diekspor untuk setup lanjutan. Mendaftarkannya bersama `intlayer()` aman — compiler melakukan deduplikasi dirinya sendiri dan berjalan hanya sekali.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Dukungan Framework
 
 Plugin Vite secara otomatis mendeteksi dan menangani berbagai jenis file:
 
+- **React / JSX / TSX**: Ditangani secara native.
+
+- **Vue**: Memerlukan `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Ditangani secara native.
 - **Vue**: Memerlukan `@intlayer/vue-compiler`.
 - **Svelte**: Memerlukan `@intlayer/svelte-compiler`.