@intlayer/docs 9.3.3 → 9.4.0

package/docs/vi/packages/intlayer/getIntlayer.md

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Tài liệu Hàm getIntlayer | intlayer
+description: Xem cách sử dụng hàm getIntlayer cho gói intlayer
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Tài liệu: Hàm `getIntlayer` trong `intlayer`
+
+## Mô tả
+
+Hàm `getIntlayer` chọn một từ điển theo khóa của nó và trả về nội dung được diễn giải cho một locale nhất định. Đây là phiên bản độc lập với framework tương ứng với hook `useIntlayer`: cùng nội dung, cùng selectors, nhưng có thể sử dụng ở bất kỳ đâu mà React context không khả dụng — các script Node, server functions, route loaders, metadata builders, Express/Fastify handlers, tests.
+
+Nó đọc các từ điển được tạo bởi Intlayer trong `.intlayer/`, vì vậy argument `key` được gõ và tự động hoàn thành từ các khai báo nội dung của bạn, và đối tượng được trả về được gõ đầy đủ đến từng leaf.
+
+**Các tính năng chính:**
+
+- Các khóa từ điển được gõ và nội dung được trả về được gõ
+- Diễn giải mọi nút nội dung (`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- Chấp nhận một locale hoặc một đối tượng selector (collections, variants)
+- Kết quả được ghi nhớ mỗi `key + locale + selector`
+- Quay lại một proxy an toàn trong quá trình phát triển khi một từ điển bị thiếu, thay vì gặp lỗi
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // Bắt buộc
+  localeOrSelector?: LocalesValues | DictionarySelector, // Tùy chọn
+  plugins?: Plugins[]                         // Tùy chọn
+): DeepTransformContent<...>
+```
+
+---
+
+## Tham số
+
+- `key: DictionaryKeys`
+  - **Description**: Khóa của từ điển cần đọc, được khai báo trong các tệp nội dung của bạn.
+  - **Type**: `DictionaryKeys` — một union của mọi khóa từ điển được khai báo.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Locale để diễn giải nội dung với, hoặc một object selector cho [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/index.md).
+    - `'fr'` — một locale
+    - `{ item: 2 }` — một mục [collection](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/collections.md) (bỏ qua `item` để lấy mọi mục dưới dạng mảng)
+    - `{ variant: 'black-friday' }` — một [variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/variants.md) được đặt tên (bỏ qua để lấy variant `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — một variant có cấu trúc
+    - Bất kỳ selector nào cũng có thể mang theo một locale: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — mặc định là `defaultLocale` được cấu hình.
+
+- `plugins: Plugins[]`
+  - **Description**: Các node transformers tùy chỉnh thay thế các plugins interpreter cơ bản. Chỉ dùng cho các trường hợp nâng cao; bỏ qua để giữ hành vi mặc định.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Returns
+
+- **Type**: Nội dung được diễn giải của từ điển, được gõ từ khai báo của bạn.
+- **Description**: Một plain object phản ánh trường `content` của từ điển của bạn, trong đó mỗi nút Intlayer đã được giải quyết thành giá trị cuối cùng cho ngôn ngữ được yêu cầu.
+
+---
+
+## Ví dụ sử dụng
+
+### Cách Sử Dụng Cơ Bản
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      vi: "Xin chào",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### Không có locale
+
+Bỏ qua locale sẽ diễn giải nội dung với `defaultLocale` được khai báo trong [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md) của bạn.
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // Diễn giải với locale mặc định
+```
+
+### Bên trong một server handler
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### With a selector (collections and variants)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// Một item của collection
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// Mọi item của collection, dưới dạng một mảng có thứ tự
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// Một variant được đặt tên
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## Ghi chú về Hành vi
+
+### Caching
+
+Kết quả được memoized trong một module-level cache được khóa bằng `key + locale + selector`. Gọi `getIntlayer("app", "fr")` nhiều lần sẽ chỉ diễn dịch dictionary một lần và trả về cùng một object sau đó.
+
+### Từ điển bị thiếu
+
+Trong quá trình phát triển, yêu cầu một khóa không có từ điển được tạo sẽ ghi lại một cảnh báo một lần và trả về một proxy dự phòng an toàn: đọc `content.title` sẽ trả về chuỗi `"app.title"` thay vì ném lỗi. Điều này giữ cho trang có thể sử dụng được trong khi khai báo bị thiếu được sửa chữa. Chạy bản dựng Intlayer (hoặc máy chủ dev) để từ điển được tạo.
+
+### Kích thước Bundle
+
+`getIntlayer` đọc từ từ điển hợp nhất, chứa **mọi** locale. Trong client bundles, các [build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/bundle_optimization.md) viết lại cuộc gọi để chỉ nội dung cần thiết được gửi đi. Khi bạn đọc nội dung bên ngoài rendering (metadata, loaders, server functions) và muốn một locale duy nhất được tải theo yêu cầu, hãy sử dụng [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getIntlayerAsync.md) thay thế.
+
+---
+
+## Các Hàm Liên Quan
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getIntlayerAsync.md): Phiên bản async tải một chunk locale duy nhất.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getDictionary.md): Diễn giải một đối tượng dictionary mà bạn truyền vào, thay vì tìm kiếm theo khóa.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/react-intlayer/useIntlayer.md): Hook React tương đương, đọc locale từ provider.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/vi/packages/intlayer/getIntlayerAsync.md

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getIntlayerAsync Function Documentation | intlayer
+description: See how to use the getIntlayerAsync function for intlayer package
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Tài liệu: Hàm `getIntlayerAsync` trong `intlayer`
+
+## Mô tả
+
+Hàm `getIntlayerAsync` chọn một từ điển theo khóa của nó và giải quyết nội dung của nó cho một locale nhất định, **chỉ tải locale đó**.
+
+Nó là phiên bản không đồng bộ của [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getIntlayer.md), được sử dụng cho các trường hợp từ điển được đọc bên ngoài quá trình render — route `head` / metadata builders, loaders, server functions.
+
+Nếu như `getIntlayer` kéo trong từ điển đã hợp nhất chứa mọi locale, các [build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`) sẽ viết lại cuộc gọi này thành `getDictionaryAsync(loaderMap, key, locale)`, chỉ vào các chunks theo locale trong `.intlayer/dynamic_dictionaries/`. Bundle do đó chỉ bao giờ cũng mang lại locale thực sự được yêu cầu.
+
+Nếu không có các plugins này — một build chưa được tối ưu hóa — cuộc gọi sẽ được giải quyết thông qua registry từ điển đồng bộ thay thế: cùng nội dung, nhưng không có sự phân chia theo locale.
+
+**Các tính năng chính:**
+
+- Các khóa, selector và nội dung được trả về giống như `getIntlayer`
+- Chỉ tải chunk locale được yêu cầu trong các build được tối ưu hóa
+- Các cuộc gọi đồng thời cho cùng một chunk chia sẻ một lần tải
+- An toàn để sử dụng trong `async` metadata builders, loaders và server functions
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // Bắt buộc
+  localeOrSelector?: LocalesValues | DictionarySelector, // Tùy chọn
+  plugins?: Plugins[]                         // Tùy chọn
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Tham số
+
+- `key: DictionaryKeys`
+  - **Description**: Khóa của từ điển cần đọc, như được khai báo trong các tệp nội dung của bạn.
+  - **Type**: `DictionaryKeys` — một union của mọi khóa từ điển được khai báo.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Locale để giải thích nội dung với, hoặc một đối tượng selector cho [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/index.md).
+    - `'fr'` — một locale
+    - `{ item: 2 }` — một mục [collection](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/collections.md) (bỏ qua `item` để lấy mọi mục dưới dạng mảng)
+    - `{ variant: 'black-friday' }` — một [variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/variants.md) có tên (bỏ qua để lấy `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — một variant có cấu trúc
+    - Bất kỳ selector nào cũng có thể mang theo một locale: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — mặc định là `defaultLocale` được cấu hình.
+
+- `plugins: Plugins[]`
+  - **Description**: Các node transformers tùy chỉnh thay thế các plugin interpreter cơ bản. Chỉ sử dụng nâng cao.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Returns
+
+- **Type**: `Promise<Content>` — a promise resolving to the interpreted content of the dictionary, typed from your declaration.
+
+---
+
+## Ví dụ Sử dụng
+
+### Cách sử dụng cơ bản
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` vs `getIntlayerAsync`
+
+|                    | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                          |
+| ------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
+| Returns            | Nội dung                                                                                                        | Một promise của nội dung                    |
+| Dictionary loaded  | Từ điển được hợp nhất (tất cả các locale)                                                                       | Chunk của locale được yêu cầu duy nhất      |
+| Best suited for    | Rendering, các đường mã đồng bộ                                                                                 | Metadata, loaders, server functions         |
+| Requires a plugin? | No                                                                                                              | No — per-locale split cần các build plugins |
+
+Cả hai chấp nhận các đối số giống nhau và trả về nội dung giống nhau: chuyển đổi từ cái này sang cái khác chỉ thay đổi **khi** và **bao nhiêu** được tải.
+
+---
+
+## Các Hàm Liên Quan
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getIntlayer.md): Tương đương đồng bộ đọc từ điển đã hợp nhất.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getDictionaryAsync.md): Hàm cấp thấp hơn mà các build plugins viết lại cuộc gọi này thành.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getLocale.md): Phát hiện locale của một yêu cầu đến.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/vi/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Hàm `getLocalizedPath` chuyển đổi một canonical path (đường dẫn nội bộ của ứng dụng) thành phiên bản đã được địa phương hóa dựa trên locale và các quy tắc rewrite được cung cấp. Hàm này đặc biệt hữu ích để tạo các URL thân thiện với SEO thay đổi theo ngôn ngữ.
 
+Đây là đối tác tương đối của [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getLocalizedUrl.md) — đối với input tương đối, cả hai đều trả về giá trị giống nhau. Không giống như `getLocalizedUrl`, nó không bao giờ trả về URL tuyệt đối: cấu hình `domains` bị bỏ qua, vì vậy một locale được phục vụ từ domain của nó vẫn tạo ra một đường dẫn. Input tuyệt đối được chấp nhận, nhưng nguồn gốc của nó bị loại bỏ — chỉ đường dẫn, chuỗi truy vấn và hash được giữ lại.
+
 **Tính năng chính:**
 
 - Hỗ trợ tham số route động bằng cú pháp `[param]`.
@@ -60,18 +62,23 @@ getLocalizedPath(
   - **Kiểu**: `string`
   - **Bắt buộc**: Có
 
-- `locale: Locales`
-  - **Mô tả**: Locale đích mà đường dẫn sẽ được nội địa hóa.
-  - **Kiểu**: `Locales`
-  - **Bắt buộc**: Có
-
 ### Tham số tùy chọn
 
+- `locale?: Locales`
+  - **Description**: Ngôn ngữ đích mà đường dẫn sẽ được địa phương hóa.
+  - **Type**: `Locales`
+  - **Default**: Ngôn ngữ mặc định của cấu hình dự án của bạn.
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Mô tả**: Một đối tượng định nghĩa các quy tắc rewrite tùy chỉnh. Nếu không được cung cấp, nó mặc định là thuộc tính `routing.rewrite` từ cấu hình dự án của bạn.
   - **Kiểu**: `RoutingConfig['rewrite']`
   - **Mặc định**: `configuration.routing.rewrite`
 
+  - `options.locales?: Locales[]` — các locale được hỗ trợ. **Default**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — locale mặc định. **Default**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — cách locale xuất hiện trong đường dẫn. **Default**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — các quy tắc rewrite tùy chỉnh. **Default**: `configuration.routing.rewrite`
+
 ---
 
 ## Trả về
@@ -79,6 +86,28 @@ getLocalizedPath(
 - **Kiểu**: `string`
 - **Mô tả**: Đường dẫn đã được nội địa hóa cho locale được chỉ định.
 
+Kiểu được thu hẹp từ các quy tắc rewrite được khai báo trong cấu hình của bạn, vì vậy trình chỉnh sửa hiển thị đường dẫn đã được giải quyết thay vì một `string` đơn thuần:
+
+```typescript codeFormat="typescript"
+// Cấu hình: mode 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (không có quy tắc rewrite nào khớp, chỉ áp dụng prefix)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Cùng một narrowing này chảy vào [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getLocalizedUrl.md), áp dụng các quy tắc rewrite trước khi thêm tiền tố locale.
+
+Hai trường hợp vẫn được mở rộng thành `string`, vì chúng không thể được giải quyết tại thời điểm biên dịch:
+
+- a path that is not a string literal (e.g. one built from a variable);
+- a path matched by a rule using a multi-segment or optional parameter (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Ví dụ sử dụng
@@ -126,6 +155,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Kết quả: "/contactez-nous"
 ```
 
+### Bỏ qua Locale
+
+Khi không có locale nào được cung cấp, đường dẫn được bản địa hóa cho locale mặc định được cấu hình:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Configuration: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Output: "/about"
+```
+
 ---
 
 ## Các hàm liên quan

package/docs/vi/packages/intlayer/getLocalizedUrl.md

@@ -70,6 +70,11 @@ getLocalizedUrl(
 
 ### Tham số tùy chọn
 
+- `options?: object`
+  - **Description**: Đối tượng cấu hình cho hành vi localization của URL.
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
 - `locales?: Locales[]`
   - **Mô tả**: Mảng các locale được hỗ trợ. Nếu không cung cấp, sẽ sử dụng các locale đã cấu hình trong cấu hình dự án của bạn.
   - **Kiểu**: `Locales[]`
@@ -112,38 +117,6 @@ getLocalizedUrl("/about", Locales.ENGLISH);
 // Kết quả: "/about" hoặc "/en/about" (tùy thuộc vào thiết lập prefixDefault của bạn)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-// Cung cấp rõ ràng tất cả các tham số tùy chọn
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Kết quả: "/fr/about" cho locale tiếng Pháp
-// Kết quả: "/about" cho locale mặc định (tiếng Anh)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-// Cung cấp rõ ràng tất cả các tham số tùy chọn
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Kết quả: "/fr/about" cho locale tiếng Pháp
-// Kết quả: "/about" cho locale mặc định (tiếng Anh)
-```
-
 ### Advanced Usage (With Optional Parameters)
 
 You can override the default configuration by providing the optional `options` parameter:
@@ -245,6 +218,12 @@ getLocalizedUrl(
 - **Locale Không Hỗ Trợ:**
   - Đối với các locale không nằm trong danh sách `locales`, hàm sẽ không áp dụng tiền tố nào.
 
+- **Các chế độ định tuyến:**
+  - `'prefix-no-default'`: Locale mặc định không có tiền tố, những locale khác có (ví dụ: `/about`, `/fr/about`)
+  - `'prefix-all'`: Tất cả các locale đều có tiền tố (ví dụ: `/en/about`, `/fr/about`)
+  - `'no-prefix'`: Không có tiền tố locale trong URL (locale được xử lý ở nơi khác)
+  - `'search-params'`: Locale được chỉ định qua tham số truy vấn (ví dụ: `/about?locale=fr`)
+
 ---
 
 ## Sử Dụng Trong Ứng Dụng

package/docs/vi/packages/intlayer/getMultilingualUrls.md

@@ -31,6 +31,14 @@ author: aymericzip
 
 Hàm `getMultilingualUrls` tạo ra một ánh xạ các URL đa ngôn ngữ bằng cách thêm tiền tố URL đã cho với mỗi ngôn ngữ được hỗ trợ. Hàm có thể xử lý cả URL tuyệt đối và tương đối, áp dụng tiền tố ngôn ngữ phù hợp dựa trên cấu hình được cung cấp hoặc mặc định.
 
+**Các Tính Năng Chính:**
+
+- Chỉ 1 tham số là bắt buộc: `url`
+- Object `options` tùy chọn với `locales`, `defaultLocale`, và `mode`
+- Sử dụng cấu hình quốc tế hóa của dự án của bạn làm mặc định
+- Hỗ trợ nhiều chế độ định tuyến: `prefix-no-default`, `prefix-all`, `no-prefix`, và `search-params`
+- Trả về một object ánh xạ với tất cả các locale làm khóa và các URL tương ứng của chúng làm giá trị
+
 ---
 
 ## Chữ Ký Hàm
@@ -139,8 +147,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Các Chế Độ Định Tuyến Khác Nhau
 
 ```typescript
@@ -206,6 +212,12 @@ getMultilingualUrls("/dashboard", {
 - **Ngôn ngữ không được hỗ trợ:**
   - Chỉ những ngôn ngữ được cung cấp trong mảng `locales` mới được xem xét để tạo URL.
 
+- **Các Chế độ Định tuyến:**
+  - `'prefix-no-default'`: Ngôn ngữ mặc định không có tiền tố, các ngôn ngữ khác có (ví dụ: `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Tất cả các ngôn ngữ đều có tiền tố (ví dụ: `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Không có tiền tố ngôn ngữ trong URL (tất cả các ngôn ngữ trả về cùng một URL)
+  - `'search-params'`: Ngôn ngữ được chỉ định thông qua tham số truy vấn (ví dụ: `/dashboard?locale=fr`)
+
 ---
 
 ## Sử dụng trong các ứng dụng

package/docs/vi/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Hàm `getTranslationContent` lấy nội dung tương ứng với một locale cụ thể từ một tập hợp nội dung ngôn ngữ có thể tùy chỉnh. Nếu locale được chỉ định không được tìm thấy, hàm sẽ mặc định trả về nội dung của locale mặc định được cấu hình trong dự án.
 
+Để biết thêm chi tiết về cách khai báo translations, hãy xem [tài liệu Translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/translation.md).
+
 ## Tham số
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/vi/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ Trong `next-intlayer`, locale hiện tại được quản lý thông qua các c
 
 #### Ví dụ:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## Lỗi Thường Gặp và Khắc Phục Sự Cố

package/docs/vi/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ Hướng dẫn thiết lập các tệp khai báo nội dung có sẵn [tại đ
 
 Dưới đây là cách bạn có thể triển khai hook `useIntlayer` trong một trang Next.js để tải nội dung đa ngôn ngữ một cách động dựa trên locale hiện tại của ứng dụng:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/vi/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ Phần này cung cấp hướng dẫn chi tiết về cách sử dụng hook `us
 
 ## Ví dụ sử dụng trong React
 
-Dưới đây là ví dụ về cách sử dụng hook `useDictionary` trong một component React:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

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

@@ -77,6 +77,34 @@ Tất cả các khóa trong từ điển phải được khai báo trong các t
 
 Ví dụ về cách sử dụng hook `useI18n` trong các thành phần React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";