@intlayer/docs 9.5.7 → 9.5.9-canary.0

package/docs/uk/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Оновлення пакетів Intlayer
+description: Дізнайтеся, як використовувати команду upgrade в Intlayer CLI, щоб отримати список усіх пакетів Intlayer вашого проєкту або монорепозиторію та оновити їх до останньої версії.
+keywords:
+  - CLI
+  - Upgrade
+  - Оновлення
+  - Пакети
+  - Монорепозиторій
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Додати команду upgrade"
+author: aymericzip
+---
+
+# Оновлення пакетів Intlayer
+
+```bash packageManager="npm"
+npx intlayer upgrade
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade
+```
+
+Команда `upgrade` виводить список пакетів Intlayer, оголошених у кожному `package.json` вашого проєкту, включно з робочими просторами (workspaces) монорепозиторію, та оновлює їх до останньої опублікованої версії. Вона автономно виконує той самий крок оновлення пакетів, що й `intlayer init`.
+
+## Аргументи:
+
+- `--project-root [projectRoot]` - Необов'язково. Кореневий каталог проєкту. За замовчуванням команда починає з найближчого `package.json` вище поточного робочого каталогу.
+- `--dry-run` - Необов'язково. Виводить список пакетів та їхніх цільових версій без зміни будь-яких файлів.
+- `--tag <tag>` - Необов'язково. npm dist-tag для оновлення (наприклад, `canary`). За замовчуванням `latest`.
+
+## Що вона робить:
+
+1. **Складає список пакетів Intlayer** - Сканує кожен `package.json` проєкту (пропускаючи `node_modules` та результати збірки) на наявність залежностей і devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` та `intlayer-*`.
+2. **Отримує цільову версію** - Зчитує версію обраного dist-tag (за замовчуванням `latest`) кожного пакета з реєстру npm.
+3. **Переписує діапазони версій** - Оновлює кожен застарілий діапазон безпосередньо у файлі, зберігаючи його оператор (`^`, `~` або без оператора) та форматування відступів.
+4. **Встановлює за один раз** - Виконує єдине встановлення з кореня робочого простору (найближчого каталогу з lock-файлом), використовуючи менеджер пакетів, якому належить lock-файл:
+
+| Lock-файл                     | Команда        |
+| ----------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`      | `bun install`  |
+| `pnpm-lock.yaml`              | `pnpm install` |
+| `yarn.lock`                   | `yarn install` |
+| `package-lock.json` або немає | `npm install`  |
+
+Якщо lock-файлу немає, використовується поле `packageManager` з `package.json` (наприклад, `"bun@1.2.0"`), перш ніж перейти до npm.
+
+Діапазони, які не вказують на реєстр, такі як `workspace:*`, `file:`, `link:`, `catalog:` або URL-адреси git, ніколи не змінюються.
+
+## Приклади:
+
+### Показати список доступних оновлень без їх застосування:
+
+```bash packageManager="npm"
+npx intlayer upgrade --dry-run
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --dry-run
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --dry-run
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --dry-run
+```
+
+### Оновити до релізу canary:
+
+```bash packageManager="npm"
+npx intlayer upgrade --tag canary
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --tag canary
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --tag canary
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --tag canary
+```
+
+## Приклад виводу:
+
+```bash
+npx intlayer upgrade
+Intlayer packages:
+  package.json
+    intlayer ^9.0.0 → ^9.5.7
+  apps/web/package.json
+    next-intlayer ^9.5.7 (latest)
+    vite-intlayer ~9.2.0 → ~9.5.7
+Running bun install...
+✓ Upgraded 2 Intlayer dependencies to latest
+```
+
+## Примітки:
+
+- Запустіть команду з кореня вашого репозиторію, щоб оновити всі робочі простори. Запустіть її з конкретного робочого простору, щоб оновити лише його.
+- Пакети, версію яких неможливо отримати (офлайн, приватний або неопублікований пакет), додаються до списку та залишаються без змін.
+- Якщо встановлення не вдалося, оновлені діапазони зберігаються в `package.json`. Запустіть команду встановлення вашого менеджера пакетів вручну.

