broccoli-sass-source-maps

broccoli-sass

The broccoli-sass plugin compiles .scss and .sass files with Dart Sass or LibSass.

This is a fork of broccoli-sass that includes support for more options and provides (partial) support for source maps by embedding the content of the SASS source files in the source map using sourcesContent.

Be aware that the paths in the generated source map not correct, but this module does what I need until the underlying issue is resolved.

Installation

npm install --save-dev broccoli-sass-source-maps sass

Usage

var compileSass = require('broccoli-sass-source-maps')(require('sass'));

var outputTree = compileSass(inputTrees, inputFile, outputFile, options);

Note that when using Dart Sass, synchronous compilation is twice as fast as asynchronous compilation by default, due to the overhead of asynchronous callbacks. To avoid this overhead, you can use the fibers package to call asynchronous importers from the synchronous code path. To enable this, pass the Fiber class to the fiber option:

var compileSass = require('broccoli-sass-source-maps')(require('sass'));
var Fiber = require('fibers');

var outputTree = compileSass(inputTrees, inputFile, outputFile, {fiber: Fiber});

• inputTrees: An array of trees that act as the include paths for Sass. If you have a single tree, pass [tree].

• inputFile: Relative path of the main .scss or .sass file to compile. Broccoli-sass expects to find this file in the first input tree (inputTrees[0]).

• outputFile: Relative path of the output CSS file.

• options: An optional hash of options for libsass and caching writer.

  • Supported Sass options are: functions, indentedSyntax, omitSourceMapUrl, outputStyle, precision, quietDeps (Dart Sass only), silenceDeprecations (Dart Sass only) sourceComments, sourceMap, sourceMapEmbed, and sourceMapContents.
  • Options for caching writer include: annotation, cacheInclude, and cacheExclude (see details here).

Example

var appCss = compileSass(['styles', 'vendor'], 'myapp/app.scss', 'assets/app.css');

Choosing the version of Sass

You must specify which version of Dart Sass or [Node Sass][] to use by passing it as a parameter to the module. Add either sass (for Dart Sass) or node-sass to your package.json and then provide that version as a parameter to the module:

// Uses Dart Sass.
var compileSass = require('broccoli-sass-source-maps')(require('sass'));

// Uses Node Sass.
var compileSass = require('broccoli-sass-source-maps')(require('node-sass'));

Changelog

v4.3.0 (2024-08-07)

:rocket: Enhancement

• #66 Add Option to Silence Deprecations (@jrjohnson)

Committers: 1

• Jon Johnson (@jrjohnson)