Huz.Com > Component > I18N

• I18n builder & flatter for current language

Standards

• Language: TS
• Eslint: Yes
• Static Code Analysis: Yes IntelliJ Code Inspections
• DDD - Document Driven: Yes
• EDD - Exception Driven: Yes
• TDD - Test Driven: Yes go to test folder
• Standards Complied: Huz Standards

Commands

• npm run clear // clears "dist" folder
• npm run lint // runs eslint for static code analysis
• npm run test // runs test files in "test" folder
• npm run build // builds JS files at "dist" folder
• npm publish or npm run publix // publishes "dist" folder to npm

Install

npm i @huz-com/i18n

Import

const {i18nString} = require('@huz-com/i18n');
//there are many most-used variations below

Options

const {i18nOption} = require('@huz-com/i18n');

i18nOption
    // which languages are viewable at client side
    .setAvailableLanguagesFn(() => ['tr', 'en'])
    // if empty response at admin side
    .setInitialLanguagesFn(() => ['en'])
    // which languages is editable at admin site
    .setManagedLanguagesFn(() => ['en', 'tr', 'de']);

Built-in Variations

Class	DateType
i18nAlpha	{[lang: string]: string}
i18nAlphaArray	{[lang: string]: Array<string>}
i18nAlphaMap	{[lang: string]: Record<string, string>}
i18nBoolean	{[lang: string]: boolean}
i18nBooleanArray	{[lang: string]: Array<boolean>}
i18nBooleanMap	{[lang: string]: Record<string, boolean>}
i18nDescription	{[lang: string]: string}
i18nDescriptionArray	{[lang: string]: Array<string>}
i18nDescriptionMap	{[lang: string]: Record<string, string>}
i18nDigit	{[lang: string]: string}
i18nDigitArray	{[lang: string]: Array<string>}
i18nDigitMap	{[lang: string]: Record<string, string>}
i18nEmail	{[lang: string]: string}
i18nEmailArray	{[lang: string]: Array<string>}
i18nEmailMap	{[lang: string]: Record<string, string>}
i18nFloat	{[lang: string]: number}
i18nFloatArray	{[lang: string]: Array<number>}
i18nFloatMap	{[lang: string]: Record<string, number>}
i18nFolder	{[lang: string]: string}
i18nFolderArray	{[lang: string]: Array<string>}
i18nFolderMap	{[lang: string]: Record<string, string>}
i18nHost	{[lang: string]: string}
i18nHostArray	{[lang: string]: Array<string>}
i18nHostMap	{[lang: string]: Record<string, string>}
i18nInteger	{[lang: string]: number}
i18nIntegerArray	{[lang: string]: Array<number>}
i18nIntegerMap	{[lang: string]: Record<string, number>}
i18nIsoDate	{[lang: string]: string}
i18nIsoDateArray	{[lang: string]: Array<string>}
i18nIsoDateMap	{[lang: string]: Record<string, string>}
i18nIsoDatetime	{[lang: string]: string}
i18nIsoDatetimeArray	{[lang: string]: Array<string>}
i18nIsoDatetimeMap	{[lang: string]: Record<string, string>}
i18nIsoTime	{[lang: string]: string}
i18nIsoTimeArray	{[lang: string]: Array<string>}
i18nIsoTimeMap	{[lang: string]: Record<string, string>}
i18nRegExp	{[lang: string]: RegExp}
i18nRegExpArray	{[lang: string]: Array<RegExp>}
i18nRegExpMap	{[lang: string]: Record<string, RegExp>}
i18nRichText	{[lang: string]: string}
i18nRichTextArray	{[lang: string]: Array<string>}
i18nRichTextMap	{[lang: string]: Record<string, string>}
i18nString	{[lang: string]: string}
i18nStringArray	{[lang: string]: Array<string>}
i18nStringMap	{[lang: string]: Record<string, string>}
i18nTitle	{[lang: string]: string}
i18nTitleArray	{[lang: string]: Array<string>}
i18nTitleMap	{[lang: string]: Record<string, string>}
i18nUrl	{[lang: string]: string}
i18nUrlArray	{[lang: string]: Array<string>}
i18nUrlMap	{[lang: string]: Record<string, string>}
i18nUuid	{[lang: string]: string}
i18nUuidArray	{[lang: string]: Array<string>}
i18nUuidMap	{[lang: string]: Record<string, string>}

Create Custom Variation

const {AbstractI18n} = require('@huz-com/i18n');


/**
 * Assume that, you want to assign a person to each language
 * */
class SamplePerson {
    id = null;
    name = null;
    
    /**
     * @param {any} value
     * @returns {SamplePerson}
     * */
    static cast(value) {
        const obj = SamplePerson(); 
        obj.id = value?.id || null;
        obj.name = value?.name || null;
        //validates value is {id: string, name: string}
        return obj;
    }
    /**
     * @param {Array<any>} values
     * @returns {Array<SamplePerson>}
     * */
    static castArray(values) {
        const list = [];
        values.forEach(value => {
            list.push(SamplePerson.cast(value));
        });
        return list;
    } 
}
export class I18nPerson extends AbstractI18n<SamplePerson> {
    constructor() {
        super(SamplePerson.cast);
    }
}
export class I18nPersonArray extends AbstractI18n<SamplePerson> {
    constructor() {
        super(SamplePerson.castArray);
    }
}
const i18nPerson = new I18nPerson();

//DEF_KEY is "__" it will be filled by default language (languageDefault)
//Invalid language will be removed, only languageAvailableList keys will be seved
i18nPerson.cast({en: {id:5}, invalidLang: {id:23, name: 'dummy'}});  //{__: {id:5, name: null}, en: {id:5, name: null}}

//Plain value (not-i18n) will be converted as i18n 
i18nPerson.cast(req, {id:7}) //{__: {id:7, name: null}, en: {id:7, name: null}}

//DEF_KEY will be removed
i18nPerson.view(req, {__: {id:7, name: 'Eric'}, en: {id:7, name: 'Eric'}, de: {id:34, name: 'Hans'}}) //{en: {id:7, name: 'Eric'}, de: {id:34, name: 'Hans'}}

//it based on languageDefaultList, ie: if it is ['en', 'de']
i18nPerson.def(req) //{en: {id:null, name: null}, de: {id:null, name: null}}

//it based on languageDefault, ie: if it is 'de'
i18nPerson.mapToPlain(req, {__: {id:7, name: 'Eric'}, en: {id:7, name: 'Eric'}, de: {id:34, name: 'Hans'}}) //{id:34, name: 'Hans'}