Autor:
    Criação:2026-01-21Última atualização:2026-01-21

    Documentação do Plugin intlayer para Vite

    O plugin Vite intlayer integra a configuração do Intlayer ao processo de build. Ele gerencia aliases de dicionÔrios, inicia o watcher de dicionÔrios em modo de desenvolvimento e prepara os dicionÔrios para o build.

    Uso

    ts
    // vite.config.ts
    import { defineConfig } from "vite";
    import { intlayer } from "vite-intlayer";
    
    export default defineConfig({
      plugins: [intlayer()],
    });
    

    OpƧƵes

    ts
    import type { IntlayerPluginOptions } from "vite-intlayer";
    

    IntlayerPluginOptions estende GetConfigurationOptions (ver @intlayer/config) com os seguintes campos adicionais:

    OpçãoTipoPadrãoDescrição
    compatCallersCompatCallerConfig[][]Padrões de chamador extra para pacotes compat-adapter (ex.: @intlayer/react-i18next). Passado ao analisador de uso de campo no momento da compilação.
    proxy{ ignore?: (req) => boolean }undefinedOpƧƵes encaminhadas para o proxy de roteamento de locale agrupado. Use ignore para excluir caminhos especƭficos (ex.: rotas de API) do roteamento de locale.

    Todas as outras opƧƵes (override, configFile, …) sĆ£o encaminhadas diretamente para getConfiguration().

    Exemplos

    Ignorar rotas de API do roteamento de locale

    ts
    // vite.config.ts
    import { defineConfig } from "vite";
    import { intlayer } from "vite-intlayer";
    
    export default defineConfig({
      plugins: [
        intlayer({
          proxy: {
            ignore: (req) => req.url?.startsWith("/api"),
          },
        }),
      ],
    });
    

    Com um caminho de arquivo de configuração personalizado

    ts
    export default defineConfig({
      plugins: [
        intlayer({
          configFile: "./config/intlayer.config.ts",
        }),
      ],
    });
    

    Com callers compat-adapter

    ts
    import { intlayer } from "vite-intlayer";
    import { reactI18nextCallerConfig } from "@intlayer/react-i18next/plugin";
    
    export default defineConfig({
      plugins: [
        intlayer({
          compatCallers: [reactI18nextCallerConfig],
        }),
      ],
    });
    

    O que o plugin faz

    1. Preparação do dicionÔrio

    Antes do build iniciar (e uma vez por hora em dev), intlayer chama prepareIntlayer para compilar todos os arquivos .content.ts em dicionƔrios JSON otimizados armazenados em .intlayer/.

    2. Aliases de módulo

    O plugin adiciona aliases de resolução do Vite para que import { myDict } from 'intlayer/dictionaries/my-dict' seja resolvido para o arquivo JSON compilado no disco. Os builds SSR usam ssr.noExternal para garantir que todos os pacotes @intlayer/* sejam agrupados com aliases aplicados.

    3. Dev-server watcher

    Em modo de desenvolvimento, um watcher chokidar é iniciado. Quando um arquivo .content.ts é alterado, os dicionÔrios são recompilados e o HMR do Vite propaga a atualização para o navegador.

    4. Proxy de roteamento de locale agrupado (v9+)

    Desde o Intlayer v9, o middleware intlayerProxy Ć© registrado automaticamente dentro de intlayer(). Ele trata:

    • Detecção de locale a partir do prefixo da URL, cookies e cabeƧalho Accept-Language.
    • Redirecionamentos 301 quando o locale detectado nĆ£o corresponde Ć  URL atual.
    • Reescritas de URL internas para que o framework veja o parĆ¢metro de rota [locale] correto.

    O proxy é controlado por routing.enableProxy (padrão true) na sua configuração do Intlayer. Para desabilitÔ-lo completamente:

    ts
    // intlayer.config.ts
    import { defineConfig } from "intlayer";
    
    export default defineConfig({
      routing: { enableProxy: false },
    });
    

    Para personalizar o comportamento do proxy sem uma chamada intlayerProxy() separada, passe opƧƵes proxy para o plugin principal:

    ts
    intlayer({ proxy: { ignore: (req) => req.url?.startsWith("/api") } });
    

    Veja a documentação do intlayerProxy para a referência completa do comportamento de roteamento.

    5. Compilador agrupado (v9+)

    Quando compiler.enabled é true e compiler.output estÔ definido na sua configuração Intlayer, intlayer() registra intlayerCompiler automaticamente. O compilador extrai declarações de conteúdo inline escritas diretamente dentro de arquivos de componente e as escreve em dicionÔrios no tempo de transformação. Consulte a documentação do intlayerCompiler.

    6. OtimizaƧƵes de build

    Durante um build de produção, o plugin adiciona:

    • intlayerOptimize – Babel transform que reescreve useIntlayer('key') → useDictionary(hash) e injeta importaƧƵes JSON diretas.
    • intlayerPrune – remove campos de conteĆŗdo nĆ£o utilizados do dictionary JSON.
    • intlayerMinify – compacta dictionary JSON e opcionalmente faz mangling de nomes de campos.

    Estes estão inativos em modo de desenvolvimento.

    Aliases Descontinuadas

    Exportação DescontinuadaSubstituição
    intlayerPluginintlayer
    intLayerPluginintlayer