sasso 0.14.1 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8be9f3f7763446b860e1dbf23b57cb075aded0446821bf576956c6c004d66011
-  data.tar.gz: 4556887906e983fd1e6bcd88bb9ecd1936650c6fb84db7d12e2cdd12852d0d21
+  metadata.gz: 5375e3b9612d974d4b5f5f36e046604d966aea2b4a52868bdaa038dc092e7877
+  data.tar.gz: 97824cb45d07e6cd9604ae7d272f938ec3fa7da712a7977c41a4a675e98cd8e1
 SHA512:
-  metadata.gz: 49911acde6cb6c77b6058946fb9579590421e221c41a7515e08b4627e7c3471e1dc5dcaa01f386bd584e63f0a576bd8c04abf55cb1a3d218b8fca6e1cc3f1645
-  data.tar.gz: 2aba6f84fd058e12fe046fb58155b024790a3e773dfdd66220815862bfe0bd21f9a9c768e55e543f5708529b51efa746853af7dac021c3596d1cf2ec34a58e22
+  metadata.gz: 8e6baf70058cafc8af867676a249b9ef99e81fcea9e30622545d5f4fd3f9a1691a4569ce7fd4cc6ba9c890f60a1638d958b26b777303c08a3ab24f18bdcf59d0
+  data.tar.gz: b8a69b394fdafe059cc15436f75363b623fb17443fc3ae6f7beda5d4440826bd635f23bd2c17c7b2cb27ed8bbd6f497834673b05609fb7826e702ccac75668e0

data/CHANGELOG.md

@@ -9,6 +9,110 @@ the gem independently of the crate.
 
 ## [Unreleased]
 
+## [0.21.0] - 2026-10-30
+
+_Adopts core `sasso` 0.21.0, nine core releases at once (0.15.0 through 0.21.0)._
+
+_The Ruby API is backward compatible and gains one option. The compiler is not:
+some stylesheets that compiled before now fail, and some CSS changes meaning,
+not only bytes. Read **New errors** first, then the output changes marked
+**meaning**._
+
+### Added
+
+- **`silence_deprecations:`** (dart-sass `silenceDeprecations`): deprecation ids,
+  as Strings or Symbols, whose warnings are dropped wherever they are raised.
+  Every other diagnostic still comes through. The core drops a silenced id before
+  its repetition cap, so unlike filtering inside `on_warn:` it leaves no
+  "N repetitive deprecation warnings omitted" footer. Ids the compiler never
+  emits are accepted, as dart accepts them (core 0.17.0).
+
+### Changed (new errors — stylesheets that compiled before)
+
+- **A built-in rejects an argument name it does not declare** (core 0.19.1).
+  `math.max(1, 2, $x: 999)` was `999`; it is now `Error: No parameter named $x.`
+  The color constructors are not checked yet.
+- **An argument given both by position and by name is an error** (0.19.2).
+  `color.mix(red, blue, 10%, $color1: green)` was `rgb(10%, 0%, 90%)`; it is now
+  `Argument $color1 was passed both by position and by name.`
+- **`@use "sass:color" as *` no longer exposes the members dart removed from
+  `sass:color`**, so `saturate(#abcdef, 10%)` reached that way fails (0.19.0).
+- **The color functions reject `var()`, `env()` and a calc that cannot fold**,
+  for example `color.invert(var(--c))` (0.19.0).
+- **Plain CSS rejects every `#{…}`**, where some positions used to drop it
+  silently, and a style rule inside a keyframe frame of a `.css` file is an
+  error (0.19.0).
+- **Selectors follow dart's grammar** (0.19.3). Malformed attributes (`[a=1]`,
+  `[a==b]`, `[]`), characters that start no selector (`a^b`), invalid keyframe
+  stops (`10px`) and a raw line break inside a quoted string now fail.
+
+### Changed (output)
+
+As with 0.14.0, byte-compared output (snapshot tests, asset digests, build
+caches) will differ. Entries marked **meaning** change what a browser does.
+
+- **meaning:** **compressed `color()` is valid CSS again** (0.17.0).
+  `color(display-p3 0.5 0.2 0.9)` compressed to `color(display-p3.5.2.9)`,
+  which browsers drop; it is now `color(display-p3 .5 .2 .9)`.
+- **meaning:** **a non-ASCII space is no longer whitespace** (0.19.3). An NBSP
+  inside a selector stays part of it: `[a="x<NBSP>y"]` was rewritten to
+  `[a="x y"]`, and `a<NBSP>b` became a descendant selector. Output containing one
+  now carries `@charset "UTF-8";`.
+- **meaning:** **whitespace inside a quoted attribute value is kept**:
+  `[a="x   y"]` used to collapse to `[a="x y"]` (0.19.3). A quoted `(` or `[`
+  no longer swallows the rest of the selector list.
+- **meaning:** **an empty at-rule survives compression**: `@font-face {}`
+  compressed to nothing and is now `@font-face{}` (0.19.0).
+- **meaning:** **plain `.css` loaded through `@use`/`@import` keeps rules it used
+  to drop** (`@keyframes`, a custom `@function`, an at-rule nested in a style
+  rule), and stops hoisting at-rules out of a keyframe frame (0.19.0).
+- **meaning:** **legacy color edge cases follow dart**. A degenerate color such
+  as `hsl(0, 100%, calc(-infinity * 1%))` is a color rather than a string, so
+  `color.mix()` on it gives `hsl(0, 0%, 0%)` instead of `rgb(NaN%, NaN%, NaN%)`.
+  `color.change()` on an hsl color no longer flips its hue (0.19.0).
+- **Compressed colors and numbers serialize the way dart's do**, about 1,400
+  cases (0.19.0). For example, `oklab(1% 0 0)` compresses to `oklab(.01 0 0)`.
+- **The `rgb()`/`hsl()` form choice follows dart's rules** in both styles
+  (0.19.0).
+- **A calc writes `+ -n` as `- n` in compressed output too** (0.17.0).
+- **A `round()` that cannot be folded is a calculation**, so compressed output
+  drops the space after its commas (0.19.0).
+- `@import` modifiers are written verbatim, a newline in a complex selector puts
+  the next one on its own line, and compressed `[a="x y" i]` drops the space
+  before `i` (0.19.0, 0.19.3).
+
+### Changed (diagnostics)
+
+- **New warning: `bogus-combinators`** (0.17.0), when a rule whose selector has
+  a repeated or leading combinator (`a > + b`) is dropped. sasso already dropped
+  those rules, as dart does, but said nothing; the warning is the only sign that
+  the CSS lost them. Use `silence_deprecations: [:"bogus-combinators"]` to
+  silence it.
+- **New deprecation: `color-module-compat`** (0.19.0), e.g. for
+  `color.grayscale(1)`.
+- **CSS filter functions no longer raise `global-builtin`**: for example,
+  `filter: grayscale(1)` (0.18.0).
+- **Messages follow dart's wording** for a removed `sass:color` member, a type
+  error, which now names the parameter (`$number: (1 2) is not a number.`), and
+  a missing attribute operator (0.19.0, 0.19.3).
+- **A stack frame names a path relative to the working directory**, not a
+  `file://` URL (0.19.0).
+
+### Changed (build)
+
+- **The extension depends on the core with `default-features = false`.** Core
+  0.19.0 added a default-on `cli-clock` feature that pulls `chrono` into Windows
+  builds for the CLI's `--watch` timestamp. The library never uses it, so the
+  native extension keeps its zero-dependency build.
+
+### Performance
+
+The library compile path is faster in every core release in this range, with
+byte-identical output in the releases that only make it faster (0.20.0, 0.21.0).
+Measured as instruction counts on the core's real-world corpus, 0.20.0 alone cut
+vuetify by 24%, bulma by 21% and bootstrap by 8%. 0.21.0 cut uswds by 41%, by
+speeding up variables reached through `@use … as *`.
+
 ## [0.14.1] - 2026-10-30
 
 _A gem-only patch. The bundled core compiler is still `sasso` 0.14.0, so

