style_capsule 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a44279976aff6cedb8ddc1a8bc4c84382378d73a11ebb7a17850626ecd612745
-  data.tar.gz: fee43b83895392f778b7c8b3600dbb5e75e52d660efc76d7939e762ef594e94d
+  metadata.gz: 66f1dc7d0d5addb480cfba5b2301305f390e23b8f6d533c69e57d8703fe9bf9d
+  data.tar.gz: 559cb7b3d87328da61419bf7a8ce1f4014a4425e4476966bfa0b129acc2fca26
 SHA512:
-  metadata.gz: a82489272c3ff1e9ac782e2129dc8133a2037101a9719f6c1a38404cec71dae33dab6f64ae93ff6926cd57bcd2456412f87dc61e0c61d04996b226a66466f411
-  data.tar.gz: 6c50c563aba3098121e4d9f2693572c6b66cbf6304fff198cafd337ac33da190af06a8469a2a6b59108c1392e2c4b844d13d0dd1cf56025faf5640bbbb1f5bdc
+  metadata.gz: cfa2dd98b0465d2d83145b11801e35b7f7a1f1e8d4d26fb18ae8f2c9af35b4d6d4b58a8d4fed3c66d037c45dd8e1a988091b9d8aef28b50e9981c1a03a3f0807
+  data.tar.gz: 10390d9e96e507b1966a4b31bc4eb490d232eda1034f029a1604d7765d75653c75b1649054aa0170b2b32acba4eca406b5c49922823696e95da3f0da24ce4c40

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 2.0.1 (2026-07-03)
+
+- Fix `render_head_stylesheets` clearing request-scoped registrations added after a template pre-render but before layout head (Phlex + Rails layout capture)
+  - Only remove request-scoped entries that existed when head rendering started; later body registrations remain for `HeadInjectionMiddleware`
+- Document Phlex + Rails layout pattern: when `HeadInjectionMiddleware` is enabled, omit `stylesheet_registry_tags` for request-scoped namespaces and let the middleware inject all pending styles before `</head>` (calling `render_head_stylesheets` in layout head clears pre-captured template registrations without reliably writing tags into the Phlex buffer)
+
 ## 2.0.0 (2026-07-03)
 
 - BREAKING: split `StylesheetRegistry.register` into request-scoped `register` and boot-time `register_eager`

data/lib/style_capsule/stylesheet_registry.rb

@@ -567,16 +567,18 @@ module StyleCapsule
     # rubocop:disable Metrics/AbcSize, Metrics/PerceivedComplexity -- renders mixed inline and file registrations
     def self.render_head_stylesheets(view_context = nil, namespace: nil)
       if namespace.nil? || namespace.to_s.strip.empty?
+        request_files_snapshot = request_file_stylesheets.transform_values { |files| files.keys.dup }
+        request_inline_snapshot = request_inline_stylesheets.transform_values(&:dup)
+
         all_stylesheets = merged_file_registrations_all_namespaces
 
         request_inline_stylesheets.each do |_ns, inline|
           all_stylesheets.concat(inline)
         end
 
-        clear # Clear request-scoped inline CSS and file paths only
         return safe_string("") if all_stylesheets.empty?
 
-        all_stylesheets.map do |stylesheet|
+        rendered = all_stylesheets.map do |stylesheet|
           if stylesheet[:type] == :inline
             render_inline_stylesheet(stylesheet, view_context)
           else
@@ -584,15 +586,19 @@ module StyleCapsule
           end
         end.join("\n").then { |s| safe_string(s) }
 
+        clear_snapshotted_request_registrations(request_files_snapshot, request_inline_snapshot)
+        rendered
+
       else
         # Render specific namespace
         ns = normalize_namespace(namespace)
+        snapshotted_file_paths = request_file_stylesheets[ns]&.keys&.dup || []
+        snapshotted_inline = request_inline_stylesheets[ns]&.dup || []
         stylesheets = stylesheets_for(namespace: ns).dup
-        clear(namespace: ns) # Clear request-scoped inline CSS and file paths only
 
         return safe_string("") if stylesheets.empty?
 
-        stylesheets.map do |stylesheet|
+        rendered = stylesheets.map do |stylesheet|
           if stylesheet[:type] == :inline
             render_inline_stylesheet(stylesheet, view_context)
           else
@@ -600,6 +606,13 @@ module StyleCapsule
           end
         end.join("\n").then { |s| safe_string(s) }
 
+        clear_snapshotted_request_registrations_for_namespace(
+          ns,
+          file_paths: snapshotted_file_paths,
+          snapshotted_inline_stylesheets: snapshotted_inline
+        )
+        rendered
+
       end
     end
     # rubocop:enable Metrics/AbcSize, Metrics/PerceivedComplexity
@@ -633,6 +646,55 @@ module StyleCapsule
     end
     # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
+    # @api private
+    def self.clear_snapshotted_request_registrations(files_snapshot, inline_snapshot)
+      files_snapshot.each do |ns, file_paths|
+        clear_snapshotted_request_registrations_for_namespace(
+          ns,
+          file_paths: file_paths,
+          snapshotted_inline_stylesheets: inline_snapshot[ns] || []
+        )
+      end
+
+      inline_snapshot.each do |ns, snapshotted_inline_stylesheets|
+        next if files_snapshot.key?(ns)
+
+        clear_snapshotted_request_registrations_for_namespace(
+          ns,
+          file_paths: [],
+          snapshotted_inline_stylesheets: snapshotted_inline_stylesheets
+        )
+      end
+    end
+
+    # @api private
+    def self.clear_snapshotted_request_registrations_for_namespace(namespace, file_paths:, snapshotted_inline_stylesheets:)
+      ns = normalize_namespace(namespace)
+
+      if file_paths.any?
+        file_registry = request_file_stylesheets
+        file_paths.each { |path| file_registry[ns]&.delete(path) }
+        file_registry.delete(ns) if file_registry[ns] && file_registry[ns].empty?
+        self.request_file_stylesheets = file_registry
+      end
+
+      return if snapshotted_inline_stylesheets.empty?
+
+      inline_registry = inline_stylesheets
+      current_inline = inline_registry[ns] || []
+      remaining_inline = current_inline.reject do |entry|
+        snapshotted_inline_stylesheets.any? { |snapshot_entry| snapshot_entry.equal?(entry) || snapshot_entry == entry }
+      end
+
+      if remaining_inline.empty?
+        inline_registry.delete(ns)
+      else
+        inline_registry[ns] = remaining_inline
+      end
+
+      self.inline_stylesheets = inline_registry
+    end
+
     # Inject pending request-scoped stylesheets into an HTML document before +</head>+.
     #
     # Used by +HeadInjectionMiddleware+ after the body has rendered and components have
@@ -718,7 +780,8 @@ module StyleCapsule
     end
     private_class_method :pending_request_stylesheets, :render_stylesheet_tags,
       :merged_file_registrations_for_namespace, :merged_file_registrations_all_namespaces,
-      :merge_file_registrations
+      :merge_file_registrations, :clear_snapshotted_request_registrations,
+      :clear_snapshotted_request_registrations_for_namespace
 
     # Render a file-based stylesheet
     def self.render_file_stylesheet(stylesheet, view_context)

data/lib/style_capsule/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StyleCapsule
-  VERSION = "2.0.0"
+  VERSION = "2.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: style_capsule
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Andrei Makarov
@@ -63,6 +63,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
+- !ruby/object:Gem::Dependency
+  name: polyrun
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement