Stylus

Stylus features a very simplistic and easy to learn/use syntax which compiles into usable CSS code.

Supports both an indented syntax and a regular CSS style.

It is widely used in today's Web development community, especially in Node.js projects.

Stylus is similar in concept to SCSS, being different only via the actually syntax.

If you are familiar with the "CSS pre-processor" term then you know exactly what it does.

Features:

• CSS syntax support
• Mixins
• Keyword arguments
• Variables
• Interpolation
• Arithmetic, logical, and equality operators
• Importing of other stylus sheets
• Introspection API
• Type coercion
• Conditionals
• Iteration
• Nested selectors
• Parent reference
• In-language functions
• Variable arguments
• Built-in functions
• Optional image inlining
• Optional compression
• JavaScript API
• Extremely terse syntax
• Stylus executable
• Error reporting
• Single-line and multi-line comments
• CSS literal
• Character escaping
• @keyframes support & expansion
• @font-face support
• @media support
• Connect Middleware
• Ruby on Rails support
• TextMate bundle
• gedit language-spec
• VIM syntax
• Firebug extension
• Transparent vendor-specific function expansion

What is new in this release:

• Added !optional directive for extending.
• Added selector-exists bif.
• Added remove bif for removing items from hashes.
• Added optional recursive hash merging.
• Added optional (--hoist-atrules flag) @import and @charset hoisting.
• Added a way to output to specific file path with CLI.
• Fixed regression with using @media inside +cache.
• Fixed resolve-url for hash URLs.
• Fixed mix bif for differently transparent colors.
• Fixed bug with postfix & without comma.
• Fixed incorrectly imported functions defined in other files with nested @require.
• Fixed duplicated selectors when extending into placeholders with MQ.
• Fixed filter: contrast() error.
• Fixed the cloning of cached nodes.
• Fixed incorrect filenames included in source maps.
• Fixed stripping of unsuppressed comments from nested blocks.
• Fixed build error for multiple files.
• Fixed error handling slightly.
• Fixed (throwing error) edge case of watching and printing at the same time.
• Fixed watch to log to std.err.

What is new in version 0.49.2:

• Fixed nested selectors when using nested and bubbled media queries.
• Fixed issue when mixin's block is used as part of a property value.
• Fixed hardcoded .styl extension from CLI (added extname arg).

What is new in version 0.48.0:

• Added basic sourcemaps support.
• Added info on columns for sourcemaps and better error reporting.
• Added globals and functions keys to options object in JS API.
• Added rebeccapurple named color.
• Added unicode-range support.
• Changed the behaviour of adding percents together to the more sane one.
• Fixed bug with property lookup inside mixin block.
• Fixed a bug with nested media queries inside mixins.
• Fixed an @extend inside @media queries with multi-level selectors.
• Fixed bug with cloning of an interpolated selector with comma.
• Fixed bug with nested media queries in conditionals.
• Fixed a bug with cached imports.
• Fixed @css literal that generated u+0085 characters instead of newlines.
• Fixed escaped comma (\,) inside hashes.
• Fixed a string representation of HSLA node to preserve %.
• Fixed incorrect position of inline comments.

What is new in version 0.46.0:

• Added support for nested media queries.
• Added convert built-in function.
• Added negative index values support for subscripts.
• Added short-circuit evaluation for logical operators.
• Fixed the dropped commas in splat arguments.
• Fixed double-writing the @media and other at-rules in mixins.
• Fixed unit expression precedence error.
• Fixed comments inside the property expressions.
• Fixed handling of the @css and unquote inside groups.
• Fixed incorrect line numbers on errors.
• Fixed import cloning with cache.
• Fixed cloning to preserve property.literal.
• Fixed bifs arguments cloning bug.
• Fixed bug with nested interpolated selectors with a comma.
• Fixed current-property ignored in property lookup.
• Fixed current-property's value to be evaluated in the right context.
• Fixed spaces and comments inside a hash declaration.
• Fixed aliases for transparent mixins.

What is new in version 0.45.1:

• Fixed regression with @require and globbed paths inside functions.

What is new in version 0.45.0:

• Added support for block-level @import and @require.
• Added hash values support in @media.
• Added coercion for pt units.
• Added a way to escape \ in a tag name.
• Fixed trailing spaces and comments in the selector groups.
• Fixed comments in the selector parts (now ignoring them).
• Fixed bug with url string having a protocol.
• Fixed bug with @scope and complex selectors.
• Fixed the recursion with the display: block inside block mixins.
• Fixed bug with current-property and block mixins.
• Fixed bug with complex selectors in conditionals.
• Fixed bug with @media bubbling and conditionals.
• Fixed bug with newlines and comments in conditionals.
• Fixed bug with the variable in the first line of mixin.
• Fixed but with the variable right after iterating over an empty list.
• Fixed bug with built-in function calls inside a hash assignment.

