@intlayer/docs 9.5.7 → 9.5.9-canary.0

package/docs/tr/benchmark/vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: 2026'da Vue için En İyi i18n Çözümü - Benchmark Raporu
-description: vue-i18n, fluent-vue ve Intlayer gibi Vue uluslararasılaştırma (i18n) kütüphanelerini karşılaştırın. Bundle boyutu, sızıntı ve reaktivite üzerine ayrıntılı performans raporu.
+description: vue-i18n, fluent-vue, Tolgee ve Intlayer gibi Vue uluslararasılaştırma (i18n) kütüphanelerini karşılaştırın. Bundle boyutu, sızıntı ve reaktivite üzerine ayrıntılı performans raporu.
 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: "Benchmark sonuçları güncellendi ve Tolgee eklendi"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Benchmark sonuçları güncellendi"
@@ -66,6 +69,7 @@ Diğer etki geliştirici deneyimi (DX) üzerindedir: içeriği nasıl tanımlad
 ## TL;DR
 
 - **Intlayer**: Yerel kapsam (scoping) ve dinamik yükleme ile en hafif çözüm (v9.5.6).
+- **Tolgee**: Dinamik modda sıfır sızıntı ile etkili dinamik yükleme, ancak daha ağır (~3.7× Intlayer) ve derleme zamanında yerleşik tip güvenliğinden yoksundur.
 - **vue-i18n**: Zengin bir ekosisteme sahip endüstri standardı, ancak büyük uygulamalarda önemli ölçüde ağırlaşabilir ve kod bölme (code-splitting) için optimize edilmesi zor olabilir.
 - **fluent-vue**: Yenilikçi mesaj organizasyonu ancak tip güvenliğinden yoksundur ve son derece ağır bir çözüm olduğu ortaya çıkmıştır.
 
