parcel-plugin-ts-mini
This library is a replacement of parcel native Typescript support. It extends functionality by providing additional languague features, like translations or unique identifiers
Translations
Translations make use of redundant unused escape character \i (backslash i). All you have to do is to tag a string that has to be translated with sequence \i:
Example:
const someText = "\i:That text will be translated";
During compilation that will automatically add unique identifier for that text and will save that text to a translations.json file.
NOTE: If you'll want to port this way of translations use a name 'tsmLang' for it.
File translations.json
In order to be able to use translations you have to place translations.json file in root directory of your project. At minimum file has to contain an empty object.
{
"default": "en", // a languague for strings in your code
"languages": [ // a list of languages that you expect your app or lib to be translated to
"pl",
"de",
"es"
],
}
ISO639 is used as standard for languague encoding
Compilation with selected languague
Currently only static compilation is supported and that means that for every app you'll have separate executables with statically included translations. To select languague you have to set envirionment variable TSM_LANG to desired languague code.
TSM_LANG=es parcel src-fe/index.html --out-dir dst/fe-dev
You can also get a languague code in your source code by placing \i\l: at begining of string:
const langCode = '\i\l:';
Fixed enumeration
If you need numbers automaticly assigned to enumeration elements in a way that they will not change their value upon adding or removal or order change of enumeration elements then add something like this to your enum code:
// @tsm fixed:
enum MyEnumeration {
SOMETHING
}
You can also define optionally a direction of numbering and starting number:
// @tsm fixed: positive 5
enum MyEnumeration1 {
SOMETHING
}
// @tsm fixed: negative
enum MyEnumeration2 {
SOMETHING
}
Starting number is automatically updated and always points next value that will be used upon adding new element. Starting number can be also passed to selected enumeration element:
// @tsm fixed: positive 5 NAME_FOR_STARTING_NUMBER
enum MyEnumeration1 {
SOMETHING,
NAME_FOR_STARTING_NUMBER
}
Fixed enumeration for variables and constants
Fixed enumeration works also for constants and variables, in this case every element with "NaN" value will be assigned automatically a new value
// @tsm fixed: negative -5 ERROR__$COUNT
export const
ERROR__$COUNT = -5,
ERROR__SUCCESS = NaN,
ERROR__NOT_IMPLEMENTED = -1,
ERROR__FAIL = -2;