data/Cargo.lock

@@ -245,14 +245,14 @@ dependencies = [
  "magnus",
  "rb-sys",
  "rb-sys-env 0.1.2",
- "sasso 0.14.0",
+ "sasso 0.21.0",
 ]
 
 [[package]]
 name = "sasso"
-version = "0.14.0"
+version = "0.21.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f6ae98548b2e9447aca2340b1c082c82d06721586708b808c52e2f908499c2f8"
+checksum = "4de32df330f2607c02458791223064ee98752e719e6f85804953229533c32448"
 
 [[package]]
 name = "seq-macro"

data/README.md

@@ -69,6 +69,7 @@ Sasso.compile("app/assets/stylesheets/application.scss",
 | `source_map_include_sources:` | `false` | embed each source's text in the map's `sourcesContent` |
 | `quiet:` | `false` | print no `@warn`/`@debug`/deprecation diagnostics |
 | `quiet_deps:` | `false` | drop deprecation warnings raised inside dependencies |
+| `silence_deprecations:` | `[]` | deprecation ids (Strings or Symbols) whose warnings are dropped |
 | `on_warn:` | `nil` | a callable receiving each diagnostic; replaces the stderr printing |
 
 ### Source maps
@@ -87,8 +88,7 @@ r.source_map["sources"]   # => ["application.scss"]
 ### Diagnostics
 
 `@warn`, `@debug` and deprecation warnings print to `$stderr` by default, the
-same dart-style block the `sasso` CLI and dart-sass print. Two ways to change
-that:
+same dart-style block the `sasso` CLI and dart-sass print. To change that:
 
 ```ruby
 # Silence them entirely:
@@ -98,10 +98,12 @@ Sasso.compile_string(scss, quiet: true)
 # resolved through a load path. The entry stylesheet's own still print.
 Sasso.compile_string(scss, load_paths: ["vendor/stylesheets"], quiet_deps: true)
 
+# Silence particular deprecations by id (dart-sass `silenceDeprecations`),
+# wherever they are raised. Every other diagnostic still prints.
+Sasso.compile_string(scss, silence_deprecations: [:import, "color-functions"])
+
 # Or take delivery yourself, which suppresses the printing:
 Sasso.compile_string(scss, url: "in.scss", on_warn: ->(d) {
-  next if d[:deprecation_id] == "color-functions"
-
   Rails.logger.warn(d[:formatted])   # the block the compiler would have printed
 })
 ```

data/ext/sasso/Cargo.toml

@@ -29,7 +29,7 @@ rb-sys = "0.9"
 # The published core compiler, pinned exactly to the API surface this binding
 # targets. Renamed to `sasso_core` so this package can be named `sasso` (a
 # package may not depend on a crate of its own name without a rename).
-sasso_core = { package = "sasso", version = "=0.14.0" }
+sasso_core = { package = "sasso", version = "=0.21.0", default-features = false }
 
 [build-dependencies]
 rb-sys-env = "0.1"

data/ext/sasso/src/lib.rs

@@ -31,18 +31,22 @@ fn flag(ruby: &Ruby, opts: RHash, key: &str, default: bool) -> Result<bool, Erro
     Ok(opt::<bool>(ruby, opts, key)?.unwrap_or(default))
 }
 
