@intlayer/docs 9.5.7 → 9.5.8

package/docs/pl/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Aktualizacja pakietów Intlayer
+description: Dowiedz się, jak używać polecenia upgrade w Intlayer CLI, aby wyświetlić listę wszystkich pakietów Intlayer w projekcie lub monorepo i zaktualizować je do najnowszej wersji.
+keywords:
+  - CLI
+  - Upgrade
+  - Aktualizacja
+  - Pakiety
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Dodaj polecenie upgrade"
+author: aymericzip
+---
+
+# Aktualizacja pakietów 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
+```
+
+Polecenie `upgrade` wyświetla listę pakietów Intlayer zadeklarowanych w każdym pliku `package.json` Twojego projektu, w tym w obszarach roboczych monorepo, i aktualizuje je do najnowszej opublikowanej wersji. Wykonuje samodzielnie ten sam krok aktualizacji pakietów co `intlayer init`.
+
+## Argumenty:
+
+- `--project-root [projectRoot]` - Opcjonalne. Katalog główny projektu. Domyślnie polecenie rozpoczyna wyszukiwanie od najbliższego pliku `package.json` powyżej bieżącego katalogu roboczego.
+- `--dry-run` - Opcjonalne. Wyświetla listę pakietów i ich wersji docelowych bez modyfikowania jakichkolwiek plików.
+- `--tag <tag>` - Opcjonalne. npm dist-tag, do którego ma nastąpić aktualizacja (np. `canary`). Wartość domyślna to `latest`.
+
+## Jak to działa:
+
+1. **Wyświetla listę pakietów Intlayer** - Skanuje każdy plik `package.json` w projekcie (pomijając `node_modules` oraz katalogi wyjściowe kompilacji) w poszukiwaniu zależności i devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` oraz `intlayer-*`.
+2. **Pobiera wersję docelową** - Odczytuje wersję wybranego dist-tagu (domyślnie `latest`) dla każdego pakietu z rejestru npm.
+3. **Przepisuje zakresy wersji** - Aktualizuje każdy przestarzały zakres bezpośrednio w pliku, zachowując jego operator (`^`, `~` lub brak) oraz wcięcia pliku.
+4. **Instaluje jednorazowo** - Uruchamia pojedynczą instalację z poziomu katalogu głównego obszaru roboczego (najbliższy katalog z plikiem blokady), używając menedżera pakietów, do którego należy plik blokady:
+
+| Plik blokady (Lock file)           | Polecenie      |
+| ---------------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`           | `bun install`  |
+| `pnpm-lock.yaml`                   | `pnpm install` |
+| `yarn.lock`                        | `yarn install` |
+| `package-lock.json` lub brak pliku | `npm install`  |
+
+Jeśli nie ma pliku blokady, przed powrotem do npm używane jest pole `packageManager` z pliku `package.json` (na przykład `"bun@1.2.0"`).
+
+Zakresy, które nie wskazują na rejestr, takie jak `workspace:*`, `file:`, `link:`, `catalog:` lub adresy URL git, nigdy nie są modyfikowane.
+
+## Przykłady:
+
+### Wyświetl dostępne aktualizacje bez ich stosowania:
+
+```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
+```
+
+### Zaktualizuj do wersji 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
+```
+
+## Przykładowe dane wyjściowe:
+
+```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
+```
+
+## Uwagi:
+
+- Uruchom polecenie z poziomu katalogu głównego repozytorium, aby zaktualizować każdy obszar roboczy. Uruchom je z poziomu danego obszaru roboczego, aby zaktualizować tylko ten obszar roboczy.
+- Pakiety, których wersji nie można pobrać (tryb offline, pakiet prywatny lub nieopublikowany), są wymieniane na liście i pozostawiane bez zmian.
+- Jeśli instalacja się nie powiedzie, zaktualizowane zakresy zostaną zachowane w `package.json`. Uruchom polecenie instalacji menedżera pakietów ręcznie.

package/docs/pt/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Melhor solução i18n para Next.js em 2026 - Relatório de Benchmark
 description: Compare bibliotecas de internacionalização (i18n) para Next.js como next-intl, next-i18next e Intlayer. Relatório detalhado de desempenho sobre tamanho do bundle, vazamento e reatividade.
 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: "Atualização dos resultados do benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Atualização dos resultados do benchmark"
@@ -213,7 +216,7 @@ Finalmente, em comparação com outras soluções, o Paraglide não usa store (e
 
 **(Tolgee)** (`@tolgee/react@7.2.0`):
 
-O `Tolgee` resolve muitos dos problemas mencionados anteriormente. Achei mais difícil de adotar do que ferramentas semelhantes. Ele não fornece segurança de tipos (type safety), o que também torna mais difícil encontrar chaves ausentes no momento da compilação. Tive que envolver as funções do Tolgee com as minhas para adicionar a detecção de chaves ausentes.
+O `Tolgee` resolve muitos dos problemas mencionados anteriormente. Achei mais difícil de adotar do que ferramentas semelhantes. Ele não fornece segurança de tipos (type safety), o que também torna mais difícil encontrar chaves ausentes no momento da compilação. Tive que envolver as funções do Tolgee com as minhas para adicionar a detecção de chaves ausentes. O pacote também é relativamente pesado (~14.3kb, o que é cerca de 2.8× `next-intlayer`).
 
 **(Next Intl)** (`next-intl@4.14.2`):
 
@@ -239,7 +242,7 @@ O `Lingui` é frequentemente elogiado. Pessoalmente, achei o fluxo de trabalho `
 
 O `next-translate` é minha recomendação principal se você gosta de uma API no estilo `t()`. É elegante via `next-translate-plugin`, carregando namespaces através de `getStaticProps` com um carregador Webpack / Turbopack. É também uma das opções mais leves aqui (~3.5kb). Para os namespaces, definir os namespaces por página ou rota na configuração é bem pensado e mais fácil de manter do que as principais alternativas como **next-intl** ou **next-i18next**. Na versão `3.1.2`, notei que a renderização estática não funcionava; o Next.js recorria à renderização dinâmica.
 
-**(Intlayer)** (`next-intlayer@9.5.1`):
+**(Intlayer)** (`next-intlayer@9.5.6`):
 
 Não serei eu a julgar pessoalmente o `next-intlayer` por uma questão de objetividade, já que é a minha própria solução.
 

package/docs/pt/benchmark/solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Melhor solução i18n para Solid em 2026 - Relatório de Benchmark
-description: Compare bibliotecas de internacionalização (i18n) para Solid como solid-primitives, solid-i18next e Intlayer. Relatório de desempenho detalhado sobre tamanho do bundle, vazamento e reatividade.
+description: Compare bibliotecas de internacionalização (i18n) para Solid como solid-primitives, solid-i18next, Tolgee e Intlayer. Relatório de desempenho detalhado sobre tamanho do bundle, vazamento e reatividade.
 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: "Atualização dos resultados do benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Atualização dos resultados do benchmark"
@@ -68,6 +71,7 @@ O outro impacto é na experiência do desenvolvedor (DX): como você declara con
 - **Intlayer**: Escolha recomendada para aplicações Solid profissionais que precisam de recursos avançados e otimização (v9.5.6).
 - **@solid-primitives/i18n**: Excelente alternativa leve para projetos simples, embora careça de recursos avançados como lazy loading.
 - **solid-i18next**: Opção padrão, mas pesada (~3.5× o Intlayer) com os mesmos pontos negativos do React i18next.
+- **Tolgee**: Plataforma de tradução rica em recursos, mas bastante pesada (~12.7kb, cerca de 3.0× Intlayer), sem primitivas Solid dedicadas (depende de @tolgee/web) e com vazamento considerável entre páginas em configurações estáticas (90% de vazamento de página).
 - **Paraglide**: Abordagem inovadora, mas DX complexa e problemas de tree-shaking em algumas configurações.
 
 ## Teste seu app
@@ -103,6 +107,7 @@ Para este benchmark, comparamos as seguintes bibliotecas:
 - [`solid-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/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)
 
 O framework é `Solid` com um app multilíngue de **10 páginas** e **10 idiomas**.
