stimulus_plumbers_tailwind 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7821a54d820ecd2c76e2ce5afd0bcd00ab4fb2f78f3e4246a256a378b3bd631
-  data.tar.gz: f67b19c723fe3ba0e22c5f7e94698575bf17e905d6ec4db9305b919d6ae4a471
+  metadata.gz: 9eb6bbfe958bd425b443843724ef2b3a66041f04fe40ec4b041a72accd9ec497
+  data.tar.gz: f1928462ed5485e7560a1993e72aeddbd90dd734db280703ae50e751bfcb6306
 SHA512:
-  metadata.gz: 959b1d2a0f740c5630d85cc824da0148e7c172e9052b6359f4c873ee5c24ac23afdddf6bc5d4cd76602373f5c3f7d90cd0649fe13185b5eeb9b802deed618a6e
-  data.tar.gz: 4a0dd9d2040676acd2671eda6b2840ebb320f6704ce93ed23dcdcbb008ab37bc9abdd30e132bb224d9f0a97aa069941bdd4ee76b650eeeb71d97b7b12fe14f25
+  metadata.gz: ce4edf07b1b20042b73e67c4d16d86eb6213e0e08a3fdb2049a362c4042941fe7672b5503e185da78c4e85394a4592e7a51971fcfca01802c14d4df5c2cf4bad
+  data.tar.gz: 625987458573abbe7ab612323c81ce300b2ac993347e6af4903e1a034b35c7153a81d716695a79531c38578d78f0884feddfe15655b0e252cbccc0f254d05ae5

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
 