-/// Read `load_paths` as filesystem paths.
-fn load_paths(ruby: &Ruby, opts: RHash) -> Result<Vec<PathBuf>, Error> {
-    match opt::<RArray>(ruby, opts, "load_paths")? {
-        Some(a) => Ok(a
-            .to_vec::<String>()?
-            .into_iter()
-            .map(PathBuf::from)
-            .collect()),
+/// Read an optional list of strings; a missing key is an empty list.
+fn strings(ruby: &Ruby, opts: RHash, key: &str) -> Result<Vec<String>, Error> {
+    match opt::<RArray>(ruby, opts, key)? {
+        Some(a) => a.to_vec::<String>(),
         None => Ok(Vec::new()),
     }
 }
 
+/// Read `load_paths` as filesystem paths.
+fn load_paths(ruby: &Ruby, opts: RHash) -> Result<Vec<PathBuf>, Error> {
+    Ok(strings(ruby, opts, "load_paths")?
+        .into_iter()
+        .map(PathBuf::from)
+        .collect())
+}
+
 /// One `@warn` / `@debug` / deprecation diagnostic, copied out of the borrowed
 /// `WarnEvent` so it outlives the compile that produced it.
 ///
@@ -145,6 +149,11 @@ fn native_compile(ruby: &Ruby, source: String, opts: RHash) -> Result<RArray, Er
         copts = copts.with_quiet_deps(importer.dependencies());
     }
 
+    // dart-sass `silenceDeprecations`: dropped by id before the per-id cap, so
+    // a silenced deprecation leaves no "N repetitive warnings omitted" footer.
+    // Ids the core never emits are accepted and do nothing, as in dart.
+    copts = copts.with_silenced_deprecations(strings(ruby, opts, "silence_deprecations")?);
+
     // "stderr" leaves `Options::warn` unset, which is what makes the core print
     // its own dart-style block — the default path installs no handler and pays
     // nothing, not even the sink's allocation. Only "capture" allocates.

data/lib/sasso/version.rb

@@ -6,5 +6,5 @@ module Sasso
   # (ext/sasso/Cargo.toml). A gem-only fix takes the next patch, so the gem may
   # sit ahead of the crate within a minor — `Sasso::CORE_VERSION` reads the
   # version out of the linked binary and is the authority on what is loaded.
-  VERSION = "0.14.1"
+  VERSION = "0.21.0"
 end

data/lib/sasso.rb

@@ -59,6 +59,8 @@ module Sasso
   #   charset:     false => omit the @charset/BOM prefix on non-ASCII output
   #   quiet:       true => print no @warn/@debug/deprecation diagnostics at all
   #   quiet_deps:  true => drop deprecation warnings raised inside dependencies
+  #   silence_deprecations: deprecation ids (Strings or Symbols) whose warnings
+  #                are dropped, e.g. [:import, "global-builtin"]
   #   on_warn:     a callable receiving each diagnostic as a Hash (see WARNING_KEYS);
   #                taking delivery this way replaces the default stderr printing
   #
@@ -67,7 +69,8 @@ module Sasso
   def compile_string(source, style: :expanded, syntax: :scss, indented: false,
                      load_paths: [], url: nil, alert_ascii: false,
                      source_map: false, source_map_include_sources: false,
-                     charset: true, quiet: false, quiet_deps: false, on_warn: nil)
+                     charset: true, quiet: false, quiet_deps: false,
+                     silence_deprecations: [], on_warn: nil)
     syntax = :sass if indented
     validate!(style, STYLES, :style)
     validate!(syntax, SYNTAXES, :syntax)
@@ -83,6 +86,7 @@ module Sasso
                                                        source_map_include_sources: source_map_include_sources,
                                                        charset: charset,
                                                        quiet_deps: quiet_deps,
+                                                       silence_deprecations: Array(silence_deprecations).map(&:to_s),
                                                        warnings: warnings_mode(quiet, on_warn),
                                                      })
     # Deliver first, raise second: a compile can warn and then fail, and those

data/sig/sasso.rbs

@@ -37,6 +37,7 @@ module Sasso
                             ?url: String?, ?alert_ascii: bool,
                             ?source_map: bool, ?source_map_include_sources: bool,
                             ?charset: bool, ?quiet: bool, ?quiet_deps: bool,
+                            ?silence_deprecations: Array[String | Symbol],
                             ?on_warn: (^(warning) -> void)?) -> (String | CompileResult)
   def self.compile: (untyped path, **untyped opts) -> (String | CompileResult)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sasso
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.21.0
 platform: ruby
 authors:
 - momiji-rs