@@ -103,6 +107,7 @@ Bu benchmark için aşağıdaki kütüphaneleri karşılaştırdık:
 - [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/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, **10 sayfa** ve **10 dilden** oluşan çok dilli bir uygulamaya sahip `Vue`'dur.
 
@@ -146,7 +151,7 @@ Her yığın için gerçek bir tarayıcıda aynı çok dilli uygulamayı çalı
 
 GitHub yıldızları, bir projenin popülerliğinin, topluluk güveninin ve uzun vadeli alakasının güçlü bir göstergesidir. Teknik kalitenin doğrudan bir ölçüsü olmasa da, kaç geliştiricinin projeyi yararlı bulduğunu, ilerlemesini takip ettiğini ve benimseme olasılığını yansıtır. Bir projenin değerini tahmin etmek için yıldızlar, alternatifler arasındaki çekişi karşılaştırmaya yardımcı olur ve ekosistem büyümesi hakkında içgörüler sağlar.
 
-[![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)
 
 ## Detaylı sonuçlar
 
@@ -156,18 +161,22 @@ GitHub yıldızları, bir projenin popülerliğinin, topluluk güveninin ve uzun
 
 ### 2 - Kabul edilebilir çözümler
 
+**(Tolgee)** (`@tolgee/vue@7.2.0`):
+
+`Tolgee`, daha önce bahsedilen sorunların çoğunu ele alarak dil ve sayfa sızıntısını başarıyla ortadan kaldıran dinamik yükleme sunar (sayfa JS boyutunu yaklaşık 58.8kb seviyesine düşürür). Ancak, anahtarlar için derleme zamanında yerleşik tip güvenliği sağlamaz, bu da eksik anahtarların yakalanmasını zorlaştırır. Ayrıca kütüphanenin boyutu nispeten ağırdır (~13.8kb, bu da `vue-intlayer` boyutunun yaklaşık 3.7 katıdır).
+
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
 - **vue-i18n** tartışmasız Vue için en çok kullanılan i18n kütüphanesidir, birçok özelliği ve devasa bir ekosistemi vardır. Ancak kaputun altında çözüm oldukça ağırdır. vue-i18n mesajlar için lazy loading entegre etse bile, kapsam (scoping) özelliği eksiktir. Klasik bir Vue SPA uygulaması durumunda sorun yoktur, ancak @nuxt/i18n kullanan bir nuxt uygulaması için, tüm sayfalardan gelen mesajların tek bir sayfaya dahil edilmesine yol açar. 10'dan fazla sayfa içeren büyük bir nuxt uygulaması için bu gerçekten sorunlu olabilir.
 
-Paket çok ağırdır (~24.3kb, bu da `vue-intlayer`'ın yaklaşık 6 katıdır).
+Paket çok ağırdır (~24.1 kb, bu da `vue-intlayer`'ın yaklaşık 6.5 katıdır).
 
 **(fluent-vue)** (`fluent-vue@3.8.2`):
 
-- **fluent-vue** .ftl formatı aracılığıyla yenilikçi bir girişim sunar. Mesaj organizasyonu harikadır, başlaması daha kolaydır. Ancak pratikte tip güvenliği eksikliği hata riskini artırır ve hata ayıklaması hızla zaman alıcı hale gelebilir. Dahası, bu çözüm mesajları her sayfada her dildeki tüm içeriğin yüklenmesini zorlayan bir vite eklentisi kullanarak yükler. Ek olarak, bu son derece ağır bir çözümdür (~29.7kb, bu da `vue-intlayer`'ın yaklaşık 7.5 katıdır).
+- **fluent-vue** .ftl formatı aracılığıyla yenilikçi bir girişim sunar. Mesaj organizasyonu harikadır, başlaması daha kolaydır. Ancak pratikte tip güvenliği eksikliği hata riskini artırır ve hata ayıklaması hızla zaman alıcı hale gelebilir. Dahası, bu çözüm mesajları her sayfada her dildeki tüm içeriğin yüklenmesini zorlayan bir vite eklentisi kullanarak yükler. Ek olarak, bu son derece ağır bir çözümdür (~29.7kb, bu da `vue-intlayer`'ın yaklaşık 8 katıdır).
 
 ### 3 - Öneriler
 
-**(Intlayer)** (`vue-intlayer@9.5.0`):
+**(Intlayer)** (`vue-intlayer@9.5.6`):
 
 Kendi çözümüm olduğu için tarafsızlık adına `vue-intlayer`'ı kişisel olarak yargılamayacağım.

package/docs/tr/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-21
+updatedAt: 2026-09-23
 title: CLI - Çok dilli web siteniz için tüm Intlayer CLI komutları
 description: Çok dilli web sitenizi yönetmek için Intlayer CLI'yı nasıl kullanacağınızı keşfedin. Projenizi birkaç dakika içinde kurmak için bu çevrimiçi belgelerdeki adımları izleyin.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "upgrade komutunu ekle"
   - version: 9.5.6
     date: 2026-09-21
     changes: "init infra komutunu ekle"
@@ -155,6 +158,7 @@ Mevcut dillerin veya diğer parametrelerin nasıl yapılandırılacağını öğ
 
 - **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/init.md)** - Otomatik yapılandırma ile projenizde Intlayer'ı kurun
 - **[Altyapıyı Kur](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/infra.md)** - Masaüstü uygulamasını yükleyin veya Docker (hepsi bir arada veya Compose) ile CMS'yi kendi sunucunuzda barındırın
+- **[Intlayer Paketlerini Yükseltme](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/upgrade.md)** - Her `package.json` dosyasındaki Intlayer paketlerini listeleyin ve bunları en son sürüme yükseltin
 - **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/configuration.md)** - Intlayer yapılandırmanızı alın ve CMS'ye gönderin
 
 ### Belge Yönetimi
@@ -182,6 +186,7 @@ Mevcut dillerin veya diğer parametrelerin nasıl yapılandırılacağını öğ
 "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/tr/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Intlayer Paketlerini Yükseltme
+description: Projenizin veya monorepo'nuzun her Intlayer paketini listelemek ve bunları en son sürüme yükseltmek için Intlayer CLI upgrade komutunu nasıl kullanacağınızı öğrenin.
+keywords:
+  - CLI
+  - Upgrade
+  - Yükselt
+  - Paketler
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "upgrade komutunu ekle"
+author: aymericzip
+---
+
+# Intlayer Paketlerini Yükseltme
+
+```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` komutu, monorepo çalışma alanları da dahil olmak üzere projenizin her `package.json` dosyasında bildirilen Intlayer paketlerini listeler ve bunları yayınlanan en son sürüme yükseltir. `intlayer init` ile aynı paket yükseltme adımını bağımsız olarak çalıştırır.
+
+## Argümanlar:
+
+- `--project-root [projectRoot]` - İsteğe bağlı. Proje kök dizini. Varsayılan olarak komut, mevcut çalışma dizininin üzerindeki en yakın `package.json` dosyasından başlar.
+- `--dry-run` - İsteğe bağlı. Herhangi bir dosyayı değiştirmeden paketleri ve hedef sürümlerini listeler.
+- `--tag <tag>` - İsteğe bağlı. Yükseltilecek npm dist-tag (örneğin `canary`). Varsayılan olarak `latest` değeridir.
+
+## Ne yapar:
+
+1. **Intlayer paketlerini listeler** - `intlayer`, `@intlayer/*`, `*-intlayer` ve `intlayer-*` bağımlılıkları ve devDependencies için projenin her `package.json` dosyasını (`node_modules` ve derleme çıktılarını atlayarak) tarar.
+2. **Hedef sürümü getirir** - Her paketin seçilen dist-tag (varsayılan olarak `latest`) sürümünü npm kayıt defterinden okur.
+3. **Aralıkları yeniden yazar** - İşlecini (`^`, `~` veya hiçbiri) ve dosya girintisini koruyarak güncelliğini yitirmiş her aralığı doğrudan dosya içinde günceller.
+4. **Tek seferde yükler** - Kilit dosyasına sahip paket yöneticisini kullanarak çalışma alanı kökünden (kilit dosyası olan en yakın dizin) tek bir yükleme çalıştırır:
+
+| Kilit dosyası                      | Komut          |
+| ---------------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`           | `bun install`  |
+| `pnpm-lock.yaml`                   | `pnpm install` |
+| `yarn.lock`                        | `yarn install` |
+| `package-lock.json` veya kilit yok | `npm install`  |
+
+Kilit dosyası yoksa, npm'e geri dönmeden önce `package.json` dosyasının `packageManager` alanı (örneğin `"bun@1.2.0"`) kullanılır.
+
+`workspace:*`, `file:`, `link:`, `catalog:` veya git URL'leri gibi kayıt defterini işaret etmeyen aralıklar asla değiştirilmez.
+
+## Örnekler:
+
+### Mevcut yükseltmeleri uygulamadan listeleme:
+
+```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 sürümüne yükseltme:
+
+```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
+```
+
+## Örnek çıktı:
+
+```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
+```
+
+## Notlar:
+
+- Her çalışma alanını yükseltmek için komutu deponuzun kökünden çalıştırın. Yalnızca ilgili çalışma alanını yükseltmek için o çalışma alanından çalıştırın.
+- Sürümü alınamayan paketler (çevrimdışı, özel veya yayınlanmamış paket) listelenir ve değiştirilmeden bırakılır.
+- Yükleme başarısız olursa, yükseltilen aralıklar `package.json` dosyasında tutulur. Paket yöneticinizin yükleme komutunu manuel olarak çalıştırın.

package/docs/uk/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Найкраще i18n рішення для Next.js у 2026 році - Звіт бенчмарку
 description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Next.js, такі як next-intl, next-i18next та Intlayer. Детальний звіт про продуктивність за розміром бандла, витоком та реактивністю.
 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 @@ Intlayer намагається оптимізувати всі ці парам
 
 **(Tolgee)** (`@tolgee/react@7.2.0`):
 
-`Tolgee` вирішує багато зі згаданих проблем. Проте його впровадження здалося мені складнішим, ніж у подібних інструментів. Він не забезпечує типізацію (type safety), що ускладнює виявлення відсутніх ключів під час компіляції. Мені довелося обертати функції Tolgee своїми, щоб додати перевірку відсутніх ключів.
+`Tolgee` вирішує багато зі згаданих проблем. Проте його впровадження здалося мені складнішим, ніж у подібних інструментів. Він не забезпечує типізацію (type safety), що ускладнює виявлення відсутніх ключів під час компіляції. Мені довелося обертати функції Tolgee своїми, щоб додати перевірку відсутніх ключів. Пакет також відносно важкий (~14.3 КБ, що приблизно в 2.8 рази більше за `next-intlayer`).
 
 **(Next Intl)** (`next-intl@4.14.2`):
 
@@ -239,7 +242,7 @@ Intlayer намагається оптимізувати всі ці парам
 
 `next-translate` - моя основна рекомендація, якщо вам подобається API у стилі `t()`. Він елегантно працює через `next-translate-plugin`, завантажуючи простори імен через `getStaticProps` за допомогою завантажувача Webpack / Turbopack. Це також один із найлегших варіантів у цьому списку (~3.5 КБ). Визначення просторів імен для сторінок або маршрутів у конфігу добре продумане і простіше в підтримці, ніж у **next-intl** чи **next-i18next**. У версії `3.1.2` я помітив, що статичний рендеринг не працював; Next.js переходив до динамічного рендерингу.
 
-**(Intlayer)** (`next-intlayer@9.5.1`):
+**(Intlayer)** (`next-intlayer@9.5.6`):
 
 Я не буду особисто оцінювати `next-intlayer` заради об’єктивності, оскільки це моє власне рішення.
 

package/docs/uk/benchmark/solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Найкраще i18n рішення для Solid у 2026 році - Звіт про бенчмарк
-description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Solid, такі як solid-primitives, solid-i18next та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
+description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Solid, такі як solid-primitives, solid-i18next, Tolgee та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
 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: "Оновлення результатів бенчмарку"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Оновлення результатів бенчмарку"
@@ -68,6 +71,7 @@ style="border:none;"
 - **Intlayer**: Рекомендований вибір для професійних додатків Solid, які потребують розширених функцій та оптимізації (v9.5.6).
 - **@solid-primitives/i18n**: Відмінна легка альтернатива для простих проєктів, хоча їй бракує розширених функцій, таких як lazy loading.
 - **solid-i18next**: Стандартний, але важкий варіант (~3.5 рази більше за Intlayer) з тими ж недоліками, що і React i18next.
+- **Tolgee**: Багатофункціональна платформа перекладів, але досить важка (~12.7 КБ, приблизно в 3.0× важча за Intlayer), не має рідних примітивів для Solid (спирається на @tolgee/web) та демонструє значний витік між сторінками у статичних конфігураціях (90% витоку сторінок).
 - **Paraglide**: Інноваційний підхід, але складний DX та проблеми з tree-shaking у деяких конфігураціях.
 
 ## Протестуйте свій додаток
@@ -103,6 +107,7 @@ style="border:none;"
 - [`solid-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/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)
 
 Фреймворк - `Solid` з багатомовним додатком із **10 сторінок** і **10 мов**.
@@ -147,7 +152,7 @@ style="border:none;"
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.
 
-[![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)
 
 ## Результати детально
 
@@ -170,6 +175,18 @@ style="border:none;"
 Solid primitive надзвичайно легкий і ефективний. Я рекомендую це рішення для легких проєктів, але в ньому може швидко не вистачити функцій для професійних рішень, що включають управління кукі, перенаправлення проксі, форматери тощо.
 Йому також не вистачає lazy loading та скоупінгу просторів імен для оптимізації розміру сторінки.
 
+**(Tolgee)** (`@tolgee/web@7.2.0`):
+
+`Tolgee` пропонує повнофункціональну платформу керування перекладами з можливостями редагування in-context.
+
+Для Solid наразі немає офіційного нативного адаптера (такого як `@tolgee/solid`), тому розробникам доводиться інтегрувати бібліотеку через `@tolgee/web` із кастомними сигналами.
+
+Пакет досить важкий (~12.7 КБ, що приблизно в 3.0× більше за `solid-intlayer`).
+
+Через відсутність механізму гранулярного поділу за сторінками у Solid усі переклади завантажуються в пам'ять на старті у статичних конфігураціях. Це призводить до значного витоку бандлу (44.5% витоку локалей, 90.0% витоку сторінок) та середнього розміру бандлу сторінки ~91.8 КБ (порівняно з ~35.8 КБ у Intlayer).
+
+Реактивність при зміні мови дуже швидка (0.6 мс), що чудово узгоджується з точковою реактивністю Solid, хоча накладні витрати на гідратацію вищі (~5.6 мс проти ~3.0 мс у Intlayer).
+
 **(Paraglide)** (`@inlang/paraglide-js@2.25.1`):
 
 `Paraglide` пропонує інноваційний, добре продуманий підхід. Незважаючи на це, у цьому бенчмарку деревоподібне шейкінг (tree-shaking), яке рекламує їхня компанія, не спрацювало для моєї реалізації. Робочий процес і DX також складніші за інші варіанти.
@@ -178,7 +195,7 @@ Solid primitive надзвичайно легкий і ефективний. Я
 
 ### 3 - Рекомендації
 
-**(Intlayer)** (`solid-intlayer@9.5.0`):
+**(Intlayer)** (`solid-intlayer@9.5.6`):
 
 Я не буду особисто оцінювати `solid-intlayer` заради об'єктивності, оскільки це моє власне рішення.
 

package/docs/uk/benchmark/svelte.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Найкраще i18n рішення для Svelte у 2026 році - Звіт про бенчмарк
-description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Svelte, такі як svelte-i18n, Paraglide та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
+description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Svelte, такі як svelte-i18n, Paraglide, Tolgee та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
 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: "Оновлення результатів бенчмарку"
@@ -67,6 +70,7 @@ style="border:none;"
 
 - **Intlayer**: Найефективніший за продуктивністю вибір (v9.5.6) з найменшим слідом (footprint).
 - **Paraglide**: Сильний претендент для tree-shaking, але має складніший досвід розробника та накладні витрати на реактивність.
+- **Tolgee**: Багатофункціональна платформа перекладів із редагуванням in-context, але досить важка (~13.0 КБ, приблизно в 3.6× важча за Intlayer), зі значним витоком між сторінками у статичних конфігураціях (90% витоку сторінок).
 - **svelte-i18n**: Комплексний та стандартний для Svelte, але несе значно більшу вагу бандла (~4.5 разів більше за Intlayer).
 
 ## Протестуйте свій додаток
@@ -101,6 +105,7 @@ style="border:none;"
 - `Base App` (Без бібліотеки i18n)
 - [`svelte-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/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)
 
 Фреймворк - `Svelte` з багатомовним додатком із **10 сторінок** і **10 мов**.
@@ -145,7 +150,7 @@ style="border:none;"
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.
 
-[![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)
 
 ## Результати детально
 
@@ -165,6 +170,16 @@ style="border:none;"
 
 > Примітка щодо paraglide: рішення впорскує код у вашу кодову базу для імпорту; як результат, метрика 'lib size' у звіті бенчмарку становить майже 0. Генерація коду - це добре, тому що використана функція включатиме лише необхідну логіку (префікс скрізь проти відсутності префікса, кукі проти сховища тощо). Для порівняння, Intlayer виконує цю фільтрацію за допомогою впорскування змінних оточення під час збірки, щоб змусити бандлер виконувати tree-shaking контенту залежно від логіки. Завдяки цьому paraglide та intlayer стають у 6–10 разів легшими рішеннями, ніж i18next або next-intl.
 
+**(Tolgee)** (`@tolgee/svelte@7.2.1`):
+
+`Tolgee` пропонує платформу локалізації "все в одному" з контекстним редагуванням in-context та офіційною інтеграцією для Svelte через `@tolgee/svelte`.
+
+Пакет досить важкий (~13.0 КБ, що приблизно в 3.6× більше за `svelte-intlayer`).
+
+Через відсутність гранулярного поділу за сторінками у Svelte всі переклади завантажуються в пам'ять на старті у статичних конфігураціях. Це призводить до істотного витоку бандлу (50.0% витоку локалей, 90.0% витоку сторінок) та середнього розміру бандлу сторінки ~100.7 КБ (порівняно з ~59.0 КБ у Intlayer).
+
+Реактивність при зміні мови дуже швидка (0.5 мс) завдяки реактивним сховищам Svelte, хоча накладні витрати на гідратацію трохи вищі (~6.2 мс проти ~5.5 мс у Intlayer).
+
 **(svelte-i18n)** (`svelte-i18n@4.0.1`):
 
 Це рішення задовольняє всі потреби i18n у проєкті Svelte. Але як і у випадку з i18next або іншими великими i18n рішеннями, воно трохи важке (~16.6kb, що приблизно в 4.5 разів більше за `svelte-intlayer`).

package/docs/uk/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Найкраще i18n рішення для TanStack Start у 2026 році - Звіт бенчмарку
 description: Порівняйте бібліотеки інтернаціоналізації для TanStack Start, такі як react-i18next, use-intl та Intlayer. Детальний звіт про продуктивність за розміром бандла, витоком та реактивністю.
 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: "Оновлення результатів бенчмарку"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Оновлення результатів бенчмарку"
@@ -200,7 +203,7 @@ history:
 
 `Tolgee` вирішує багато зі згаданих проблем. Проте почати роботу з ним здалося мені важче, ніж з іншими інструментами з подібними підходами. Він не забезпечує типізацію, що значно ускладнює виявлення відсутніх ключів під час компіляції. Мені довелося обертати Tolgee API своїми рішеннями, щоб додати перевірку відсутніх ключів.
 
-Пакет досить важкий (~11.1kb, що більш ніж у 2 рази більше за `react-intlayer`).
+Пакет досить важкий (~13.8 kb, що більш ніж у 2.9 рази більше за `react-intlayer`).
 
 На TanStack Start я також мав проблеми з реактивністю: при зміні локалі довелося примусово перерендерити провайдер і підписуватися на події зміни локалі, щоб завантаження іншою мовою працювало коректно.
 
@@ -234,7 +237,7 @@ history:
 
 Цей бенчмарк TanStack Start не має прямого еквівалента `next-translate` (Next.js плагін + `getStaticProps`). Командам, які справді хочуть API у стилі `t()` зі зрілою екосистемою, `react-i18next` та `use-intl` залишаються "розумним" вибором, але будьте готові витратити багато часу на оптимізацію для уникнення витоків.
 
-**(Intlayer)** (`react-intlayer@9.5.1`):
+**(Intlayer)** (`react-intlayer@9.5.6`):
 
 Я не буду особисто оцінювати `react-intlayer` заради об’єктивності, оскільки це моє власне рішення.
 

package/docs/uk/benchmark/vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Найкраще i18n рішення для Vue у 2026 році - Звіт про бенчмарк
-description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Vue, такі як vue-i18n, fluent-vue та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
+description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Vue, такі як vue-i18n, fluent-vue, Tolgee та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
 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: "Оновлення результатів бенчмарку та додавання Tolgee"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Оновлення результатів бенчмарку"
@@ -66,6 +69,7 @@ style="border:none;"
 ## TL;DR
 
 - **Intlayer**: Найлегше рішення (v9.5.6) з нативним скоупінгом (scoping) та динамічним завантаженням.
+- **Tolgee**: Ефективне динамічне завантаження з нульовим витоком у динамічному режимі, але важче рішення (~3.7× Intlayer) без вбудованої типізації під час компіляції.
 - **vue-i18n**: Галузевий стандарт з багатою екосистемою, але може стати значно важчим і важчим для оптимізації під code-splitting у великих додатках.
 - **fluent-vue**: Інноваційна організація повідомлень, але не вистачає безпеки типів (type-safety) і виявляється надзвичайно важким рішенням.
 
@@ -103,6 +107,7 @@ style="border:none;"
 - [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/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)
 
 Фреймворк - `Vue` з багатомовним додатком із **10 сторінок** і **10 мов**.
 
@@ -146,7 +151,7 @@ style="border:none;"
 
 Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.
 
-[![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)
 
 ## Результати детально
 
@@ -156,18 +161,22 @@ style="border:none;"
 
 ### 2 - Прийнятні рішення
 
+**(Tolgee)** (`@tolgee/vue@7.2.0`):
+
+`Tolgee` вирішує багато зі згаданих проблем, пропонуючи динамічне завантаження, яке успішно усуває витоки мовних версій та сторінок (зменшуючи JS сторінки приблизно до 58.8 КБ). Проте він не забезпечує вбудованої типізації для ключів під час компіляції, що ускладнює виявлення відсутніх ключів. Крім того, розмір бібліотеки є відносно важким (~13.8 КБ, що приблизно в 3.7 рази більше за `vue-intlayer`).
+
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
 - **vue-i18n** безперечно є найбільш використовуваною бібліотекою i18n для Vue, вона має багато функцій і величезну екосистему. Але "під капотом" рішення досить важке. Навіть якщо vue-i18n інтегрує lazy loading для повідомлень, у ній відсутня функція скоупінгу (scoping). У випадку класичного Vue SPA додатка проблем немає, але для nuxt додатка, що використовує @nuxt/i18n, це призводить до включення повідомлень з усіх сторінок в одну. Для великого nuxt додатка з понад 10 сторінками це може стати справді проблематичним.
 
-Пакет дуже важкий (~24.3kb, що приблизно в 6 разів більше за `vue-intlayer`).
+Пакет дуже важкий (~24.1 kb, що приблизно в 6 разів більше за `vue-intlayer`).
 
 **(fluent-vue)** (`fluent-vue@3.8.2`):
 
-- **fluent-vue** пропонує спробу інновації через формат .ftl. Організація повідомлень чудова, легше почати роботу. Але на практиці відсутність безпеки типів підвищує ризик помилок і налагодження може швидко стати трудомістким. Більше того, це рішення завантажує повідомлення за допомогою плагіна vite, який змушує завантажувати весь контент усіма мовами на кожну сторінку. Крім того, це надзвичайно важке рішення (~29.7kb, що приблизно в 7.5 рази більше за `vue-intlayer`).
+- **fluent-vue** пропонує спробу інновації через формат .ftl. Організація повідомлень чудова, легше почати роботу. Але на практиці відсутність безпеки типів підвищує ризик помилок і налагодження може швидко стати трудомістким. Більше того, це рішення завантажує повідомлення за допомогою плагіна vite, який змушує завантажувати весь контент усіма мовами на кожну сторінку. Крім того, це надзвичайно важке рішення (~29.7kb, що приблизно в 8 рази більше за `vue-intlayer`).
 
 ### 3 - Рекомендації
 
-**(Intlayer)** (`vue-intlayer@9.5.0`):
+**(Intlayer)** (`vue-intlayer@9.5.6`):
 
 Я не буду особисто оцінювати `vue-intlayer` заради об'єктивності, оскільки це моє власне рішення.

package/docs/uk/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-21
+updatedAt: 2026-09-23
 title: CLI - Усі команди Intlayer CLI для вашого багатомовного вебсайту
 description: Дізнайтеся, як використовувати Intlayer CLI для керування вашим багатомовним вебсайтом. Дотримуйтесь кроків у цій онлайн-документації, щоб налаштувати свій проєкт за лічені хвилини.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Додати команду upgrade"
   - version: 9.5.6
     date: 2026-09-21
     changes: "Додати команду init infra"
@@ -155,6 +158,7 @@ Intlayer приймає кілька форматів файлів конфіг
 
 - **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/init.md)** - Налаштування Intlayer у вашому проєкті з автоматичною конфігурацією
 - **[Налаштування інфраструктури](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/infra.md)** - Встановіть десктопний застосунок або запустіть CMS на власній інфраструктурі за допомогою Docker (all-in-one або Compose)
+- **[Оновлення пакетів Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/upgrade.md)** - Скласти список пакетів Intlayer для кожного `package.json` та оновити їх до останньої версії
 - **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/configuration.md)** - Отримання вашої конфігурації Intlayer та її відправка в CMS
 
 ### Керування документацією
@@ -182,6 +186,7 @@ Intlayer приймає кілька форматів файлів конфіг
 "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",