livescript-transform-esm

Transform for livescript adding support for modules.

Repository on github

Usage

CLI

First install livescript and transfrom-esm

npm i -D https://github.com/gkz/LiveScript livescript-transform-esm

to transpile from src to tmp

node_modules/.bin/lsc -r livescript-transform-esm/register -c -o tmp src

to run script use CommonJS module format option e.g. running test/index.ls

node -r livescript-transform-esm/register/cjs -c -o tmp src

Features

This plugin comes equiped with some extra features which won't be seen in js-land any time soon.

Injecting imports to scope

Tired of manual polluting scope with hundreds of identifiers, let compiler do it for you. (for now only relative module are resolved)

import ...
    './symbols'

import 
    './symbols' : ...

both generate

import { init, create } from './symbols';
 

Globs/wildcards

Importing multiple files never was so easy, you can pass any string compatible with globby and compiler will do the rest. Globs are expanded during compilation making them transparent for other tools and browser.

import 'modules/**'

import foo from './modules/foo';
import Math from './modules/Math';
import Vector from './modules/Vector';

glob + exports = index

If you've ever wanted to generated index file base on content of directory it is trivial with this plugin, take export, import, some glob mix the together and here you have:

# inside of modules there are: foo.ls, Match.ls, Vector.ls
export { import './modules/**' }

import import$ from './modules/foo';
import import1$ from './modules/Math';
import import2$ from './modules/Vector';
export { import$ as foo }
export { import1$ as Math }
export { import2$ as Vector }

imports as expressions

Guys in js-land need to put imports into top scope otherwise its gives theme nice shinny error. But we don't like to obey those silly rules and we can but imports wherever it will make sense.

export default config =
    plugins: [
        import \livescript-transform-object-create
        import \livescript-transform-esm
        import \livescript-transform-implicit-async
        import \livescript-transform-object-create/lib/plugin
        import \livescript-transform-esm/lib/plugin
        import \livescript-transform-implicit-async/lib/plugin
    ]

import import$ from 'livescript-transform-object-create';
import import1$ from 'livescript-transform-esm';
import import2$ from 'livescript-transform-implicit-async';
import import3$ from 'livescript-transform-object-create/lib/plugin';
import import4$ from 'livescript-transform-esm/lib/plugin';
import import5$ from 'livescript-transform-implicit-async/lib/plugin';
var config;
export { config as default }
config = {
  plugins: [import$, import1$, import2$, import3$, import4$, import5$]
};

dynamic imports

A riddle: how to make dynamic import?
Answer: async it

foo = async import \./modules/foo
vector-path = \./modules/Vector
Vector = async import vector-path

var foo, vectorPath, Vector;
foo = import('./modules/foo');
vectorPath = './modules/Vector';
Vector = import(vectorPath);

import all

import all
    \react
    \./symbols

import * as symbols from './symbols';
import * as react from 'react';

Integration

Atom

If you are using Atom editor you may be interested in my packages which provide realtime code preview supporting this plugin.

• livescript-ide-preview - show transpiled code
• atom-livescript-provider - provides compilation service

Webpack loader

If you are using Webpack you can try my loader whith support for this and other plugins.

License

BSD-3-Clause