What is new in version 0.44.0:

• Major performance tuning and basic caching support, almost ⨉2 build time boost.
• Added basic support for most at-rules.
• Added +cache built-in mixin for caching the result of functions and mixins into placeholders.
• Added current-media() bif that returns the string for the current media query.
• Added called-from property in functions that contains the names of the functions from the call stack till the current one.
• Added a way to escape commas and parent references inside selectors.
• Removed the never needed -ms- prefix for keyframes.

What is new in version 0.43.1:

• Fixed regression with only keyword.

What is new in version 0.42.2:

• Added support for reverse ranges.
• Fixed bug with an expression as arguments of function call.
• Fixed bug with property lookup inside @block.
• Fixed bug with parsing an attribute selector.
• Fixed bug with add-property inside function call.
• Fixed compiling to a directory with .styl in the name.
• Fixed bug with missed mtime in middleware imports.
• Fixed an incorrect line number in multi-line group selectors.

What is new in version 0.42.0:

• Added @require.
• Added more lookup patterns for the @import and @require. Support Node.js modules.
• Added file globbing.
• Added root reference.
• Added basic support for @block entity.
• Added string support for selector() bif.
• Added options as an optional argument for use() bif.
• Added some new colors shortcuts: grayscale, complement, tint & shade.
• Fixed broken @media queries in logic blocks.
• Fixed function call inside block mixin is on the block variable pass.
• Fixed bug with if and color in array check.
• Fixed bug with list of color keywords as default argument.
• Fixed bug with property lookup in @media queries.

What is new in version 0.41.0:

• Added basic block mixins (+foo) with block interpolation (block).
• Added selector() bif.
• Added hash interpolation to blocks.
• Fixed parent reference in root context from returning &.

What is new in version 0.38.0:

• Fixed property lookup from mixins.
• Fixed support for src and dest in middleware, started tests for middleware.
• Fixed --resolve-url that removed tails from URLs.
• Fixed mime type for .woff.
• Fixed .toString for undefined functions.
• Fixed path overlap for non-string dest.
• Fixed path.resolve for non-true resolveURL.
• Fixed sync return in stylus.render().
• Fixed duplicate calls from this.calling.

What is new in version 0.37.0:

• Added optional params to the json bif.
• Added --print option to print CSS to stdout.
• Fixed json bif to return literals for colours.
• Fixed include of the CSS files when --resolve-url is on.
• Fixed error in negating variables.
• Fixed bug in p function.
• Fixed tests under Windows.

What is new in version 0.35.1:

• Fixed the support for progressive JPEGs in image-size.

What is new in version 0.32.0:

• Added sync API.
• Fixed unsuppressed comments in nested imports.

What is new in version 0.28.2:

• Fixed extend in mixin.

What is new in version 0.28.0:

• Added:
• Suffix to basename() BIF
• pathjoin() BIF
• basename() BIF
• dirname() BIF
• extname() BIF

What is new in version 0.27.2:

• Adding list of all CSS 3 units.
• Fixed CSS to stylus conversion !important support.
• Fixed last rule being ignored if empty indents at the end of the file.

What is new in version 0.27.1:

• Fixes:
• Incorrect function call within for with named argument.
• Stylus incorrectly imports the .css files that are not in the same folder as the processed .styl file.

What is new in version 0.27.0:

• Added add-property() mixin support.
• Added % support for fade-in() and fade-out().
• Added % support to rgba().

What is new in version 0.25.0:

• Added make test-cov
• Added temporary multiline support.
• Added: allow for '%' unit type in the 'alpha' of rgba and hsla
• Updated cssom dep
• Removed growl dep.
• Fixed BIF retval coercion

What is new in version 0.22.4:

• Fixed @extends inheritance bug.
• Fixed 'lineno' global leak due to missing new.

What is new in version 0.21.2:

• Fixed literal / within function call.

What is new in version 0.21.0:

• Added unit casting, ex: (n * 5)%.

What is new in version 0.20.1:

• Added global leak detection to the test suite.
• Fixed two globals.
• Fixed operator ident regression.

What is new in version 0.20.0:

• Added --include-css to literally include imported CSS.
• Fixed coercion bug with expression.

What is new in version 0.19.8:

• Fixed middleware mkdir -p support.

What is new in version 0.19.5:

• Revert noop visitor methods, this breaks extensions.

What is new in version 0.19.3:

• Added "include css" setting (need docs) to literally include imported CSS.
• Added EOL escape.
• Fixed tab support in lexical analysis (trailing colors etc).

Requirements:

• JavaScript enabled on client side
• Node.js