hot_module 1.0.0.alpha10 → 1.0.0.alpha12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84445fa8f0ceb1c241dc1497597ff16665383a4bcea444d41569ba673cf51e84
-  data.tar.gz: 8416c036a600a2655c1e1883238d49b9cfefe187b35be5e93f7aa4508c364e15
+  metadata.gz: 51da117a031a9b9ad3c16a35b4b5276928874e742bf72e90bc9e1089f4b856a1
+  data.tar.gz: b1bb49f906b3dbc82671ec7a4850baac1899c93ce3237cc88c8bb3c69dff75f3
 SHA512:
-  metadata.gz: 6285f80875501f2b04b28f10bfdf7f9145a4a5a6843a3f01ed3b3a2c0848d9584b829e1ee5b0048c41d70dde248aa8f506be25155fae1a94472c57c46c77669d
-  data.tar.gz: ca42664335930b9468bdcd0d2e09620cd5b3b81cd2e3dfbc1fd2bd256cabe12515796f7288fa3051d59dfe80fbb5164205f1d906d270ca43e75191b36973228f
+  metadata.gz: 0b6b8661ec4ee9f416eff3373a049c126a744e5bd280ddf88fac6d896f58df1f844f170ddc85d5addbd099e70e5fc8f5d3421a966ea5b13bba2f568eb2bc8f86
+  data.tar.gz: d50b1b02e71f78e14ebde1c8c08abcd80eb79911fd1fafcf15de6a89ea5c412db50ddeecc23e804f05acee61b8d75d1be8ca5bef38937105b779f32b39b4e6e4

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    hot_module (1.0.0.alpha10)
+    hot_module (1.0.0.alpha12)
+      concurrent-ruby (~> 1.2)
       nokolexbor (>= 0.4.2)
 
 GEM

data/hot_module.gemspec

@@ -27,6 +27,7 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ["lib"]
 
+  spec.add_dependency "concurrent-ruby", "~> 1.2"
   spec.add_dependency "nokolexbor", ">= 0.4.2"
 
   spec.add_development_dependency "hash_with_dot_access", "~> 1.2"

data/lib/hot_module/component_renderer.rb

@@ -7,21 +7,16 @@ module HoTModuLe
 
   class ComponentRenderer < Bridgetown::Builder
     def build
-      registered_tags = {}
-      Bridgetown::Component.subclasses.each do |component|
-        next unless component.respond_to?(:tag_name)
-
-        registered_tags[component.tag_name] = component
-      end
-
-      render_html_modules(registered_tags)
+      render_html_modules
     end
 
-    def render_html_modules(registered_tags) # rubocop:todo Metrics
-      inspect_html do |doc, resource| # rubocop:todo Metrics
+    # rubocop:todo Metrics
+    def render_html_modules
+      inspect_html do |doc, resource|
         view_context = HoTModuLe::View.new(resource)
 
-        registered_tags.each do |tag_name, component|
+        HoTModuLe.registered_elements.each do |component|
+          tag_name = component.tag_name
           doc.xpath("//#{tag_name}").reverse.each do |node|
             if node["hmod:ignore"]
               node.attribute("hmod:ignore").remove
@@ -33,9 +28,9 @@ module HoTModuLe
 
             new_attrs = {}
             attrs.each do |k, v|
-              next unless k.start_with?("ruby:")
+              next unless k.start_with?("arg:")
 
-              new_key = k.delete_prefix("ruby:")
+              new_key = k.delete_prefix("arg:")
               attrs.delete(k)
               new_attrs[new_key] = resource.instance_eval(v)
             end
@@ -54,5 +49,6 @@ module HoTModuLe
         end
       end
     end
+    # rubocop:enable Metrics
   end
 end

data/lib/hot_module/fragment.rb

@@ -10,9 +10,9 @@ module HoTModuLe
       end
     end
 
-    # NOTE: for some reason, the Nokogiri traverse method yields node children first, then the
-    # parent node. That doesn't work for our case. We want to go strictly in source order. So this
-    # is our own implementation of that.
+    # NOTE: for some reason, the traverse method yields node children first, then the
+    # parent node. That doesn't work for our case. We want to go strictly in source order.
+    # So this is our own implementation of that.
     def traverse(node, &block)
       yield(node)
       node.children.each { |child| traverse(child, &block) }

data/lib/hot_module/query_selection.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
 module HoTModuLe
-  # Add a couple familar DOM API features to Nokogiri
+  # Add a couple familar DOM API features to Nokolexbor
   module QuerySelection
     # @param selector [String]
-    # @return [Nokogiri::XML::Element]
+    # @return [Nokolexbor::Element]
     def query_selector(selector) = at_css(selector)
 
     # @param selector [String]
-    # @return [Nokogiri::XML::Element]
+    # @return [Nokolexbor::Element]
     def query_selector_all(selector) = css(selector)
   end
 

data/lib/hot_module/version.rb

@@ -2,5 +2,5 @@
 
 module HoTModuLe
   # @return [String]
-  VERSION = "1.0.0.alpha10"
+  VERSION = "1.0.0.alpha12"
 end

data/lib/hot_module.rb

@@ -3,6 +3,7 @@
 require_relative "hot_module/version"
 
 require "nokolexbor"
+require "concurrent"
 
 # Include this module into your own component class
 module HoTModuLe
@@ -23,10 +24,35 @@ module HoTModuLe
   require_relative "hot_module/fragment"
   require_relative "hot_module/query_selection"
 
+  def self.registered_elements
+    @registered_elements ||= Concurrent::Set.new
+
+    @registered_elements.each do |component|
+      begin
+        next if Kernel.const_get(component.to_s) == component # thin out unloaded consts
+      rescue NameError; end # rubocop:disable Lint/SuppressedException
+
+      @registered_elements.delete component
+    end
+
+    @registered_elements
+  end
+
+  def self.register_element(component)
+    @registered_elements ||= Concurrent::Set.new
+    @registered_elements << component
+  end
+
   # @param klass [Class]
   # @return [void]
   def self.included(klass)
     klass.extend ClassMethods
+
+    klass.attribute_binding "hmod:children", :_hmod_children_binding, only: :template
+    klass.attribute_binding "hmod:replace", :_hmod_replace_binding
+    klass.attribute_binding "hmod:text", :_hmod_expr_binding
+    klass.attribute_binding "hmod:html", :_hmod_expr_binding
+
     # Don't stomp on a superclass's `content` method
     return if klass.instance_methods.include?(:content)
 
@@ -41,7 +67,8 @@ module HoTModuLe
       end
     end
 
-    def html_file_extensions = %w[module.html tmpl.html html].freeze
+    def html_file_extensions = %w[module.html mod.html html].freeze
+
     def processed_css_extension = "css-local"
 
     # @param tag_name [String]
@@ -54,43 +81,42 @@ module HoTModuLe
         raise HoTModuLe::Error, "You must either supply a file path argument or respond to `source_location'"
       end
 
-      @tag_name = tag_name
+      self.tag_name tag_name
 
       if html_module
-        @html_module = html_module
+        self.html_module html_module
       else
         basepath = File.join(File.dirname(source_location), File.basename(source_location, ".*"))
 
-        @html_module = html_file_extensions.lazy.filter_map do |ext|
+        self.html_module(html_file_extensions.lazy.filter_map do |ext|
           path = "#{basepath}.#{ext}"
           File.exist?(path) ? path : nil
-        end.first
+        end.first)
 
         raise HoTModuLe::Error, "Cannot find sidecar HTML module for `#{self}'" unless @html_module
       end
 
-      @shadow_root = shadow_root
+      self.shadow_root shadow_root
     end
 
     # @param value [String]
     # @return [String]
     def tag_name(value = nil)
-      @tag_name ||= value
+      @tag_name ||= begin
+        HoTModuLe.register_element self
+        value
+      end
     end
 
     # @param value [String]
     # @return [String]
-    def html_module(value = nil)
-      @html_module ||= value
-    end
+    def html_module(value = nil) = @html_module ||= value
 
     # @param value [Boolean]
     # @return [Boolean]
-    def shadow_root(value = nil)
-      @shadow_root ||= value
-    end
+    def shadow_root(value = nil) = @shadow_root ||= value
 
-    # @return [Nokogiri::XML::Element]
+    # @return [Nokolexbor::Element]
     def doc
       @doc ||= begin
         @doc_html = "<#{tag_name}>#{File.read(html_module).strip}</#{tag_name}>"
@@ -103,9 +129,7 @@ module HoTModuLe
       instance_variable_get(:@doc_html)[0..loc].count("\n") + 1
     end
 
-    def attribute_bindings
-      @attribute_bindings ||= []
-    end
+    def attribute_bindings = @attribute_bindings ||= []
 
     def attribute_binding(matcher, method_name, only: nil)
       attribute_bindings << AttributeBinding.new(
@@ -117,22 +141,21 @@ module HoTModuLe
   end
 
   module ContentMethod
-    # @return [String, Nokogiri::XML::Element]
-    def content; end
+    # @return [String, Nokolexbor::Element]
+    def content = @_content
   end
 
   # Override in component
   #
   # @return [Hash]
-  def attributes
-    {}
-  end
+  def attributes = {}
 
   # @param attributes [Hash]
-  # @param content [String, Nokogiri::XML::Element]
+  # @param content [String, Nokolexbor::Element]
   # @param return_node [Boolean]
   def render_element(attributes: self.attributes, content: self.content, return_node: false) # rubocop:disable Metrics
     doc = self.class.doc.clone
+    @_content = content
 
     tmpl_el = doc.css("> template").find { _1.attributes.empty? }
 
@@ -146,6 +169,33 @@ module HoTModuLe
     # Process all the template bits
     process_fragment(tmpl_el)
 
+    HoTModuLe.registered_elements.each do |component|
+      tmpl_el.children[0].css(component.tag_name).reverse.each do |node|
+        if node["hmod:ignore"]
+          node.attribute("hmod:ignore").remove
+          next
+        end
+
+        attrs = node.attributes.transform_values(&:value)
+        attrs.reject! { |k| k.start_with?("hmod:") }
+        new_attrs = {}
+        attrs.each do |k, v|
+          next unless k.start_with?("arg:")
+
+          new_key = k.delete_prefix("arg:")
+          attrs.delete(k)
+          new_attrs[new_key] = instance_eval(v, self.class.html_module, self.class.line_number_of_node(node))
+        end
+        attrs.merge!(new_attrs)
+        attrs.transform_keys!(&:to_sym)
+
+        new_node = node.replace(
+          component.new(**attrs).render_element(content: node.children)
+        )
+        new_node.first.attribute("hmod:ignore")&.remove
+      end
+    end
+
     # Set attributes on the custom element
     attributes.each { |k, v| doc[k.to_s.tr("_", "-")] = value_to_attribute(v) if v }
 
@@ -182,14 +232,15 @@ module HoTModuLe
       style_tag.content = output_styles
     end
 
+    child_content = @_replaced_children || content
     if self.class.shadow_root
       # Guess what? We can reuse the same template tag! =)
       tmpl_el["shadowrootmode"] = "open"
       tmpl_el.children[0] << style_tag if style_tag
-      doc << content if content
+      doc << child_content if child_content
     else
       tmpl_el.children[0] << style_tag if style_tag
-      tmpl_el.children[0].at_css("slot:not([name])")&.swap(content) if content
+      tmpl_el.children[0].at_css("slot:not([name])")&.swap(child_content) if child_content
       tmpl_el.children[0].children.each do |node|
         doc << node
       end
@@ -200,13 +251,9 @@ module HoTModuLe
     return_node ? doc : doc.to_html
   end
 
-  def call(...)
-    render_element(...)
-  end
+  def call(...) = render_element(...)
 
-  def inspect
-    "#<#{self.class.name} #{attributes}>"
-  end
+  def inspect = "#<#{self.class.name} #{attributes}>"
 
   def value_to_attribute(val)
     case val
@@ -219,13 +266,15 @@ module HoTModuLe
     end
   end
 
+  def node_or_string(val)
+    val.is_a?(Nokolexbor::Node) ? val : val.to_s
+  end
+
   # Override in component if need be, otherwise we'll use the node walker/binding pipeline
   #
-  # @param fragment [Nokogiri::XML::Element]
+  # @param fragment [Nokolexbor::Element]
   # @return [void]
-  def process_fragment(fragment)
-    Fragment.new(fragment, self).process
-  end
+  def process_fragment(fragment) = Fragment.new(fragment, self).process
 
   def process_list(attribute:, node:, item_node:, for_in:) # rubocop:disable Metrics
     _context_nodes.push(node)
@@ -275,13 +324,9 @@ module HoTModuLe
     end.join(" ")
   end
 
-  def _context_nodes
-    @_context_nodes ||= []
-  end
+  def _context_nodes = @_context_nodes ||= []
 
-  def _context_locals
-    @_context_locals ||= {}
-  end
+  def _context_locals = @_context_locals ||= {}
 
   def _check_stack(node)
     node_and_ancestors = [node, *node.ancestors.to_a]
@@ -303,6 +348,31 @@ module HoTModuLe
     yield previous_context
     @_context_locals = previous_context
   end
+
+  def _hmod_children_binding(attribute:, node:) # rubocop:disable Lint/UnusedMethodArgument
+    @_replaced_children = node.children[0]
+    node.remove
+  end
+
+  def _hmod_replace_binding(attribute:, node:)
+    if node.name == "template"
+      node.children[0].inner_html = node_or_string(evaluate_attribute_expression(attribute))
+      node.replace(node.children[0].children)
+    else
+      node.inner_html = node_or_string(evaluate_attribute_expression(attribute))
+      node.replace(node.children)
+    end
+  end
+
+  def _hmod_expr_binding(attribute:, node:)
+    if attribute.name.end_with?(":text")
+      node.content = node_or_string(evaluate_attribute_expression(attribute))
+      attribute.parent.delete(attribute.name)
+    elsif attribute.name.end_with?(":html")
+      node.inner_html = node_or_string(evaluate_attribute_expression(attribute))
+      attribute.parent.delete(attribute.name)
+    end
+  end
 end
 
 if defined?(Bridgetown)

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: hot_module
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha10
+  version: 1.0.0.alpha12
 platform: ruby
 authors:
 - Jared White
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-05 00:00:00.000000000 Z
+date: 2023-04-08 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: nokolexbor
   requirement: !ruby/object:Gem::Requirement