@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.21

package/docs/ur/intlayer_with_vite+lit.md

@@ -79,28 +79,48 @@ Intlayer کے ساتھ، آپ:
 
 npm کا استعمال کرتے ہوئے ضروری پیکجز انسٹال کریں:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> `--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 +171,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 +446,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,48 @@ Intlayer کے ساتھ، آپ:
 
 npm کا استعمال کرتے ہوئے ضروری پیکجز انسٹال کریں:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> `--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 +171,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 +438,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 +578,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 +589,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/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js yêu cầu có plugin `@intlayer/swc` cho bước optimize (bước thay
 
 > Plugin này không cài đặt theo mặc định bởi vì nền tảng hỗ trợ (API SWC Plugins) trên Next.js vẫn còn là một thử nghiệm. Do đó sẽ có thay đổi khi nó được cập nhật.
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 Sau khi hoàn tất, Intlayer có thể tìm kiếm và ứng dụng tự động nó cho phần compile hệ thống.
 
 Để áp dụng các bước thao tác **purge và minify** (chức năng xóa bỏ các trường hoặc cấu trúc bị dư thừa, đặt biệt danh thay thế cho file), nên thực hiện bổ sung cài `@intlayer/babel` và thiết lập trên config của Babel. Vì bản thân lõi Next.js dù sử dụng SWC trong quy trình dịch mã cho code (transform) nhưng lại luôn thực hiện phân giải config cài đặt của Babel (qua file `babel.config.js`). Cho nên plugin của Babel sẽ vận hành như bước khởi động tiền đề trước khi chạy SWC.

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/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`

package/docs/vi/cli/index.md

@@ -125,7 +125,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 
 ### Xác thực
 
-- **[Đăng nhập](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/login.md)** - Xác thực với Intlayer CMS và nhận thông tin xác thực truy cập
+- **[Đă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
 
 ### Các lệnh cốt lõi
 

package/docs/vi/cli/login.md

@@ -78,42 +78,6 @@ bun x intlayer login --cms-url https://intlayer.org
 
 ### Tùy chọn cấu hình
 
-Bạn cũng có thể sử dụng các tùy chọn cấu hình chung sau:
-
-- `--env-file <path>`: Đường dẫn tới file môi trường
-- `-e, --env <env>`: Môi trường thực thi
-- `--base-dir <dir>`: Thư mục gốc của dự án
-- `--verbose`: Bật đầu ra chi tiết (mặc định: true)
-- `--prefix <prefix>`: Tiền tố cho logs
-
-## Cách hoạt động
-
-1. **Khởi động máy chủ cục bộ**: Lệnh khởi động một máy chủ HTTP cục bộ trên một cổng ngẫu nhiên để nhận thông tin xác thực từ CMS
-
-Chỉ định URL của Intlayer CMS để kết nối xác thực.
-
-- **Loại**: `string`
-- **Mặc định**: Giá trị được cấu hình trong `intlayer.config.*` hoặc `https://intlayer.org`
-- **Ví dụ**:
-
-```bash packageManager="npm"
-npx intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="yarn"
-yarn intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="bun"
-bun x intlayer login --cms-url https://intlayer.org
-```
-
-### Tùy chọn cấu hình
-
 Bạn cũng có thể sử dụng các tùy chọn cấu hình chung:
 
 - `--env-file <path>`: Đường dẫn tới file môi trường

package/docs/vi/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-Để truy cập ở cấp độ thấp hơn, `scanWebsite` từ `@intlayer/chokidar/scan` sẽ trả về một đối tượng `ScanResult` có cấu trúc:
+Để truy cập ở cấp độ thấp hơn, `scanWebsite` từ `@intlayer/engine/scan` sẽ trả về một đối tượng `ScanResult` có cấu trúc:
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);