riot-compiler

Documentation

• API

Installation

Npm

$ npm install riot-compiler --save

Bower

$ bower install riot-compiler --save

For babel users

Due to recent changes in the babel API, from v2.3.0-beta.7 we are supporting babel versions previous to 6.0.2 through parsers.css.es6 (<script type="es6">), new versions are not compatible with the node API.

For babel-core, please use the new parsers.css.babel (<script type="babel">). You must npm install babel-preset-es2015 too, for this works.

Changelog

v2.3.0

This is a complete rewrite and the first solo version of the compiler.

• Now the compiler generates a call to the new riot.tag2 function, with the same parameters as riot.tag and an additional one: the brackets used in the compilation. riot.tag2 requires all parameters except the brackets, so the compiler generates all but ignores the brackets if there are no generated expressions.
• Unlike previous versions, backslashes are removed from the expressions (before being sent to any parser). Outside of expressions, all backslashes are preserved.
• Double quotes inside expressions are converted to ", to avoid issues with HTML markup.
• Fix riot#1207 : Riot compiler/parser breaks indentation.
• Fix riot#1120 : Double quotes break Riot attributes

Enhancements

• The compiler loads the brackets in runtime on each tag, allowing use of different brackets. riot#1122 related.
• Multiple <script> blocks. These can have different types and are merged with the untagged script block, if any.
• More flexible formats in ES6 style method definitions.
• In the JavaScript, trailing whitespace are removed and multiple empty lines are combined into one.
• Better recognition of expressions. Now you can use almost any character, even in unquoted expressions (expressions containing the > operator needs to be enclosed in quotes) - riot#744
• If the first character inside an expression is ^, the expression is not passed to any parser. This is some sort of type=none at expression level - riot#543, riot#1090
• Type es6 now supports babel-core - riot#1039
• New logic for scoped style blocks, if a style contains the ":scoped" selector, this is replaced by the name of the root element, if not, the name is prepended - riot#912
• type="scoped-css" for style tags is deprecated, use only scoped or scoped="scoped"