reactive_component 0.8.4 → 0.8.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77acde881234cd7b6013ab8618efd2cbeb1ffd1a4c6232199517a9b14f4aa9ce
-  data.tar.gz: 1854830f220dd61bb49625a1a2a69e29d4e42ce96a40cf371586d3dd898bcbfc
+  metadata.gz: 5ec78650feb0396bbe85c2adc0994209dc4d1ab91a6cf0ca49d9692b17e0b316
+  data.tar.gz: c2d54ef039a0ea502c593a5eb1e173f509955e3e37b0f6eea1cd78c05ed365d5
 SHA512:
-  metadata.gz: 2721d5f6252603a600a4b297276a460cece0d4216303d40b6daa193b9d141a745c7024c347f6109463016f0f21d2beef01a083fa11d4fc3d294125973fa98630
-  data.tar.gz: 78a474176edff971af3979ca7c0b02d667c5be59e89f19b2dda28b770184f651799f0220eb2c65f5dfb47e938c4307253b52ad0bdf3df09a16a9679039bb832a
+  metadata.gz: caf86cb2646eea037defb27405b486555e70377351c6fe3a61b7d1b00aa33cf330d6ace77a42936e9c93c2bbb992026d0a5a2138137ac6591ff6efd1a45f6c21
+  data.tar.gz: fc02fd8569b770ff6b6ed6583cdfbc4fb3dfb2630768eaa7d4f095ce755cc7ecf7617721fa542ca5f76a7a149984cbd5549e4f959911e67b739f96a4e2aa3a22

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.8.5] - 2026-09-16
+
+### Added
+- `morphHooks`: register Idiomorph callbacks that run inside every component's
+  morph, for flashing changed values and similar page-wide behaviour, without
+  subclassing the controller. See Hooking into the morph.
+
+### Fixed
+- An app that does not eager load (development, test) broadcast nothing from a
+  process that had not rendered the subscribing component yet, such as a job or
+  a turbo-stream request. The engine now loads the components under
+  `app/components` that include `ReactiveComponent` on boot and after each
+  reload, and only those, so the rest of the app keeps lazy loading. Set
+  `ReactiveComponent::SubscriberLoader.paths` to look elsewhere.
+
 ## [0.8.4] - 2026-09-16
 
 ### Added

data/app/javascript/reactive_component/lib/reactive_renderer_utils.js

@@ -34,6 +34,21 @@ export async function decompress(base64) {
   return new Response(stream).json()
 }
 
+// Idiomorph's callbacks, open for the app to hook into: push an object with any
+// of them (a flash on changed numbers, a sound, a counter) and it runs for every
+// component. A hook returning false cancels that node, as Idiomorph expects.
+export const morphHooks = []
+
+const HOOK_NAMES = [
+  'beforeNodeAdded', 'afterNodeAdded', 'beforeNodeMorphed', 'afterNodeMorphed',
+  'beforeNodeRemoved', 'afterNodeRemoved', 'beforeAttributeUpdated'
+]
+
+const morphCallbacks = Object.fromEntries(HOOK_NAMES.map(name => [
+  name,
+  (...args) => morphHooks.reduce((ok, hook) => (hook[name]?.(...args) === false ? false : ok), true)
+]))
+
 export function morphElement(element, newHtml) {
   const parser = new DOMParser()
   const doc = parser.parseFromString(`<div>${newHtml}</div>`, "text/html")
@@ -42,7 +57,8 @@ export function morphElement(element, newHtml) {
   if (typeof Idiomorph !== "undefined") {
     Idiomorph.morph(element, newContent, {
       morphStyle: "innerHTML",
-      ignoreActiveValue: true
+      ignoreActiveValue: true,
+      callbacks: morphCallbacks
     })
   } else {
     element.innerHTML = newContent.innerHTML

data/lib/reactive_component/engine.rb

@@ -15,6 +15,16 @@ module ReactiveComponent
       ReactiveComponent::DataEvaluator.finalize!
     end
 
+    # A component wires its model up when the class loads, so an app that does
+    # not eager load (development, test) would broadcast nothing from a process
+    # that has not rendered that component yet: a job, or a turbo-stream
+    # request. Load the subscribing components on boot and after each reload.
+    initializer 'reactive_component.load_subscribers' do |app|
+      next if app.config.eager_load
+
+      app.config.to_prepare { ReactiveComponent::SubscriberLoader.load_all }
+    end
+
     initializer 'reactive_component.importmap', before: 'importmap' do |app|
       if defined?(Importmap)
         app.config.importmap.paths <<

data/lib/reactive_component/subscriber_loader.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module ReactiveComponent
+  # A component wires its model up when the class loads, so an app that does
+  # not eager load broadcasts nothing from a process that has not rendered that
+  # component yet. This loads the components that subscribe, and nothing else.
+  module SubscriberLoader
+    mattr_accessor :paths, default: ['app/components']
+
+    SUBSCRIBER = /include\s+ReactiveComponent\b/
+
+    module_function
+
+    def load_all
+      loader = Rails.autoloaders.main
+
+      files.each { |file| loader.cpath_expected_at(file)&.safe_constantize }
+    end
+
+    # The files under `paths` that include the concern, read rather than
+    # loaded, so an app keeps lazy loading for everything else.
+    def files
+      paths.flat_map do |path|
+        dir = Rails.root.join(path)
+        next [] unless Dir.exist?(dir)
+
+        Dir.glob(dir.join('**', '*.rb')).select { |file| File.read(file).match?(SUBSCRIBER) }
+      end
+    end
+  end
+end

data/lib/reactive_component/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ReactiveComponent
-  VERSION = '0.8.4'
+  VERSION = '0.8.5'
 end

data/lib/reactive_component.rb

@@ -8,6 +8,7 @@ require_relative 'reactive_component/compiler'
 require_relative 'reactive_component/data_evaluator'
 require_relative 'reactive_component/wrapper'
 require_relative 'reactive_component/broadcastable'
+require_relative 'reactive_component/subscriber_loader'
 require_relative 'reactive_component/entity'
 require_relative 'reactive_component/engine' if defined?(Rails::Engine)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: reactive_component
 version: !ruby/object:Gem::Version
-  version: 0.8.4
+  version: 0.8.5
 platform: ruby
 authors:
 - Przemyslaw Lusar
@@ -115,6 +115,7 @@ files:
 - lib/reactive_component/engine.rb
 - lib/reactive_component/entity.rb
 - lib/reactive_component/erubi.rb
+- lib/reactive_component/subscriber_loader.rb
 - lib/reactive_component/transpiler.rb
 - lib/reactive_component/version.rb
 - lib/reactive_component/wrapper.rb