emjay 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7e892dd10debedb98375075acbc595f229f28a1cf7976a90444748f123236b8
-  data.tar.gz: adfb7062c1f9ca6d7a7926f9add058896e1d71078a795a64f0638cc036ad387e
+  metadata.gz: 44b1f5f2d6b785a000c044f8910beb812ab3b851fa5aa9a9950bdafc14842cd3
+  data.tar.gz: ff1959f81bd0468820a03c87a64396a63a14fcc4b90cc11465021519e704bd70
 SHA512:
-  metadata.gz: b337e7f6f0ebeece8666fed2347bd0f00a5e1b814312b25d9ec81c31021749f7e81d576e4c318f38cc2c81fcc8560bb9914a9a146cf77d5a8729ada51510f046
-  data.tar.gz: 5b3b358d75521a337ef0ee78af3b1d7929dd8cdcec194d2762332619f067558e9a04289686364d8627e50cf4963ec6bd192de72c1d78bd17c371388b972e56cd
+  metadata.gz: 2b137f248b18a2d4128e58626158b70e607d74e600f2096df7c0d920cfd9b4411c04912dc1e5a8e244aec4e201718edc62396c6ecb65bf53185c28e8e56204d6
+  data.tar.gz: ba4fceec3711cb71600ecc8eaee52865a873a34aabbf952ac40487903024bb266062689b95cf12b285fab4072eb6b52dcc4fc38156b7eb12b60ebec154353922

data/lib/emjay/components/body/mj_accordion.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -94,6 +93,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjAccordion)
 end

data/lib/emjay/components/body/mj_accordion_element.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/conditional_tag"
 
 module Emjay
@@ -122,6 +121,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjAccordionElement)
 end

data/lib/emjay/components/body/mj_accordion_text.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -118,6 +117,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjAccordionText)
 end

data/lib/emjay/components/body/mj_accordion_title.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/conditional_tag"
 
 module Emjay
@@ -166,6 +165,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjAccordionTitle)
 end

data/lib/emjay/components/body/mj_body.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -65,6 +64,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjBody)
 end

data/lib/emjay/components/body/mj_button.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/width_parser"
 
 module Emjay
@@ -193,6 +192,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjButton)
 end

data/lib/emjay/components/body/mj_carousel.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/conditional_tag"
 require_relative "../../helpers/gen_random_hex_string"
 
@@ -405,6 +404,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjCarousel)
 end

data/lib/emjay/components/body/mj_carousel_image.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/suffix_css_classes"
 
 module Emjay
@@ -183,6 +182,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjCarouselImage)
 end

data/lib/emjay/components/body/mj_column.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/width_parser"
 
 module Emjay
@@ -250,7 +249,7 @@ module Emjay
         if unit == "px"
           floor_width = reduced.floor
           fractional = reduced - floor_width
-          extra = [0, [sibling, (sibling * fractional).round].min].max
+          extra = (sibling * fractional).round.clamp(0, sibling)
           {parsed_width: floor_width + ((index < extra) ? 1 : 0), unit: unit}
         else
           {parsed_width: reduced, unit: unit}
@@ -425,6 +424,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjColumn)
 end

data/lib/emjay/components/body/mj_divider.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/width_parser"
 
 module Emjay
@@ -115,6 +114,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjDivider)
 end

data/lib/emjay/components/body/mj_group.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/width_parser"
 
 module Emjay
@@ -191,6 +190,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjGroup)
 end

data/lib/emjay/components/body/mj_hero.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/width_parser"
 
 module Emjay
@@ -377,6 +376,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjHero)
 end

data/lib/emjay/components/body/mj_image.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/width_parser"
 require_relative "../../helpers/make_lower_breakpoint"
 
@@ -183,6 +182,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjImage)
 end

data/lib/emjay/components/body/mj_navbar.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/conditional_tag"
 require_relative "../../helpers/make_lower_breakpoint"
 require_relative "../../helpers/gen_random_hex_string"
@@ -182,6 +181,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjNavbar)
 end

data/lib/emjay/components/body/mj_navbar_link.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/conditional_tag"
 require_relative "../../helpers/suffix_css_classes"
 
@@ -124,6 +123,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjNavbarLink)
 end

data/lib/emjay/components/body/mj_raw.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -29,6 +28,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjRaw)
 end

data/lib/emjay/components/body/mj_section.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/suffix_css_classes"
 
 module Emjay
@@ -440,6 +439,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjSection)
 end

