@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.8

package/docs/es/intlayer_with_tanstack+solid.md

@@ -228,11 +228,15 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -568,22 +572,25 @@ También puede utilizar `intlayerProxy` para añadir enrutamiento del lado del s
 
 > Tenga en cuenta que para utilizar `intlayerProxy` en producción, necesita cambiar el paquete `vite-intlayer` de `devDependencies` a `dependencies`.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/solid-start/plugin/vite";
 import solid from "vite-plugin-solid";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // El proxy debe colocarse antes que el servidor si utiliza Nitro
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solid(),
@@ -826,9 +833,9 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
-Actualice su `vite.config.ts` para incluir el plugin `intlayerCompiler`:
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
-> Desde Intlayer v9, el compilador está integrado directamente en el plugin `intlayer()` y se activa automáticamente una vez que `compiler.enabled` está configurado con una ruta en `compiler.output`. Registrar `intlayerCompiler()` por separado como se muestra a continuación ahora es opcional — se deduplica a sí mismo si también se añade. Consulta las [notas de la versión v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v9.md).
+Actualice su `vite.config.ts` para incluir el plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
 import { intlayer, intlayerCompiler } from "vite-intlayer";
@@ -843,12 +850,12 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
     intlayer(),
-    intlayerCompiler(),
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/intlayer_with_tanstack.md

