emjay 0.1.2 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 236a4d64e435fdf2e8616ef9212e7ce2cf4cf3d58c56e0fa5bb5b09783b807f7
-  data.tar.gz: bbc45d8d1ce8f19fb991c7741e8ce819d38dc9aac9c42582ccd7105fffe914c7
+  metadata.gz: 44b1f5f2d6b785a000c044f8910beb812ab3b851fa5aa9a9950bdafc14842cd3
+  data.tar.gz: ff1959f81bd0468820a03c87a64396a63a14fcc4b90cc11465021519e704bd70
 SHA512:
-  metadata.gz: 7888e15b605b12cd5087271dea4982fa3b3a1a663bf97a9e93148982e94404e2b363928d5b0b66ab914d420bf9b37f0e7482fcba924db88f4184e98421e2dd19
-  data.tar.gz: 70ab5c53cf4b2302dc940ca0d9664705437174e5d6d5a64acf6536f8d1cb2f418d4e97b18dc2f003dc81131d87cb4332b49da109d9bed6e0e846978ee9843386
+  metadata.gz: 2b137f248b18a2d4128e58626158b70e607d74e600f2096df7c0d920cfd9b4411c04912dc1e5a8e244aec4e201718edc62396c6ecb65bf53185c28e8e56204d6
+  data.tar.gz: ba4fceec3711cb71600ecc8eaee52865a873a34aabbf952ac40487903024bb266062689b95cf12b285fab4072eb6b52dcc4fc38156b7eb12b60ebec154353922

data/README.md

@@ -12,7 +12,7 @@ emjay implements the full set of standard MJML components:
 
 **Features:** CSS inlining via `<mj-style inline="inline">`, global default attributes, `mj-class`, `mj-html-attributes` with CSS selectors, custom fonts, responsive breakpoints, Outlook conditionals, `lang`/`dir` attributes.
 