data/lib/emjay/components/body/mj_social.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -169,6 +168,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjSocial)
 end

data/lib/emjay/components/body/mj_social_element.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -270,6 +269,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjSocialElement)
 end

data/lib/emjay/components/body/mj_spacer.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -52,6 +51,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjSpacer)
 end

data/lib/emjay/components/body/mj_table.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/width_parser"
 
 module Emjay
@@ -108,6 +107,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjTable)
 end

data/lib/emjay/components/body/mj_text.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../body_component"
-require_relative "../../registry"
 require_relative "../../helpers/conditional_tag"
 
 module Emjay
@@ -95,6 +94,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjText)
 end

data/lib/emjay/components/body/mj_wrapper.rb

@@ -51,6 +51,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjWrapper)
 end

data/lib/emjay/components/head/mj_attributes.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -33,6 +32,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjAttributes)
 end

data/lib/emjay/components/head/mj_breakpoint.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -23,6 +22,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjBreakpoint)
 end

data/lib/emjay/components/head/mj_font.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -19,6 +18,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjFont)
 end

data/lib/emjay/components/head/mj_head.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -15,6 +14,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjHead)
 end

data/lib/emjay/components/head/mj_html_attributes.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -28,6 +27,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjHtmlAttributes)
 end

data/lib/emjay/components/head/mj_preview.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -19,6 +18,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjPreview)
 end

data/lib/emjay/components/head/mj_style.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -29,6 +28,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjStyle)
 end

data/lib/emjay/components/head/mj_title.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "../../head_component"
-require_relative "../../registry"
 
 module Emjay
   module Components
@@ -19,6 +18,4 @@ module Emjay
       end
     end
   end
-
-  Registry.register(Components::MjTitle)
 end

data/lib/emjay/railtie.rb

@@ -2,11 +2,21 @@
 
 module Emjay
   class Railtie < Rails::Railtie
-    initializer "emjay.register_template_handler_and_interceptor" do
-      ActiveSupport.on_load(:action_mailer) do
+    # Register the template handler on :action_view load, not :action_mailer.
+    # ActionView's FileSystemResolver builds its PathParser regex from the
+    # registered extensions on first template lookup; if ActionView loads
+    # before ActionMailer (e.g. a controller renders a view first), the
+    # regex is cached without :mjml and .html.mjml templates stay invisible
+    # for the rest of the process.
+    initializer "emjay.register_template_handler" do
+      ActiveSupport.on_load(:action_view) do
         require "emjay/rails/template_handler"
         ActionView::Template.register_template_handler(:mjml, Emjay::Rails::TemplateHandler)
+      end
+    end
 
+    initializer "emjay.register_mail_interceptor" do
+      ActiveSupport.on_load(:action_mailer) do
         require "emjay/rails/mail_interceptor"
         interceptor = Emjay::Rails::MailInterceptor
         ActionMailer::Base.register_interceptor(interceptor)

data/lib/emjay/registry.rb

@@ -1,19 +1,79 @@
 # frozen_string_literal: true
 
 module Emjay
+  # Lazy autoloader for MJML components. Scans `lib/emjay/components/**/*.rb`
+  # once at load time, then derives both the MJML tag name and the Ruby class
+  # from each filename:
+  #
+  #   components/body/mj_button.rb  →  tag "mj-button"  →  Emjay::Components::MjButton
+  #
+  # Files are `require`d and constants resolved on first `find`.
   module Registry
-    @components = {}
+    class UnknownComponent < StandardError; end
 
-    def self.register(component_class)
-      @components[component_class.component_name] = component_class
-    end
+    COMPONENTS_ROOT = File.expand_path("components", __dir__)
+
+    PATHS = Dir.glob("{head,body}/*.rb", base: COMPONENTS_ROOT).sort.each_with_object({}) do |rel, h|
+      basename = File.basename(rel, ".rb") # e.g. "mj_html_attributes"
+      tag = basename.tr("_", "-")           # → "mj-html-attributes"
+      h[tag] = File.join(COMPONENTS_ROOT, rel)
+    end.freeze
+
+    @loaded = {}
+    @mutex = Mutex.new
 
     def self.find(tag_name)
-      @components[tag_name]
+      @loaded[tag_name] ||= load_component(tag_name)
     end
 
     def self.components
