@intlayer/docs 9.5.7 → 9.5.8

package/docs/en-GB/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Upgrade Intlayer packages
+description: Learn how to use the Intlayer CLI upgrade command to list every Intlayer package of your project or monorepo and upgrade them to the latest version.
+keywords:
+  - CLI
+  - Upgrade
+  - Update
+  - Packages
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Add upgrade command"
+author: aymericzip
+---
+
+# Upgrade Intlayer Packages
+
+```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
+```
+
+The `upgrade` command lists the Intlayer packages declared in every `package.json` of your project, including monorepo workspaces, and upgrades them to the latest published version. It runs the same package upgrade step as `intlayer init`, on its own.
+
+## Arguments:
+
+- `--project-root [projectRoot]` - Optional. The project root directory. By default, the command starts from the nearest `package.json` above the current working directory.
+- `--dry-run` - Optional. Lists the packages and their target version without modifying any file.
+- `--tag <tag>` - Optional. The npm dist-tag to upgrade to (for example `canary`). Defaults to `latest`.
+
+## What it does:
+
+1. **Lists the Intlayer packages** - Scans every `package.json` of the project (skipping `node_modules` and build outputs) for `intlayer`, `@intlayer/*`, `*-intlayer` and `intlayer-*` dependencies and dev dependencies.
+2. **Fetches the target version** - Reads the version of the selected dist-tag (`latest` by default) of each package from the npm registry.
+3. **Rewrites the ranges** - Updates each outdated range in place, keeping its operator (`^`, `~` or none) and the file indentation.
+4. **Installs once** - Runs a single install from the workspace root (the nearest directory with a lock file), using the package manager that owns the lock file:
+
+| Lock file                      | Command        |
+| ------------------------------ | -------------- |
+| `bun.lock` / `bun.lockb`       | `bun install`  |
+| `pnpm-lock.yaml`               | `pnpm install` |
+| `yarn.lock`                    | `yarn install` |
+| `package-lock.json` or no lock | `npm install`  |
+
+If there is no lock file, the `packageManager` field of `package.json` (for example `"bun@1.2.0"`) is used before falling back to npm.
+
+Ranges that do not point to the registry, such as `workspace:*`, `file:`, `link:`, `catalog:` or git URLs, are never modified.
+
+## Examples:
+
+### List the available upgrades without applying them:
+
+```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
+```
+
+### Upgrade to the canary release:
+
+```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
+```
+
+## Example output:
+
+```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
+```
+
+## Notes:
+
+- Run the command from the root of your repository to upgrade every workspace. Run it from a workspace to upgrade that workspace only.
+- Packages whose version cannot be fetched (offline, private or unpublished package) are listed and left unchanged.
+- If the install fails, the upgraded ranges are kept in `package.json`. Run your package manager's install command manually.

package/docs/es/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: La mejor solución i18n para Next.js en 2026 - Informe de Benchmark
 description: Compara librerías de internacionalización (i18n) para Next.js como next-intl, next-i18next e Intlayer. Informe detallado de rendimiento sobre tamaño del bundle, fugas y reactividad.
 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: "Actualización de los resultados del benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Actualización de los resultados del benchmark"
@@ -212,7 +215,7 @@ Finalmente, en comparación con otras soluciones, Paraglide no usa un almacén (
 
 **(Tolgee)** (`@tolgee/react@7.2.0`):
 
-`Tolgee` aborda muchos de los problemas mencionados anteriormente. Me resultó más difícil de adoptar que herramientas similares. No proporciona seguridad de tipos (type safety), lo que también dificulta detectar claves faltantes en tiempo de compilación (build time). Tuve que envolver las funciones de Tolgee con las mías propias para añadir la detección de claves faltantes.
+`Tolgee` aborda muchos de los problemas mencionados anteriormente. Me resultó más difícil de adoptar que herramientas similares. No proporciona seguridad de tipos (type safety), lo que también dificulta detectar claves faltantes en tiempo de compilación (build time). Tuve que envolver las funciones de Tolgee con las mías propias para añadir la detección de claves faltantes. El paquete también es relativamente pesado (~14.3kb, que es aproximadamente 2.8× `next-intlayer`).
 
 **(Next Intl)** (`next-intl@4.14.2`):
 
@@ -238,7 +241,7 @@ A menudo se elogia a `Lingui`. Personalmente, encontré el flujo de trabajo `lin
 
 `next-translate` es mi recomendación principal si te gusta una API de estilo `t()`. Es elegante a través de `next-translate-plugin`, cargando namespaces mediante `getStaticProps` con un cargador de Webpack / Turbopack. También es una de las opciones más ligeras aquí (~3.5kb). Para la segmentación por espacios de nombres, definirnamespaces por página o ruta en la configuración está bien pensado y es más fácil de mantener que las principales alternativas como **next-intl** o **next-i18next**. En la versión `3.1.2`, noté que el renderizado estático no funcionaba; Next.js recurría al renderizado dinámico.
 
-**(Intlayer)** (`next-intlayer@9.5.1`):
+**(Intlayer)** (`next-intlayer@9.5.6`):
 
 No seré yo quien juzgue personalmente a `next-intlayer` por objetividad, ya que es mi propia solución.
 

package/docs/es/benchmark/solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: La mejor solución i18n para Solid en 2026 - Informe de Benchmark
-description: Compara bibliotecas de internacionalización (i18n) para Solid como solid-primitives, solid-i18next e Intlayer. Informe de rendimiento detallado sobre el tamaño del bundle, fugas y reactividad.
+description: Compara bibliotecas de internacionalización (i18n) para Solid como solid-primitives, solid-i18next, Tolgee e Intlayer. Informe de rendimiento detallado sobre el tamaño del bundle, fugas y reactividad.
 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: "Actualización de los resultados del benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Actualización de los resultados del benchmark"
@@ -68,6 +71,7 @@ El otro impacto es en la experiencia del desarrollador (DX): cómo se declara el
 - **Intlayer**: Opción recomendada para aplicaciones Solid profesionales que necesitan características avanzadas y optimización (v9.5.6).
 - **@solid-primitives/i18n**: Excelente alternativa ligera para proyectos simples, aunque carece de características avanzadas como la carga diferida (lazy loading).
 - **solid-i18next**: Opción estándar pero pesada (~3.5× Intlayer) con los mismos inconvenientes que React i18next.
+- **Tolgee**: Plataforma de traducción completa, pero bastante pesada (~12.7kb, aproximadamente 3.0× Intlayer), carece de primitivas nativas para Solid (se basa en @tolgee/web), y en configuraciones estáticas presenta fugas considerables entre páginas (90% de fuga de página).
 - **Paraglide**: Enfoque innovador pero DX compleja y problemas de tree-shaking en algunas configuraciones.
 
 ## Pruebe su aplicación
@@ -103,6 +107,7 @@ Para este benchmark, comparamos las siguientes bibliotecas:
 - [`solid-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/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)
 
 El framework es `Solid` con una aplicación multilingüe de **10 páginas** y **10 idiomas**.
@@ -147,7 +152,7 @@ Ejecuté la misma aplicación multilingüe en un navegador real para cada stack,
 
 Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto, la confianza de la comunidad y la relevancia a largo plazo. Si bien no son una medida directa de la calidad técnica, reflejan cuántos desarrolladores encuentran útil el proyecto, siguen su progreso y es probable que lo adopten. Para estimar el valor de un proyecto, las estrellas ayudan a comparar la tracción entre alternativas y brindan información sobre el crecimiento del ecosistema.
 
