@intlayer/docs 9.5.4 → 9.5.6

package/docs/es/intlayer_with_vite+preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Preact i18n - Guía completa para traducir tu aplicación"
 description: "Sin más i18next. La guía 2026 para crear una aplicación Vite + Preact multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
@@ -862,8 +862,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -878,6 +884,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila tu aplicación para transformar tus componentes y extraer el contenido
+
 ```bash packageManager="npm"
 npm run build # O npm run dev
 ```
@@ -934,7 +945,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -947,7 +960,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1121,6 +1134,13 @@ Sí: [formas plurales](https://github.com/aymericzip/intlayer/blob/main/docs/doc
 
 A través del [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md), que se ejecuta en tu propia infraestructura y permite que cualquiera edite texto en su sitio en la aplicación en ejecución, o del [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md), que externaliza el contenido para que pueda cambiar sin un despliegue.
 
+</Question>
+<Question title="¿Cuál es el costo del editor visual? ¿Es excesivo si no lo necesito?">
+
+El [editor visual de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) tiene un **costo cero** en su aplicación si no está configurado. La lógica adicional solo se carga si se habilita explícitamente y es necesaria.
+
+Si está habilitado, el impacto es extremadamente ligero (+5 KB, cargado dinámicamente solo cuando se activa) porque la mayor parte de la lógica es manejada por el editor del servidor en [app.intlayer.org](https://app.intlayer.org) o a través del paquete `intlayer-editor`. Si solo necesita una solución de traducción simple sin edición visual, Intlayer no agrega ninguna sobrecarga a su aplicación.
+
 </Question>
 <Question title="¿Es Intlayer gratuito y de código abierto?">
 

package/docs/es/intlayer_with_vite+react.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + React i18n - Guía completa para traducir tu aplicación"
 description: "Sin más i18next. La guía 2026 para crear una aplicación Vite + React multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
@@ -824,8 +824,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -840,6 +846,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila tu aplicación para transformar tus componentes y extraer el contenido
+
 ```bash packageManager="npm"
 npm run build # O npm run dev
 ```
@@ -896,7 +907,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -909,7 +922,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1065,6 +1078,13 @@ Sí: [formas plurales](https://github.com/aymericzip/intlayer/blob/main/docs/doc
 
 A través del [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md), autoalojado, que permite que cualquiera edite texto en su sitio en la aplicación en ejecución, o del [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para el contenido que debe cambiar sin un despliegue.
 
+</Question>
+<Question title="¿Cuál es el costo del editor visual? ¿Es excesivo si no lo necesito?">
+
+El [editor visual de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) tiene un **costo cero** en su aplicación si no está configurado. La lógica adicional solo se carga si se habilita explícitamente y es necesaria.
+
+Si está habilitado, el impacto es extremadamente ligero (+5 KB, cargado dinámicamente solo cuando se activa) porque la mayor parte de la lógica es manejada por el editor del servidor en [app.intlayer.org](https://app.intlayer.org) o a través del paquete `intlayer-editor`. Si solo necesita una solución de traducción simple sin edición visual, Intlayer no agrega ninguna sobrecarga a su aplicación.
+
 </Question>
 <Question title="¿Es Intlayer gratuito y de código abierto?">
 

package/docs/es/intlayer_with_vite+solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Solid i18n - Guía completa para traducir tu aplicación"
 description: "Sin más i18next. La guía 2026 para crear una aplicación Vite + Solid multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
@@ -585,8 +585,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -601,6 +607,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila tu aplicación para transformar tus componentes y extraer el contenido
+
 ```bash packageManager="npm"
 npm run build # O npm run dev
 ```
@@ -657,7 +668,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -670,7 +683,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -820,6 +833,13 @@ Sí: [formas plurales](https://github.com/aymericzip/intlayer/blob/main/docs/doc
 
 A través del [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md), que se ejecuta en tu propia infraestructura y permite que cualquiera edite texto en su sitio en la aplicación en ejecución, o del [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md), que externaliza el contenido para que pueda cambiar sin un despliegue.
 
+</Question>
+<Question title="¿Cuál es el costo del editor visual? ¿Es excesivo si no lo necesito?">
+
+El [editor visual de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) tiene un **costo cero** en su aplicación si no está configurado. La lógica adicional solo se carga si se habilita explícitamente y es necesaria.
+
+Si está habilitado, el impacto es extremadamente ligero (+5 KB, cargado dinámicamente solo cuando se activa) porque la mayor parte de la lógica es manejada por el editor del servidor en [app.intlayer.org](https://app.intlayer.org) o a través del paquete `intlayer-editor`. Si solo necesita una solución de traducción simple sin edición visual, Intlayer no agrega ninguna sobrecarga a su aplicación.
+
 </Question>
 <Question title="¿Es Intlayer gratuito y de código abierto?">
 

package/docs/es/intlayer_with_vite+svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Svelte i18n - Guía completa para traducir tu aplicación"
 description: "Sin más i18next. La guía 2026 para crear una aplicación Vite + Svelte multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
@@ -590,8 +590,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -606,6 +612,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila tu aplicación para transformar tus componentes y extraer el contenido
+
 ```bash packageManager="npm"
 npm run build # O npm run dev
 ```
@@ -662,7 +673,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -675,7 +688,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/es/intlayer_with_vite+vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vanilla JS i18n - Guía completa para traducir tu aplicación"
 description: "Sin más i18next. La guía 2026 para crear una aplicación Vite + Vanilla JS multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
@@ -613,8 +613,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Actualiza tu `vite.config.ts` para incluir el plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -629,6 +635,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila tu aplicación para transformar tus componentes y extraer el contenido
+
 ```bash packageManager="npm"
 npm run build # O npm run dev
 ```
@@ -685,7 +696,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -698,7 +711,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/es/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vue i18n - Guía completa para traducir tu aplicación"
 description: "Sin más i18next. La guía 2026 para crear una aplicación Vite + Vue multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
@@ -1020,8 +1020,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -1036,6 +1042,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compila tu aplicación para transformar tus componentes y extraer el contenido
+
 ```bash packageManager="npm"
 npm run build # O npm run dev
 ```
@@ -1092,7 +1103,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -1105,7 +1118,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/es/introduction.md

@@ -187,7 +187,6 @@ Hemos creado Intlayer pensando en la flexibilidad, ofreciendo una integración p
 - **[Intlayer con Astro + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_astro_solid.md)**
 - **[Intlayer con Astro + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_astro_preact.md)**
 - **[Intlayer con Astro + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_astro_lit.md)**
-- **[Intlayer con Astro + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_astro_vanilla.md)**
 - **[Intlayer con Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+vue.md)**
 - **[Intlayer con Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nuxt.md)**
 - **[Intlayer con Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+svelte.md)**

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

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-09-19
 title: Documentación del paquete astro-intlayer
-description: Integración de Astro para Intlayer, proporcionando configuración para el enrutamiento basado en locales y la gestión de diccionarios.
+description: Integración de Astro para Intlayer, que proporciona configuración para enrutamiento basado en locales, middleware, hooks, store de cliente y gestión de diccionarios.
 keywords:
   - astro-intlayer
   - astro
@@ -14,6 +14,9 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Añadida documentación de hooks useIntlayer, useDictionary, useLocale, middleware y formateadores"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentación unificada para todas las exportaciones"
@@ -22,7 +25,7 @@ author: aymericzip
 
 # Paquete astro-intlayer
 
-El paquete `astro-intlayer` proporciona las herramientas necesarias para integrar Intlayer en aplicaciones Astro. Configura el enrutamiento basado en locales y la gestión de diccionarios.
+El paquete `astro-intlayer` proporciona las herramientas necesarias para integrar Intlayer en aplicaciones Astro. Configura el enrutamiento basado en locales, la gestión de diccionarios, la reescritura de páginas en tiempo de compilación, el middleware de solicitudes y los hooks para acceder al contenido multilingüe tanto en componentes `.astro` renderizados en el servidor como en scripts del lado del cliente.
 
 ## Instalación
 
@@ -34,22 +37,171 @@ npm install astro-intlayer
 
 ### Integración
 
-El paquete `astro-intlayer` proporciona una integración para Astro para configurar Intlayer en tu proyecto.
+El paquete `astro-intlayer` proporciona una integración de Astro que configura Intlayer en tu proyecto.
 
-Importar:
+Importación:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-o agregándolo a `astro.config.mjs`:
+o importación por defecto en `astro.config.mjs`:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| Función    | Descripción                                                 |
-| ---------- | ----------------------------------------------------------- |
-| `intlayer` | Integración de Astro que configura Intlayer en tu proyecto. |
+| Función    | Descripción                                                                                                                                                                                                             | Documentación relacionada                                                                                     |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Integración de Astro que prepara diccionarios, configura plugins de Vite (alias, proxy de enrutamiento, poda), registra automáticamente el middleware de solicitudes y emite páginas prerenderizadas en URL reescritas. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/intlayer.md) |
+
+### Hooks (Servidor y Cliente)
+
+Importación:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| Hook            | Descripción                                                                                                                                                                                               | Documentación relacionada                                                                                               |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Selecciona un diccionario por su clave y devuelve su contenido localizado. En el frontmatter de `.astro`, lee el locale de la solicitud de `Astro.locals`. En `<script>`, lee desde el store del cliente. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | Transforma un objeto diccionario y devuelve contenido para el locale resuelto. Funciona en frontmatter y scripts de cliente.                                                                              | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | Devuelve el locale actual, el locale predeterminado, los locales disponibles y una función para actualizar el locale.                                                                                     | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/useLocale.md)         |
+
+### Middleware (astro-intlayer/middleware)
+
+Importación:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| Exportación | Tipo                | Descripción                                                                                                                                                                            | Documentación relacionada                                                                                       |
+| ----------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | Middleware de Astro que detecta el locale de la solicitud y adjunta `Astro.locals.intlayer`. Registrado automáticamente por `intlayer()`, o importado manualmente para su composición. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/onRequest.md) |
+
+### Utilidades
+
+Importación:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| Función             | Descripción                                                                                                             | Documentación relacionada |
+| ------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| `getIntlayerLocals` | Función de ayuda para recuperar el objeto `IntlayerLocals` actual del ámbito de almacenamiento fuera de `Astro.locals`. | -                         |
+
+### Utilidades de Cliente (astro-intlayer/client)
+
+Importación:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+Cuando se importa en el navegador o dentro de etiquetas `<script>` del cliente, `astro-intlayer` se asigna automáticamente a `astro-intlayer/client` (impulsado por `vanilla-intlayer`), proporcionando getters de diccionario en el cliente, suscriptores al store y herramientas de persistencia de locale.
+
+### Formateadores (astro-intlayer/format)
+
+Importación:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| Hook              | Descripción                                                                                                          |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Devuelve una instancia de Intl vinculada al locale con capacidades de almacenamiento en caché y suscripción.         |
+| `useDate`         | Devuelve una función de formato de fecha predeterminada para el locale actual (`Intl.DateTimeFormat`).               |
+| `useNumber`       | Devuelve una función de formato numérico predeterminada para el locale actual (`Intl.NumberFormat`).                 |
+| `useCurrency`     | Devuelve una función de formato de moneda predeterminada para el locale actual.                                      |
+| `usePercentage`   | Devuelve una función de formato de porcentaje predeterminada para el locale actual.                                  |
+| `useRelativeTime` | Devuelve una función de formato de tiempo relativo predeterminada para el locale actual (`Intl.RelativeTimeFormat`). |
+| `useList`         | Devuelve una función de formato de lista predeterminada para el locale actual (`Intl.ListFormat`).                   |
+| `useUnit`         | Devuelve una función de formato de unidad predeterminada para el locale actual.                                      |
+| `useCompact`      | Devuelve una función de formato de número compacto predeterminada para el locale actual (p. ej. `1.5K`).             |
+
+### Utilidades HTML (astro-intlayer/html)
+
+Importación:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| Exportación       | Tipo       | Descripción                                                          |
+| ----------------- | ---------- | -------------------------------------------------------------------- |
+| `renderHTML`      | `Function` | Función de utilidad independiente para renderizar nodos HTML.        |
+| `useHTML`         | `Hook`     | Hook para obtener el contexto y configuración del proveedor de HTML. |
+| `useHTMLRenderer` | `Hook`     | Hook para obtener una función de renderizado de HTML preconfigurada. |
+
+### Utilidades Markdown (astro-intlayer/markdown)
+
+Importación:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| Exportación           | Tipo       | Descripción                                                              |
+| --------------------- | ---------- | ------------------------------------------------------------------------ |
+| `compileMarkdown`     | `Function` | Compila cadenas markdown en una representación estructurada.             |
+| `renderMarkdown`      | `Function` | Renderiza contenido markdown en nodos de salida.                         |
+| `parseMarkdown`       | `Function` | Analiza contenido markdown en un AST.                                    |
+| `useMarkdown`         | `Hook`     | Hook para obtener el contexto del proveedor de markdown.                 |
+| `useMarkdownRenderer` | `Hook`     | Hook para obtener una función de renderizado de Markdown preconfigurada. |
+
+### Tipos
+
+Importación:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| Tipo              | Descripción                                                                                              |
+| ----------------- | -------------------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | El objeto adjunto a `Astro.locals.intlayer` que contiene `locale`, `defaultLocale` y `availableLocales`. |
+| `UseLocaleProps`  | Propiedades de configuración opcionales aceptadas por `useLocale()`.                                     |
+| `UseLocaleResult` | El tipo de retorno de `useLocale()`, que proporciona propiedades de locale y métodos de actualización.   |

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: Documentación de la integración intlayer | astro-intlayer
+description: Aprende a configurar y utilizar la integración de Astro intlayer en astro.config.mjs.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - integración
+  - i18n
+  - internacionalización
+  - documentación
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Actualizada documentación de integración con detalles de middleware y hooks"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "Doc inicial"
+author: aymericzip
+---
+
+# Documentación de la integración de Astro intlayer
+
+La integración `intlayer` para Astro configura tu proyecto para la internacionalización (i18n) multilingüe. Se encarga de la preparación de diccionarios en tiempo de compilación, la inyección de plugins de Vite, el registro automático de middleware de solicitudes y la emisión de páginas prerenderizadas localizadas.
+
+## Uso
+
+Agrega `intlayer()` a tu `astro.config.mjs`:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+El codemod del CLI de Astro (`astro add astro-intlayer`) también genera una importación predeterminada que es compatible:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## Descripción
+
+La integración se conecta al ciclo de vida de compilación y ejecución de Astro:
+
+1. **Configuración (`astro:config:setup`)**:
+   - **Preparación de diccionarios**: Prepara los diccionarios de Intlayer y los tipos generados antes de que se ejecute la compilación.
+   - **Plugins de Vite**: Inyecta plugins para alias de Vite (permitiendo importaciones directas de diccionarios), proxies de enrutamiento de locale y poda de compilación.
+   - **Registro de Middleware**: Inyecta automáticamente `astro-intlayer/middleware` en la cadena de middleware de tu proyecto, completando `Astro.locals.intlayer` en cada solicitud entrante.
+2. **Compilación finalizada (`astro:build:done`)**:
+   - **Reescritura de páginas**: Inspecciona las reglas de reescritura de URL localizadas y emite páginas HTML prerenderizadas en sus rutas localizadas correspondientes.
+
+## Qué se proporciona de forma predeterminada
+
+Una vez configurada, tu aplicación Astro puede utilizar inmediatamente:
+
+- Los hooks `useIntlayer`, `useDictionary` y `useLocale` dentro del frontmatter de componentes `.astro`.
+- El objeto `Astro.locals.intlayer` en endpoints y páginas de Astro.
+- Importaciones en el cliente en bloques `<script>` que reflejan la misma API con actualizaciones reactivas.
+- Formateadores integrados bajo `astro-intlayer/format` (`useDate`, `useNumber`, `useCurrency`, etc.).
+
+## Documentación relacionada
+
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/useLocale.md)
+- [Middleware `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/astro-intlayer/onRequest.md)