Dart Sass 1.70.0

To install Sass 1.70.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

JavaScript API

• Add a sass.initCompiler() function that returns a sass.Compiler object which supports compile() and compileString() methods with the same API as the global Sass object. On the Node.js embedded host, each sass.Compiler object uses a single long-lived subprocess, making compiling multiple stylesheets much more efficient.

• Add a sass.initAsyncCompiler() function that returns a sass.AsyncCompiler object which supports compileAsync() and compileStringAsync() methods with the same API as the global Sass object. On the Node.js embedded host, each sass.AsynCompiler object uses a single long-lived subprocess, making compiling multiple stylesheets much more efficient.

Embedded Sass

• Support the CompileRequest.silent field. This allows compilations with no logging to avoid unnecessary request/response cycles.

• The Dart Sass embedded compiler now reports its name as "dart-sass" rather than "Dart Sass", to match the JS API's info field.

See the full changelog for changes in earlier releases.

Dart Sass 1.69.7

To install Sass 1.69.7, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

Embedded Sass

• In the JS Embedded Host, properly install the x64 Dart Sass executable on ARM64 Windows.

See the full changelog for changes in earlier releases.

Dart Sass 1.69.5

To install Sass 1.69.5, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

JS API

• Compatibility with Node.js 21.0.0.

See the full changelog for changes in earlier releases.

Dart Sass 1.69.4

To install Sass 1.69.4, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

Dart Sass 1.69.3

To install Sass 1.69.3, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

Embedded Sass

• Fix TypeScript type locations in package.json.

See the full changelog for changes in earlier releases.

Dart Sass 1.69.2

To install Sass 1.69.2, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

JS API

• Fix a bug where Sass crashed when running in the browser if there was a global variable named process.

See the full changelog for changes in earlier releases.

Dart Sass 1.69.1

To install Sass 1.69.1, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

Dart Sass 1.69.0

To install Sass 1.69.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Add a meta.get-mixin() function that returns a mixin as a first-class Sass value.

• Add a meta.apply() mixin that includes a mixin value.

• Add a meta.module-mixins() function which returns a map from mixin names in a module to the first-class mixins that belong to those names.

• Add a meta.accepts-content() function which returns whether or not a mixin value can take a content block.

• Add support for the relative color syntax from CSS Color 5. This syntax cannot be used to create Sass color values. It is always emitted as-is in the CSS output.

Dart API

• Deprecate Deprecation.calcInterp since it was never actually emitted as a deprecation.

Embedded Sass

• Fix a rare race condition where the embedded compiler could freeze when a protocol error was immediately followed by another request.

See the full changelog for changes in earlier releases.

Dart Sass 1.68.0

To install Sass 1.68.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix the source spans associated with the abs-percent deprecation.

JS API

• Non-filesystem importers can now set the nonCanonicalScheme field, which declares that one or more URL schemes (without :) will never be used for URLs returned by the canonicalize() method.

• Add a containingUrl field to the canonicalize() and findFileUrl() methods of importers, which is set to the canonical URL of the stylesheet that contains the current load. For filesystem importers, this is always set; for other importers, it's set only if the current load has no URL scheme, or if its URL scheme is declared as non-canonical by the importer.

Dart API

• Add AsyncImporter.isNonCanonicalScheme, which importers (async or sync) can use to indicate that a certain URL scheme will never be used for URLs returned by the canonicalize() method.

• Add AsyncImporter.containingUrl, which is set during calls to the canonicalize() method to the canonical URL of the stylesheet that contains the current load. This is set only if the current load has no URL scheme, or if its URL scheme is declared as non-canonical by the importer.

Embedded Sass

• The CalculationValue.interpolation field is deprecated and will be removed in a future version. It will no longer be set by the compiler, and if the host sets it it will be treated as equivalent to CalculationValue.string except that "(" and ")" will be added to the beginning and end of the string values.

• Properly include TypeScript types in the sass-embedded package.

See the full changelog for changes in earlier releases.

Dart Sass 1.67.0

To install Sass 1.67.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• All functions defined in CSS Values and Units 4 are now once again parsed as calculation objects: round(), mod(), rem(), sin(), cos(), tan(), asin(), acos(), atan(), atan2(), pow(), sqrt(), hypot(), log(), exp(), abs(), and sign().

  Unlike in 1.65.0, function calls are not locked into being parsed as calculations or plain Sass functions at parse-time. This means that user-defined functions will take precedence over CSS calculations of the same name. Although the function names calc() and clamp() are still forbidden, users may continue to freely define functions whose names overlap with other CSS calculations (including abs(), min(), max(), and round() whose names overlap with global Sass functions).

• As a consequence of the change in calculation parsing described above, calculation functions containing interpolation are now parsed more strictly than before. However, all interpolations that would have produced valid CSS will continue to work, so this is not considered a breaking change.

• Interpolations in calculation functions that aren't used in a position that could also have a normal calculation value are now deprecated. For example, calc(1px #{"+ 2px"}) is deprecated, but calc(1px + #{"2px"}) is still allowed. This deprecation is named calc-interp. See the Sass website for more information.

• Potentially breaking bug fix: The importer used to load a given file is no longer used to load absolute URLs that appear in that file. This was unintented behavior that contradicted the Sass specification. Absolute URLs will now correctly be loaded only from the global importer list. This applies to the modern JS API, the Dart API, and the embedded protocol.

Embedded Sass

• Substantially improve the embedded compiler's performance when compiling many files or files that require many importer or function call round-trips with the embedded host.

See the full changelog for changes in earlier releases.