+---
+## [0.4.3](https://github.com/ryancyq/stimulus-plumbers/compare/stimulus-plumbers-tailwind/v0.4.2..stimulus-plumbers-tailwind/v0.4.3) - 2026-06-30
+
+### Bug Fixes
+
+- tailwind generator ([#149](https://github.com/ryancyq/stimulus-plumbers/issues/149)) - ([9dafae0](https://github.com/ryancyq/stimulus-plumbers/commit/9dafae03b5d49fb543d08f84cdb718d944dce49f)) - Ryan Chang
+
 ---
 ## [0.4.2](https://github.com/ryancyq/stimulus-plumbers/compare/stimulus-plumbers-tailwind/v0.4.0..stimulus-plumbers-tailwind/v0.4.2) - 2026-06-30
 

data/README.md

@@ -31,14 +31,30 @@ StimulusPlumbers.configure do |config|
 end
 ```
 
-Tell Tailwind to scan the gem's lib files so component class names are included in the generated CSS. Add an `@source` directive pointing at the gem's installed path:
+Run the install generator once to inject the required `@source` directive into your Tailwind CSS entry file:
 
-```css
-@import "tailwindcss";
-@source "/path/to/gems/stimulus_plumbers_tailwind-VERSION/lib/**/*.rb";
+```bash
+bin/rails generate stimulus_plumbers_tailwind:install
 ```
 
-Use `bundle show stimulus_plumbers_tailwind` to get the exact installed path.
+The generator checks these files in order:
+
+- `app/assets/stylesheets/application.tailwind.css`
+- `app/assets/stylesheets/application.css`
+- `app/javascript/entrypoints/application.css`
+
+Override the detected file for both the generator and rake task with `TAILWIND_CSS_FILE=/path/to/entry.css`.
+
+After the initial install, the `@source` path is kept current automatically — no manual re-run needed after `bundle update`. The engine hooks `stimulus_plumbers_tailwind:install` as a prerequisite of:
+
+- `assets:precompile` (Sprockets and Propshaft both define this task)
+- `tailwindcss:build` (when `tailwindcss-rails` is present)
+
+To trigger an update manually without a full compile (useful for debugging or after `bundle update`):
+
+```bash
+bin/rails stimulus_plumbers_tailwind:install
+```
 
 ## Theming
 

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

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module StimulusPlumbersTailwind
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      GEM_NAME          = "stimulus_plumbers_tailwind"
+      TAILWIND_CSS_FILE = "TAILWIND_CSS_FILE"
+      CSS_CANDIDATES    = %w[
+        app/assets/stylesheets/application.tailwind.css
+        app/assets/stylesheets/application.css
+        app/javascript/entrypoints/application.css
+      ].freeze
+
+      def install
+        css_file = entry_css_file
+        return warn_entry_css_not_found unless css_file
+
+        apply_edit(css_file)
+      end
+
+      private
+
+      def warn_entry_css_not_found
+        tried = CSS_CANDIDATES.map { |c| File.join(destination_root, c) }
+        tried.unshift(File.expand_path(ENV[TAILWIND_CSS_FILE])) if ENV[TAILWIND_CSS_FILE]
+        say "Could not find a Tailwind CSS entry file. Tried: #{tried.join(", ")}. " \
+            "Set #{TAILWIND_CSS_FILE}=/path/to/entry.css and re-run.",
+            :red
+      end
+
+      def apply_edit(css_file)
+        content              = File.read(css_file)
+        new_content, status  = content_edit(content, source_directive)
+
+        if new_content
+          File.write(css_file, new_content)
+          say_status status, relative_to_destination(css_file), :green
+        else
+          say_status :identical, relative_to_destination(css_file)
+        end
+      end
+
+      def content_edit(content, source_line)
+        if content.include?(source_line)
+          nil
+        elsif (existing = content.match(%r{@source "[^"]*#{Regexp.escape(GEM_NAME)}[^"]*";}))
+          [content.sub(existing[0], source_line), :update]
+        elsif (import_line = content.match(%r{@import "tailwindcss"[^;]*;}))
+          [content.sub(import_line[0], "#{import_line[0]}\n#{source_line}"), :insert]
+        else
+          ["#{content.rstrip}\n#{source_line}\n", :append]
+        end
+      end
+
+      def source_directive
+        spec = Gem.loaded_specs[GEM_NAME]
+        %(@source "#{spec.gem_dir}/lib/**/*.rb";)
+      end
+
+      def entry_css_file
+        if ENV[TAILWIND_CSS_FILE]
+          path = File.expand_path(ENV[TAILWIND_CSS_FILE])
+          return path if File.exist?(path)
+        end
+
+        CSS_CANDIDATES
+          .map { |c| File.join(destination_root, c) }
+          .find { |f| File.exist?(f) }
+      end
+
+      def relative_to_destination(path)
+        path.delete_prefix("#{destination_root}/")
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers_tailwind/engine.rb

@@ -7,5 +7,9 @@ module StimulusPlumbersTailwind
         c.theme.register(:tailwind, StimulusPlumbers::Themes::TailwindTheme)
       end
     end
+
+    rake_tasks do
+      load File.join(__dir__, "../tasks/stimulus_plumbers_tailwind.rake")
+    end
   end
 end

data/lib/stimulus_plumbers_tailwind/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StimulusPlumbersTailwind
-  VERSION = "0.4.2"
+  VERSION = "0.4.3"
 end

data/lib/tasks/stimulus_plumbers_tailwind.rake

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+namespace :stimulus_plumbers_tailwind do
+  desc "Add @source directive for stimulus_plumbers_tailwind into Tailwind CSS entry file"
+  task install: :environment do
+    require "generators/stimulus_plumbers_tailwind/install/install_generator"
+    StimulusPlumbersTailwind::Generators::InstallGenerator.new(
+      [], {}, { destination_root: Rails.root.to_s }
+    ).invoke_all
+  end
+end
+
+Rake::Task["assets:precompile"].enhance(["stimulus_plumbers_tailwind:install"]) if Rake::Task.task_defined?("assets:precompile")
+
+Rake::Task["tailwindcss:build"].enhance(["stimulus_plumbers_tailwind:install"]) if Rake::Task.task_defined?("tailwindcss:build")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_plumbers_tailwind
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Ryan Chang
@@ -33,6 +33,7 @@ files:
 - CHANGELOG.md
 - LICENSE-DEPENDENCIES
 - README.md
+- lib/generators/stimulus_plumbers_tailwind/install/install_generator.rb
 - lib/stimulus_plumbers/themes/tailwind/avatar.rb
 - lib/stimulus_plumbers/themes/tailwind/button.rb
 - lib/stimulus_plumbers/themes/tailwind/button/group.rb
@@ -704,6 +705,7 @@ files:
 - lib/stimulus_plumbers_tailwind.rb
 - lib/stimulus_plumbers_tailwind/engine.rb
 - lib/stimulus_plumbers_tailwind/version.rb
+- lib/tasks/stimulus_plumbers_tailwind.rake
 homepage: https://github.com/ryancyq/stimulus-plumbers
 licenses:
 - MIT