@intlayer/docs 7.0.7 → 7.0.8-canary.0

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

@@ -0,0 +1,162 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Tài liệu hàm getEnumeration | intlayer
+description: Xem cách sử dụng hàm getEnumeration cho gói intlayer
+keywords:
+  - getEnumeration
+  - dịch thuật
+  - Intlayer
+  - intlayer
+  - Quốc tế hóa
+  - Tài liệu
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getEnumeration
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Khởi tạo lịch sử
+---
+
+# Tài liệu: Hàm `getEnumeration` trong `intlayer`
+
+## Mô tả
+
+Hàm `getEnumeration` lấy nội dung tương ứng với một số lượng cụ thể dựa trên các điều kiện đã được định nghĩa trước trong một đối tượng liệt kê. Các điều kiện được định nghĩa dưới dạng các khóa, và thứ tự ưu tiên của chúng được xác định theo thứ tự trong đối tượng.
+
+## Tham số
+
+- `enumerationContent: QuantityContent<Content>`
+  - **Mô tả**: Một đối tượng trong đó các khóa đại diện cho các điều kiện (ví dụ: `<=`, `<`, `>=`, `=`) và các giá trị đại diện cho nội dung tương ứng. Thứ tự các khóa xác định độ ưu tiên khi so khớp.
+  - **Kiểu**: `QuantityContent<Content>`
+    - `Content` có thể là bất kỳ kiểu nào.
+
+- `quantity: number`
+  - **Mô tả**: Giá trị số được sử dụng để so khớp với các điều kiện trong `enumerationContent`.
+  - **Kiểu**: `number`
+
+## Giá trị trả về
+
+- **Kiểu**: `Content`
+- **Mô tả**: Nội dung tương ứng với điều kiện đầu tiên được khớp trong `enumerationContent`. Nếu không tìm thấy khớp nào, sẽ xử lý theo cách cài đặt (ví dụ: lỗi hoặc nội dung dự phòng).
+
+## Ví dụ sử dụng
+
+### Sử dụng cơ bản
+
+```typescript codeFormat="typescript"
+import { getEnumeration } from "intlayer";
+
+// Lấy nội dung dựa trên số lượng và điều kiện trong enumerationContent
+const content = getEnumeration(
+  {
+    "<=-2.3": "Bạn có ít hơn -2.3",
+    "<1": "Bạn có ít hơn một",
+    "2": "Bạn có hai",
+    ">=3": "Bạn có ba hoặc nhiều hơn",
+  },
+  2
+);
+
+console.log(content); // Kết quả: "Bạn có hai"
+```
+
+```javascript codeFormat="esm"
+import { getEnumeration } from "intlayer";
+
+// Lấy nội dung dựa trên số lượng và điều kiện trong enumerationContent
+const content = getEnumeration(
+  {
+    "<1": "Bạn có ít hơn một",
+    "2": "Bạn có hai",
+    ">=3": "Bạn có ba hoặc nhiều hơn",
+  },
+  2
+);
+
+console.log(content); // Kết quả: "Bạn có hai"
+```
+
+```javascript codeFormat="commonjs"
+const { getEnumeration } = require("intlayer");
+
+// Lấy nội dung dựa trên số lượng và điều kiện trong enumerationContent
+const content = getEnumeration(
+  {
+    "<1": "Bạn có ít hơn một",
+    "2": "Bạn có hai",
+    ">=3": "Bạn có ba hoặc nhiều hơn",
+  },
+  2
+);
+
+console.log(content); // Kết quả: "Bạn có hai"
+```
+
+### Ưu tiên của các điều kiện
+
+```typescript codeFormat="typescript"
+import { getEnumeration } from "intlayer";
+
+const content = getEnumeration(
+  {
+    "<4": "Bạn có ít hơn bốn",
+    "2": "Bạn có hai",
+  },
+  2
+);
+
+console.log(content); // Kết quả: "Bạn có ít hơn bốn"
+```
+
+```javascript codeFormat="esm"
+import { getEnumeration } from "intlayer";
+
+const content = getEnumeration(
+  {
+    "<4": "Bạn có ít hơn bốn",
+    "2": "Bạn có hai",
+  },
+  2
+);
+
+console.log(content); // Kết quả: "Bạn có ít hơn bốn"
+```
+
+```javascript codeFormat="commonjs"
+const { getEnumeration } = require("intlayer");
+
+const content = getEnumeration(
+  {
+    "<4": "Bạn có ít hơn bốn",
+    "2": "Bạn có hai",
+  },
+  2
+);
+
+console.log(content); // Kết quả: "Bạn có ít hơn bốn"
+```
+
+## Các Trường Hợp Biên
+
+- **Không Có Điều Kiện Phù Hợp:**
+  - Nếu không có điều kiện nào phù hợp với số lượng được cung cấp, hàm sẽ trả về `undefined` hoặc xử lý kịch bản mặc định/dự phòng một cách rõ ràng.
+
+- **Điều Kiện Mơ Hồ:**
+  - Nếu các điều kiện chồng chéo nhau, điều kiện phù hợp đầu tiên (dựa trên thứ tự trong đối tượng) sẽ được ưu tiên.
+
+- **Khóa Không Hợp Lệ:**
+  - Hàm giả định rằng tất cả các khóa trong `enumerationContent` đều hợp lệ và có thể phân tích như các điều kiện. Các khóa không hợp lệ hoặc định dạng sai có thể dẫn đến hành vi không mong muốn.
+
+- **Ràng Buộc TypeScript:**
+  - Hàm đảm bảo rằng kiểu `Content` nhất quán trên tất cả các khóa, cho phép an toàn kiểu khi lấy nội dung.
+
+## Ghi Chú
+
+- Tiện ích `findMatchingCondition` được sử dụng để xác định điều kiện phù hợp dựa trên số lượng đã cho.

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