-      @components
+      @components ||= LazyComponents.new
+    end
+
+    # Kept for backwards compatibility with callers that eagerly register.
+    def self.register(component_class)
+      @loaded[component_class.component_name] = component_class
+    end
+
+    def self.load_component(tag_name)
+      path = PATHS[tag_name] or return nil
+      @mutex.synchronize do
+        return @loaded[tag_name] if @loaded[tag_name]
+        require path
+        const_name = File.basename(path, ".rb").split("_").map(&:capitalize).join
+        Emjay::Components.const_get(const_name)
+      end
+    end
+
+    # The renderer treats `Registry.components` as a hash keyed by tag name.
+    # This proxy resolves each lookup through `Registry.find` so components
+    # only load when actually referenced.
+    class LazyComponents
+      include Enumerable
+
+      def [](tag_name)
+        component = Registry.find(tag_name)
+        # We only reach here on render paths (never during parsing, which uses
+        # Registry.find directly and tolerates nil). If a tag looks like MJML
+        # but resolves to nothing, it's almost certainly a typo like
+        # `<mj-nonesuch>` — surface it instead of silently rendering blank.
+        if component.nil? && tag_name.to_s.start_with?("mj-")
+          raise UnknownComponent, "Unknown MJML component #{tag_name.inspect}"
+        end
+        component
+      end
+
+      def each
+        PATHS.each_key { |tag| yield tag, Registry.find(tag) }
+      end
+
+      def keys
+        PATHS.keys
+      end
+
+      def values
+        PATHS.each_key.map { |tag| Registry.find(tag) }
+      end
     end
   end
 end

data/lib/emjay/renderer.rb

@@ -185,9 +185,11 @@ module Emjay
 
       children = element.children.select(&:element?).map { |child| nokogiri_to_hash(child) }
 
-      # For ending-tag components, content is the inner HTML
+      # For ending-tag components, content is the inner HTML. Only MJML tags
+      # can be components — plain HTML (e.g. <a>, <b> nested in mj-text) never
+      # is, so don't waste a Registry lookup on it.
       tag_name = element.name
-      component_class = Registry.find(tag_name)
+      component_class = tag_name.start_with?("mj-") ? Registry.find(tag_name) : nil
       content = if component_class&.ending_tag?
         inner = element.inner_html.strip
         # Restore escaped bare < characters (from template syntax in mj-raw etc.)

data/lib/emjay/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Emjay
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/emjay.rb

@@ -22,40 +22,7 @@ require_relative "emjay/helpers/styles"
 require_relative "emjay/helpers/make_lower_breakpoint"
 require_relative "emjay/helpers/gen_random_hex_string"
 
-# Head components
-require_relative "emjay/components/head/mj_head"
-require_relative "emjay/components/head/mj_attributes"
-require_relative "emjay/components/head/mj_style"
-require_relative "emjay/components/head/mj_font"
-require_relative "emjay/components/head/mj_title"
-require_relative "emjay/components/head/mj_preview"
-require_relative "emjay/components/head/mj_breakpoint"
-require_relative "emjay/components/head/mj_html_attributes"
-
-# Body components
-require_relative "emjay/components/body/mj_body"
-require_relative "emjay/components/body/mj_section"
-require_relative "emjay/components/body/mj_column"
-require_relative "emjay/components/body/mj_text"
-require_relative "emjay/components/body/mj_wrapper"
-require_relative "emjay/components/body/mj_group"
-require_relative "emjay/components/body/mj_image"
-require_relative "emjay/components/body/mj_button"
-require_relative "emjay/components/body/mj_divider"
-require_relative "emjay/components/body/mj_spacer"
-require_relative "emjay/components/body/mj_table"
-require_relative "emjay/components/body/mj_raw"
-require_relative "emjay/components/body/mj_hero"
-require_relative "emjay/components/body/mj_social"
-require_relative "emjay/components/body/mj_social_element"
-require_relative "emjay/components/body/mj_navbar"
-require_relative "emjay/components/body/mj_navbar_link"
-require_relative "emjay/components/body/mj_accordion"
-require_relative "emjay/components/body/mj_accordion_element"
-require_relative "emjay/components/body/mj_accordion_title"
-require_relative "emjay/components/body/mj_accordion_text"
-require_relative "emjay/components/body/mj_carousel"
-require_relative "emjay/components/body/mj_carousel_image"
+# Components are autoloaded on demand via Emjay::Registry — see registry.rb.
 
 module Emjay
   def self.to_html(mjml_string, options = {})

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: emjay
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Julik Tarkhanov
 bindir: bin
 cert_chain: []
-date: 2026-08-19 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri