@intlayer/docs 7.5.10 → 7.5.12

package/docs/en-GB/plugins/sync-json.md

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // required
   location?: string, // optional label, default: "plugin"
   priority?: number, // optional priority for conflict resolution, default: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // optional formatter, default: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // optional formatter, used for intlayer runtime compatibility
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Specifies the formatter to use for the dictionary content when synchronising JSON files. This allows using different message formatting syntaxes compatible with various i18n libraries.
+Specifies the formatter to use for the dictionary content when synchronising JSON files. This allows using different message formatting syntaxes compatible with intlayer runtime.
 
+- `undefined`: No formatter will be used, the JSON content will be used as is.
 - `'intlayer'`: The default Intlayer formatter (default).
 - `'icu'`: Uses ICU message formatting (compatible with libraries like react-intl, vue-i18n).
 - `'i18next'`: Uses i18next message formatting (compatible with i18next, next-i18next, Solid-i18next).
 
+> Note that using a formatter will transform your JSON content in input, and output. For complex json rules as ICU plurals, the parsing may not ensure a 1 to 1 mapping between the input and output.
+> If you do not use Intlayer runtime, you may prefer to not set a formatter.
+
 **Example:**
 
 ```ts

package/docs/es/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Comando CI
+description: Aprende a usar el comando Intlayer CI para ejecutar comandos Intlayer con credenciales auto-inyectadas en pipelines CI/CD y monorepos.
+keywords:
+  - CI
+  - CI/CD
+  - Automatización
+  - Monorepo
+  - Credenciales
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Agregar comando CI
+---
+
+# Comando CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+El comando CI está diseñado para automatización y pipelines CI/CD. Inyecta automáticamente credenciales desde la variable de entorno `INTLAYER_PROJECT_CREDENTIALS` y puede ejecutar comandos Intlayer en múltiples proyectos en un monorepo.
+
+## Cómo funciona
+
+El comando CI opera en dos modos:
+
+1. **Modo de proyecto único**: Si el directorio de trabajo actual coincide con una de las rutas de proyecto en `INTLAYER_PROJECT_CREDENTIALS`, ejecuta el comando solo para ese proyecto específico.
+
+2. **Modo de iteración**: Si no se detecta un contexto de proyecto específico, itera sobre todos los proyectos configurados y ejecuta el comando para cada uno.
+
+## Variable de entorno
+
+El comando requiere que se establezca la variable de entorno `INTLAYER_PROJECT_CREDENTIALS`. Esta variable debe contener un objeto JSON que mapee las rutas de proyecto a sus credenciales:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Detección del gestor de paquetes
+
+El comando CI detecta automáticamente qué gestor de paquetes se está usando (npm, yarn, pnpm o bun) basándose en la variable de entorno `npm_config_user_agent` y usa el comando apropiado para ejecutar Intlayer.
+
+## Argumentos
+
+- **`<command...>`**: El comando Intlayer a ejecutar (por ejemplo, `fill`, `push`, `build`). Puedes pasar cualquier comando Intlayer y sus argumentos.
+
+  > Ejemplo: `npx intlayer ci fill --verbose`
+  >
+  > Ejemplo: `npx intlayer ci push`
+  >
+  > Ejemplo: `npx intlayer ci build`
+
+## Ejemplos
+
+### Ejecutar un comando en modo de proyecto único
+
+Si estás en un directorio de proyecto que coincide con una de las rutas en `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Esto ejecutará el comando `fill` con las credenciales inyectadas automáticamente para el proyecto `packages/app`.
+
+### Ejecutar un comando en todos los proyectos
+
+Si estás en un directorio que no coincide con ninguna ruta de proyecto, el comando iterará sobre todos los proyectos configurados:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Esto ejecutará el comando `push` para cada proyecto configurado en `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Pasar banderas adicionales
+
+Puedes pasar cualquier bandera al comando Intlayer subyacente:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Usar en pipelines CI/CD
+
+En tu configuración CI/CD (por ejemplo, GitHub Actions, GitLab CI), establece `INTLAYER_PROJECT_CREDENTIALS` como secreto:
+
+```yaml
+# Ejemplo de GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Llenar diccionarios
+    run: npx intlayer ci fill
+```
+
+## Manejo de errores
+
+- Si `INTLAYER_PROJECT_CREDENTIALS` no está establecida, el comando saldrá con un error.
+- Si `INTLAYER_PROJECT_CREDENTIALS` no es un JSON válido, el comando saldrá con un error.
+- Si una ruta de proyecto no existe, se omitirá con una advertencia.
+- Si algún proyecto falla, el comando saldrá con un código de estado distinto de cero.
+
+## Casos de uso
+
+- **Automatización de monorepo**: Ejecutar comandos Intlayer en múltiples proyectos en un monorepo
+- **Pipelines CI/CD**: Automatizar la gestión de diccionarios en flujos de trabajo de integración continua
+- **Operaciones masivas**: Realizar la misma operación en múltiples proyectos Intlayer a la vez
+- **Gestión de secretos**: Gestionar de forma segura las credenciales para múltiples proyectos usando variables de entorno
+
+## Mejores prácticas de seguridad
+
+- Almacena `INTLAYER_PROJECT_CREDENTIALS` como secretos cifrados en tu plataforma CI/CD
+- Nunca comprometas las credenciales en el control de versiones
+- Usa credenciales específicas del entorno para diferentes entornos de despliegue
+- Rota las credenciales regularmente

package/docs/es/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Descubre cómo usar el CLI de Intlayer para gestionar tu sitio web multilingüe. Sigue los pasos en esta documentación en línea para configurar tu proyecto en pocos minutos.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Añadir comando projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Añadir comando init
@@ -119,6 +122,7 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulta
 - **[Construir Diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/build.md)** - Construye tus diccionarios a partir de archivos de declaración de contenido
 - **[Observar Diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/watch.md)** - Observa cambios y construye diccionarios automáticamente
 - **[Verificar Versión CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/version.md)** - Verifica la versión instalada del CLI de Intlayer
+- **[Listar Proyectos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/list_projects.md)** - Lista todos los proyectos Intlayer en un directorio o repositorio git
 
 ### Gestión de Diccionarios
 
@@ -166,6 +170,7 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulta
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Para ver cómo configurar los locales disponibles u otros parámetros, consulta
 >
 > - `npx intlayer list` en lugar de `npx intlayer content list`
 > - `npx intlayer test` en lugar de `npx intlayer content test`
+> - `npx intlayer projects-list` o `npx intlayer pl` en lugar de `npx intlayer projects list`

package/docs/es/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Listar archivos de declaración de contenido
 description: Aprende cómo listar todos los archivos de declaración de contenido en tu proyecto.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Agregar opción de salida absoluta al comando list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Agregar opción de salida JSON al comando list
 ---
 
 # Listar archivos de declaración de contenido
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Este comando muestra todos los archivos de declaración de contenido en tu proyecto, mostrando sus claves de diccionario y rutas de archivo. Es útil para obtener una visión general de todos tus archivos de contenido y verificar que sean correctamente detectados por Intlayer.
 
-## Ejemplo:
+## Argumentos:
+
+- **`--json`**: Muestra los resultados como JSON en lugar de texto formateado. Útil para scripting y acceso programático.
+
+  > Ejemplo: `npx intlayer content list --json`
+
+## Ejemplos:
+
+### Listar archivos de declaración de contenido:
 
 ```bash
 npx intlayer content list
 ```
 
+### Salida como JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Salida como rutas absolutas:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Salida de ejemplo:
 
+### Salida formateada:
+
 ```bash
 npx intlayer content list
 Archivos de declaración de contenido:
