sasso-rails 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec674d60203b29114c080883f7e4cf438fa36dbc8b43daaebb02f7d197ffbf2e
-  data.tar.gz: cd677fde1997dae468d8ad8acdd4de81a41847931ba6f72a9d7b102cfe523bbe
+  metadata.gz: 362a4798b8ebe03f26c32688f42048bc184b56a4e23a02db7d5cffbeaefcc4d8
+  data.tar.gz: 2bda2a2d286b992749ace28b314e8c86c9796bdd160d13c735a233967efc9a8d
 SHA512:
-  metadata.gz: ca83ee104decbe95b065399c956584959c4f8599658c590c90c371859a920562f611eb7d41171d53e1581a3d66160ccb5bd02fd2545986ad87c9fba975075079
-  data.tar.gz: 9df668f046ac42666b9ab9e65aba3b0b29fe3dfb0d018ccf8f7afc821f8f4378e76afbf0b5ca151ac6efc9b987a52160f0279fdcfeaa55215e3bb3738c39347c
+  metadata.gz: f23d4f4c8372103bf0fdaaeb86c85694eed3d861409aa99f915c580bfbde57842a811211a16f8806175db649474c9aa45421b4f4aea4266217d054dce3a32180
+  data.tar.gz: f097ec3da59d3e120408a9db2926e89d1d53d6f5b926699b7b126a7c6aa923f079f0f9d5c9ea5a342988570222bb3e34ea4043fa85660abb6254536deaa273a8

data/CHANGELOG.md

@@ -8,6 +8,29 @@ the engine-gem version range it requires.
 
 ## [Unreleased]
 
+## [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.
+
+### Fixed
+
+- The installer now removes the default `app/assets/stylesheets/application.css`,
+  which otherwise collides with the compiled `app/assets/builds/application.css`
+  on the asset load path (both resolve to the logical path `application.css`).
+- The installer repoints the Rails 8 default layout's `stylesheet_link_tag :app`
+  to `stylesheet_link_tag "application"` so the compiled CSS is actually linked
+  (no-op if the layout already links `"application"` or was customized).
+
 ## [0.1.0] - 2026-06-13
 
 Initial release. Requires the `sasso` gem **>= 0.1.1, < 1**.

data/README.md

@@ -30,15 +30,18 @@ bin/rails generate sasso:install
 ```
 
 The installer scaffolds `app/assets/stylesheets/application.scss`, creates
-`app/assets/builds/` (with a `.keep`), links the builds directory in a Sprockets
-manifest if one exists, and adds a watch process to `Procfile.dev`.
-
-Reference the compiled CSS in your layout:
+`app/assets/builds/` (with a `.keep`), removes the default
+`app/assets/stylesheets/application.css` (it would collide with the compiled
+output), links the builds directory in a Sprockets manifest if one exists, adds
+a watch process to `Procfile.dev`, and points your layout at the compiled CSS:
 
 ```erb
 <%= stylesheet_link_tag "application" %>
 ```
 
+(On Rails 8 the default layout links `:app`; the installer repoints it to
+`"application"`. If you wire the link yourself, use `"application"`.)
+
 ## Usage
 
 ```sh
@@ -69,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/generators/sasso/install/install_generator.rb

@@ -9,10 +9,33 @@ module Sasso
     class InstallGenerator < ::Rails::Generators::Base
       source_root File.expand_path("templates", __dir__)
 
+      # A fresh Propshaft/Sprockets app ships app/assets/stylesheets/application.css.
+      # Our compiled output is app/assets/builds/application.css — both resolve to
+      # the logical path "application.css" on the asset load path, which collides.
+      # The build dir owns the compiled CSS now (the cssbundling convention), so
+      # drop the default stub.
+      def remove_default_application_css
+        default = "app/assets/stylesheets/application.css"
+        remove_file default if File.exist?(File.join(destination_root, default))
+      end
+
       def create_stylesheet
         template "application.scss", "app/assets/stylesheets/application.scss"
       end
 
+      # Rails 8 layouts default to `stylesheet_link_tag :app`, which looks for
+      # "app.css" and won't pick up our compiled "application.css". Point it at
+      # the entrypoint we build. No-op if the layout is missing or already links
+      # "application" (so a customized layout is left alone).
+      def link_stylesheet_in_layout
+        layout = "app/views/layouts/application.html.erb"
+        full = File.join(destination_root, layout)
+        return unless File.exist?(full)
+        return if File.read(full).include?('stylesheet_link_tag "application"')
+
+        gsub_file layout, /stylesheet_link_tag\s+:app\b/, 'stylesheet_link_tag "application"'
+      end
+
       def ensure_builds_directory
         create_file "app/assets/builds/.keep" unless File.exist?(builds_keep_path)
 

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.0"
+    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.0
+  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'