unmagic-components 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c4fbdc3dbc2a5dbba7758240b2c0fa271c81f46e00435e898ad179f23ce1937
-  data.tar.gz: 1ce6acc98aecc0153da190eca815d5ca469e6e46c0fe61bdd8b1fc75dd437e10
+  metadata.gz: acc506f1f415e9fa5c52d7e54e8790581b0b402e76769f52888c2ab25efa025f
+  data.tar.gz: e6fd6a1c65c1945efb5c05320af6a6b76b57bda43a948ac9e6528966ee21a6fe
 SHA512:
-  metadata.gz: 2cbcb4011c8504a0247e3a26d49042da521e22ccc658615049e7bdfc7ec9411fa86f984acb2abc9e59a99bc398c245dd03f99de30616f00c2a5ecc49ed688251
-  data.tar.gz: 6599c73d2d0c5846a8b5206e3df0071b31c8d958f88b3e21dcbdda761c48820c1f2a1854762c99ce09b6f360985be017a10c007be5887c26a5ae5c097ca4807a
+  metadata.gz: d72cc016685d0cdf5b0da795badbe6f0ffba6dd603dd2c5ff3b715675e979e2be87ca5efedb26af84b4538b21dbe0e9b476061adbfa88edb6e71628737443b33
+  data.tar.gz: 68c74166b2ce4ea52dc5746cf6c63148dfdbdfabff6cdb8b635400651dd5e540f89b7e045da6bcbb36c8c8a1e7742da4cf4ffa2af058bc2521eb677a4975bdef

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-09-17
+
+### Added
+
+- `Unmagic::Components.with_default_configuration { … }` runs a block with the
+  built-in seams, whatever the app configured. The override is per thread or
+  fiber, so the app's other requests aren't affected.
+
+### Changed
+
+- The component browser ignores the host's configuration and renders every
+  example through the built-in seams. A host whose `empty_state` or
+  `pagination` rendered its own partials had to hand the browser the helpers
+  those partials call; now none of the host's code runs inside the browser.
+
 ## [0.4.0] - 2026-09-16
 
 ### Added
@@ -257,7 +272,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Configurable empty-state, pagination and Pagy seams so the gem depends on neither
   Pagy nor any host helper.
 
-[Unreleased]: https://github.com/unreasonable-magic/unmagic-components/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/unreasonable-magic/unmagic-components/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/unreasonable-magic/unmagic-components/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/unreasonable-magic/unmagic-components/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/unreasonable-magic/unmagic-components/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/unreasonable-magic/unmagic-components/compare/v0.1.0...v0.2.0

data/README.md

@@ -99,9 +99,9 @@ mount Unmagic::Components::Browser::Engine => "/unmagic/components" if Rails.env
 
 It brings its own stylesheet, prebuilt with Tailwind's default theme, and loads
 the components' JavaScript and Turbo itself, so nothing in your CSS or JS
-changes. It needs `turbo-rails` in your bundle. It renders through your
-configuration, so a `control_class` pointed at your own classes leaves its form
-examples unstyled.
+changes. It needs `turbo-rails` in your bundle. It shows the components as the
+gem draws them: your configuration doesn't apply inside it, so an `empty_state`
+that renders your own partial runs only in your app.
 
 Its controllers inherit `ActionController::Base`, so your authentication doesn't
 cover it. Its demo endpoints only write to the visitor's session, but mount it

data/lib/unmagic/components/browser/app/controllers/unmagic/components/browser/application_controller.rb

@@ -24,6 +24,12 @@ module Unmagic
 
         before_action :require_turbo, :remember_theme, :load_catalog
 
+        # The browser shows the gem's own components, not the host's take on them:
+        # its stylesheet has only the gem's classes, and a host's empty_state or
+        # pagination would render the host's partials, which call helpers this
+        # controller doesn't have.
+        around_action :with_default_configuration
+
         private
 
         # Checked per request rather than at load, because a host that eager loads
@@ -42,6 +48,8 @@ module Unmagic
 
         def dark_theme? = browser_session[:theme] == "dark"
 
+        def with_default_configuration(&) = Unmagic::Components.with_default_configuration(&)
+
         def load_catalog
           Catalog.reload! if Rails.env.development?
           @components = Catalog.all

data/lib/unmagic/components/version.rb

@@ -2,6 +2,6 @@
 
 module Unmagic
   module Components
-    VERSION = "0.4.0"
+    VERSION = "0.5.0"
   end
 end

data/lib/unmagic/components.rb

@@ -5,6 +5,7 @@ require "active_support/core_ext/object/try"
 require "active_support/core_ext/hash/except"
 require "active_support/core_ext/module/delegation"
 require "active_support/core_ext/string/output_safety"
+require "active_support/isolated_execution_state"
 
 require_relative "components/version"
 require_relative "components/configuration"
@@ -76,18 +77,38 @@ module Unmagic
   module Components
     class << self
       def configure
-        yield(configuration) if block_given?
-        configuration
+        yield(app_configuration) if block_given?
+        app_configuration
       end
 
+      # The app's configuration, unless the current request or job is inside
+      # with_default_configuration.
       def configuration
-        @configuration ||= Configuration.new
+        ActiveSupport::IsolatedExecutionState[:unmagic_components_configuration] || app_configuration
+      end
+
+      # Runs the block with the built-in seams, whatever the app configured. The
+      # browser renders through this, so none of a host's code (its partials, and
+      # the helpers they call) runs inside it. The override is per thread or fiber,
+      # so the app's own requests running alongside keep the app's configuration.
+      def with_default_configuration
+        previous = ActiveSupport::IsolatedExecutionState[:unmagic_components_configuration]
+        ActiveSupport::IsolatedExecutionState[:unmagic_components_configuration] = Configuration.new
+        yield
+      ensure
+        ActiveSupport::IsolatedExecutionState[:unmagic_components_configuration] = previous
       end
 
       # Drops every customisation, restoring the built-in seams. Intended for
       # tests; an app configures once at boot.
       def reset_configuration!
-        @configuration = nil
+        @app_configuration = nil
+      end
+
+      private
+
+      def app_configuration
+        @app_configuration ||= Configuration.new
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: unmagic-components
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Keith Pitt