@@ -0,0 +1,121 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Tài liệu hàm getHTMLTextDir | intlayer
+description: Xem cách sử dụng hàm getHTMLTextDir cho gói intlayer
+keywords:
+  - getHTMLTextDir
+  - dịch thuật
+  - Intlayer
+  - intlayer
+  - Quốc tế hóa
+  - Tài liệu
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getHTMLTextDir
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Khởi tạo lịch sử
+---
+
+# Tài liệu: Hàm `getHTMLTextDir` trong `intlayer`
+
+## Mô tả
+
+Hàm `getHTMLTextDir` xác định hướng văn bản (`ltr`, `rtl`, hoặc `auto`) dựa trên locale được cung cấp. Hàm này được thiết kế để giúp các nhà phát triển thiết lập thuộc tính `dir` trong HTML nhằm hiển thị văn bản đúng cách.
+
+## Tham số
+
+- `locale?: Locales`
+  - **Mô tả**: Chuỗi locale (ví dụ: `Locales.ENGLISH`, `Locales.ARABIC`) được sử dụng để xác định hướng văn bản.
+  - **Kiểu**: `Locales` (tùy chọn)
+
+## Giá trị trả về
+
+- **Kiểu**: `Dir` (`'ltr' | 'rtl' | 'auto'`)
+- **Mô tả**: Hướng văn bản tương ứng với locale:
+  - `'ltr'` cho các ngôn ngữ viết từ trái sang phải.
+  - `'rtl'` cho các ngôn ngữ viết từ phải sang trái.
+  - `'auto'` nếu locale không được nhận diện.
+
+## Ví dụ sử dụng
+
+### Xác định hướng văn bản
+
+```typescript codeFormat="typescript"
+import { getHTMLTextDir } from "intlayer";
+
+getHTMLTextDir(Locales.ENGLISH); // Kết quả: "ltr"
+getHTMLTextDir(Locales.FRENCH); // Kết quả: "ltr"
+getHTMLTextDir(Locales.ARABIC); // Kết quả: "rtl"
+```
+
+```javascript codeFormat="esm"
+import { getHTMLTextDir } from "intlayer";
+
+getHTMLTextDir(Locales.ENGLISH); // Kết quả: "ltr"
+getHTMLTextDir(Locales.FRENCH); // Kết quả: "ltr"
+getHTMLTextDir(Locales.ARABIC); // Kết quả: "rtl"
+```
+
+```javascript codeFormat="commonjs"
+const { getHTMLTextDir } = require("intlayer");
+
+getHTMLTextDir(Locales.ENGLISH); // Kết quả: "ltr"
+getHTMLTextDir(Locales.FRENCH); // Kết quả: "ltr"
+getHTMLTextDir(Locales.ARABIC); // Kết quả: "rtl"
+```
+
+## Các trường hợp đặc biệt
+
+- **Không cung cấp Locale:**
+  - Hàm trả về `'auto'` khi `locale` là `undefined`.
+
+- **Locale không được nhận diện:**
+  - Với các locale không được nhận diện, hàm mặc định trả về `'auto'`.
+
+## Sử dụng trong Components:
+
+Hàm `getHTMLTextDir` có thể được sử dụng để thiết lập thuộc tính `dir` trong tài liệu HTML một cách động nhằm hiển thị văn bản đúng hướng dựa trên locale.
+
+```tsx codeFormat="typescript"
+import type { FC } from "react";
+import { getHTMLTextDir, type Locales } from "intlayer";
+
+export const HTMLLayout: FC<PropsWithChildren<{ locale: Locales }>> = ({
+  children,
+  locale,
+}) => (
+  <html dir={getHTMLTextDir(locale)} locale={locale}>
+    <body>{children}</body>
+  </html>
+);
+```
+
+```jsx codeFormat="esm"
+import { getHTMLTextDir } from "intlayer";
+
+const HTMLLayout = ({ children, locale }) => (
+  <html dir={getHTMLTextDir(locale)} locale={locale}>
+    <body>{children}</body>
+  </html>
+);
+```
+
+```jsx codeFormat="commonjs"
+const { getHTMLTextDir } = require("intlayer");
+
+const HTMLLayout = ({ children, locale }) => (
+  <html dir={getHTMLTextDir(locale)} locale={locale}>
+    <body>{children}</body>
+  </html>
+);
+```
+
+Trong ví dụ trên, thuộc tính `dir` được thiết lập động dựa trên locale.

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

