view_component_reflex 1.7.2 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e5577d7e345a14f59567739802588506a300b2caa96bba74bd4f12a93752a04
-  data.tar.gz: be4d877d89d50555bde7f1ba929ef4fd5b1e60c72f2e7e921e33e2623574bfa7
+  metadata.gz: 46d3bc691137a986b26a9487624f004cf9625079040130a035129d12f3f52829
+  data.tar.gz: 9793628bd7618163d9c0014f887d8ef791ac25c2f168dd8c7cbb45e6c55f0839
 SHA512:
-  metadata.gz: 60530d55c39126bd6be3d5be688f08cbe4e84e0b16e444334e438d99ec1a6b05a1f08c102407bea04b9c73ca5ace4bbb4ec013529810bc5363c6bd09e4224d70
-  data.tar.gz: ceebff13ff2407be15ad1d3e851f78130a7bec2d00cdd260bd3ed78d32ebfce596f1763d6608b822d628f0ce91b164a53c47ee2296755733ddac01888ae1bf8c
+  metadata.gz: 014e4d807f719ccb361d9bd800ed599164c498c8e0a947820495982d63a1c07c7409041394d24e247701ec2510b27fe2bbfaee9829733946fe8e51ce630f8e80
+  data.tar.gz: 11cb4beef6ec931032d5b228fa43aee432ce8973fffa10c4391a8577d4788607937d3eb19b41650f778bbdd3cdad94f05e6eb69c0f97a7fdddc8056973f0152c

data/README.md

@@ -108,6 +108,33 @@ def collection_key
 end
 ```
 
+### stimulate(target, data)
+Stimulate another reflex from within your component. This typically requires the key of the component you're stimulating
+which can be passed in via parameters.
+
+```ruby
+def initialize(parent_key)
+  @parent_key = parent_key
+end
+
+def stimulate_other
+  stimulate("OtherComponent#method", { key: @parent_key })
+end
+```
+
+### refresh!(selectors)
+Refresh a specific element on the page. Using this will implicitly run `prevent_render!`.
+If you want to render a specific element, as well as the component, a common pattern would be to pass `selector` as one of the parameters
+
+```
+def my_method
+  refresh! '#my-special-element', selector
+end
+```
+
+### selector
+Returns the unique selector for this component. Useful to pass to `refresh!` when refreshing custom elements.
+
 ### prevent_refresh!
 By default, VCR will re-render your component after it executes your method. `revent_refresh!` prevents this from happening.
 

data/app/components/view_component_reflex/component.rb

@@ -2,95 +2,12 @@ module ViewComponentReflex
   class Component < ViewComponent::Base
     class << self
       def init_stimulus_reflex
-        klass = self
-        @stimulus_reflex ||= Object.const_set(name + "Reflex", Class.new(StimulusReflex::Reflex) {
-          def refresh!(primary_selector = "[data-controller~=\"#{stimulus_controller}\"][data-key=\"#{element.dataset[:key]}\"]", *selectors)
-            save_state
-            @channel.send :render_page_and_broadcast_morph, self, [primary_selector, *selectors], {
-              "dataset" => element.dataset.to_h,
-              "args" => [],
-              "attrs" => element.attributes.to_h,
-              "selectors" => ["body"],
-              "target" => "#{self.class.name}##{method_name}",
-              "url" => request.url,
-              "permanent_attribute_name" => "data-reflex-permanent"
-            }
-          end
-
-          def refresh_all!
-            refresh!("body")
-          end
-
-          # SR's delegate_call_to_reflex in channel.rb
-          # uses method to gather the method parameters, but since we're abusing
-          # method_missing here, that'll always fail
-          def method(name)
-            name.to_sym.to_proc
-          end
-
-          def respond_to_missing?(name, _ = false)
-            !!name.to_proc
-          end
-
-          before_reflex do |a|
-            a.send a.method_name
-            throw :abort
-          end
-
-          def method_missing(name, *args)
-            super unless respond_to_missing?(name)
-            state.each do |k, v|
-              component.instance_variable_set(k, v)
-            end
-            name.to_proc.call(component, *args)
-            refresh! unless @prevent_refresh
-          end
-
-          def prevent_refresh!
-            @prevent_refresh = true
-          end
-
-          define_method :component_class do
-            @component_class ||= klass
-          end
-
-          private :component_class
-
-          private
-
-          def stimulus_controller
-            component_class.stimulus_controller
-          end
-
-          def component
-            return @component if @component
-            @component = component_class.allocate
-            reflex = self
-            exposed_methods = [:params, :request, :element, :refresh!, :refresh_all!, :stimulus_controller, :session, :prevent_refresh!]
-            exposed_methods.each do |meth|
-              @component.define_singleton_method(meth) do |*a|
-                reflex.send(meth, *a)
-              end
-            end
-            @component
-          end
-
-          def set_state(new_state = {})
-            ViewComponentReflex::Engine.state_adapter.set_state(request, controller, element.dataset[:key], new_state)
-          end
-
-          def state
-            ViewComponentReflex::Engine.state_adapter.state(request, element.dataset[:key])
-          end
-
-          def save_state
-            new_state = {}
-            component.safe_instance_variables.each do |k|
-              new_state[k] = component.instance_variable_get(k)
-            end
-            set_state(new_state)
-          end
-        })
+        if name.include? "::"
+          @stimulus_reflex ||= module_parent.const_set(name.split("::").last + "Reflex", Class.new(Reflex))
+        else
+          @stimulus_reflex ||= Object.const_set(name + "Reflex", Class.new(Reflex))
+        end
+        @stimulus_reflex.component_class = self
       end
     end
 
@@ -121,6 +38,10 @@ module ViewComponentReflex
       content_tag tag, capture(&blk), options
     end
 
+    def can_render_to_string?
+      omitted_from_state.empty?
+    end
+
     # key is required if you're using state
     # We can't initialize the session state in the initial method
     # because it doesn't have a view_context yet
@@ -174,7 +95,11 @@ module ViewComponentReflex
       else
         initial_state = ViewComponentReflex::Engine.state_adapter.state(request, "#{@key}_initial")
         ViewComponentReflex::Engine.state_adapter.state(request, @key).each do |k, v|
-          unless permit_parameter?(initial_state[k], instance_variable_get(k))
+          instance_value = instance_variable_get(k)
+          if permit_parameter?(initial_state[k], instance_value)
+            ViewComponentReflex::Engine.state_adapter.set_state(request, controller, "#{@key}_initial", { k => instance_value })
+            ViewComponentReflex::Engine.state_adapter.set_state(request, controller, @key, { k => instance_value })
+          else
             instance_variable_set(k, v)
           end
         end
@@ -192,7 +117,7 @@ module ViewComponentReflex
       [
         :@view_context, :@lookup_context, :@view_renderer, :@view_flow,
         :@virtual_path, :@variant, :@current_template, :@output_buffer, :@key,
-        :@helpers, :@controller, :@request, :@content, :@tag_builder
+        :@helpers, :@controller, :@request, :@tag_builder
       ]
     end
 

data/app/reflexes/view_component_reflex/reflex.rb

@@ -0,0 +1,140 @@
+module ViewComponentReflex
+  class Reflex < StimulusReflex::Reflex
+    include CableReady::Broadcaster
+
+    class << self
+      attr_accessor :component_class
+    end
+
+    def refresh!(primary_selector = nil, *rest)
+      save_state
+
+      if primary_selector.nil? && !component.can_render_to_string?
+        primary_selector = selector
+      end
+      if primary_selector
+        prevent_refresh!
+
+        controller.process(url_params[:action])
+        document = Nokogiri::HTML(controller.response.body)
+        [primary_selector, *rest].each do |s|
+          html = document.css(s)
+          if html.present?
+            cable_ready[channel.stream_name].morph(
+              selector: s,
+              html: html.inner_html,
+              children_only: true,
+              permanent_attribute_name: "data-reflex-permanent"
+            )
+          end
+        end
+      else
+        refresh_component!
+      end
+      cable_ready.broadcast
+    end
+
+    def refresh_component!
+      component.tap do |k|
+        k.define_singleton_method(:key) do
+          element.dataset[:key]
+        end
+      end
+      document = Nokogiri::HTML(controller.render_component_to_string(component))
+      cable_ready[channel.stream_name].morph(
+        selector: selector,
+        children_only: true,
+        html: document.css(selector).inner_html,
+        permanent_attribute_name: "data-reflex-permanent"
+      )
+    end
+
+    def refresh_all!
+      refresh!("body")
+    end
+
+    def selector
+      "[data-controller~=\"#{stimulus_controller}\"][data-key=\"#{element.dataset[:key]}\"]"
+    end
+
+    # SR's delegate_call_to_reflex in channel.rb
+    # uses method to gather the method parameters, but since we're abusing
+    # method_missing here, that'll always fail
+    def method(name)
+      name.to_sym.to_proc
+    end
+
+    def respond_to_missing?(name, _ = false)
+      !!name.to_proc
+    end
+
+    before_reflex do |a|
+      a.send a.method_name
+      throw :abort
+    end
+
+    def method_missing(name, *args)
+      super unless respond_to_missing?(name)
+      state.each do |k, v|
+        component.instance_variable_set(k, v)
+      end
+      name.to_proc.call(component, *args)
+      refresh! unless @prevent_refresh
+    end
+
+    def prevent_refresh!
+      @prevent_refresh = true
+    end
+
+    private
+
+    def component_class
+      self.class.component_class
+    end
+
+    def stimulus_controller
+      component_class.stimulus_controller
+    end
+
+    def stimulate(target, data)
+      dataset = {}
+      data.each do |k, v|
+        dataset["data-#{k}"] = v.to_s
+      end
+      channel.receive({
+        "target" => target,
+        "attrs" => element.attributes.to_h.symbolize_keys,
+        "dataset" => dataset
+      })
+    end
+
+    def component
+      return @component if @component
+      @component = component_class.allocate
+      reflex = self
+      exposed_methods = [:params, :request, :element, :refresh!, :refresh_all!, :stimulus_controller, :session, :prevent_refresh!, :selector, :stimulate]
+      exposed_methods.each do |meth|
+        @component.define_singleton_method(meth) do |*a|
+          reflex.send(meth, *a)
+        end
+      end
+      @component
+    end
+
+    def set_state(new_state = {})
+      ViewComponentReflex::Engine.state_adapter.set_state(request, controller, element.dataset[:key], new_state)
+    end
+
+    def state
+      ViewComponentReflex::Engine.state_adapter.state(request, element.dataset[:key])
+    end
+
+    def save_state
+      new_state = {}
+      component.safe_instance_variables.each do |k|
+        new_state[k] = component.instance_variable_get(k)
+      end
+      set_state(new_state)
+    end
+  end
+end

data/lib/view_component_reflex.rb

@@ -1,7 +1,7 @@
 require "view_component_reflex/state_adapter/session"
 require "view_component_reflex/state_adapter/memory"
 require "view_component_reflex/engine"
-require 'stimulus_reflex'
+require "stimulus_reflex"
 
 module ViewComponentReflex
   # Your code goes here...

data/lib/view_component_reflex/version.rb

@@ -1,3 +1,3 @@
 module ViewComponentReflex
-  VERSION = '1.7.2'
+  VERSION = '2.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: view_component_reflex
 version: !ruby/object:Gem::Version
-  version: 1.7.2
+  version: 2.1.1
 platform: ruby
 authors:
 - Joshua LeBlanc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-06 00:00:00.000000000 Z
+date: 2020-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -69,6 +69,7 @@ files:
 - README.md
 - Rakefile
 - app/components/view_component_reflex/component.rb
+- app/reflexes/view_component_reflex/reflex.rb
 - lib/view_component_reflex.rb
 - lib/view_component_reflex/engine.rb
 - lib/view_component_reflex/state_adapter/memory.rb