mirror of
https://github.com/danog/dart-sass.git
synced 2024-11-27 04:34:59 +01:00
11d09cffd7
Co-authored-by: Natalie Weizenbaum <nweiz@google.com>
1831 lines
55 KiB
Markdown
1831 lines
55 KiB
Markdown
## 1.32.9
|
|
|
|
* Fix a typo in a deprecation warning.
|
|
|
|
### Dart API
|
|
|
|
* Allow the null safety release of args and watcher.
|
|
|
|
### Command Line Interface
|
|
|
|
* Add a `-w` shorthand for the `--watch` flag.
|
|
|
|
## 1.32.8
|
|
|
|
* Update chokidar version for Node API tests.
|
|
|
|
### JavaScript API
|
|
|
|
* Allow a custom function to access the `render()` options object within its
|
|
local context, as `this.options`.
|
|
|
|
## 1.32.7
|
|
|
|
* Allow the null safety release of stream_transform.
|
|
|
|
* Allow `@forward...with` to take arguments that have a `!default` flag without
|
|
a trailing comma.
|
|
|
|
* Improve the performance of unitless and single-unit numbers.
|
|
|
|
## 1.32.6
|
|
|
|
### Node JS API
|
|
|
|
* Fix Electron support when `nodeIntegration` is disabled.
|
|
|
|
### Dart API
|
|
|
|
* All range checks for `SassColor` constructors now throw `RangeError`s with
|
|
`start` and `end` set.
|
|
|
|
## 1.32.5
|
|
|
|
* **Potentially breaking bug fix:** When using `@for` with numbers that have
|
|
units, the iteration variable now matches the unit of the initial number. This
|
|
matches the behavior of Ruby Sass and LibSass.
|
|
|
|
### Node JS API
|
|
|
|
* Fix a few infrequent errors when calling `render()` with `fiber` multiple
|
|
times simultaneously.
|
|
|
|
* Avoid possible mangled error messages when custom functions or importers throw
|
|
unexpected exceptions.
|
|
|
|
* Fix Electron support when `nodeIntegration` is disabled.
|
|
|
|
## 1.32.4
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.32.3
|
|
|
|
* Optimize `==` for numbers that have different units.
|
|
|
|
## 1.32.2
|
|
|
|
* Print the actual number that was received in unit deprecation warnings for
|
|
color functions.
|
|
|
|
## 1.32.1
|
|
|
|
* Don't emit permissions errors on Windows and OS X when trying to determine the
|
|
real case of path names.
|
|
|
|
## 1.32.0
|
|
|
|
* Deprecate passing non-`%` numbers as lightness and saturation to `hsl()`,
|
|
`hsla()`, `color.adjust()`, and `color.change()`. This matches the CSS
|
|
specification, which also requires `%` for all lightness and saturation
|
|
parameters. See [the Sass website][color-units] for more details.
|
|
|
|
* Deprecate passing numbers with units other than `deg` as the hue to `hsl()`,
|
|
`hsla()`, `adjust-hue()`, `color.adjust()`, and `color.change()`. Unitless
|
|
numbers *are* still allowed here, since they're allowed by CSS. See [the Sass
|
|
website][color-units] for more details.
|
|
|
|
* Improve error messages about incompatible units.
|
|
|
|
* Properly mark some warnings emitted by `sass:color` functions as deprecation
|
|
warnings.
|
|
|
|
### Dart API
|
|
|
|
* Rename `SassNumber.valueInUnits()` to `SassNumber.coerceValue()`. The old name
|
|
remains, but is now deprecated.
|
|
|
|
* Rename `SassNumber.coerceValueToUnit()`, a shorthand for
|
|
`SassNumber.coerceValue()` that takes a single numerator unit.
|
|
|
|
* Add `SassNumber.coerceToMatch()` and `SassNumber.coerceValueToMatch()`, which
|
|
work like `SassNumber.coerce()` and `SassNumber.coerceValue()` but take a
|
|
`SassNumber` whose units should be matched rather than taking the units
|
|
explicitly. These generate better error messages than `SassNumber.coerce()`
|
|
and `SassNumber.coerceValue()`.
|
|
|
|
* Add `SassNumber.convertToMatch()` and `SassNumber.convertValueToMatch()`,
|
|
which work like `SassNumber.coerceToMatch()` and
|
|
`SassNumber.coerceValueToMatch()` except they throw exceptions when converting
|
|
unitless values to or from units.
|
|
|
|
* Add `SassNumber.compatibleWithUnit()`, which returns whether the number can be
|
|
coerced to a single numerator unit.
|
|
|
|
## 1.31.0
|
|
|
|
* Add support for parsing `clamp()` as a special math function, the same way
|
|
`calc()` is parsed.
|
|
|
|
* Properly load files in case-sensitive Windows directories with upper-case
|
|
names.
|
|
|
|
## 1.30.0
|
|
|
|
* Fix a bug where `@at-root (without: all)` wouldn't properly remove a
|
|
`@keyframes` context when parsing selectors.
|
|
|
|
### Node JS API
|
|
|
|
* The generated `main()` function in `sass.js` now returns a `Promise` that
|
|
completes when the executable is finished running.
|
|
|
|
### Dart API
|
|
|
|
* Fix a bug that prevented importers from returning null when loading from a
|
|
URL that they had already canonicalized.
|
|
|
|
## 1.29.0
|
|
|
|
* Support a broader syntax for `@supports` conditions, based on the latest
|
|
[Editor's Draft of CSS Conditional Rules 3]. Almost all syntax will be allowed
|
|
(with interpolation) in the conditions' parentheses, as well as function
|
|
syntax such as `@supports selector(...)`.
|
|
|
|
[Editor's Draft of CSS Conditional Rules 3]: https://drafts.csswg.org/css-conditional-3/#at-supports
|
|
|
|
## 1.28.0
|
|
|
|
* Add a [`color.hwb()`] function to `sass:color` that can express colors in [HWB] format.
|
|
|
|
[`color.hwb()`]: https://sass-lang.com/documentation/modules/color#hwb
|
|
[HWB]: https://en.wikipedia.org/wiki/HWB_color_model
|
|
|
|
* Add [`color.whiteness()`] and [`color.blackness()`] functions to `sass:color`
|
|
to get a color's [HWB] whiteness and blackness components.
|
|
|
|
[`color.whiteness()`]: https://sass-lang.com/documentation/modules/color#whiteness
|
|
[`color.blackness()`]: https://sass-lang.com/documentation/modules/color#blackness
|
|
|
|
* Add `$whiteness` and `$blackness` parameters to [`color.adjust()`],
|
|
[`color.change()`], and [`color.scale()`] to modify a color's [HWB] whiteness
|
|
and blackness components.
|
|
|
|
[`color.adjust()`]: https://sass-lang.com/documentation/modules/color#adjust
|
|
[`color.change()`]: https://sass-lang.com/documentation/modules/color#change
|
|
[`color.scale()`]: https://sass-lang.com/documentation/modules/color#scale
|
|
|
|
### Dart API
|
|
|
|
* Add [HWB] support to the `SassColor` class, including a `SassColor.hwb()`
|
|
constructor, `whiteness` and `blackness` getters, and a `changeHwb()` method.
|
|
|
|
[HWB]: https://en.wikipedia.org/wiki/HWB_color_model
|
|
|
|
## 1.27.2
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.27.1
|
|
|
|
* **Potentially breaking bug fix:** `meta.load-css()` now correctly uses the
|
|
name `$url` for its first argument, rather than `$module`.
|
|
|
|
* Don't crash when using `Infinity` or `NaN` as a key in a map.
|
|
|
|
* Emit a proper parse error for a `=` with no right-hand side in a function.
|
|
|
|
* Avoid going exponential on certain recursive `@extend` edge cases.
|
|
|
|
## 1.27.0
|
|
|
|
* Adds an overload to `map.merge()` that supports merging a nested map.
|
|
|
|
`map.merge($map1, $keys..., $map2)`: The `$keys` form a path to the nested map
|
|
in `$map1`, into which `$map2` gets merged.
|
|
|
|
See [the Sass documentation][map-merge] for more details.
|
|
|
|
[map-merge]: https://sass-lang.com/documentation/modules/map#merge
|
|
|
|
* Adds an overloaded `map.set()` function.
|
|
|
|
`map.set($map, $key, $value)`: Adds to or updates `$map` with the specified
|
|
`$key` and `$value`.
|
|
|
|
`map.set($map, $keys..., $value)`: Adds to or updates a map that is nested
|
|
within `$map`. The `$keys` form a path to the nested map in `$map`, into
|
|
which `$value` is inserted.
|
|
|
|
See [the Sass documentation][map-set] for more details.
|
|
|
|
[map-set]: https://sass-lang.com/documentation/modules/map#set
|
|
|
|
* Add support for nested maps to `map.get()`.
|
|
For example, `map.get((a: (b: (c: d))), a, b, c)` would return `d`.
|
|
See [the documentation][map-get] for more details.
|
|
|
|
[map-get]: https://sass-lang.com/documentation/modules/map#get
|
|
|
|
* Add support for nested maps in `map.has-key`.
|
|
For example, `map.has-key((a: (b: (c: d))), a, b, c)` would return true.
|
|
See [the documentation][map-has-key] for more details.
|
|
|
|
[map-has-key]: https://sass-lang.com/documentation/modules/map#has-key
|
|
|
|
* Add a `map.deep-merge()` function. This works like `map.merge()`, except that
|
|
nested map values are *also* recursively merged. For example:
|
|
|
|
```
|
|
map.deep-merge(
|
|
(color: (primary: red, secondary: blue),
|
|
(color: (secondary: teal)
|
|
) // => (color: (primary: red, secondary: teal))
|
|
```
|
|
|
|
See [the Sass documentation][map-deep-merge] for more details.
|
|
|
|
[map-deep-merge]: https://sass-lang.com/documentation/modules/map#deep-merge
|
|
|
|
* Add a `map.deep-remove()` function. This allows you to remove keys from
|
|
nested maps by passing multiple keys. For example:
|
|
|
|
```
|
|
map.deep-remove(
|
|
(color: (primary: red, secondary: blue)),
|
|
color, primary
|
|
) // => (color: (secondary: blue))
|
|
```
|
|
|
|
See [the Sass documentation][map-deep-remove] for more details.
|
|
|
|
[map-deep-remove]: https://sass-lang.com/documentation/modules/map#deep-remove
|
|
|
|
* Fix a bug where custom property values in plain CSS were being parsed as
|
|
normal property values.
|
|
|
|
### Dart API
|
|
|
|
* Add a `Value.tryMap()` function which returns the `Value` as a `SassMap` if
|
|
it's a valid map, or `null` otherwise. This allows function authors to safely
|
|
retrieve maps even if they're internally stored as empty lists, without having
|
|
to catch exceptions from `Value.assertMap()`.
|
|
|
|
## 1.26.12
|
|
|
|
* Fix a bug where nesting properties beneath a Sass-syntax custom property
|
|
(written as `#{--foo}: ...`) would crash.
|
|
|
|
## 1.26.11
|
|
|
|
* **Potentially breaking bug fix:** `selector.nest()` now throws an error
|
|
if the first arguments contains the parent selector `&`.
|
|
|
|
* Fixes a parsing bug with inline comments in selectors.
|
|
|
|
* Improve some error messages for edge-case parse failures.
|
|
|
|
* Throw a proper error when the same built-in module is `@use`d twice.
|
|
|
|
* Don't crash when writing `Infinity` in JS mode.
|
|
|
|
* Produce a better error message for positional arguments following named
|
|
arguments.
|
|
|
|
## 1.26.10
|
|
|
|
* Fixes a bug where two adjacent combinators could cause an error.
|
|
|
|
## 1.26.9
|
|
|
|
* Use an updated version of `node_preamble` when compiling to JS.
|
|
|
|
## 1.26.8
|
|
|
|
* Fixes an error when emitting source maps to stdout.
|
|
|
|
## 1.26.7
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.26.6
|
|
|
|
* Fix a bug where escape sequences were improperly recognized in `@else` rules.
|
|
|
|
### JavaScript API
|
|
|
|
* Add `sass.NULL`, `sass.TRUE`, and `sass.FALSE` constants to match Node Sass's
|
|
API.
|
|
|
|
* If a custom Node importer returns both `file` and `contents`, don't attempt to
|
|
read the `file`. Instead, use the `contents` provided by the importer, with
|
|
`file` as the canonical url.
|
|
|
|
## 1.26.5
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.26.4
|
|
|
|
* Be more memory-efficient when handling `@forward`s through `@import`s.
|
|
|
|
## 1.26.3
|
|
|
|
* Fix a bug where `--watch` mode could go into an infinite loop compiling CSS
|
|
files to themselves.
|
|
|
|
## 1.26.2
|
|
|
|
* More aggressively eliminate redundant selectors in the `selector.extend()` and
|
|
`selector.replace()` functions.
|
|
|
|
## 1.26.1
|
|
|
|
### Command Line Interface
|
|
|
|
* Fix a longstanding bug where `--watch` mode could enter into a state where
|
|
recompilation would not occur after a syntax error was introduced into a
|
|
dependency and then fixed.
|
|
|
|
## 1.26.0
|
|
|
|
* **Potentially breaking bug fix:** `@use` rules whose URLs' basenames begin
|
|
with `_` now correctly exclude that `_` from the rules' namespaces.
|
|
|
|
* Fix a bug where imported forwarded members weren't visible in mixins and
|
|
functions that were defined before the `@import`.
|
|
|
|
* Don't throw errors if the exact same member is loaded or forwarded from
|
|
multiple modules at the same time.
|
|
|
|
## 1.25.2
|
|
|
|
* Fix a bug where, under extremely rare circumstances, a valid variable could
|
|
become unassigned.
|
|
|
|
## 1.25.0
|
|
|
|
* Add functions to the built-in "sass:math" module.
|
|
|
|
* `clamp($min, $number, $max)`. Clamps `$number` in between `$min` and `$max`.
|
|
|
|
* `hypot($numbers...)`. Given *n* numbers, outputs the length of the
|
|
*n*-dimensional vector that has components equal to each of the inputs.
|
|
|
|
* Exponential. All inputs must be unitless.
|
|
* `log($number)` or `log($number, $base)`. If no base is provided, performs
|
|
a natural log.
|
|
* `pow($base, $exponent)`
|
|
* `sqrt($number)`
|
|
|
|
* Trigonometric. The input must be an angle. If no unit is given, the input is
|
|
assumed to be in `rad`.
|
|
* `cos($number)`
|
|
* `sin($number)`
|
|
* `tan($number)`
|
|
|
|
* Inverse trigonometric. The output is in `deg`.
|
|
* `acos($number)`. Input must be unitless.
|
|
* `asin($number)`. Input must be unitless.
|
|
* `atan($number)`. Input must be unitless.
|
|
* `atan2($y, $x)`. `$y` and `$x` must have compatible units or be unitless.
|
|
|
|
* Add the variables `$pi` and `$e` to the built-in "sass:math" module.
|
|
|
|
### JavaScript API
|
|
|
|
* `constructor.value` fields on value objects now match their Node Sass
|
|
equivalents.
|
|
|
|
## 1.24.5
|
|
|
|
* Highlight contextually-relevant sections of the stylesheet in error messages,
|
|
rather than only highlighting the section where the error was detected.
|
|
|
|
## 1.24.4
|
|
|
|
### JavaScript API
|
|
|
|
* Fix a bug where source map generation would crash with an absolute source map
|
|
path and a custom importer that returns string file contents.
|
|
|
|
## 1.24.3
|
|
|
|
### Command Line Interface
|
|
|
|
* Fix a bug where `sass --version` would crash for certain executable
|
|
distributions.
|
|
|
|
## 1.24.2
|
|
|
|
### JavaScript API
|
|
|
|
* Fix a bug introduced in the previous release that prevented custom importers
|
|
in Node.js from loading import-only files.
|
|
|
|
## 1.24.1
|
|
|
|
* Fix a bug where the wrong file could be loaded when the same URL is used by
|
|
both a `@use` rule and an `@import` rule.
|
|
|
|
## 1.24.0
|
|
|
|
* Add an optional `with` clause to the `@forward` rule. This works like the
|
|
`@use` rule's `with` clause, except that `@forward ... with` can declare
|
|
variables as `!default` to allow downstream modules to reconfigure their
|
|
values.
|
|
|
|
* Support configuring modules through `@import` rules.
|
|
|
|
## 1.23.8
|
|
|
|
* **Potentially breaking bug fix:** Members loaded through a nested `@import`
|
|
are no longer ever accessible outside that nested context.
|
|
|
|
* Don't throw an error when importing two modules that both forward members with
|
|
the same name. The latter name now takes precedence over the former, as per
|
|
the specification.
|
|
|
|
### Dart API
|
|
|
|
* `SassFormatException` now implements `SourceSpanFormatException` (and thus
|
|
`FormatException`).
|
|
|
|
## 1.23.7
|
|
|
|
* No user-visible changes
|
|
|
|
## 1.23.6
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.23.5
|
|
|
|
* Support inline comments in the indented syntax.
|
|
|
|
* When an overloaded function receives the wrong number of arguments, guess
|
|
which overload the user actually meant to invoke, and display the invalid
|
|
argument error for that overload.
|
|
|
|
* When `@error` is used in a function or mixin, print the call site rather than
|
|
the location of the `@error` itself to better match the behavior of calling a
|
|
built-in function that throws an error.
|
|
|
|
## 1.23.4
|
|
|
|
### Command-Line Interface
|
|
|
|
* Fix a bug where `--watch` wouldn't watch files referred to by `@forward`
|
|
rules.
|
|
|
|
## 1.23.3
|
|
|
|
* Fix a bug where selectors were being trimmed over-eagerly when `@extend`
|
|
crossed module boundaries.
|
|
|
|
## 1.23.2
|
|
|
|
### Command-Line Interface
|
|
|
|
* Fix a bug when compiling all Sass files in a directory where a CSS file could
|
|
be compiled to its own location, creating an infinite loop in `--watch` mode.
|
|
|
|
* Properly compile CSS entrypoints in directories outside of `--watch` mode.
|
|
|
|
## 1.23.1
|
|
|
|
* Fix a bug preventing built-in modules from being loaded within a configured
|
|
module.
|
|
|
|
* Fix a bug preventing an unconfigured module from being loaded from within two
|
|
different configured modules.
|
|
|
|
* Fix a bug when `meta.load-css()` was used to load some files that included
|
|
media queries.
|
|
|
|
* Allow `saturate()` in plain CSS files, since it can be used as a plain CSS
|
|
filter function.
|
|
|
|
* Improve the error messages for trying to access functions like `lighten()`
|
|
from the `sass:color` module.
|
|
|
|
## 1.23.0
|
|
|
|
* **Launch the new Sass module system!** This adds:
|
|
|
|
* The [`@use` rule][], which loads Sass files as *modules* and makes their
|
|
members available only in the current file, with automatic namespacing.
|
|
|
|
[`@use` rule]: https://sass-lang.com/documentation/at-rules/use
|
|
|
|
* The [`@forward` rule][], which makes members of another Sass file available
|
|
to stylesheets that `@use` the current file.
|
|
|
|
[`@forward` rule]: https://sass-lang.com/documentation/at-rules/forward
|
|
|
|
* Built-in modules named `sass:color`, `sass:list`, `sass:map`, `sass:math`,
|
|
`sass:meta`, `sass:selector`, and `sass:string` that provide access to all
|
|
the built-in Sass functions you know and love, with automatic module
|
|
namespaces.
|
|
|
|
* The [`meta.load-css()` mixin][], which includes the CSS contents of a module
|
|
loaded from a (potentially dynamic) URL.
|
|
|
|
[`meta.load-css()` mixin]: https://sass-lang.com/documentation/modules/meta#load-css
|
|
|
|
* The [`meta.module-variables()` function][], which provides access to the
|
|
variables defined in a given module.
|
|
|
|
[`meta.module-variables()` function]: https://sass-lang.com/documentation/modules/meta#module-variables
|
|
|
|
* The [`meta.module-functions()` function][], which provides access to the
|
|
functions defined in a given module.
|
|
|
|
[`meta.module-functions()` function]: https://sass-lang.com/documentation/modules/meta#module-functions
|
|
|
|
Check out [the Sass blog][migrator blog] for more information on the new
|
|
module system. You can also use the new [Sass migrator][] to automatically
|
|
migrate your stylesheets to the new module system!
|
|
|
|
[migrator blog]: https://sass-lang.com/blog/the-module-system-is-launched
|
|
[Sass migrator]: https://sass-lang.com/documentation/cli/migrator
|
|
|
|
## 1.22.12
|
|
|
|
* **Potentially breaking bug fix:** character sequences consisting of two or
|
|
more hyphens followed by a number (such as `--123`), or two or more hyphens on
|
|
their own (such as `--`), are now parsed as identifiers [in accordance with
|
|
the CSS spec][ident-token-diagram].
|
|
|
|
[ident-token-diagram]: https://drafts.csswg.org/css-syntax-3/#ident-token-diagram
|
|
|
|
The sequence `--` was previously parsed as multiple applications of the `-`
|
|
operator. Since this is unlikely to be used intentionally in practice, we
|
|
consider this bug fix safe.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Fix a bug where changes in `.css` files would be ignored in `--watch` mode.
|
|
|
|
### JavaScript API
|
|
|
|
* Allow underscore-separated custom functions to be defined.
|
|
|
|
* Improve the performance of Node.js compilation involving many `@import`s.
|
|
|
|
## 1.22.11
|
|
|
|
* Don't try to load unquoted plain-CSS indented-syntax imports.
|
|
|
|
* Fix a couple edge cases in `@extend` logic and related selector functions:
|
|
|
|
* Recognize `:matches()` and similar pseudo-selectors as superselectors of
|
|
matching complex selectors.
|
|
|
|
* Recognize `::slotted()` as a superselector of other `::slotted()` selectors.
|
|
|
|
* Recognize `:current()` with a vendor prefix as a superselector.
|
|
|
|
## 1.22.10
|
|
|
|
* Fix a bug in which `get-function()` would fail to find a dash-separated
|
|
function when passed a function name with underscores.
|
|
|
|
## 1.22.9
|
|
|
|
* Include argument names when reporting range errors and selector parse errors.
|
|
|
|
* Avoid double `Error:` headers when reporting selector parse errors.
|
|
|
|
* Clarify the error message when the wrong number of positional arguments are
|
|
passed along with a named argument.
|
|
|
|
### JavaScript API
|
|
|
|
* Re-add support for Node Carbon (8.x).
|
|
|
|
## 1.22.8
|
|
|
|
### JavaScript API
|
|
|
|
* Don't crash when running in a directory whose name contains URL-sensitive
|
|
characters.
|
|
|
|
* Drop support for Node Carbon (8.x), which doesn't support `url.pathToFileURL`.
|
|
|
|
## 1.22.7
|
|
|
|
* Restrict the supported versions of the Dart SDK to `^2.4.0`.
|
|
|
|
## 1.22.6
|
|
|
|
* **Potentially breaking bug fix:** The `keywords()` function now converts
|
|
underscore-separated argument names to hyphen-separated names. This matches
|
|
LibSass's behavior, but not Ruby Sass's.
|
|
|
|
* Further improve performance for logic-heavy stylesheets.
|
|
|
|
* Improve a few error messages.
|
|
|
|
## 1.22.5
|
|
|
|
### JavaScript API
|
|
|
|
* Improve performance for logic-heavy stylesheets.
|
|
|
|
## 1.22.4
|
|
|
|
* Fix a bug where at-rules imported from within a style rule would appear within
|
|
that style rule rather than at the root of the document.
|
|
|
|
## 1.22.3
|
|
|
|
* **Potentially breaking bug fix:** The argument name for the `saturate()`
|
|
function is now `$amount`, to match the name in LibSass and originally in Ruby
|
|
Sass.
|
|
|
|
* **Potentially breaking bug fix:** The `invert()` function now properly returns
|
|
`#808080` when passed `$weight: 50%`. This matches the behavior in LibSass and
|
|
originally in Ruby Sass, as well as being consistent with other nearby values
|
|
of `$weight`.
|
|
|
|
* **Potentially breaking bug fix:** The `invert()` function now throws an error
|
|
if it's used [as a plain CSS function][plain-CSS invert] *and* the Sass-only
|
|
`$weight` parameter is passed. This never did anything useful, so it's
|
|
considered a bug fix rather than a full breaking change.
|
|
|
|
[plain-CSS invert]: https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/invert
|
|
|
|
* **Potentially breaking bug fix**: The `str-insert()` function now properly
|
|
inserts at the end of the string if the `$index` is `-1`. This matches the
|
|
behavior in LibSass and originally in Ruby Sass.
|
|
|
|
* **Potentially breaking bug fix**: An empty map returned by `map-remove()` is
|
|
now treated as identical to the literal value `()`, rather than being treated
|
|
as though it had a comma separator. This matches the original behavior in Ruby
|
|
Sass.
|
|
|
|
* The `adjust-color()` function no longer throws an error when a large `$alpha`
|
|
value is combined with HSL adjustments.
|
|
|
|
* The `alpha()` function now produces clearer error messages when the wrong
|
|
number of arguments are passed.
|
|
|
|
* Fix a bug where the `str-slice()` function could produce invalid output when
|
|
passed a string that contains characters that aren't represented as a single
|
|
byte in UTF-16.
|
|
|
|
* Improve the error message for an unknown separator name passed to the `join()`
|
|
or `append()` functions.
|
|
|
|
* The `zip()` function no longer deadlocks if passed no arguments.
|
|
|
|
* The `map-remove()` function can now take a `$key` named argument. This matches
|
|
the signature in LibSass and originally in Ruby Sass.
|
|
|
|
## 1.22.2
|
|
|
|
### JavaScript API
|
|
|
|
* Avoid re-assigning the `require()` function to make the code statically
|
|
analyzable by Webpack.
|
|
|
|
## 1.22.1
|
|
|
|
### JavaScript API
|
|
|
|
* Expand the dependency on `chokidar` to allow 3.x.
|
|
|
|
## 1.22.0
|
|
|
|
* Produce better stack traces when importing a file that contains a syntax
|
|
error.
|
|
|
|
* Make deprecation warnings for `!global` variable declarations that create new
|
|
variables clearer, especially in the case where the `!global` flag is
|
|
unnecessary because the variables are at the top level of the stylesheet.
|
|
|
|
### Dart API
|
|
|
|
* Add a `Value.realNull` getter, which returns Dart's `null` if the value is
|
|
Sass's null.
|
|
|
|
## 1.21.0
|
|
|
|
### Dart API
|
|
|
|
* Add a `sass` executable when installing the package through `pub`.
|
|
|
|
* Add a top-level `warn()` function for custom functions and importers to print
|
|
warning messages.
|
|
|
|
## 1.20.3
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.20.2
|
|
|
|
* Fix a bug where numbers could be written using exponential notation in
|
|
Node.js.
|
|
|
|
* Fix a crash that would appear when writing some very large integers to CSS.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Improve performance for stand-alone packages on Linux and Mac OS.
|
|
|
|
### JavaScript API
|
|
|
|
* Pass imports to custom importers before resolving them using `includePaths` or
|
|
the `SASS_PATH` environment variable. This matches Node Sass's behavior, so
|
|
it's considered a bug fix.
|
|
|
|
## 1.20.1
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.20.0
|
|
|
|
* Support attribute selector modifiers, such as the `i` in `[title="test" i]`.
|
|
|
|
### Command-Line Interface
|
|
|
|
* When compilation fails, Sass will now write the error message to the CSS
|
|
output as a comment and as the `content` property of a `body::before` rule so
|
|
it will show up in the browser (unless compiling to standard output). This can
|
|
be disabled with the `--no-error-css` flag, or forced even when compiling to
|
|
standard output with the `--error-css` flag.
|
|
|
|
### Dart API
|
|
|
|
* Added `SassException.toCssString()`, which returns the contents of a CSS
|
|
stylesheet describing the error, as above.
|
|
|
|
## 1.19.0
|
|
|
|
* Allow `!` in `url()`s without quotes.
|
|
|
|
### Dart API
|
|
|
|
* `FilesystemImporter` now doesn't change its effective directory if the working
|
|
directory changes, even if it's passed a relative argument.
|
|
|
|
## 1.18.0
|
|
|
|
* Avoid recursively listing directories when finding the canonical name of a
|
|
file on case-insensitive filesystems.
|
|
|
|
* Fix importing files relative to `package:`-imported files.
|
|
|
|
* Don't claim that "package:" URLs aren't supported when they actually are.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Add a `--no-charset` flag. If this flag is set, Sass will never emit a
|
|
`@charset` declaration or a byte-order mark, even if the CSS file contains
|
|
non-ASCII characters.
|
|
|
|
### Dart API
|
|
|
|
* Add a `charset` option to `compile()`, `compileString()`, `compileAsync()` and
|
|
`compileStringAsync()`. If this option is set to `false`, Sass will never emit
|
|
a `@charset` declaration or a byte-order mark, even if the CSS file contains
|
|
non-ASCII characters.
|
|
|
|
* Explicitly require that importers' `canonicalize()` methods be able to take
|
|
paths relative to their outputs as valid inputs. This isn't considered a
|
|
breaking change because the importer infrastructure already required this in
|
|
practice.
|
|
|
|
## 1.17.4
|
|
|
|
* Consistently parse U+000C FORM FEED, U+000D CARRIAGE RETURN, and sequences of
|
|
U+000D CARRIAGE RETURN followed by U+000A LINE FEED as individual newlines.
|
|
|
|
### JavaScript API
|
|
|
|
* Add a `sass.types.Error` constructor as an alias for `Error`. This makes our
|
|
custom function API compatible with Node Sass's.
|
|
|
|
## 1.17.3
|
|
|
|
* Fix an edge case where slash-separated numbers were written to the stylesheet
|
|
with a slash even when they're used as part of another arithmetic operation,
|
|
such as being concatenated with a string.
|
|
|
|
* Don't put style rules inside empty `@keyframes` selectors.
|
|
|
|
## 1.17.2
|
|
|
|
* Deprecate `!global` variable assignments to variables that aren't yet defined.
|
|
This deprecation message can be avoided by assigning variables to `null` at
|
|
the top level before globally assigning values to them.
|
|
|
|
### Dart API
|
|
|
|
* Explicitly mark classes that were never intended to be subclassed or
|
|
implemented as "sealed".
|
|
|
|
## 1.17.1
|
|
|
|
* Properly quote attribute selector values that start with identifiers but end
|
|
with a non-identifier character.
|
|
|
|
## 1.17.0
|
|
|
|
* Improve error output, particularly for errors that cover multiple lines.
|
|
|
|
* Improve source locations for some parse errors. Rather than pointing to the
|
|
next token that wasn't what was expected, they point *after* the previous
|
|
token. This should generally provide more context for the syntax error.
|
|
|
|
* Produce a better error message for style rules that are missing the closing
|
|
`}`.
|
|
|
|
* Produce a better error message for style rules and property declarations
|
|
within `@function` rules.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Passing a directory on the command line now compiles all Sass source files in
|
|
the directory to CSS files in the same directory, as though `dir:dir` were
|
|
passed instead of just `dir`.
|
|
|
|
* The new error output uses non-ASCII Unicode characters by default. Add a
|
|
`--no-unicode` flag to disable this.
|
|
|
|
## 1.16.1
|
|
|
|
* Fix a performance bug where stylesheet evaluation could take a very long time
|
|
when many binary operators were used in sequence.
|
|
|
|
## 1.16.0
|
|
|
|
* `rgb()` and `hsl()` now treat unquoted strings beginning with `env()`,
|
|
`min()`, and `max()` as special number strings like `calc()`.
|
|
|
|
## 1.15.3
|
|
|
|
* Properly merge `all and` media queries. These queries were previously being
|
|
merged as though `all` referred to a specific media type, rather than all
|
|
media types.
|
|
|
|
* Never remove units from 0 values in compressed mode. This wasn't safe in
|
|
general, since some properties (such as `line-height`) interpret `0` as a
|
|
`<number>` rather than a `<length>` which can break CSS transforms. It's
|
|
better to do this optimization in a dedicated compressor that's aware of CSS
|
|
property semantics.
|
|
|
|
* Match Ruby Sass's behavior in some edge-cases involving numbers with many
|
|
significant digits.
|
|
|
|
* Emit escaped tab characters in identifiers as `\9` rather than a backslash
|
|
followed by a literal tab.
|
|
|
|
### Command-Line Interface
|
|
|
|
* The source map generated for a stylesheet read from standard input now uses a
|
|
`data:` URL to include that stylesheet's contents in the source map.
|
|
|
|
### Node JS API
|
|
|
|
* `this.includePaths` for a running importer is now a `;`-separated string on
|
|
Windows, rather than `:`-separated. This matches Node Sass's behavior.
|
|
|
|
### Dart API
|
|
|
|
* The URL used in a source map to refer to a stylesheet loaded from an importer
|
|
is now `ImportResult.sourceMapUrl` as documented.
|
|
|
|
## 1.15.2
|
|
|
|
### Node JS API
|
|
|
|
* When `setValue()` is called on a Sass string object, make it unquoted even if
|
|
it was quoted originally, to match the behavior of Node Sass.
|
|
|
|
## 1.15.1
|
|
|
|
* Always add quotes to attribute selector values that begin with `--`, since IE
|
|
11 doesn't consider them to be identifiers.
|
|
|
|
## 1.15.0
|
|
|
|
* Add support for passing arguments to `@content` blocks. See [the
|
|
proposal][content-args] for details.
|
|
|
|
* Add support for the new `rgb()` and `hsl()` syntax introduced in CSS Colors
|
|
Level 4, such as `rgb(0% 100% 0% / 0.5)`. See [the proposal][color-4-rgb-hsl]
|
|
for more details.
|
|
|
|
* Add support for interpolation in at-rule names. See [the
|
|
proposal][at-rule-interpolation] for details.
|
|
|
|
* Add paths from the `SASS_PATH` environment variable to the load paths in the
|
|
command-line interface, Dart API, and JS API. These load paths are checked
|
|
just after the load paths explicitly passed by the user.
|
|
|
|
* Allow saturation and lightness values outside of the `0%` to `100%` range in
|
|
the `hsl()` and `hsla()` functions. They're now clamped to be within that
|
|
range rather than producing an error if they're outside it.
|
|
|
|
* Properly compile selectors that end in escaped whitespace.
|
|
|
|
[content-args]: https://github.com/sass/language/blob/master/accepted/content-args.md
|
|
[color-4-rgb-hsl]: https://github.com/sass/language/blob/master/accepted/color-4-rgb-hsl.md
|
|
[at-rule-interpolation]: https://github.com/sass/language/blob/master/accepted/at-rule-interpolation.md
|
|
|
|
### JavaScript API
|
|
|
|
* Always include the error location in error messages.
|
|
|
|
## 1.14.4
|
|
|
|
* Properly escape U+0009 CHARACTER TABULATION in unquoted strings.
|
|
|
|
## 1.14.3
|
|
|
|
* Treat `:before`, `:after`, `:first-line`, and `:first-letter` as
|
|
pseudo-elements for the purposes of `@extend`.
|
|
|
|
* When running in compressed mode, remove spaces around combinators in complex
|
|
selectors, so a selector like `a > b` is output as `a>b`.
|
|
|
|
* Properly indicate the source span for errors involving binary operation
|
|
expressions whose operands are parenthesized.
|
|
|
|
## 1.14.2
|
|
|
|
* Fix a bug where loading the same stylesheet from two different import paths
|
|
could cause its imports to fail to resolve.
|
|
|
|
* Properly escape U+001F INFORMATION SEPARATOR ONE in unquoted strings.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Don't crash when using `@debug` in a stylesheet passed on standard input.
|
|
|
|
### Dart API
|
|
|
|
* `AsyncImporter.canonicalize()` and `Importer.canonicalize()` must now return
|
|
absolute URLs. Relative URLs are still supported, but are deprecated and will
|
|
be removed in a future release.
|
|
|
|
## 1.14.1
|
|
|
|
* Canonicalize escaped digits at the beginning of identifiers as hex escapes.
|
|
|
|
* Properly parse property declarations that are both *in* content blocks and
|
|
written *after* content blocks.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Print more readable paths in `--watch` mode.
|
|
|
|
## 1.14.0
|
|
|
|
### BREAKING CHANGE
|
|
|
|
In accordance with our [compatibility policy][], breaking changes made for CSS
|
|
compatibility reasons are released as minor version revision after a three-month
|
|
deprecation period.
|
|
|
|
[compatibility policy]: README.md#compatibility-policy
|
|
|
|
* Tokens such as `#abcd` that are now interpreted as hex colors with alpha
|
|
channels, rather than unquoted ID strings.
|
|
|
|
## 1.13.4
|
|
|
|
### Node JS
|
|
|
|
* Tweak JS compilation options to substantially improve performance.
|
|
|
|
## 1.13.3
|
|
|
|
* Properly generate source maps for stylesheets that emit `@charset`
|
|
declarations.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Don't error out when passing `--embed-source-maps` along with
|
|
`--embed-sources` for stylesheets that contain non-ASCII characters.
|
|
|
|
## 1.13.2
|
|
|
|
* Properly parse `:nth-child()` and `:nth-last-child()` selectors with
|
|
whitespace around the argument.
|
|
|
|
* Don't emit extra whitespace in the arguments for `:nth-child()` and
|
|
`:nth-last-child()` selectors.
|
|
|
|
* Fix support for CSS hacks in plain CSS mode.
|
|
|
|
## 1.13.1
|
|
|
|
* Allow an IE-style single equals operator in plain CSS imports.
|
|
|
|
## 1.13.0
|
|
|
|
* Allow `@extend` to be used with multiple comma-separated simple selectors.
|
|
This is already supported by other implementations, but fell through the
|
|
cracks for Dart Sass until now.
|
|
|
|
* Don't crash when a media rule contains another media rule followed by a style
|
|
rule.
|
|
|
|
## 1.12.0
|
|
|
|
### Dart API
|
|
|
|
* Add a `SassException` type that provides information about Sass compilation
|
|
failures.
|
|
|
|
### Node JS API
|
|
|
|
* Remove the source map comment from the compiled JS. We don't ship with the
|
|
source map, so this pointed to nothing.
|
|
|
|
## 1.11.0
|
|
|
|
* Add support for importing plain CSS files. They can only be imported *without*
|
|
an extension—for example, `@import "style"` will import `style.css`. Plain CSS
|
|
files imported this way only support standard CSS features, not Sass
|
|
extensions.
|
|
|
|
See [the proposal][css-import] for details.
|
|
|
|
* Add support for CSS's `min()` and `max()` [math functions][]. A `min()` and
|
|
`max()` call will continue to be parsed as a Sass function if it involves any
|
|
Sass-specific features like variables or function calls, but if it's valid
|
|
plain CSS (optionally with interpolation) it will be emitted as plain CSS instead.
|
|
|
|
See [the proposal][css-min-max] for details.
|
|
|
|
* Add support for range-format media features like `(10px < width < 100px)`. See
|
|
[the proposal][media-ranges] for details.
|
|
|
|
* Normalize escape codes in identifiers so that, for example, `éclair` and
|
|
`\E9clair` are parsed to the same value. See
|
|
[the proposal][identifier-escapes] for details.
|
|
|
|
* Don't choke on a [byte-order mark][] at the beginning of a document when
|
|
running in JavaScript.
|
|
|
|
[math functions]: https://drafts.csswg.org/css-values/#math-function
|
|
[css-import]: https://github.com/sass/language/blob/master/accepted/css-imports.md
|
|
[css-min-max]: https://github.com/sass/language/blob/master/accepted/min-max.md
|
|
[media-ranges]: https://github.com/sass/language/blob/master/accepted/media-ranges.md
|
|
[identifier-escapes]: https://github.com/sass/language/blob/master/accepted/identifier-escapes.md
|
|
[byte-order mark]: https://en.wikipedia.org/wiki/Byte_order_mark
|
|
|
|
### Command-Line Interface
|
|
|
|
* The `--watch` command now continues to recompile a file after a syntax error
|
|
has been detected.
|
|
|
|
### Dart API
|
|
|
|
* Added a `Syntax` enum to indicate syntaxes for Sass source files.
|
|
|
|
* The `compile()` and `compileAsync()` functions now parse files with the `.css`
|
|
extension as plain CSS.
|
|
|
|
* Added a `syntax` parameter to `compileString()` and `compileStringAsync()`.
|
|
|
|
* Deprecated the `indented` parameter to `compileString()` and `compileStringAsync()`.
|
|
|
|
* Added a `syntax` parameter to `new ImporterResult()` and a
|
|
`ImporterResult.syntax` getter to set the syntax of the source file.
|
|
|
|
* Deprecated the `indented` parameter to `new ImporterResult()` and the
|
|
`ImporterResult.indented` getter in favor of `syntax`.
|
|
|
|
## 1.10.4
|
|
|
|
### Command-Line Interface
|
|
|
|
* Fix a Homebrew installation failure.
|
|
|
|
## 1.10.3
|
|
|
|
### Command-Line Interface
|
|
|
|
* Run the Chocolatey script with the correct arguments so it doesn't crash.
|
|
|
|
## 1.10.2
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.10.1
|
|
|
|
### Node JS API
|
|
|
|
* Don't crash when passing both `includePaths` and `importer`.
|
|
|
|
## 1.10.0
|
|
|
|
* When two `@media` rules' queries can't be merged, leave nested rules in place
|
|
for browsers that support them.
|
|
|
|
* Fix a typo in an error message.
|
|
|
|
## 1.9.2
|
|
|
|
### Node JS API
|
|
|
|
* Produce more readable filesystem errors, such as when a file doesn't exist.
|
|
|
|
## 1.9.1
|
|
|
|
### Command-Line Interface
|
|
|
|
* Don't emit ANSI codes to Windows terminals that don't support them.
|
|
|
|
* Fix a bug where `--watch` crashed on Mac OS.
|
|
|
|
## 1.9.0
|
|
|
|
### Node API
|
|
|
|
* Add support for `new sass.types.Color(argb)` for creating colors from ARGB hex
|
|
numbers. This was overlooked when initially adding support for Node Sass's
|
|
JavaScript API.
|
|
|
|
## 1.8.0
|
|
|
|
### Command-Line Interface
|
|
|
|
* Add a `--poll` flag to make `--watch` mode repeatedly check the filesystem for
|
|
updates rather than relying on native filesystem notifications.
|
|
|
|
* Add a `--stop-on-error` flag to stop compiling additional files once an error
|
|
is encountered.
|
|
|
|
## 1.7.3
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.7.2
|
|
|
|
* Add a deprecation warning for `@-moz-document`, except for cases where only an
|
|
empty `url-prefix()` is used. Support is [being removed from Firefox][] and
|
|
will eventually be removed from Sass as well.
|
|
|
|
[being removed from Firefox]: https://www.fxsitecompat.com/en-CA/docs/2018/moz-document-support-has-been-dropped-except-for-empty-url-prefix/
|
|
|
|
* Fix a bug where `@-moz-document` functions with string arguments weren't being
|
|
parsed.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Don't crash when a syntax error is added to a watched file.
|
|
|
|
## 1.7.1
|
|
|
|
* Fix crashes in released binaries.
|
|
|
|
## 1.7.0
|
|
|
|
* Emit deprecation warnings for tokens such as `#abcd` that are ambiguous
|
|
between ID strings and hex colors with alpha channels. These will be
|
|
interpreted as colors in a release on or after 19 September 2018.
|
|
|
|
* Parse unambiguous hex colors with alpha channels as colors.
|
|
|
|
* Fix a bug where relative imports from files on the load path could look in the
|
|
incorrect location.
|
|
|
|
## 1.6.2
|
|
|
|
### Command-Line Interface
|
|
|
|
* Fix a bug where the source map comment in the generated CSS could refer to the
|
|
source map file using an incorrect URL.
|
|
|
|
## 1.6.1
|
|
|
|
* No user-visible changes.
|
|
|
|
## 1.6.0
|
|
|
|
* Produce better errors when expected tokens are missing before a closing brace.
|
|
|
|
* Avoid crashing when compiling a non-partial stylesheet that exists on the
|
|
filesystem next to a partial with the same name.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Add support for the `--watch`, which watches for changes in Sass files on the
|
|
filesystem and ensures that the compiled CSS is up-to-date.
|
|
|
|
* When using `--update`, surface errors when an import doesn't exist even if the
|
|
file containing the import hasn't been modified.
|
|
|
|
* When compilation fails, delete the output file rather than leaving an outdated
|
|
version.
|
|
|
|
## 1.5.1
|
|
|
|
* Fix a bug where an absolute Windows path would be considered an `input:output`
|
|
pair.
|
|
|
|
* Forbid custom properties that have no values, like `--foo:;`, since they're
|
|
forbidden by the CSS spec.
|
|
|
|
## 1.5.0
|
|
|
|
* Fix a bug where an importer would be passed an incorrectly-resolved URL when
|
|
handling a relative import.
|
|
|
|
* Throw an error when an import is ambiguous due to a partial and a non-partial
|
|
with the same name, or multiple files with different extensions. This matches
|
|
the standard Sass behavior.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Add an `--interactive` flag that supports interactively running Sass
|
|
expressions (thanks to [Jen Thakar][]!).
|
|
|
|
[Jen Thakar]: https://github.com/jathak
|
|
|
|
## 1.4.0
|
|
|
|
* Improve the error message for invalid semicolons in the indented syntax.
|
|
|
|
* Properly disallow semicolons after declarations in the indented syntax.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Add support for compiling multiple files at once by writing
|
|
`sass input.scss:output.css`. Note that unlike Ruby Sass, this *always*
|
|
compiles files by default regardless of when they were modified.
|
|
|
|
This syntax also supports compiling entire directories at once. For example,
|
|
`sass templates/stylesheets:public/css` compiles all non-partial Sass files
|
|
in `templates/stylesheets` to CSS files in `public/css`.
|
|
|
|
* Add an `--update` flag that tells Sass to compile only stylesheets that have
|
|
been (transitively) modified since the CSS file was generated.
|
|
|
|
### Dart API
|
|
|
|
* Add `Importer.modificationTime()` and `AsyncImporter.modificationTime()` which
|
|
report the last time a stylesheet was modified.
|
|
|
|
### Node API
|
|
|
|
* Generate source maps when the `sourceMaps` option is set to a string and the
|
|
`outFile` option is not set.
|
|
|
|
## 1.3.2
|
|
|
|
* Add support for `@elseif` as an alias of `@else if`. This is not an
|
|
intentional feature, so using it will cause a deprecation warning. It will be
|
|
removed at some point in the future.
|
|
|
|
## 1.3.1
|
|
|
|
### Node API
|
|
|
|
* Fix loading imports relative to stylesheets that were themselves imported
|
|
though relative include paths.
|
|
|
|
## 1.3.0
|
|
|
|
### Command-Line Interface
|
|
|
|
* Generate source map files by default when writing to disk. This can be
|
|
disabled by passing `--no-source-map`.
|
|
|
|
* Add a `--source-map-urls` option to control whether the source file URLs in
|
|
the generated source map are relative or absolute.
|
|
|
|
* Add an `--embed-sources` option to embed the contents of all source files in
|
|
the generated source map.
|
|
|
|
* Add an `--embed-source-map` option to embed the generated source map as a
|
|
`data:` URL in the generated CSS.
|
|
|
|
### Dart API
|
|
|
|
* Add a `sourceMap` parameter to `compile()`, `compileString()`,
|
|
`compileAsync()`, and `compileStringAsync()`. This takes a callback that's
|
|
called with a [`SingleMapping`][] that contains the source map information for
|
|
the compiled CSS file.
|
|
|
|
[`SingleMapping`]: https://www.dartdocs.org/documentation/source_maps/latest/source_maps.parser/SingleMapping-class.html
|
|
|
|
### Node API
|
|
|
|
* Added support for the `sourceMap`, `omitSourceMapUrl`, `outFile`,
|
|
`sourceMapContents`, `sourceMapEmbed`, and `sourceMapRoot` options to
|
|
`render()` and `renderSync()`.
|
|
|
|
* Fix a bug where passing a relative path to `render()` or `renderSync()` would
|
|
cause relative imports to break.
|
|
|
|
* Fix a crash when printing warnings in stylesheets compiled using `render()` or
|
|
`renderSync()`.
|
|
|
|
* Fix a bug where format errors were reported badly on Windows.
|
|
|
|
## 1.2.1
|
|
|
|
* Always emit units in compressed mode for `0` dimensions other than lengths and
|
|
angles.
|
|
|
|
## 1.2.0
|
|
|
|
* The command-line executable will now create the directory for the resulting
|
|
CSS if that directory doesn't exist.
|
|
|
|
* Properly parse `#{$var} -#{$var}` as two separate values in a list rather than
|
|
one value being subtracted from another.
|
|
|
|
* Improve the error message for extending compound selectors.
|
|
|
|
## 1.1.1
|
|
|
|
* Add a commit that was accidentally left out of 1.1.0.
|
|
|
|
## 1.1.0
|
|
|
|
* The command-line executable can now be used to write an output file to disk
|
|
using `sass input.scss output.css`.
|
|
|
|
* Use a POSIX-shell-compatible means of finding the location of the `sass` shell
|
|
script.
|
|
|
|
## 1.0.0
|
|
|
|
**Initial stable release.**
|
|
|
|
### Changes Since 1.0.0-rc.1
|
|
|
|
* Allow `!` in custom property values ([#260][]).
|
|
|
|
[#260]: https://github.com/sass/dart-sass/issues/260
|
|
|
|
#### Dart API
|
|
|
|
* Remove the deprecated `render()` function.
|
|
|
|
#### Node API
|
|
|
|
* Errors are now subtypes of the `Error` type.
|
|
|
|
* Allow both the `data` and `file` options to be passed to `render()` and
|
|
`renderSync()` at once. The `data` option will be used as the contents of the
|
|
stylesheet, and the `file` option will be used as the path for error reporting
|
|
and relative imports. This matches Node Sass's behavior.
|
|
|
|
## 1.0.0-rc.1
|
|
|
|
* Add support for importing an `_index.scss` or `_index.sass` file when
|
|
importing a directory.
|
|
|
|
* Add a `--load-path` command-line option (alias `-I`) for passing additional
|
|
paths to search for Sass files to import.
|
|
|
|
* Add a `--quiet` command-line option (alias `-q`) for silencing warnings.
|
|
|
|
* Add an `--indented` command-line option for using the indented syntax with a
|
|
stylesheet from standard input.
|
|
|
|
* Don't merge the media queries `not type` and `(feature)`. We had previously
|
|
been generating `not type and (feature)`, but that's not actually the
|
|
intersection of the two queries.
|
|
|
|
* Don't crash on `$x % 0`.
|
|
|
|
* The standalone executable distributed on GitHub is now named `sass` rather
|
|
than `dart-sass`. The `dart-sass` executable will remain, with a deprecation
|
|
message, until 1.0.0 is released.
|
|
|
|
### Dart API
|
|
|
|
* Add a `Logger` class that allows users to control how messages are printed by
|
|
stylesheets.
|
|
|
|
* Add a `logger` parameter to `compile()`, `compileAsync()`, `compileString()`,
|
|
and `compileStringAsync()`.
|
|
|
|
### Node JS API
|
|
|
|
* Import URLs passed to importers are no longer normalized. For example, if a
|
|
stylesheet contains `@import "./foo.scss"`, importers will now receive
|
|
`"./foo.scss"` rather than `"foo.scss"`.
|
|
|
|
## 1.0.0-beta.5.3
|
|
|
|
* Support hard tabs in the indented syntax.
|
|
|
|
* Improve the formatting of comments that don't start on the same line as the
|
|
opening `/*`.
|
|
|
|
* Preserve whitespace after `and` in media queries in compressed mode.
|
|
|
|
### Indented Syntax
|
|
|
|
* Properly parse multi-line selectors.
|
|
|
|
* Don't deadlock on `/*` comments.
|
|
|
|
* Don't add an extra `*/` to comments that already have it.
|
|
|
|
* Preserve empty lines in `/*` comments.
|
|
|
|
## 1.0.0-beta.5.2
|
|
|
|
* Fix a bug where some colors would crash `compressed` mode.
|
|
|
|
## 1.0.0-beta.5.1
|
|
|
|
* Add a `compressed` output style.
|
|
|
|
* Emit a warning when `&&` is used, since it's probably not what the user means.
|
|
|
|
* `round()` now returns the correct results for negative numbers that should
|
|
round down.
|
|
|
|
* `var()` may now be passed in place of multiple arguments to `rgb()`, `rgba()`,
|
|
`hsl()` and `hsla()`.
|
|
|
|
* Fix some cases where equivalent numbers wouldn't count as the same keys in
|
|
maps.
|
|
|
|
* Fix a bug where multiplication like `(1/1px) * (1px/1)` wouldn't properly
|
|
cancel out units.
|
|
|
|
* Fix a bug where dividing by a compatible unit would produce an invalid
|
|
result.
|
|
|
|
* Remove a non-`sh`-compatible idiom from the standalone shell script.
|
|
|
|
### Dart API
|
|
|
|
* Add a `functions` parameter to `compile()`, `compleString()`,
|
|
`compileAsync()`, and `compileStringAsync()`. This allows users to define
|
|
custom functions in Dart that can be invoked from Sass stylesheets.
|
|
|
|
* Expose the `Callable` and `AsyncCallable` types, which represent functions
|
|
that can be invoked from Sass.
|
|
|
|
* Expose the `Value` type and its subclasses, as well as the top-level
|
|
`sassTrue`, `sassFalse`, and `sassNull` values, which represent Sass values
|
|
that may be passed into or returned from custom functions.
|
|
|
|
* Expose the `OutputStyle` enum, and add a `style` parameter to `compile()`,
|
|
`compleString()`, `compileAsync()`, and `compileStringAsync()` that allows
|
|
users to control the output style.
|
|
|
|
### Node JS API
|
|
|
|
* Support the `functions` option.
|
|
|
|
* Support the `"compressed"` value for the `outputStyle` option.
|
|
|
|
## 1.0.0-beta.4
|
|
|
|
* Support unquoted imports in the indented syntax.
|
|
|
|
* Fix a crash when `:not(...)` extends a selector that appears in
|
|
`:not(:not(...))`.
|
|
|
|
### Node JS API
|
|
|
|
* Add support for asynchronous importers to `render()` and `renderSync()`.
|
|
|
|
### Dart API
|
|
|
|
* Add `compileAsync()` and `compileStringAsync()` methods. These run
|
|
asynchronously, which allows them to take asynchronous importers (see below).
|
|
|
|
* Add an `AsyncImporter` class. This allows imports to be resolved
|
|
asynchronously in case no synchronous APIs are available. `AsyncImporter`s are
|
|
only compatible with `compileAysnc()` and `compileStringAsync()`.
|
|
|
|
## 1.0.0-beta.3
|
|
|
|
* Properly parse numbers with exponents.
|
|
|
|
* Don't crash when evaluating CSS variables whose names are entirely
|
|
interpolated (for example, `#{--foo}: ...`).
|
|
|
|
### Node JS API
|
|
|
|
* Add support for the `importer` option to `render()` and `renderSync()`.
|
|
Only synchronous importers are currently supported.
|
|
|
|
### Dart API
|
|
|
|
* Added an `Importer` class. This can be extended by users to provide support
|
|
for custom resolution for `@import` rules.
|
|
|
|
* Added built-in `FilesystemImporter` and `PackageImporter` implementations that
|
|
support resolving `file:` and `package:` URLs, respectively.
|
|
|
|
* Added an `importers` argument to the `compile()` and `compileString()`
|
|
functions that provides `Importer`s to use when resolving `@import` rules.
|
|
|
|
* Added a `loadPaths` argument to the `compile()` and `compileString()`
|
|
functions that provides paths to search for stylesheets when resolving
|
|
`@import` rules. This is a shorthand for passing `FilesystemImporter`s to the
|
|
`importers` argument.
|
|
|
|
## 1.0.0-beta.2
|
|
|
|
* Add support for the `::slotted()` pseudo-element.
|
|
|
|
* Generated transparent colors will now be emitted as `rgba(0, 0, 0, 0)` rather
|
|
than `transparent`. This works around a bug wherein IE incorrectly handles the
|
|
latter format.
|
|
|
|
### Command-Line Interface
|
|
|
|
* Improve the logic for whether to use terminal colors by default.
|
|
|
|
### Node JS API
|
|
|
|
* Add support for `data`, `includePaths`, `indentedSyntax`, `lineFeed`,
|
|
`indentWidth`, and `indentType` options to `render()` and `renderSync()`.
|
|
|
|
* The result object returned by `render()` and `renderSync()` now includes the
|
|
`stats` object which provides metadata about the compilation process.
|
|
|
|
* The error object thrown by `render()` and `renderSync()` now includes `line`,
|
|
`column`, `file`, `status`, and `formatted` fields. The `message` field and
|
|
`toString()` also provide more information.
|
|
|
|
### Dart API
|
|
|
|
* Add a `renderString()` method for rendering Sass source that's not in a file
|
|
on disk.
|
|
|
|
## 1.0.0-beta.1
|
|
|
|
* Drop support for the reference combinator. This has been removed from the
|
|
spec, and will be deprecated and eventually removed in other implementations.
|
|
|
|
* Trust type annotations when compiling to JavaScript, which makes it
|
|
substantially faster.
|
|
|
|
* Compile to minified JavaScript, which decreases the code size substantially
|
|
and makes startup a little faster.
|
|
|
|
* Fix a crash when inspecting a string expression that ended in "\a".
|
|
|
|
* Fix a bug where declarations and `@extend` were allowed outside of a style
|
|
rule in certain circumstances.
|
|
|
|
* Fix `not` in parentheses in `@supports` conditions.
|
|
|
|
* Allow `url` as an identifier name.
|
|
|
|
* Properly parse `/***/` in selectors.
|
|
|
|
* Properly parse unary operators immediately after commas.
|
|
|
|
* Match Ruby Sass's rounding behavior for all functions.
|
|
|
|
* Allow `\` at the beginning of a selector in the indented syntax.
|
|
|
|
* Fix a number of `@extend` bugs:
|
|
|
|
* `selector-extend()` and `selector-replace()` now allow compound selector
|
|
extendees.
|
|
|
|
* Remove the universal selector `*` when unifying with other selectors.
|
|
|
|
* Properly unify the result of multiple simple selectors in the same compound
|
|
selector being extended.
|
|
|
|
* Properly handle extensions being extended.
|
|
|
|
* Properly follow the [first law of `@extend`][laws].
|
|
|
|
* Fix selector specificity tracking to follow the
|
|
[second law of `@extend`][laws].
|
|
|
|
* Allow extensions that match selectors but fail to unify.
|
|
|
|
* Partially-extended selectors are no longer used as parent selectors.
|
|
|
|
* Fix an edge case where both the extender and the extended selector
|
|
have invalid combinator sequences.
|
|
|
|
* Don't crash with a "Bad state: no element" error in certain edge cases.
|
|
|
|
[laws]: https://github.com/sass/sass/issues/324#issuecomment-4607184
|
|
|
|
## 1.0.0-alpha.9
|
|
|
|
* Elements without a namespace (such as `div`) are no longer unified with
|
|
elements with the empty namespace (such as `|div`). This unification didn't
|
|
match the results returned by `is-superselector()`, and was not guaranteed to
|
|
be valid.
|
|
|
|
* Support `&` within `@at-root`.
|
|
|
|
* Properly error when a compound selector is followed immediately by `&`.
|
|
|
|
* Properly handle variable scoping in `@at-root` and nested properties.
|
|
|
|
* Properly handle placeholder selectors in selector pseudos.
|
|
|
|
* Properly short-circuit the `or` and `and` operators.
|
|
|
|
* Support `--$variable`.
|
|
|
|
* Don't consider unitless numbers equal to numbers with units.
|
|
|
|
* Warn about using named colors in interpolation.
|
|
|
|
* Don't emit loud comments in functions.
|
|
|
|
* Detect import loops.
|
|
|
|
* Fix `@import` with a `supports()` clause.
|
|
|
|
* Forbid functions named "and", "or", and "not".
|
|
|
|
* Fix `type-of()` with a function.
|
|
|
|
* Emit a nicer error for invalid tokens in a selector.
|
|
|
|
* Fix `invert()` with a `$weight` parameter.
|
|
|
|
* Fix a unit-parsing edge-cases.
|
|
|
|
* Always parse imports with queries as plain CSS imports.
|
|
|
|
* Support `&` followed by a non-identifier.
|
|
|
|
* Properly handle split media queries.
|
|
|
|
* Properly handle a placeholder selector that isn't at the beginning of a
|
|
compound selector.
|
|
|
|
* Fix more `str-slice()` bugs.
|
|
|
|
* Fix the `%` operator.
|
|
|
|
* Allow whitespace between `=` and the mixin name in the indented syntax.
|
|
|
|
* Fix some slash division edge cases.
|
|
|
|
* Fix `not` when used like a function.
|
|
|
|
* Fix attribute selectors with single-character values.
|
|
|
|
* Fix some bugs with the `call()` function.
|
|
|
|
* Properly handle a backslash followed by a CRLF sequence in a quoted string.
|
|
|
|
* Fix numbers divided by colors.
|
|
|
|
* Support slash-separated numbers in arguments to plain CSS functions.
|
|
|
|
* Error out if a function is passed an unknown named parameter.
|
|
|
|
* Improve the speed of loading large files on Node.
|
|
|
|
* Don't consider browser-prefixed selector pseudos to be superselectors of
|
|
differently- or non-prefixed selector pseudos with the same base name.
|
|
|
|
* Fix an `@extend` edge case involving multiple combinators in a row.
|
|
|
|
* Fix a bug where a `@content` block could get incorrectly passed to a mixin.
|
|
|
|
* Properly isolate the lexical environments of different calls to the same mixin
|
|
and function.
|
|
|
|
## 1.0.0-alpha.8
|
|
|
|
* Add the `content-exists()` function.
|
|
|
|
* Support interpolation in loud comments.
|
|
|
|
* Fix a bug where even valid semicolons and exclamation marks in custom property
|
|
values were disallowed.
|
|
|
|
* Disallow invalid function names.
|
|
|
|
* Disallow extending across media queries.
|
|
|
|
* Properly parse whitespace after `...` in argument declaration lists.
|
|
|
|
* Support terse mixin syntax in the indented syntax.
|
|
|
|
* Fix `@at-root` query parsing.
|
|
|
|
* Support special functions in `@-moz-document`.
|
|
|
|
* Support `...` after a digit.
|
|
|
|
* Fix some bugs when treating a map as a list of pairs.
|
|
|
|
## 1.0.0-alpha.7
|
|
|
|
* Fix `function-exists()`, `variable-exists()`, and `mixin-exists()` to use the
|
|
lexical scope rather than always using the global scope.
|
|
|
|
* `str-index()` now correctly inserts at negative indices.
|
|
|
|
* Properly parse `url()`s that contain comment-like text.
|
|
|
|
* Fix a few more small `@extend` bugs.
|
|
|
|
* Fix a bug where interpolation in a quoted string was being dropped in some
|
|
circumstances.
|
|
|
|
* Properly handle `@for` rules where each bound has a different unit.
|
|
|
|
* Forbid mixins and functions from being defined in control directives.
|
|
|
|
* Fix a superselector-computation edge case involving `:not()`.
|
|
|
|
* Gracefully handle input files that are invalid UTF-8.
|
|
|
|
* Print a Sass stack trace when a file fails to load.
|
|
|
|
## 1.0.0-alpha.6
|
|
|
|
* Allow `var()` to be passed to `rgb()`, `rgba()`, `hsl()`, and `hsla()`.
|
|
|
|
* Fix conversions between numbers with `dpi`, `dpcm`, and `dppx` units.
|
|
Previously these conversions were inverted.
|
|
|
|
* Don't crash when calling `str-slice()` with an `$end-at` index lower than the
|
|
`$start-at` index.
|
|
|
|
* `str-slice()` now correctly returns `""` when `$end-at` is negative and points
|
|
before the beginning of the string.
|
|
|
|
* Interpolation in quoted strings now properly preserves newlines.
|
|
|
|
* Don't crash when passing only `$hue` or no keyword arguments to
|
|
`adjust-color()`, `scale-color()`, or `change-color()`.
|
|
|
|
* Preserve escapes in identifiers. This used to only work for identifiers in
|
|
SassScript.
|
|
|
|
* Fix a few small `@extend` bugs.
|
|
|
|
## 1.0.0-alpha.5
|
|
|
|
* Fix bounds-checking for `opacify()`, `fade-in()`, `transparentize()`, and
|
|
`fade-out()`.
|
|
|
|
* Fix a bug with `@extend` superselector calculations.
|
|
|
|
* Fix some cases where `#{...}--` would fail to parse in selectors.
|
|
|
|
* Allow a single number to be passed to `saturate()` for use in filter contexts.
|
|
|
|
* Fix a bug where `**/` would fail to close a loud comment.
|
|
|
|
* Fix a bug where mixin and function calls could set variables incorrectly.
|
|
|
|
* Move plain CSS `@import`s to the top of the document.
|
|
|
|
## 1.0.0-alpha.4
|
|
|
|
* Add support for bracketed lists.
|
|
|
|
* Add support for Unicode ranges.
|
|
|
|
* Add support for the Microsoft-style `=` operator.
|
|
|
|
* Print the filename for `@debug` rules.
|
|
|
|
* Fix a bug where `1 + - 2` and similar constructs would crash the parser.
|
|
|
|
* Fix a bug where `@extend` produced the wrong result when used with
|
|
selector combinators.
|
|
|
|
* Fix a bug where placeholder selectors were not allowed to be unified.
|
|
|
|
* Fix the `mixin-exists()` function.
|
|
|
|
* Fix `:nth-child()` and `:nth-last-child()` parsing when they contain `of
|
|
selector`.
|
|
|
|
## 1.0.0-alpha.3
|
|
|
|
* Fix a bug where color equality didn't take the alpha channel into account.
|
|
|
|
* Fix a bug with converting some RGB colors to HSL.
|
|
|
|
* Fix a parent selector resolution bug.
|
|
|
|
* Properly declare the arguments for `opacify()` and related functions.
|
|
|
|
* Add a missing dependency on the `stack_trace` package.
|
|
|
|
* Fix broken Windows archives.
|
|
|
|
* Emit colors using their original representation if possible.
|
|
|
|
* Emit colors without an original representation as names if possible.
|
|
|
|
## 1.0.0-alpha.2
|
|
|
|
* Fix a bug where variables, functions, and mixins were broken in imported
|
|
files.
|
|
|
|
## 1.0.0-alpha.1
|
|
|
|
* Initial alpha release.
|