-[![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)
 
 ## Resultados detallados
 
@@ -170,6 +175,18 @@ Aun así, comparte las mismas desventajas principales que las pilas construidas
 Solid primitive es extremadamente ligero y eficiente. Recomiendo esa solución para proyectos ligeros, pero puede carecer rápidamente de características para soluciones profesionales que incluyan gestión de cookies, redirección de proxy, formateadores, etc.
 También carece de carga diferida (lazy loading) y segmentación de namespaces para la optimización del tamaño de la página.
 
+**(Tolgee)** (`@tolgee/web@7.2.0`):
+
+`Tolgee` ofrece una plataforma integral de gestión de traducciones con funciones de edición in-context.
+
+En Solid, actualmente no existe un adaptador nativo oficial (como `@tolgee/solid`), por lo que los desarrolladores deben integrarlo mediante `@tolgee/web` con señales personalizadas.
+
+El paquete es relativamente pesado (~12.7kb, aproximadamente 3.0× `solid-intlayer`).
+
+Sin un mecanismo granular de división por página en Solid, todas las traducciones se cargan en memoria desde el inicio en configuraciones estáticas. Esto genera una fuga considerable en el bundle (44.5% de fuga de idioma, 90.0% de fuga de página) y paquetes de página promedio de ~91.8kb (frente a ~35.8kb para Intlayer).
+
+La reactividad al cambiar de idioma es muy rápida (0.6ms), aprovechando la reactividad de grano fino de Solid, aunque la sobrecarga de hidratación es mayor (~5.6ms frente a ~3.0ms para Intlayer).
+
 **(Paraglide)** (`@inlang/paraglide-js@2.25.1`):
 
 `Paraglide` ofrece un enfoque innovador y bien pensado. Aun así, en este benchmark, el tree-shaking que su empresa publicita no funcionó para mi implementación. El flujo de trabajo y la DX también son más complejos que en otras opciones.
@@ -178,7 +195,7 @@ Finalmente, en comparación con otras soluciones, Paraglide no utiliza un almac
 
 ### 3 - Recomendaciones
 
-**(Intlayer)** (`solid-intlayer@9.5.0`):
+**(Intlayer)** (`solid-intlayer@9.5.6`):
 
 No juzgaré personalmente `solid-intlayer` por objetividad, ya que es mi propia solución.
 

package/docs/es/benchmark/svelte.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: La mejor solución i18n para Svelte en 2026 - Informe de Benchmark
-description: Compara bibliotecas de internacionalización (i18n) para Svelte como svelte-i18n, Paraglide e Intlayer. Informe de rendimiento detallado sobre el tamaño del bundle, fugas y reactividad.
+description: Compara bibliotecas de internacionalización (i18n) para Svelte como svelte-i18n, Paraglide, Tolgee e Intlayer. Informe de rendimiento detallado sobre el tamaño del bundle, fugas y reactividad.
 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: "Actualización de los resultados del benchmark"
@@ -67,6 +70,7 @@ El otro impacto es en la experiencia del desarrollador (DX): cómo se declara el
 
 - **Intlayer**: La opción más eficiente en cuanto a rendimiento (v9.5.6) con la menor huella.
 - **Paraglide**: Candidato fuerte para el tree-shaking pero tiene una experiencia de desarrollador más compleja y sobrecarga de reactividad.
+- **Tolgee**: Plataforma de traducción completa con edición in-context, pero bastante pesada (~13.0kb, aproximadamente 3.6× Intlayer), y en configuraciones estáticas presenta fugas considerables entre páginas (90% de fuga de página).
 - **svelte-i18n**: Completo y estándar para Svelte, pero conlleva un peso de paquete mucho mayor (~4.5 veces Intlayer).
 
 ## Pruebe su aplicación
@@ -101,6 +105,7 @@ Para este benchmark, comparamos las siguientes bibliotecas:
 - `Base App` (Sin biblioteca i18n)
 - [`svelte-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/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)
 
 El framework es `Svelte` con una aplicación multilingüe de **10 páginas** y **10 idiomas**.
@@ -145,7 +150,7 @@ Ejecuté la misma aplicación multilingüe en un navegador real para cada stack,
 
 Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto, la confianza de la comunidad y la relevancia a largo plazo. Si bien no son una medida directa de la calidad técnica, reflejan cuántos desarrolladores encuentran útil el proyecto, siguen su progreso y es probable que lo adopten. Para estimar el valor de un proyecto, las estrellas ayudan a comparar la tracción entre alternativas y brindan información sobre el crecimiento del ecosistema.
 
-[![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)
 
 ## Resultados detallados
 
@@ -165,6 +170,16 @@ Finalmente, en comparación con otras soluciones, Paraglide no utiliza un almac
 
 > Nota sobre paraglide: la solución inyecta código en su base de código para las importaciones; como resultado, la métrica 'lib size' en el informe de benchmark es casi 0. La generación de código es algo bueno, porque la función utilizada incluirá solo la lógica necesaria (prefijo en todas partes vs sin prefijo, cookie vs almacenamiento, etc.). En comparación, Intlayer realiza este filtrado mediante inyecciones de variables de entorno durante la compilación para obligar al bundler a realizar tree-shaking del contenido según la lógica. Gracias a esto, paraglide e intlayer terminan siendo soluciones de 6 a 10 veces más ligeras que i18next o next-intl.
 
+**(Tolgee)** (`@tolgee/svelte@7.2.1`):
+
+`Tolgee` ofrece una plataforma de localización todo en uno con edición in-context e integración oficial para Svelte mediante `@tolgee/svelte`.
+
+El paquete es relativamente pesado (~13.0kb, aproximadamente 3.6× `svelte-intlayer`).
+
+Sin una división granular por página en Svelte, todas las traducciones se cargan en memoria desde el inicio en configuraciones estáticas. Esto genera una fuga considerable en el bundle (50.0% de fuga de idioma, 90.0% de fuga de página) y paquetes de página promedio de ~100.7kb (frente a ~59.0kb para Intlayer).
+
+La reactividad al cambiar de idioma es muy rápida (0.5ms), beneficiándose de los stores reactivos de Svelte, aunque la sobrecarga de hidratación es ligeramente mayor (~6.2ms frente a ~5.5ms para Intlayer).
+
 **(svelte-i18n)** (`svelte-i18n@4.0.1`):
 
 Esta solución satisface todas las necesidades de i18n en un proyecto Svelte. Pero como es el caso de i18next u otras soluciones importantes, es un poco pesada (~16.6kb, aproximadamente 4.5 veces `svelte-intlayer`).

package/docs/es/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: La mejor solución i18n para TanStack Start en 2026 - Informe de Benchmark
 description: Compara librerías de internacionalización para TanStack Start como react-i18next, use-intl e Intlayer. Informe detallado de rendimiento sobre tamaño del bundle, fugas y reactividad.
 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: "Actualización de los resultados del benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Actualización de los resultados del benchmark"
@@ -200,7 +203,7 @@ La idea detrás de `Wuchale` es interesante pero todavía no es una solución vi
 
 `Tolgee` aborda muchos de los problemas mencionados anteriormente. Me resultó más difícil empezar con ella que con otras herramientas con enfoques similares. No proporciona seguridad de tipos, lo que también dificulta mucho detectar claves faltantes en tiempo de compilación (build time). Tuve que envolver las API de Tolgee con las mías propias para añadir la detección de claves faltantes.
 
-El package es bastante pesado (~11.1kb, lo que es más de 2× `react-intlayer`).
+El package es bastante pesado (~13.8 kb, lo que es más de 2.9× `react-intlayer`).
 
 En TanStack Start también tuve problemas de reactividad: al cambiar de idioma, tuve que forzar el renderizado del proveedor y suscribirme a eventos de cambio de idioma para que la carga en otro idioma se comportara correctamente.
 
@@ -234,7 +237,7 @@ El package también es pesado (~15.3kb, lo que es aproximadamente 3× `react-int
 
 Este benchmark de TanStack Start no tiene un equivalente directo a `next-translate` (plugin de Next.js + `getStaticProps`). Para los equipos que realmente quieren una API `t()` con un ecosistema maduro, `react-i18next` y `use-intl` siguen siendo opciones "razonables", pero prepárate para invertir mucho tiempo optimizando para evitar fugas.
 
-**(Intlayer)** (`react-intlayer@9.5.1`):
+**(Intlayer)** (`react-intlayer@9.5.6`):
 
 No seré yo quien juzgue personalmente a `react-intlayer` por objetividad, ya que es mi propia solución.
 

package/docs/es/benchmark/vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: La mejor solución i18n para Vue en 2026 - Informe de Benchmark
-description: Compara bibliotecas de internacionalización (i18n) para Vue como vue-i18n, fluent-vue e Intlayer. Informe de rendimiento detallado sobre el tamaño del bundle, fugas y reactividad.
+description: Compara bibliotecas de internacionalización (i18n) para Vue como vue-i18n, fluent-vue, Tolgee e Intlayer. Informe de rendimiento detallado sobre el tamaño del bundle, fugas y reactividad.
 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: "Actualización de los resultados del benchmark y adición de Tolgee"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Actualización de los resultados del benchmark"
@@ -66,6 +69,7 @@ El otro impacto es en la experiencia del desarrollador (DX): cómo se declara el
 ## TL;DR
 
 - **Intlayer**: La solución más ligera (v9.5.6) con segmentación (scoping) y carga dinámica nativas.
+- **Tolgee**: Carga dinámica eficaz sin fugas en modo dinámico, pero más pesado (~3.7× Intlayer) y carece de seguridad de tipos en tiempo de compilación.
 - **vue-i18n**: El estándar de la industria con un ecosistema rico, pero puede ser significativamente más pesado y difícil de optimizar para el code-splitting en aplicaciones grandes.
 - **fluent-vue**: Organización innovadora de mensajes pero carece de seguridad de tipos y resulta ser una solución extremadamente pesada.
 
@@ -103,6 +107,7 @@ Para este benchmark, comparamos las siguientes bibliotecas:
 - [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/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)
 
 El framework es `Vue` con una aplicación multilingüe de **10 páginas** y **10 idiomas**.
 
@@ -146,7 +151,7 @@ Ejecuté la misma aplicación multilingüe en un navegador real para cada stack
 
 Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto, la confianza de la comunidad y la relevancia a largo plazo. Si bien no son una medida directa de la calidad técnica, reflejan cuántos desarrolladores encuentran útil el proyecto, siguen su progreso y es probable que lo adopten. Para estimar el valor de un proyecto, las estrellas ayudan a comparar la tracción entre alternativas y brindan información sobre el crecimiento del ecosistema.
 
-[![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 en detalle
 
@@ -156,11 +161,15 @@ Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto
 
 ### 2 - Soluciones aceptables
 
+**(Tolgee)** (`@tolgee/vue@7.2.0`):
+
+`Tolgee` aborda muchos de los problemas mencionados anteriormente, ofreciendo carga dinámica que elimina con éxito las fugas de locale y de página (reduciendo el JS de la página a ~58.8kb). Sin embargo, no proporciona seguridad de tipos en tiempo de compilación para las claves de forma predeterminada, lo que dificulta la detección de claves faltantes. Además, la biblioteca es relativamente pesada (~13.8kb, que es aproximadamente 3.7× `vue-intlayer`).
+
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
 - **vue-i18n** es sin duda la biblioteca de i18n más utilizada para Vue, tiene muchas características y un ecosistema enorme. Pero bajo el capó la solución es bastante pesada. Aunque vue-i18n integra carga diferida para los mensajes, carece de una función de segmentación (scoping). En el caso de una aplicación Vue SPA clásica no hay problema, pero para una aplicación Nuxt que utiliza @nuxt/i18n, esto lleva a incluir los mensajes de todas las páginas en una sola. Para una aplicación Nuxt grande con más de 10 páginas, puede volverse realmente problemático.
 
-El paquete es muy pesado (~24.3kb, aproximadamente 6 veces `vue-intlayer`).
+El paquete es muy pesado (~24.1 kb, aproximadamente 6 veces `vue-intlayer`).
 
 **(fluent-vue)** (`fluent-vue@3.8.2`):
 
@@ -168,6 +177,6 @@ El paquete es muy pesado (~24.3kb, aproximadamente 6 veces `vue-intlayer`).
 
 ### 3 - Recomendaciones
 
-**(Intlayer)** (`vue-intlayer@9.5.0`):
+**(Intlayer)** (`vue-intlayer@9.5.6`):
 
 No juzgaré personalmente `vue-intlayer` por objetividad, ya que es mi propia solución.

package/docs/es/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-21
+updatedAt: 2026-09-23
 title: CLI - Todas las comandos de Intlayer CLI para su sitio web multilingüe
 description: Descubra cómo usar Intlayer CLI para gestionar su sitio web multilingüe. Siga los pasos de esta documentación en línea para configurar su proyecto en pocos minutos.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Agregar el comando upgrade"
   - version: 9.5.6
     date: 2026-09-21
     changes: "Agregar el comando init infra"
@@ -155,6 +158,7 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulte
 
 - **[Inicializar Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/init.md)** - Configure Intlayer en su proyecto con configuración automática
 - **[Configurar infraestructura](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/infra.md)** - Instala la aplicación de escritorio o autoaloja el CMS con Docker (todo en uno o Compose)
+- **[Actualizar paquetes de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/upgrade.md)** - Lista los paquetes de Intlayer de cada `package.json` y actualízalos a la última versión
 - **[Gestionar configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/configuration.md)** - Obtenga y envíe su configuración de Intlayer al CMS
 
 ### Gestión de documentación
@@ -182,6 +186,7 @@ Para ver cómo configurar los locales disponibles u otros 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/es/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Actualizar paquetes de Intlayer
+description: Aprenda a usar el comando upgrade de Intlayer CLI para listar cada paquete de Intlayer de su proyecto o monorepo y actualizarlos a la última versión.
+keywords:
+  - CLI
+  - Upgrade
+  - Actualizar
+  - Paquetes
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Agregar el comando upgrade"
+author: aymericzip
+---
+
+# Actualizar paquetes de 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
+```
+
+El comando `upgrade` lista los paquetes de Intlayer declarados en cada `package.json` de su proyecto, incluidos los workspaces de un monorepo, y los actualiza a la última versión publicada. Ejecuta el mismo paso de actualización de paquetes que `intlayer init`, de forma independiente.
+
+## Argumentos:
+
+- `--project-root [projectRoot]` - Opcional. El directorio raíz del proyecto. Por defecto, el comando comienza desde el `package.json` más cercano encima del directorio de trabajo actual.
+- `--dry-run` - Opcional. Lista los paquetes y su versión de destino sin modificar ningún archivo.
+- `--tag <tag>` - Opcional. El dist-tag de npm al que actualizar (por ejemplo `canary`). Por defecto es `latest`.
+
+## Qué hace:
+
+1. **Lista los paquetes de Intlayer** - Escanea cada `package.json` del proyecto (omitiendo `node_modules` y salidas de build) en busca de dependencias y devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` e `intlayer-*`.
+2. **Obtiene la versión de destino** - Lee la versión del dist-tag seleccionado (`latest` por defecto) de cada paquete desde el registro de npm.
+3. **Reescribe los rangos** - Actualiza cada rango desactualizado directamente en el archivo, conservando su operador (`^`, `~` o ninguno) y la indentación del archivo.
+4. **Instala una sola vez** - Ejecuta una sola instalación desde la raíz del workspace (el directorio más cercano con un lock file), usando el gestor de paquetes propietario del lock file:
+
+| Lock file                      | Comando        |
+| ------------------------------ | -------------- |
+| `bun.lock` / `bun.lockb`       | `bun install`  |
+| `pnpm-lock.yaml`               | `pnpm install` |
+| `yarn.lock`                    | `yarn install` |
+| `package-lock.json` o sin lock | `npm install`  |
+
+Si no hay ningún lock file, se utiliza el campo `packageManager` de `package.json` (por ejemplo `"bun@1.2.0"`) antes de recurrir a npm.
+
+Los rangos que no apuntan al registro, como `workspace:*`, `file:`, `link:`, `catalog:` o URLs de git, nunca se modifican.
+
+## Ejemplos:
+
+### Listar las actualizaciones disponibles sin aplicarlas:
+
+```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
+```
+
+### Actualizar a la versión 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
+```
+
+## Salida de ejemplo:
+
+```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:
+
+- Ejecute el comando desde la raíz de su repositorio para actualizar todos los workspaces. Ejecútelo desde un workspace para actualizar únicamente ese workspace.
+- Los paquetes cuya versión no se puede obtener (sin conexión, paquete privado o no publicado) se listan y se dejan sin cambios.
+- Si la instalación falla, los rangos actualizados se conservan en `package.json`. Ejecute manualmente el comando de instalación de su gestor de paquetes.

package/docs/fr/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: La meilleure solution i18n pour Next.js en 2026 - Rapport de Benchmark
 description: Comparez les bibliothèques d'internationalisation (i18n) pour Next.js comme next-intl, next-i18next et Intlayer. Rapport de performance détaillé sur la taille du bundle, les fuites et la réactivité.
 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: "Mise à jour des résultats du benchmark"
   - version: 9.5.1
     date: 2026-09-11
     changes: "Mise à jour des résultats du benchmark"
@@ -213,7 +216,7 @@ Enfin, par rapport aux autres solutions, Paraglide n'utilise pas de "store" (ex:
 
 **(Tolgee)** (`@tolgee/react@7.2.0`) :
 
-`Tolgee` traite bon nombre des problèmes mentionnés plus haut. Je l'ai trouvé plus difficile à adopter que des outils similaires. Il n'offre pas de sécurité de type (type safety), ce qui rend également plus difficile la détection des clés manquantes à la compilation. J'ai dû wrapper les fonctions de Tolgee avec les miennes pour ajouter la détection des clés manquantes.
+`Tolgee` traite bon nombre des problèmes mentionnés plus haut. Je l'ai trouvé plus difficile à adopter que des outils similaires. Il n'offre pas de sécurité de type (type safety), ce qui rend également plus difficile la détection des clés manquantes à la compilation. J'ai dû wrapper les fonctions de Tolgee avec les miennes pour ajouter la détection des clés manquantes. Le paquet est également relativement lourd (~14.3 Ko, soit environ 2.8× `next-intlayer`).
 
 **(Next Intl)** (`next-intl@4.14.2`) :
 
@@ -239,7 +242,7 @@ Les formats de messages diffèrent également : `next-intl` utilise ICU MessageF
 
 `next-translate` est ma recommandation principale si vous aimez une API de style `t()`. C'est élégant via `next-translate-plugin`, chargeant les namespaces via `getStaticProps` avec un loader Webpack / Turbopack. C'est aussi l'une des options les plus légères ici (env. 3,5 Ko). Pour le découpage en namespaces, la définition par page ou par route dans la config est bien pensée et plus facile à maintenir que les alternatives principales comme **next-intl** ou **next-i18next**. Dans la version `3.1.2`, j'ai noté que le rendu statique ne fonctionnait pas ; Next.js se repliait sur le rendu dynamique.
 
-**(Intlayer)** (`next-intlayer@9.5.1`) :
+**(Intlayer)** (`next-intlayer@9.5.6`) :
 
 Je ne jugerai pas personnellement `next-intlayer` par souci d'objectivité, puisqu'il s'agit de ma propre solution.