Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(deps): update dependency sass to ~1.59.0 #10221

Merged
merged 1 commit into from
Mar 11, 2023
Merged

Conversation

renovate[bot]
Copy link
Contributor

@renovate renovate bot commented Mar 11, 2023

Mend Renovate

This PR contains the following updates:

Package Change Age Adoption Passing Confidence
sass ~1.40.0 -> ~1.59.0 age adoption passing confidence

Release Notes

sass/dart-sass

v1.59.2

Compare Source

  • No user-visible changes.

v1.59.1

Compare Source

  • No user-visible changes.

v1.59.0

Compare Source

Command Line Interface
  • Added a new --fatal-deprecation flag that lets you treat a deprecation
    warning as an error. You can pass an individual deprecation ID
    (e.g. slash-div) or you can pass a Dart Sass version to treat all
    deprecations initially emitted in that version or earlier as errors.

  • New --future-deprecation flag that lets you opt into warning for use of
    certain features that will be deprecated in the future. At the moment, the
    only option is --future-deprecation=import, which will emit warnings for
    Sass @import rules, which are not yet deprecated, but will be in the future.

Dart API
  • New Deprecation enum, which contains the different current and future
    deprecations used by the new CLI flags.

  • The compile methods now take in fatalDeprecations and futureDeprecations
    parameters, which work similarly to the CLI flags.

v1.58.3

Compare Source

  • No user-visible changes.

v1.58.2

Compare Source

Command Line Interface
  • Add a timestamp to messages printed in --watch mode.

  • Print better calc()-based suggestions for /-as-division expression that
    contain calculation-incompatible constructs like unary minus.

v1.58.1

Compare Source

  • Emit a unitless hue when serializing hsl() colors. The deg unit is
    incompatible with IE, and while that officially falls outside our
    compatibility policy, it's better to lean towards greater compatibility.

v1.58.0

Compare Source

  • Remove sourcemap comments from Sass sources. The generated sourcemap comment
    for the compiled CSS output remains unaffected.

  • Fix a bug in @extend logic where certain selectors with three or more
    combinators were incorrectly considered superselectors of similar selectors
    with fewer combinators, causing them to be incorrectly trimmed from the
    output.

  • Produce a better error message for a number with a leading + or -, a
    decimal point, but no digits.

  • Produce a better error message for a nested property whose name starts with
    --.

  • Fix a crash when a selector ends in an escaped backslash.

  • Add the relative length units from CSS Values 4 and CSS Contain 3 as known
    units to validate bad computation in calc.

Command Line Interface
  • The --watch flag will now track loads through calls to meta.load-css() as
    long as their URLs are literal strings without any interpolation.

v1.57.1

Compare Source

  • No user-visible changes.

v1.57.0

Compare Source

  • Add a split($string, $separator, $limit: null) function to sass:string
    that splits a string into separate substrings based on a separator string.
JavaScript API
  • Potentially breaking bug fix: Custom functions in both the modern and
    legacy API now properly reject signatures with whitespace between the function
    name and parentheses.

  • Custom functions in the legacy API now allow signatures with whitespace before
    the function name, to match a bug in Node Sass.

Dart API
  • Potentially breaking bug fix: Callable.fromSignature() and
    AsyncCallable.fromSignature() now reject signatures with whitespace between
    the function name and parentheses.

v1.56.2

Compare Source

Embedded Sass

v1.56.1

Compare Source

Embedded Sass
  • Importer results now validate that contents is actually a string and whether
    sourceMapUrl is an absolute URL.

v1.56.0

