@intlayer/docs 7.2.3 → 7.3.0

package/docs/es/cli/fill.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Rellenar Diccionarios
+description: Aprende cómo rellenar, auditar y traducir tus diccionarios usando IA.
+keywords:
+  - Rellenar
+  - Auditar
+  - Traducir
+  - Diccionarios
+  - CLI
+  - Intlayer
+  - IA
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# Rellenar / auditar / traducir diccionarios
+
+```bash
+npx intlayer fill
+```
+
+Este comando analiza tus archivos de declaración de contenido en busca de posibles problemas como traducciones faltantes, inconsistencias estructurales o incompatibilidades de tipo. Si encuentra algún problema, **intlayer fill** propondrá o aplicará actualizaciones para mantener tus diccionarios consistentes y completos.
+
+## Alias:
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## Argumentos:
+
+**Opciones de lista de archivos:**
+
+- **`-f, --file [files...]`**: Una lista de archivos específicos de declaración de contenido para auditar. Si no se proporciona, se auditarán todos los archivos `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` descubiertos según la configuración de tu archivo.
+
+  > Ejemplo: `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`**: Filtrar diccionarios basados en claves. Si no se proporciona, se auditarán todos los diccionarios.
+
+  > Ejemplo: `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`**: Filtrar diccionarios basados en claves (alias de --keys).
+
+  > Ejemplo: `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`**: Excluir diccionarios basados en claves. Si no se proporciona, se auditarán todos los diccionarios.
+
+  > Ejemplo: `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`**: Excluir diccionarios basados en claves (alias de --excluded-keys).
+
+  > Ejemplo: `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`**: Filtrar diccionarios basados en patrones glob para rutas de archivos.
+
+  > Ejemplo: `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**Opciones de salida de entradas:**
+
+- **`--source-locale [sourceLocale]`**: La locale fuente desde la cual traducir. Si no se especifica, se usará la locale por defecto de tu configuración.
+
+- **`--output-locales [outputLocales...]`**: Locales destino a las cuales traducir. Si no se especifica, se usarán todas las locales de tu configuración excepto la locale fuente.
+
+- **`--mode [mode]`**: Modo de traducción: `complete`, `review`. Por defecto es `complete`. `complete` llenará todo el contenido faltante, `review` llenará el contenido faltante y revisará las claves existentes.
+
+**Opciones de Git:**
+
+- **`--git-diff`**: Ejecutar solo en diccionarios que incluyan cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
+- **`--git-diff-base`**: Especificar la referencia base para el git diff (por defecto `origin/main`).
+- **`--git-diff-current`**: Especificar la referencia actual para el git diff (por defecto `HEAD`).
+- **`--uncommitted`**: Incluir cambios no confirmados.
+- **`--unpushed`**: Incluir cambios no enviados.
+- **`--untracked`**: Incluir archivos no rastreados.
+
+  > Ejemplo: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ejemplo: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**Opciones de IA:**
+
+- **`--model [model]`**: El modelo de IA a usar para la traducción (por ejemplo, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: El proveedor de IA a usar para la traducción.
+- **`--temperature [temperature]`**: Configuración de temperatura para el modelo de IA.
+- **`--api-key [apiKey]`**: Proporciona tu propia clave API para el servicio de IA.
+- **`--custom-prompt [prompt]`**: Proporciona un prompt personalizado para tus instrucciones de traducción.
+- **`--application-context [applicationContext]`**: Proporciona contexto adicional para la traducción por IA.
+
+  > Ejemplo: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Mi aplicación es una tienda de gatos"`
+
+**Opciones de variables de entorno:**
+
+- **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`).
+- **`--env-file [envFile]`**: Proporciona un archivo de entorno personalizado desde el cual cargar las variables.
+
+  > Ejemplo: `npx intlayer fill --env-file .env.production.local`
+
+  > Ejemplo: `npx intlayer fill --env production`
+
+**Opciones de configuración:**
+
+- **`--base-dir`**: Especifica el directorio base para el proyecto.
+
+  > Ejemplo: `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`**: Deshabilita la caché.
+
+  > Ejemplo: `npx intlayer build --no-cache`
+
+**Opciones de preparación:**
+
+- **`--build`**: Construye los diccionarios antes de hacer push para asegurar que el contenido esté actualizado. True forzará la construcción, false la omitirá, undefined permitirá usar la caché de la construcción.
+
+- **`--skip-metadata`**: Omitir el llenado de metadatos faltantes (descripción, título, etiquetas) para los diccionarios.
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilitar el registro detallado para depuración. (por defecto en true usando CLI)
+
+## Ejemplo:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+Este comando traducirá el contenido del inglés al francés y español para todos los archivos de declaración de contenido en el directorio `src/home/` usando el modelo GPT-3.5 Turbo.

package/docs/es/cli/index.md

@@ -0,0 +1,163 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+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:
+  - CLI
+  - Interfaz de Línea de Comandos
+  - Internacionalización
+  - Documentación
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: Añadir comando transform
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: Añadir opción skipIfExists al comando translate
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: Añadir alias para argumentos y comandos del CLI
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: Añadir opción build a los comandos
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: Añadir comando version
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: Establecer la opción verbose por defecto a true usando CLI
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: Añadir comando watch y opción with
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: Añadir comando editor
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: Añadir comandos content test y list
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: Actualizar documentación de parámetros de comandos CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Inicializar historial
+---
+
+# Intlayer CLI
+
+---
+
+## Tabla de Contenidos
+
+<TOC/>
+
+---
+
+## Instalar Paquete
+
+Instala los paquetes necesarios usando npm:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> Si el paquete `intlayer` ya está instalado, el CLI se instala automáticamente. Puedes omitir este paso.
+
+## Paquete intlayer-cli
+
+El paquete `intlayer-cli` tiene como objetivo transpilar tus [declaraciones intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md) en diccionarios.
+
+Este paquete transpilará todos los archivos intlayer, como `src/**/*.content.{ts|js|mjs|cjs|json}`. [Consulta cómo declarar tus archivos de declaración Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+Para interpretar diccionarios intlayer puedes usar intérpretes, como [react-intlayer](https://www.npmjs.com/package/react-intlayer) o [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+
+## Soporte para Archivos de Configuración
+
+Intlayer acepta múltiples formatos de archivos de configuración:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Para ver cómo configurar los locales disponibles u otros parámetros, consulta la [documentación de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+
+## Ejecutar comandos de intlayer
+
+### Comandos principales
+
+- **[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
+
+### Gestión de Diccionarios
+
+- **[Enviar Diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/push.md)** - Envía diccionarios al editor y CMS de Intlayer
+- **[Extraer Diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/pull.md)** - Extrae diccionarios desde el editor y CMS de Intlayer
+- **[Rellenar Diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/fill.md)** - Rellena, audita y traduce diccionarios usando IA
+- **[Probar Traducciones Faltantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/test.md)** - Prueba e identifica traducciones faltantes
+- **[Listar Archivos de Declaración de Contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/list.md)** - Lista todos los archivos de declaración de contenido en tu proyecto
+
+### Gestión de Componentes
+
+- **[Transformar Componentes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/transform.md)** - Transforma componentes existentes para usar Intlayer
+
+### Configuración
+
+- **[Gestionar Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/configuration.md)** - Obtener y enviar tu configuración de Intlayer al CMS
+
+### Gestión de Documentación
+
+- **[Traducir Documento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/doc-translate.md)** - Traducir automáticamente archivos de documentación usando IA
+- **[Revisar Documento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/doc-review.md)** - Revisar archivos de documentación para calidad y consistencia
+
+### Editor y Sincronización en Vivo
+
+- **[Comandos del Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/editor.md)** - Usa los comandos del editor de Intlayer
+- **[Comandos de Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/live.md)** - Usa Live Sync para reflejar los cambios de contenido del CMS en tiempo de ejecución
+
+### Herramientas de Desarrollo
+
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/sdk.md)** - Usa el SDK CLI de Intlayer en tu propio código
+- **[Comando Debug de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/debug.md)** - Depura y soluciona problemas del CLI de Intlayer
+
+## Usa los comandos de intlayer en tu `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **Nota**: También puedes usar los alias más cortos:
+>
+> - `npx intlayer list` en lugar de `npx intlayer content list`
+> - `npx intlayer test` en lugar de `npx intlayer content test`

package/docs/es/cli/list.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+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:
+  - Listar
+  - Declaración de Contenido
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+---
+
+# Listar archivos de declaración de contenido
+
+```bash
+npx intlayer content list
+```
+
+## Alias:
+
+- `npx intlayer 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:
+
+```bash
+npx intlayer content list
+```
+
+## Salida de ejemplo:
+
+```bash
+npx intlayer content list
+Archivos de declaración de contenido:
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+Total de archivos de declaración de contenido: 3
+```
+
+Este comando mostrará:
+
+- Una lista formateada de todos los archivos de declaración de contenido con sus claves y rutas de archivo relativas
+- El conteo total de archivos de declaración de contenido encontrados
+
+La salida te ayuda a verificar que todos tus archivos de contenido estén correctamente configurados y sean detectables por el sistema Intlayer.

package/docs/es/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Comandos de Live Sync
+description: Aprende a usar Live Sync para reflejar cambios en el contenido del CMS en tiempo de ejecución.
+keywords:
+  - Live Sync
+  - CMS
+  - Tiempo de ejecución
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# Comandos de Live Sync
+
+Live Sync permite que tu aplicación refleje los cambios en el contenido del CMS en tiempo de ejecución. No se requiere reconstrucción ni redeploy. Cuando está habilitado, las actualizaciones se transmiten a un servidor de Live Sync que actualiza los diccionarios que tu aplicación lee. Consulta [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para más detalles.
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## Argumentos:
+
+**Opciones de configuración:**
+
+- **`--base-dir`**: Especifica el directorio base del proyecto. Para obtener la configuración de intlayer, el comando buscará el archivo `intlayer.config.{ts,js,json,cjs,mjs}` en el directorio base.
+
+- **`--no-cache`**: Desactiva la caché.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilita el registro detallado para depuración. (por defecto está activado usando CLI)

package/docs/es/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Extraer Diccionarios
+description: Aprende cómo extraer diccionarios desde el editor y CMS de Intlayer.
+keywords:
+  - Extraer
+  - Diccionarios
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# Extraer Diccionarios Remotos
+
+```bash
+npx intlayer pull
+```
+
+Si tienes instalado el [editor de intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md), también puedes extraer diccionarios desde el editor. De esta forma, puedes sobrescribir el contenido de tus diccionarios según las necesidades de tu aplicación.
+
+## Alias:
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## Argumentos:
+
+**Opciones de diccionario:**
+
+- **`-d, --dictionaries`**: Ids de los diccionarios a extraer. Si no se especifica, se extraerán todos los diccionarios.
+
+  > Ejemplo: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: Ids de los diccionarios a extraer (alias de --dictionaries).
+
+  > Ejemplo: `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Opciones de configuración:**
+
+- **`--base-dir`**: Especifica el directorio base para el proyecto. Para obtener la configuración de intlayer, el comando buscará el archivo `intlayer.config.{ts,js,json,cjs,mjs}` en el directorio base.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: Desactiva la caché.
+
+  > Ejemplo: `npx intlayer build --no-cache`
+
+**Opciones de variables de entorno:**
+
+- **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`).
+- **`--env-file`**: Proporciona un archivo de entorno personalizado para cargar variables.
+- **`--base-dir`**: Especifica el directorio base para el proyecto. Para obtener la configuración de intlayer, el comando buscará el archivo `intlayer.config.{ts,js,json,cjs,mjs}` en el directorio base.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Ejemplo: `npx intlayer dictionary push --env production`
+
+**Opciones de salida:**
+
+- **`--new-dictionaries-path`** : Ruta al directorio donde se guardarán los nuevos diccionarios. Si no se especifica, los nuevos diccionarios se guardarán en el directorio `./intlayer-dictionaries` del proyecto. Si se especifica un campo `filePath` en el contenido de tu diccionario, los diccionarios no considerarán este argumento y se guardarán en el directorio `filePath` especificado.
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilita el registro detallado para depuración. (por defecto es true usando la CLI)
+
+## Ejemplo:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```

