v3.0.0 second beta

Installation:

npm install node-sass@beta

Changelog:

• Implements libsass v3.2.0-beta.5 API.
• Importer: Throws error on invalid return type.
  • Issue URL: #670.
  • PR URL: #833.
• API: Provides support for array of importers.
  • Issue URL: #821.
  • PR URL: #832.
• Feature: Provides sourceMapRoot option.
  • Issue URL: #776.
  • PR URL: #813.
• CLI: Adds support for Custom Functions.
  • Issue URL: #784.
  • PR URL: #815.
• CLI: Changes --watch flag Boolean by @wesleytodd.
  • Issue URL: #781.
  • PR URL: #782.
• CLI: Sets --recursive flag default to true by @wesleytodd.
  • Issue URL: #601
  • PR URL: #782.
• Build: Adding libsass.gyp in a separate dir.
  • Originally implemented by @saper, This was previously removed due to the bug in npm.
• README: Formatting fixes by @tomfuertes.

v2.1.1

Installation

npm install node-sass@2.1.1

Changelog:

• Adds pangyp as primary dependency.
• Adds the new io.js binaries for the entire matrix.

Version 3 beta

Installation:

From CLI:

npm install node-sass@beta
# or
npm install node-sass@3.0.0-beta.4

Or in package.json:

{
  "dependencies": {
    "node-sass": "beta"
  }
}

Changelog:

• Configurable linefeed by @matryo
  Issue URL: #332.
  PR URL: #644.
• Provide options to configure linefeed by @am11
  Issue URL: #682,
  PR URL: #792.
  Upstream PR URL: sass/libsass#787.
• Updates LibSass v3.2.0-beta.2 and corresponding Sass-Spec commit.
• Reverts Build with unbundled LibSass. #763 by @saper, as it was causing issue with npm publish.

v3.0.0-alpha.1

Installation:

From CLI:

npm install sass/node-sass#v3.0.0-alpha.1

Or in package.json:

{
  "dependencies": {
    "node-sass": "sass/node-sass#v3.0.0-alpha.1"
  }
}

Note 1: This alpha version is not published to npm, but npm has the ability to figure out if you are requiring the GitHub release. For more information, see https://docs.npmjs.com/cli/install (keyword to search on page "commit-ish").

Note 2: You should have git in your PATH to be able to install GitHub tagged release via npm.

Changelog:

Build with unbundled LibSass. #763 by @saper.
Fixes bug #769, reported by @benpptung.

v3.0.0-alpha.0

npm install node-sass@3.0.0-alpha.0

• Thanks to @lennym and @callumacrae for reporting npm publishing issue at #758.
• CLI Usage: Fixed --watch bug reported by @IGRACH at #755.
• Added .gitattributes, so publish issue from Windows don't happen again. Thanks @mgreter for suggesting the idea. #760

v3.0.0-pre

This is a pre release.

npm install node-sass@3.0.0-alpha.0     # (updated)

Breaking Changes:

