hot_module 1.0.0.alpha8 → 1.0.0.alpha10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 990a6f28bab40a5307b988d5409362c5f3b5c913306785acc893b30d01a53ca2
-  data.tar.gz: 52cbe7db9a562446c7d4c5c1b8327863aa2128f9fd78cc55945a48441c212d32
+  metadata.gz: 84445fa8f0ceb1c241dc1497597ff16665383a4bcea444d41569ba673cf51e84
+  data.tar.gz: 8416c036a600a2655c1e1883238d49b9cfefe187b35be5e93f7aa4508c364e15
 SHA512:
-  metadata.gz: ff5eb0bcf2c3c1b3902196b394f61ca7c206a5443c15791e716a441375694c82f8f887b90ff218d7e6fa4626e79b67262e0eae82112e46d31d0e4191b1077e29
-  data.tar.gz: ccebd667ca63b6beb81a4a20eb0f1e9d8aeea34b4b7e15d3efc79776bc60656c5b234b8b8cdf253acfc37bb692feac0c4664e7ffb55274f070d2561d5cce96be
+  metadata.gz: 6285f80875501f2b04b28f10bfdf7f9145a4a5a6843a3f01ed3b3a2c0848d9584b829e1ee5b0048c41d70dde248aa8f506be25155fae1a94472c57c46c77669d
+  data.tar.gz: ca42664335930b9468bdcd0d2e09620cd5b3b81cd2e3dfbc1fd2bd256cabe12515796f7288fa3051d59dfe80fbb5164205f1d906d270ca43e75191b36973228f

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [1.0.0.alpha10] - 2023-04-04
+
+- Update debugging features based on Nokolexbor fixes
+
+## [1.0.0.alpha9] - 2023-04-02
+
+- Add support for [@crystallized/shadow-effects](https://github.com/hotmodule/crystallized/tree/main/packages/shadow-effects) template syntax
+- Let `camelcased` handle symbol arrays, so it works with `attr_reader`
+
 ## [1.0.0.alpha8] - 2023-03-23
 
 - Alias `HoTModuLe` to `HotModule` for people who are annoyed :)

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    hot_module (1.0.0.alpha8)
-      nokolexbor (~> 0.4)
+    hot_module (1.0.0.alpha10)
+      nokolexbor (>= 0.4.2)
 
 GEM
   remote: https://rubygems.org/
@@ -33,9 +33,9 @@ GEM
       racc (~> 1.4)
     nokogiri (1.14.2-x86_64-linux)
       racc (~> 1.4)
-    nokolexbor (0.4.0-arm64-darwin)
+    nokolexbor (0.4.2-arm64-darwin)
     parallel (1.22.1)
-    parser (3.2.1.1)
+    parser (3.2.2.0)
       ast (~> 2.4.1)
     racc (1.6.2)
     rainbow (3.1.1)
@@ -44,17 +44,17 @@ GEM
     reverse_markdown (2.1.1)
       nokogiri
     rexml (3.2.5)
-    rubocop (1.48.1)
+    rubocop (1.49.0)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.2.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.26.0, < 2.0)
+      rubocop-ast (>= 1.28.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.27.0)
+    rubocop-ast (1.28.0)
       parser (>= 3.2.1.0)
     rubocop-minitest (0.22.2)
       rubocop (>= 0.90, < 2.0)

data/README.md

@@ -2,7 +2,7 @@
 
 Parse, mutate, and render custom elements in Ruby using [HTML Modules](https://github.com/WICG/webcomponents/blob/gh-pages/proposals/html-modules-explainer.md).
 
-Great for pairing with [esbuild-plugin-html-modules](https://github.com/whitefusionhq/esbuild-plugin-html-modules) for a full-stack component rendering pipeline.
+Great for pairing with [esbuild-plugin-html-modules](https://github.com/hotmodule/esbuild-plugin-html-modules) for a full-stack component rendering pipeline.
 
 ## Installation
 
@@ -26,7 +26,7 @@ To install this gem onto your local machine, run `bin/rake install`. To release
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/whitefusionhq/hot_module. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/whitefusionhq/hot_module/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/hotmodule/hot_module. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/hotmodule/hot_module/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -34,4 +34,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the HoTModuLe project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/whitefusionhq/hot_module/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the HoTModuLe project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/hotmodule/hot_module/blob/main/CODE_OF_CONDUCT.md).

data/hot_module.gemspec

@@ -9,13 +9,13 @@ Gem::Specification.new do |spec|
   spec.email = ["jared@whitefusion.studio"]
 
   spec.summary = "Parse, mutate, and render HTML Modules in Ruby."
-  spec.homepage = "https://github.com/whitefusionhq/hot_module#readme"
+  spec.homepage = "https://github.com/hotmodule/hot_module#readme"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 3.0"
 
   spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/whitefusionhq/hot_module"
-  spec.metadata["changelog_uri"] = "https://github.com/whitefusionhq/hot_module/blob/main/CHANGELOG.md"
+  spec.metadata["source_code_uri"] = "https://github.com/hotmodule/hot_module"
+  spec.metadata["changelog_uri"] = "https://github.com/hotmodule/hot_module/blob/main/CHANGELOG.md"
   spec.metadata["rubygems_mfa_required"] = "true"
 
   # Specify which files should be added to the gem when it is released.
@@ -27,7 +27,7 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "nokolexbor", "~> 0.4"
+  spec.add_dependency "nokolexbor", ">= 0.4.2"
 
   spec.add_development_dependency "hash_with_dot_access", "~> 1.2"
 end

data/lib/hot_module/fragment.rb

@@ -2,10 +2,12 @@
 
 module HoTModuLe
   class Fragment
-    def initialize(fragment, attribute_bindings, html_module:)
+    def initialize(fragment, component)
       @fragment = fragment
-      @attribute_bindings = attribute_bindings
-      @html_module = html_module
+      @component = component
+      @attribute_bindings = component.class.attribute_bindings.each do |attr_def|
+        attr_def.method = component.method(attr_def.method_name)
+      end
     end
 
     # NOTE: for some reason, the Nokogiri traverse method yields node children first, then the
@@ -32,7 +34,8 @@ module HoTModuLe
           break unless attribute_binding.method.(attribute: attr_node, node: node)
         end
       rescue Exception => e # rubocop:disable Lint/RescueException
-        raise e.class, e.message.lines.first, ["#{@html_module}:#{attr_node}", *e.backtrace]
+        line_segments = [@component.class.html_module, @component.class.line_number_of_node(attr_node)]
+        raise e.class, e.message.lines.first, [line_segments.join(":"), *e.backtrace]
       end
     end
   end

data/lib/hot_module/petite.rb

@@ -23,7 +23,7 @@ module HoTModuLe
       process_list(
         attribute: attribute,
         node: node,
-        item_node: node.children[0].element_children.first,
+        item_node: node.children[0].first_element_child,
         for_in: expression
       )
     end

data/lib/hot_module/shadow_effects.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require "hot_module"
+
+module HoTModuLe
+  module ShadowEffects
+    # rubocop:disable Naming/MethodName
+    module JSPropertyAliases
+      def textContent=(value)
+        self.content = value
+      end
+
+      def innerHTML=(value)
+        self.inner_html = value
+      end
+
+      def method_missing(meth, *args, **kwargs) # rubocop:disable Style/MissingRespondToMissing
+        return super unless meth.to_s.end_with?("=")
+
+        kebob_cased = meth.to_s
+                          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1-\2')
+                          .gsub(/([a-z\d])([A-Z])/, '\1-\2')
+                          .downcase
+
+        self[kebob_cased.delete_suffix("=")] = args[0]
+      end
+    end
+    # rubocop:enable Naming/MethodName
+
+    Nokolexbor::Element.include JSPropertyAliases unless Nokolexbor::Element.instance_methods.include?(:textContent=)
+
+    module ClassMethods
+      def directive(name, &block)
+        @directives ||= {}
+        @directives[name.to_s] = block
+      end
+    end
+
+    # @param klass [Class]
+    # @return [void]
+    def self.included(klass)
+      klass.attribute_binding "host-effect", :_shadow_effect_binding
+
+      klass.singleton_class.attr_reader :directives
+
+      klass.extend ClassMethods
+
+      klass.class_eval do
+        directive :show do |_, element, value|
+          element["hidden"] = "" unless value
+        end
+
+        directive :hide do |_, element, value|
+          element["hidden"] = "" if value
+        end
+
+        directive :classMap do |_, element, obj|
+          obj.each do |k, v|
+            element.add_class k.to_s if v
+          end
+        end
+      end
+    end
+
+    def _shadow_effect_binding(attribute:, node:) # rubocop:disable Metrics
+      syntax = attribute.value
+      statements = syntax.split(";").map(&:strip)
+
+      statements.each do |statement| # rubocop:disable Metrics
+        if statement.start_with?("$el.")
+          # property assignment
+          expression = statement.split("=").map(&:strip)
+          expression[0] = expression[0][4..]
+
+          value = send(expression[1])
+
+          node.send("#{expression[0]}=", value_to_attribute(value))
+        elsif statement.start_with?("$")
+          # directive
+          directive_name, args_str = statement.strip.match(/(.*)\((.*)\)/).captures
+          arg_strs = args_str.split(",").map(&:strip)
+          arg_strs.unshift("$el")
+
+          if self.class.directives[directive_name.strip[1..]]
+            args = arg_strs.map do |arg_str|
+              next node if arg_str == "$el"
+
+              next arg_str[1...-1] if arg_str.start_with?("'") # string literal
+
+              send(arg_str)
+            end
+
+            self.class.directives[directive_name.strip[1..]]&.(self, *args)
+          end
+        else
+          # method call
+          method_name, args_str = statement.strip.match(/(.*)\((.*)\)/).captures
+          arg_strs = args_str.split(",").map(&:strip)
+
+          args = arg_strs.map do |arg_str|
+            next node if arg_str == "$el"
+
+            next arg_str[1...-1] if arg_str.start_with?("'") # string literal
+
+            send(arg_str)
+          end
+
+          send(method_name.strip, *args)
+        end
+      end
+    end
+  end
+end

data/lib/hot_module/version.rb

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

data/lib/hot_module.rb

@@ -35,8 +35,10 @@ module HoTModuLe
 
   # Extends the component class
   module ClassMethods
-    def camelcased(method_symbol)
-      alias_method(method_symbol.to_s.gsub(/(?!^)_[a-z0-9]/) { |match| match[1].upcase }, method_symbol)
+    def camelcased(method_symbols)
+      Array(method_symbols).each do |method_symbol|
+        alias_method(method_symbol.to_s.gsub(/(?!^)_[a-z0-9]/) { |match| match[1].upcase }, method_symbol)
+      end
     end
 
     def html_file_extensions = %w[module.html tmpl.html html].freeze
@@ -90,9 +92,15 @@ module HoTModuLe
 
     # @return [Nokogiri::XML::Element]
     def doc
-      @doc ||= Nokolexbor::DocumentFragment.parse(
-        "<#{tag_name}>#{File.read(html_module).strip}</#{tag_name}>"
-      ).element_children.first
+      @doc ||= begin
+        @doc_html = "<#{tag_name}>#{File.read(html_module).strip}</#{tag_name}>"
+        Nokolexbor::DocumentFragment.parse(@doc_html).first_element_child
+      end
+    end
+
+    def line_number_of_node(node)
+      loc = node.source_location
+      instance_variable_get(:@doc_html)[0..loc].count("\n") + 1
     end
 
     def attribute_bindings
@@ -216,10 +224,7 @@ module HoTModuLe
   # @param fragment [Nokogiri::XML::Element]
   # @return [void]
   def process_fragment(fragment)
-    Fragment.new(
-      fragment, self.class.attribute_bindings.each { _1.method = method(_1.method_name) },
-      html_module: self.class.html_module
-    ).process
+    Fragment.new(fragment, self).process
   end
 
   def process_list(attribute:, node:, item_node:, for_in:) # rubocop:disable Metrics
@@ -245,10 +250,7 @@ module HoTModuLe
         _context_locals[lh[0]] = list_item
         _context_locals[lh[1]] = index if lh[1]
 
-        Fragment.new(
-          new_node, self.class.attribute_bindings,
-          html_module: self.class.html_module
-        ).process
+        Fragment.new(new_node, self).process
       end
     end
   end
@@ -258,7 +260,7 @@ module HoTModuLe
     _context_locals.keys.reverse_each do |name|
       eval_code = "#{name} = _context_locals[\"#{name}\"];" + eval_code
     end
-    instance_eval(eval_code, self.class.html_module) # , attribute.line)
+    instance_eval(eval_code, self.class.html_module, self.class.line_number_of_node(attribute))
   end
 
   def class_list_for(obj)

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: hot_module
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha8
+  version: 1.0.0.alpha10
 platform: ruby
 authors:
 - Jared White
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-25 00:00:00.000000000 Z
+date: 2023-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokolexbor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 0.4.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 0.4.2
 - !ruby/object:Gem::Dependency
   name: hash_with_dot_access
   requirement: !ruby/object:Gem::Requirement
@@ -60,14 +60,15 @@ files:
 - lib/hot_module/fragment.rb
 - lib/hot_module/petite.rb
 - lib/hot_module/query_selection.rb
+- lib/hot_module/shadow_effects.rb
 - lib/hot_module/version.rb
-homepage: https://github.com/whitefusionhq/hot_module#readme
+homepage: https://github.com/hotmodule/hot_module#readme
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/whitefusionhq/hot_module#readme
-  source_code_uri: https://github.com/whitefusionhq/hot_module
-  changelog_uri: https://github.com/whitefusionhq/hot_module/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/hotmodule/hot_module#readme
+  source_code_uri: https://github.com/hotmodule/hot_module
+  changelog_uri: https://github.com/hotmodule/hot_module/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []