Fixed

• Fix the generation of inline source maps (@ArnaudLigny)

This release is a full rewrite of the compiler. The new implementation is a port of dart-sass,
making it spec-compliant and easier to update to support new Sass features. However this release
does not implement Sass modules yet.

BC breaks

• The Compiler class is now final
• The LoggerInterface now expects more argument in its method signatures
• \ScssPhp\ScssPhp\OutputStyle is now an enum instead of a class with string constants.
• Compiler::setOutputStyle now expects an instance of the OutputStyle enum instead of a string.
• Deprecated methods of the compiler have been removed.

Deprecated

• Deprecate passing a path as string as the Compiler::compileString second argument. Either pass
  a URL or use Compiler::compileFile instead. (@stof)

Removed

• Remove support for color math in Sass expressions (@stof)
• Remove the CLI shipped in the package (@stof)
• Remove the scss.inc.php file. Use the autoloader generated by Composer instead. (@stof)
• Remove the cache system integrated in the compiler (@stof)
• Remove support for PHP < 8.1 (@stof)

Added

• Add support for PHP 8.4 (@stof)
• Add support for the Sass indented syntax (@stof)
• Add a representation of Sass values using PHP value objects (@stof)
• Add the Importer extension point for custom importers (@stof)
• Add support for configuring the reporting of deprecation with Compiler::setSilencedDeprecations,
  Compiler::setFutureDeprecations and Compiler::setActiveDeprecations (@stof)
• Add support for silencing deprecations from dependencies with Compiler::setQuietDeps (@stof)
• Add support for configuring verbosity of deprecation warnings with Compiler::setVerbose (@stof)

Fixed

• Thanks to the rewrite, scssphp is now spec-compliant, fixing many issues (@stof)

Changed

• The message received by loggers no longer contains the location and stack trace. Loggers
  need to include them based on the provided argument depending on their formatting needs. (@stof)
• Custom functions can now be defined using the new representation of Sass values by using
  \ScssPhp\ScssPhp\Value\Value as return type. Untyped functions will still receive legacy
  values. (@stof)

Deprecated

• Deprecate registering a custom function with a callable expecting 2 arguments (@stof)

Fixed

• Fix the handling of leading spaces in interpolated media queries (@stof)
• Fix the compilation cache key when using numbers in variables (@stof)

Deprecated

• Deprecate passing string with extra content after the expression in ValueConverter::parseValue (@stof)

Added

• Add the Compiler::compileFile method (@stof)
• Add the OutputStyle::fromString and OutputStyle::toString methods to allow writing code supporting both Scssphp 1.12+ and 2.0 (@stof)

Fixed

• Fix the parsing of values in ValueConverter::parseValue when using comments inside the value source (@stof)

Added

• Add dedicated error handling when passing invalid UTF-8 (@stof)

Fixed

• Fix extending a selector using :is() (@ssltg)

Deprecated

• Deprecate passing a limit with unit to random() (@stof)

Added

• Add support for empty fallback in var() (@stof)

Fixed

• Fix the handling of mixed case operators in media queries (@stof)

Changed

• Improve error messages for incorrect units in color functions (@stof)

Fixed

• Fix the handling of non-integer numbers in nth and set-nth (@max-m)

Fixed

• Remove false positive deprecation warnings when compiling Bootstrap 5.2.0 (@stof)

Changed

• Remove usage of interpolation syntax deprecated in PHP 8.2 (@shyim)

Fixed

• Fix the handling of nested at-root in mixins (@stof)

Changed

• Mark the logger implementations as @final to prepare for 2.0 (@stof)