Auteur:
    Aymeric PINEAU
    Création:2026-09-19Dernière mise à jour:2026-09-19

    Package remix-intlayer

    Le package remix-intlayer fournit les outils nécessaires pour intégrer Intlayer dans les applications Remix 3. Conçu entièrement sur les standards web (Request, Response, Headers et URL), il propose un middleware de routeur pour le routage par locale et les réécritures internes, le stockage de contexte, des hooks et des utilitaires de formatage pour une gestion simple du contenu multilingue.

    Installation

    bash
    npm install remix-intlayer

    Exports

    Middleware

    Import :

    tsx
    import { intlayer } from "remix-intlayer";
    FonctionDescriptionDoc associée
    intlayerMiddleware de routeur Remix 3 qui gère le routage par locale (redirections et réécritures internes), résout la locale de la requête, la persiste dans les cookies/en-têtes et initialise la portée du contexte de requête.intlayer

    Contexte

    Import :

    tsx
    import { Intlayer, INTLAYER_CONTEXT_PROPERTY } from "remix-intlayer";
    ExportTypeDescriptionDoc associée
    IntlayerContextKeyClé de RequestContext contenant l'IntlayerState (locale, defaultLocale, availableLocales) pour la requête actuelle.Intlayer
    INTLAYER_CONTEXT_PROPERTYstringNom de propriété ('intlayer') installé directement sur le contexte de requête, accessible via context.intlayer et context.get(Intlayer).-

    Hooks

    Import :

    tsx
    import { useIntlayer, useDictionary, useLocale } from "remix-intlayer";
    HookDescriptionDoc associée
    useIntlayerSélectionne un dictionnaire par sa clé et retourne son contenu pour la locale de la requête en cours. Lit automatiquement depuis le contexte de requête.useIntlayer
    useDictionaryTransforme un objet dictionnaire importé et retourne son contenu pour la locale de la requête actuelle. Supporte les sélecteurs.useDictionary
    useLocaleRetourne la locale résolue de la requête actuelle, avec la defaultLocale et les availableLocales configurées.useLocale

    Utilitaires

    Import :

    tsx
    import { createLocaleRouting, getIntlayerState } from "remix-intlayer";
    FonctionDescriptionDoc associée
    createLocaleRoutingFonction pure qui détermine les actions de routage (redirect, rewrite ou pass) selon la requête, la configuration et les options.-
    getIntlayerStateLit l'IntlayerState actuel (locale, defaultLocale, availableLocales) depuis le stockage de requête AsyncLocalStorage.-

    Formateurs (remix-intlayer/format)

    Import :

    tsx
    import {
  useIntl,
  useDate,
  useNumber,
  useCurrency,
  usePercentage,
  useRelativeTime,
  useList,
  useUnit,
  useCompact,
} from "remix-intlayer/format";
    HookDescription
    useIntlRetourne une instance Intl liée à la locale de la requête avec gestion du cache et abonnements.
    useDateRetourne une fonction de formatage de date liée à la locale de la requête (Intl.DateTimeFormat).
    useNumberRetourne une fonction de formatage de nombre liée à la locale de la requête (Intl.NumberFormat).
    useCurrencyRetourne une fonction de formatage de devise liée à la locale de la requête.
    usePercentageRetourne une fonction de formatage de pourcentage liée à la locale de la requête.
    useRelativeTimeRetourne une fonction de formatage de temps relatif liée à la locale de la requête (Intl.RelativeTimeFormat).
    useListRetourne une fonction de formatage de liste liée à la locale de la requête (Intl.ListFormat).
    useUnitRetourne une fonction de formatage d'unité liée à la locale de la requête.
    useCompactRetourne une fonction de formatage compact de nombre liée à la locale de la requête (ex. 1.5K).

    Utilitaires HTML (remix-intlayer/html)

    Import :

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "remix-intlayer/html";
    ExportTypeDescription
    renderHTMLFunctionFonction utilitaire pour effectuer le rendu des nœuds HTML hors interface utilisateur.
    useHTMLHookHook pour obtenir le contexte et la configuration du fournisseur HTML.
    useHTMLRendererHookHook pour obtenir une fonction de rendu HTML pré-configurée.

    Utilitaires Markdown (remix-intlayer/markdown)

    Import :

    tsx
    import {
  compileMarkdown,
  renderMarkdown,
  parseMarkdown,
  useMarkdown,
  useMarkdownRenderer,
} from "remix-intlayer/markdown";
    ExportTypeDescription
    compileMarkdownFunctionCompile des chaînes markdown en représentation structurée.
    renderMarkdownFunctionRend le contenu markdown en nœuds de sortie.
    parseMarkdownFunctionAnalyse le contenu markdown brut en AST.
    useMarkdownHookHook pour accéder au contexte du fournisseur markdown.
    useMarkdownRendererHookHook pour obtenir une fonction de rendu Markdown pré-configurée.

    Types

    Import :

    tsx
    import type {
  IntlayerState,
  IntlayerMiddlewareOptions,
  LocaleRoutingOptions,
  LocaleRoutingAction,
  LocaleRoutingRequest,
  UseLocaleResult,
} from "remix-intlayer";
    TypeDescription
    IntlayerStateObjet d'état contenant locale, defaultLocale et availableLocales stocké dans le contexte Remix.
    IntlayerMiddlewareOptionsOptions de configuration transmises au middleware intlayer().
    LocaleRoutingOptionsOptions personnalisant les préfixes de locale, la détection et les redirections.
    LocaleRoutingActionUnion discriminée représentant la décision de routage : redirect, rewrite ou pass.
    LocaleRoutingRequestReprésentation minimale de la requête requise par createLocaleRouting.
    UseLocaleResultType de retour de useLocale(), contenant locale, defaultLocale et availableLocales.
    useLocaleintlayer