@@ -0,0 +1,81 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Tài liệu hàm getLocaleLang | intlayer
+description: Xem cách sử dụng hàm getLocaleLang cho gói intlayer
+keywords:
+  - getLocaleLang
+  - dịch thuật
+  - Intlayer
+  - intlayer
+  - Quốc tế hóa
+  - Tài liệu
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getLocaleLang
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Khởi tạo lịch sử
+---
+
+# Tài liệu: Hàm `getLocaleLang` trong `intlayer`
+
+## Mô tả
+
+Hàm `getLocaleLang` trích xuất mã ngôn ngữ từ chuỗi locale. Nó hỗ trợ các locale có hoặc không có mã quốc gia. Nếu không cung cấp locale, hàm sẽ trả về chuỗi rỗng.
+
+## Tham số
+
+- `locale?: Locales`
+  - **Mô tả**: Chuỗi locale (ví dụ: `Locales.ENGLISH_UNITED_STATES`, `Locales.FRENCH_CANADA`) từ đó mã ngôn ngữ được trích xuất.
+  - **Kiểu**: `Locales` (tùy chọn)
+
+## Giá trị trả về
+
+- **Kiểu**: `string`
+- **Mô tả**: Mã ngôn ngữ được trích xuất từ locale. Nếu không cung cấp locale, hàm trả về chuỗi rỗng (`''`).
+
+## Ví dụ sử dụng
+
+### Trích xuất mã ngôn ngữ:
+
+```typescript codeFormat="typescript"
+import { getLocaleLang, Locales } from "intlayer";
+
+getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Kết quả: "en"
+getLocaleLang(Locales.ENGLISH); // Kết quả: "en"
+getLocaleLang(Locales.FRENCH_CANADA); // Kết quả: "fr"
+getLocaleLang(Locales.FRENCH); // Kết quả: "fr"
+```
+
+```javascript codeFormat="esm"
+import { getLocaleLang } from "intlayer";
+
+getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Kết quả: "en"
+getLocaleLang(Locales.ENGLISH); // Kết quả: "en"
+getLocaleLang(Locales.FRENCH_CANADA); // Kết quả: "fr"
+getLocaleLang(Locales.FRENCH); // Kết quả: "fr"
+```
+
+```javascript codeFormat="commonjs"
+const { getLocaleLang } = require("intlayer");
+
+getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Kết quả: "en"
+getLocaleLang(Locales.ENGLISH); // Kết quả: "en"
+getLocaleLang(Locales.FRENCH_CANADA); // Kết quả: "fr"
+getLocaleLang(Locales.FRENCH); // Kết quả: "fr"
+```
+
+## Các trường hợp đặc biệt
+
+- **Không cung cấp Locale:**
+  - Hàm trả về chuỗi rỗng khi `locale` là `undefined`.
+
+- **Chuỗi Locale không đúng định dạng:**
+  - Nếu `locale` không theo định dạng `language-country` (ví dụ: `Locales.ENGLISH-US`), hàm sẽ trả về an toàn phần trước dấu `'-'` hoặc toàn bộ chuỗi nếu không có dấu `'-'`.

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