package/docs/es/cli/push.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Empujar Diccionarios
+description: Aprende cómo empujar tus diccionarios al editor y CMS de Intlayer.
+keywords:
+  - Empujar
+  - Diccionarios
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - push
+---
+
+# Empujar Diccionarios
+
+```bash
+npx intlayer dictionary push
+```
+
+Si el [editor de intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) está instalado, también puedes empujar diccionarios al editor. Este comando permitirá que los diccionarios estén disponibles para [el editor](https://intlayer.org/dashboard). De esta manera, puedes compartir tus diccionarios con tu equipo y editar tu contenido sin modificar el código de tu aplicación.
+
+## Alias:
+
+- `npx intlayer dictionaries push`
+- `npx intlayer dictionary push`
+- `npx intlayer dic push`
+
+## Argumentos:
+
+**Opciones de diccionario:**
+
+- **`-d`, `--dictionaries`**: ids de los diccionarios a empujar. Si no se especifica, se empujarán todos los diccionarios.
+
+  > Ejemplo: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: ids de los diccionarios a empujar (alias de --dictionaries).
+
+  > Ejemplo: `npx intlayer dictionary push --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Opciones de configuración:**
+
+- **`--base-dir`**: Especifica el directorio base del proyecto. Para obtener la configuración de intlayer, el comando buscará el archivo `intlayer.config.{ts,js,json,cjs,mjs}` en el directorio base.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: Deshabilita la caché.
+
+  > Ejemplo: `npx intlayer build --no-cache`
+
+**Opciones de variables de entorno:**
+
+- **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`). Útil en caso de que uses variables de entorno en tu archivo de configuración de intlayer.
+- **`--env-file`**: Proporciona un archivo de entorno personalizado para cargar variables. Útil en caso de que uses variables de entorno en tu archivo de configuración de intlayer.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Ejemplo: `npx intlayer dictionary push --env production`
+
+**Opciones de salida:**
+
+- **`-r`, `--delete-locale-dictionary`**: Omite la pregunta que solicita eliminar los directorios de locales una vez que los diccionarios son enviados, y los elimina. Por defecto, si el diccionario está definido localmente, sobrescribirá el contenido de los diccionarios remotos.
+
+  > Ejemplo: `npx intlayer dictionary push -r`
+
+  > Ejemplo: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: Omite la pregunta que solicita eliminar los directorios de locales una vez que los diccionarios son enviados, y los conserva. Por defecto, si el diccionario está definido localmente, sobrescribirá el contenido de los diccionarios remotos.
+
+  > Ejemplo: `npx intlayer dictionary push -k`
+
+  > Ejemplo: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**Opciones de preparación:**
+
+- **`--build`**: Construye los diccionarios antes de enviarlos para asegurar que el contenido esté actualizado. True forzará la construcción, false la omitirá, undefined permitirá usar la caché de la construcción.
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilita el registro detallado para depuración. (por defecto true usando CLI)
+
+**Opciones de Git:**
+
+- **`--git-diff`**: Solo ejecuta en diccionarios que incluyen cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
+- **`--git-diff-base`**: Especifica la referencia base para git diff (por defecto `origin/main`).
+- **`--git-diff-current`**: Especifica la referencia actual para git diff (por defecto: `HEAD`).
+- **`--uncommitted`**: Incluye cambios no confirmados.
+- **`--unpushed`**: Incluye cambios no enviados.
+- **`--untracked`**: Incluye archivos no rastreados.
+
+  > Ejemplo: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ejemplo: `npx intlayer dictionary push --uncommitted --unpushed --untracked`

package/docs/es/cli/sdk.md

@@ -0,0 +1,67 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: SDK CLI
+description: Aprende cómo usar el SDK CLI de Intlayer en tu propio código.
+keywords:
+  - SDK
+  - CLI
+  - Intlayer
+  - Programático
+slugs:
+  - doc
+  - concept
+  - cli
+  - sdk
+---
+
+# SDK CLI
+
+El SDK CLI es una biblioteca que te permite usar el CLI de Intlayer en tu propio código.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+Ejemplo de uso:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  listContentDeclaration,
+  testMissingTranslations,
+  docTranslate,
+  docReview,
+  transform,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+listContentDeclaration();
+// ...
+testMissingTranslations();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+transform();
+// ...
+```