Releases: sass/dart-sass
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 thecanonicalize()
method. -
Add a
containingUrl
field to thecanonicalize()
andfindFileUrl()
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 thecanonicalize()
method. -
Add
AsyncImporter.containingUrl
, which is set during calls to thecanonicalize()
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 toCalculationValue.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()
, andsign()
.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()
andclamp()
are still forbidden, users may continue to freely define functions whose names overlap with other CSS calculations (includingabs()
,min()
,max()
, andround()
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, butcalc(1px + #{"2px"})
is still allowed. This deprecation is namedcalc-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.
Dart Sass 1.66.1
To install Sass 1.66.1, 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 compilation could crash in strict mode if passed a callback that threw a string, boolean, number, symbol, or bignum.
See the full changelog for changes in earlier releases.
Dart Sass 1.66.0
To install Sass 1.66.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.
Changes
-
Breaking change: Drop support for the additional CSS calculations defined in CSS Values and Units 4. Custom Sass functions whose names overlapped with these new CSS functions were being parsed as CSS calculations instead, causing an unintentional breaking change outside our normal [compatibility policy] for CSS compatibility changes.
Support will be added again in a future version, but only after Sass has emitted a deprecation warning for all functions that will break for at least three months prior to the breakage.
See the full changelog for changes in earlier releases.