sasso-rails 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47fd62745a906cd33915884a073e5388d83256bea9532a27c21a03673834d7b3
-  data.tar.gz: f605f87e6c421d01a67c4ee18a336a1b501be756cf74bdac88173e828fe982b5
+  metadata.gz: 362a4798b8ebe03f26c32688f42048bc184b56a4e23a02db7d5cffbeaefcc4d8
+  data.tar.gz: 2bda2a2d286b992749ace28b314e8c86c9796bdd160d13c735a233967efc9a8d
 SHA512:
-  metadata.gz: 85f6248e5b1bec53c62170a86d94b9e7ebad12777447057b117d9410f63d5887918188f0d031e79a477aae9509d901cdeb54c9b1eac07a36531678744efb79d9
-  data.tar.gz: 6a616ebbe2dbdda75c06f717d4fa7c71a0815aa2fcba243b6ea6ccf8db0cfb36696b1869fb346de3396709c6baa956dc172ce5deb7a8da616fbd3f5cf9129062
+  metadata.gz: f23d4f4c8372103bf0fdaaeb86c85694eed3d861409aa99f915c580bfbde57842a811211a16f8806175db649474c9aa45421b4f4aea4266217d054dce3a32180
+  data.tar.gz: f097ec3da59d3e120408a9db2926e89d1d53d6f5b926699b7b126a7c6aa923f079f0f9d5c9ea5a342988570222bb3e34ea4043fa85660abb6254536deaa273a8

data/CHANGELOG.md

@@ -8,7 +8,17 @@ the engine-gem version range it requires.
 
 ## [Unreleased]
 
-## [0.1.1] - 2026-06-13
+## [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"

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.2"
   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.2
 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'