@intlayer/docs 9.0.0-canary.5 → 9.0.0-canary.6

package/docs/uk/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Документація пакета react-native-intlayer
-description: Підтримка React Native для Intlayer, надає провайдери та поліфіли.
+description: Підтримка React Native для Intlayer, надає провайдери, хуки, поліфіли та конфігурацію Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Реекспорт повного API react-intlayer (хуки, утиліти, підшляхи format/html/markdown), щоб застосунок React Native залежав лише від react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Узагальнена документація для всіх експортів"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Пакет react-native-intlayer
 
-Пакет `react-native-intlayer` надає необхідні інструменти для інтеграції Intlayer у застосунки React Native. Він включає провайдер та поліфіли для підтримки локалі.
+Пакет `react-native-intlayer` надає необхідні інструменти для інтеграції Intlayer у застосунки React Native. Він реекспортує повний API `react-intlayer` (хуки та утиліти) з `IntlayerProvider`, адаптованим для React Native, а також поліфіли та конфігурацію Metro, необхідні для React Native.
+
+> У застосунку React Native імпортуйте **все** з `react-native-intlayer`. Встановлювати або імпортувати `react-intlayer` безпосередньо не потрібно.
 
 ## Встановлення
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Провайдер
 
-| Компонент          | Опис                                                                      |
-| ------------------ | ------------------------------------------------------------------------- |
-| `IntlayerProvider` | Компонент-провайдер, який обгортає ваш додаток і надає контекст Intlayer. |
+| Компонент          | Опис                                                                                                                 |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Компонент-провайдер, який обгортає ваш додаток і надає контекст Intlayer. Автоматично застосовує необхідні поліфіли. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Хуки та утиліти
+
+Вони реекспортуються з `react-intlayer`, тому ви можете імпортувати їх безпосередньо з `react-native-intlayer`:
 
-Імпорт:
+| Експорт                                                                                                           | Опис                                                |
+| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Доступ до локалізованого вмісту за ключем словника. |
+| `useLocale`                                                                                                       | Читання та зміна поточної локалі.                   |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Завантаження вмісту словника різними способами.     |
+| `useI18n`                                                                                                         | Хук, сумісний з i18next.                            |
+| `t`                                                                                                               | Допоміжна функція для вбудованого перекладу.        |
+| `getIntlayer`, `getDictionary`                                                                                    | Імперативні геттери контенту.                       |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Допоміжні функції для збереження локалі.            |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Поліфіл
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Функція, що застосовує необхідні поліфіли для React Native, щоб забезпечити підтримку Intlayer. |
 
-Імпорт:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Поліфіл застосовується автоматично при імпорті `IntlayerProvider`. Викликайте `intlayerPolyfill` вручну лише якщо вам потрібні поліфіли до монтування провайдера.
+
+### Форматери
+
+Хуки форматування чисел, дат та інші функції на базі Intl доступні з підшляху `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Markdown та HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Конфігурація Metro
@@ -66,8 +102,6 @@ import "react-native-intlayer";
 | `configMetroIntlayerSync` | Синхронна функція, яка об'єднує конфігурацію Metro без підготовки ресурсів Intlayer. |
 | `exclusionList`           | Створює патерн RegExp для blockList Metro, щоб виключати файли контенту з бандлу.    |
 
-Імпорт:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/vi/intlayer_with_react_native+expo.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-25
 title: "Expo + React Native i18n - Hướng dẫn đầy đủ để dịch ứng dụng của bạn"
 description: "Không còn i18next nữa. Hướng dẫn 2026 để xây dựng ứng dụng Expo + React Native đa ngôn ngữ (i18n). Dịch với các AI agent và tối ưu hóa kích thước bundle, SEO và hiệu suất."
 keywords:
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-react-native-template
 applicationShowcase: https://intlayer-react-native.vercel.app
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Nhập provider và hook trực tiếp từ react-native-intlayer; react-intlayer không còn cần thiết như một phụ thuộc trực tiếp"
   - version: 8.9.0
     date: 2026-05-04
     changes: "Cập nhật cách sử dụng API useIntlayer của Solid sang truy cập thuộc tính trực tiếp"
@@ -101,7 +104,7 @@ Việc kết nối các tệp JSON lớn với các thành phần có thể dẫ
 
 <Accordion header="Mở rộng quy mô không có nhà phát triển">
 
-Không chỉ là giải pháp i18n, Intlayer còn cung cấp **[trình chỉnh sửa trực quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** và **[CMS đầy đủ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** để giúp bạn quản lý nội dung đa ngôn ngữ của mình trong **thời gian thực**, giúp việc cộng tác với người dịch, người viết quảng cáo và các thành viên khác trong nhóm trở nên liền mạch. Nội dung có thể được lưu trữ cục bộ và/hoặc từ xa.
+Không chỉ là giải pháp i18n, Intlayer còn cung cấp **[trình chỉnh sửa trực quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** tự lưu trữ và **[CMS đầy đủ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** để giúp bạn quản lý nội dung đa ngôn ngữ của mình trong **thời gian thực**, giúp việc cộng tác với người dịch, người viết quảng cáo và các thành viên khác trong nhóm trở nên liền mạch. Nội dung có thể được lưu trữ cục bộ và/hoặc từ xa.
 
 </Accordion>
 
@@ -121,27 +124,39 @@ Xem [Mẫu ứng dụng](https://github.com/aymericzip/intlayer-react-native-tem
 Từ dự án React Native của bạn, hãy cài đặt các gói sau:
 
 ```bash packageManager="npm"
-npm cài đặt intlayer phản ứng-intlayer
-cài đặt npm --save-dev Reac -igen-intlayer
-init nội bộ npx
+npx intlayer-cli init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm thêm intlayer phản ứng-intlayer
-pnpm thêm --save-dev Reac -igen-intlayer
-init nội bộ pnpm
+pnpm dlx intlayer-cli init --interactive
 ```
 
-```bash packageManager="sợi"
-sợi thêm lớp trong Reac-inlayer
-thêm sợi --save-dev Reac -igen-intlayer
-init sợi bên trong
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
 ```
 
 ```bash packageManager="bun"
-bun thêm intlayer phản ứng-inlayer
-bun thêm --dev Reac -igen-intlayer
-init x init
+bunx intlayer-cli init --interactive
+```
+
+> Cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là AI agent.
+
+> Lệnh này sẽ tự động phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
+```bash packageManager="npm"
+npm install intlayer react-native-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer react-native-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer react-native-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer react-native-intlayer
 ```
 
 ### Các gói
@@ -149,17 +164,14 @@ init x init
 - **intlayer**  
   Bộ công cụ i18n cốt lõi dùng để cấu hình, nội dung từ điển, tạo kiểu, và các lệnh CLI.
 
-- **react-intlayer**  
-  Tích hợp React cung cấp các context provider và React hook mà bạn sẽ dùng trong React Native để lấy và chuyển đổi ngôn ngữ.
-
 - **react-native-intlayer**  
-  Tích hợp React Native cung cấp plugin Metro để tích hợp Intlayer với bundler của React Native.
+  Tích hợp React Native cung cấp các context provider và React hook mà bạn sẽ dùng để lấy và chuyển đổi ngôn ngữ, các polyfill cho React Native, và plugin Metro để tích hợp Intlayer với bundler của React Native. Nó tái xuất tất cả mọi thứ từ `react-intlayer`, vì vậy bạn chỉ cần gói duy nhất này trong một ứng dụng React Native.
 
 ---
 
 </Step>
 
-<Step number={3} title="Tạo cấu hình Intlayer">
+<Step number={2} title="Tạo cấu hình Intlayer">
 
 Trong thư mục gốc dự án của bạn (hoặc bất cứ nơi nào thuận tiện), tạo một file **cấu hình Intlayer**. Nó có thể trông như sau:
 
@@ -189,11 +201,11 @@ Trong cấu hình này, bạn có thể:
 - Cấu hình **danh sách các ngôn ngữ được hỗ trợ**.
 - Đặt một ngôn ngữ **mặc định**.
 - Sau này, bạn có thể thêm các tùy chọn nâng cao hơn (ví dụ: ghi log, thư mục nội dung tùy chỉnh, v.v.).
-- Xem thêm tại [tài liệu cấu hình Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md).
+- Xem thêm tại [tài liệu cấu hình Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md).
 
 </Step>
 
-<Step number={4} title="Thêm plugin Metro">
+<Step number={3} title="Thêm plugin Metro">
 
 Metro là một trình đóng gói (bundler) cho React Native. Đây là trình đóng gói mặc định cho các dự án React Native được tạo bằng lệnh `react-native init`. Để sử dụng Intlayer với Metro, bạn cần thêm plugin vào file `metro.config.js` của bạn:
 
@@ -213,11 +225,11 @@ module.exports = (async () => {
 
 </Step>
 
-<Step number={5} title="Thêm Intlayer provider">
+<Step number={4} title="Thêm Intlayer provider">
 
 Để giữ đồng bộ ngôn ngữ người dùng trên toàn bộ ứng dụng của bạn, bạn cần bao bọc component gốc của bạn với component `IntlayerProvider` từ `react-native-intlayer`.
 
-> Hãy chắc chắn sử dụng provider từ `react-native-intlayer` thay vì `react-intlayer`. Export từ `react-native-intlayer` bao gồm các polyfill cho web API.
+> Luôn nhập từ `react-native-intlayer`. `IntlayerProvider` của nó bao gồm các polyfill cho web API được sử dụng bởi Intlayer, và gói này tái xuất tất cả các hook và tiện ích từ `react-intlayer`.
 
 Ngoài ra, bạn cần thêm hàm `intlayerPolyfill` vào file `index.js` của bạn để đảm bảo Intlayer hoạt động đúng.
 
@@ -244,7 +256,7 @@ export default RootLayout;
 
 </Step>
 
-<Step number={6} title="Khai báo Nội dung của Bạn">
+<Step number={5} title="Khai báo Nội dung của Bạn">
 
 Tạo các tệp **khai báo nội dung** ở bất kỳ đâu trong dự án của bạn (thường là trong thư mục `src/`), sử dụng bất kỳ định dạng phần mở rộng nào mà Intlayer hỗ trợ:
 
@@ -315,7 +327,7 @@ export default homeScreenContent;
 
 </Step>
 
-<Step number={7} title="Sử dụng Intlayer trong các Component của bạn">
+<Step number={6} title="Sử dụng Intlayer trong các Component của bạn">
 
 Sử dụng hook `useIntlayer` trong các component con để lấy nội dung đã được bản địa hóa.
 
@@ -323,7 +335,7 @@ Sử dụng hook `useIntlayer` trong các component con để lấy nội dung
 
 ```tsx fileName="app/(tabs)/index.tsx" codeFormat={["typescript", "esm"]}
 import { Image, StyleSheet, Platform } from "react-native";
-import { useIntlayer } from "react-intlayer";
+import { useIntlayer } from "react-native-intlayer";
 import { HelloWave } from "@/components/HelloWave";
 import ParallaxScrollView from "@/components/ParallaxScrollView";
 import { ThemedText } from "@/components/ThemedText";
@@ -370,7 +382,7 @@ export default HomeScreen;
 
 </Step>
 
-<Step number={8} title="Thay đổi Ngôn ngữ Ứng dụng" isOptional={true}>
+<Step number={7} title="Thay đổi Ngôn ngữ Ứng dụng" isOptional={true}>
 
 Để chuyển đổi ngôn ngữ từ bên trong các component của bạn, bạn có thể sử dụng phương thức `setLocale` của hook `useLocale`:
 
@@ -378,7 +390,7 @@ export default HomeScreen;
 import { type FC } from "react";
 import { View, Text, TouchableOpacity, StyleSheet } from "react-native";
 import { getLocaleName } from "intlayer";
-import { useLocale } from "react.intlayer";
+import { useLocale } from "react-native-intlayer";
 
 export const LocaleSwitcher: FC = () => {
   const { setLocale, availableLocales } = useLocale();
@@ -421,7 +433,7 @@ const styles = StyleSheet.create({
 
 Điều này kích hoạt việc render lại tất cả các component sử dụng nội dung Intlayer, giờ đây hiển thị bản dịch cho locale mới.
 
-> Xem thêm tài liệu [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/react-intlayer/useLocale.md) để biết chi tiết.
+> Xem thêm tài liệu [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/packages/react-intlayer/useLocale.md) để biết chi tiết.
 
 </Step>
 
@@ -496,13 +508,12 @@ Intlayer chủ yếu hướng đến Web Intl API; trên React Native bạn ph
 
 Danh sách kiểm tra:
 
-- Sử dụng các phiên bản mới nhất của `intlayer`, `react-intlayer`, và `react-native-intlayer`.
+- Sử dụng các phiên bản mới nhất của `intlayer` và `react-native-intlayer`.
 - Kích hoạt polyfill của Intlayer.
 - Nếu bạn sử dụng `getLocaleName` hoặc các tiện ích dựa trên Intl-API khác, hãy nhập các polyfill này sớm (ví dụ trong `index.js` hoặc `App.tsx`):
 
 ```ts
 import "intl";
-// Nhập polyfill để hỗ trợ các tính năng Intl khác nhau
 import "@formatjs/intl-getcanonicallocales/polyfill";
 import "@formatjs/intl-locale/polyfill";
 import "@formatjs/intl-pluralrules/polyfill";

package/docs/vi/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Tài liệu gói react-native-intlayer
-description: Hỗ trợ React Native cho Intlayer, cung cấp provider và các polyfill.
+description: Hỗ trợ React Native cho Intlayer, cung cấp provider, hook, polyfill và cấu hình Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Tái xuất toàn bộ API react-intlayer (hook, tiện ích, các subpath format/html/markdown) để ứng dụng React Native chỉ cần phụ thuộc vào react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Hợp nhất tài liệu cho tất cả các exports"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Gói react-native-intlayer
 
-Gói `react-native-intlayer` cung cấp các công cụ cần thiết để tích hợp Intlayer vào các ứng dụng React Native. Nó bao gồm một provider và các polyfill để hỗ trợ locale.
+Gói `react-native-intlayer` cung cấp các công cụ cần thiết để tích hợp Intlayer vào các ứng dụng React Native. Nó tái xuất toàn bộ API `react-intlayer` (hook và tiện ích) với `IntlayerProvider` sẵn sàng cho React Native, cùng các polyfill và cấu hình Metro mà React Native yêu cầu.
+
+> Trong một ứng dụng React Native, hãy nhập **tất cả mọi thứ** từ `react-native-intlayer`. Bạn không cần cài đặt hoặc nhập `react-intlayer` trực tiếp.
 
 ## Cài đặt
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Provider
 
-| Thành phần         | Mô tả                                                                     |
-| ------------------ | ------------------------------------------------------------------------- |
-| `IntlayerProvider` | Component Provider bọc ứng dụng của bạn và cung cấp context của Intlayer. |
+| Thành phần         | Mô tả                                                                                                             |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Component Provider bọc ứng dụng của bạn và cung cấp context của Intlayer. Tự động áp dụng các polyfill cần thiết. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Hook và tiện ích
+
+Các mục này được tái xuất từ `react-intlayer`, vì vậy bạn có thể nhập chúng trực tiếp từ `react-native-intlayer`:
 
-Nhập:
+| Export                                                                                                            | Mô tả                                                  |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `useIntlayer`                                                                                                     | Truy cập nội dung đã bản địa hóa cho một khóa từ điển. |
+| `useLocale`                                                                                                       | Đọc và thay đổi locale hiện tại.                       |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Tải nội dung từ điển theo nhiều cách khác nhau.        |
+| `useI18n`                                                                                                         | Hook tương thích với i18next.                          |
+| `t`                                                                                                               | Trợ lý dịch inline.                                    |
+| `getIntlayer`, `getDictionary`                                                                                    | Các hàm lấy nội dung theo kiểu mệnh lệnh.              |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Các trợ lý lưu trữ locale.                             |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Polyfill
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------- |
 | `intlayerPolyfill` | Hàm áp dụng các polyfill cần thiết cho React Native để hỗ trợ Intlayer. |
 
-Nhập:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Polyfill được áp dụng tự động khi bạn nhập `IntlayerProvider`. Chỉ gọi `intlayerPolyfill` thủ công nếu bạn cần các polyfill trước khi provider được mount.
+
+### Bộ định dạng (Formatters)
+
+Các hook định dạng số, ngày tháng và các hook dựa trên Intl khác có sẵn từ subpath `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Markdown và HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Cấu hình Metro
@@ -66,8 +102,6 @@ Gói `react-native-intlayer` cung cấp các tiện ích cấu hình Metro để
 | `configMetroIntlayerSync` | Hàm đồng bộ hợp nhất cấu hình Metro mà không chuẩn bị tài nguyên của Intlayer.             |
 | `exclusionList`           | Tạo một biểu thức RegExp cho blockList của Metro để loại trừ các tệp nội dung khỏi bundle. |
 
-Import:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```