Ninja Programmers Mindmeld

    lisan
    TypeScript icon, indicating that this package has built-in type declarations

    0.1.1 • Public • Published

    Lisan.js
    i18n, Reimagined!

    A blazing fast and super small i18n library for Javascript


    Website

    Installation · API · Guides & Tips · Examples


    Lisan

    Lisan (Turkish: lee · sun) is an i18n (internationalization) library.

    It provides all essential tooling to have multiple languages in your applications and format numbers, currencies, ordinals & dates based on locale.

    Lisan's biggest difference compared to traditional i18n libraries is taking advantage of ES6 Template Literals and using them to generate functions to interpolate strings.


    What is Lisan trying to solve?

    Most of the i18n libraries are based on some sort of template engine to interpolate strings and these template engines use regex or loops under the hood to find & replace the placeholders.

    However, using regex lookups or javascript loops decreases the performance significantly (especially on client-side) since find & replace is being done on runtime.


    How lisan solves it?

    Lisan adds an extra step to CI, but a giant performance gain to app kind!

    Lisan introduces a Dictionary concept where a dictionary entry can be either just a string or a javascript function that interpolates placeholders and returns a string. Since there is no need finding & replacing placeholder templates, we can avoid using regex or loops.

    It is that simple.

    Of course, maintaining javascript files to store translations could be challenging and not ideal. Especially when using third-party software like transifex or crowdin.

    That's why Lisan also provides a compiler and a command line tool to generate Dictionary objects from Translation JSON files. Dictionary objects are saved in javascript files.

    Enriched with plugins

    Also, you can use existing plugins or write your plugins to extend the capabilities of Lisan.

    Installation

    You can install lisan from the sources below, as you see fit.

    from npm

    npm install lisan

    from CDN

    <script src="https://unpkg.com/lisan/dist/index.umd.js" type="text/javascript"></script>

    After adding the script tag above, all public variables will be accessible via window.lisanJS variables.

    Usage:

    <script
      src="https://unpkg.com/lisan/dist/index.umd.js"
      type="text/javascript"
    ></script> 
    <script type="text/javascript">
      (() => {
        const { lisan, t, c, Lisan } = window.lisanJS;
      })();
    </script> 

    Compatibility

    Platform IE Edge Firefox Chrome Nodejs
    Version 8+ All All All 8+

    License

    This package is MIT licensed.

    Install

    npm i lisan

    DownloadsWeekly Downloads

    8

    Version

    0.1.1

    License

    MIT

    Unpacked Size

    35 kB

    Total Files

    12

    Last publish

    Collaborators

    • yatki