@intlayer/docs 9.3.3 → 9.4.0

package/docs/uk/readme.md

@@ -225,8 +225,8 @@ const HomePage = () => {
   <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=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ const HomePage = () => {
       <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/uk/releases/v8.md

@@ -763,8 +763,6 @@ export default {
   </Tab>
 </Tabs>
 
----
-
 ## Правила множини Unicode CLDR (v8.8.0)
 
 Було впроваджено новий хелпер вузла `plural` на основі правил множини, визначених проектом Unicode CLDR, що покращує підтримку складних мов.
@@ -1111,7 +1109,7 @@ Intlayer v8 включає новий шар кешування для комп
 
 <Tabs group='bundler'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```typescript fileName="babel.config.js"
       const {
       intlayerExtractBabelPlugin,
@@ -1133,7 +1131,7 @@ Intlayer v8 включає новий шар кешування для комп
 
   </Tab>
   <Tab label="Vite" value="vite">
-   
+
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
     import { intlayer, intlayerCompiler } from "vite-intlayer";

package/docs/uk/releases/v9.md

@@ -373,6 +373,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Встановлювач завантажує `docker-compose.yml` та `.env`, автоматично генерує необхідні секрети та запускає `docker compose up -d`. Все — дашборд, API, база даних, сховище об'єктів та транзакційна електронна пошта — працює локально у контейнерах.
 
+---
+
 ## Примітки щодо міграції з v8
 
 Якщо ви оновлюєтеся з v8, зверніть увагу, що v9 не містить критичних змін (breaking changes). Проте ось ключові зміни:

package/docs/uk/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer може повністю працювати на вашій власній інфраструктурі — обліковий запис Intlayer Cloud не потрібен. Одна команда запускає готовий до виробництва стек:
 
+Одна команда встановлює все:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Інсталятор завантажує `docker-compose.yml` та `.env`, автоматично генерує необхідні секрети та запускає всі контейнери за допомогою `docker compose up -d`.
 
+Єдиною зовнішньою залежністю є **MongoDB**: backend підключається до кластера MongoDB **Atlas**, який ви надаєте. Все інше працює всередині контейнера.
+
 ## Зміст
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (використовується для генерації скрін
 - Порти `3000`, `3100`, `8025`, `9000` та `9001` доступні на хості.
 - Хост Linux або macOS (або WSL2 на Windows).
 
+Все інше — Bun, Redis, MinIO, Chromium — поставляється всередині образу.
+
 ---
 
 ## Швидкий старт
 
-Витягніть і запустіть опубліковану image, надавши ваші облікові дані та секрети MongoDB Atlas:
+### 1. Запустити інсталятор
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Він перевіряє, чи встановлено Docker і він запущений, записує `./intlayer.env` із уже згенерованими `BETTER_AUTH_SECRET` та `S3_SECRET_ACCESS_KEY`, і витягує образ. Він не запускає контейнер — backend не може завантажитися без ваших облікових даних бази даних.
+
+Повторне запущення інсталятора безпечне: існуючий `intlayer.env` ніколи не перезаписується, тому він також служить шляхом оновлення.
+
+### 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>
+```
+
+Файл також містить закоментовані блоки для опціональних функцій — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` та OAuth провайдери. Розкоментуйте те, що вам потрібно.
+
+> Файл читається за допомогою `docker run --env-file`, який не видаляє лапки та трактує все після `=` як значення. Пишіть значення без лапок і тримайте коментарі на окремих рядках.
+
+### 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 \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Потім відкрийте **http://localhost:3000**.
+Потім відкрийте **http://localhost:3000**. При першому завантаженні ініціалізуються сховища даних, тому дайте йому хвилину.
 
-> Dashboard доступний на `localhost`. Див. [Обмеження](#limitations) — користувацькі домени не підтримуються опублікованою image.
+> Панель керування обслуговується на `localhost`. Див. [Обмеження](#limitations) — спеціальні домени не підтримуються опублікованим образом.
 
----
+### Налаштування installer
 
-## Швидкий старт
+Installer читає кілька змінних середовища. Оскільки він передається в `sh`, передайте їх оболонці, а не `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Змінна                    | За замовчуванням                              | Опис                                 |
+| ------------------------- | --------------------------------------------- | ------------------------------------ |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Image для завантаження               |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Де писати env файл                   |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Ім'я контейнера                      |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Названий том, змонтований на `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Хост-порт для dashboard              |
+| `INTLAYER_API_PORT`       | `3100`                                        | Хост-порт для API                    |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Хост-порт для MinIO S3 API           |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Хост-порт для MinIO console          |
+
+> Чотири змінні портів змінюють лише сторону **host** у відображенні, надрукованому в команді `docker run`. Опублікований image має `http://localhost:3000`, `http://localhost:3100` і `http://localhost:9000` скомпільовані в bundle dashboard під час збірки, тому їх переназначення залишає браузер, спрямований на старі порти. Зберігайте значення за замовчуванням, якщо ви не будуєте власний image — див. [Обмеження](#limitations).
+
+---
+
+## Швидкий старт
+
 Що робить інсталятор:
 
 1.  Перевіряє наявність `docker` та `docker compose`.
@@ -117,8 +163,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **minio**   | `minio/minio`                       | `9000` (S3), `9001` (консоль)         | Об'єктне сховище, сумісне з S3, для аватарів та скріншотів |
 | **mailpit** | `axllent/mailpit`                   | `1025` (SMTP), `8025` (веб-інтерфейс) | Локальний приймач транзакційних електронних листів         |
 
-Внутрішні порти (mongo, redis) за замовчуванням не доступні з хосту.
-
 > Порт MinIO `9000` має бути доступним для браузера, оскільки завантажені ресурси (аватари, скріншоти) завантажуються безпосередньо з `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Вхід через LinkedIn OAuth                                                           |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Вхід через Atlassian OAuth                                                          |
 
----
-
 ### Глобальний поштовик
 
 За замовчуванням усі транзакційні електронні листи відправляються через Resend з використанням `RESEND_API_KEY`. Самостійно розгорнуті розгортання можуть натомість маршрутизувати **кожну** електронну пошту — включаючи не-організаційні листи, такі як скидання паролів і магічні посилання — через глобальний поштовик, налаштований за допомогою змінних середовища.
@@ -261,16 +303,8 @@ 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
@@ -334,14 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Шукайте `MongoDB connection error` близько до початку логу.
+
 ### Електронні листи не надсилаються
 
 За замовчуванням усі вихідні електронні листи захоплюються Mailpit. Відкрийте `http://localhost:8025`, щоб побачити надіслані повідомлення. Щоб надсилати реальні електронні листи, встановіть `MAIL_PROVIDER=resend` та `RESEND_API_KEY=<ваш-ключ>` у `.env`, а потім перезапустіть бекенд:
 
-```sh
-docker compose restart backend
-```
-
 ### Відсутній кошик MinIO
 
 Якщо одноразовий сервіс `minio-init` не запустився (або запустився до того, як MinIO був готовий), створіть кошик вручну:

package/docs/ur/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> منی فیکیشن کو چھوڑ (skipped) دیا جاتا ہے جب `optimize` کی ویلیو `false` ہو، یا جب `editor.enabled` کی ویلیو `true` ہو (ویژول ایڈیٹر کو ایڈیٹنگ کی اجازت دینے کے لیے اصل فیلڈ کے ناموں کی ضرورت ہوتی ہے)۔
+> جب `optimize` کی ویلیو `false` ہو تو منی فیکیشن چھوڑ (skipped) دی جاتی ہے۔ جب `editor.enabled` کی ویلیو `true` ہو تو یہ پھر بھی چلتی ہے، لیکن فیلڈ کا نام تبدیل کرنے کا مرحلہ چھوڑ دیا جاتا ہے — ویژول ایڈیٹر ترامیم کو `keyPath` کے ذریعے حل کرتا ہے، اس لیے اصل فیلڈ کے ناموں کا برقرار رہنا ضروری ہے۔
 
 > Next.js پر، minification تب بھی چھوڑ دی جاتی ہے جب `@intlayer/swc` نصب نہ ہو یا لوڈ نہ ہو سکے (16.1.0 سے نیچے کا Next.js)۔ سورس میں رسائیوں کو دوبارہ لکھنے والا نصف حصہ یہی پلگ اِن ہے، اس لیے اس کے بغیر ڈکشنریز کے نام بدلنے سے آپ کا کوڈ ایسے فیلڈ نام پڑھتا رہ جائے گا جو اب موجود نہیں۔
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> جب `optimize` کی ویلیو `false` ہو یا جب `editor.enabled` کی ویلیو `true` ہو تو پرجنگ (Purging) چھوڑ (skipped) دی جاتی ہے۔ Next.js پر یہ تب بھی چھوڑ دیا جاتا ہے جب `@intlayer/swc` دستیاب نہ ہو، اور جب کمپیٹ اڈاپٹر کالرز ترتیب دیے گئے ہوں۔
+> جب `optimize` کی ویلیو `false` ہو تو پرجنگ (Purging) چھوڑ دی جاتی ہے۔ جب `editor.enabled` کی ویلیو `true` ہو تب بھی یہ فعال رہتی ہے — کیونکہ ہٹائی گئی فیلڈ کو کوئی بھی کمپوننٹ نہیں پڑھتا، اس لیے ایڈیٹر اسے کبھی رینڈر نہیں کرتا۔ Next.js پر یہ تب بھی چھوڑ دیا جاتا ہے جب `@intlayer/swc` دستیاب نہ ہو، اور جب کمپیٹ اڈاپٹر کالرز ترتیب دیے گئے ہوں۔
 
 > پرجنگ کو حفاظتی تدابیر (conservatively) کے طور پر ان حالات میں بھی چھوڑ دیا جاتا ہے جب کوئی سورس فائل پارس (parse) نہیں ہو پاتی، یا جب `useIntlayer` کا نتیجہ کسی ویری ایبل کو تفویض (assign) کر دیا جائے اور پھر ان طریقوں سے آگے بڑھایا جائے جن کا اسٹیٹک اینالائزر کھوج نہیں لگا سکتا (جیسے اسپریڈ کو کسی آبجیکٹ میں ڈالنا، ڈسٹرکچر کیے بغیر پروپ کے طور پر بھیجنا)۔ ان صورتوں میں، مکمل ڈکشنری محفوظ رکھی جاتی ہے۔
 

package/docs/ur/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: ترتیب (Configuration)
 description: سیکھیں کہ اپنی ایپلیکیشن کے لیے Intlayer کو کیسے ترتیب دینا ہے۔ اپنی ضروریات کے مطابق Intlayer کو اپنی مرضی کے مطابق بنانے کے لیے دستیاب مختلف ترتیبات اور اختیارات کو سمجھیں۔
 keywords:
@@ -16,6 +16,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "`@intlayer/analytics` انسٹال ہونے پر اینالیٹکس بطورِ ڈیفالٹ فعال کیا گیا"
   - version: 9.1.3
     date: 2026-08-06
     changes: "`routing.enableProxy` کو تین حالتوں والا بنایا گیا: غیر مقرر (auto)، `true`، `false`"
@@ -382,8 +385,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * کیا اینالیٹکس ڈیٹا اکٹھا کرنا فعال ہے (پیج ویوز، کنٹینٹ ایکسپوژر، A/B ایونٹس)۔
-     * ایٹریبیوشن کے لیے `editor.clientId` سیٹ ہونا ضروری ہے۔
-     * ڈیفالٹ: false
+     * `@intlayer/analytics` کا انسٹال ہونا اور ایٹریبیوشن کے لیے `editor.clientId` سیٹ ہونا ضروری ہے۔
+     * ڈیفالٹ: true
      */
     enabled: true,
 
@@ -741,13 +744,13 @@ export default config;
 
 Intlayer اینالیٹکس سے متعلق ترتیبات کی وضاحت کرتا ہے: صارفین کو حقیقت میں دکھائے جانے والے مواد (پیج ویوز، کنٹینٹ ایکسپوژر) کو اکٹھا کرنا اور مواد پر A/B ٹیسٹنگ کو فعال بنانا۔
 
-اینالیٹکس مکمل طور پر اختیاری (opt-in) ہے: جب تک `analytics.enabled` کو واضح طور پر `true` پر سیٹ نہ کیا جائے **اور** ایٹریبیوشن کے لیے پراجیکٹ کی (`editor.clientId`) کنفیگر نہ کی جائے، کچھ بھی اکٹھا نہیں کیا جاتا۔ غیر فعال ہونے کی صورت میں (ڈیفالٹ)، پورا اینالیٹکس انٹیگریشن آپ کے ایپلیکیشن بنڈل سے ہٹا دیا جاتا ہے (ڈیڈ کوڈ ایلیمینیشن)۔
+اینالیٹکس بطورِ ڈیفالٹ فعال ہے (opt-out): جیسے ہی `@intlayer/analytics` پیکج انسٹال ہوتا ہے **اور** ایٹریبیوشن کے لیے پراجیکٹ کی (`editor.clientId`) کنفیگر ہوتی ہے، ڈیٹا اکٹھا ہونا شروع ہو جاتا ہے۔ `analytics.enabled` کو `false` کر دیں — یا پیکج انسٹال نہ کریں — تو پورا اینالیٹکس انٹیگریشن آپ کے ایپلیکیشن بنڈل سے ہٹا دیا جاتا ہے (ڈیڈ کوڈ ایلیمینیشن)۔
 
-| فیلڈ            | تفصیل                                                                              | قسم       | ڈیفالٹ  | مثال    | نوٹ                                                                                                                        |
-| --------------- | ---------------------------------------------------------------------------------- | --------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`       | اینالیٹکس ڈیٹا اکٹھا کرنے کو فعال کرتا ہے (پیج ویوز، کنٹینٹ ایکسپوژر، A/B ایونٹس)۔ | `boolean` | `false` | `true`  | ایٹریبیوشن کے لیے `editor.clientId` سیٹ ہونا ضروری ہے؛ ورنہ `enabled` کے `true` ہونے کے باوجود اینالیٹکس غیر فعال رہتا ہے۔ |
-| `flushInterval` | بیک اینڈ کو خودکار بیچ ارسال کے درمیان ملی سیکنڈز۔                                 | `number`  | `20000` | `10000` |                                                                                                                            |
-| `sampleRate`    | ریکارڈ کیے جانے والے سیشنز کا تناسب، `0` (کوئی نہیں) سے `1` (تمام) تک۔             | `number`  | `1`     | `0.5`   | سیمپلنگ فی سیشن یقینی (deterministic) ہے، اس لیے ایک ریکارڈ شدہ سیشن اپنے تمام ایونٹس کی رپورٹ کرتا ہے۔                    |
+| فیلڈ            | تفصیل                                                                              | قسم       | ڈیفالٹ  | مثال    | نوٹ                                                                                                                                                                 |
+| --------------- | ---------------------------------------------------------------------------------- | --------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | اینالیٹکس ڈیٹا اکٹھا کرنے کو فعال کرتا ہے (پیج ویوز، کنٹینٹ ایکسپوژر، A/B ایونٹس)۔ | `boolean` | `true`  | `false` | `@intlayer/analytics` کا انسٹال ہونا اور ایٹریبیوشن کے لیے `editor.clientId` سیٹ ہونا ضروری ہے؛ ورنہ `enabled` کے `true` ہونے کے باوجود اینالیٹکس غیر فعال رہتا ہے۔ |
+| `flushInterval` | بیک اینڈ کو خودکار بیچ ارسال کے درمیان ملی سیکنڈز۔                                 | `number`  | `20000` | `10000` |                                                                                                                                                                     |
+| `sampleRate`    | ریکارڈ کیے جانے والے سیشنز کا تناسب، `0` (کوئی نہیں) سے `1` (تمام) تک۔             | `number`  | `1`     | `0.5`   | سیمپلنگ فی سیشن یقینی (deterministic) ہے، اس لیے ایک ریکارڈ شدہ سیشن اپنے تمام ایونٹس کی رپورٹ کرتا ہے۔                                                             |
 
 ---
 

package/docs/ur/intlayer_with_fastify.md

@@ -222,9 +222,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... دیگر ترتیب کے اختیارات
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/ur/intlayer_with_hono.md

@@ -235,9 +235,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... دیگر کنفیگریشن کے اختیارات
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/ur/introduction.md

@@ -108,7 +108,7 @@ export const MyComponent: FC = () => {
 
 <Accordion header="AI ایجنٹ (AI Agent)">
 
-مواد کو قریب رکھنا بڑے لینگویج ماڈلز (LLMs) کی طرف سے **درکار سیاق و سباق کو کم کرتا ہے**۔ Intlayer ٹولز کے ایک سوٹ کے ساتھ بھی آتا ہے، جیسے غائب ترجموں کو جانچنے کے لیے **CLI**، **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/mcp_server.md)** اور AI ایجنٹس کے لیے ڈیولپر کے تجربے (DX) کو اور بھی ہموار بنانے کے لیے **[ایجنٹ کی مہارتیں (agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/agent_skills.md)**۔
+مواد کو قریب رکھنا بڑے لینگویج ماڈلز (LLMs) کی طرف سے **درکار سیاق و سباق کو کم کرتا ہے**۔ Intlayer ٹولز کے ایک سوٹ کے ساتھ بھی آتا ہے، جیسے غائب ترجموں کو جانچنے کے لیے **CLI**، **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/mcp_server.md)** اور AI ایجنٹس کے لیے ڈیولپر کے تجربے (DX) کو اور بھی ہموار بنانے کے لیے **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/agent_skills.md)**۔
 
 </Accordion>
 

package/docs/vi/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Kỹ năng Agent
+title: Agent Skills
 description: Tìm hiểu cách sử dụng Intlayer Agent Skills để cải thiện khả năng AI agent hiểu về dự án của bạn, bao gồm các hướng dẫn thiết lập toàn diện cho Metadata, Sitemaps và Server Actions.
 keywords:
   - Intlayer
-  - Kỹ năng Agent
+  - Agent Skills
   - AI Agent
   - Quốc tế hóa
   - Tài liệu
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Kỹ năng Agent
+# Agent Skills
 
 ## Thiết lập
 
 ### Sử dụng CLI
 
-Lệnh `intlayer init skills` là cách dễ nhất để thiết lập kỹ năng agent trong dự án của bạn. Nó phát hiện môi trường và cài đặt các tập tin cấu hình cần thiết cho các nền tảng bạn ưu tiên.
+Lệnh `intlayer init skills` là cách dễ nhất để thiết lập Agent Skills trong dự án của bạn. Nó phát hiện môi trường và cài đặt các tập tin cấu hình cần thiết cho các nền tảng bạn ưu tiên.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Mở Command Palette (Ctrl+Shift+P hoặc Cmd+Shift+P).
 2. Nhập `Intlayer: Setup AI Agent Skills`
 3. Chọn nền tảng bạn sử dụng (ví dụ: `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, v.v.).
-4. Chọn các Kỹ năng bạn muốn cài đặt (ví dụ: `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Chọn các Agent Skills bạn muốn cài đặt (ví dụ: `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Nhấn Enter.
 
-## Danh sách kỹ năng
+## Danh sách Agent Skills
 
 **intlayer-config**
 

package/docs/vi/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Theo dõi hiển thị nội dung và chạy thử nghiệm A/B
 description: Khám phá cách @intlayer/analytics theo dõi lượt xem trang/ngôn ngữ và lượt hiển thị nội dung, cũng như cách sử dụng nó để chạy thử nghiệm A/B trên nội dung Intlayer của bạn.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Bật phân tích theo mặc định khi `@intlayer/analytics` được cài đặt"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — gói @intlayer/analytics, theo dõi ở cấp độ provider/node, thử nghiệm A/B, dashboard"
@@ -57,7 +60,7 @@ Intlayer đã cho phép bạn khai báo [Biến thể (Variants)](https://github
 
 ## Cài đặt
 
-`@intlayer/analytics` là một dependency **ngang hàng (peer), tùy chọn** — không bao giờ được tự động cài đặt bởi một gói framework. Hãy thêm nó cùng với `intlayer`:
+`@intlayer/analytics` là **phụ thuộc tùy chọn** của mọi gói framework (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …), nên hầu hết dự án đã có sẵn. Hãy cài đặt tường minh nếu thiết lập của bạn bỏ qua các phụ thuộc tùy chọn (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Nếu bạn không cài đặt nó, mọi điểm tích hợp (integration point) sẽ được coi là một hành động trống (no-op) — xem phần [Không tốn phí khi không được cài đặt](#khong-ton-phi-khi-khong-duoc-cai-dat) bên dưới.
+Chỉ cần cài gói là đủ để bật phân tích: `analytics.enabled` mặc định là `true`, và `@intlayer/config` sẽ chuyển thành `false` bất cứ khi nào không tìm thấy gói trong dự án của bạn. Nếu bạn không cài đặt nó, mọi điểm tích hợp (integration point) sẽ được coi là một hành động trống (no-op) — xem phần [Không tốn phí khi không được cài đặt](#khong-ton-phi-khi-khong-duoc-cai-dat) bên dưới.
 
 ## Cấu hình
 
-Analytics **sử dụng lại khối cấu hình `editor` hiện có** — không có schema cấu hình `analytics` riêng biệt để điền vào:
+Phân tích không cần cấu hình để bắt đầu: nó **được bật theo mặc định** và **tái sử dụng khối cấu hình `editor` sẵn có** cho endpoint và khóa dự án.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 Nếu bạn tự lưu trữ (self-host) Intlayer, analytics sẽ tự động trỏ đến phiên bản của riêng bạn vì nó dùng chung `editor.backendURL`.
 
+### Cách tắt (opt-out)
+
+Khối `analytics` tùy chọn cho phép tinh chỉnh — hoặc tắt hẳn — việc thu thập:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Mặc định: true — loại toàn bộ tích hợp khỏi gói ứng dụng
+    flushInterval: 20_000, // Số mili giây giữa hai lần gửi theo lô
+    sampleRate: 1, // Tỷ lệ phiên được ghi lại, từ 0 (không) đến 1 (tất cả)
+  },
+};
+
+export default config;
+```
+
+Gỡ cài đặt `@intlayer/analytics` có tác dụng tương tự `enabled: false`. Xem [tài liệu tham chiếu cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md) để biết danh sách đầy đủ các trường.
+
 ## Hỗ trợ Framework
 
 Analytics được liên kết với `IntlayerProvider` dùng chung từ `react-intlayer`, vì vậy nó có sẵn ở bất kỳ đâu provider đó được sử dụng:
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` tuân theo chính xác cùng một mô hình tùy chọn-dependency như `@intlayer/editor`:
 
 - mọi điểm tích hợp đều tải gói này thông qua việc sử dụng **dynamic `import()` được bao bọc trong khối `try/catch`** — một ứng dụng không bao giờ cài đặt `@intlayer/analytics` sẽ không bao giờ bị tăng kích thước bundle hoặc chi phí thời gian chạy, và không bao giờ thấy lỗi;
-- một biến môi trường ở thời điểm biên dịch (`INTLAYER_ANALYTICS_ENABLED`), được đặt tự động thành `'false'` bởi `@intlayer/config` bất cứ khi nào `editor.clientId` không được định cấu hình, cho phép các bundler có thể **loại bỏ mã thừa (dead-code-eliminate)** toàn bộ tích hợp này;
+- một biến môi trường tại thời điểm biên dịch (`INTLAYER_ANALYTICS_ENABLED`), được `@intlayer/config` tự động đặt thành `'false'` khi gói chưa được cài đặt, `analytics.enabled` là `false`, hoặc `editor.clientId` chưa được cấu hình, cho phép các bundler **loại bỏ toàn bộ tích hợp dưới dạng mã chết (dead-code-eliminate)**;
 - analytics bị vô hiệu hóa bên trong iframe xem trước của trình chỉnh sửa / CMS Intlayer, do đó các phiên của trình chỉnh sửa không bao giờ được tính là lưu lượng truy cập thực.
 
 ## Dashboard: Trang Analytics

package/docs/vi/benchmark/tanstack.md

@@ -194,6 +194,8 @@ Các vấn đề gặp phải:
 
 `Tolgee` giải quyết được nhiều vấn đề đã đề cập trước đó. Tôi thấy việc bắt đầu với Tolgee khó khăn hơn so với các công cụ khác có phương pháp tiếp cận tương tự. Nó không cung cấp tính an toàn kiểu dữ liệu, điều này cũng khiến việc phát hiện các khóa bị thiếu tại thời điểm biên dịch trở nên khó khăn hơn nhiều. Tôi đã phải bao bọc các API của Tolgee bằng các API của riêng mình để thêm tính năng phát hiện khóa bị thiếu.
 
+Package này khá nặng (~11.1kb, gấp hơn 2× `react-intlayer`).
+
 Trên TanStack Start, tôi cũng gặp vấn đề về tính phản ứng: khi ngôn ngữ thay đổi, tôi phải ép buộc provider render lại và đăng ký vào các sự kiện thay đổi ngôn ngữ để việc tải ở một ngôn ngữ khác hoạt động chính xác.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ Trên TanStack Start, bạn tránh được các cạm bẫy đặc thù của N
 
 Tuy nhiên, nó có cùng những nhược điểm chính như các ngăn công nghệ được xây dựng trên `t('a.b.c')`: tối ưu hóa là có thể nhưng rất tốn thời gian, và các dự án lớn có rủi ro rơi vào các thực hành xấu (namespace + tải động + kiểu dữ liệu).
 
+Package này đặc biệt nặng (~17.3kb, tức là khoảng 3.5× `react-intlayer`).
+
 Các định dạng thông báo cũng khác nhau: `use-intl` sử dụng ICU MessageFormat, trong khi `i18next` sử dụng định dạng riêng của mình - điều này làm phức tạp thêm công cụ hoặc quá trình di chuyển nếu bạn trộn lẫn chúng.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ Các định dạng thông báo cũng khác nhau: `use-intl` sử dụng ICU Mes
 
 `react-intl` là một triển khai hiệu năng từ nhóm Format.js. Trải nghiệm phát triển vẫn còn rườm rà: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` thêm vào sự phức tạp, công việc JavaScript bổ sung và ràng buộc instance i18n toàn cục vào nhiều nút trong cây React.
 
+Package cũng khá nặng (~14.4kb, tức là khoảng 3× `react-intlayer`).
+
 ### 4 - Các khuyến nghị
 
 Benchmark TanStack Start này không có đối trọng trực tiếp cho `next-translate` (Next.js plugin + `getStaticProps`). Đối với các nhóm thực sự muốn một API `t()` với một hệ sinh thái chín muồi, `react-i18next` và `use-intl` vẫn là những lựa chọn "hợp lý", nhưng hãy chuẩn bị đầu tư nhiều thời gian tối ưu hóa để tránh rò rỉ.

package/docs/vi/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> Lưu ý: Sự can thiệp minify sẽ ngừng thực hiện nếu cờ `optimize` được kích ở mức `false` hoặc lúc bộ hiển thị bằng editor đang dùng tham số `editor.enabled` = `true` (do phía editor thiết kế cần đọc đúng định dạng khai báo nguồn nội dung ban đầu từ file config).
+> Việc minify sẽ bị bỏ qua khi `optimize` là `false`. Khi `editor.enabled` là `true`, quá trình này vẫn chạy nhưng không thực hiện bước đổi tên trường — trình soạn thảo trực quan phân giải các chỉnh sửa thông qua `keyPath`, vì vậy tên trường gốc phải được giữ nguyên.
 
 > Trên Next.js, minify cũng bị bỏ qua khi `@intlayer/swc` không được cài đặt hoặc không thể tải (Next.js dưới 16.1.0). Plugin chính là nửa viết lại các truy cập trong mã nguồn, nên đổi tên từ điển mà thiếu nó sẽ khiến mã của bạn đọc những tên trường không còn tồn tại.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Hãy cân nhắc bởi Purge cũng chẳng khác gì minify, hệ sẽ phớt lờ thao tác nếu như thông số thuộc `optimize` để là `false` hay công cụ trình hỗ trợ `editor.enabled` đang mở (true). Trên Next.js, nó còn bị bỏ qua khi `@intlayer/swc` không khả dụng và khi có cấu hình các lời gọi từ bộ chuyển đổi tương thích.
+> Purge sẽ bị bỏ qua khi `optimize` là `false`. Nó vẫn hoạt động khi `editor.enabled` là `true` — một trường đã bị loại bỏ sẽ không được component nào đọc đến, nên trình soạn thảo sẽ không bao giờ render nó. Trên Next.js, nó còn bị bỏ qua khi `@intlayer/swc` không khả dụng và khi có cấu hình các lời gọi từ bộ chuyển đổi tương thích.
 
 > Ngoài ra chức năng của hệ cũng bảo lưu quy trình rủi ro và buộc dừng tiến trình purge (như khi không parse được code nguồn để phân tích), hoặc lệnh trả biến ở bộ thu nhận `useIntlayer` xài như thông số ẩn hoặc bị mã hóa ngầm lúc khai báo truyền tin nên analyzer bot mất dấu để định hướng hành tung của nội dung nguồn (một trường hợp cụ thể đó là kiểu trải dữ liệu `spread` cho vô Object bự xài nhưng quên không destructure rõ ràng tham số lúc dùng trong prop). Tại ranh giới bất an kiểu này hệ tự ép lấy sạch sành sanh cho yên tâm trọn gói JSON mà khỏi sợ cắt lố làm mất dữ liệu oan.
 

package/docs/vi/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Sử dụng trong pipeline CI/CD
 
+Chạy `intlayer init` tạo ra hai GitHub Actions workflows sẵn sàng sử dụng cho bạn (xem [Scaffolded GitHub Actions](#scaffolded-github-actions) dưới đây). Ví dụ ở đây cho thấy cấu hình tương đương bằng cách sử dụng lệnh `ci` cho một monorepo, nơi các credentials được inject cho mỗi project từ `INTLAYER_PROJECT_CREDENTIALS`.
+
 Trong cấu hình CI/CD của bạn (ví dụ: GitHub Actions, GitLab CI), đặt `INTLAYER_PROJECT_CREDENTIALS` làm bí mật:
 
 ```yaml

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

@@ -91,7 +91,15 @@ Lệnh này có thể được sử dụng để đánh giá các tệp đã đ
 
 - **`--log`**: Chế độ chỉ ghi log. Không dịch bằng AI; thay vào đó, ghi lại các phần cần lưu ý (kèm số dòng và nội dung) cho ngôn ngữ cơ sở và ngôn ngữ đích, nhằm hỗ trợ một agent khác tạo bản dịch.
 
-  > Ví dụ: `npx intlayer doc review --log`
+- **If `apply`**: Translate missing/diverging content and return the complete updated Vietnamese file
+- **If `report`**: Log blocks needing attention with line numbers and content for both locales
+- **If `synthesis`**: Skip per-block output and provide only a final recap of up-to-date vs. documents needing edits
+
+> Ví dụ: `npx intlayer doc review --mode report`
+
+> Ví dụ: `npx intlayer doc review --log`
+
+Bất kể chế độ nào, quá trình chạy kết thúc bằng một tổng hợp liệt kê các tài liệu được căn chỉnh với tài liệu cơ sở của chúng và những tài liệu vẫn còn các khối cần chỉnh sửa.
 
 **Tùy chọn xuất đầu vào:**
 

package/docs/vi/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Lệnh này phân tích các tệp khai báo nội dung của bạn để tìm các vấn đề tiềm ẩn như thiếu bản dịch, không nhất quán về cấu trúc hoặc không khớp kiểu dữ liệu. Nếu phát hiện bất kỳ vấn đề nào, **intlayer fill** sẽ đề xuất hoặc áp dụng các cập nhật để giữ cho từ điển của bạn nhất quán và đầy đủ.
 
-Điểm chính:
-
-- Chia các tệp JSON lớn thành các phần nhỏ để nằm trong giới hạn cửa sổ ngữ cảnh của mô hình AI.
-- Thử lại bản dịch nếu định dạng đầu ra không đúng.
-- Tích hợp ngữ cảnh cụ thể cho ứng dụng và tệp để cải thiện độ chính xác của bản dịch.
-- Bảo tồn các bản dịch hiện có bằng cách không ghi đè chúng.
-- Xử lý tệp, phần và ngôn ngữ song song bằng hệ thống hàng đợi để tăng tốc độ.
-
 ## Những Điểm Chính:
 
 - Chia các tệp JSON lớn thành các chunks để duy trì trong giới hạn cửa sổ ngữ cảnh của mô hình AI.

package/docs/vi/cli/index.md

@@ -127,6 +127,8 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 
 - **[Đăng nhập](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/login.md)** - Xác thực với Intlayer CMS và nhận thông tin xác thực truy cập
 
+> `intlayer login` cấp một **access key** (`clientId` / `clientSecret`) mà mọi lệnh có xác thực đều sử dụng. Secret là một thông tin xác thực phía server và không bao giờ được gửi tới client bundle của bạn — xem [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/login.md#keeping-the-access-key-safe).
+
 ### Các lệnh cốt lõi
 
 - **[Xây dựng từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/build.md)** - Xây dựng từ điển của bạn từ các tệp khai báo nội dung

package/docs/vi/cli/list_projects.md

@@ -52,8 +52,6 @@ Lệnh này tìm kiếm và liệt kê tất cả các dự án Intlayer bằng
 
   > Ví dụ: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Ví dụ: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Tìm kiếm từ thư mục gốc của git thay vì thư mục cơ sở. Điều này hữu ích để tìm tất cả các dự án Intlayer trong một monorepo hoặc kho git.
 
   > Ví dụ: `npx intlayer projects list --git-root`