Autor:
    Aymeric PINEAU
    Criação:2026-09-19Última atualização:2026-09-19

    Pacote remix-intlayer

    O pacote remix-intlayer fornece as ferramentas necessárias para integrar o Intlayer em aplicações Remix 3. Desenvolvido inteiramente sobre padrões web (Request, Response, Headers e URL), oferece middleware de roteador para roteamento por locale e reescritas internas, armazenamento de contexto, hooks e utilitários de formatação para gerenciamento simples de conteúdo multilíngue.

    Instalação

    bash
    npm install remix-intlayer

    Exportações

    Middleware

    Importação:

    tsx
    import { intlayer } from "remix-intlayer";
    FunçãoDescriçãoDoc relacionada
    intlayerMiddleware de roteador Remix 3 que gerencia o roteamento baseado em locale (redirecionamentos e reescritas internas), resolve a locale da requisição, persiste-a em cookies/cabeçalhos e estabelece o escopo de contexto da requisição.intlayer

    Contexto

    Importação:

    tsx
    import { Intlayer, INTLAYER_CONTEXT_PROPERTY } from "remix-intlayer";
    ExportaçãoTipoDescriçãoDoc relacionada
    IntlayerContextKeyChave de RequestContext contendo o IntlayerState (locale, defaultLocale, availableLocales) para a requisição atual.Intlayer
    INTLAYER_CONTEXT_PROPERTYstringNome de propriedade ('intlayer') instalado diretamente no contexto da requisição, acessível via context.intlayer e context.get(Intlayer).-

    Hooks

    Importação:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "remix-intlayer";
    HookDescriçãoDoc relacionada
    useIntlayerSeleciona um dicionário por sua chave e retorna seu conteúdo para a locale da requisição atual. Lê automaticamente do contexto da requisição.useIntlayer
    useDictionaryTransforma um objeto de dicionário importado e retorna seu conteúdo para a locale da requisição atual. Suporta seletores.useDictionary
    useLocaleRetorna a locale resolvida da requisição atual, juntamente com defaultLocale e availableLocales configuradas.useLocale

    Utilitários

    Importação:

    tsx
    import { createLocaleRouting, getIntlayerState } from "remix-intlayer";
    FunçãoDescriçãoDoc relacionada
    createLocaleRoutingFunção pura que calcula decisões de roteamento (redirect, rewrite ou pass) com base em requisição, configuração e opções.-
    getIntlayerStateLê o IntlayerState atual (locale, defaultLocale, availableLocales) do escopo AsyncLocalStorage.-

    Formatadores (remix-intlayer/format)

    Importação:

    tsx
    import {
  useIntl,
  useDate,
  useNumber,
  useCurrency,
  usePercentage,
  useRelativeTime,
  useList,
  useUnit,
  useCompact,
} from "remix-intlayer/format";
    HookDescrição
    useIntlRetorna uma instância Intl vinculada à locale da requisição com recursos de cache e assinatura.
    useDateRetorna uma função de formatação de data vinculada à locale da requisição (Intl.DateTimeFormat).
    useNumberRetorna uma função de formatação de número vinculada à locale da requisição (Intl.NumberFormat).
    useCurrencyRetorna uma função de formatação de moeda vinculada à locale da requisição.
    usePercentageRetorna uma função de formatação de porcentagem vinculada à locale da requisição.
    useRelativeTimeRetorna uma função de formatação de tempo relativo vinculada à locale da requisição (Intl.RelativeTimeFormat).
    useListRetorna uma função de formatação de lista vinculada à locale da requisição (Intl.ListFormat).
    useUnitRetorna uma função de formatação de unidade vinculada à locale da requisição.
    useCompactRetorna uma função de formatação de número compacto vinculada à locale da requisição (ex.: 1.5K).

    Utilitários HTML (remix-intlayer/html)

    Importação:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "remix-intlayer/html";
    ExportaçãoTipoDescrição
    renderHTMLFunctionFunção utilitária para renderizar nós HTML fora da interface do usuário.
    useHTMLHookHook para obter o contexto e a configuração do provedor HTML.
    useHTMLRendererHookHook para obter uma função de renderização HTML pré-configurada.

    Utilitários Markdown (remix-intlayer/markdown)

    Importação:

    tsx
    import {
  compileMarkdown,
  renderMarkdown,
  parseMarkdown,
  useMarkdown,
  useMarkdownRenderer,
} from "remix-intlayer/markdown";
    ExportaçãoTipoDescrição
    compileMarkdownFunctionCompila strings markdown em representação estruturada.
    renderMarkdownFunctionRenderiza conteúdo markdown em nós de saída.
    parseMarkdownFunctionAnalisa conteúdo markdown bruto em uma AST.
    useMarkdownHookHook para acessar o contexto do provedor markdown.
    useMarkdownRendererHookHook para obter uma função de renderização Markdown pré-configurada.

    Tipos

    Importação:

    tsx
    import type {
  IntlayerState,
  IntlayerMiddlewareOptions,
  LocaleRoutingOptions,
  LocaleRoutingAction,
  LocaleRoutingRequest,
  UseLocaleResult,
} from "remix-intlayer";
    TipoDescrição
    IntlayerStateObjeto de estado contendo locale, defaultLocale e availableLocales armazenado no contexto Remix.
    IntlayerMiddlewareOptionsOpções de configuração passadas para o middleware intlayer().
    LocaleRoutingOptionsOpções que personalizam prefixos de locale, detecção e redirecionamentos.
    LocaleRoutingActionUnião discriminada representando a decisão de roteamento: redirect, rewrite ou pass.
    LocaleRoutingRequestRepresentação mínima de requisição exigida por createLocaleRouting.
    UseLocaleResultTipo de retorno de useLocale(), contendo locale, defaultLocale e availableLocales.
    useLocaleintlayer