• Dropped method-style callback in favour of node-style option: (suggested by @sindresorhus; #676)
  Implemented by: @jakobo

  Old:

    require('node-sass').render({
      /* options */,
     success: function (result) { },
     error: function (err) { }
    });

  New:

    require('node-sass').render({
      /* options */
    }, function (err, result) { });

• API returns Buffer output as opposed to String. (suggested by @joliss #711)

  Old:

    require('node-sass').render({
      /* options */,
      success: function(result) {
        assert(typeof result.css === 'string');
        assert(typeof result.map === 'string');
      }
    });

  New:

    require('node-sass').render({
      /* options */
    }, function (err, result) {
      if (err) {
        return myErrorHandler(err);
      }
  
      assert(result.css instanceof Buffer);
      assert(result.map instanceof Buffer);
    });

• Retired image path options. (driven by the change in libsass #702)

• CLI now throws output to stdout, when no output file/directory is specified. (suggested by @xzyfer #669)

• The input, output and map paths are resolved against current-working-directory before passing to libsass. This fixes the issues with invalid paths in source-maps. (issue reported by @itsnydell: #731)

Enhancements

• Now this.options is available in importer and render callbacks. Implemented by @jakobo via #686 . Also, see the related issue: #674.

• Made API throw Error object instead of Strings: (suggested by @sindresorhus; #675)

  Old:

    require('node-sass').render({
      /* options */,
      error: function(err) {
        assert(typeof err === 'string');
    });

  New:

    require('node-sass').render({
      /* options */
    }, function (err, result) {
      if (err) {
        assert(err instanceof Error);
      }
    });

• Ignore test directory from package. (suggested by @dcbarans: #683)

Infrastructure:

• Better support for io.js rapid release cycle. (suggested by @xzyfer #694).
• Binaries downloadable from custom URL.(suggested by @johnrc #720).
• Binaries are now uploaded as release assets, which used to be hosted via node-sass-binaries repo release.(suggested by @nschonni #712).

Install script fixes

This release fixes some bugs discovered in install script.

So just do:

npm install node-sass@2.0.1

Twice the Sass

Welcome to node-sass v2.

npm install node-sass@2.0.0

Release Notes

• API Features & Enhancements:
  • io.js support: #627 (@mnutt)
  • Sass Graph for intelligent file watching: #157 (@xzyfer)
  • Creates directory if non-existing path is provided from CLI usage: #574 (@SebastianOsuna)
  • node.js v0.12 support (while keeping the v0.10 compatibility): #653, #655, https://github.com/sass/node-sass-binaries/releases/tag/v2.0.0 (@xzyfer, @am11)
• Build and Installation Improvements:
  • Binary download improved: #663 (@rubennorte)
  • Proxy discovery improved: #588, #609 (@xzyfer, @am11)
  • Only runs one test after install to verify binary status.
    
    Also retires SKIP_NODE_SASS_TESTS. #611 (@am11)
  • Brings runtime-awareness to build and download steps: #657, #660 (@am11)
• Bug Fixes and Others:
  • Treat source-map as string for CLI: #573 (@didoarellano)
  • Don't exit if an error occurs while watching: #650 (@dprotaso)
  • Readying for FreeBSD: #588 (@ahacking)
  • Configured inch-ci and added docs badge to README: #647 (@rrrene)
  • Improved coverage: 99% (credit goes to everybody who contributed)

Thanks @stevenvergenz, @Jenius, @temega, @peterjmag, @olsonpm and @andrew for improving the README.

Snow Man (beta)

Welcome to node-sass pre-release: v2.0.0-beta ⛄

npm install node-sass@2.0.0-beta

New Features:

• Custom Importer: is a user-defined function, which libsass calls whenever SASS @import directive (as opposed to CSS3 one) is encountered. It can return result synchronously or asynchronously. Details are present in README. Also, see #44.
• Custom Importer: available via CLI usage as well. See README under CLI Usage section.
• sourceMapEmbed option when set to true, it embeds source-maps in CSS sourceMappingURL comment.
• sourceMapContents option when set to true, it the actual SCSS content in source-map contents[] array.
• Both node-sass and libsass version info is now displayed via code usage: require('node-sass').info() and also displayed via CLI usage with --help option.
• In render, error callback now emits object with column info.

Breaking Changes:

The node-sass API is overhauled, which presents some breaking changes:

• renderFileSync is removed. Use renderSync which accept file, data or both. See examples in README for details.
• success and error callbacks now return object. Again it is exampled in README.
• renderSync also returns an object (or in case of error, a JS object literal is printed on standout).
• stats option is retired. stats object will always be returned as part of result.
• stats in result does not emit source-map, since we are emitting map as part of result anyway..
• node-sass does not write output to disk from code usage. It will deliver the output which user can store in file/data-base or generate in-memory HTTP responses.

Known issues:

• You may find some abnormal behavior, when throttling simultaneous requests when using importers. In which case, please open an issue with detailed, tangible reproduction steps (as I could not isolate the code from our bug suite which is the source of this misbehaviour).
• In case of incompatible binary (issue #517, //cc @nsams, @laurelnaiad et al.), the installation step would not indicate the problem, but the usage will throw. We revoke this condition, as tests are not passing on Linux. On Windows they pass intermittently due to the aforementioned (throttling) issue. Note that issue #517 is still unresolved.

Gratitude:

Thanks for everyone who provided valuable feedback and contributed in development. Special thanks to:

@mgreter, @xzyfer, @andrew for handful of suggestions and feedback.
@txdv, @rvagg, for enlightening us with libuv and nan tricks and tips, during the implementation of custom importers feature.
@jhnns for giving quality feedback on custom importer and refactoring of v2 API.
@cuongvo: for adding SSL workaround in enterprise environments.
@naartjie updating docs with Workaround for node v0.11.13 v0.11.14
@macbre for updating README with indentationStyle option.

v1.1.4

Bugfixes:

• Republished to fix issues on linux installs

Available on NPM: https://npmjs.org/package/node-sass

npm install node-sass@1.1.4