kiso 0.2.0.pre → 0.2.2.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a28e88755cea2967813e27293413e587cef78cd5466240e16034df5c512b887d
-  data.tar.gz: 6f8cee28fae6476f598f384ef4898726499f39e0ed99e4a785f64ef08f517205
+  metadata.gz: cfca4f2a1e45d61e45de52c22a96428de18c04643860ea07c0913d2c29d3c397
+  data.tar.gz: e46ba40a7fe00c0818958742e745058e6cec5990e2b195df085cc2b3e8242477
 SHA512:
-  metadata.gz: 3caa5d60dd0339c04dfd2c7cd03695dcac54d9c9c91fe6b082b9fb6adc79bca73a8e7d9c0de9c91d50bba095f1dd738032d2be04cc77b558ba6ba9e45144e7d9
-  data.tar.gz: 97b58647c61a6460cb72a9633bef14037026fd7c1be9d22b073e98f3de7c28d830b8f24f1fc628bc145d91b996954f7d7c22f49cc7a54ac9c35e420b3c877f1f
+  metadata.gz: 8ca9dcd4857e5f4eb41086239901a6c347314432ba75189372642dba08d6975fe9caa5466635e94e013f26c858a84ff5af64e2701dd75a3ef946e560b3025011
+  data.tar.gz: 75689ce3b7a06d3377d74ed37f7d5fe1d44c95d19549b6992e5c66bd3b78a8b07e924bbc2ba26a15f02b861f74986565c124369fb7648de5b5655b060dd2d4f6

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2.pre] - 2026-03-03
+
+### Fixed
+
+- Dashboard layout rendering — components called without a block inside a layout (e.g., sidebar toggle, collapse) would capture the entire page template via ERB yield bubbling, breaking the dashboard grid. The `kui()` helper now passes an empty proc to prevent yield from reaching the layout.
+- Dashboard toggle and collapse icon sizing — SVG icons now render at the correct size via `[&>svg]:size-4`.
+
+## [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 +68,9 @@ 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.2.pre...HEAD
+[0.2.2.pre]: https://github.com/steveclarke/kiso/releases/tag/v0.2.2.pre
+[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/app/helpers/kiso/component_helper.rb

@@ -30,6 +30,16 @@ module Kiso
         "kiso/components/#{component}"
       end
 
+      # Prevent yield from bubbling up the ERB rendering chain when no block
+      # is passed. Without this, partials that use `capture { yield }.presence`
+      # to support optional block overrides (e.g., toggle/collapse/separator)
+      # would have their `yield` bubble through nested content_tag blocks all
+      # the way to the layout's `<%= yield %>`, capturing the entire page
+      # template content. An explicit empty proc gives `yield` something to
+      # call, returning empty string → `.presence` returns nil → default
+      # content renders correctly.
+      block ||= proc {}
+
       if collection
         render partial: path, collection: collection, locals: kwargs, &block
       else

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/themes/dashboard.rb

@@ -9,7 +9,7 @@ module Kiso
     )
 
     DashboardNavbarToggle = ClassVariants.build(
-      base: "flex items-center justify-center w-8 h-8 rounded-md text-foreground/50 hover:text-foreground hover:bg-accent transition-colors duration-150 shrink-0"
+      base: "flex items-center justify-center w-8 h-8 rounded-md text-foreground/50 hover:text-foreground hover:bg-accent transition-colors duration-150 shrink-0 [&>svg]:size-4"
     )
 
     DashboardSidebar = ClassVariants.build(
@@ -29,11 +29,11 @@ module Kiso
     )
 
     DashboardSidebarToggle = ClassVariants.build(
-      base: "lg:hidden flex items-center justify-center w-8 h-8 rounded-md text-foreground/50 hover:text-foreground hover:bg-accent transition-colors duration-150 shrink-0 cursor-pointer"
+      base: "lg:hidden flex items-center justify-center w-8 h-8 rounded-md text-foreground/50 hover:text-foreground hover:bg-accent transition-colors duration-150 shrink-0 cursor-pointer [&>svg]:size-4"
     )
 
     DashboardSidebarCollapse = ClassVariants.build(
-      base: "hidden lg:flex items-center justify-center w-8 h-8 rounded-md text-foreground/50 hover:text-foreground hover:bg-accent transition-colors duration-150 shrink-0 cursor-pointer"
+      base: "hidden lg:flex items-center justify-center w-8 h-8 rounded-md text-foreground/50 hover:text-foreground hover:bg-accent transition-colors duration-150 shrink-0 cursor-pointer [&>svg]:size-4"
     )
 
     DashboardToolbar = ClassVariants.build(

data/lib/kiso/themes/input_otp.rb

@@ -20,7 +20,7 @@ module Kiso
     # @example
     #   InputOtpSlot.render(size: :md)
     InputOtpSlot = ClassVariants.build(
-      base: "border-accented relative flex items-center justify-center " \
+      base: "border-border relative flex items-center justify-center " \
             "border-y border-r shadow-xs transition-all outline-none " \
             "first:rounded-l-md first:border-l last:rounded-r-md " \
             "data-[active=true]:z-10 data-[active=true]:border-primary " \

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