package/docs/vi/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Giải pháp i18n tốt nhất cho Next.js năm 2026 - Báo cáo Benchmark
 description: So sánh các thư viện quốc tế hóa (i18n) cho Next.js như next-intl, next-i18next và Intlayer. Báo cáo hiệu năng chi tiết về kích thước bundle bundle, rò rỉ dữ liệu và tính phản ứng.
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "Cập nhật kết quả benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Cập nhật kết quả benchmark"
@@ -213,7 +216,7 @@ Cuối cùng, so với các giải pháp khác, Paraglide không sử dụng sto
 
 **(Tolgee)** (`@tolgee/react@7.2.0`):
 
-`Tolgee` giải quyết được nhiều vấn đề đã đề cập trước đó. Tôi thấy việc áp dụng nó khó hơn so với các công cụ tương tự. Nó không cung cấp tính an toàn kiểu dữ liệu (type safety), điều này cũng khiến việc phát hiện các khóa bị thiếu tại thời điểm biên dịch trở nên khó khăn hơn. Tôi đã phải bao bọc các hàm của Tolgee bằng các hàm của riêng mình để thêm tính năng phát hiện khóa bị thiếu.
+`Tolgee` giải quyết được nhiều vấn đề đã đề cập trước đó. Tôi thấy việc áp dụng nó khó hơn so với các công cụ tương tự. Nó không cung cấp tính an toàn kiểu dữ liệu (type safety), điều này cũng khiến việc phát hiện các khóa bị thiếu tại thời điểm biên dịch trở nên khó khăn hơn. Tôi đã phải bao bọc các hàm của Tolgee bằng các hàm của riêng mình để thêm tính năng phát hiện khóa bị thiếu. Gói này cũng tương đối nặng (~14.3kb, gấp khoảng 2.8 lần `next-intlayer`).
 
 **(Next Intl)** (`next-intl@4.14.2`):
 
@@ -239,7 +242,7 @@ Các định dạng thông báo cũng khác nhau: `next-intl` sử dụng ICU Me
 
 `next-translate` là khuyến nghị chính của tôi nếu bạn thích một API theo kiểu `t()`. Nó vận hành thanh thoát thông qua `next-translate-plugin`, tải các namespace qua `getStaticProps` với một trình tải Webpack / Turbopack. Nó cũng là một trong những tùy chọn nhẹ nhất ở đây (~3.5kb). Đối với việc phân namespace, việc định nghĩa các namespace theo từng trang hoặc route trong cấu hình được cân nhắc kỹ lưỡng và dễ bảo trì hơn so với các lựa chọn thay thế chính như **next-intl** hay **next-i18next**. Ở phiên bản `3.1.2`, tôi nhận thấy rằng việc render tĩnh không hoạt động; Next.js đã quay trở lại việc render động.
 
-**(Intlayer)** (`next-intlayer@9.5.1`):
+**(Intlayer)** (`next-intlayer@9.5.6`):
 
 Tôi sẽ không đích thân đánh giá `next-intlayer` vì tính khách quan, vì đây là giải pháp của riêng tôi.
 

package/docs/vi/benchmark/solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Giải pháp i18n tốt nhất cho Solid năm 2026 - Báo cáo Benchmark
-description: So sánh các thư viện quốc tế hóa (i18n) Solid như solid-primitives, solid-i18next và Intlayer. Báo cáo hiệu suất chi tiết về kích thước bundle, rò rỉ và tính phản ứng.
+description: So sánh các thư viện quốc tế hóa (i18n) Solid như solid-primitives, solid-i18next, Tolgee và Intlayer. Báo cáo hiệu suất chi tiết về kích thước bundle, rò rỉ và tính phản ứng.
 keywords:
   - benchmark
   - i18n
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "Cập nhật kết quả benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Cập nhật kết quả benchmark"
@@ -68,6 +71,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 - **Intlayer**: Lựa chọn được đề xuất cho các ứng dụng Solid chuyên nghiệp cần các tính năng nâng cao và tối ưu hóa (v9.5.6).
 - **@solid-primitives/i18n**: Giải pháp thay thế gọn nhẹ tuyệt vời cho các dự án đơn giản, mặc dù thiếu các tính năng nâng cao như lazy loading.
 - **solid-i18next**: Tùy chọn tiêu chuẩn nhưng nặng (~3.5 lần Intlayer) với các nhược điểm tương tự như React i18next.
+- **Tolgee**: Nền tảng dịch thuật giàu tính năng, nhưng khá nặng (~12.7kb, gấp khoảng 3.0 lần Intlayer), thiếu các primitive Solid chuyên dụng (dựa vào @tolgee/web), và trong cấu hình tĩnh có thể rò rỉ bản dịch giữa các trang (90% rò rỉ trang).
 - **Paraglide**: Cách tiếp cận sáng tạo nhưng DX phức tạp và vấn đề tree-shaking trong một số thiết lập.
 
 ## Kiểm tra ứng dụng của bạn