@@ -242,11 +242,15 @@ import { intlayer } from "vite-intlayer";
 const config = defineConfig({
   plugins: [
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -650,22 +654,25 @@ También puedes usar el `intlayerProxy` para añadir enrutamiento del lado del s
 
 > Ten en cuenta que para usar el `intlayerProxy` en producción, necesitas cambiar el paquete `vite-intlayer` de `devDependencies` a `dependencies`.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/react-start/plugin/vite";
 import viteReact from "@vitejs/plugin-react";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // El proxy debe colocarse antes que el servidor si utilizas Nitro
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -906,6 +913,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -915,7 +924,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Agrega el plugin del compilador
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/intlayer_with_vite+lit.md

@@ -205,7 +205,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -474,12 +480,15 @@ Primero, agrega `intlayerProxy` a tu configuración de Vite:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/es/intlayer_with_vite+preact.md

@@ -829,6 +829,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -838,7 +840,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Agrega el plugin del compilador
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/intlayer_with_vite+react.md

@@ -504,14 +504,17 @@ Paralelamente, también puedes usar el `intlayerProxy` para agregar enrutamiento
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     react(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -816,6 +819,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -825,7 +830,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Agrega el plugin del compilador
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/intlayer_with_vite+react_compiler.md

@@ -213,11 +213,18 @@ Añade el complemento de intlayer en tu configuración.
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerCompiler()],
+  plugins: [
+    react(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/es/intlayer_with_vite+solid.md

@@ -596,6 +596,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -605,7 +607,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Agrega el plugin del compilador
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/intlayer_with_vite+svelte.md

@@ -458,7 +458,7 @@ Paralelamente, también puedes usar `intlayerProxy` para añadir enrutamiento de
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
   plugins: [intlayerProxy(), // should be placed first
  svelte(), intlayer()],
@@ -592,6 +592,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -601,7 +603,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Agrega el plugin del compilador
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/intlayer_with_vite+vanilla.md

@@ -205,7 +205,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -466,12 +472,15 @@ Primero, añade `intlayerProxy` a tu configuración de Vite:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // debe colocarse primero
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -603,6 +612,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Actualiza tu `vite.config.ts` para incluir el plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -612,7 +623,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Añade el plugin del compilador
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/intlayer_with_vite+vue.md

@@ -665,14 +665,17 @@ Paralelamente, también puede usar el `intlayerProxy` para agregar enrutamiento
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -1001,6 +1004,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Actualiza tu archivo `vite.config.ts` para incluir el plugin `intlayerCompiler` :
 
 ```ts fileName="vite.config.ts"
@@ -1010,7 +1015,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Agrega el plugin del compilador
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/es/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Documentación del paquete @intlayer/babel"
+description: Complementos de Babel para Intlayer para manejar la extracción de contenido, la optimización de importaciones, la depuración de campos no utilizados y la ofuscación de nombres de campos durante la compilación.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - internacionalización
+  - i18n
+  - compilador
+  - optimizar
+  - depurar
+  - minificar
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Documentación unificada de todas las exportaciones"
+author: aymericzip
+---
+
+# Paquete @intlayer/babel
+
+El paquete `@intlayer/babel` proporciona un conjunto de plugins de Babel especializados para Intlayer. Estos plugins cubren todo el ciclo de compilación: extracción de declaraciones de contenido, reescritura de llamadas a `useIntlayer` / `getIntlayer` a importaciones de diccionarios optimizadas, depuración de campos no utilizados y minificación de nombres de campos.
+
+## Instalación
+
+```bash
+npm install @intlayer/babel
+```
+
+## Exportaciones
+
+Importar:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Plugins
+
+| Función / Clase                | Descripción                                                                                                                                                                                                              |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `intlayerExtractBabelPlugin`   | Plugin de Babel que extrae contenido traducible de archivos fuente e inyecta los hooks `useIntlayer` / `getIntlayer` automáticamente. Diseñado para su uso con Next.js y herramientas de compilación basadas en Babel.   |
+| `intlayerOptimizeBabelPlugin`  | Plugin de Babel que transforma las llamadas `useIntlayer` y `getIntlayer` y reescribe sus importaciones a importaciones de diccionarios JSON optimizadas (estáticas, dinámicas o a través de fetch).                     |
+| `intlayerPurgeBabelPlugin`     | Plugin de Babel que analiza archivos fuente y reescribe archivos JSON de diccionarios compilados para eliminar campos no utilizados (`build.purge`) o renombrarlos a alias cortos (`build.minify`).                      |
+| `intlayerMinifyBabelPlugin`    | Plugin de Babel que reescribe archivos fuente para usar los alias de campos cortos asignados durante la fase de minificación (por ejemplo, `content.title` ← `content.a`). Depende de `intlayerPurgeBabelPlugin`.        |
+| `makeFieldRenameBabelPlugin`   | Función de fábrica que produce un plugin de Babel para renombrar los accesos a campos de contenido de diccionarios en archivos fuente de acuerdo con la `dictionaryKeyToFieldRenameMap` completada en el `PruneContext`. |
+| `makeUsageAnalyzerBabelPlugin` | Función de fábrica que produce un plugin de Babel para analizar el uso de `useIntlayer` / `getIntlayer` en el código fuente y acumular datos de uso de campos en el `PruneContext` compartido.                           |
+| `getSharedPruneContext`        | Función de ayuda que devuelve el objeto `PruneContext` compartido para el directorio base especificado, o `null` si aún no se ha inicializado.                                                                           |
+
+---
+
+### Utilidades de configuración del plugin
+
+| Función                    | Descripción                                                                                                                                                |
+| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getExtractPluginOptions`  | Carga la configuración de Intlayer y devuelve `ExtractPluginOptions` listas para su uso con `intlayerExtractBabelPlugin`.                                  |
+| `getOptimizePluginOptions` | Carga la configuración de Intlayer y los diccionarios compilados, y devuelve `OptimizePluginOptions` listas para su uso con `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Carga la configuración de Intlayer y devuelve `PurgePluginOptions` listas para su uso con `intlayerPurgeBabelPlugin`.                                      |
+| `getMinifyPluginOptions`   | Carga la configuración de Intlayer y devuelve `MinifyPluginOptions` listas para su uso con `intlayerMinifyBabelPlugin`.                                    |
+
+---
+
+### Tipos
+
+| Tipo                    | Descripción                                                                                                                                       |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Modo de compilador: `'dev'` para desarrollo con soporte HMR, o `'build'` para compilaciones de producción.                                        |
+| `ExtractPluginOptions`  | Opciones para `intlayerExtractBabelPlugin`: lista de archivos, configuración, callback `onExtract`, etc.                                          |
+| `ExtractResult`         | Resultado de la extracción: clave de diccionario, ruta del archivo, contenido y idioma.                                                           |
+| `OptimizePluginOptions` | Opciones para `intlayerOptimizeBabelPlugin`: rutas de diccionarios, modo de importación, mapa de modos por diccionario, etc.                      |
+| `PurgePluginOptions`    | Opciones para `intlayerPurgeBabelPlugin`: directorio base, indicadores de depuración/minificación/optimización, lista de archivos de componentes. |
+| `MinifyPluginOptions`   | Opciones para `intlayerMinifyBabelPlugin`: directorio base, indicadores de minificación/optimización/editorEnabled.                               |
+| `PruneContext`          | Estado compartido entre los plugins de análisis y depuración: mapas de uso de campos, mapas de renombrado, etc.                                   |
+| `DictionaryFieldUsage`  | Resultado del uso de campos para un solo diccionario: `Set<string>` o `'all'` cuando el análisis estático no es concluyente.                      |
+| `NestedRenameEntry`     | Nodo en el árbol de renombrado: el `shortName` y el mapa de hijos.                                                                                |
+| `NestedRenameMap`       | Un nivel en el árbol de renombrado: `Map<string, NestedRenameEntry>`.                                                                             |
+| `CompatCallerConfig`    | Configuración para un analizador de uso compatible para paquetes compat-adapter (nombre de la llamada y opciones de procesamiento).               |
+| `ScriptBlock`           | Bloque de script extraído de un tệp SFC (Vue o Svelte): contenido, desplazamiento de inicio y desplazamiento de final.                            |
+
+---
+
+### Funciones utilitarias
+
+| Función                           | Description                                                                                                                                                                                   |
+| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Convierte un entero (empezando desde cero) en un identificador alfabético corto: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, etc.                                                               |
+| `buildNestedRenameMapFromContent` | Construye recursivamente una `NestedRenameMap` a partir del valor de contenido de un diccionario compilado, respetando las estructuras de nodos de Intlayer (translation, enumeration, etc.). |
+| `createPruneContext`              | Crea un nuevo objeto `PruneContext` vacío inicializado con los valores predeterminados.                                                                                                       |
+| `extractScriptBlocks`             | Extrae bloques `<script>` de archivos SFC (Vue / Svelte) para un análisis Babel posterior.                                                                                                    |
+| `BABEL_PARSER_OPTIONS`            | Constante que representa las opciones del parser de Babel que cubren los frameworks admitidos (React/Vue/Svelte/Angular/...).                                                                 |
+| `INTLAYER_CALLER_NAMES`           | Lista constante de nombres de llamada originales de Intlayer: `['useIntlayer', 'getIntlayer']`.                                                                                               |
+
+---
+
+## Ejemplo de uso
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Nota:** El plugin `intlayerPurgeBabelPlugin` debe declararse **antes** de `intlayerMinifyBabelPlugin`, porque este último lee el mapa de renombrado creado por el primero. Además, ambos deben estar precedidos por `intlayerOptimizeBabelPlugin` para que este pueda ver las claves del diccionario antes de que se reescriban las llamadas a `useIntlayer`.

package/docs/es/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Documentación del plugin Vite intlayerCompiler | vite-intlayer
+description: Plugin de Vite que extrae declaraciones de contenido de Intlayer en línea de los archivos de componentes y las escribe en archivos JSON de diccionario en el momento de la compilación/transformación.
+keywords:
+  - intlayerCompiler
+  - vite
+  - plugin
+  - compilador
+  - contenido
+  - diccionario
+  - internacionalización
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Integrado en intlayer(); inicialización de doc"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` es un plugin de Vite que escanea los archivos de código fuente de los componentes en busca de **declaraciones de contenido inline de Intlayer** — contenido definido directamente dentro de un componente en lugar de en un archivo `.content.ts` separado — y las escribe en archivos JSON de diccionario durante la fase de transformación.
+
+> **Desde Intlayer v9**, `intlayerCompiler` se incluye automáticamente dentro del plugin principal [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/vite-intlayer/intlayer.md) cuando tanto `compiler.enabled` es `true` como `compiler.output` están configurados en su configuración de Intlayer. Solo necesita registrarlo por separado cuando desee tener un control total sobre la configuración específica del compilador.
+
+## Uso
+
+### Como parte de `intlayer()` (recomendado, v9+)
+
+Habilite el compilador a través de su configuración de Intlayer:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // donde se escriben los diccionarios extraídos
+  },
+});
+```
+
+Luego use el plugin estándar sin registro adicional:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Autónomo (cuando sea necesario)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Opciones
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Opción           | Tipo                      | Descripción                                                                                                             |
+| ---------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Anulaciones de configuración de Intlayer reenviadas a `getConfiguration()`.                                             |
+| `compilerConfig` | `Partial<CompilerConfig>` | Anulaciones para la sección de configuración específica del compilador (por ejemplo, `enabled`, `output`, `filesList`). |
+
+### Ejemplo
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Cómo funciona
+
+### Fase de transformación
+
+Para cada archivo fuente que coincida con `compiler.filesList`, el plugin del compilador:
+
+1. Pasa el contenido del archivo a través de `extractContent` de `@intlayer/babel`.
+2. Llama a `onExtract` para cada declaración encontrada, lo que escribe el JSON del diccionario resultante en `compiler.output`.
+3. Devuelve el código fuente transformado con las declaraciones en línea reemplazadas por llamadas estándar `useIntlayer('key')` / `getIntlayer('key')`.
+
+Tipos de archivos admitidos: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Cuando se guarda un archivo de componente en modo de desarrollo, el compilador:
+
+1. Detecta el cambio de archivo a través del hook `handleHotUpdate` de Vite.
+2. Vuelve a extraer el contenido del archivo actualizado.
+3. Escribe el JSON del diccionario actualizado.
+4. Activa una recarga completa de la página (`server.ws.send({ type: 'full-reload' })`).
+
+Un retraso (debounce) de 500 ms evita que la propia escritura del diccionario (que también activa un evento de cambio de archivo) cause un bucle de re-extracción infinito.
+
+### Deduplicación
+
+`intlayerCompiler` utiliza el mismo mecanismo de deduplicación `createPrimaryInstanceGuard` que los otros plugins incluidos. Cuando están presentes tanto `intlayer()` (que incluye el compilador) como una llamada manual a `intlayerCompiler()`, solo se ejecuta la primera instancia registrada; no se escribe ningún diccionario dos veces.