Compare Source

  • Potentially breaking change: To match the CSS spec, SassScript expressions
    beginning with not or ( are no longer supported at the beginning of
    parenthesized sections of media queries. For example,

    @​media (width >= 500px) and (not (grid))

    will now be emitted unchanged, instead of producing

    @​media (width >= 500px) and (false)

    See the Sass website for details.

  • Potentially breaking bug fix: Angle units like rad or turn are now
    properly converted to equivalent deg values for hsl(), hsla(),
    adjust-hue(), color.adjust(), and color.change().

    See the Sass website for
    details.

  • Fix indentation for selectors that span multiple lines in a @media query.

  • Emit a deprecation warning when passing $alpha values with units to
    color.adjust() or color.change(). This will be an error in Dart Sass
    2.0.0.

    See the Sass website for
    details.

  • Emit a deprecation warning when passing a $weight value with no units or
    with units other than % to color.mix(). This will be an error in Dart Sass
    2.0.0.

    See the Sass website for
    details.

  • Emit a deprecation warning when passing $n values with units to list.nth()
    or list.set-nth(). This will be an error in Dart Sass 2.0.0.

    See the Sass website for
    details.

  • Improve existing deprecation warnings to wrap /-as-division suggestions in
    calc() expressions.

  • Properly mark the warning for passing numbers with units to random() as a
    deprecation warning.

  • Fix a bug where @extend could behave unpredicatably when used along with
    meta.load-css() and shared modules that contained no CSS themselves but
    loaded CSS from other modules.

Dart API
  • Emit a deprecation warning when passing a sassIndex with units to
    Value.sassIndexToListIndex(). This will be an error in Dart Sass 2.0.0.
JS API
  • Importer results now validate whether contents is actually a string type.

  • Importer result argument errors are now rendered correctly.

v1.55.0

Compare Source

  • Potentially breaking bug fix: Sass numbers are now universally stored as
    64-bit floating-point numbers, rather than sometimes being stored as integers.
    This will generally make arithmetic with very large numbers more reliable and
    more consistent across platforms, but it does mean that numbers between nine
    quadrillion and nine quintillion will no longer be represented with full
    accuracy when compiling Sass on the Dart VM.

  • Potentially breaking bug fix: Sass equality is now properly transitive.
    Two numbers are now considered equal (after doing unit conversions) if they
    round to the same 1e-11th. Previously, numbers were considered equal if they
    were within 1e-11 of one another, which led to some circumstances where $a == $b and $b == $c but $a != $b.

  • Potentially breaking bug fix: Various functions in sass:math no longer
    treat floating-point numbers that are very close (but not identical) to
    integers as integers. Instead, these functions now follow the floating-point
    specification exactly. For example, math.pow(0.000000000001, -1) now returns
    1000000000000 instead of Infinity.

  • Emit a deprecation warning for $a -$b and $a +$b, since these look like
    they could be unary operations but they're actually parsed as binary
    operations. Either explicitly write $a - $b or $a (-$b). See
    https://sass-lang.com/d/strict-unary for more details.

Dart API
  • Add an optional argumentName parameter to SassScriptException() to make it
    easier to throw exceptions associated with particular argument names.

  • Most APIs that previously returned num now return double. All APIs
    continue to accept num, although in Dart 2.0.0 these APIs will be changed
    to accept only double.

JS API
  • Fix a bug in which certain warning spans would not have their properties
    accessible by the JS API.

v1.54.9

Compare Source

  • Fix an incorrect span in certain @media query deprecation warnings.

v1.54.8

Compare Source

  • No user-visible changes.

v1.54.7

Compare Source

  • Add support for 32-bit ARM releases on Linux.

v1.54.6

Compare Source

  • Fix a bug where a @media query could be incorrectly omitted from a
    stylesheet if it had multiple levels of nested @media queries within it
    and the inner queries were mergeable but the outer query was not.

v1.54.5

Compare Source

  • Properly consider a ~ c to be a superselector of a ~ b ~ c and a + b + c.

  • Properly consider b > c to be a superselector of a > b > c, and similarly
    for other combinators.

  • Properly calculate specificity for selector pseudoclasses.

  • Deprecate use of random() when $limit has units to make it explicit that
    random() currently ignores units. A future version will no longer ignore
    units.

  • Don't throw an error when the same module is @forwarded multiple times
    through a configured module.

Embedded Sass
  • Rather than downloading the embedded compiler for the local platform on
    install, the sass-embedded npm package now declares optional dependencies on
    platform-specific embedded compiler packages.

v1.54.4

Compare Source

  • Improve error messages when passing incorrect units that are also
    out-of-bounds to various color functions.

v1.54.3

Compare Source

  • Release a native ARM64 executable for Mac OS.

v1.54.2

Compare Source

  • No user-visible changes.

v1.54.1

Compare Source

  • When unifying selectors for @extend and selector.unify(), ensure that
    :root, :scope, :host, and :host-context only appear at the beginning
    of complex selectors.

v1.54.0

Compare Source

  • Deprecate selectors with leading or trailing combinators, or with multiple
    combinators in a row. If they're included in style rules after nesting is
    resolved, Sass will now produce a deprecation warning and, in most cases, omit
    the selector. Leading and trailing combinators can still be freely used for
    nesting purposes.

    See https://sass-lang.com/d/bogus-combinators for more details.

  • Add partial support for new media query syntax from Media Queries Level 4. The
    only exception are logical operations nested within parentheses, as these were
    previously interpreted differently as SassScript expressions.

    A parenthesized media condition that begins with not or an opening
    parenthesis now produces a deprecation warning. In a future release, these
    will be interpreted as plain CSS instead.

  • Deprecate passing non-deg units to color.hwb()'s $hue argument.

  • Fix a number of bugs when determining whether selectors with pseudo-elements
    are superselectors.

  • Treat * as a superselector of all selectors.

Dart API
  • Add a top-level fakeFromImport() function for testing custom importers
    that use AsyncImporter.fromImport.
JS API
  • Add a charset option that controls whether or not Sass emits a
    @charset/BOM for non-ASCII stylesheets.

  • Fix Sass npm package types for TS 4.7+ Node16 and NodeNext module resolution.

v1.53.0

Compare Source

  • Add support for calling var() with an empty second argument, such as
    var(--side, ).
JS API
  • Fix a bug where meta.load-css() would sometimes resolve relative URLs
    incorrectly when called from a mixin using the legacy JS API.
Embedded Sass
  • Respect npm's proxy settings when downloading the embedded Sass compiler.

v1.52.3

Compare Source

  • Fix crash when trailing loud comments (/* ... */) appear twice in a row
    across two different imports which themselves imported the same file each.

v1.52.2

Compare Source

  • Preserve location of trailing loud comments (/* ... */) instead of pushing
    the comment to the next line.

v1.52.1

Compare Source

Command Line Interface
  • Fix a bug where --watch mode would close immediately in TTY mode. This was
    caused by our change to close --watch when stdin was closed outside of TTY
    mode, which has been reverted for now while we work on a fix.

v1.52.0

Compare Source

  • Add support for arbitrary modifiers at the end of plain CSS imports, in
    addition to the existing supports() and media queries. Sass now allows any
    sequence of identifiers of functions after the URL of an import for forwards
    compatibility with future additions to the CSS spec.

  • Fix an issue where source locations tracked through variable references could
    potentially become incorrect.

  • Fix a bug where a loud comment in the source can break the source map when
    embedding the sources, when using the command-line interface or the legacy JS
    API.

JS API
  • SassNumber.assertUnit() and SassNumber.assertNoUnits() now correctly
    return the number called on when it passes the assertion.

v1.51.0

Compare Source

  • Potentially breaking change: Change the order of maps returned by
    map.deep-merge() to match those returned by map.merge(). All keys that
    appeared in the first map will now be listed first in the same order they
    appeared in that map, followed by any new keys added from the second map.

  • Improve the string output of some AST nodes in error messages.

v1.50.1

Compare Source

Embedded Sass
  • The JS embedded host and the embedded compiler will now properly avoid
    resolving imports relative to the current working directory unless '.' is
    passed as a load path.

  • Fix a bug in the JS embedded host's implementation of the legacy JS API where
    imports that began with / could crash on Windows.

v1.50.0

Compare Source

  • @extend now treats [:where()][:where()] the same as :is().
Command Line Interface
  • Closing the standard input stream will now cause the --watch command to stop
    running.
Embedded Sass
  • Fix a bug where the JS embedded host crashed when invoking a legacy importer
    after resolving a relative filesystem import.

  • Improve error messages when returning non-Object values from legacy
    importers.

v1.49.11

Compare Source

  • Add support for 64-bit ARM releases on Linux.
Embedded Sass
  • The embedded compiler now correctly sets the id field for all
    OutboundMessages.

v1.49.10

Compare Source

  • Quiet deps mode now silences compiler warnings in mixins and functions that
    are defined in dependencies even if they're invoked from application
    stylesheets.

  • In expanded mode, Sass will now emit colors using rgb(), rbga(), hsl(),
    and hsla() function notation if they were defined using the corresponding
    notation. As per our browser support policy, this change was only done once
    95% of browsers were confirmed to support this output format, and so is not
    considered a breaking change.

    Note that this output format is intended for human readability and not for
    interoperability with other tools. As always, Sass targets the CSS
    specification, and any tool that consumes Sass's output should parse all
    colors that are supported by the CSS spec.

  • Fix a bug in which a color written using the four- or eight-digit hex format
    could be emitted as a hex color rather than a format with higher browser
    compatibility.

  • Calculations are no longer simplified within supports declarations

v1.49.9

Compare Source

Embedded Sass
  • Fixed a bug where the legacy API could crash when passed an empty importer
    list.

v1.49.8

Compare Source

  • Fixed a bug where some plain CSS imports would not be emitted.
JS API
  • Fix a bug where inspecting the Sass module in the Node.js console crashed on
    Node 17.
Embedded Sass
  • Fix a bug where source map URLs were incorrectly generated when passing
    importers to the legacy API.

v1.49.7

Compare Source

Embedded Sass
  • First stable release the sass-embedded npm package that contains the Node.js
    Embedded Host.

  • First stable release of the sass_embedded pub package that contains the
    Embedded Dart Sass compiler.

v1.49.6

Compare Source

  • No user-visible changes.

v1.49.5

Compare Source

  • No user-visible changes.

v1.49.4

Compare Source

  • No user-visible changes.

v1.49.3

Compare Source

  • No user-visible changes.

v1.49.2

Compare Source

  • No user-visible changes.

v1.49.1

Compare Source

  • Add support for 64-bit ARM releases on Linux.
Embedded Sass
  • The embedded compiler now correctly sets the id field for all
    OutboundMessages.

v1.49.0

Compare Source

  • Fix a bug in string.insert with certain negative indices.
JS API
  • Add support for the sourceMapIncludeSources option in the new JS API.
TypeScript Declarations
  • Fix a bug where LegacyPluginThis.options.linefeed was typed to return
    abbreviations when it actually returned literal linefeed characters.

v1.48.0

Compare Source

JS API
  • Potentially breaking bug fix: Match the specification of the new JS API by
    setting LegacyResult.map to undefined rather than null.
TypeScript Declarations
  • Add a declaration for the NULL constant.

v1.47.0

Compare Source

JS API
TypeScript Declarations
  • Add declarations for the TRUE and FALSE constants.

v1.46.0

Compare Source

JS API
  • Potentially breaking bug fix: Match the specification of the new JS API by
    passing undefined rather than null to Logger.warn() for an unset span.
TypeScript Declarations
  • Add a declaration for the LegacyPluginThis.options.context field.

  • Update the definition of LegacyAsyncFunction to include explicit definitions
    with zero through six arguments before the done parameter. This makes it
    possible for TypeScript users to pass in callbacks that take a specific number
    of arguments, rather than having to declare a callback that takes an arbitrary
    number.

  • Add a declaration for types.Error, a legacy API class that can be returned
    by asynchronous functions to signal asynchronous errors.

  • Add a LegacyAsyncFunctionDone type for the done callback that's passed to
    LegacyAsyncFunction.

v1.45.2

Compare Source

JS API
  • Potentially breaking bug fix: Change the default value of the separator
    parameter for new SassArgumentList() to ',' rather than null. This
    matches the API specification.

v1.45.1

Compare Source

  • Potentially breaking bug fix: Properly parse custom properties in
    @supports conditions. Note that this means that SassScript expressions on
    the right-hand side of custom property @supports queries now need to be
    interpolated, as per https://sass-lang.com/d/css-vars.

  • Potentially breaking bug fix: Fix a bug where inspect() was not
    properly printing nested, empty, bracketed lists.

v1.45.0

Compare Source

JS API

This release includes an entirely new JavaScript API, designed to be more
idiomatic, performant, and usable. The old API will continue to be supported
until Dart Sass 2.0.0, but it is now considered deprecated and should be avoided
for new code.

The new API includes:

  • compile() and compileAsync() functions that take Sass file paths and
    return the result of compiling them to CSS. The async function returns a
    Promise rather than using a callback-based API.

  • compileString() and compileStringAsync() functions that take a string of
    Sass source and compiles it to CSS. As above, the async function returns a
    Promise.

  • A new importer API that more closely matches the Sass specification's logic
    for resolving loads. This makes it much easier for Sass to cache information
    across @import and @use rules, which substantially improves performance
    for applications that rely heavily on repeated @imports.

  • A new custom function API, including much more usable JS representations of
    Sass value types complete with type-assertion functions, easy map and list
    lookups, and compatibility with the [immutable][immutable] package. Unlike in the
    legacy API,
    function callbacks now take one argument which contains an array
    of Sass values (rather than taking a separate JS argument for each Sass
    argument).

For full documentation of this API, please see the Sass website.

This release also adds TypeScript type definitions.

v1.44.0

Compare Source

  • Suggest calc() as an alternative in /-as-division deprecation messages.
Dart API
  • Add SassNumber.convert() and SassNumber.convertValue(). These work like
    SassNumber.coerce() and SassNumber.coerceValue(), except they don't treat
    unitless numbers as universally compatible.

  • Fix a bug where SassNumber.coerceToMatch() and
    SassNumber.coerceValueToMatch() wouldn't coerce single-unit numbers to
    match unitless numbers.

v1.43.5

Compare Source

  • Fix a bug where calculations with different operators were incorrectly
    considered equal.

  • Properly parse attribute selectors with empty namespaces.

JS API
  • Print more detailed JS stack traces. This is mostly useful for the Sass team's
    own debugging purposes.

v1.43.4

Compare Source

JS API
  • Fix a bug where the logger option was ignored for the render() function.

v1.43.3

Compare Source

  • Improve performance.

v1.43.2

Compare Source

  • Improve the error message when the default namespace of a @use rule is not
    a valid identifier.

v1.42.1

Compare Source

  • Fix a bug where Sass variables and function calls in calculations weren't
    being resolved correctly if there was a parenthesized interpolation elsewhere
    in the file.

v1.42.0

Compare Source

  • min() and max() expressions are once again parsed as calculations as long
    as they contain only syntax that's allowed in calculation expressions. To
    avoid the backwards-compatibility issues that were present in 1.40.0, they now
    allow unitless numbers to be mixed with numbers with units just like the
    global min() and max() functions. Similarly, + and - operations within
    min() and max() functions allow unitless numbers to be mixed with numbers
    with units.

v1.41.1

Compare Source

  • Preserve parentheses around var() functions in calculations, because they
    could potentially be replaced with sub-expressions that might need to be
    parenthesized.

v1.41.0

Compare Source

  • Calculation values can now be combined with strings using the + operator.
    This was an error in 1.40.0, but this broke stylesheets that were relying on
    $value + "" expressions to generically convert values to strings. (Note that
    the Sass team recommends the use of "#{$value}" or inspect($value) for
    that use-case.)

  • The selector.unify() function now correctly returns null when one selector
    is a :host or :host-context and the other is a selector that's guaranteed
    to be within the current shadow DOM. The @extend logic has been updated
    accordingly as well.

  • Fix a bug where extra whitespace in min(), max(), clamp(), and calc()
    expressions could cause bogus parse errors.

  • Fix a bug where the right-hand operand of a - in a calculation could
    incorrectly be stripped of parentheses.

Dart API
  • SassCalculation.plus() now allows SassString arguments.

Configuration

📅 Schedule: Branch creation - "every weekend" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Never, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR has been generated by Mend Renovate. View repository job log here.

@renovate renovate bot requested a review from a team as a code owner March 11, 2023 02:21
@renovate renovate bot requested review from kennylam and RichKummer March 11, 2023 02:21
@ibmdotcom-bot
Copy link
Contributor

@ibmdotcom-bot
Copy link
Contributor

@ibmdotcom-bot
Copy link
Contributor

@ibmdotcom-bot
Copy link
Contributor

@ibmdotcom-bot
Copy link
Contributor

@kennylam kennylam added the Ready to merge Label for the pull requests that are ready to merge label Mar 11, 2023
@kodiakhq kodiakhq bot merged commit 488b83b into main Mar 11, 2023
@kodiakhq kodiakhq bot deleted the renovate/sass-1.x branch March 11, 2023 19:04
@ariellalgilmore
Copy link
Member

The updates to sass are still causing issues with doing @extend
Some examples below:
Screen Shot 2023-03-14 at 8 34 56 AM
Screen Shot 2023-03-14 at 8 35 05 AM

kennylam pushed a commit to kennylam/carbon-for-ibm-dotcom that referenced this pull request Dec 4, 2023
…10221)

[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [sass](https://togithub.com/sass/dart-sass) | [`~1.40.0` -> `~1.59.0`](https://renovatebot.com/diffs/npm/sass/1.40.1/1.59.2) | [![age](https://badges.renovateapi.com/packages/npm/sass/1.59.2/age-slim)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://badges.renovateapi.com/packages/npm/sass/1.59.2/adoption-slim)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://badges.renovateapi.com/packages/npm/sass/1.59.2/compatibility-slim/1.40.1)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://badges.renovateapi.com/packages/npm/sass/1.59.2/confidence-slim/1.40.1)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>sass/dart-sass</summary>

### [`v1.59.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1592)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.59.1...1.59.2)

-   No user-visible changes.

### [`v1.59.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1591)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.59.0...1.59.1)

-   No user-visible changes.

### [`v1.59.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1590)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.3...1.59.0)

##### Command Line Interface

-   Added a new `--fatal-deprecation` flag that lets you treat a deprecation
    warning as an error. You can pass an individual deprecation ID
    (e.g. `slash-div`) or you can pass a Dart Sass version to treat all
    deprecations initially emitted in that version or earlier as errors.

-   New `--future-deprecation` flag that lets you opt into warning for use of
    certain features that will be deprecated in the future. At the moment, the
    only option is `--future-deprecation=import`, which will emit warnings for
    Sass `@import` rules, which are not yet deprecated, but will be in the future.

##### Dart API

-   New `Deprecation` enum, which contains the different current and future
    deprecations used by the new CLI flags.

-   The `compile` methods now take in `fatalDeprecations` and `futureDeprecations`
    parameters, which work similarly to the CLI flags.

### [`v1.58.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1583)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.2...1.58.3)

-   No user-visible changes.

### [`v1.58.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1582)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.1...1.58.2)

##### Command Line Interface

-   Add a timestamp to messages printed in `--watch` mode.

-   Print better `calc()`-based suggestions for `/`-as-division expression that
    contain calculation-incompatible constructs like unary minus.

### [`v1.58.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1581)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.0...1.58.1)

-   Emit a unitless hue when serializing `hsl()` colors. The `deg` unit is
    incompatible with IE, and while that officially falls outside our
    compatibility policy, it's better to lean towards greater compatibility.

### [`v1.58.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1580)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.57.1...1.58.0)

-   Remove sourcemap comments from Sass sources. The generated sourcemap comment
    for the compiled CSS output remains unaffected.

-   Fix a bug in `@extend` logic where certain selectors with three or more
    combinators were incorrectly considered superselectors of similar selectors
    with fewer combinators, causing them to be incorrectly trimmed from the
    output.

-   Produce a better error message for a number with a leading `+` or `-`, a
    decimal point, but no digits.

-   Produce a better error message for a nested property whose name starts with
    `--`.

-   Fix a crash when a selector ends in an escaped backslash.

-   Add the relative length units from CSS Values 4 and CSS Contain 3 as known
    units to validate bad computation in `calc`.

##### Command Line Interface

-   The `--watch` flag will now track loads through calls to `meta.load-css()` as
    long as their URLs are literal strings without any interpolation.

### [`v1.57.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1571)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.57.0...1.57.1)

-   No user-visible changes.

### [`v1.57.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1570)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.56.2...1.57.0)

-   Add a `split($string, $separator, $limit: null)` function to `sass:string`
    that splits a string into separate substrings based on a separator string.

##### JavaScript API

-   **Potentially breaking bug fix**: Custom functions in both the modern and
    legacy API now properly reject signatures with whitespace between the function
    name and parentheses.

-   Custom functions in the legacy API now allow signatures with whitespace before
    the function name, to match a bug in Node Sass.

##### Dart API

-   **Potentially breaking bug fix**: `Callable.fromSignature()` and
    `AsyncCallable.fromSignature()` now reject signatures with whitespace between
    the function name and parentheses.

### [`v1.56.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1562)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.56.1...1.56.2)

##### Embedded Sass

-   The embedded compiler now supports version 1.2.0 of [the embedded
    protocol](https://togithub.com/sass/embedded-protocol).

### [`v1.56.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1561)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.56.0...1.56.1)

##### Embedded Sass

-   Importer results now validate that `contents` is actually a string and whether
    `sourceMapUrl` is an absolute URL.

### [`v1.56.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1560)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.55.0...1.56.0)

-   **Potentially breaking change:** To match the CSS spec, SassScript expressions
    beginning with `not` or `(` are no longer supported at the beginning of
    parenthesized sections of media queries. For example,

    ```scss
    @&carbon-design-system#8203;media (width >= 500px) and (not (grid))
    ```

    will now be emitted unchanged, instead of producing

    ```scss
    @&carbon-design-system#8203;media (width >= 500px) and (false)
    ```

    See [the Sass website](https://sass-lang.com/d/media-logic) for details.

-   **Potentially breaking bug fix:** Angle units like `rad` or `turn` are now
    properly converted to equivalent `deg` values for `hsl()`, `hsla()`,
    `adjust-hue()`, `color.adjust()`, and `color.change()`.

    See [the Sass website](https://sass-lang.com/d/function-units#hue) for
    details.

-   Fix indentation for selectors that span multiple lines in a `@media` query.

-   Emit a deprecation warning when passing `$alpha` values with units to
    `color.adjust()` or `color.change()`. This will be an error in Dart Sass
    2.0.0.

    See [the Sass website](https://sass-lang.com/d/function-units#alpha) for
    details.

-   Emit a deprecation warning when passing a `$weight` value with no units or
    with units other than `%` to `color.mix()`. This will be an error in Dart Sass
    2.0.0.

    See [the Sass website](https://sass-lang.com/d/function-units#weight) for
    details.

-   Emit a deprecation warning when passing `$n` values with units to `list.nth()`
    or `list.set-nth()`. This will be an error in Dart Sass 2.0.0.

    See [the Sass website](https://sass-lang.com/d/function-units#index) for
    details.

-   Improve existing deprecation warnings to wrap `/`-as-division suggestions in
    `calc()` expressions.

-   Properly mark the warning for passing numbers with units to `random()` as a
    deprecation warning.

-   Fix a bug where `@extend` could behave unpredicatably when used along with
    `meta.load-css()` and shared modules that contained no CSS themselves but
    loaded CSS from other modules.

##### Dart API

-   Emit a deprecation warning when passing a `sassIndex` with units to
    `Value.sassIndexToListIndex()`. This will be an error in Dart Sass 2.0.0.

##### JS API

-   Importer results now validate whether `contents` is actually a string type.

-   Importer result argument errors are now rendered correctly.

### [`v1.55.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1550)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.9...1.55.0)

-   **Potentially breaking bug fix:** Sass numbers are now universally stored as
    64-bit floating-point numbers, rather than sometimes being stored as integers.
    This will generally make arithmetic with very large numbers more reliable and
    more consistent across platforms, but it does mean that numbers between nine
    quadrillion and nine quintillion will no longer be represented with full
    accuracy when compiling Sass on the Dart VM.

-   **Potentially breaking bug fix:** Sass equality is now properly [transitive].
    Two numbers are now considered equal (after doing unit conversions) if they
    round to the same `1e-11`th. Previously, numbers were considered equal if they
    were within `1e-11` of one another, which led to some circumstances where `$a == $b` and `$b == $c` but `$a != $b`.

[transitive]: https://en.wikipedia.org/wiki/Transitive_property

-   **Potentially breaking bug fix:** Various functions in `sass:math` no longer
    treat floating-point numbers that are very close (but not identical) to
    integers as integers. Instead, these functions now follow the floating-point
    specification exactly. For example, `math.pow(0.000000000001, -1)` now returns
    `1000000000000` instead of `Infinity`.

-   Emit a deprecation warning for `$a -$b` and `$a +$b`, since these look like
    they could be unary operations but they're actually parsed as binary
    operations. Either explicitly write `$a - $b` or `$a (-$b)`. See
    https://sass-lang.com/d/strict-unary for more details.

##### Dart API

-   Add an optional `argumentName` parameter to `SassScriptException()` to make it
    easier to throw exceptions associated with particular argument names.

-   Most APIs that previously returned `num` now return `double`. All APIs
    continue to *accept* `num`, although in Dart 2.0.0 these APIs will be changed
    to accept only `double`.

##### JS API

-   Fix a bug in which certain warning spans would not have their properties
    accessible by the JS API.

### [`v1.54.9`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1549)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.8...1.54.9)

-   Fix an incorrect span in certain `@media` query deprecation warnings.

### [`v1.54.8`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1548)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.7...1.54.8)

-   No user-visible changes.

### [`v1.54.7`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1547)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.6...1.54.7)

-   Add support for 32-bit ARM releases on Linux.

### [`v1.54.6`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1546)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.5...1.54.6)

-   Fix a bug where a `@media` query could be incorrectly omitted from a
    stylesheet if it had multiple levels of nested `@media` queries within it
    *and* the inner queries were mergeable but the outer query was not.

### [`v1.54.5`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1545)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.4...1.54.5)

-   Properly consider `a ~ c` to be a superselector of `a ~ b ~ c` and `a + b +
    c`.

-   Properly consider `b > c` to be a superselector of `a > b > c`, and similarly
    for other combinators.

-   Properly calculate specificity for selector pseudoclasses.

-   Deprecate use of `random()` when `$limit` has units to make it explicit that
    `random()` currently ignores units. A future version will no longer ignore
    units.

-   Don't throw an error when the same module is `@forward`ed multiple times
    through a configured module.

##### Embedded Sass

-   Rather than downloading the embedded compiler for the local platform on
    install, the `sass-embedded` npm package now declares optional dependencies on
    platform-specific embedded compiler packages.

### [`v1.54.4`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1544)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.3...1.54.4)

-   Improve error messages when passing incorrect units that are also
    out-of-bounds to various color functions.

### [`v1.54.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1543)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.2...1.54.3)

-   Release a native ARM64 executable for Mac OS.

### [`v1.54.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1542)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.1...1.54.2)

-   No user-visible changes.

### [`v1.54.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1541)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.0...1.54.1)

-   When unifying selectors for `@extend` and `selector.unify()`, ensure that
    `:root`, `:scope`, `:host`, and `:host-context` only appear at the beginning
    of complex selectors.

### [`v1.54.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1540)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.53.0...1.54.0)

-   Deprecate selectors with leading or trailing combinators, or with multiple
    combinators in a row. If they're included in style rules after nesting is
    resolved, Sass will now produce a deprecation warning and, in most cases, omit
    the selector. Leading and trailing combinators can still be freely used for
    nesting purposes.

    See https://sass-lang.com/d/bogus-combinators for more details.

-   Add partial support for new media query syntax from Media Queries Level 4. The
    only exception are logical operations nested within parentheses, as these were
    previously interpreted differently as SassScript expressions.

    A parenthesized media condition that begins with `not` or an opening
    parenthesis now produces a deprecation warning. In a future release, these
    will be interpreted as plain CSS instead.

-   Deprecate passing non-`deg` units to `color.hwb()`'s `$hue` argument.

-   Fix a number of bugs when determining whether selectors with pseudo-elements
    are superselectors.

-   Treat `*` as a superselector of all selectors.

##### Dart API

-   Add a top-level `fakeFromImport()` function for testing custom importers
    that use `AsyncImporter.fromImport`.

##### JS API

-   Add a `charset` option that controls whether or not Sass emits a
    `@charset`/BOM for non-ASCII stylesheets.

-   Fix Sass npm package types for TS 4.7+ Node16 and NodeNext module resolution.

### [`v1.53.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1530)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.3...1.53.0)

-   Add support for calling `var()` with an empty second argument, such as
    `var(--side, )`.

##### JS API

-   Fix a bug where `meta.load-css()` would sometimes resolve relative URLs
    incorrectly when called from a mixin using the legacy JS API.

##### Embedded Sass

-   Respect npm's proxy settings when downloading the embedded Sass compiler.

### [`v1.52.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1523)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.2...1.52.3)

-   Fix crash when trailing loud comments (`/* ... */`) appear twice in a row
    across two different imports which themselves imported the same file each.

### [`v1.52.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1522)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.1...1.52.2)

-   Preserve location of trailing loud comments (`/* ... */`) instead of pushing
    the comment to the next line.

### [`v1.52.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1521)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.0...1.52.1)

##### Command Line Interface

-   Fix a bug where `--watch` mode would close immediately in TTY mode. This was
    caused by our change to close `--watch` when stdin was closed *outside of* TTY
    mode, which has been reverted for now while we work on a fix.

### [`v1.52.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1520)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.51.0...1.52.0)

-   Add support for arbitrary modifiers at the end of plain CSS imports, in
    addition to the existing `supports()` and media queries. Sass now allows any
    sequence of identifiers of functions after the URL of an import for forwards
    compatibility with future additions to the CSS spec.

-   Fix an issue where source locations tracked through variable references could
    potentially become incorrect.

-   Fix a bug where a loud comment in the source can break the source map when
    embedding the sources, when using the command-line interface or the legacy JS
    API.

##### JS API

-   `SassNumber.assertUnit()` and `SassNumber.assertNoUnits()` now correctly
    return the number called on when it passes the assertion.

### [`v1.51.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1510)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.50.1...1.51.0)

-   **Potentially breaking change**: Change the order of maps returned by
    `map.deep-merge()` to match those returned by `map.merge()`. All keys that
    appeared in the first map will now be listed first in the same order they
    appeared in that map, followed by any new keys added from the second map.

-   Improve the string output of some AST nodes in error messages.

### [`v1.50.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1501)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.50.0...1.50.1)

##### Embedded Sass

-   The JS embedded host and the embedded compiler will now properly avoid
    resolving imports relative to the current working directory unless `'.'` is
    passed as a load path.

-   Fix a bug in the JS embedded host's implementation of the legacy JS API where
    imports that began with `/` could crash on Windows.

### [`v1.50.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1500)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.11...1.50.0)

-   `@extend` now treats [`:where()`][:where()] the same as `:is()`.

[`:where()`]: https://developer.mozilla.org/en-US/docs/Web/CSS/:where

##### Command Line Interface

-   Closing the standard input stream will now cause the `--watch` command to stop
    running.

##### Embedded Sass

-   Fix a bug where the JS embedded host crashed when invoking a legacy importer
    after resolving a relative filesystem import.

-   Improve error messages when returning non-`Object` values from legacy
    importers.

### [`v1.49.11`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;14911)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.10...1.49.11)

-   Add support for 64-bit ARM releases on Linux.

##### Embedded Sass

-   The embedded compiler now correctly sets the `id` field for all
    `OutboundMessage`s.

### [`v1.49.10`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;14910)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.9...1.49.10)

-   Quiet deps mode now silences compiler warnings in mixins and functions that
    are defined in dependencies even if they're invoked from application
    stylesheets.

-   In expanded mode, Sass will now emit colors using `rgb()`, `rbga()`, `hsl()`,
    and `hsla()` function notation if they were defined using the corresponding
    notation. As per our browser support policy, this change was only done once
    95% of browsers were confirmed to support this output format, and so is not
    considered a breaking change.

    Note that this output format is intended for human readability and not for
    interoperability with other tools. As always, Sass targets the CSS
    specification, and any tool that consumes Sass's output should parse all
    colors that are supported by the CSS spec.

-   Fix a bug in which a color written using the four- or eight-digit hex format
    could be emitted as a hex color rather than a format with higher browser
    compatibility.

-   Calculations are no longer simplified within supports declarations

### [`v1.49.9`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1499)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.8...1.49.9)

##### Embedded Sass

-   Fixed a bug where the legacy API could crash when passed an empty importer
    list.

### [`v1.49.8`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1498)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.7...1.49.8)

-   Fixed a bug where some plain CSS imports would not be emitted.

##### JS API

-   Fix a bug where inspecting the Sass module in the Node.js console crashed on
    Node 17.

##### Embedded Sass

-   Fix a bug where source map URLs were incorrectly generated when passing
    importers to the legacy API.

### [`v1.49.7`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1497)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.6...1.49.7)

##### Embedded Sass

-   First stable release the `sass-embedded` npm package that contains the Node.js
    Embedded Host.

-   First stable release of the `sass_embedded` pub package that contains the
    Embedded Dart Sass compiler.

### [`v1.49.6`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1496)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.5...1.49.6)

-   No user-visible changes.

### [`v1.49.5`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1495)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.4...1.49.5)

-   No user-visible changes.

### [`v1.49.4`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1494)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.3...1.49.4)

-   No user-visible changes.

### [`v1.49.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1493)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.2...1.49.3)

-   No user-visible changes.

### [`v1.49.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1492)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.1...1.49.2)

-   No user-visible changes.

### [`v1.49.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;14911)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.0...1.49.1)

-   Add support for 64-bit ARM releases on Linux.

##### Embedded Sass

-   The embedded compiler now correctly sets the `id` field for all
    `OutboundMessage`s.

### [`v1.49.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1490)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.48.0...1.49.0)

-   Fix a bug in `string.insert` with certain negative indices.

##### JS API

-   Add support for the `sourceMapIncludeSources` option in the new JS API.

##### TypeScript Declarations

-   Fix a bug where `LegacyPluginThis.options.linefeed` was typed to return
    abbreviations when it actually returned literal linefeed characters.

### [`v1.48.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1480)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.47.0...1.48.0)

##### JS API

-   **Potentially breaking bug fix:** Match the specification of the new JS API by
    setting `LegacyResult.map` to `undefined` rather than `null`.

##### TypeScript Declarations

-   Add a declaration for the `NULL` constant.

### [`v1.47.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1470)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.46.0...1.47.0)

##### JS API

##### TypeScript Declarations

-   Add declarations for the `TRUE` and `FALSE` constants.

### [`v1.46.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1460)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.45.2...1.46.0)

##### JS API

-   **Potentially breaking bug fix:** Match the specification of the new JS API by
    passing `undefined` rather than `null` to `Logger.warn()` for an unset `span`.

##### TypeScript Declarations

-   Add a declaration for the `LegacyPluginThis.options.context` field.

-   Update the definition of `LegacyAsyncFunction` to include explicit definitions
    with zero through six arguments before the `done` parameter. This makes it
    possible for TypeScript users to pass in callbacks that take a specific number
    of arguments, rather than having to declare a callback that takes an arbitrary
    number.

-   Add a declaration for `types.Error`, a legacy API class that can be returned
    by asynchronous functions to signal asynchronous errors.

-   Add a `LegacyAsyncFunctionDone` type for the `done` callback that's passed to
    `LegacyAsyncFunction`.

### [`v1.45.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1452)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.45.1...1.45.2)

##### JS API

-   **Potentially breaking bug fix:** Change the default value of the `separator`
    parameter for `new SassArgumentList()` to `','` rather than `null`. This
    matches the API specification.

### [`v1.45.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1451)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.45.0...1.45.1)

-   **Potentially breaking bug fix:** Properly parse custom properties in
    `@supports` conditions. Note that this means that SassScript expressions on
    the right-hand side of custom property `@supports` queries now need to be
    interpolated, as per https://sass-lang.com/d/css-vars.

-   **Potentially breaking bug fix:** Fix a bug where `inspect()` was not
    properly printing nested, empty, bracketed lists.

### [`v1.45.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1450)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.44.0...1.45.0)

##### JS API

This release includes an entirely new JavaScript API, designed to be more
idiomatic, performant, and usable. The old API will continue to be supported
until Dart Sass 2.0.0, but it is now considered deprecated and should be avoided
for new code.

The new API includes:

-   `compile()` and `compileAsync()` functions that take Sass file paths and
    return the result of compiling them to CSS. The async function returns a
    `Promise` rather than using a callback-based API.

-   `compileString()` and `compileStringAsync()` functions that take a string of
    Sass source and compiles it to CSS. As above, the async function returns a
    `Promise`.

-   A new importer API that more closely matches the Sass specification's logic
    for resolving loads. This makes it much easier for Sass to cache information
    across `@import` and `@use` rules, which substantially improves performance
    for applications that rely heavily on repeated `@import`s.

-   A new custom function API, including much more usable JS representations of
    Sass value types complete with type-assertion functions, easy map and list
    lookups, and compatibility with the [`immutable`][immutable] package. **Unlike in the
    legacy API,** function callbacks now take one argument which contains an array
    of Sass values (rather than taking a separate JS argument for each Sass
    argument).

[`immutable`]: https://immutable-js.com/

For full documentation of this API, please see [the Sass website][js-api].

[js-api]: https://sass-lang.com/documentation/js-api

This release also adds TypeScript type definitions.

### [`v1.44.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1440)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.5...1.44.0)

-   Suggest `calc()` as an alternative in `/`-as-division deprecation messages.

##### Dart API

-   Add `SassNumber.convert()` and `SassNumber.convertValue()`. These work like
    `SassNumber.coerce()` and `SassNumber.coerceValue()`, except they don't treat
    unitless numbers as universally compatible.

-   Fix a bug where `SassNumber.coerceToMatch()` and
    `SassNumber.coerceValueToMatch()` wouldn't coerce single-unit numbers to
    match unitless numbers.

### [`v1.43.5`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1435)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.4...1.43.5)

-   Fix a bug where calculations with different operators were incorrectly
    considered equal.

-   Properly parse attribute selectors with empty namespaces.

##### JS API

-   Print more detailed JS stack traces. This is mostly useful for the Sass team's
    own debugging purposes.

### [`v1.43.4`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1434)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.3...1.43.4)

##### JS API

-   Fix a bug where the `logger` option was ignored for the `render()` function.

### [`v1.43.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1433)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.2...1.43.3)

-   Improve performance.

### [`v1.43.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1432)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.42.1...1.43.2)

-   Improve the error message when the default namespace of a `@use` rule is not
    a valid identifier.

### [`v1.42.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1421)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.42.0...1.42.1)

-   Fix a bug where Sass variables and function calls in calculations weren't
    being resolved correctly if there was a parenthesized interpolation elsewhere
    in the file.

### [`v1.42.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1420)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.41.1...1.42.0)

-   `min()` and `max()` expressions are once again parsed as calculations as long
    as they contain only syntax that's allowed in calculation expressions. To
    avoid the backwards-compatibility issues that were present in 1.40.0, they now
    allow unitless numbers to be mixed with numbers with units just like the
    global `min()` and `max()` functions. Similarly, `+` and `-` operations within
    `min()` and `max()` functions allow unitless numbers to be mixed with numbers
    with units.

### [`v1.41.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1411)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.41.0...1.41.1)

-   Preserve parentheses around `var()` functions in calculations, because they
    could potentially be replaced with sub-expressions that might need to be
    parenthesized.

### [`v1.41.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1410)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.40.1...1.41.0)

-   Calculation values can now be combined with strings using the `+` operator.
    This was an error in 1.40.0, but this broke stylesheets that were relying on
    `$value + ""` expressions to generically convert values to strings. (Note that
    the Sass team recommends the use of `"#{$value}"` or `inspect($value)` for
    that use-case.)

-   The `selector.unify()` function now correctly returns `null` when one selector
    is a `:host` or `:host-context` and the other is a selector that's guaranteed
    to be within the current shadow DOM. The `@extend` logic has been updated
    accordingly as well.

-   Fix a bug where extra whitespace in `min()`, `max()`, `clamp()`, and `calc()`
    expressions could cause bogus parse errors.

-   Fix a bug where the right-hand operand of a `-` in a calculation could
    incorrectly be stripped of parentheses.

##### Dart API

-   `SassCalculation.plus()` now allows `SassString` arguments.

</details>

---

### Configuration

📅 **Schedule**: Branch creation - "every weekend" (UTC), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Never, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://app.renovatebot.com/dashboard#github/carbon-design-system/carbon-for-ibm-dotcom).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNC4xNjAuMCIsInVwZGF0ZWRJblZlciI6IjM0LjE2MC4wIn0=-->
kennylam pushed a commit to kennylam/carbon-for-ibm-dotcom that referenced this pull request Jun 11, 2024
…10221)

[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [sass](https://togithub.com/sass/dart-sass) | [`~1.40.0` -> `~1.59.0`](https://renovatebot.com/diffs/npm/sass/1.40.1/1.59.2) | [![age](https://badges.renovateapi.com/packages/npm/sass/1.59.2/age-slim)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://badges.renovateapi.com/packages/npm/sass/1.59.2/adoption-slim)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://badges.renovateapi.com/packages/npm/sass/1.59.2/compatibility-slim/1.40.1)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://badges.renovateapi.com/packages/npm/sass/1.59.2/confidence-slim/1.40.1)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>sass/dart-sass</summary>

### [`v1.59.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1592)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.59.1...1.59.2)

-   No user-visible changes.

### [`v1.59.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1591)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.59.0...1.59.1)

-   No user-visible changes.

### [`v1.59.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1590)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.3...1.59.0)

##### Command Line Interface

-   Added a new `--fatal-deprecation` flag that lets you treat a deprecation
    warning as an error. You can pass an individual deprecation ID
    (e.g. `slash-div`) or you can pass a Dart Sass version to treat all
    deprecations initially emitted in that version or earlier as errors.

-   New `--future-deprecation` flag that lets you opt into warning for use of
    certain features that will be deprecated in the future. At the moment, the
    only option is `--future-deprecation=import`, which will emit warnings for
    Sass `@import` rules, which are not yet deprecated, but will be in the future.

##### Dart API

-   New `Deprecation` enum, which contains the different current and future
    deprecations used by the new CLI flags.

-   The `compile` methods now take in `fatalDeprecations` and `futureDeprecations`
    parameters, which work similarly to the CLI flags.

### [`v1.58.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1583)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.2...1.58.3)

-   No user-visible changes.

### [`v1.58.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1582)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.1...1.58.2)

##### Command Line Interface

-   Add a timestamp to messages printed in `--watch` mode.

-   Print better `calc()`-based suggestions for `/`-as-division expression that
    contain calculation-incompatible constructs like unary minus.

### [`v1.58.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1581)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.58.0...1.58.1)

-   Emit a unitless hue when serializing `hsl()` colors. The `deg` unit is
    incompatible with IE, and while that officially falls outside our
    compatibility policy, it's better to lean towards greater compatibility.

### [`v1.58.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1580)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.57.1...1.58.0)

-   Remove sourcemap comments from Sass sources. The generated sourcemap comment
    for the compiled CSS output remains unaffected.

-   Fix a bug in `@extend` logic where certain selectors with three or more
    combinators were incorrectly considered superselectors of similar selectors
    with fewer combinators, causing them to be incorrectly trimmed from the
    output.

-   Produce a better error message for a number with a leading `+` or `-`, a
    decimal point, but no digits.

-   Produce a better error message for a nested property whose name starts with
    `--`.

-   Fix a crash when a selector ends in an escaped backslash.

-   Add the relative length units from CSS Values 4 and CSS Contain 3 as known
    units to validate bad computation in `calc`.

##### Command Line Interface

-   The `--watch` flag will now track loads through calls to `meta.load-css()` as
    long as their URLs are literal strings without any interpolation.

### [`v1.57.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1571)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.57.0...1.57.1)

-   No user-visible changes.

### [`v1.57.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1570)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.56.2...1.57.0)

-   Add a `split($string, $separator, $limit: null)` function to `sass:string`
    that splits a string into separate substrings based on a separator string.

##### JavaScript API

-   **Potentially breaking bug fix**: Custom functions in both the modern and
    legacy API now properly reject signatures with whitespace between the function
    name and parentheses.

-   Custom functions in the legacy API now allow signatures with whitespace before
    the function name, to match a bug in Node Sass.

##### Dart API

-   **Potentially breaking bug fix**: `Callable.fromSignature()` and
    `AsyncCallable.fromSignature()` now reject signatures with whitespace between
    the function name and parentheses.

### [`v1.56.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1562)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.56.1...1.56.2)

##### Embedded Sass

-   The embedded compiler now supports version 1.2.0 of [the embedded
    protocol](https://togithub.com/sass/embedded-protocol).

### [`v1.56.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1561)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.56.0...1.56.1)

##### Embedded Sass

-   Importer results now validate that `contents` is actually a string and whether
    `sourceMapUrl` is an absolute URL.

### [`v1.56.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1560)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.55.0...1.56.0)

-   **Potentially breaking change:** To match the CSS spec, SassScript expressions
    beginning with `not` or `(` are no longer supported at the beginning of
    parenthesized sections of media queries. For example,

    ```scss
    @&carbon-design-system#8203;media (width >= 500px) and (not (grid))
    ```

    will now be emitted unchanged, instead of producing

    ```scss
    @&carbon-design-system#8203;media (width >= 500px) and (false)
    ```

    See [the Sass website](https://sass-lang.com/d/media-logic) for details.

-   **Potentially breaking bug fix:** Angle units like `rad` or `turn` are now
    properly converted to equivalent `deg` values for `hsl()`, `hsla()`,
    `adjust-hue()`, `color.adjust()`, and `color.change()`.

    See [the Sass website](https://sass-lang.com/d/function-units#hue) for
    details.

-   Fix indentation for selectors that span multiple lines in a `@media` query.

-   Emit a deprecation warning when passing `$alpha` values with units to
    `color.adjust()` or `color.change()`. This will be an error in Dart Sass
    2.0.0.

    See [the Sass website](https://sass-lang.com/d/function-units#alpha) for
    details.

-   Emit a deprecation warning when passing a `$weight` value with no units or
    with units other than `%` to `color.mix()`. This will be an error in Dart Sass
    2.0.0.

    See [the Sass website](https://sass-lang.com/d/function-units#weight) for
    details.

-   Emit a deprecation warning when passing `$n` values with units to `list.nth()`
    or `list.set-nth()`. This will be an error in Dart Sass 2.0.0.

    See [the Sass website](https://sass-lang.com/d/function-units#index) for
    details.

-   Improve existing deprecation warnings to wrap `/`-as-division suggestions in
    `calc()` expressions.

-   Properly mark the warning for passing numbers with units to `random()` as a
    deprecation warning.

-   Fix a bug where `@extend` could behave unpredicatably when used along with
    `meta.load-css()` and shared modules that contained no CSS themselves but
    loaded CSS from other modules.

##### Dart API

-   Emit a deprecation warning when passing a `sassIndex` with units to
    `Value.sassIndexToListIndex()`. This will be an error in Dart Sass 2.0.0.

##### JS API

-   Importer results now validate whether `contents` is actually a string type.

-   Importer result argument errors are now rendered correctly.

### [`v1.55.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1550)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.9...1.55.0)

-   **Potentially breaking bug fix:** Sass numbers are now universally stored as
    64-bit floating-point numbers, rather than sometimes being stored as integers.
    This will generally make arithmetic with very large numbers more reliable and
    more consistent across platforms, but it does mean that numbers between nine
    quadrillion and nine quintillion will no longer be represented with full
    accuracy when compiling Sass on the Dart VM.

-   **Potentially breaking bug fix:** Sass equality is now properly [transitive].
    Two numbers are now considered equal (after doing unit conversions) if they
    round to the same `1e-11`th. Previously, numbers were considered equal if they
    were within `1e-11` of one another, which led to some circumstances where `$a == $b` and `$b == $c` but `$a != $b`.

[transitive]: https://en.wikipedia.org/wiki/Transitive_property

-   **Potentially breaking bug fix:** Various functions in `sass:math` no longer
    treat floating-point numbers that are very close (but not identical) to
    integers as integers. Instead, these functions now follow the floating-point
    specification exactly. For example, `math.pow(0.000000000001, -1)` now returns
    `1000000000000` instead of `Infinity`.

-   Emit a deprecation warning for `$a -$b` and `$a +$b`, since these look like
    they could be unary operations but they're actually parsed as binary
    operations. Either explicitly write `$a - $b` or `$a (-$b)`. See
    https://sass-lang.com/d/strict-unary for more details.

##### Dart API

-   Add an optional `argumentName` parameter to `SassScriptException()` to make it
    easier to throw exceptions associated with particular argument names.

-   Most APIs that previously returned `num` now return `double`. All APIs
    continue to *accept* `num`, although in Dart 2.0.0 these APIs will be changed
    to accept only `double`.

##### JS API

-   Fix a bug in which certain warning spans would not have their properties
    accessible by the JS API.

### [`v1.54.9`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1549)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.8...1.54.9)

-   Fix an incorrect span in certain `@media` query deprecation warnings.

### [`v1.54.8`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1548)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.7...1.54.8)

-   No user-visible changes.

### [`v1.54.7`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1547)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.6...1.54.7)

-   Add support for 32-bit ARM releases on Linux.

### [`v1.54.6`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1546)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.5...1.54.6)

-   Fix a bug where a `@media` query could be incorrectly omitted from a
    stylesheet if it had multiple levels of nested `@media` queries within it
    *and* the inner queries were mergeable but the outer query was not.

### [`v1.54.5`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1545)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.4...1.54.5)

-   Properly consider `a ~ c` to be a superselector of `a ~ b ~ c` and `a + b +
    c`.

-   Properly consider `b > c` to be a superselector of `a > b > c`, and similarly
    for other combinators.

-   Properly calculate specificity for selector pseudoclasses.

-   Deprecate use of `random()` when `$limit` has units to make it explicit that
    `random()` currently ignores units. A future version will no longer ignore
    units.

-   Don't throw an error when the same module is `@forward`ed multiple times
    through a configured module.

##### Embedded Sass

-   Rather than downloading the embedded compiler for the local platform on
    install, the `sass-embedded` npm package now declares optional dependencies on
    platform-specific embedded compiler packages.

### [`v1.54.4`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1544)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.3...1.54.4)

-   Improve error messages when passing incorrect units that are also
    out-of-bounds to various color functions.

### [`v1.54.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1543)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.2...1.54.3)

-   Release a native ARM64 executable for Mac OS.

### [`v1.54.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1542)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.1...1.54.2)

-   No user-visible changes.

### [`v1.54.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1541)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.54.0...1.54.1)

-   When unifying selectors for `@extend` and `selector.unify()`, ensure that
    `:root`, `:scope`, `:host`, and `:host-context` only appear at the beginning
    of complex selectors.

### [`v1.54.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1540)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.53.0...1.54.0)

-   Deprecate selectors with leading or trailing combinators, or with multiple
    combinators in a row. If they're included in style rules after nesting is
    resolved, Sass will now produce a deprecation warning and, in most cases, omit
    the selector. Leading and trailing combinators can still be freely used for
    nesting purposes.

    See https://sass-lang.com/d/bogus-combinators for more details.

-   Add partial support for new media query syntax from Media Queries Level 4. The
    only exception are logical operations nested within parentheses, as these were
    previously interpreted differently as SassScript expressions.

    A parenthesized media condition that begins with `not` or an opening
    parenthesis now produces a deprecation warning. In a future release, these
    will be interpreted as plain CSS instead.

-   Deprecate passing non-`deg` units to `color.hwb()`'s `$hue` argument.

-   Fix a number of bugs when determining whether selectors with pseudo-elements
    are superselectors.

-   Treat `*` as a superselector of all selectors.

##### Dart API

-   Add a top-level `fakeFromImport()` function for testing custom importers
    that use `AsyncImporter.fromImport`.

##### JS API

-   Add a `charset` option that controls whether or not Sass emits a
    `@charset`/BOM for non-ASCII stylesheets.

-   Fix Sass npm package types for TS 4.7+ Node16 and NodeNext module resolution.

### [`v1.53.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1530)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.3...1.53.0)

-   Add support for calling `var()` with an empty second argument, such as
    `var(--side, )`.

##### JS API

-   Fix a bug where `meta.load-css()` would sometimes resolve relative URLs
    incorrectly when called from a mixin using the legacy JS API.

##### Embedded Sass

-   Respect npm's proxy settings when downloading the embedded Sass compiler.

### [`v1.52.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1523)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.2...1.52.3)

-   Fix crash when trailing loud comments (`/* ... */`) appear twice in a row
    across two different imports which themselves imported the same file each.

### [`v1.52.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1522)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.1...1.52.2)

-   Preserve location of trailing loud comments (`/* ... */`) instead of pushing
    the comment to the next line.

### [`v1.52.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1521)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.52.0...1.52.1)

##### Command Line Interface

-   Fix a bug where `--watch` mode would close immediately in TTY mode. This was
    caused by our change to close `--watch` when stdin was closed *outside of* TTY
    mode, which has been reverted for now while we work on a fix.

### [`v1.52.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1520)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.51.0...1.52.0)

-   Add support for arbitrary modifiers at the end of plain CSS imports, in
    addition to the existing `supports()` and media queries. Sass now allows any
    sequence of identifiers of functions after the URL of an import for forwards
    compatibility with future additions to the CSS spec.

-   Fix an issue where source locations tracked through variable references could
    potentially become incorrect.

-   Fix a bug where a loud comment in the source can break the source map when
    embedding the sources, when using the command-line interface or the legacy JS
    API.

##### JS API

-   `SassNumber.assertUnit()` and `SassNumber.assertNoUnits()` now correctly
    return the number called on when it passes the assertion.

### [`v1.51.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1510)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.50.1...1.51.0)

-   **Potentially breaking change**: Change the order of maps returned by
    `map.deep-merge()` to match those returned by `map.merge()`. All keys that
    appeared in the first map will now be listed first in the same order they
    appeared in that map, followed by any new keys added from the second map.

-   Improve the string output of some AST nodes in error messages.

### [`v1.50.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1501)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.50.0...1.50.1)

##### Embedded Sass

-   The JS embedded host and the embedded compiler will now properly avoid
    resolving imports relative to the current working directory unless `'.'` is
    passed as a load path.

-   Fix a bug in the JS embedded host's implementation of the legacy JS API where
    imports that began with `/` could crash on Windows.

### [`v1.50.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1500)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.11...1.50.0)

-   `@extend` now treats [`:where()`][:where()] the same as `:is()`.

[`:where()`]: https://developer.mozilla.org/en-US/docs/Web/CSS/:where

##### Command Line Interface

-   Closing the standard input stream will now cause the `--watch` command to stop
    running.

##### Embedded Sass

-   Fix a bug where the JS embedded host crashed when invoking a legacy importer
    after resolving a relative filesystem import.

-   Improve error messages when returning non-`Object` values from legacy
    importers.

### [`v1.49.11`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;14911)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.10...1.49.11)

-   Add support for 64-bit ARM releases on Linux.

##### Embedded Sass

-   The embedded compiler now correctly sets the `id` field for all
    `OutboundMessage`s.

### [`v1.49.10`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;14910)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.9...1.49.10)

-   Quiet deps mode now silences compiler warnings in mixins and functions that
    are defined in dependencies even if they're invoked from application
    stylesheets.

-   In expanded mode, Sass will now emit colors using `rgb()`, `rbga()`, `hsl()`,
    and `hsla()` function notation if they were defined using the corresponding
    notation. As per our browser support policy, this change was only done once
    95% of browsers were confirmed to support this output format, and so is not
    considered a breaking change.

    Note that this output format is intended for human readability and not for
    interoperability with other tools. As always, Sass targets the CSS
    specification, and any tool that consumes Sass's output should parse all
    colors that are supported by the CSS spec.

-   Fix a bug in which a color written using the four- or eight-digit hex format
    could be emitted as a hex color rather than a format with higher browser
    compatibility.

-   Calculations are no longer simplified within supports declarations

### [`v1.49.9`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1499)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.8...1.49.9)

##### Embedded Sass

-   Fixed a bug where the legacy API could crash when passed an empty importer
    list.

### [`v1.49.8`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1498)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.7...1.49.8)

-   Fixed a bug where some plain CSS imports would not be emitted.

##### JS API

-   Fix a bug where inspecting the Sass module in the Node.js console crashed on
    Node 17.

##### Embedded Sass

-   Fix a bug where source map URLs were incorrectly generated when passing
    importers to the legacy API.

### [`v1.49.7`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1497)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.6...1.49.7)

##### Embedded Sass

-   First stable release the `sass-embedded` npm package that contains the Node.js
    Embedded Host.

-   First stable release of the `sass_embedded` pub package that contains the
    Embedded Dart Sass compiler.

### [`v1.49.6`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1496)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.5...1.49.6)

-   No user-visible changes.

### [`v1.49.5`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1495)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.4...1.49.5)

-   No user-visible changes.

### [`v1.49.4`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1494)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.3...1.49.4)

-   No user-visible changes.

### [`v1.49.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1493)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.2...1.49.3)

-   No user-visible changes.

### [`v1.49.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1492)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.1...1.49.2)

-   No user-visible changes.

### [`v1.49.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;14911)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.49.0...1.49.1)

-   Add support for 64-bit ARM releases on Linux.

##### Embedded Sass

-   The embedded compiler now correctly sets the `id` field for all
    `OutboundMessage`s.

### [`v1.49.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1490)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.48.0...1.49.0)

-   Fix a bug in `string.insert` with certain negative indices.

##### JS API

-   Add support for the `sourceMapIncludeSources` option in the new JS API.

##### TypeScript Declarations

-   Fix a bug where `LegacyPluginThis.options.linefeed` was typed to return
    abbreviations when it actually returned literal linefeed characters.

### [`v1.48.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1480)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.47.0...1.48.0)

##### JS API

-   **Potentially breaking bug fix:** Match the specification of the new JS API by
    setting `LegacyResult.map` to `undefined` rather than `null`.

##### TypeScript Declarations

-   Add a declaration for the `NULL` constant.

### [`v1.47.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1470)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.46.0...1.47.0)

##### JS API

##### TypeScript Declarations

-   Add declarations for the `TRUE` and `FALSE` constants.

### [`v1.46.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1460)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.45.2...1.46.0)

##### JS API

-   **Potentially breaking bug fix:** Match the specification of the new JS API by
    passing `undefined` rather than `null` to `Logger.warn()` for an unset `span`.

##### TypeScript Declarations

-   Add a declaration for the `LegacyPluginThis.options.context` field.

-   Update the definition of `LegacyAsyncFunction` to include explicit definitions
    with zero through six arguments before the `done` parameter. This makes it
    possible for TypeScript users to pass in callbacks that take a specific number
    of arguments, rather than having to declare a callback that takes an arbitrary
    number.

-   Add a declaration for `types.Error`, a legacy API class that can be returned
    by asynchronous functions to signal asynchronous errors.

-   Add a `LegacyAsyncFunctionDone` type for the `done` callback that's passed to
    `LegacyAsyncFunction`.

### [`v1.45.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1452)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.45.1...1.45.2)

##### JS API

-   **Potentially breaking bug fix:** Change the default value of the `separator`
    parameter for `new SassArgumentList()` to `','` rather than `null`. This
    matches the API specification.

### [`v1.45.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1451)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.45.0...1.45.1)

-   **Potentially breaking bug fix:** Properly parse custom properties in
    `@supports` conditions. Note that this means that SassScript expressions on
    the right-hand side of custom property `@supports` queries now need to be
    interpolated, as per https://sass-lang.com/d/css-vars.

-   **Potentially breaking bug fix:** Fix a bug where `inspect()` was not
    properly printing nested, empty, bracketed lists.

### [`v1.45.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1450)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.44.0...1.45.0)

##### JS API

This release includes an entirely new JavaScript API, designed to be more
idiomatic, performant, and usable. The old API will continue to be supported
until Dart Sass 2.0.0, but it is now considered deprecated and should be avoided
for new code.

The new API includes:

-   `compile()` and `compileAsync()` functions that take Sass file paths and
    return the result of compiling them to CSS. The async function returns a
    `Promise` rather than using a callback-based API.

-   `compileString()` and `compileStringAsync()` functions that take a string of
    Sass source and compiles it to CSS. As above, the async function returns a
    `Promise`.

-   A new importer API that more closely matches the Sass specification's logic
    for resolving loads. This makes it much easier for Sass to cache information
    across `@import` and `@use` rules, which substantially improves performance
    for applications that rely heavily on repeated `@import`s.

-   A new custom function API, including much more usable JS representations of
    Sass value types complete with type-assertion functions, easy map and list
    lookups, and compatibility with the [`immutable`][immutable] package. **Unlike in the
    legacy API,** function callbacks now take one argument which contains an array
    of Sass values (rather than taking a separate JS argument for each Sass
    argument).

[`immutable`]: https://immutable-js.com/

For full documentation of this API, please see [the Sass website][js-api].

[js-api]: https://sass-lang.com/documentation/js-api

This release also adds TypeScript type definitions.

### [`v1.44.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1440)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.5...1.44.0)

-   Suggest `calc()` as an alternative in `/`-as-division deprecation messages.

##### Dart API

-   Add `SassNumber.convert()` and `SassNumber.convertValue()`. These work like
    `SassNumber.coerce()` and `SassNumber.coerceValue()`, except they don't treat
    unitless numbers as universally compatible.

-   Fix a bug where `SassNumber.coerceToMatch()` and
    `SassNumber.coerceValueToMatch()` wouldn't coerce single-unit numbers to
    match unitless numbers.

### [`v1.43.5`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1435)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.4...1.43.5)

-   Fix a bug where calculations with different operators were incorrectly
    considered equal.

-   Properly parse attribute selectors with empty namespaces.

##### JS API

-   Print more detailed JS stack traces. This is mostly useful for the Sass team's
    own debugging purposes.

### [`v1.43.4`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1434)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.3...1.43.4)

##### JS API

-   Fix a bug where the `logger` option was ignored for the `render()` function.

### [`v1.43.3`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1433)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.43.2...1.43.3)

-   Improve performance.

### [`v1.43.2`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1432)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.42.1...1.43.2)

-   Improve the error message when the default namespace of a `@use` rule is not
    a valid identifier.

### [`v1.42.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1421)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.42.0...1.42.1)

-   Fix a bug where Sass variables and function calls in calculations weren't
    being resolved correctly if there was a parenthesized interpolation elsewhere
    in the file.

### [`v1.42.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1420)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.41.1...1.42.0)

-   `min()` and `max()` expressions are once again parsed as calculations as long
    as they contain only syntax that's allowed in calculation expressions. To
    avoid the backwards-compatibility issues that were present in 1.40.0, they now
    allow unitless numbers to be mixed with numbers with units just like the
    global `min()` and `max()` functions. Similarly, `+` and `-` operations within
    `min()` and `max()` functions allow unitless numbers to be mixed with numbers
    with units.

### [`v1.41.1`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1411)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.41.0...1.41.1)

-   Preserve parentheses around `var()` functions in calculations, because they
    could potentially be replaced with sub-expressions that might need to be
    parenthesized.

### [`v1.41.0`](https://togithub.com/sass/dart-sass/blob/HEAD/CHANGELOG.md#&#8203;1410)

[Compare Source](https://togithub.com/sass/dart-sass/compare/1.40.1...1.41.0)

-   Calculation values can now be combined with strings using the `+` operator.
    This was an error in 1.40.0, but this broke stylesheets that were relying on
    `$value + ""` expressions to generically convert values to strings. (Note that
    the Sass team recommends the use of `"#{$value}"` or `inspect($value)` for
    that use-case.)

-   The `selector.unify()` function now correctly returns `null` when one selector
    is a `:host` or `:host-context` and the other is a selector that's guaranteed
    to be within the current shadow DOM. The `@extend` logic has been updated
    accordingly as well.

-   Fix a bug where extra whitespace in `min()`, `max()`, `clamp()`, and `calc()`
    expressions could cause bogus parse errors.

-   Fix a bug where the right-hand operand of a `-` in a calculation could
    incorrectly be stripped of parentheses.

##### Dart API

-   `SassCalculation.plus()` now allows `SassString` arguments.

</details>

---

### Configuration

📅 **Schedule**: Branch creation - "every weekend" (UTC), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Never, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://app.renovatebot.com/dashboard#github/carbon-design-system/carbon-for-ibm-dotcom).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNC4xNjAuMCIsInVwZGF0ZWRJblZlciI6IjM0LjE2MC4wIn0=-->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Ready to merge Label for the pull requests that are ready to merge
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants