Creation:2026-01-21Last update:2026-01-21

    intlayer Package

    The intlayer package is the core library of the Intlayer ecosystem. It provides the essential functions, types, and utilities for managing multilingual content in JavaScript and TypeScript applications.

    Installation

    npm install intlayer
    yarn add intlayer
    pnpm add intlayer
    bun add intlayer

    Exports

    Configuration

    Import:

    import "intlayer";
    Variable Type Description Related Doc
    configuration IntlayerConfig The Intlayer configuration object. getConfiguration
    getConfiguration () => IntlayerConfig Returns the Intlayer configuration object. (Deprecated: Use configuration instead) getConfiguration
    locales Locales[] The list of all supported locales. -
    requiredLocales Locales[] The list of all required locales. -
    defaultLocale Locales The default locale. -

    Types

    Import:

    import "intlayer";
    Type Description
    Dictionary The dictionary type used to define the structure of a dictionary.
    DeclarationContent (Deprecated) Use Dictionary<T> instead.
    IntlayerConfig The type defining the Intlayer configuration.
    ContentNode A node in the dictionary content.
    Locale The type representing a locale.
    LocalesValues The possible values for a locale.
    StrictModeLocaleMap A map of locales with strict type checking.

    Content Functions

    Import:

    import "intlayer";
    Function Type Description Related Doc
    t / getTranslation Function Picks content based on the current locale. translation
    enu / getEnumeration Function Picks content based on a quantity. enumeration
    cond / getCondition Function Picks content based on a boolean condition. condition
    gender Function Picks content based on a gender. gender
    insert Function Inserts values into a content string. insertion
    nest / getNesting Function Nests another dictionary. nesting
    md Function Processes markdown content. markdown
    html Function Processes HTML content. html
    file Function Handles file content. file
    getDictionary Function Processes objects that look like dictionaries (key, content). It processes t() translations, enumerations, etc. -
    getIntlayer Function Based on getDictionary, but injects an optimized version of the dictionary from the generated declaration. -

    Localization Utilities

    Import:

    import "intlayer";
    Function Type Description Related Doc
    getLocale Function Detects the locale from a string or path. getLocale
    getLocaleLang Function Gets the language part of a locale. getLocaleLang
    getLocaleName Function Gets the display name of a locale. getLocaleName
    getLocalizedPath Function Resolves a canonical path to localized. getLocalizedPath
    getCanonicalPath Function Resolves a localized path to canonical. getCanonicalPath
    getLocalizedUrl Function Generates a localized URL. getLocalizedUrl
    getMultilingualUrls Function Generates URLs for all supported locales. getMultilingualUrls
    getPathWithoutLocale Function Removes the locale prefix from a path. getPathWithoutLocale
    getPrefix Function Gets the locale prefix from a path. getPrefix
    getHTMLTextDir Function Gets the text direction (LTR/RTL). getHTMLTextDir
    validatePrefix Function Validates a locale prefix. validatePrefix

    Browser Utilities

    Import:

    import "intlayer";
    Function Type Description
    getBrowserLocale Function Detects the browser's preferred locale.
    getCookie Function Retrieves a cookie value.
    getLocaleFromStorage Function Retrieves the locale from storage.
    setLocaleInStorage Function Saves the locale to storage.

    Formatters

    Import:

    import "intlayer";
    Function Description
    number Formats a number.
    currency Formats a currency value.
    percentage Formats a percentage.
    compact Formats a number in compact form.
    date Formats a date.
    relativeTime Formats relative time.
    units Formats a value with units.
    Intl The standard Intl object.
    Why Intlayer ?