sasso-rails 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 362a4798b8ebe03f26c32688f42048bc184b56a4e23a02db7d5cffbeaefcc4d8
-  data.tar.gz: 2bda2a2d286b992749ace28b314e8c86c9796bdd160d13c735a233967efc9a8d
+  metadata.gz: 906b842a73c7016c0682b5f414faab3416d11bcaff07b3b4a5b26da3faab1a61
+  data.tar.gz: dc2b535f1e451ab474767bd9249241166198ddd5fef17ec540e3a684040802cd
 SHA512:
-  metadata.gz: f23d4f4c8372103bf0fdaaeb86c85694eed3d861409aa99f915c580bfbde57842a811211a16f8806175db649474c9aa45421b4f4aea4266217d054dce3a32180
-  data.tar.gz: f097ec3da59d3e120408a9db2926e89d1d53d6f5b926699b7b126a7c6aa923f079f0f9d5c9ea5a342988570222bb3e34ea4043fa85660abb6254536deaa273a8
+  metadata.gz: e96e0f66238e73d3889a180f749356c14907c7c643b08a0b4fb5a62d2c5e88e98db5a6a79bc6b821c9dc9e2246bc462b2a96d6f72b18797946422a9b259f0e05
+  data.tar.gz: fe8c449eaf6ee9d337fdff94ed65d5d5330d011751855482cacd53d95af9652f6873151db02d1e778252847cd349acc0d0d562943c984cb3c675d0acb40decf7

data/CHANGELOG.md

@@ -8,6 +8,37 @@ the engine-gem version range it requires.
 
 ## [Unreleased]
 
+## [0.1.4] - 2026-06-15
+
+Requires the `sasso` gem **>= 0.2.3** (was `>= 0.2.0`).
+
+### Changed
+
+- Bumped the `sasso` engine-gem floor to **>= 0.2.3**, which pulls in two
+  dart-sass parity fixes contributed upstream by @shyim:
+  - **`!default` no longer evaluates its right-hand side when the variable is
+    already set.** This fixes a spurious "incompatible units" error seen in
+    Bootstrap-on-Shopware setups.
+  - **Legacy `rgb()`/`hsl()` preserve the caller's `rgba`/`hsla` spelling in
+    special-value passthroughs** (e.g. `rgba(var(--bs-body-color-rgb), …)`),
+    which Bootstrap relies on.
+
+## [0.1.3] - 2026-06-14
+
+### Fixed
+
+- **Sprockets `assets:precompile` crash (`LoadError: cannot load such file --
+  sassc`).** On a Sprockets app (e.g. a default Rails 7.0 app), the install
+  generator left the manifest's default `//= link_directory ../stylesheets .css`
+  directive in place, so Sprockets 4 tried to COMPILE the `application.scss`
+  entrypoint with its built-in `SasscProcessor` (`require "sassc"`, not
+  installed) — harmless in dev but crashing `assets:precompile` on deploy. The
+  generator now neutralizes that directive (sasso owns the compiled output,
+  served from `../builds`, which is linked separately). Idempotent, and a no-op
+  on Propshaft (no manifest). Rails 7.0 + Sprockets now precompiles cleanly;
+  Propshaft (Rails 7.1 / 8.x) is unaffected. Verified end-to-end across both
+  pipelines, plus a generator unit test.
+
 ## [0.1.2] - 2026-06-14
 
 Requires the `sasso` gem **>= 0.2.0** (for its source-map API).

data/README.md

@@ -17,6 +17,28 @@ Why this gem over the alternatives:
   directly through the native extension — no process spawn, no IPC.
 - **Pure Rust core.** No libsass (deprecated), no Dart VM.
 
