@intlayer/docs 5.5.8

package/es/per_locale_file.md

@@ -0,0 +1,293 @@
+# Intlayer admite dos formas de declarar contenido multilingüe:
+
+- Archivo único con todas las traducciones
+- Un archivo por idioma (formato por idioma)
+
+Esta flexibilidad permite:
+
+- Migración sencilla desde otras herramientas i18n
+- Soporte para flujos de trabajo de traducción automatizados
+- Organización clara de las traducciones en archivos separados y específicos por idioma
+
+## Archivo Único con Múltiples Traducciones
+
+Este formato es ideal para:
+
+- Iteración rápida en el código.
+- Integración fluida con el CMS.
+
+Este es el enfoque recomendado para la mayoría de los casos de uso. Centraliza las traducciones, facilitando la iteración e integración con el CMS.
+
+```tsx fileName="hello-world.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      es: "Título de mi componente",
+      en: "Title of my component",
+    }),
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      es: "Título de mi componente",
+      en: "Title of my component",
+    }),
+  },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.cjs" contentDeclarationFormat="json"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      es: "Título de mi componente",
+      en: "Title of my component",
+    }),
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "es": "Título de mi componente",
+        "en": "Title of my component"
+      }
+    }
+  }
+}
+```
+
+> Recomendado: Este formato es el mejor cuando se utiliza el editor visual de Intlayer o se gestionan traducciones directamente en el código.
+
+## Formato Por Idioma
+
+Este formato es útil cuando:
+
+- Deseas versionar o sobrescribir traducciones de forma independiente.
+- Estás integrando flujos de trabajo de traducción automática o manual.
+
+También puedes dividir las traducciones en archivos individuales por idioma especificando el campo `locale`:
+
+```tsx fileName="hello-world.en.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: { multilingualContent: "Title of my component" },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: { multilingualContent: "Título de mi componente" },
+};
+```
+
+```js fileName="hello-world.en.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: { multilingualContent: "Title of my component" },
+};
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: { multilingualContent: "Título de mi componente" },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.en.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: {
+    multilingualContent: "Title of my component",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: {
+    multilingualContent: "Título de mi componente",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "en", // Importante
+  "content": {
+    "multilingualContent": "Title of my component",
+  },
+}
+```
+
+```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "es", // Importante
+  "content": {
+    "multilingualContent": "Título de mi componente",
+  },
+}
+```
+
+> Importante: Asegúrate de que el campo `locale` esté definido. Indica a Intlayer qué idioma representa el archivo.
+
+> Nota: En ambos casos, el archivo de declaración de contenido debe seguir el patrón de nomenclatura `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconocido por Intlayer. El sufijo `.[locale]` es opcional y se utiliza solo como una convención de nomenclatura.
+
+## Mezcla de Formatos
+
+Puedes mezclar ambos enfoques para la misma clave de contenido. Por ejemplo:
+
+Declara contenido predeterminado o base de forma estática (por ejemplo, `index.content.ts`).
+
+Agrega o sobrescribe contenido específico por idioma en `index.content.json`, `index.fr.content.ts`, etc.
+
+Esto es especialmente útil cuando:
+
+- Deseas declarar tu contenido base de forma estática en tu base de código y completar automáticamente con traducciones en el CMS.
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.content.json
+        └── index.ts
+```
+
+### Ejemplo
+
+Aquí un archivo de declaración de contenido multilingüe:
+
+```tsx fileName="Components/MyComponent/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH,
+  content: {
+    multilingualContent: "Title of my component",
+    projectName: "My project",
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```json fileName="Components/MyComponent/index.content.json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "fr": "Titre de mon composant",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+Intlayer combina automáticamente archivos multilingües y por idioma.
+
+```tsx fileName="Components/MyComponent/index.ts"
+import { getIntlayer, Locales } from "intlayer";
+
+const intlayer = getIntlayer("hello-world"); // El idioma predeterminado es INGLÉS, por lo que devolverá el contenido en INGLÉS
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Resultado:
+// {
+//  "multilingualContent": "Title of my component",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.SPANISH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Resultado:
+// {
+//  "multilingualContent": "Título de mi componente",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.FRENCH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Resultado:
+// {
+//  "multilingualContent": "Titre de mon composant",
+//  "projectName": "My project"
+// }
+```
+
+### Generación Automática de Traducciones
+
+Usa el [CLI de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/es/intlayer_cli.md) para completar automáticamente traducciones faltantes basándote en tus servicios preferidos.

package/es/privacy_notice.md

@@ -0,0 +1,61 @@
+# Aviso de privacidad
+
+## Introducción
+
+En Intlayer, nos tomamos la privacidad en serio. Este aviso explica cómo manejamos la información recopilada a través de nuestro sitio web y CMS.
+
+## Contacto
+
+Si tienes alguna pregunta o inquietud sobre privacidad, por favor contáctanos en la siguiente dirección: [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Uso de Cookies y Tecnologías de Seguimiento
+
+Utilizamos **Google Analytics** y el **Meta (Facebook) Pixel** para analizar el uso de nuestro sitio web y mejorar nuestros servicios. Estas herramientas generan estadísticas y otra información sobre el sitio web utilizando cookies almacenadas en los dispositivos de los usuarios.
+
+Para más información:
+
+- [Política de privacidad de Google](https://policies.google.com/privacy)
+- [Política de privacidad de Meta](https://www.facebook.com/privacy/policy)
+
+## Autenticación y Datos de Usuario
+
+El acceso al CMS de Intlayer requiere autenticación de usuario. Ofrecemos autenticación mediante correo electrónico/contraseña y acceso a través de terceros como **Google** y **GitHub**.
+
+Durante el proceso de autenticación, recopilamos:
+
+- Dirección de correo electrónico
+- Nombre visible (o nombre elegido)
+
+Los usuarios también pueden acceder al CMS mediante tokens de acceso vinculados a su cuenta. Estos tokens están asociados con los mismos datos de autenticación.
+
+## Almacenamiento y Seguridad de Datos
+
+Los datos de autenticación de usuarios se almacenan en una **base de datos MongoDB** alojada en **cloud.mongodb.com**:
+
+- **Región:** AWS / Oregón (us-west-2)
+- **Tipo:** Conjunto Réplica (3 nodos)
+- **Seguridad de Contraseñas:** Todas las contraseñas están cifradas utilizando prácticas estándar de la industria.
+
+No almacenamos ningún dato personal innecesario más allá de lo requerido para la autenticación y el acceso seguro al CMS.
+
+## Compartición de Datos con Terceros
+
+**No** vendemos ni compartimos tus datos personales con terceros, excepto cuando sea necesario para análisis (Google Analytics, Facebook Pixel) o como parte del proceso de autenticación (inicio de sesión con Google o GitHub).
+
+## Derechos de los Usuarios
+
+Como usuario, tienes derecho a:
+
+- Acceder a los datos personales que tenemos sobre ti
+- Solicitar la corrección o eliminación de tus datos
+- Revocar el acceso o eliminar tu cuenta
+
+Para cualquier solicitud relacionada con tus datos, contáctanos en [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Cambios en Este Aviso
+
+Podemos actualizar este aviso de privacidad de vez en cuando. Se recomienda a los usuarios revisar regularmente esta página para mantenerse informados sobre cualquier cambio.
+
+---
+
+Haznos saber si prefieres un tono más formal, incluir menciones a GDPR/CCPA, o adaptarlo para una página legal en tu sitio.

package/es/roadmap.md

@@ -0,0 +1,157 @@
+# Intlayer: Descripción de Funcionalidades y Hoja de Ruta
+
+Intlayer es una solución de gestión de contenido e internacionalización diseñada para optimizar cómo declaras, gestionas y actualizas contenido en tus aplicaciones. Ofrece potentes funcionalidades como declaración de contenido centralizada o distribuida, amplias opciones de internacionalización, soporte para Markdown, renderizado condicional, integración con TypeScript/JavaScript/JSON, y más. A continuación, se presenta una descripción completa de lo que Intlayer ofrece actualmente, seguida de las características futuras en la hoja de ruta.
+
+---
+
+## Funcionalidades Actuales
+
+### 1. Declaración de Contenido
+
+#### Centralizada o Distribuida
+
+- **Centralizada**: Declara todo tu contenido en un único archivo grande en la base de tu aplicación, similar a i18next, para que puedas gestionarlo todo en un solo lugar.
+- **Distribuida**: Alternativamente, divide tu contenido en archivos separados a nivel de componente o funcionalidad para un mejor mantenimiento. Esto mantiene tu contenido cerca del código relevante (componentes, pruebas, Storybook, etc.). Eliminar un componente asegura que cualquier contenido asociado también se elimine, evitando datos sobrantes que desordenen tu base de código.
+
+### 2. Internacionalización
+
+- Soporte para **230 idiomas y locales** (incluyendo variantes regionales como francés (Francia), inglés (Canadá), inglés (Reino Unido), portugués (Portugal), etc.).
+- Gestiona fácilmente las traducciones para todos estos locales desde un solo lugar.
+
+### 3. Soporte para Markdown
+
+- Declara contenido usando **Markdown**, permitiéndote formatear texto automáticamente con párrafos, encabezados, enlaces y más.
+- Ideal para publicaciones de blogs, artículos, páginas de documentación o cualquier escenario donde se necesite formato de texto enriquecido.
+
+### 4. Renderizado Condicional
+
+- Define contenido que se adapta según condiciones específicas, como el idioma del usuario, el estado de inicio de sesión del usuario o cualquier otra variable relacionada con el contexto.
+- Ayuda a personalizar experiencias sin duplicar contenido en múltiples archivos.
+
+### 5. Formatos de Declaración de Contenido
+
+Intlayer soporta **TypeScript** (también JavaScript) y **JSON** para declarar contenido.
+
+- **TypeScript**:
+
+  - Asegura que la estructura de tu contenido sea correcta y que no falten traducciones.
+  - Ofrece modos de validación estrictos o más flexibles.
+  - Permite la obtención dinámica de datos desde variables, funciones o APIs externas.
+
+- **JSON**:
+  - Facilita la integración con herramientas externas (como editores visuales) debido a su formato estandarizado.
+
+---
+
+## Integración con Frameworks y Entornos
+
+### 1. Next.js
+
+#### a. Componentes del Servidor y Cliente
+
+- Proporciona un **enfoque unificado de gestión de contenido** para componentes del servidor y cliente.
+- Ofrece un contexto integrado para componentes del servidor, simplificando la implementación en comparación con otras soluciones.
+
+#### b. Metadata, Sitemaps y robots.txt
+
+- Obtén e inyecta contenido dinámicamente para generar metadata, sitemaps o archivos `robots.txt`.
+
+#### c. Middleware
+
+- Añade un middleware para **redirigir a los usuarios** al contenido basado en su idioma preferido.
+
+#### d. Compatibilidad con Turbopack y Webpack
+
+- Totalmente compatible con el nuevo Turbopack de Next.js, así como con el Webpack tradicional.
+
+### 2. Vite
+
+- Similar a Next.js, puedes integrar Intlayer con Vite y usar un **middleware** para redirigir a los usuarios al contenido basado en su idioma preferido.
+
+### 3. Express
+
+- Gestiona contenido e internacionaliza servicios backend construidos en Express.
+- Personaliza correos electrónicos, mensajes de error, notificaciones push y más con texto localizado.
+
+---
+
+## Editores Visuales y CMS
+
+### 1. Editor Visual Local
+
+- Un **editor visual local gratuito** que te permite editar el contenido de tu aplicación seleccionando directamente elementos en la página.
+- Integra funciones de IA para:
+  - Generar o corregir traducciones
+  - Verificar sintaxis y ortografía
+  - Sugerir mejoras
+- Puede alojarse localmente o desplegarse en un servidor remoto.
+
+### 2. Intlayer CMS (Remoto)
+
+- Una solución de **CMS alojado** que te permite gestionar el contenido de tu aplicación en línea, sin tocar tu base de código.
+- Proporciona funciones asistidas por IA para declarar contenido, gestionar traducciones y corregir errores de sintaxis u ortografía.
+- Interactúa con tu contenido a través de la interfaz de tu aplicación en vivo.
+
+---
+
+## Intlayer CLI
+
+- **Auditoría y Generación de Traducciones**: Realiza auditorías en tus archivos de contenido para generar traducciones faltantes o identificar las no utilizadas.
+- **Interacción Remota**: Publica tu contenido local en el CMS remoto o recupera contenido remoto para integrarlo en tu aplicación local.
+- Útil para **pipelines CI/CD**, asegurando que tu contenido esté siempre sincronizado con tu código.
+
+---
+
+## Entornos
+
+- Usa **variables de entorno** para configurar Intlayer de manera diferente en producción, pruebas y entornos locales.
+- Define qué editor visual o proyecto de CMS remoto apuntar dependiendo de tu entorno.
+
+---
+
+## Actualizaciones de Contenido en Vivo
+
+- Al usar diccionarios remotos y el CMS de Intlayer, puedes **actualizar el contenido de tu aplicación en tiempo real**, sin necesidad de redeploy.
+
+---
+
+## Funcionalidades Futuras
+
+### 1. Pruebas A/B y Personalización
+
+- **Pruebas Multivariantes**: Prueba diferentes versiones de un contenido para ver cuál funciona mejor (por ejemplo, mayor tasa de clics).
+- **Personalización Basada en Datos**: Muestra contenido diferente basado en la demografía del usuario (género, edad, ubicación, etc.) u otros patrones de comportamiento.
+- **Iteración Automatizada**: Permite que la IA pruebe automáticamente múltiples versiones y elija la mejor o recomiende opciones para la aprobación del administrador.
+
+### 2. Versionado
+
+- Restaura versiones anteriores de tu contenido con **versionado de contenido**.
+- Rastrea cambios a lo largo del tiempo y vuelve a estados anteriores si es necesario.
+
+### 3. Traducción Automática
+
+- Para usuarios del CMS remoto, **generación de traducciones con un clic** para cualquier idioma soportado.
+- El sistema generará traducciones en segundo plano y luego te pedirá validación o ediciones.
+
+### 4. Mejoras SEO
+
+- Herramientas para **analizar palabras clave**, intención de búsqueda del usuario y tendencias emergentes.
+- Sugerir contenido mejorado para mejores rankings y rastrear el rendimiento a largo plazo.
+
+### 5. Compatibilidad con Más Frameworks
+
+- Se están realizando esfuerzos para soportar **Vue, Solid, Svelte, Angular**, y más.
+- El objetivo es hacer que Intlayer sea compatible con **cualquier aplicación basada en JavaScript**.
+
+### 6. Extensiones para IDE
+
+- Extensiones para los principales IDEs para proporcionar una **interfaz gráfica** para gestionar traducciones locales y remotas.
+- Las características podrían incluir la generación automática de archivos de declaración de contenido para componentes, integración directa con el CMS de Intlayer y validación en tiempo real.
+
+---
+
+## Conclusión
+
+Intlayer aspira a ser una solución integral para la gestión de contenido e internacionalización. Se enfoca en la flexibilidad (archivos centralizados o distribuidos), soporte amplio de idiomas, fácil integración con frameworks modernos y empaquetadores, y potentes funciones impulsadas por IA. A medida que nuevas capacidades, como pruebas A/B, versionado y traducciones automáticas, estén disponibles, Intlayer continuará simplificando los flujos de trabajo de contenido y elevando las experiencias de usuario en diferentes plataformas.
+
+Mantente atento a los próximos lanzamientos y no dudes en explorar las funcionalidades existentes para ver cómo Intlayer puede ayudarte a centralizar y optimizar tus procesos de gestión de contenido hoy mismo!

package/es/terms_of_service.md

@@ -0,0 +1,33 @@
+# Términos de Servicio
+
+## 1. Aceptación de los Términos
+
+Al usar Intlayer, aceptas estar sujeto a estos términos de uso. Si no aceptas estos términos, por favor no utilices la herramienta.
+
+## 2. Licencia
+
+Intlayer se distribuye bajo la **licencia Apache 2.0**, que permite el uso, modificación y distribución del código tanto para proyectos de código abierto como comerciales. Los usuarios pueden modificar el código fuente y enviar contribuciones a través de solicitudes de extracción de acuerdo con las directrices establecidas en nuestra [guía de contribución](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md). El robo de código para uso comercial está estrictamente prohibido.
+
+## 3. Uso Comercial
+
+Se permite el uso de Intlayer para proyectos comerciales. Sin embargo, está prohibido reutilizar el código para crear herramientas competidoras directas basadas en Intlayer sin una transformación significativa o un valor añadido sustancial.
+
+## 4. Responsabilidad
+
+Los mantenedores de Intlayer se esfuerzan por corregir errores y problemas de seguridad tan pronto como se descubren. Sin embargo, no se hacen responsables de los daños resultantes de dichos problemas en las infraestructuras de los usuarios. Animamos a los usuarios a reportar problemas a través de nuestro [sistema de seguimiento de problemas](https://github.com/aymericzip/intlayer/issues).
+
+## 5. Privacidad
+
+Intlayer no recopila ni almacena ningún dato personal de los usuarios.
+
+## 6. Contribuciones
+
+Se anima a los usuarios a contribuir a Intlayer siguiendo las directrices proporcionadas en nuestra guía de contribución. Cualquier código enviado debe cumplir con los estándares de calidad establecidos y será revisado por los mantenedores antes de su integración.
+
+## 7. Atribución
+
+Cualquier herramienta desarrollada para extender o utilizar el código de Intlayer debe acreditar claramente a Intlayer como la base del código. Esta atribución debe ser visible en el código fuente, así como en cualquier documentación de usuario o promocional.
+
+## 8. Modificación de los Términos
+
+Estos términos de uso pueden ser modificados en cualquier momento. Los usuarios serán informados de cualquier cambio significativo en los términos de uso y deberán aceptar los cambios para continuar utilizando Intlayer.

package/es/vs_code_extension.md

@@ -0,0 +1,139 @@
+# Extensión VS Code Oficial para Intlayer
+
+## Descripción General
+
+**Intlayer** es la extensión oficial de Visual Studio Code para **Intlayer**, diseñada para mejorar la experiencia del desarrollador al trabajar con contenido localizado en proyectos de **React, Next.js y JavaScript**.
+
+Con esta extensión, los desarrolladores pueden **navegar rápidamente** a sus diccionarios de contenido, gestionar archivos de localización y optimizar su flujo de trabajo con potentes comandos automatizados.
+
+![Intlayer VS Code Extension](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+
+Enlace de la extensión: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## Funcionalidades
+
+### Navegación Instantánea
+
+**Soporte para Ir a Definición** – Usa `Cmd+Click` (Mac) o `Ctrl+Click` (Windows/Linux) en una clave de `useIntlayer` para abrir instantáneamente el archivo de contenido correspondiente.  
+**Integración Perfecta** – Funciona sin problemas con proyectos de **react-intlayer** y **next-intlayer**.  
+**Soporte Multilenguaje** – Compatible con contenido localizado en diferentes idiomas.  
+**Integración con VS Code** – Se integra perfectamente con la navegación y el paleta de comandos de VS Code.
+
+### Comandos de Gestión de Diccionarios
+
+Gestiona tus diccionarios de contenido directamente desde VS Code:
+
+- **Construir Diccionarios** (`extension.buildDictionaries`) – Genera archivos de contenido basados en la estructura de tu proyecto.
+- **Subir Diccionarios** (`extension.pushDictionaries`) – Sube el contenido más reciente del diccionario a tu repositorio.
+- **Descargar Diccionarios** (`extension.pullDictionaries`) – Sincroniza el contenido más reciente del diccionario desde tu repositorio a tu entorno local.
+
+### Generador de Declaración de Contenido
+
+Genera fácilmente archivos de diccionario estructurados en diferentes formatos:
+
+- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
+- **ES Module (`.esm`)** – `extension.createDictionaryFile.esm`
+- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
+- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+
+## Instalación
+
+Puedes instalar **Intlayer** directamente desde el Marketplace de VS Code:
+
+1. Abre **VS Code**.
+2. Ve al **Marketplace de Extensiones**.
+3. Busca **"Intlayer"**.
+4. Haz clic en **Instalar**.
+
+Alternativamente, instálalo a través de la línea de comandos:
+
+```sh
+code --install-extension intlayer
+```
+
+## Uso
+
+### Navegación Rápida
+
+1. Abre un proyecto que use **react-intlayer**.
+2. Localiza una llamada a `useIntlayer()`, como:
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. Haz **Cmd+Click** (`⌘+Click` en macOS) o **Ctrl+Click** (en Windows/Linux) en la clave (por ejemplo, `"app"`).
+4. VS Code abrirá automáticamente el archivo de diccionario correspondiente, por ejemplo, `src/app.content.ts`.
+
+### Gestión de Diccionarios de Contenido
+
+#### Construcción de Diccionarios
+
+Genera todos los archivos de contenido del diccionario con:
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+Busca **Construir Diccionarios** y ejecuta el comando.
+
+#### Subir Diccionarios
+
+Sube el contenido más reciente del diccionario:
+
+1. Abre la **Paleta de Comandos**.
+2. Busca **Subir Diccionarios**.
+3. Selecciona los diccionarios a subir y confirma.
+
+#### Descargar Diccionarios
+
+Sincroniza el contenido más reciente del diccionario:
+
+1. Abre la **Paleta de Comandos**.
+2. Busca **Descargar Diccionarios**.
+3. Elige los diccionarios a descargar.
+
+### Personalización de Rutas de Archivos de Diccionario
+
+Por defecto, la extensión sigue la estructura estándar del proyecto **Intlayer**. Sin embargo, puedes configurar rutas personalizadas:
+
+1. Abre **Configuración (`Cmd + ,` en macOS / `Ctrl + ,` en Windows/Linux)`**.
+2. Busca `Intlayer`.
+3. Ajusta la configuración de la ruta del archivo de contenido.
+
+## Desarrollo y Contribución
+
+¿Quieres contribuir? ¡Damos la bienvenida a las contribuciones de la comunidad!
+
+URL del repositorio: https://github.com/aymericzip/intlayer-vs-code-extension
+
+### Primeros Pasos
+
+Clona el repositorio e instala las dependencias:
+
+```sh
+git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
+cd intlayer-vs-code-extension
+npm install
+```
+
+> Usa el gestor de paquetes `npm` para compatibilidad con el paquete `vsce` para construir y publicar la extensión.
+
+### Ejecutar en Modo de Desarrollo
+
+1. Abre el proyecto en **VS Code**.
+2. Presiona `F5` para lanzar una nueva ventana de **Extension Development Host**.
+
+### Enviar un Pull Request
+
+Si mejoras la extensión, envía un PR en [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension).
+
+## Comentarios y Problemas
+
+¿Encontraste un error o tienes una solicitud de funcionalidad? Abre un problema en nuestro **repositorio de GitHub**:
+
+[Problemas en GitHub](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## Licencia
+
+Intlayer se publica bajo la **Licencia MIT**.