@@ -45,6 +74,14 @@ Archivos de declaración de contenido:
 Total de archivos de declaración de contenido: 3
 ```
 
+### Salida JSON:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 Este comando mostrará:
 
 - Una lista formateada de todos los archivos de declaración de contenido con sus claves y rutas de archivo relativas

package/docs/es/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Listar proyectos de Intlayer
+description: Aprende cómo listar todos los proyectos de Intlayer en un directorio o repositorio git.
+keywords:
+  - Lista
+  - Proyectos
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Agregar opción de salida absoluta al comando list projects
+---
+
+# Listar proyectos de Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Este comando busca y lista todos los proyectos de Intlayer encontrando directorios que contienen archivos de configuración de Intlayer. Es útil para descubrir todos los proyectos de Intlayer en un monorepo, workspace o repositorio git.
+
+## Alias:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumentos:
+
+- **`--base-dir [path]`**: Especifica el directorio base desde el cual buscar. Por defecto es el directorio de trabajo actual.
+
+  > Ejemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Ejemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Buscar desde el directorio raíz de git en lugar del directorio base. Esto es útil para encontrar todos los proyectos de Intlayer en un monorepo o repositorio git.
+
+  > Ejemplo: `npx intlayer projects list --git-root`
+
+- **`--json`**: Muestra los resultados como JSON en lugar de texto formateado. Útil para scripting y acceso programático.
+
+  > Ejemplo: `npx intlayer projects list --json`
+
+- **`--absolute`**: Muestra los resultados como rutas absolutas en lugar de rutas relativas.
+
+  > Ejemplo: `npx intlayer projects list --absolute`
+
+## Cómo funciona:
+
+El comando busca archivos de configuración de Intlayer en el directorio especificado (o en la raíz del git si se usa `--git-root`). Busca los siguientes patrones de archivos de configuración:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Cada directorio que contenga uno de estos archivos se considera un proyecto de Intlayer y se listará en la salida.
+
+## Ejemplos:
+
+### Listar proyectos en el directorio actual:
+
+```bash
+npx intlayer projects list
+```
+
+### Listar proyectos en un directorio específico:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Listar todos los proyectos en el repositorio git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Usar el alias corto:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Salida como JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Ejemplo de salida:
+
+### Salida formateada:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Salida JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Casos de uso:
+
+- **Gestión de monorepos**: Descubrir todos los proyectos Intlayer en una estructura monorepo
+- **Descubrimiento de proyectos**: Encontrar todos los proyectos habilitados con Intlayer en un workspace
+- **CI/CD**: Verificar proyectos Intlayer en flujos de trabajo automatizados
+- **Documentación**: Generar documentación que liste todos los proyectos que usan Intlayer
+
+La salida proporciona rutas absolutas a cada directorio de proyecto, lo que facilita la navegación hacia ellos o la automatización de operaciones sobre múltiples proyectos Intlayer.

package/docs/es/intlayer_CMS.md

@@ -71,6 +71,26 @@ Para la integración con Vite + React, consulta la [guía de configuración](htt
 
 ## Configuración
 
+Ejecuta el siguiente comando para iniciar sesión en el Intlayer CMS:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Esto abrirá tu navegador predeterminado para completar el proceso de autenticación y recibir las credenciales necesarias (Client ID y Client Secret) para usar los servicios de Intlayer.
+
 En tu archivo de configuración de Intlayer, puedes personalizar los ajustes del CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/es/intlayer_with_next-i18next.md

@@ -593,7 +593,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/es/intlayer_with_nextjs_14.md

@@ -81,6 +81,34 @@ El paquete que integra Intlayer con Next.js. Proporciona proveedores de contexto
 
 ### Paso 2: Configura tu proyecto
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Crea un archivo de configuración para configurar los idiomas de tu aplicación:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/es/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ bunx intlayer init
 
 ### Paso 2: Configura tu proyecto
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Crea un archivo de configuración para configurar los idiomas de tu aplicación:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/es/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ bunx intlayer init
 
 ### Paso 2: Configura tu proyecto
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Crea un archivo de configuración para configurar los idiomas de tu aplicación:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"