+## Compatibility
+
+- **Ruby** ≥ 3.1.
+- **Rails** ≥ 7.0 (`railties >= 7.0`), on **either** asset pipeline. Verified
+  end-to-end (`generate sasso:install` → `sasso:build` → production
+  `assets:precompile` → served CSS) on:
+
+  | Rails  | Asset pipeline                                       | Status              |
+  |--------|------------------------------------------------------|---------------------|
+  | 8.x    | Propshaft (the Rails 8 default)                      | ✅ primary path     |
+  | 7.1+   | Propshaft (`rails new --asset-pipeline=propshaft`)   | ✅                  |
+  | 7.0    | Sprockets (the Rails 7.0 default)                    | ✅ (since **0.1.3**) |
+
+  On **Propshaft** sasso compiles to `app/assets/builds/` and Propshaft serves
+  it (Propshaft performs no Sass step of its own). On **Sprockets** the installer
+  links that builds directory into the manifest **and** disables Sprockets' own
+  `.scss` handling, so `assets:precompile` deploys cleanly without `sassc`/
+  libsass (this last part is the 0.1.3 fix — earlier versions crashed
+  `assets:precompile` on a default Sprockets app; see the changelog). Either way
+  the compiler is the pure-Rust `sasso` native gem — no Node, no Dart, no
+  subprocess.
+
 ## Installation
 
 ```ruby
@@ -94,8 +116,6 @@ that directory as a source of ready-to-serve assets:
 
 ## Notes & limitations
 
-- **Source maps are not supported yet.** The in-process compiler returns CSS
-  only; there is no `.css.map` output in any environment.
 - **`builds` is file-to-file.** Each entry maps one input file to one output
   file. There is no directory-glob form (no `"." => "."`); list each entrypoint
   explicitly.
@@ -110,10 +130,33 @@ that directory as a source of ready-to-serve assets:
 - **Watch is a 1s mtime poll** (dependency-free, no native fs-events); it covers
   the source dir and `config.sasso.load_paths`.
 
+## Troubleshooting
+
+**`Bundler::GemNotFound: Could not find sasso-<version>-<platform>`** on
+`bin/rails sasso:build` (or any boot) right after `bundle install`. The `sasso`
+compiler ships as a **precompiled native gem**, so the lockfile must list your
+platform. If Bundler resolved the version but didn't materialize the native
+build for your arch, add the platform and re-install:
+
+```console
+$ bundle lock --add-platform arm64-darwin   # or x86_64-linux, aarch64-linux, etc.
+$ bundle install
+```
+
+This is a generic Bundler behaviour for precompiled native gems (the same step
+`nokogiri` etc. need on CI/Docker), not specific to sasso — but you may hit it
+on a first local install. To bake every supported platform into the lockfile up
+front:
+
+```console
+$ bundle lock --add-platform x86_64-linux aarch64-linux \
+    x86_64-linux-musl aarch64-linux-musl arm64-darwin x86_64-darwin x64-mingw-ucrt
+```
+
 ## Versioning
 
 This gem versions independently of the `sasso` compiler gem and pins it with a
-range (`sasso >= 0.1.1, < 1`). An app may pin a specific compiler version in its
+range (`sasso >= 0.2.3, < 1`). An app may pin a specific compiler version in its
 own `Gemfile`.
 
 ## License

data/lib/generators/sasso/install/install_generator.rb

@@ -55,9 +55,24 @@ module Sasso
         manifest = "app/assets/config/manifest.js"
         full = File.join(destination_root, manifest)
         return unless File.exist?(full)
-        return if File.read(full).include?("link_tree ../builds")
 
-        append_to_file manifest, %(//= link_tree ../builds\n)
+        unless File.read(full).include?("link_tree ../builds")
+          append_to_file manifest, %(//= link_tree ../builds\n)
+        end
+
+        # The default Sprockets manifest links the stylesheets SOURCE directory
+        # (`//= link_directory ../stylesheets .css`). Sprockets 4 then tries to
+        # COMPILE our `application.scss` entrypoint with its built-in
+        # SasscProcessor, which `require "sassc"` — not installed on a default
+        # app — so `assets:precompile` crashes with
+        # `LoadError: cannot load such file -- sassc`. sasso owns the compiled
+        # output (served from ../builds, linked above), so the raw source dir
+        # must NOT be linked. Neutralize the directive — idempotent, since the
+        # regex only matches the live `//=` form (a re-run is a no-op).
+        gsub_file manifest,
+                  %r{^([ \t]*)//=([ \t]*link_directory[ \t]+\.\./stylesheets\b.*)$},
+                  "\\1//\\2  -- disabled by sasso-rails (sasso compiles ../stylesheets to ../builds; " \
+                  "linking the source dir makes Sprockets compile .scss via sassc)"
       end
 
       def add_watch_to_procfile

data/lib/sasso/rails/version.rb

@@ -5,6 +5,6 @@ module Sasso
     # Versioned INDEPENDENTLY of both the `sasso` gem and the `sasso` crate.
     # The gemspec pins the engine gem with a range (sasso >= 0.1.1, < 1), so a
     # compiler bump does not force a lockstep release of this integration gem.
-    VERSION = "0.1.2"
+    VERSION = "0.1.4"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sasso-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - momiji-rs
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-14 00:00:00.000000000 Z
+date: 2026-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -30,7 +30,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.2.3
     - - "<"
       - !ruby/object:Gem::Version
         version: '1'
@@ -40,7 +40,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.2.3
     - - "<"
       - !ruby/object:Gem::Version
         version: '1'