v8.1.0

• FEATURE: If True sass option is not specified, True will automatically attempt to use embedded-sass, then sass #290
• INTERNAL: Add sass and sass-embedded as optional peer-dependencies
• INTERNAL: Update dependencies

Full Changelog: v8.0.0...v8.1.0

v8.0.0

• FEATURE: Add True sass option (string or Sass implementation instance, defaults to 'sass') to allow using either sass or embedded-sass.
• FEATURE: Add the Node.js package importer to the Sass importers option by default, if Dart Sass v1.71 or later is available. Users can opt out by providing their own importers option, e.g. { importers: [] }.
• BREAKING: Drop support for node < 18
• INTERNAL: Remove sass as a peer-dependency.
• INTERNAL: Update dependencies

Full Changelog: v7.0.1...v8.0.0

v7.0.1

• FEATURE: Validate runSass arguments and warn if using v6 API -- #268
• DOCUMENTATION: Add note that { style: 'compressed' } is not supported.
• DOCUMENTATION: Add note about possible Jest error and workaround.
• INTERNAL: Update dependencies

New Contributors

• @holblin made their first contribution in #258

Full Changelog: v7.0.0...v7.0.1

v7.0.0

• FEATURE: contains() checks multiple block with matching selectors. #243
• BREAKING: Upgrade to newer Sass API
  • Add True sourceType option (path [default] or string)
  • Reverse order of expected arguments to runSass: 1) True options, 2) source path (or string), 3) optional Sass options
  • Note that some of the Sass options have changed. For example, includePaths is now loadPaths, outputStyle is now style, importer is now importers, etc. See the Dart Sass documentation for more details.
• BREAKING: Require sass (>=1.45.0) as a peer-dependency, removing True sass option
• BREAKING: Drop support for node < 14.15.0
• INTERNAL: Use both Jest and Mocha for internal testing
• INTERNAL: Remove documentation from npm package
• INTERNAL: Update dependencies

Migrating from v6

• runSass arguments have changed:

v6:

const path = require('path');
const sass = require('node-sass');
const sassTrue = require('sass-true');

const sassFile = path.join(__dirname, 'test.scss');
sassTrue.runSass(
  // Sass options [required]
  { file: sassFile, outputStyle: 'compressed', includePaths: ['node_modules'] },
  // True options [required]
  { describe, it, sass },
);

const sassString = `
h1 {
  font-size: 40px;
}`;
sassTrue.runSass(
  // Sass options [required]
  {
    data: sassString,
    outputStyle: 'compressed',
    includePaths: ['node_modules'],
  },
  // True options [required]
  { describe, it, sass },
);

v7:

const path = require('path');
const sassTrue = require('sass-true');

const sassFile = path.join(__dirname, 'test.scss');
sassTrue.runSass(
  // True options [required]
  { describe, it },
  // Sass source (path) [required]
  sassFile,
  // Sass options [optional]
  { style: 'compressed', loadPaths: ['node_modules'] },
);

const sassString = `
h1 {
  font-size: 40px;
}`;
sassTrue.runSass(
  // True options [required]
  { describe, it, sourceType: 'string' },
  // Sass source (string) [required]
  sassString,
  // Sass options [optional]
  { style: 'compressed', loadPaths: ['node_modules'] },
);

New Contributors

• @codr made their first contribution in #243

Full Changelog: v6.1.0...v7.0.0

v7.0.0-beta.0

• BREAKING: Upgrade to newer Sass API
  • Add True sourceType option (path [default] or string)
  • Reverse order of expected arguments to runSass: 1) True options, 2) source path (or string), 3) optional Sass options
• BREAKING: Require sass as a peer-dependency, removing True sass option
• BREAKING: Drop support for node < 14.15.0
• INTERNAL: Use both Jest and Mocha for internal testing
• INTERNAL: Update dependencies

Migrating from v6

• runSass arguments have changed:

v6:

const path = require('path');
const sass = require('node-sass');
const sassTrue = require('sass-true');

const sassFile = path.join(__dirname, 'test.scss');
sassTrue.runSass(
  // Sass options [required]
  { file: sassFile, outputStyle: 'compressed' },
  // True options [required]
  { describe, it, sass },
);

const sassString = `
h1 {
  font-size: 40px;
}`;
sassTrue.runSass(
  // Sass options [required]
  { data: sassString, outputStyle: 'compressed' },
  // True options [required]
  { describe, it, sass },
);

v7:

const path = require('path');
const sassTrue = require('sass-true');

const sassFile = path.join(__dirname, 'test.scss');
sassTrue.runSass(
  // True options [required]
  { describe, it },
  // Sass source (path) [required]
  sassFile,
  // Sass options [optional]
  { style: 'compressed' },
);

const sassString = `
h1 {
  font-size: 40px;
}`;
sassTrue.runSass(
  // True options [required]
  { describe, it, sourceType: 'string' },
  // Sass source (string) [required]
  sassString,
  // Sass options [optional]
  { style: 'compressed' },
);

Full Changelog: v6.1.0...v7.0.0-beta.0

v6.1.0

6.1.0 (03/02/22)

• No changes since v6.1.0-beta.1

Full Changelog: v6.0.1...v6.1.0

v6.1.0-beta.1

6.1.0-beta.1 (02/24/22)

• FEATURE: Clearer formatting of failing test diffs #210
• INTERNAL: Limit files included in npm package #189
• INTERNAL: Convert JS to TypeScript and bundle type definitions #212 -- thanks to @robertmaier for the initial PR #206
• INTERNAL: Remove documentation static-site from True repository
• INTERNAL: Use Jest for internal testing (replaces Mocha)
• INTERNAL: Switch from Travis CI to GitHub Actions for CI
• INTERNAL: Update dependencies

Full Changelog: v6.0.1...v6.1.0-beta.1

Patch Docs & Eyeglass Versions

• Remove eyeglass specific-version requirement
• Update documentation

Move to Sass Modules (🚨Requires Dart Sass🚨)

• 🚨 BREAKING: Switch to Dart Sass with Sass module system, dropping support for Node Sass.
• 🚨 BREAKING: Drop support for node < 10
• 🚨 BREAKING: Rename $true-terminal-output setting to $terminal-output when importing as a module (with @use). Projects not using Sass modules can still @import '<path>/sass-true/sass/true' and access the setting as $true-terminal-output
• 🎉 FEATURE: Added _index.scss at the project root, for simpler import path: @use '<path>/sass-true'
• 🎉 FEATURE: New sass/_throw.scss module provides:
  • error() function & mixin for establishing "catchable" errors
  • global $catch-errors toggles how error() output is handled
• 🎉 FEATURE: Support testing content properties which include a curly brace.
• 🛠 Update dependencies

Support for Dart Sass & Jest

• BREAKING: Update API for runSass, which now accepts two arguments: a
  sassOptions object and a trueOptions object.
• BREAKING: Drop support for node < 8
• Add docs and testing for usage with Jest
  #135
• Add sass option to runSass for passing a different Sass implementation
  than node-sass #137
• Remove node-sass from peerDependencies
• Fix deprecated use of assert.fail
  #138
• Update dev dependencies