@@ -0,0 +1,129 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Tài liệu hàm getLocaleName | intlayer
+description: Xem cách sử dụng hàm getLocaleName cho gói intlayer
+keywords:
+  - getLocaleName
+  - dịch thuật
+  - Intlayer
+  - intlayer
+  - Quốc tế hóa
+  - Tài liệu
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getLocaleName
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Khởi tạo lịch sử
+---
+
+# Tài liệu: Hàm `getLocaleName` trong `intlayer`
+
+## Mô tả
+
+Hàm `getLocaleName` trả về tên địa phương hóa của một locale nhất định (`targetLocale`) trong locale hiển thị (`displayLocale`). Nếu không cung cấp `targetLocale`, hàm sẽ trả về tên của `displayLocale` bằng chính ngôn ngữ của nó.
+
+## Tham số
+
+- `displayLocale: Locales`
+  - **Mô tả**: Locale mà trong đó tên của locale đích sẽ được hiển thị.
+  - **Kiểu**: Enum hoặc chuỗi đại diện cho các locale hợp lệ.
+
+- `targetLocale?: Locales`
+  - **Mô tả**: Locale mà tên của nó sẽ được địa phương hóa.
+  - **Kiểu**: Tùy chọn. Enum hoặc chuỗi đại diện cho các locale hợp lệ.
+
+## Giá trị trả về
+
+- **Kiểu**: `string`
+- **Mô tả**: Tên đã được địa phương hóa của `targetLocale` trong `displayLocale`, hoặc tên của chính `displayLocale` nếu không cung cấp `targetLocale`. Nếu không tìm thấy bản dịch, nó trả về `"Unknown locale"`.
+
+## Ví dụ sử dụng
+
+```typescript codeFormat="typescript"
+import { Locales, getLocaleName } from "intlayer";
+
+getLocaleName(Locales.ENGLISH); // Output: "English"
+getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Kết quả: "Anglais"
+getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Kết quả: "Inglés"
+getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Kết quả: "English"
+
+getLocaleName(Locales.FRENCH); // Kết quả: "Français"
+getLocaleName(Locales.FRENCH, Locales.FRENCH); // Kết quả: "Français"
+getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Kết quả: "Francés"
+getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Kết quả: "French"
+
+getLocaleName(Locales.CHINESE); // Kết quả: "中文"
+getLocaleName(Locales.CHINESE, Locales.FRENCH); // Kết quả: "Chinois"
+getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Kết quả: "Chino"
+getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Kết quả: "Chinese"
+
+getLocaleName("unknown-locale"); // Kết quả: "Unknown locale"
+```
+
+```javascript codeFormat="esm"
+import { Locales, getLocaleName } from "intlayer";
+
+// Lấy tên ngôn ngữ theo locale mặc định (English)
+getLocaleName(Locales.ENGLISH); // Kết quả: "English"
+// Lấy tên ngôn ngữ English theo locale French
+getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Kết quả: "Anglais"
+// Lấy tên ngôn ngữ English theo locale Espanol
+getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Kết quả: "Inglés"
+// Lấy tên ngôn ngữ English theo locale English
+getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Kết quả: "English"
+
+// Lấy tên ngôn ngữ French theo locale mặc định (French)
+getLocaleName(Locales.FRENCH); // Kết quả: "Français"
+// Lấy tên ngôn ngữ French theo locale French
+getLocaleName(Locales.FRENCH, Locales.FRENCH); // Kết quả: "Français"
+// Lấy tên ngôn ngữ French theo locale Espanol
+getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Kết quả: "Francés"
+// Lấy tên ngôn ngữ French theo locale English
+getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Kết quả: "French"
+
+// Lấy tên ngôn ngữ Chinese theo locale mặc định (Chinese)
+getLocaleName(Locales.CHINESE); // Kết quả: "中文"
+// Lấy tên ngôn ngữ Chinese theo locale French
+getLocaleName(Locales.CHINESE, Locales.FRENCH); // Kết quả: "Chinois"
+// Lấy tên ngôn ngữ Chinese theo locale Espanol
+getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Kết quả: "Chino"
+getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Kết quả: "Chinese"
+
+getLocaleName("unknown-locale"); // Kết quả: "Unknown locale"
+```
+
+```javascript codeFormat="commonjs"
+const { Locales, getLocaleName } = require("intlayer");
+
+getLocaleName(Locales.ENGLISH); // Kết quả: "English"
+getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Kết quả: "Anglais"
+getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Kết quả: "Inglés"
+getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Kết quả: "English"
+
+getLocaleName(Locales.FRENCH); // Kết quả: "Français"
+getLocaleName(Locales.FRENCH, Locales.FRENCH); // Kết quả: "Français"
+getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Kết quả: "Francés"
+getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Kết quả: "French"
+
+getLocaleName(Locales.CHINESE); // Kết quả: "中文"
+getLocaleName(Locales.CHINESE, Locales.FRENCH); // Kết quả: "Chinois"
+getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Kết quả: "Chino"
+getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Kết quả: "Chinese"
+
+getLocaleName("unknown-locale"); // Kết quả: "Unknown locale"
+```
+
+## Các trường hợp đặc biệt
+
+- **Không cung cấp `targetLocale`:**
+  - Hàm mặc định trả về tên của chính `displayLocale`.
+- **Thiếu bản dịch:**
+  - Nếu `localeNameTranslations` không chứa mục cho `targetLocale` hoặc `displayLocale` cụ thể, hàm sẽ sử dụng lại `ownLocalesName` hoặc trả về `"Unknown locale"`.