Localizer

A localization module for managing translations and providing localized content in your application.

Installation

npm i @sern/localizer

Usage

Initializing the Localizer

src/index.js

import { makeDependencies } from '@sern/handler';
import { Localization } from '@sern/localizer';

await makeDependencies(({ add }) => {
    // add other deps
    add('localizer', Localization());
});

src/dependencies.d.ts

import type { Logging, CoreDependencies } from '@sern/handler'
import type { Localizer } from '@sern/localizer'
declare global {
    interface Dependencies extends CoreDependencies {
        localizer: Localizer;
   }
}
export {}

This localizer is FILE BASED. Create the directory assets/locals. Each json file in here must be named after the locale

Spanish

~/assets/locals/es-ES.json

    {
        "salute": {
            "hello": "hola"
        }
    }

English

~/assets/locals/en-US.json

    {
        "salute": {
            "hello": "hello"
        }
    }

Accessing translations

• If you are in a command execute callback, use deps from SDT.

execute : (ctx, { deps }) => {
    //the localizer object from makeDependencies
    deps.localizer
    // Returns the Spanish translation for 'salute.hello'
    deps.localizer.translate("salute.hello", "es-ES");
}

import { local } from '@sern/localizer';

// Returns the Spanish translation for 'salute.hello'
const greeting = local('salute.hello', 'es-ES');