sasso-rails 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47fd62745a906cd33915884a073e5388d83256bea9532a27c21a03673834d7b3
-  data.tar.gz: f605f87e6c421d01a67c4ee18a336a1b501be756cf74bdac88173e828fe982b5
+  metadata.gz: 182fa27772f53b3c1fbacd3befd6785adf4bac01018fb283e771e75cd4c1c53a
+  data.tar.gz: 3199c95dd402640b1408e998bf7879dd7aadcf352328e292a1e8700884be9df9
 SHA512:
-  metadata.gz: 85f6248e5b1bec53c62170a86d94b9e7ebad12777447057b117d9410f63d5887918188f0d031e79a477aae9509d901cdeb54c9b1eac07a36531678744efb79d9
-  data.tar.gz: 6a616ebbe2dbdda75c06f717d4fa7c71a0815aa2fcba243b6ea6ccf8db0cfb36696b1869fb346de3396709c6baa956dc172ce5deb7a8da616fbd3f5cf9129062
+  metadata.gz: 9b7fd563419f880c4540fa2da7a28dfcc33b06d7cc4e898ef8669794938614e0b903fcbc4e96cb365451a98890d3dcd907ca1100b7a5262f75d96a17ff767149
+  data.tar.gz: 2599b9c1c5f0e84d76b713eabbaf1bb6068863551f3d7ab38fc6b5d3ae6f1f0a6103cbc0089e00fb640a27cadd476831cfa89204ad4d5d3bf5cb169f15592130

data/CHANGELOG.md

@@ -8,7 +8,33 @@ the engine-gem version range it requires.
 
 ## [Unreleased]
 
-## [0.1.1] - 2026-06-13
+## [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).
+
+### Added
+
+- **Source maps.** `sasso:build` writes a `<output>.map` sidecar next to each
+  compiled CSS and appends the `sourceMappingURL` footer. Controlled by
+  `config.sasso.source_map` (default: on outside production, off in production);
+  the map's `sources` are rewritten relative to the builds directory and `file`
+  points at the built CSS.
 
 Makes `bin/rails generate sasso:install` drop-in on a fresh Rails 8 app.
 

data/README.md

@@ -72,6 +72,10 @@ config.sasso.style = :compressed
 # searched first, so sibling partials need no configuration.
 config.sasso.load_paths = [Rails.root.join("vendor/styles").to_s]
 
+# Source maps: write a <output>.map sidecar + sourceMappingURL footer.
+# Default: on outside production, off in production. Set true/false to force.
+config.sasso.source_map = nil
+
 # Defaults shown:
 config.sasso.source_dir = "app/assets/stylesheets"
 config.sasso.build_dir  = "app/assets/builds"
@@ -90,8 +94,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.
@@ -106,6 +108,29 @@ 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

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/compiler.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require "fileutils"
+require "json"
+require "pathname"
 
 module Sasso
   module Rails
@@ -21,17 +23,18 @@ module Sasso
 
       ALLOWED_STYLES = %i[expanded compressed].freeze
 
-      attr_reader :root, :builds, :style, :load_paths, :source_dir, :build_dir
+      attr_reader :root, :builds, :style, :load_paths, :source_dir, :build_dir, :source_map
 
       def initialize(root:, builds:, style: :expanded, load_paths: [],
                      source_dir: "app/assets/stylesheets",
-                     build_dir: "app/assets/builds")
+                     build_dir: "app/assets/builds", source_map: false)
         @root       = File.expand_path(root.to_s)
         @builds     = normalize_builds(builds)
         @style      = normalize_style(style)
         @load_paths = Array(load_paths).map(&:to_s)
         @source_dir = source_dir.to_s
         @build_dir  = build_dir.to_s
+        @source_map = source_map ? true : false
       end
 
       # Compile every entrypoint; returns the list of written output paths.
@@ -47,13 +50,18 @@ module Sasso
           raise Error, "sasso-rails: input stylesheet not found: #{src}"
         end
 
-        # `Sasso.compile` already searches the entry file's own directory first
-        # (for sibling @use/@import); pass any extra include dirs after it.
-        css = ::Sasso.compile(src, style: @style, load_paths: @load_paths)
-
         dest = File.join(@root, @build_dir, output)
         FileUtils.mkdir_p(File.dirname(dest))
-        File.write(dest, css)
+
+        # `Sasso.compile` already searches the entry file's own directory first
+        # (for sibling @use/@import); pass any extra include dirs after it.
+        if @source_map
+          result = ::Sasso.compile(src, style: @style, load_paths: @load_paths, source_map: true)
+          write_source_map(dest, result.source_map)
+          File.write(dest, result.css + source_map_footer(File.basename(dest)))
+        else
+          File.write(dest, ::Sasso.compile(src, style: @style, load_paths: @load_paths))
+        end
         dest
       end
 
@@ -76,6 +84,33 @@ module Sasso
 
       private
 
+      # Write the sidecar `<dest>.map`, pointing `file` at the built CSS and
+      # rewriting each source URL to a path relative to the builds directory
+      # (the .map lives next to the CSS). `source_map` is the parsed v3 Hash.
+      def write_source_map(dest, source_map)
+        from_dir = File.dirname(dest)
+        source_map["file"] = File.basename(dest)
+        source_map["sources"] = Array(source_map["sources"]).map { |s| relative_source(s, from_dir) }
+        File.write("#{dest}.map", JSON.generate(source_map))
+      end
+
+      # The `sourceMappingURL` footer for the built CSS. Matches dart-sass: the
+      # expanded footer sits on its own line after the trailing newline; the
+      # compressed footer is appended directly (no leading newline).
+      def source_map_footer(css_basename)
+        comment = "/*# sourceMappingURL=#{css_basename}.map */"
+        @style == :compressed ? "#{comment}\n" : "\n#{comment}\n"
+      end
+
+      # A source URL made relative to the .map's directory (so a DevTools that
+      # loads the .map resolves the original next to it). Falls back to the URL
+      # unchanged if it is not a relativizable path.
+      def relative_source(url, from_dir)
+        Pathname.new(url).relative_path_from(Pathname.new(from_dir)).to_s
+      rescue ArgumentError
+        url
+      end
+
       # Compile, downgrading a Sass/config error to a warning so a watcher does
       # not die on it (used at startup and on every recompile).
       def safe_build

data/lib/sasso/rails/engine.rb

@@ -12,6 +12,7 @@ module Sasso
     #   config.sasso.load_paths # extra @use/@import include dirs (Array)
     #   config.sasso.source_dir # default "app/assets/stylesheets"
     #   config.sasso.build_dir  # default "app/assets/builds"
+    #   config.sasso.source_map # true | false (default: on outside production)
     #
     # The `sasso:build` rake task is enhanced onto `assets:precompile`, so the
     # CSS is generated before Propshaft/Sprockets fingerprints it on deploy.
@@ -22,6 +23,7 @@ module Sasso
       config.sasso.load_paths = []
       config.sasso.source_dir = "app/assets/stylesheets"
       config.sasso.build_dir  = "app/assets/builds"
+      config.sasso.source_map = nil   # resolved in `Sasso::Rails.source_map_for`
 
       # NOTE: no `rake_tasks do load ... end` — Rails::Engine already auto-loads
       # lib/tasks/**/*.rake into the host app. Loading it again here would define
@@ -40,9 +42,20 @@ module Sasso
         load_paths: cfg.load_paths,
         source_dir: cfg.source_dir,
         build_dir:  cfg.build_dir,
+        source_map: source_map_for(cfg.source_map),
       )
     end
 
+    # Generate source maps outside production by default (debugging aid); an
+    # explicit `config.sasso.source_map` (true/false) always wins. Off in
+    # production by default to avoid shipping `.map` sidecars + the asset-digest
+    # interaction unless opted in.
+    def source_map_for(configured)
+      return configured ? true : false unless configured.nil?
+
+      !::Rails.env.production?
+    end
+
     # Default to compressed CSS in production (smaller payload), expanded
     # elsewhere (readable). An explicit `config.sasso.style` always wins.
     #

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.1"
+    VERSION = "0.1.3"
   end
 end

metadata

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