@@ -103,6 +107,7 @@ Các cú pháp được xây dựng xung quanh `t('a.b.c')` rất tiện lợi n
 - [`solid-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/solid-intlayer/exports.md) (v9.5.6)
 - [`@solid-primitives/i18n`](https://github.com/solidjs-community/solid-primitives/tree/main/packages/i18n) (v2.2.1)
 - [`i18next`](https://github.com/i18next/i18next) (v26.0.8) + [`@mbarzda/solid-i18next`](https://github.com/mbarzda/solid-i18next) (v1.4.1)
+- [`@tolgee/web`](https://github.com/tolgee/tolgee-js) (v7.2.0)
 - [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 Framework là `Solid` với một ứng dụng đa ngôn ngữ gồm **10 trang** và **10 ngôn ngữ**.
@@ -147,7 +152,7 @@ Tôi chạy cùng một ứng dụng đa ngôn ngữ trong trình duyệt thực
 
 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.
 
-[![Star History Chart](https://api.star-history.com/chart?repos=solidjs-community%2Fsolid-primitives%2Cmbarzda%2Fsolid-i18next%2Copral%2Fparaglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#solidjs-community/solid-primitives&mbarzda/solid-i18next&opral/paraglide-js&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=solidjs-community%2Fsolid-primitives%2Cmbarzda%2Fsolid-i18next%2Copral%2Fparaglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#solidjs-community/solid-primitives&mbarzda/solid-i18next&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
 
 ## Kết quả chi tiết
 
@@ -170,6 +175,18 @@ Tuy nhiên, nó có cùng những nhược điểm chính như các stack đư
 Solid primitive cực kỳ nhẹ và hiệu quả. Tôi khuyên dùng giải pháp đó cho các dự án nhẹ, nhưng nó có thể nhanh chóng thiếu các tính năng cho các giải pháp chuyên nghiệp bao gồm quản lý cookie, chuyển hướng proxy, formatter, v.v.
 Nó cũng thiếu lazy loading và scoping namespace để tối ưu hóa kích thước trang.
 
+**(Tolgee)** (`@tolgee/web@7.2.0`):
+
+`Tolgee` cung cấp một nền tảng quản lý bản dịch toàn diện với các tính năng chỉnh sửa in-context.
+
+Trên Solid, hiện tại không có adapter chính thức chuyên dụng (như `@tolgee/solid`), đòi hỏi các nhà phát triển phải tích hợp qua `@tolgee/web` với các signal tùy chỉnh.
+
+Gói này tương đối nặng (~12.7kb, gấp khoảng 3.0 lần `solid-intlayer`).
+
+Nếu không có cơ chế chia nhỏ theo từng trang trong Solid, tất cả các bản dịch sẽ được tải vào bộ nhớ ngay từ đầu trong cấu hình tĩnh. Điều này dẫn đến tình trạng rò rỉ bundle nghiêm trọng (44.5% rò rỉ ngôn ngữ, 90.0% rò rỉ trang) và kích thước bundle trung bình mỗi trang là ~91.8kb (so với ~35.8kb của Intlayer).
+
+Khả năng phản ứng khi chuyển đổi ngôn ngữ rất nhanh (0.6ms), phù hợp với tính phản ứng chi tiết của Solid, mặc dù chi phí hydration cao hơn một chút (~5.6ms so với ~3.0ms của Intlayer).
+
 **(Paraglide)** (`@inlang/paraglide-js@2.25.1`):
 
 `Paraglide` đưa ra một cách tiếp cận sáng tạo, được cân nhắc kỹ lưỡng. Mặc dù vậy, trong benchmark này, tree-shaking mà công ty họ quảng cáo đã không hoạt động cho triển khai của tôi. Workflow và DX cũng phức tạp hơn các tùy chọn khác.
@@ -178,7 +195,7 @@ Cuối cùng, so với các giải pháp khác, Paraglide không sử dụng sto
 
 ### 3 - Khuyến nghị
 
-**(Intlayer)** (`solid-intlayer@9.5.0`):
+**(Intlayer)** (`solid-intlayer@9.5.6`):
 
 Tôi sẽ không đích thân đánh giá `solid-intlayer` vì tính khách quan, vì đó là giải pháp của chính tôi.
 

package/docs/vi/benchmark/svelte.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Giải pháp i18n tốt nhất cho Svelte năm 2026 - Báo cáo Benchmark
-description: So sánh các thư viện quốc tế hóa (i18n) Svelte như svelte-i18n, Paraglide và Intlayer. Báo cáo hiệu suất chi tiết về kích thước bundle, rò rỉ và tính phản ứng.
+description: So sánh các thư viện quốc tế hóa (i18n) Svelte như svelte-i18n, Paraglide, Tolgee và Intlayer. Báo cáo hiệu suất chi tiết về kích thước bundle, rò rỉ và tính phản ứng.
 keywords:
   - benchmark
   - i18n
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "Update benchmark results"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Cập nhật kết quả benchmark"
@@ -67,6 +70,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 
 - **Intlayer**: Lựa chọn hiệu quả nhất về hiệu suất (v9.5.6) với dấu chân (footprint) nhỏ nhất.
 - **Paraglide**: Đối thủ nặng ký cho tree-shaking nhưng có trải nghiệm nhà phát triển phức tạp hơn và overhead về tính phản ứng.
+- **Tolgee**: Nền tảng dịch thuật giàu tính năng với khả năng chỉnh sửa in-context, nhưng khá nặng (~13.0kb, gấp khoảng 3.6 lần Intlayer), và trong cấu hình tĩnh gây rò rỉ bản dịch đáng kể giữa các trang (90% rò rỉ trang).
 - **svelte-i18n**: Toàn diện và tiêu chuẩn cho Svelte, nhưng mang trọng lượng bundle lớn hơn nhiều (~4.5 lần Intlayer).
 
 ## Kiểm tra ứng dụng của bạn
@@ -101,6 +105,7 @@ Các cú pháp được xây dựng xung quanh `t('a.b.c')` rất tiện lợi n
 - `Base App` (Không có thư viện i18n)
 - [`svelte-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/svelte-intlayer/exports.md) (v9.5.6)
 - [`svelte-i18n`](https://github.com/kaisermann/svelte-i18n) (v4.0.1)
+- [`@tolgee/svelte`](https://github.com/tolgee/tolgee-js) (v7.2.1)
 - [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 Framework là `Svelte` với một ứng dụng đa ngôn ngữ gồm **10 trang** và **10 ngôn ngữ**.
@@ -145,7 +150,7 @@ Tôi đã chạy cùng một ứng dụng đa ngôn ngữ trong trình duyệt t
 
 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.
 
-[![Star History Chart](https://api.star-history.com/chart?repos=kaisermann%2Fsvelte-i18n%2Copral%2Fparaglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#kaisermann/svelte-i18n&opral/paraglide-js&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=kaisermann%2Fsvelte-i18n%2Copral%2Fparaglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#kaisermann/svelte-i18n&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
 
 ## Kết quả chi tiết
 
@@ -165,6 +170,16 @@ Cuối cùng, so với các giải pháp khác, Paraglide không sử dụng sto
 
 > Lưu ý về paraglide: giải pháp này đưa mã vào mã nguồn của bạn cho các import; do đó, chỉ số 'lib size' trong báo cáo benchmark gần như bằng 0. Việc tạo mã (Code generation) là một điều tốt, bởi vì hàm được sử dụng sẽ chỉ bao gồm logic cần thiết (prefix ở mọi nơi so với không prefix, cookie so với storage, v.v.). So với đó, Intlayer thực hiện việc lọc này thông qua việc đưa biến môi trường vào build để buộc bundler thực hiện tree-shaking nội dung tùy thuộc vào logic. Nhờ đó, paraglide và intlayer cuối cùng là các giải pháp nhẹ hơn từ 6 đến 10 lần so với i18next hoặc next-intl.
 
+**(Tolgee)** (`@tolgee/svelte@7.2.1`):
+
+`Tolgee` cung cấp một nền tảng bản địa hóa toàn diện với tính năng chỉnh sửa in-context và tích hợp chính thức cho Svelte thông qua `@tolgee/svelte`.
+
+Gói này tương đối nặng (~13.0kb, gấp khoảng 3.6 lần `svelte-intlayer`).
+
+Nếu không có cơ chế chia nhỏ theo từng trang trong Svelte, tất cả các bản dịch sẽ được tải vào bộ nhớ ngay từ đầu trong cấu hình tĩnh. Điều này gây ra hiện tượng rò rỉ bundle đáng kể (50.0% rò rỉ ngôn ngữ, 90.0% rò rỉ trang) và kích thước bundle trung bình mỗi trang là ~100.7kb (so với ~59.0kb của Intlayer).
+
+Khả năng phản ứng khi chuyển đổi ngôn ngữ rất nhanh (0.5ms), được hưởng lợi từ các store phản ứng của Svelte, mặc dù chi phí hydration cao hơn một chút (~6.2ms so với ~5.5ms của Intlayer).
+
 **(svelte-i18n)** (`svelte-i18n@4.0.1`):
 
 Giải pháp này đáp ứng tất cả các nhu cầu i18n trong một dự án Svelte. Nhưng giống như trường hợp của i18next hoặc các giải pháp i18n lớn khác, nó hơi nặng (~16.6kb, gấp khoảng 4.5 lần `svelte-intlayer`).

package/docs/vi/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Giải pháp i18n tốt nhất cho TanStack Start năm 2026 - Báo cáo Benchmark
 description: So sánh các thư viện quốc tế hóa cho TanStack Start như react-i18next, use-intl và Intlayer. Báo cáo hiệu năng chi tiết về kích thước bundle bundle, rò rỉ dữ liệu và tính phản ứng.
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "Cập nhật kết quả benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Cập nhật kết quả benchmark"
@@ -200,7 +203,7 @@ Các vấn đề gặp phải:
 
 `Tolgee` giải quyết được nhiều vấn đề đã đề cập trước đó. Tôi thấy việc bắt đầu với Tolgee khó khăn hơn so với các công cụ khác có phương pháp tiếp cận tương tự. Nó không cung cấp tính an toàn kiểu dữ liệu, điều này cũng khiến việc phát hiện các khóa bị thiếu tại thời điểm biên dịch trở nên khó khăn hơn nhiều. Tôi đã phải bao bọc các API của Tolgee bằng các API của riêng mình để thêm tính năng phát hiện khóa bị thiếu.
 
-Package này khá nặng (~11.1kb, gấp hơn 2× `react-intlayer`).
+Package này khá nặng (~13.8 kb, gấp hơn 2.9× `react-intlayer`).
 
 Trên TanStack Start, tôi cũng gặp vấn đề về tính phản ứng: khi ngôn ngữ thay đổi, tôi phải ép buộc provider render lại và đăng ký vào các sự kiện thay đổi ngôn ngữ để việc tải ở một ngôn ngữ khác hoạt động chính xác.
 
@@ -234,7 +237,7 @@ Package cũng khá nặng (~15.3kb, tức là khoảng 3× `react-intlayer`).
 
 Benchmark TanStack Start này không có đối trọng trực tiếp cho `next-translate` (Next.js plugin + `getStaticProps`). Đối với các nhóm thực sự muốn một API `t()` với một hệ sinh thái chín muồi, `react-i18next` và `use-intl` vẫn là những lựa chọn "hợp lý", nhưng hãy chuẩn bị đầu tư nhiều thời gian tối ưu hóa để tránh rò rỉ.
 
-**(Intlayer)** (`react-intlayer@9.5.1`):
+**(Intlayer)** (`react-intlayer@9.5.6`):
 
 Tôi sẽ không đích thân đánh giá `react-intlayer` vì tính khách quan, vì đây là giải pháp của riêng tôi.
 

package/docs/vi/benchmark/vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Giải pháp i18n tốt nhất cho Vue năm 2026 - Báo cáo Benchmark
-description: So sánh các thư viện quốc tế hóa (i18n) Vue như vue-i18n, fluent-vue và Intlayer. Báo cáo hiệu suất chi tiết về kích thước bundle, rò rỉ và tính phản ứng.
+description: So sánh các thư viện quốc tế hóa (i18n) Vue như vue-i18n, fluent-vue, Tolgee và Intlayer. Báo cáo hiệu suất chi tiết về kích thước bundle, rò rỉ và tính phản ứng.
 keywords:
   - benchmark
   - i18n
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "Cập nhật kết quả benchmark và thêm Tolgee"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Cập nhật kết quả benchmark"
@@ -66,6 +69,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 ## TL;DR
 
 - **Intlayer**: Giải pháp nhẹ nhất (v9.5.6) với tính năng scoping và tải động gốc.
+- **Tolgee**: Tải động hiệu quả mà không bị rò rỉ trong chế độ động, nhưng nặng hơn (~3.7× Intlayer) và thiếu tính an toàn kiểu dữ liệu lúc biên dịch.
 - **vue-i18n**: Tiêu chuẩn ngành với hệ sinh thái phong phú, nhưng có thể trở nên nặng hơn đáng kể và khó tối ưu hóa cho code-splitting trong các ứng dụng lớn.
 - **fluent-vue**: Tổ chức thông báo sáng tạo nhưng thiếu an toàn kiểu (type-safety) và hóa ra là một giải pháp cực kỳ nặng.
 
@@ -103,6 +107,7 @@ Các cú pháp được xây dựng xung quanh `const { t } = useI18n()` + `t('a
 - [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compat/vue-i18n.md) (v9.5.6)
 - [`vue-i18n`](https://github.com/intlify/vue-i18n) (v11.4.0)
 - [`fluent-vue`](https://github.com/fluent-vue/fluent-vue) (v3.8.2)
+- [`@tolgee/vue`](https://github.com/tolgee/tolgee-js) (v7.2.0)
 
 Framework là `Vue` với một ứng dụng đa ngôn ngữ gồm **10 trang** và **10 ngôn ngữ**.
 
@@ -146,7 +151,7 @@ Tôi đã chạy cùng một ứng dụng đa ngôn ngữ trong một trình duy
 
 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.
 
-[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&tolgee/tolgee-js&aymericzip/intlayer)
 
 ## Kết quả chi tiết
 
@@ -156,18 +161,22 @@ Sao GitHub là một chỉ số mạnh mẽ về mức độ phổ biến của
 
 ### 2 - Các giải pháp chấp nhận được
 
+**(Tolgee)** (`@tolgee/vue@7.2.0`):
+
+`Tolgee` giải quyết nhiều vấn đề đã đề cập trước đó, cung cấp khả năng tải động giúp loại bỏ thành công rò rỉ ngôn ngữ và trang (giảm dung lượng JS của trang xuống còn khoảng 58.8kb). Tuy nhiên, nó không cung cấp tính an toàn kiểu dữ liệu lúc biên dịch cho các khóa, khiến việc phát hiện các khóa bị thiếu trở nên khó khăn hơn. Ngoài ra, kích thước thư viện tương đối nặng (~13.8kb, gấp khoảng 3.7 lần `vue-intlayer`).
+
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
 - **vue-i18n** chắc chắn là thư viện i18n được sử dụng nhiều nhất cho Vue, nó có rất nhiều tính năng và một hệ sinh thái khổng lồ. Nhưng thực tế giải pháp này khá nặng. Ngay cả khi vue-i18n tích hợp lazy loading cho các tin nhắn, nó vẫn thiếu tính năng scoping. Trong trường hợp ứng dụng Vue SPA cổ điển thì không có vấn đề gì, nhưng đối với ứng dụng Nuxt, sử dụng @nuxt/i18n, nó dẫn đến việc bao gồm tin nhắn từ tất cả các trang vào một trang duy nhất. Đối với một ứng dụng Nuxt lớn bao gồm hơn 10 trang, nó có thể trở nên thực sự rắc rối.
 
-Package này rất nặng (~24.3kb, gấp khoảng 6 lần `vue-intlayer`).
+Package này rất nặng (~24.1 kb, gấp khoảng 6.5 lần `vue-intlayer`).
 
 **(fluent-vue)** (`fluent-vue@3.8.2`):
 
-- **fluent-vue** đưa ra một nỗ lực đổi mới thông qua định dạng .ftl. Tổ chức tin nhắn tuyệt vời, dễ dàng bắt đầu hơn. Nhưng trong thực tế, việc thiếu an toàn kiểu làm tăng rủi ro lỗi và có thể nhanh chóng trở nên tốn thời gian để debug. Hơn nữa, giải pháp đó tải các tin nhắn bằng một plugin vite bắt buộc tải tất cả nội dung ở tất cả các ngôn ngữ vào mỗi trang. Ngoài ra, đây là một giải pháp cực kỳ nặng (~29.7kb, gấp khoảng 7.5 lần `vue-intlayer`).
+- **fluent-vue** đưa ra một nỗ lực đổi mới thông qua định dạng .ftl. Tổ chức tin nhắn tuyệt vời, dễ dàng bắt đầu hơn. Nhưng trong thực tế, việc thiếu an toàn kiểu làm tăng rủi ro lỗi và có thể nhanh chóng trở nên tốn thời gian để debug. Hơn nữa, giải pháp đó tải các tin nhắn bằng một plugin vite bắt buộc tải tất cả nội dung ở tất cả các ngôn ngữ vào mỗi trang. Ngoài ra, đây là một giải pháp cực kỳ nặng (~29.7kb, gấp khoảng 8 lần `vue-intlayer`).
 
 ### 3 - Khuyến nghị
 
-**(Intlayer)** (`vue-intlayer@9.5.0`):
+**(Intlayer)** (`vue-intlayer@9.5.6`):
 
 Tôi sẽ không đích thân đánh giá `vue-intlayer` vì tính khách quan, vì đó là giải pháp của chính tôi.

package/docs/vi/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-21
+updatedAt: 2026-09-23
 title: CLI - Tất cả các lệnh CLI của Intlayer cho trang web đa ngôn ngữ của bạn
 description: Tìm hiểu cách sử dụng Intlayer CLI để quản lý trang web đa ngôn ngữ của bạn. Làm theo các bước trong tài liệu trực tuyến này để thiết lập dự án của bạn trong vài phút.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Thêm lệnh upgrade"
   - version: 9.5.6
     date: 2026-09-21
     changes: "Thêm lệnh init infra"
@@ -155,6 +158,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 
 - **[Khởi tạo Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/init.md)** - Thiết lập Intlayer trong dự án của bạn với cấu hình tự động
 - **[Thiết lập cơ sở hạ tầng](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/infra.md)** - Cài đặt ứng dụng máy tính để bàn hoặc tự lưu trữ CMS với Docker (tất cả trong một hoặc Compose)
+- **[Nâng cấp các gói Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/upgrade.md)** - Liệt kê các gói Intlayer trong mỗi `package.json` và nâng cấp chúng lên phiên bản mới nhất
 - **[Quản lý cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/configuration.md)** - Nhận cấu hình Intlayer của bạn và đẩy lên CMS
 
 ### Quản lý tài liệu
@@ -182,6 +186,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 "scripts": {
   "intlayer:init": "npx intlayer init",
   "intlayer:infra": "npx intlayer init infra",
+  "intlayer:upgrade": "npx intlayer upgrade",
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",

package/docs/vi/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Nâng cấp các gói Intlayer
+description: Tìm hiểu cách sử dụng lệnh upgrade của Intlayer CLI để liệt kê từng gói Intlayer trong dự án hoặc monorepo của bạn và nâng cấp chúng lên phiên bản mới nhất.
+keywords:
+  - CLI
+  - Upgrade
+  - Nâng cấp
+  - Gói
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Thêm lệnh upgrade"
+author: aymericzip
+---
+
+# Nâng cấp các gói Intlayer
+
+```bash packageManager="npm"
+npx intlayer upgrade
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade
+```
+
+Lệnh `upgrade` liệt kê các gói Intlayer được khai báo trong mỗi `package.json` của dự án, bao gồm cả các workspace monorepo, và nâng cấp chúng lên phiên bản mới nhất đã xuất bản. Lệnh này chạy bước nâng cấp gói tương tự như `intlayer init` một cách độc lập.
+
+## Đối số:
+
+- `--project-root [projectRoot]` - Tùy chọn. Thư mục gốc của dự án. Theo mặc định, lệnh bắt đầu từ `package.json` gần nhất phía trên thư mục làm việc hiện tại.
+- `--dry-run` - Tùy chọn. Liệt kê các gói và phiên bản mục tiêu của chúng mà không sửa đổi bất kỳ tệp nào.
+- `--tag <tag>` - Tùy chọn. npm dist-tag cần nâng cấp lên (ví dụ `canary`). Mặc định là `latest`.
+
+## Chức năng hoạt động:
+
+1. **Liệt kê các gói Intlayer** - Quét từng `package.json` của dự án (bỏ qua `node_modules` và kết quả bản dựng) để tìm các phụ thuộc và devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` và `intlayer-*`.
+2. **Lấy phiên bản mục tiêu** - Đọc phiên bản của dist-tag đã chọn (mặc định là `latest`) của từng gói từ npm registry.
+3. **Viết lại dải phiên bản** - Cập nhật trực tiếp từng dải phiên bản đã lỗi thời trong tệp, giữ nguyên toán tử (`^`, `~` hoặc không có) và thụt lề của tệp.
+4. **Cài đặt một lần** - Chạy một lượt cài đặt duy nhất từ thư mục gốc của workspace (thư mục gần nhất có tệp khóa), sử dụng trình quản lý gói sở hữu tệp khóa đó:
+
+| Tệp khóa (Lock file)           | Lệnh           |
+| ------------------------------ | -------------- |
+| `bun.lock` / `bun.lockb`       | `bun install`  |
+| `pnpm-lock.yaml`               | `pnpm install` |
+| `yarn.lock`                    | `yarn install` |
+| `package-lock.json` hoặc không | `npm install`  |
+
+Nếu không có tệp khóa, trường `packageManager` của `package.json` (ví dụ `"bun@1.2.0"`) sẽ được sử dụng trước khi chuyển sang npm.
+
+Các dải phiên bản không trỏ đến registry, chẳng hạn như `workspace:*`, `file:`, `link:`, `catalog:` hoặc URL git, sẽ không bao giờ bị sửa đổi.
+
+## Ví dụ:
+
+### Liệt kê các nâng cấp có sẵn mà không áp dụng chúng:
+
+```bash packageManager="npm"
+npx intlayer upgrade --dry-run
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --dry-run
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --dry-run
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --dry-run
+```
+
+### Nâng cấp lên bản phát hành canary:
+
+```bash packageManager="npm"
+npx intlayer upgrade --tag canary
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --tag canary
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --tag canary
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --tag canary
+```
+
+## Ví dụ đầu ra:
+
+```bash
+npx intlayer upgrade
+Intlayer packages:
+  package.json
+    intlayer ^9.0.0 → ^9.5.7
+  apps/web/package.json
+    next-intlayer ^9.5.7 (latest)
+    vite-intlayer ~9.2.0 → ~9.5.7
+Running bun install...
+✓ Upgraded 2 Intlayer dependencies to latest
+```
+
+## Ghi chú:
+
+- Chạy lệnh từ thư mục gốc của kho lưu trữ để nâng cấp mọi workspace. Chạy lệnh từ một workspace cụ thể để chỉ nâng cấp riêng workspace đó.
+- Các gói không thể lấy được phiên bản (ngoại tuyến, gói riêng tư hoặc chưa xuất bản) sẽ được liệt kê và giữ nguyên.
+- Nếu quá trình cài đặt thất bại, các dải phiên bản đã nâng cấp vẫn được giữ lại trong `package.json`. Hãy chạy lệnh cài đặt của trình quản lý gói theo cách thủ công.

package/docs/zh/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: 2026 年 Next.js 最佳 i18n 解决方案 - 基准测试报告
 description: 对比 next-intl、next-i18next 和 Intlayer 等 Next.js 国际化 (i18n) 库。关于打包体积、泄漏和响应性的详细性能报告。
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "更新基准测试结果"
   - version: 9.5.1
     date: 2026-09-11
     changes: "更新基准测试结果"
@@ -213,7 +216,7 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 **(Tolgee)** (`@tolgee/react@7.2.0`):
 
-`Tolgee` 解决了前面提到的许多问题。我发现它比类似的工具更难采用。它不提供类型安全，这增加了在编译时捕捉缺失键的难度。我不得不使用自己的函数封装 Tolgee 的函数，以添加缺失键检测。
+`Tolgee` 解决了前面提到的许多问题。我发现它比类似的工具更难采用。它不提供类型安全，这增加了在编译时捕捉缺失键的难度。我不得不使用自己的函数封装 Tolgee 的函数，以添加缺失键检测。 该软件包也相对较重（~14.3kb，约为 `next-intlayer` 的 2.8 倍）。
 
 **(Next Intl)** (`next-intl@4.14.2`):
 
@@ -239,7 +242,7 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 如果你喜欢 `t()` 风格的 API，`next-translate` 是我的主要推荐方案。它通过 `next-translate-plugin` 优雅运作，利用 Webpack / Turbopack loader 通过 `getStaticProps` 加载命名空间。它也是这些方案中最轻量的之一（约 3.5kb）。对于命名空间拆分，在配置中为每个页面或路由定义命名空间的设计非常周到，比 **next-intl** 或 **next-i18next** 等主要替代方案更易于维护。在版本 `3.1.2` 中，我注意到静态渲染无法工作，Next.js 会回退到动态渲染。
 
-**(Intlayer)** (`next-intlayer@9.5.1`):
+**(Intlayer)** (`next-intlayer@9.5.6`):
 
 出于客观性考量，我不会亲自评价 `next-intlayer`，因为这是我自己的解决方案。