csspin-rails 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1717d5c0156c805e78da55e7b3646c305586cc9d74b243d9799b29d76dd2e75
-  data.tar.gz: 6fa180b07893e1c5a119da73c80318eacd7663791ae2c6c149c46031fe8cde45
+  metadata.gz: 3454e0488e9e270d59a784ee6d543b8b78c30358014dbeb625c8687ec439ba5f
+  data.tar.gz: 7b2bc27e4cb01fc6a2b9904531537a524af3d6614fdfbecd1a6720dbd8a87c37
 SHA512:
-  metadata.gz: 827c66a027c92c20c3e236596903b70cf462eadd8b081dcd491cdb60129791e88b004dfe98576ab8b192a17a90787e766397d3d8e72921f2133e90e67dad4229
-  data.tar.gz: 7a04c7c035d9fa58e151c0c4af7456b9ce0c7923c78495de426dbef7bb99e63ac5310481ac071a0c681d998d77c45a6313c9e4f7e3aebc3867a11600b033c219
+  metadata.gz: a3c8739d3e66f4dafaf259936931e99bc5599c7d9a6a237538a234aed0d3a2a03ad6c6abb40dfbfa4f8387f93e92edd0033f1f2bd79a9743fe5cc532bb8c316d
+  data.tar.gz: 71adb4ac5225949c366efb8a3de1b6774e1ad9c12ea29334f2a4839ac4bde1c53555f3a8a8538eceb63f0641297e3be1b8cfae083fa173b40e8f37e29c2d6fb3

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 1.0.1
+
+- Inline relative CSS `@import` directives when pinning, so packages that ship an entrypoint stylesheet produce a single usable vendored file.
+- Document the release process in the README.
+
+## 1.0.0
+
+- Initial release.

data/README.md

@@ -1,6 +1,8 @@
 # csspin-rails
 
-[![CI](https://github.com/elalemanyo/csspin-rails/actions/workflows/ci.yml/badge.svg)](https://github.com/elalemanyo/csspin-rails/actions/workflows/ci.yml)
+![Gem Version](https://img.shields.io/gem/v/csspin-rails)
+![CI](https://github.com/elalemanyo/csspin-rails/actions/workflows/ci.yml/badge.svg)
+![License](https://img.shields.io/badge/License-MIT-green)
 
 Pin CSS packages from npm into a Rails app's `vendor/assets/stylesheets` — without Node.js.
 
@@ -24,13 +26,13 @@ bundle install
 
 ```bash
 # Pin a package (latest version)
-bundle exec csspin pin trix
+bundle exec csspin pin sourdough-toast
 
 # Pin a specific version
-bundle exec csspin pin trix@2.0.0
+  bundle exec csspin pin sourdough-toast@2.0.7
 
 # Pin a scoped package
-bundle exec csspin pin @scope/package@1.2.3
+bundle exec csspin pin @37signals/lexxy
 ```
 
 CSS is saved to `vendor/assets/stylesheets/<package>.css`.
@@ -40,8 +42,8 @@ If you want `bin/csspin`, run `bundle binstubs csspin-rails` first.
 After pinning, the CLI prints integration snippets:
 
 ```
-Sprockets snippet: *= require trix
-Sass snippet: @import "trix";
+Sprockets snippet: *= require sourdough-toast
+Sass snippet: @import "sourdough-toast";
 ```
 
 ## CLI
@@ -72,6 +74,17 @@ bundle exec standardrb
 bundle exec rake test
 ```
 
+### Releasing
+
+This repo publishes via GitHub Actions when you push a tag matching `v*` (see `.github/workflows/release.yml`).
+
+1. Update `lib/csspin/version.rb`
+2. Run `bundle exec rake test` (and any linting you want)
+3. Commit
+4. Tag: `git tag vX.Y.Z`
+5. Push commit: `git push origin HEAD`
+6. Push tag: `git push origin vX.Y.Z`
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/csspin/commands/pin.rb

@@ -30,7 +30,10 @@ module Csspin
           return 1
         end
 
-        saved_path = @writer.write(package_name: spec.package_name, content: result[:body])
+        css = Csspin::CssImportsInliner
+          .new(downloader: @downloader)
+          .inline(result[:body], base_url: result[:url], import_stack: [result[:url]])
+        saved_path = @writer.write(package_name: spec.package_name, content: css)
 
         snippet_package = File.basename(saved_path, ".css")
 

data/lib/csspin/css_imports_inliner.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module Csspin
+  class CssImportsInliner
+    IMPORT_RE = /\A\s*@import\s+(?:url\(\s*)?["'](?<path>[^"']+)["']\s*\)?\s*(?<media>[^;]*);\s*\z/
+
+    def initialize(downloader:)
+      @downloader = downloader
+    end
+
+    def inline(css, base_url:, import_stack: [])
+      return css unless css.include?("@import")
+
+      out = +""
+
+      css.each_line do |line|
+        match = IMPORT_RE.match(line)
+
+        out << if match && relative_css_path?(match[:path]) && match[:media].to_s.strip.empty?
+          fetch_css(base_url, match[:path], import_stack)
+        else
+          line
+        end
+      end
+
+      out
+    end
+
+    private
+
+    def fetch_css(base_url, relative_path, import_stack)
+      url = URI.join(base_url, relative_path).to_s
+
+      if import_stack.include?(url)
+        raise "Circular CSS import detected: #{(import_stack + [url]).join(" -> ")}"
+      end
+
+      response = @downloader.get(url)
+
+      raise "Failed to download imported CSS: #{url}" unless response[:ok]
+
+      import_stack << url
+      inlined = inline(response[:body].to_s, base_url: url, import_stack: import_stack)
+      inlined.end_with?("\n") ? inlined : "#{inlined}\n"
+    ensure
+      import_stack.pop if import_stack.last == url
+    end
+
+    def relative_css_path?(path)
+      return false if path.start_with?("/", "//")
+      return false if path.match?(/\A[a-z][a-z0-9+\-.]*:/i)
+
+      true
+    end
+  end
+end

data/lib/csspin/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Csspin
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/lib/csspin.rb

@@ -6,6 +6,7 @@ require_relative "csspin/css_fallback_candidates"
 require_relative "csspin/jsdelivr_metadata_client"
 require_relative "csspin/resolver/jsdelivr"
 require_relative "csspin/http/downloader"
+require_relative "csspin/css_imports_inliner"
 require_relative "csspin/vendor_writer"
 require_relative "csspin/instructions_printer"
 require_relative "csspin/commands/pin"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: csspin-rails
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - elalemanyo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -60,12 +60,14 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - README.md
 - exe/csspin
 - lib/csspin.rb
 - lib/csspin/cli.rb
 - lib/csspin/commands/pin.rb
 - lib/csspin/css_fallback_candidates.rb
+- lib/csspin/css_imports_inliner.rb
 - lib/csspin/http/downloader.rb
 - lib/csspin/instructions_printer.rb
 - lib/csspin/jsdelivr_metadata_client.rb