@@ -147,7 +152,7 @@ Executei o mesmo aplicativo multilíngue em um navegador real para cada stack e
 
 As estrelas do GitHub são um forte indicador da popularidade de um projeto, da confiança da comunidade e da relevância a longo prazo. Embora não sejam uma medida direta da qualidade técnica, elas refletem quantos desenvolvedores consideram o projeto útil, acompanham seu progresso e têm probabilidade de adotá-lo. Para estimar o valor de um projeto, as estrelas ajudam a comparar a tração entre as alternativas e fornecem insights sobre o crescimento do ecossistema.
 
-[![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&codingcommons/typesafe-i18n)
+[![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&codingcommons/typesafe-i18n)
 
 ## Resultados em detalhes
 
@@ -170,6 +175,18 @@ Ainda assim, compartilha as mesmas principais desvantagens das stacks construíd
 O Solid primitive é extremamente leve e eficiente. Recomendo essa solução para projetos leves, mas pode rapidamente carecer de recursos para soluções profissionais que incluam gerenciamento de cookies, redirecionamento de proxy, formatadores etc.
 Também carece de lazy loading e scoping de namespaces para otimização do tamanho da página.
 
+**(Tolgee)** (`@tolgee/web@7.2.0`):
+
+O `Tolgee` oferece uma plataforma completa de gerenciamento de traduções com recursos de edição in-context.
+
+No Solid, atualmente não há um adaptador nativo oficial (como `@tolgee/solid`), exigindo que os desenvolvedores façam a integração via `@tolgee/web` com sinais personalizados.
+
+O pacote é relativamente pesado (~12.7kb, cerca de 3.0× `solid-intlayer`).
+
+Sem um mecanismo de divisão granular por página no Solid, todas as traduções são carregadas na memória logo na inicialização em configurações estáticas. Isso gera um alto vazamento no bundle (44.5% de vazamento de localidade, 90.0% de vazamento de página) e tamanhos médios de bundle por página de ~91.8kb (em comparação com ~35.8kb para o Intlayer).
+
+A reatividade na troca de idioma é muito rápida (0.6ms), aproveitando a reatividade refinada do Solid, embora a sobrecarga de hidratação seja um pouco maior (~5.6ms contra ~3.0ms para o Intlayer).
+
 **(Paraglide)** (`@inlang/paraglide-js@2.25.1`):
 
 O `Paraglide` oferece uma abordagem inovadora e bem pensada. Ainda assim, neste benchmark, o tree-shaking que a empresa anuncia não funcionou para minha implementação. O fluxo de trabalho e a DX também são mais complexos do que outras opções.
@@ -178,7 +195,7 @@ Finalmente, em comparação com outras soluções, o Paraglide não usa um store
 
 ### 3 - Recomendações
 
-**(Intlayer)** (`solid-intlayer@9.5.0`):
+**(Intlayer)** (`solid-intlayer@9.5.6`):
 
 Eu não julgarei pessoalmente o `solid-intlayer` por uma questão de objetividade, já que é minha própria solução.
 

package/docs/pt/benchmark/svelte.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Melhor solução i18n para Svelte em 2026 - Relatório de Benchmark
-description: Compare bibliotecas de internacionalização (i18n) para Svelte como svelte-i18n, Paraglide e Intlayer. Relatório de desempenho detalhado sobre tamanho do bundle, vazamento e reatividade.
+description: Compare bibliotecas de internacionalização (i18n) para Svelte como svelte-i18n, Paraglide, Tolgee e Intlayer. Relatório de desempenho detalhado sobre tamanho do bundle, vazamento e reatividade.
 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: "Atualização dos resultados do benchmark"
@@ -67,6 +70,7 @@ O outro impacto é na experiência do desenvolvedor (DX): como você declara con
 
 - **Intlayer**: A escolha mais eficiente em desempenho (v9.5.6) com o menor footprint.
 - **Paraglide**: Forte candidato para tree-shaking, mas possui uma experiência de desenvolvedor mais complexa e overhead de reatividade.
+- **Tolgee**: Plataforma de tradução rica em recursos com edição in-context, mas bastante pesada (~13.0kb, cerca de 3.6× Intlayer), e em configurações estáticas apresenta vazamento substancial entre páginas (90% de vazamento de página).
 - **svelte-i18n**: Abrangente e padrão para Svelte, mas carrega um peso de bundle muito maior (~4.5× o Intlayer).
 
 ## Teste seu app
@@ -101,6 +105,7 @@ Para este benchmark, comparamos as seguintes bibliotecas:
 - `Base App` (Sem biblioteca i18n)
 - [`svelte-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/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)
 
 O framework é `Svelte` com um app multilíngue de **10 páginas** e **10 idiomas**.
@@ -145,7 +150,7 @@ Executei o mesmo aplicativo multilíngue em um navegador real para cada stack, d
 
 As estrelas do GitHub são um forte indicador da popularidade de um projeto, da confiança da comunidade e da relevância a longo prazo. Embora não sejam uma medida direta da qualidade técnica, elas refletem quantos desenvolvedores consideram o projeto útil, acompanham seu progresso e têm probabilidade de adotá-lo. Para estimar o valor de um projeto, as estrelas ajudam a comparar a tração entre as alternativas e fornecem insights sobre o crescimento do ecossistema.
 
-[![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&codingcommons/typesafe-i18n)
+[![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&codingcommons/typesafe-i18n)
 
 ## Resultados em detalhes
 
@@ -165,6 +170,16 @@ Finalmente, em comparação com outras soluções, o Paraglide não usa um store
 
 > Nota sobre o paraglide: a solução injeta código em sua base de código para importações; como resultado, a métrica 'lib size' no relatório de benchmark é quase 0. A geração de código é algo bom, porque a função utilizada incluirá apenas a lógica necessária (prefixo em todos os lugares vs sem prefixo, cookie vs armazenamento, etc.). Em comparação, o Intlayer realiza essa filtragem via injeções de variáveis de ambiente durante o build para forçar o bundler a fazer tree-shaking do conteúdo dependendo da lógica. Graças a isso, o paraglide e o intlayer acabam sendo soluções de 6 a 10 vezes mais leves que o i18next ou o next-intl.
 
+**(Tolgee)** (`@tolgee/svelte@7.2.1`):
+
+O `Tolgee` oferece uma plataforma completa de localização com edição in-context e integração oficial para o Svelte via `@tolgee/svelte`.
+
+O pacote é relativamente pesado (~13.0kb, cerca de 3.6× `svelte-intlayer`).
+
+Sem uma divisão granular por página no Svelte, todas as traduções são carregadas na memória logo na inicialização em configurações estáticas. Isso causa um vazamento substancial no bundle (50.0% de vazamento de localidade, 90.0% de vazamento de página) e tamanhos médios de bundle por página de ~100.7kb (em comparação com ~59.0kb para o Intlayer).
+
+A reatividade na troca de idioma é muito rápida (0.5ms), beneficiando-se das stores reativas do Svelte, embora a sobrecarga de hidratação seja um pouco maior (~6.2ms contra ~5.5ms para o Intlayer).
+
 **(svelte-i18n)** (`svelte-i18n@4.0.1`):
 
 Esta solução atende a todas as necessidades de i18n em um projeto Svelte. Mas, como é o caso do i18next ou de outras grandes soluções de i18n, é um pouco pesada (~16.6kb, o que é cerca de 4.5× o `svelte-intlayer`).

package/docs/pt/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Melhor solução i18n para TanStack Start em 2026 - Relatório de Benchmark
 description: Compare bibliotecas de internacionalização para TanStack Start como react-i18next, use-intl e Intlayer. Relatório detalhado de desempenho sobre tamanho do bundle, vazamento e reatividade.
 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: "Atualização dos resultados do benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Atualização dos resultados do benchmark"
@@ -200,7 +203,7 @@ O `Paraglide` oferece uma abordagem inovadora e bem pensada. Mesmo assim, neste
 
 O `Tolgee` resolve muitos dos problemas mencionados anteriormente. Achei mais difícil de começar com ele do que com outras ferramentas com abordagens semelhantes. Ele não fornece segurança de tipos, o que também torna muito difícil encontrar chaves ausentes no momento da compilação. Tive que envolver as APIs do Tolgee com as minhas para adicionar a detecção de chaves ausentes.
 
-O package é bastante pesado (~11.1kb, o que é mais de 2× `react-intlayer`).
+O package é bastante pesado (~13.8 kb, o que é mais de 2.9× `react-intlayer`).
 
 No TanStack Start também tive problemas de reatividade: na mudança de localidade, tive que forçar o provedor a renderizar novamente e me inscrever em eventos de mudança de localidade para que o carregamento em outro idioma se comportasse corretamente.
 
@@ -234,7 +237,7 @@ O package também é pesado (~15.3kb, o que é cerca de 3× `react-intlayer`).
 
 Este benchmark do TanStack Start não possui um equivalente direto do `next-translate` (plugin Next.js + `getStaticProps`). Para as equipes que realmente desejam uma API `t()` com um ecossistema maduro, o `react-i18next` e o `use-intl` continuam sendo escolhas "razoáveis", mas espere investir muito tempo otimizando para evitar vazamentos.
 
-**(Intlayer)** (`react-intlayer@9.5.1`):
+**(Intlayer)** (`react-intlayer@9.5.6`):
 
 Não serei eu a julgar pessoalmente o `react-intlayer` por uma questão de objetividade, já que é a minha própria solução.
 

package/docs/pt/benchmark/vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: Melhor solução i18n para Vue em 2026 - Relatório de Benchmark
-description: Compare bibliotecas de internacionalização (i18n) para Vue como vue-i18n, fluent-vue e Intlayer. Relatório de desempenho detalhado sobre tamanho do bundle, vazamento e reatividade.
+description: Compare bibliotecas de internacionalização (i18n) para Vue como vue-i18n, fluent-vue, Tolgee e Intlayer. Relatório de desempenho detalhado sobre tamanho do bundle, vazamento e reatividade.
 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: "Atualização dos resultados do benchmark e adição do Tolgee"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Atualização dos resultados do benchmark"
@@ -66,6 +69,7 @@ O outro impacto é na experiência do desenvolvedor (DX): como você declara con
 ## TL;DR
 
 - **Intlayer**: A solução mais leve (v9.5.6) com escopo (scoping) e carregamento dinâmico integrados.
+- **Tolgee**: Carregamento dinâmico eficaz sem vazamento no modo dinâmico, mas mais pesado (~3.7× Intlayer) e carece de segurança de tipos em tempo de compilação.
 - **vue-i18n**: O padrão da indústria com um rico ecossistema, mas pode se tornar significativamente mais pesado e difícil de otimizar para code-splitting em aplicações de grande porte.
 - **fluent-vue**: Organização de mensagens inovadora, mas carece de segurança de tipos e acaba sendo uma solução extremamente pesada.
 
@@ -103,6 +107,7 @@ Para este benchmark, comparamos as seguintes bibliotecas:
 - [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/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)
 
 O framework é `Vue` com um app multilíngue de **10 páginas** e **10 idiomas**.
 
@@ -146,7 +151,7 @@ Executei o mesmo app multilíngue em um navegador real para cada stack e anotei
 
 As estrelas do GitHub são um forte indicador da popularidade de um projeto, da confiança da comunidade e da relevância a longo prazo. Embora não sejam uma medida direta da qualidade técnica, elas refletem quantos desenvolvedores consideram o projeto útil, acompanham seu progresso e têm probabilidade de adotá-lo. Para estimar o valor de um projeto, as estrelas ajudam a comparar a tração entre as alternativas e fornecem insights sobre o crescimento do ecossistema.
 
-[![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)
 
 ## Resultados em detalhes
 
@@ -156,11 +161,15 @@ As estrelas do GitHub são um forte indicador da popularidade de um projeto, da
 
 ### 2 - Soluções aceitáveis
 
+**(Tolgee)** (`@tolgee/vue@7.2.0`):
+
+O `Tolgee` resolve muitos dos problemas mencionados anteriormente, oferecendo carregamento dinâmico que elimina com sucesso vazamentos de locale e de página (reduzindo o JS da página para ~58.8kb). No entanto, não fornece segurança de tipos em tempo de compilação para chaves nativamente, tornando mais difícil capturar chaves ausentes. Além disso, a biblioteca é relativamente pesada (~13.8kb, o que é cerca de 3.7× `vue-intlayer`).
+
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
 - **vue-i18n** é sem contestação a biblioteca i18n mais usada para Vue, possui muitos recursos e um ecossistema enorme. Mas, nos bastidores, a solução é bastante pesada. Mesmo que o vue-i18n integre lazy loading para mensagens, falta um recurso de escopo (scoping). No caso de um app Vue SPA clássico, não há problema, mas para um app Nuxt, usando @nuxt/i18n, isso leva à inclusão das mensagens de todas as páginas em uma única. Para um app Nuxt grande com mais de 10 páginas, isso pode se tornar realmente problemático.
 
-O pacote é muito pesado (~24.3kb, o que é cerca de 6× o `vue-intlayer`).
+O pacote é muito pesado (~24.1 kb, o que é cerca de 6× o `vue-intlayer`).
 
 **(fluent-vue)** (`fluent-vue@3.8.2`):
 
@@ -168,6 +177,6 @@ O pacote é muito pesado (~24.3kb, o que é cerca de 6× o `vue-intlayer`).
 
 ### 3 - Recomendações
 
-**(Intlayer)** (`vue-intlayer@9.5.0`):
+**(Intlayer)** (`vue-intlayer@9.5.6`):
 
 Eu não julgarei pessoalmente o `vue-intlayer` por uma questão de objetividade, já que é minha própria solução.

package/docs/pt/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-21
+updatedAt: 2026-09-23
 title: CLI - Todos os comandos do CLI Intlayer para o seu site multilíngue
 description: Descubra como utilizar o CLI Intlayer para gerir o seu site multilíngue. Siga os passos nesta documentação online para configurar o seu projeto em poucos minutos.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Adicionar o comando upgrade"
   - version: 9.5.6
     date: 2026-09-21
     changes: "Adicionar o comando init infra"
@@ -155,6 +158,7 @@ Para ver como configurar os idiomas disponíveis ou outros parâmetros, consulte
 
 - **[Inicializar Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/init.md)** - Configure o Intlayer no seu projeto com configuração automática
 - **[Configurar Infraestrutura](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/infra.md)** - Instale o aplicativo desktop ou faça auto-hospedagem do CMS com Docker (tudo-em-um ou Compose)
+- **[Atualizar Pacotes Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/upgrade.md)** - Liste os pacotes Intlayer de cada `package.json` e atualize-os para a versão mais recente
 - **[Gerir Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/configuration.md)** - Obtenha e envie a sua configuração do Intlayer para o CMS
 
 ### Gestão de Documentação
@@ -182,6 +186,7 @@ Para ver como configurar os idiomas disponíveis ou outros parâmetros, consulte
 "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/pt/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Atualizar pacotes Intlayer
+description: Aprenda a utilizar o comando upgrade do CLI Intlayer para listar todos os pacotes Intlayer do seu projeto ou monorepo e atualizá-los para a versão mais recente.
+keywords:
+  - CLI
+  - Upgrade
+  - Atualizar
+  - Pacotes
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Adicionar o comando upgrade"
+author: aymericzip
+---
+
+# Atualizar Pacotes 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
+```
+
+O comando `upgrade` lista os pacotes Intlayer declarados em cada `package.json` do seu projeto, incluindo workspaces de monorepo, e atualiza-os para a versão publicada mais recente. Executa o mesmo passo de atualização de pacotes que o `intlayer init`, de forma autónoma.
+
+## Argumentos:
+
+- `--project-root [projectRoot]` - Opcional. O diretório raiz do projeto. Por padrão, o comando inicia a partir do `package.json` mais próximo acima do diretório de trabalho atual.
+- `--dry-run` - Opcional. Lista os pacotes e a respetiva versão de destino sem modificar nenhum ficheiro.
+- `--tag <tag>` - Opcional. A dist-tag npm para a qual atualizar (por exemplo `canary`). O padrão é `latest`.
+
+## O que faz:
+
+1. **Lista os pacotes Intlayer** - Faz scan a cada `package.json` do projeto (ignorando `node_modules` e saídas de build) à procura de dependências e devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` e `intlayer-*`.
+2. **Obtém a versão de destino** - Lê a versão da dist-tag selecionada (`latest` por padrão) de cada pacote a partir do registo npm.
+3. **Reescreve os intervalos** - Atualiza cada intervalo desatualizado diretamente no ficheiro, mantendo o seu operador (`^`, `~` ou nenhum) e a indentação do ficheiro.
+4. **Instala de uma só vez** - Executa uma única instalação a partir da raiz do workspace (o diretório mais próximo com um lock file), utilizando o gestor de pacotes associado ao lock file:
+
+| Lock file                       | Comando        |
+| ------------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`        | `bun install`  |
+| `pnpm-lock.yaml`                | `pnpm install` |
+| `yarn.lock`                     | `yarn install` |
+| `package-lock.json` ou sem lock | `npm install`  |
+
+Se não houver nenhum lock file, o campo `packageManager` do `package.json` (por exemplo `"bun@1.2.0"`) é utilizado antes de recorrer ao npm.
+
+Intervalos que não apontam para o registo, como `workspace:*`, `file:`, `link:`, `catalog:` ou URLs git, nunca são modificados.
+
+## Exemplos:
+
+### Listar as atualizações disponíveis sem aplicá-las:
+
+```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
+```
+
+### Atualizar para a versão 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
+```
+
+## Exemplo de saída:
+
+```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
+```
+
+## Notas:
+
+- Execute o comando a partir da raiz do seu repositório para atualizar todos os workspaces. Execute-o a partir de um workspace para atualizar apenas esse workspace.
+- Pacotes cuja versão não pode ser obtida (offline, pacote privado ou não publicado) são listados e mantidos inalterados.
+- Se a instalação falhar, os intervalos atualizados são mantidos no `package.json`. Execute manualmente o comando de instalação do seu gestor de pacotes.

package/docs/ru/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` решает многие из упомянутых ранее проблем. Мне показалось, что его сложнее внедрить, чем аналогичные инструменты. Он не обеспечивает типобезопасность, что также затрудняет отлов отсутствующих ключей на этапе компиляции. Мне пришлось обернуть функции Tolgee своими собственными, чтобы добавить обнаружение отсутствующих ключей.
+`Tolgee` решает многие из упомянутых ранее проблем. Мне показалось, что его сложнее внедрить, чем аналогичные инструменты. Он не обеспечивает типобезопасность, что также затрудняет отлов отсутствующих ключей на этапе компиляции. Мне пришлось обернуть функции 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` ради объективности, так как это мое собственное решение.