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

package/docs/ur/intlayer_with_vite+lit.md

@@ -79,28 +79,44 @@ Intlayer کے ساتھ، آپ:
 
 npm کا استعمال کرتے ہوئے ضروری پیکجز انسٹال کریں:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
+
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
 ```bash packageManager="npm"
 npm install intlayer lit-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer lit-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer lit-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer lit-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**
@@ -151,7 +167,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -420,7 +442,7 @@ export class MyElement extends LitElement {
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [intlayer(), intlayerProxy()],

package/docs/ur/intlayer_with_vite+vanilla.md

@@ -80,28 +80,44 @@ Intlayer کے ساتھ، آپ:
 
 npm کا استعمال کرتے ہوئے ضروری پیکجز انسٹال کریں:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
+
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
 ```bash packageManager="npm"
 npm install intlayer vanilla-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vanilla-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vanilla-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vanilla-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**
@@ -151,7 +167,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -412,12 +434,15 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // اسے پہلے رکھنا چاہیے
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -549,6 +574,8 @@ bunx intlayer extract
  </Tab>
  <Tab value='Babel کمپائلر'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `intlayerCompiler` پلگ ان شامل کرنے کے لیے اپنی `vite.config.ts` اپ ڈیٹ کریں:
 
 ```ts fileName="vite.config.ts"
@@ -558,7 +585,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // کمپائلر پلگ ان شامل کرتا ہے
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ur/packages/intlayer/comparePaths.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: comparePaths فنکشن دستاویزات | intlayer
+description: جانیں کہ intlayer پیکیج کے لیے comparePaths فنکشن کا استعمال کیسے کریں
+keywords:
+  - comparePaths
+  - normalizePath
+  - فعال لنک (active link)
+  - نیویگیشن
+  - Intlayer
+  - intlayer
+  - بین الاقوامیت (Internationalization)
+  - دستاویزات
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "ابتدائی دستاویزات"
+author: aymericzip
+---
+
+# دستاویزات: `intlayer` میں `comparePaths` فنکشن
+
+## تفصیل
+
+`comparePaths` فنکشن لوکیل (locale) سیگمنٹ، پروٹوکول/ہوسٹ، استفسار کی تار (query string)، ہیش اور ٹریلنگ سلیش (trailing slashes) کو نظرانداز کرتے ہوئے دو یو آر ایل (URLs) یا راستوں کی برابری کا موازنہ کرتا ہے۔ یہ اس بات کا تعین کرنے کا تجویز کردہ طریقہ ہے کہ آیا کوئی نیویگیشن لنک موجودہ صفحے کی طرف اشارہ کر رہا ہے — مثال کے طور پر فعال لنک کو اجاگر کرنے کے لیے — اپنا خود کا (غلطی کا شکار) معمول کی منطق (normalization logic) لکھے بغیر۔
+
+اندرونی طور پر یہ لوکیل سیگمنٹ کو ہٹانے کے لیے [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/packages/intlayer/getPathWithoutLocale.md) کو دوبارہ استعمال کرتا ہے، اس طرح یہ آپ کے تشکیل شدہ روٹنگ موڈ اور لوکیلز کا احترام کرتا ہے۔
+
+پیکیج ایک بنیادی [`normalizePath`](#normalizepath) مددگار (helper) کو بھی برآمد کرتا ہے، جو موازنہ کے لیے استعمال ہونے والا کینونیکل، لوکیل سے آزاد راستہ واپس کرتا ہے۔
+
+**کلیدی خصوصیات:**
+
+- لوکیل سے آزاد موازنہ (`/ur/about`, `/about` سے میل کھاتا ہے)
+- مطلق (absolute) URLs اور متعلقہ (relative) راستوں دونوں کے ساتھ کام کرتا ہے
+- استفسار کی تار (query string)، ہیش اور ٹریلنگ سلیش کو نظر انداز کرتا ہے
+- غائب معروف سلیش اور خالی اقدار کو برداشت کرتا ہے (`/` میں معمول کے مطابق)
+- ہلکا پھلکا — `getPathWithoutLocale` کے اوپر بنایا گیا
+
+---
+
+## فنکشن سگنیچر
+
+```typescript
+comparePaths(
+  pathname: string,  // ضروری
+  href: string,      // ضروری
+  locales?: Locales[] // اختیاری
+): boolean
+
+normalizePath(
+  inputUrl: string,   // ضروری
+  locales?: Locales[] // اختیاری
+): string
+```
+
+---
+
+## پیرامیٹرز
+
+- `pathname: string`
+  - **تفصیل**: موازنہ کرنے کے لیے پہلی URL سٹرنگ یا راستہ (عام طور پر موجودہ راستہ)۔
+  - **قسم**: `string`
+  - **ضروری**: ہاں
+
+- `href: string`
+  - **تفصیل**: موازنہ کرنے کے لیے دوسری URL سٹرنگ یا راستہ (عام طور پر نیویگیشن لنک کا `href`)۔
+  - **قسم**: `string`
+  - **ضروری**: ہاں
+
+- `locales: Locales[]`
+  - **تفصیل**: حمایت یافتہ لوکیلز کا اختیاری مجموعہ (array)۔ پہلے سے طے شدہ طور پر پروجیکٹ میں تشکیل شدہ لوکیلز کو لیتا ہے۔
+  - **قسم**: `Locales[]`
+  - **ضروری**: نہیں (اختیاری)
+
+### واپسی (Returns)
+
+- **قسم**: `boolean`
+- **تفصیل**: `true` جب دونوں ان پٹ ایک ہی لوکیل سے آزاد راستے پر حل ہوتے ہیں، بصورت دیگر `false`۔
+
+---
+
+## استعمال کی مثال
+
+### بنیادی استعمال
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { comparePaths } from "intlayer";
+
+comparePaths("/ru/path", "/path"); // true
+comparePaths("/ru/path/", "/path"); // true
+comparePaths("/ru/path", "/path/"); // true
+comparePaths("/ru/", "/"); // true
+comparePaths("/ru", "/"); // true
+comparePaths("ru/path", "/path"); // true
+comparePaths("", "/"); // true
+comparePaths("/ru", ""); // true
+comparePaths("/ru/path", "/other"); // false
+```
+
+### مطلق اور رشتہ دار URLs
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### فعال نیویگیشن لنک کو اجاگر کرنا
+
+```tsx
+import { comparePaths } from "intlayer";
+import { useLocation } from "react-router";
+
+const NavLink = ({ href, children }) => {
+  const { pathname } = useLocation();
+  const isActive = comparePaths(pathname, href);
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {children}
+    </a>
+  );
+};
+```
+
+---
+
+## normalizePath
+
+`normalizePath` وہ کینونیکل، لوکیل سے آزاد راستہ واپس کرتا ہے جو `comparePaths` کے ذریعہ استعمال ہوتا ہے۔ یہ لوکیل سیگمنٹ، پروٹوکول/ہوسٹ، استفسار کی تار اور ہیش کو ہٹا دیتا ہے، ایک واحد معروف سلیش کو یقینی بناتا ہے، کسی بھی ٹریلنگ سلیش کو ہٹاتا ہے (روٹ کے سوا) اور خالی اقدار کے لیے `/` پر واپس آجاتا ہے۔
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { normalizePath } from "intlayer";
+
+normalizePath("/ru/path"); // "/path"
+normalizePath("/ru/path/"); // "/path"
+normalizePath("ru/path"); // "/path"
+normalizePath("/ru/"); // "/"
+normalizePath("/ru"); // "/"
+normalizePath(""); // "/"
+normalizePath("https://example.com/ru/path"); // "/path"
+```
+
+---
+
+## متعلقہ فنکشنز
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/packages/intlayer/getPathWithoutLocale.md): کسی URL یا راستے سے لوکیل سیگمنٹ کو ہٹاتا ہے۔
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/packages/intlayer/getPrefix.md): کسی دیئے گئے لوکیل کے لیے URL سابقہ (prefix) کا تعین کرتا ہے۔
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/packages/intlayer/getLocalizedUrl.md): ایک مخصوص لوکیل کے لیے مقامی (localized) URL تیار کرتا ہے۔
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

package/docs/vi/autoFill.md

@@ -35,6 +35,26 @@ author: aymericzip
 
 **Các tệp khai báo nội dung tự động điền** trong CI của bạn là một cách để tăng tốc quy trình phát triển.
 
+## Hiểu về hành vi
+
+Lệnh `fill` bao gồm hai chế độ:
+
+- **Complete**: Tự động điền tất cả nội dung bị thiếu cho mỗi locale và chỉnh sửa tệp hiện tại hoặc tệp khác nếu được chỉ định. Nói cách khác, chế độ complete sẽ bỏ qua việc dịch nội dung hiện có nếu đã được dịch.
+- **Review**: Tự động điền **tất cả** nội dung cho mỗi locale và tạo cho một tệp cụ thể hoặc tệp khác nếu được chỉ định.
+
+Lệnh `fill` sẽ xử lý tất cả các tệp khai báo nội dung locale của bạn. Nói cách khác, nó sẽ không xử lý nội dung từ xa của bạn từ CMS. CMS bao gồm hệ thống quản lý bản dịch của riêng nó.
+Nếu bạn sử dụng các plugin như `@intlayer/sync-json-plugin`, Intlayer sẽ chuyển đổi các tệp JSON thành các tệp khai báo nội dung locale. Nói cách khác, chúng sẽ được xử lý bởi lệnh `fill`.
+
+Các tệp được tạo mới bao gồm một hướng dẫn `filled` như siêu dữ liệu từ điển. Hướng dẫn này sẽ được Intlayer sử dụng để biết liệu tệp đã được điền tự động hay không, và bỏ qua tệp này khỏi việc dịch lại nếu có.
+
+Intlayer cũng sẽ xem xét hướng dẫn sau để điền tự động:
+
+- Từ `.content.{ts|js|json}` của bạn → hướng dẫn `fill`
+- Từ tệp cấu hình `.intlayer.config.ts` của bạn → hướng dẫn `dictionary.fill`
+- Sẽ được đặt thành `true` theo mặc định nếu không có
+
+Đối với các tệp khai báo nội dung theo locale, hướng dẫn `true` sẽ được thay thế bằng `./{{fileName}}.fill.content.json`. Điều này là vì một tệp khai báo nội dung theo locale không thể nhận nội dung bản địa hóa bổ sung. Vì vậy, nó sẽ tạo một tệp mới để không ghi đè tệp hiện có.
+
 ## Hành Vi Mặc Định
 
 Theo mặc định, `fill` được đặt là `true` toàn cục, có nghĩa là Intlayer sẽ tự động điền tất cả các tệp nội dung và chỉnh sửa chính tệp đó. Hành vi này có thể được tùy chỉnh theo nhiều cách:

package/docs/vi/benchmark/solid.md

@@ -118,6 +118,28 @@ Chúng tôi đã so sánh **bốn chiến lược tải**:
 - **Scoped static**: Giữ cho mã được tổ chức (tách biệt logic) mà không cần các request mạng bổ sung phức tạp.
 - **Scoped dynamic**: Phương pháp tốt nhất cho _code splitting_ và hiệu suất. Giảm thiểu bộ nhớ bằng cách chỉ tải những gì chế độ xem hiện tại và ngôn ngữ đang hoạt động cần.
 
+### Những gì tôi đo lường:
+
+Tôi chạy cùng một ứng dụng đa ngôn ngữ trong trình duyệt thực tế cho mỗi stack, sau đó ghi lại những gì thực sự xuất hiện trên dây và mất bao lâu. Kích thước được báo cáo **sau nén web bình thường**, vì điều đó gần hơn với những gì mọi người tải xuống so với số lượng nguồn thô.
+
+- **Kích thước thư viện quốc tế hóa**: Sau khi bundling, tree-shaking và minification, kích thước của thư viện i18n là kích thước của providers + hooks/primitives code trong một thành phần rỗng. Nó không bao gồm việc tải các tệp dịch. Nó trả lời câu hỏi thư viện này tốn kém bao nhiêu trước khi nội dung của bạn xuất hiện.
+
+- **JavaScript trên mỗi trang**: Đối với mỗi tuyến đường benchmark, trình duyệt tải bao nhiêu script trong lần truy cập đó, trung bình trên các trang trong bộ (và trên các locale nếu báo cáo gộp chúng). Các trang nặng là các trang chậm.
+
+- **Rò rỉ từ các locale khác**: Đó là nội dung của cùng một trang nhưng bằng ngôn ngữ khác sẽ được tải do lỗi trong trang được kiểm tra. Nội dung này là không cần thiết và nên tránh. (ví dụ: nội dung trang `/fr/about` trong bundle trang `/en/about`)
+
+- **Rò rỉ từ các tuyến đường khác**: Ý tưởng tương tự cho **các màn hình khác** trong ứng dụng: liệu bản sao của chúng có đi kèm khi bạn chỉ mở một trang. (ví dụ: nội dung trang `/en/about` trong bundle trang `/en/contact`). Điểm số cao gợi ý splitting yếu hoặc bundles quá rộng.
+
+- **Kích thước bundle thành phần trung bình**: Các phần UI phổ biến được đo lường **từng cái một** thay vì ẩn trong một số ứng dụng khổng lồ. Nó cho thấy liệu quốc tế hóa có yên tĩnh làm tăng các thành phần hàng ngày hay không. Ví dụ, nếu thành phần của bạn render lại, nó sẽ tải tất cả dữ liệu đó từ bộ nhớ. Gắn một JSON khổng lồ vào bất kỳ thành phần nào cũng giống như kết nối một cửa hàng lớn dữ liệu không được sử dụng sẽ làm chậm hiệu suất các thành phần của bạn.
+
+- **Độ phản hồi chuyển đổi ngôn ngữ**: Tôi chuyển đổi ngôn ngữ bằng cách điều khiển của ứng dụng và đo lường thời gian cho đến khi trang đã rõ ràng chuyển đổi, điều mà một khách truy cập sẽ nhận thấy, không phải một bước micro trong phòng thí nghiệm.
+
+- **Rendering work sau khi thay đổi ngôn ngữ**: Một bước theo dõi hẹp hơn: giao diện tốn bao nhiêu công sức để vẽ lại cho ngôn ngữ mới khi việc chuyển đổi đang diễn ra. Hữu ích khi "cảm nhận" thời gian và chi phí framework khác nhau.
+
+- **Thời gian tải trang ban đầu**: Từ điều hướng đến trình duyệt coi trang được tải hoàn toàn cho các kịch bản tôi đã kiểm tra. Tốt cho so sánh các lần khởi động lạnh.
+
+- **Hydration time**: Khi ứng dụng cung cấp nó, trình duyệt máy khách dành bao lâu để biến HTML máy chủ thành thứ gì đó bạn thực sự có thể nhấp vào. Một dấu gạch ngang trong các bảng có nghĩa là việc thực hiện này không cung cấp một con số hydration đáng tin cậy trong benchmark này.
+
 ## Sao GitHub
 
 Sao GitHub là một chỉ số mạnh mẽ về mức độ phổ biến của dự án, sự tin tưởng của cộng đồng và mức độ phù hợp lâu dài. Mặc dù không phải là thước đo trực tiếp về chất lượng kỹ thuật, chúng phản ánh số lượng nhà phát triển thấy dự án hữu ích, theo dõi tiến trình của nó và có khả năng áp dụng nó. Để ước tính giá trị của một dự án, các ngôi sao giúp so sánh sức hút giữa các lựa chọn thay thế và cung cấp thông tin chi tiết về sự phát triển của hệ sinh thái.

package/docs/vi/benchmark/svelte.md

@@ -116,6 +116,28 @@ Chúng tôi đã so sánh **bốn chiến lược tải**:
 - **Scoped static**: Giữ cho mã được tổ chức (tách biệt logic) mà không cần các request mạng bổ sung phức tạp.
 - **Scoped dynamic**: Phương pháp tốt nhất cho _code splitting_ và hiệu suất. Giảm thiểu bộ nhớ bằng cách chỉ tải những gì chế độ xem hiện tại và ngôn ngữ đang hoạt động cần.
 
+### Những gì tôi đo lường:
+
+Tôi đã chạy cùng một ứng dụng đa ngôn ngữ trong trình duyệt thực tế cho mọi stack, sau đó ghi lại những gì thực sự xuất hiện trên đường truyền và mất bao lâu. Kích thước được báo cáo **sau khi nén web bình thường**, bởi vì điều đó gần hơn với những gì mọi người tải xuống so với số lượng nguồn thô.
+
+- **Kích thước thư viện quốc tế hóa**: Sau khi bundle, tree-shaking và minification, kích thước của thư viện i18n là kích thước của mã providers + stores trong một component trống. Nó không bao gồm việc tải các tệp dịch. Nó trả lời câu hỏi thư viện tốn kém bao nhiêu trước khi nội dung của bạn vào tranh.
+
+- **JavaScript trên mỗi trang**: Đối với mỗi tuyến benchmark, trình duyệt kéo bao nhiêu script trong lần truy cập đó, được tính trung bình trên các trang trong bộ (và trên các locale khi báo cáo tập hợp chúng). Các trang nặng là các trang chậm.
+
+- **Rò rỉ từ các locale khác**: Đó là nội dung của cùng một trang nhưng ở ngôn ngữ khác sẽ được tải nhầm trong trang đã kiểm toán. Nội dung này là không cần thiết và nên được tránh. (ví dụ: nội dung trang `/fr/about` trong bundle trang `/en/about`)
+
+- **Rò rỉ từ các tuyến khác**: Cùng ý tưởng cho **các màn hình khác** trong ứng dụng: liệu bản sao của chúng có được đi cùng khi bạn chỉ mở một trang. (ví dụ: nội dung trang `/en/about` trong bundle trang `/en/contact`). Điểm số cao gợi ý về splitting yếu hoặc các bundle quá rộng.
+
+- **Kích thước bundle component trung bình**: Các phần giao diện người dùng phổ biến được đo **một lần** thay vì ẩn bên trong một con số ứng dụng khổng lồ. Nó cho thấy liệu quốc tế hóa có im lặng làm tăng các component hàng ngày hay không. Ví dụ, nếu component của bạn render lại, nó sẽ tải tất cả dữ liệu đó từ bộ nhớ. Đính kèm một JSON khổng lồ vào bất kỳ component nào giống như kết nối một kho dữ liệu không sử dụng lớn sẽ làm chậm hiệu suất của các component của bạn.
+
+- **Khảp phản ứng chuyển đổi ngôn ngữ**: Tôi lật ngôn ngữ bằng cách điều khiển của ứng dụng và đo thời gian cho đến khi trang rõ ràng đã chuyển đổi, điều mà một người truy cập sẽ nhận thấy, không phải một bước vi mô trong phòng thí nghiệm.
+
+- **Công việc rendering sau khi thay đổi ngôn ngữ**: Một bước theo dõi hẹp hơn: giao diện tốn bao nhiêu nỗ lực để vẽ lại cho ngôn ngữ mới khi công tắc đang diễn ra. Hữu ích khi thời gian "cảm nhận" và chi phí framework khác nhau.
+
+- **Thời gian tải trang ban đầu**: Từ điều hướng đến trình duyệt xem xét trang được tải hoàn toàn cho các kịch bản tôi đã kiểm tra. Tốt cho việc so sánh khởi động lạnh.
+
+- **Thời gian hydration**: Khi ứng dụng hiển thị, người dùng khách hàng dành bao lâu để biến HTML máy chủ thành thứ bạn thực sự có thể nhấp vào. Dấu gạch ngang trong các bảng có nghĩa là triển khai đó không cung cấp hình hydration đáng tin cậy trong benchmark này.
+
 ## Sao GitHub
 
 Sao GitHub là một chỉ số mạnh mẽ về mức độ phổ biến của dự án, sự tin tưởng của cộng đồng và mức độ phù hợp lâu dài. Mặc dù không phải là thước đo trực tiếp về chất lượng kỹ thuật, chúng phản ánh số lượng nhà phát triển thấy dự án hữu ích, theo dõi tiến trình của nó và có khả năng áp dụng nó. Để ước tính giá trị của một dự án, các ngôi sao giúp so sánh sức hút giữa các lựa chọn thay thế và cung cấp thông tin chi tiết về sự phát triển của hệ sinh thái.

package/docs/vi/benchmark/tanstack.md

@@ -124,6 +124,28 @@ Chúng tôi đã so sánh **bốn chiến lược tải**:
 - **Scoped static**: Giữ cho mã được tổ chức (tách biệt logic) mà không cần các yêu cầu mạng bổ sung phức tạp.
 - **Scoped dynamic**: Phương pháp tốt nhất cho việc _chia tách mã_ (code splitting) và hiệu năng. Giảm thiểu bộ nhớ bằng cách chỉ tải những gì cần thiết cho chế độ xem hiện tại và ngôn ngữ đang hoạt động.
 
+### Những gì tôi đã đo lường:
+
+Tôi chạy cùng một ứng dụng đa ngôn ngữ trong một trình duyệt thực cho mỗi stack, sau đó ghi lại những gì thực sự xuất hiện trên đường truyền và mất bao lâu. Kích thước được báo cáo **sau nén web bình thường**, bởi vì điều đó gần hơn với những gì mọi người tải xuống so với số lượng nguồn thô.
+
+- **Kích thước thư viện quốc tế hóa**: Sau khi bundling, tree-shaking và minification, kích thước của thư viện i18n là kích thước của các providers (ví dụ: `NextIntlClientProvider`) + hooks (ví dụ: `useTranslations`) code trong một component trống. Nó không bao gồm việc tải các tệp dịch. Nó trả lời câu hỏi thư viện tốn kém bao nhiêu trước khi nội dung của bạn vào vào hình ảnh.
+
+- **JavaScript trên mỗi trang**: Đối với mỗi tuyến đường benchmark, trình duyệt tải bao nhiêu script trong lần truy cập đó, được tính trung bình trên các trang trong bộ (và trên các locales nơi báo cáo ghi chép chúng). Các trang nặng là các trang chậm.
+
+- **Rò rỉ từ các locales khác**: Đó là nội dung của cùng một trang nhưng ở ngôn ngữ khác sẽ được tải bởi lỗi trên trang được kiểm tra. Nội dung này là không cần thiết và nên tránh. (ví dụ: nội dung trang `/fr/about` trong bundle trang `/en/about`)
+
+- **Rò rỉ từ các tuyến đường khác**: Cùng ý tưởng cho **các màn hình khác** trong ứng dụng: liệu bản sao của chúng có đi cùng khi bạn chỉ mở một trang. (ví dụ: nội dung trang `/en/about` trong bundle trang `/en/contact`). Điểm số cao gợi ý tách biệt yếu hoặc bundle quá rộng.
+
+- **Kích thước bundle component trung bình**: Các UI pieces phổ biến được đo lường **từng cái một** thay vì ẩn bên trong một số ứng dụng khổng lồ. Nó cho thấy liệu quốc tế hóa có yên tĩnh làm tăng các component hàng ngày hay không. Ví dụ, nếu component của bạn renders lại, nó sẽ tải tất cả dữ liệu đó từ bộ nhớ. Gắn một JSON lớn vào bất kỳ component nào cũng giống như kết nối một cửa hàng lớn dữ liệu không sử dụng sẽ làm chậm hiệu suất component của bạn.
+
+- **Khả năng phản hồi khi chuyển đổi ngôn ngữ**: Tôi lật ngôn ngữ bằng cách sử dụng điều khiển của ứng dụng và đo thời gian cần thiết cho đến khi trang đã rõ ràng được chuyển đổi, điều mà một khách truy cập sẽ nhận thấy, không phải một bước micro của phòng thí nghiệm.
+
+- **Công việc rendering sau khi thay đổi ngôn ngữ**: Một lần theo dõi hẹp hơn: giao diện mất bao nhiêu nỗ lực để vẽ lại cho ngôn ngữ mới khi sự chuyển đổi đang được thực hiện. Hữu ích khi thời gian "cảm nhận" và chi phí framework phân kỳ.
+
+- **Thời gian tải trang ban đầu**: Từ điều hướng đến trình duyệt xem xét trang được tải đầy đủ cho các kịch bản tôi đã kiểm tra. Tốt để so sánh lần khởi động lạnh.
+
+- **Thời gian hydration**: Khi ứng dụng hiển thị nó, khách hàng mất bao lâu để biến HTML máy chủ thành thứ bạn thực sự có thể nhấp. Một dấu gạch ngang trong các bảng có nghĩa là việc triển khai này không cung cấp con số hydration đáng tin cậy trong benchmark này.
+
 ## Sao GitHub
 
 Sao GitHub là một chỉ số mạnh mẽ về mức độ phổ biến của dự án, sự tin tưởng của cộng đồng và mức độ phù hợp lâu dài. Mặc dù không phải là thước đo trực tiếp về chất lượng kỹ thuật, chúng phản ánh số lượng nhà phát triển thấy dự án hữu ích, theo dõi tiến trình của nó và có khả năng áp dụng nó. Để ước tính giá trị của một dự án, các ngôi sao giúp so sánh sức hút giữa các lựa chọn thay thế và cung cấp thông tin chi tiết về sự phát triển của hệ sinh thái.

package/docs/vi/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## GitHub Actions được tạo tự động
+
+Khi bạn chạy `intlayer init`, Intlayer sẽ phát hiện package manager của bạn (npm, yarn, pnpm, hoặc bun) và tạo hai workflow GitHub Actions trong `.github/workflows/`, với các lệnh phù hợp với package manager đó:
+
+- **`intlayer-fill.yml`** — Trên mọi pull request, xây dựng các từ điển và chạy `intlayer fill --git-diff --mode complete` để tạo các bản dịch bị thiếu cho các từ điển đã thay đổi, sau đó commit kết quả lại vào nhánh PR.
+- **`intlayer-test.yml`** — Trên mọi pull request, xây dựng các từ điển và chạy `intlayer test`, làm cho kiểm tra thất bại khi các locale bắt buộc bị thiếu bản dịch.
+
+Các tập tin workflow hiện có sẽ không bao giờ bị ghi đè. Để bỏ qua việc tạo tự động hoàn toàn, hãy chạy:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Cấp quyền truy cập AI cho quy trình fill
+
+`intlayer-fill.yml` được tạo ra yêu cầu quyền truy cập AI. Có hai tùy chọn có sẵn (được cấu hình trong khối `env` của quy trình):
+
+1. **Khóa nhà cung cấp AI của riêng bạn** — Thêm bí mật `AI_API_KEY` trong cài đặt kho lưu trữ của bạn (Settings → Secrets and variables → Actions). Quy trình sẽ chuyển tiếp nó qua `--provider`, `--model` và `--api-key`.
+2. **Khóa truy cập Intlayer CMS** — Thêm bí mật `INTLAYER_CLIENT_ID` và `INTLAYER_CLIENT_SECRET` và kết nối chúng vào phần `editor` của `intlayer.config` của bạn. Các khóa truy cập CMS cấp quyền truy cập AI thông qua backend Intlayer.
+
+Quy trình `intlayer-test.yml` không yêu cầu bất kỳ quyền truy cập AI nào.
+
 ## Xử lý lỗi
 
 - Nếu `INTLAYER_PROJECT_CREDENTIALS` không được đặt, lệnh sẽ thoát với lỗi.

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Đánh Giá Tài Liệu
 description: Tìm hiểu cách đánh giá các tệp tài liệu về chất lượng, tính nhất quán và độ đầy đủ trên các ngôn ngữ khác nhau.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Thêm tùy chọn --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ Lệnh này có thể được sử dụng để đánh giá các tệp đã đ
 
 ## Tham số:
 
-Lệnh `doc review` chấp nhận cùng các tham số như `doc translate`, cho phép bạn đánh giá các tệp tài liệu cụ thể và áp dụng các kiểm tra chất lượng.
+**Tùy chọn danh sách tệp:**
 
-Nếu bạn đã kích hoạt một trong các tùy chọn git, lệnh sẽ chỉ đánh giá phần của các tệp bị thay đổi. Script sẽ xử lý bằng cách chia tệp thành các phần nhỏ và đánh giá từng phần. Nếu phần đó không có thay đổi, script sẽ bỏ qua để tăng tốc quá trình đánh giá và giới hạn chi phí API của nhà cung cấp AI.
+- **`--doc-pattern [docPattern...]`**: Các mẫu glob để khớp với các tệp tài liệu cần đánh giá.
 
-- Để xem danh sách đầy đủ các tham số, hãy xem tài liệu lệnh [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-translate.md).
+  > Ví dụ: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Các mẫu glob để loại trừ khỏi việc đánh giá.
+
+  > Ví dụ: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Bỏ qua tệp nếu nó đã được sửa đổi trước thời gian cho trước.
+  - Có thể là thời gian tuyệt đối như "2025-12-05" (chuỗi hoặc Date)
+  - Có thể là thời gian tương đối tính bằng ms `1 * 60 * 60 * 1000` (1 giờ)
+  - Tùy chọn này kiểm tra thời gian cập nhật của tệp bằng phương thức `fs.stat`. Do đó, nó có thể bị ảnh hưởng bởi Git hoặc các công cụ khác sửa đổi tệp.
+
+  > Ví dụ: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Bỏ qua tệp nếu nó đã được sửa đổi trong khoảng thời gian cho trước.
+  - Có thể là thời gian tuyệt đối như "2025-12-05" (chuỗi hoặc Date)
+  - Có thể là thời gian tương đối tính bằng ms `1 * 60 * 60 * 1000` (1 giờ)
+  - Tùy chọn này kiểm tra thời gian cập nhật của tệp bằng phương thức `fs.stat`. Do đó, nó có thể bị ảnh hưởng bởi Git hoặc các công cụ khác sửa đổi tệp.
+
+  > Ví dụ: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Bỏ qua tệp nếu tệp đã tồn tại.
+
+  > Ví dụ: `npx intlayer doc review --skip-if-exists`
+
+**Tùy chọn chế độ đánh giá:**
+
+- **`--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`
+
+**Tùy chọn xuất đầu vào:**
+
+- **`--locales [locales...]`**: Các ngôn ngữ đích để đánh giá tài liệu.
+
+  > Ví dụ: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Ngôn ngữ nguồn (tài liệu cơ sở) để so sánh.
+
+  > Ví dụ: `npx intlayer doc review --base-locale en`
+
+**Tùy chọn xử lý tệp:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Số lượng tệp được xử lý đồng thời để đánh giá.
+
+  > Ví dụ: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Tùy chọn AI:**
+
+- **`--model [model]`**: Mô hình AI được sử dụng để đánh giá (ví dụ: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Nhà cung cấp AI được sử dụng để đánh giá.
+- **`--temperature [temperature]`**: Thiết lập nhiệt độ cho mô hình AI.
+- **`--api-key [apiKey]`**: Cung cấp khóa API riêng của bạn cho dịch vụ AI.
+- **`--application-context [applicationContext]`**: Cung cấp ngữ cảnh bổ sung cho việc đánh giá AI.
+- **`--data-serialization [dataSerialization]`**: Định dạng tuần tự hóa dữ liệu sử dụng cho các tính năng AI của Intlayer. Các tùy chọn: `json` (tiêu chuẩn, đáng tin cậy), `toon` (ít token hơn, kém nhất quán hơn).
+- **`--custom-prompt [prompt]`**: Tùy chỉnh prompt cơ bản được sử dụng cho việc đánh giá. (Lưu ý: Trong hầu hết các trường hợp, tùy chọn `--custom-instructions` được khuyến nghị vì nó cung cấp khả năng kiểm soát tốt hơn.)
+
+  > Ví dụ: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Ứng dụng của tôi là một cửa hàng mèo"`
+
+**Tùy chọn biến môi trường:**
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`).
+- **`--env-file [envFile]`**: Cung cấp tệp môi trường tùy chỉnh để tải biến.
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án.
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Tùy chọn ghi log:**
+
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+
+  > Ví dụ: `npx intlayer doc review --verbose`
+
+**Tùy chọn hướng dẫn tùy chỉnh:**
+
+- **`--custom-instructions [customInstructions]`**: Hướng dẫn tùy chỉnh được thêm vào prompt. Hữu ích để áp dụng các quy tắc cụ thể liên quan đến định dạng, dịch URL, v.v.
+
+  > Ví dụ: `npx intlayer doc review --custom-instructions "Tránh dịch các URL, và giữ nguyên định dạng markdown"`
+
+  > Ví dụ: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Tùy chọn Git:**
+
+- **`--git-diff`**: Chỉ chạy trên các tệp có thay đổi từ cơ sở (mặc định `origin/main`) đến nhánh hiện tại (mặc định: `HEAD`).
+- **`--git-diff-base`**: Chỉ định tham chiếu cơ sở cho git diff (mặc định `origin/main`).
+- **`--git-diff-current`**: Chỉ định tham chiếu hiện tại cho git diff (mặc định: `HEAD`).
+- **`--uncommitted`**: Bao gồm các thay đổi chưa được commit.
+- **`--unpushed`**: Bao gồm các thay đổi chưa được đẩy lên.
+- **`--untracked`**: Bao gồm các tệp chưa được theo dõi.
+
+  > Ví dụ: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ví dụ: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Lưu ý rằng đường dẫn tệp đầu ra sẽ được xác định bằng cách thay thế các mẫu sau:
+>
+> - `/{{baseLocale}}/` thành `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` thành `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` thành `_{{locale}}.`
+> - `{{baseLocale}}_` thành `{{locale}}_`
+> - `.{{baseLocaleName}}.` thành `.{{localeName}}.`
+>
+> Nếu không tìm thấy mẫu, tệp đầu ra sẽ thêm `.{{locale}}` vào phần mở rộng của tệp. Ví dụ, `./my/file.md` sẽ được đánh giá và cập nhật thành `./my/file.fr.md` cho ngôn ngữ Pháp.

package/docs/vi/cli/fill.md

@@ -47,6 +47,14 @@ 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
 - 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.
+- Thử lại dịch nếu định dạng đầu ra không chính xác.
+- Kết 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ý các tệp, chunks và locales song song bằng cách sử dụng hệ thống queue để tăng tốc độ.
+
 ## Bí danh:
 
 - `npx intlayer dictionaries fill`