@intlayer/docs 9.4.0-canary.0 → 9.4.1

package/docs/es/intlayer_with_vite+lit.md

@@ -109,6 +109,8 @@ Más que una simple solución i18n, Intlayer proporciona un **[editor visual] au
 
 ---
 
+Ver [Application Template](https://github.com/aymericzip/intlayer-vite-lit-template) en GitHub.
+
 ## Guía paso a paso para configurar Intlayer en una aplicación Vite y Lit
 
 <Steps>
@@ -478,6 +480,8 @@ Primero, agrega `intlayerProxy` a tu configuración de Vite:
 
 > Ten en cuenta que para usar `intlayerProxy` en producción, debes mover `vite-intlayer` de `devDependencies` a `dependencies`.
 
+> Desde Intlayer v9, `intlayerProxy()` está incluido directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación es ahora opcional — se mantiene para compatibilidad hacia atrás y para configuraciones que necesitan controlar el orden de los plugins. Establece `routing.enableProxy: false` para optar por no participar. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/es/intlayer_with_vite+preact.md

@@ -61,10 +61,6 @@ author: aymericzip
   </Tab>
 </Tabs>
 
-> Este paquete está en desarrollo. Consulta el [issue](https://github.com/aymericzip/intlayer/issues/118) para más información. Muestra tu interés en Intlayer para Preact dando like al issue.
-
-See [Plantilla de Aplicación](https://github.com/aymericzip/intlayer-vite-preact-template) en GitHub.
-
 ## Tabla de contenidos
 
 <TOC/>
@@ -122,6 +118,8 @@ Más que una simple solución i18n, Intlayer proporciona un **[editor visual] au
 
 ## Guía paso a paso para configurar Intlayer en una aplicación Vite y Preact
 
+Ver [Plantilla de Aplicación](https://github.com/aymericzip/intlayer-vite-preact-template) en GitHub.
+
 <Steps>
 
 <Step number={1} title="Instalar dependencias">
@@ -516,6 +514,30 @@ const App: FunctionalComponent = () => (
 export default App;
 ```
 
+En paralelo, también puedes usar `intlayerProxy` para agregar enrutamiento del lado del servidor a tu aplicación. Este plugin detectará automáticamente la locale actual basándose en la URL y establecerá la cookie de locale apropiada. Si no se especifica ninguna locale, el plugin determinará la locale más apropiada basándose en las preferencias de idioma del navegador del usuario. Si no se detecta ninguna locale, redirigirá a la locale predeterminada.
+
+> Tenga en cuenta que para usar `intlayerProxy` en producción, debe cambiar el paquete `vite-intlayer` de `devDependencies` a `dependencies`.
+
+> Desde Intlayer v9, `intlayerProxy()` está incluido directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación es ahora opcional — se mantiene para compatibilidad hacia atrás y para configuraciones que necesiten controlar el orden de los plugins. Establece `routing.enableProxy: false` para optar por no participar. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
+```typescript {3,7} fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+import preact from "@preact/preset-vite";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    preact(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
 </Step>
 
 <Step number={8} title="Cambiar la URL cuando cambia el idioma" isOptional={true}>
@@ -592,6 +614,10 @@ export default LocaleSwitcher;
 >
 > > - [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/react-intlayer/useLocale.md) (la API es similar para `preact-intlayer`)> - [Hook `getLocaleName`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocaleName.md)> - [Hook `getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocalizedUrl.md)> - [Hook `getHTMLTextDir`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getHTMLTextDir.md)> - [Atributo `hreflang`](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=fr)> - [Atributo `lang`](https://developer.mozilla.org/es/docs/Web/HTML/Global_attributes/lang)> - [Atributo `dir`](https://developer.mozilla.org/es/docs/Web/HTML/Global_attributes/dir)> - [Atributo `aria-current`](https://developer.mozilla.org/es/docs/Web/Accessibility/ARIA/Attributes/aria-current)> - [API Popover](https://developer.mozilla.org/es/docs/Web/API/Popover_API)
 
+A continuación se muestra el **Paso 9** actualizado con explicaciones añadidas y ejemplos de código refinados:
+
+---
+
 </Step>
 
 <Step number={9} title="Cambiar los atributos de idioma y dirección del HTML" isOptional={true}>
@@ -661,6 +687,12 @@ const App: FunctionalComponent = () => (
 export default App;
 ```
 
+Al aplicar estos cambios, tu aplicación:
+
+- Asegura que el atributo **language** (`lang`) refleje correctamente la locale actual, lo cual es importante para SEO y el comportamiento del navegador.
+- Ajusta la **dirección del texto** (`dir`) según la locale, mejorando la legibilidad y usabilidad para idiomas con diferentes órdenes de lectura.
+- Proporciona una experiencia más **accesible**, ya que las tecnologías de asistencia dependen de estos atributos para funcionar de manera óptima.
+
 </Step>
 
 <Step number={10} title="Crear un Componente de Enlace Localizado" isOptional={true}>

package/docs/es/intlayer_with_vite+react.md

@@ -501,6 +501,8 @@ Paralelamente, también puedes usar el `intlayerProxy` para agregar enrutamiento
 
 > Ten en cuenta que para usar el `intlayerProxy` en producción, debes mover el paquete `vite-intlayer` de `devDependencies` a `dependencies`.
 
+> A partir de Intlayer v9, `intlayerProxy()` está incluido directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación ahora es opcional — se mantiene por compatibilidad hacia atrás y para configuraciones que necesitan controlar el orden de los plugins. Establece `routing.enableProxy: false` para optar por no participar. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";

package/docs/es/intlayer_with_vite+react_compiler.md

@@ -232,6 +232,8 @@ export default defineConfig({
 
 > El complemento Vite `intlayerCompiler()` se utiliza para extraer contenido del componente y escribir archivos `.content`.
 
+> Desde Intlayer v9, el compilador está incluido directamente en el plugin `intlayer()` y se activa automáticamente una vez que `compiler.enabled` se establece con una ruta `compiler.output`. Registrar `intlayerCompiler()` por separado como se muestra a continuación ahora es opcional — se deduplica a sí mismo si también se agrega. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 </Step>
 
 <Step number={4} title="Compila tu código">

package/docs/es/intlayer_with_vite+solid.md

@@ -46,6 +46,17 @@ author: aymericzip
   loading="lazy"
 />
 
+  </Tab>
+  <Tab label="Demo" value="demo">
+
+<iframe
+  src="https://intlayer-vite-solid.vercel.app"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Intlayer Vite + Solid Template"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
   </Tab>
 </Tabs>
 
@@ -53,10 +64,6 @@ author: aymericzip
 
 <TOC/>
 
-> Este paquete está en desarrollo. Consulta el [issue](https://github.com/aymericzip/intlayer/issues/117) para más información. Muestra tu interés en Intlayer para Solid dando like al issue
-
-<!-- Consulta la [Plantilla de Aplicación](https://github.com/aymericzip/intlayer-solid-template) en GitHub. -->
-
 ## ¿Por qué Intlayer en lugar de alternativas?
 
 En comparación con soluciones principales como `@solid-primitives/i18n` o `i18next`, Intlayer es una solución que viene con optimizaciones integradas como:
@@ -242,8 +249,6 @@ export default appContent;
 
 > Tus declaraciones de contenido pueden definirse en cualquier lugar de tu aplicación tan pronto como se incluyan en el directorio `contentDir` (por defecto, `./src`). Y coincidan con la extensión del archivo de declaración de contenido (por defecto, `.content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}`).
 
-> Para más detalles, consulta la [documentación de declaración de contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md).
-
 </Step>
 
 <Step number={5} title="Utiliza Intlayer en tu código">
@@ -491,29 +496,10 @@ export const Link: ParentComponent<AnchorProps> = (props) => {
 };
 ```
 
-</Step>
-
 <Step number={11} title="Renderizar Markdown" isOptional={true}>
 
 Intlayer admite renderizar contenido Markdown directamente en tu aplicación Solid usando su propio analizador interno. Por defecto, Markdown se trata como texto plano. Para renderizarlo como HTML enriquecido, envuelve tu aplicación con el `MarkdownProvider`.
 
-```tsx fileName="src/index.tsx"
-import { render } from "solid-js/web";
-import { MarkdownProvider } from "solid-intlayer/markdown";
-import App from "./App";
-
-const root = document.getElementById("root");
-
-render(
-  () => (
-    <MarkdownProvider>
-      <App />
-    </MarkdownProvider>
-  ),
-  root!
-);
-```
-
 Luego puedes usarlo en tus componentes:
 
 ```tsx
@@ -738,19 +724,8 @@ Para mejorar tu experiencia de desarrollo con Intlayer, puedes instalar la exten
 
 [Instalar desde el Marketplace de VS Code](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
 
-Esta extensión proporciona:
-
-- **Autocompletado** para las claves de traducción.
-- **Detección de errores en tiempo real** para traducciones faltantes.
-- **Vistas previas en línea** del contenido traducido.
-- **Acciones rápidas** para crear y actualizar traducciones fácilmente.
-
-Para más detalles sobre cómo usar la extensión, consulta la [documentación de la extensión Intlayer para VS Code](https://intlayer.org/doc/vs-code-extension).
-
 ---
 
 ### Ir Más Allá
 
 Para ir más allá, puedes implementar el [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) o externalizar tu contenido usando el [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md).
-
----

package/docs/es/intlayer_with_vite+svelte.md

@@ -455,6 +455,8 @@ Paralelamente, también puedes usar `intlayerProxy` para añadir enrutamiento de
 
 > Ten en cuenta que para usar `intlayerProxy` en producción, necesitas mover el paquete `vite-intlayer` de `devDependencies` a `dependencies`.
 
+> A partir de Intlayer v9, `intlayerProxy()` está incluido directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación ahora es opcional — se mantiene por compatibilidad hacia atrás y para configuraciones que necesitan controlar el orden de los plugins. Establece `routing.enableProxy: false` para desactivarlo. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";

package/docs/es/intlayer_with_vite+vanilla.md

@@ -470,6 +470,8 @@ Primero, añade `intlayerProxy` a tu configuración de Vite:
 
 > Ten en cuenta que para usar `intlayerProxy` en producción, necesitas mover `vite-intlayer` de `devDependencies` a `dependencies`.
 
+> Desde Intlayer v9, `intlayerProxy()` está agrupado directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación es ahora opcional — se mantiene para compatibilidad hacia atrás y para configuraciones que necesitan controlar el orden de los plugins. Establece `routing.enableProxy: false` para optar por no participar. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/es/intlayer_with_vite+vue.md

@@ -402,6 +402,13 @@ app.use(intlayer);
 app.mount("#app");
 ```
 
+> También puedes llamar a `installIntlayer(app)` directamente como una función si lo prefieres:
+>
+> ```javascript
+> import { intlayer } from "vue-intlayer";
+> app.use(intlayer);
+> ```
+
 Accede a tus diccionarios de contenido en toda tu aplicación creando un componente principal de Vue y usando los composables `useIntlayer`:
 
 ```vue fileName="src/HelloWord.vue"
@@ -455,6 +462,8 @@ const countRef = ref(0);
 </template>
 ```
 
+> Si tu aplicación ya existe, puedes usar el [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md), así como el [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md), para transformar miles de componentes en un segundo.
+
 #### Accediendo al contenido en Intlayer
 
 Intlayer ofrece diferentes APIs para acceder a tu contenido:
@@ -473,8 +482,6 @@ Intlayer ofrece diferentes APIs para acceder a tu contenido:
   - Usa `const content = useIntlayer("myContent");` y `{{ content.myContent }}` / `<content.myContent />`.
   - O usa `const { myContent } = useIntlayer("myContent");` y `{{ myContent}}` / `<myContent/>` para desestructurar el contenido.
 
-> Si su aplicación ya existe, puede utilizar el [Compilador Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md), así como el [comando de extracción](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md), para transformar miles de componentes en un segundo.
-
 </Step>
 
 <Step number={6} title="Cambiar el idioma de tu contenido" isOptional={true}>
@@ -662,6 +669,10 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 
 Paralelamente, también puede usar el `intlayerProxy` para agregar enrutamiento del lado del servidor a su aplicación. Este plugin detectará automáticamente la configuración regional actual basada en la URL y establecerá la cookie de configuración regional correspondiente. Si no se especifica ninguna configuración regional, el plugin determinará la configuración regional más adecuada según las preferencias de idioma del navegador del usuario. Si no se detecta ninguna configuración regional, redirigirá a la configuración regional predeterminada.
 
+> Tenga en cuenta que para usar `intlayerProxy` en producción, debe cambiar el paquete `vite-intlayer` de `devDependencies` a `dependencies`.
+
+> Desde Intlayer v9, `intlayerProxy()` está incluido directamente en el plugin `intlayer()` y habilitado por defecto a través de la opción `routing.enableProxy` (`true` por defecto). Registrarlo por separado como se muestra a continuación es ahora opcional — se mantiene para compatibilidad hacia atrás y para configuraciones que necesitan controlar el orden de los plugins. Establece `routing.enableProxy: false` para optar por no participar. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
@@ -1167,3 +1178,5 @@ Para más detalles sobre cómo usar la extensión, consulta la [documentación d
 ### Ir más allá
 
 Para ir más allá, puedes implementar el [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) o externalizar tu contenido usando el [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md).
+
+Please share the content you'd like me to review.---

package/docs/es/live-sync.md

@@ -42,8 +42,6 @@ La sincronización en vivo permite que tu aplicación refleje los cambios de con
 
 ## Activar la sincronización en vivo
 
-> Live Sync requiere una conexión continua al servidor y está disponible en el plan enterprise.
-
 Habilita Live Sync actualizando tu configuración de Intlayer:
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
@@ -85,6 +83,19 @@ export default config;
 
 Inicie el servidor Live Sync para envolver su aplicación:
 
+Ejemplo usando servidor independiente:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... otros scripts
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+También puedes usar tu servidor de aplicación en paralelo utilizando el argumento `--process`.
+
 Ejemplo usando Next.js:
 
 ```json5 fileName="package.json"
@@ -125,8 +136,6 @@ Cómo funciona:
 
 ## Flujo de trabajo de desarrollo (local)
 
-docs/ko/intlayer_CMS.md
-
 - En desarrollo, todos los diccionarios remotos se obtienen cuando la aplicación se inicia, para que puedas probar actualizaciones rápidamente.
 - Para probar Live Sync localmente con Next.js, envuelve tu servidor de desarrollo:
 

package/docs/es/packages/elysia-intlayer/exports.md

@@ -0,0 +1,134 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Documentación del paquete elysia-intlayer
+description: Plugin de Elysia para Intlayer, que proporciona funciones de traducción y detección de locale.
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Documentación unificada para todas las exportaciones"
+author: aymericzip
+---
+
+# Paquete elysia-intlayer
+
+El paquete `elysia-intlayer` proporciona un plugin para aplicaciones Elysia para gestionar la internacionalización. Detecta el locale del usuario e inyecta un objeto `intlayer` en el contexto de la ruta.
+
+## Instalación
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia` es una peer dependency (`>=1.0.0`). Elysia está pensado para el runtime **Bun**.
+
+## Exportaciones
+
+### Plugin
+
+Importación:
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| Función    | Descripción                                                                                                                                                                                                                                                                                                                                       | Documento relacionado                                                                                          |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Plugin de Elysia que integra Intlayer en tu aplicación Elysia. Gestiona la detección del locale desde el storage (cookies, headers) y luego desde `Accept-Language`, inyecta un objeto `intlayer` que expone `locale`, `t`, `getIntlayer` y `getDictionary` en el contexto de la ruta, y configura el contexto de request de `AsyncLocalStorage`. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/elysia-intlayer/intlayer.md) |
+
+### Funciones
+
+Importación:
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| Función         | Descripción                                                                                                                                                                                                                                                                     | Documento relacionado                                                                                  |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `t`             | Función de traducción global que recupera el contenido para el locale actual en Elysia. Usa `AsyncLocalStorage` para acceder al contexto de request configurado por el plugin `intlayer`, y recurre al locale por defecto fuera de él. También accesible mediante `intlayer.t`. | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/translation.md) |
+| `getIntlayer`   | Recupera un diccionario por su clave desde la declaración generada y devuelve su contenido para el locale actual. Versión optimizada de `getDictionary`. Usa `AsyncLocalStorage` para acceder al contexto de la request. También accesible mediante `intlayer.getIntlayer`.     | -                                                                                                      |
+| `getDictionary` | Procesa objetos de diccionario y devuelve el contenido para el locale actual. Procesa traducciones `t()`, enumeraciones, markdown, HTML, etc. Usa `AsyncLocalStorage` para acceder al contexto de la request. También accesible mediante `intlayer.getDictionary`.              | -                                                                                                      |
+
+### Tipos
+
+Importación:
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| Tipo                | Descripción                                                                                                                                                          |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerContext`   | Forma del objeto `intlayer` inyectado en cada contexto de ruta: `locale`, `locale_storage`, `locale_detected`, `defaultLocale`, `t`, `getIntlayer`, `getDictionary`. |
+| `TranslateFunction` | Firma de la función de traducción, que convierte un locale map en el contenido correspondiente al locale de la request actual.                                       |
+
+## Uso
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // Cargar el plugin de internacionalización
+  .use(intlayer())
+  // Leer la locale y los helpers desde el contexto de la ruta
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // O usar los helpers standalone, ligados a la petición actual
+  .get("/t_example", () =>
+    t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> El plugin registra su contexto mediante un `derive` **global**, que Elysia tipa como `Partial<{ intlayer: IntlayerContext }>`. El valor siempre está presente en tiempo de ejecución para las rutas registradas después de `.use(intlayer())`, así que usa la aserción non-null (`intlayer!.locale`) — u optional chaining — para satisfacer a TypeScript en modo `strict`.
+
+## Documentación relacionada
+
+- [Elysia i18n - Guía completa para traducir tu aplicación](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_elysia.md)
+- [Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md)

package/docs/es/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Documentación del Plugin intlayer para Elysia | elysia-intlayer
+description: Descubre cómo usar el plugin intlayer del paquete elysia-intlayer
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - Internacionalización
+  - Documentación
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Inicialización de la documentación"
+author: aymericzip
+---
+
+# Documentación del Plugin intlayer para Elysia
+
+El plugin `intlayer` para Elysia detecta el locale del usuario e inyecta un objeto `intlayer` en el contexto de la ruta. También permite el uso de funciones globales de traducción dentro del contexto de la request.
+
+## Uso
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> El plugin registra su contexto mediante un `derive` **global**, que Elysia tipa como `Partial<{ intlayer: IntlayerContext }>`. El valor siempre está presente en tiempo de ejecución para las rutas registradas después de `.use(intlayer())`, así que usa la aserción non-null (`intlayer!.t`) — u optional chaining — para satisfacer a TypeScript en modo `strict`.
+
+Los mismos helpers están disponibles como exports independientes, por lo que puedes llamarlos sin desestructurar el contexto de la ruta:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## Descripción
+
+El plugin realiza las siguientes tareas:
+
+1. **Detección de locale**: Lee el locale establecido explícitamente por el cliente desde el storage (cookie, header), y luego recurre al locale negociado a partir del header `Accept-Language`.
+2. **Inyección en el contexto**: Añade una propiedad `intlayer` al contexto de ruta de Elysia (ver la tabla Contexto de la ruta más abajo).
+3. **Gestión del contexto**: Usa `AsyncLocalStorage` para gestionar un contexto asíncrono, permitiendo que las funciones globales de Intlayer (`t`, `getIntlayer`, `getDictionary`) accedan al locale específico de la request sin tener que pasar el objeto de contexto.
+4. **Preparación de los diccionarios**: Llama a `prepareIntlayer` cuando se crea el plugin, de modo que los diccionarios se construyen al arrancar la aplicación.
+
+### Contexto de la ruta
+
+| Propiedad         | Tipo                   | Descripción                                                                                   |
+| ----------------- | ---------------------- | --------------------------------------------------------------------------------------------- |
+| `locale`          | `Locale`               | El locale a usar para esta request; `locale_storage` tiene prioridad sobre `locale_detected`. |
+| `locale_storage`  | `Locale` (opcional)    | El locale solicitado explícitamente por el cliente mediante una cookie o un header.           |
+| `locale_detected` | `Locale`               | El locale negociado a partir de los headers de la request.                                    |
+| `defaultLocale`   | `Locale`               | El locale configurado como fallback en `intlayer.config.ts`.                                  |
+| `t`               | `TranslateFunction`    | Una función de traducción.                                                                    |
+| `getIntlayer`     | `typeof getIntlayer`   | Una función para recuperar diccionarios por clave.                                            |
+| `getDictionary`   | `typeof getDictionary` | Una función para procesar objetos de diccionario.                                             |
+
+> A diferencia de los plugins de Intlayer basados en Node, `elysia-intlayer` se apoya en `AsyncLocalStorage` en lugar de `cls-hooked`, porque `cls-hooked` depende de `async_hooks.createHook`, que Bun no implementa.
+
+El contexto de la request se libera una vez que la respuesta se ha mapeado, de modo que los helpers independientes nunca se resuelven contra una request ya finalizada. Cuando se llaman fuera de una request gestionada por el plugin, recurren al locale por defecto configurado.
+
+## Orden de resolución de la locale
+
+Por defecto, el plugin resuelve la locale en este orden:
+
+1. La cookie `INTLAYER_LOCALE`.
+2. El header `x-intlayer-locale`.
+3. La negociación del header `Accept-Language`.
+4. La `defaultLocale` configurada.
+
+```bash
+# Negociada desde `Accept-Language`
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# La cookie tiene prioridad sobre `Accept-Language`
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# El header tiene prioridad sobre `Accept-Language`
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## Configuración
+
+El plugin lee tu archivo `intlayer.config.ts`. Puedes personalizar la cookie y el header usados para la detección del locale:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> Para más información sobre la configuración, visita la [documentación de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+
+## Documentación relacionada
+
+- [Documentación del paquete elysia-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - Guía completa para traducir tu aplicación](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_elysia.md)