-All components and features from the [MJML documentation](https://documentation.mjml.io/) should work as described. The [MJML templates and examples](https://mjml.io/templates) are a good starting point for building your own emails. Output is tested against the upstream [MJML 4 JavaScript implementation](https://github.com/mjmlio/mjml) using fixture-based comparison and backported behavioral tests. If you find a case where emjay produces different output from the reference MJML implementation, please [open an issue](https://github.com/julik/emjay/issues).
+All components and features from the [MJML documentation](https://documentation.mjml.io/) should work as described. The [MJML templates and examples](https://mjml.io/templates) are a good starting point for building your own emails. Output is tested against the upstream [MJML 5.4.0 JavaScript implementation](https://github.com/mjmlio/mjml/tree/5.4.0) using fixture-based comparison and backported behavioral tests. If you find a case where emjay produces different output from the reference MJML implementation, please [open an issue](https://github.com/julik/emjay/issues).
 
 ## Installation
 
@@ -141,6 +141,10 @@ MJML partials work with the standard `render` helper. Use them to share common s
 </mj-section>
 ```
 
+### mj-include is not supported
+
+emjay does not implement MJML's `<mj-include />` file-inclusion directive. In a Rails app, use standard ERB partials via `<%= render "shared/header" %>` (as shown above) — partials also accept locals, which `mj-include` does not.
+
 ### How it works
 
 The `.mjml` template handler is an ERB passthrough — it does not compile MJML itself. Instead, an ActionMailer interceptor (`Emjay::Rails::MailInterceptor`) compiles the assembled MJML to HTML after Rails has applied layouts and partials. This means `yield` in a layout receives MJML (not HTML), and the full document is compiled in one pass.

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
@@ -71,6 +70,8 @@ module Emjay
       def get_styles
         has_br = has_border_radius?
         has_ibr = has_inner_border_radius?
+        outlook_gutter = get_outlook_gutter_styles
+        mobile_gutter = get_mobile_gutter_styles
 
         table_style = {
           "background-color" => get_attribute("background-color"),
@@ -91,7 +92,8 @@ module Emjay
             "direction" => get_attribute("direction"),
             "display" => "inline-block",
             "vertical-align" => get_attribute("vertical-align"),
-            "width" => get_mobile_width
+            "width" => get_mobile_width,
+            **mobile_gutter
           },
           table: {
             **(has_gutter? ? {
@@ -107,7 +109,8 @@ module Emjay
           },
           tdOutlook: {
             "vertical-align" => get_attribute("vertical-align"),
-            "width" => get_width_as_pixel
+            "width" => get_width_as_pixel,
+            **outlook_gutter
           },
           gutter: {
             **table_style,
@@ -121,7 +124,9 @@ module Emjay
       end
 
       def render
-        classes_name = "#{get_column_class} mj-outlook-group-fix"
+        classes_name = get_column_class.dup
+        classes_name += " #{get_desktop_gutter_class_name}" if has_column_gutter?
+        classes_name += " mj-outlook-group-fix"
         css_class = get_attribute("css-class")
         classes_name += " #{css_class}" if css_class
 
@@ -180,15 +185,20 @@ module Emjay
       def get_column_class
         add_media_query = @context[:add_media_query]
 
-        parsed = get_parsed_width
-        formatted = format_float(parsed[:parsed_width]).to_s.tr(".", "-")
+        parsed = has_column_gutter? ? get_desktop_width : get_parsed_width
+        normalized = (parsed[:unit] == "px") ? normalize_px_value(parsed[:parsed_width]) : parsed[:parsed_width]
+        formatted = format_float(normalized).to_s.tr(".", "-")
 
         class_name = case parsed[:unit]
         when "%" then "mj-column-per-#{formatted}"
         else "mj-column-px-#{formatted}"
         end
 
-        add_media_query&.call(class_name, parsed)
+        add_media_query&.call(class_name, {unit: parsed[:unit], parsed_width: normalized})
+
+        if has_column_gutter? && !@context[:is_in_group]
+          add_media_query&.call(get_desktop_gutter_class_name, {padding: get_desktop_padding})
+        end
 
         class_name
       end
@@ -198,6 +208,138 @@ module Emjay
         (value == value.to_i) ? value.to_i : value
       end
 
+      def has_column_gutter?
+        gutter = @context[:gutter]
+        !gutter.nil? && gutter != ""
+      end
+
+      def get_normalized_gutter_value(target_unit)
+        gutter = @context[:gutter]
+        return 0 if gutter.nil? || gutter == ""
+
+        parsed = WidthParser.call(gutter, parse_float_to_int: false)
+        parent_width = @context[:container_width]
+
+        return parsed[:parsed_width] if parsed[:unit] == target_unit
+
+        if target_unit == "%" && parsed[:unit] == "px"
+          (parsed[:parsed_width] / parent_width.to_f) * 100
+        elsif target_unit == "px" && parsed[:unit] == "%"
+          (parent_width.to_f * parsed[:parsed_width]) / 100
+        else
+          parsed[:parsed_width]
+        end
+      end
+
+      def get_desktop_unit
+        get_parsed_width[:unit]
+      end
+
+      def get_desktop_width
+        parsed = get_parsed_width
+        return parsed unless has_column_gutter?
+
+        sibling = @props[:sibling] || 1
+        index = @props[:index] || 0
+        unit = parsed[:unit]
+        gutter = get_normalized_gutter_value(unit)
+        reduction = (gutter * (sibling - 1)) / sibling.to_f
+        reduced = [0, normalize_unit_value(parsed[:parsed_width] - reduction)].max
+
+        if unit == "px"
+          floor_width = reduced.floor
+          fractional = reduced - floor_width
+          extra = (sibling * fractional).round.clamp(0, sibling)
+          {parsed_width: floor_width + ((index < extra) ? 1 : 0), unit: unit}
+        else
+          {parsed_width: reduced, unit: unit}
+        end
+      end
+
+      def get_desktop_gutter_class_name
+        unit = get_desktop_unit
+        gutter = get_normalized_gutter_value(unit)
+        unit_token = (unit == "%") ? "per" : unit
+        direction_token = (@context[:direction] == "rtl") ? "-rtl" : ""
+        normalized = (unit == "px") ? normalize_px_value(gutter) : gutter
+        gutter_token = normalize_unit_value(normalized).to_s.tr(".", "-")
+        sibling = @props[:sibling] || 1
+        index = @props[:index] || 0
+        "mj-column-gutter-#{sibling}-#{index + 1}-#{unit_token}-#{gutter_token}#{direction_token}"
+      end
+
+      def get_desktop_padding_values(unit)
+        first = @props[:first]
+        last = @props[:last]
+        sibling = @props[:sibling] || 1
+        direction = @context[:direction]
+        gutter = get_normalized_gutter_value(unit)
+        normalized = (unit == "px") ? normalize_px_value(gutter) : gutter
+        is_px = unit == "px"
+        half_leading = is_px ? (normalized / 2.0).ceil : normalized / 2.0
+        half_trailing = is_px ? (normalized / 2.0).floor : normalized / 2.0
+        is_rtl = direction == "rtl"
+
+        return {top: 0, right: 0, bottom: 0, left: 0} if sibling == 1
+
+        if is_rtl
+          {top: 0, right: first ? 0 : half_trailing, bottom: 0, left: last ? 0 : half_leading}
+        else
+          {top: 0, right: last ? 0 : half_leading, bottom: 0, left: first ? 0 : half_trailing}
+        end
+      end
+
+      def get_mobile_padding_values
+        first = @props[:first]
+        last = @props[:last]
+        gutter = get_normalized_gutter_value("%")
+        half = gutter / 2.0
+        {top: first ? 0 : half, right: 0, bottom: last ? 0 : half, left: 0}
+      end
+
+      def format_padding(top, right, bottom, left, unit)
+        if unit == "px"
+          "#{normalize_px_value(top)}px #{normalize_px_value(right)}px #{normalize_px_value(bottom)}px #{normalize_px_value(left)}px"
+        else
+          "#{normalize_unit_value(top)}#{unit} #{normalize_unit_value(right)}#{unit} #{normalize_unit_value(bottom)}#{unit} #{normalize_unit_value(left)}#{unit}"
+        end
+      end
+
+      def get_desktop_padding
+        unit = get_desktop_unit
+        v = get_desktop_padding_values(unit)
+        format_padding(v[:top], v[:right], v[:bottom], v[:left], unit)
+      end
+
+      def get_mobile_padding
+        v = get_mobile_padding_values
+        format_padding(v[:top], v[:right], v[:bottom], v[:left], "%")
+      end
+
+      def get_outlook_gutter_styles
+        return {} unless has_column_gutter?
+        {"padding" => get_desktop_padding_values("px").then { |v| format_padding(v[:top], v[:right], v[:bottom], v[:left], "px") }}
+      end
+
+      def get_mobile_gutter_styles
+        return {} unless has_column_gutter?
+
+        if @context[:is_in_group]
+          {"padding" => get_desktop_padding}
+        else
+          {"padding" => get_mobile_padding}
+        end
+      end
+
+      def normalize_unit_value(value)
+        rounded = value.to_f.round(6)
+        (rounded == rounded.to_i) ? rounded.to_i : rounded
+      end
+
+      def normalize_px_value(value)
+        value.to_f.round
+      end
+
       def has_border_radius?
         br = get_attribute("border-radius")
         br && !br.empty?
@@ -282,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
@@ -28,6 +27,7 @@ module Emjay
           "border-top" => "string",
           "direction" => "enum(ltr,rtl)",
           "full-width" => "enum(full-width,false,)",
+          "gutter" => "unit(px,%)",
           "padding" => "unit(px,%){1,4}",
           "padding-top" => "unit(px,%)",
           "padding-bottom" => "unit(px,%)",
@@ -54,7 +54,9 @@ module Emjay
         widths = get_box_widths
         @context.merge(
           container_width: "#{widths[:box]}px",
-          gap: get_attribute("gap")
+          gap: get_attribute("gap"),
+          gutter: get_attribute("gutter"),
+          direction: get_attribute("direction")
         )
       end
 
@@ -437,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
@@ -48,6 +47,7 @@ module Emjay
           "align" => "left",
           "icon-position" => "left",
           "color" => "#000",
+          "border" => "0",
           "border-radius" => "3px",
           "font-family" => "Ubuntu, Helvetica, Arial, sans-serif",
           "font-size" => "13px",
@@ -66,6 +66,7 @@ module Emjay
           "icon-position" => "enum(left,right)",
           "background-color" => "color",
           "color" => "color",
+          "border" => "string",
           "border-radius" => "string",
           "font-family" => "string",
           "font-size" => "unit(px)",
@@ -123,6 +124,7 @@ module Emjay
             "width" => icon_size
           },
           img: {
+            "border" => get_attribute("border"),
             "border-radius" => get_attribute("border-radius"),
             "display" => "block"
           },
@@ -267,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

@@ -90,10 +90,13 @@ module Emjay
         global_data: global_data,
         container_width: "600px",
         add_media_query: ->(class_name, data) {
-          pw = data[:parsed_width]
-          pw = pw.to_i if pw == pw.to_i
-          global_data.media_queries[class_name] =
+          global_data.media_queries[class_name] = if data.key?(:padding)
+            "{ padding:#{data[:padding]} !important; }"
+          else
+            pw = data[:parsed_width]
+            pw = pw.to_i if pw == pw.to_i
             "{ width:#{pw}#{data[:unit]} !important; max-width: #{pw}#{data[:unit]}; }"
+          end
         },
         add_head_style: ->(identifier, head_style_fn) {
           global_data.head_style[identifier] = head_style_fn
@@ -182,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.1.2"
+  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.1.2
+  version: 0.2.1
 platform: ruby
 authors:
 - Julik Tarkhanov
 bindir: bin
 cert_chain: []
-date: 2026-05-20 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -108,7 +108,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/julik/emjay
   source_code_uri: https://github.com/julik/emjay
-  changelog_uri: https://github.com/julik/emjay/commits/main
+  changelog_uri: https://github.com/julik/emjay/releases
 rdoc_options: []
 require_paths:
 - lib