kiso 0.2.0.pre → 0.2.1.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a28e88755cea2967813e27293413e587cef78cd5466240e16034df5c512b887d
-  data.tar.gz: 6f8cee28fae6476f598f384ef4898726499f39e0ed99e4a785f64ef08f517205
+  metadata.gz: fc81659a56fbdc6091f37b314d096fa6eeca6a430284f594a2666e7646b49bed
+  data.tar.gz: 75d5f93f6d15684a044b340c1159fca84d0ac8285e16bf859c6805ceef35da4a
 SHA512:
-  metadata.gz: 3caa5d60dd0339c04dfd2c7cd03695dcac54d9c9c91fe6b082b9fb6adc79bca73a8e7d9c0de9c91d50bba095f1dd738032d2be04cc77b558ba6ba9e45144e7d9
-  data.tar.gz: 97b58647c61a6460cb72a9633bef14037026fd7c1be9d22b073e98f3de7c28d830b8f24f1fc628bc145d91b996954f7d7c22f49cc7a54ac9c35e420b3c877f1f
+  metadata.gz: 452f1fcafc008d9257fe03b6530a182e4be66a8fbcf7e42ae6d03131cc0fb3fe8f8f144330a6c667d7e9fbb4dad65a592dd17e24c1833fb28cfbd71c5e4224fc
+  data.tar.gz: cae0cecec57517234b7f5c02d44cfe7b3542b463bec938ae955793c345345be7daf63a7212adfd040cf1849ec2d5faeaa377e410b79c477abfe68e6a92110699

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1.pre] - 2026-03-03
+
+### Fixed
+
+- Propshaft `stylesheet_link_tag :app` compatibility — the Rails 8.1 default `:app` symbol caused Propshaft to serve `tailwindcss-rails` engine CSS stubs directly to the browser, resulting in 404 errors for absolute filesystem paths. Kiso now filters these build-time intermediates from Propshaft's stylesheet resolution automatically. Host apps using either `:app` or explicit `"tailwind"` work correctly.
+
 ## [0.2.0.pre] - 2026-03-03
 
 ### Added
@@ -55,7 +61,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Lookbook component previews
 - Bridgetown documentation site
 
-[Unreleased]: https://github.com/steveclarke/kiso/compare/v0.2.0.pre...HEAD
+[Unreleased]: https://github.com/steveclarke/kiso/compare/v0.2.1.pre...HEAD
+[0.2.1.pre]: https://github.com/steveclarke/kiso/releases/tag/v0.2.1.pre
 [0.2.0.pre]: https://github.com/steveclarke/kiso/releases/tag/v0.2.0.pre
 [0.1.1.pre]: https://github.com/steveclarke/kiso/releases/tag/v0.1.1.pre
 [0.1.0.pre]: https://github.com/steveclarke/kiso/releases/tag/v0.1.0.pre

data/lib/kiso/engine.rb

@@ -51,6 +51,51 @@ module Kiso
       end
     end
 
+    # Filters tailwindcss-rails engine CSS stubs from Propshaft's :app stylesheet
+    # resolution so they are never served to the browser.
+    #
+    # Background: tailwindcss-rails generates intermediate stub files in the host
+    # app at app/assets/builds/tailwind/<engine_name>.css. Each stub contains a
+    # single @import with an absolute filesystem path:
+    #
+    #   @import "/path/to/gems/kiso-0.2.0/app/assets/tailwind/kiso/engine.css";
+    #
+    # The Tailwind CLI resolves this @import at build time and inlines the engine
+    # CSS into the compiled output (app/assets/builds/tailwind.css). The stubs are
+    # build-time intermediates — they should never reach the browser.
+    #
+    # The problem: Propshaft's stylesheet_link_tag :app (the Rails 8.1 default)
+    # globs app/assets/**/*.css and generates a <link> tag for every match. This
+    # picks up the stubs alongside the compiled tailwind.css. The browser then
+    # receives a stub, encounters the @import with a filesystem path, interprets
+    # it as a URL, and gets a 404.
+    #
+    # Propshaft's excluded_paths config only removes top-level directories from
+    # the load path — it can't exclude files within a load path directory. The
+    # stubs live inside app/assets/builds/ (a single load path entry), so
+    # excluded_paths can't help.
+    #
+    # This fix prepends a filter onto Propshaft::Helper#app_stylesheets_paths to
+    # reject any asset whose logical path starts with "tailwind/" — these are
+    # always engine stubs generated by tailwindcss-rails, never user CSS.
+    # The compiled output is "tailwind.css" (no slash), so it passes through.
+    #
+    # This affects ALL engine stubs, not just Kiso's, because the problem is
+    # systemic to how tailwindcss-rails engine bundling interacts with Propshaft's
+    # :app resolution.
+    #
+    # See: propshaft-1.3.1 lib/propshaft/helper.rb#app_stylesheets_paths
+    # See: tailwindcss-rails lib/tailwindcss/engines.rb (stub generation)
+    # See: tailwindcss-rails lib/tailwindcss/engine.rb (excludes app/assets/tailwind
+    #      but not app/assets/builds/tailwind)
+    initializer "kiso.filter_tailwind_stubs" do
+      ActiveSupport.on_load(:action_view) do
+        if defined?(Propshaft::Helper)
+          Propshaft::Helper.prepend(Kiso::PropshaftTailwindStubFilter)
+        end
+      end
+    end
+
     # Registers Kiso's component previews with Lookbook when available.
     initializer "kiso.lookbook", after: :load_config_initializers do
       if defined?(Lookbook)

data/lib/kiso/propshaft_tailwind_stub_filter.rb

@@ -0,0 +1,13 @@
+module Kiso
+  # Filters tailwindcss-rails engine CSS stubs from Propshaft's :app stylesheet
+  # resolution. Prepended onto Propshaft::Helper by the engine initializer.
+  #
+  # Engine stubs have logical paths like "tailwind/kiso.css" — always under the
+  # "tailwind/" prefix. The compiled output is "tailwind.css" (no slash) and
+  # passes through unaffected.
+  module PropshaftTailwindStubFilter
+    def app_stylesheets_paths
+      super.reject { |path| path.start_with?("tailwind/") }
+    end
+  end
+end

data/lib/kiso/version.rb

@@ -2,5 +2,5 @@
 
 module Kiso
   # @return [String] the current gem version
-  VERSION = "0.2.0.pre"
+  VERSION = "0.2.1.pre"
 end

data/lib/kiso.rb

@@ -5,6 +5,7 @@ require "tailwind_merge"
 require "kiso/version"
 require "kiso/configuration"
 require "kiso/theme_overrides"
+require "kiso/propshaft_tailwind_stub_filter"
 require "kiso/engine"
 require "kiso/themes/shared"
 require "kiso/themes/badge"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kiso
 version: !ruby/object:Gem::Version
-  version: 0.2.0.pre
+  version: 0.2.1.pre
 platform: ruby
 authors:
 - Steve Clarke
@@ -268,6 +268,7 @@ files:
 - lib/kiso/cli/make.rb
 - lib/kiso/configuration.rb
 - lib/kiso/engine.rb
+- lib/kiso/propshaft_tailwind_stub_filter.rb
 - lib/kiso/theme_overrides.rb
 - lib/kiso/themes/alert.rb
 - lib/kiso/themes/avatar.rb