emjay 0.1.0

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

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative "../../head_component"
+require_relative "../../registry"
+
+module Emjay
+  module Components
+    class MjHead < HeadComponent
+      def self.component_name
+        "mj-head"
+      end
+
+      def handler
+        handler_children
+      end
+    end
+  end
+
+  Registry.register(Components::MjHead)
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "../../head_component"
+require_relative "../../registry"
+
+module Emjay
+  module Components
+    class MjHtmlAttributes < HeadComponent
+      def self.component_name
+        "mj-html-attributes"
+      end
+
+      def handler
+        add = @context[:add]
+        children = @props[:children] || []
+
+        children.select { |c| c[:tag_name] == "mj-selector" }.each do |selector|
+          path = (selector[:attributes] || {})["path"]
+
+          custom = (selector[:children] || [])
+            .select { |c| c[:tag_name] == "mj-html-attribute" && (c[:attributes] || {})["name"] }
+            .each_with_object({}) { |c, acc|
+              acc[c[:attributes]["name"]] = c[:content] || ""
+            }
+
+          add.call(:html_attributes, path, custom)
+        end
+      end
+    end
+  end
+
+  Registry.register(Components::MjHtmlAttributes)
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "../../head_component"
+require_relative "../../registry"
+
+module Emjay
+  module Components
+    class MjPreview < HeadComponent
+      def self.component_name
+        "mj-preview"
+      end
+
+      def self.ending_tag?
+        true
+      end
+
+      def handler
+        @context[:add].call(:preview, get_content)
+      end
+    end
+  end
+
+  Registry.register(Components::MjPreview)
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "../../head_component"
+require_relative "../../registry"
+
+module Emjay
+  module Components
+    class MjStyle < HeadComponent
+      def self.component_name
+        "mj-style"
+      end
+
+      def self.ending_tag?
+        true
+      end
+
+      def self.allowed_attributes
+        {"inline" => "string"}
+      end
+
+      def handler
+        add = @context[:add]
+        key = if get_attribute("inline") == "inline"
+          :inline_style
+        else
+          :style
+        end
+        add.call(key, get_content)
+      end
+    end
+  end
+
+  Registry.register(Components::MjStyle)
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "../../head_component"
+require_relative "../../registry"
+
+module Emjay
+  module Components
+    class MjTitle < HeadComponent
+      def self.component_name
+        "mj-title"
+      end
+
+      def self.ending_tag?
+        true
+      end
+
+      def handler
+        @context[:add].call(:title, get_content)
+      end
+    end
+  end
+
+  Registry.register(Components::MjTitle)
+end

data/lib/emjay/global_data.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Emjay
+  class GlobalData
+    ARRAY_FIELDS = %i[inline_style components_head_style head_raw style].freeze
+    HASH_FIELDS = %i[classes classes_default default_attributes html_attributes fonts head_style media_queries].freeze
+    SCALAR_FIELDS = %i[before_doctype breakpoint preview title force_owa_desktop lang dir].freeze
+
+    attr_accessor(*ARRAY_FIELDS, *HASH_FIELDS, *SCALAR_FIELDS)
+
+    def initialize(options = {})
+      @before_doctype = ""
+      @breakpoint = options[:breakpoint] || "480px"
+      @classes = {}
+      @classes_default = {}
+      @default_attributes = {}
+      @html_attributes = {}
+      @fonts = options.fetch(:fonts, default_fonts)
+      @inline_style = []
+      @head_style = {}
+      @components_head_style = []
+      @head_raw = []
+      @media_queries = {}
+      @preview = ""
+      @style = []
+      @title = ""
+      @force_owa_desktop = false
+      @lang = "und"
+      @dir = "auto"
+    end
+
+    # Mirrors JS headHelpers.add() semantics
+    def add(key, *params)
+      val = send(key)
+      if val.is_a?(Array)
+        val.push(*params)
+      elsif val.is_a?(Hash)
+        if params.length > 1
+          val[params[0]] = if val[params[0]].is_a?(Hash)
+            val[params[0]].merge(params[1])
+          else
+            params[1]
+          end
+        else
+          send(:"#{key}=", params[0])
+        end
+      else
+        send(:"#{key}=", params[0])
+      end
+    end
+
+    private
+
+    def default_fonts
+      {
+        "Open Sans" => "https://fonts.googleapis.com/css?family=Open+Sans:300,400,500,700",
+        "Droid Sans" => "https://fonts.googleapis.com/css?family=Droid+Sans:300,400,500,700",
+        "Lato" => "https://fonts.googleapis.com/css?family=Lato:300,400,500,700",
+        "Roboto" => "https://fonts.googleapis.com/css?family=Roboto:300,400,500,700",
+        "Ubuntu" => "https://fonts.googleapis.com/css?family=Ubuntu:300,400,500,700"
+      }
+    end
+  end
+end

data/lib/emjay/head_component.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "component"
+
+module Emjay
+  # Base class for head components. Port of JS HeadComponent from createComponent.js.
+  class HeadComponent < Component
+    def handler
+      # Subclasses override
+    end
+
+    def handler_children
+      children = @props[:children] || []
+      components = @context[:components] || {}
+
+      children.filter_map do |child|
+        component_class = components[child[:tag_name]]
+
+        unless component_class
+          warn "No matching component for tag: #{child[:tag_name]}"
+          next
+        end
+
+        component = component_class.new(
+          attributes: child[:attributes] || {},
+          children: child[:children] || [],
+          content: child[:content] || "",
+          context: get_child_context
+        )
+
+        component.handler if component.respond_to?(:handler)
+
+        component.render if component.respond_to?(:render)
+      end
+    end
+  end
+end

data/lib/emjay/helpers/conditional_tag.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Emjay
+  module ConditionalTag
+    START_CONDITIONAL_TAG = "<!--[if mso | IE]>"
+    START_MSO_CONDITIONAL_TAG = "<!--[if mso]>"
+    END_CONDITIONAL_TAG = "<![endif]-->"
+    START_NEGATION_CONDITIONAL_TAG = "<!--[if !mso | IE]><!-->"
+    START_MSO_NEGATION_CONDITIONAL_TAG = "<!--[if !mso]><!-->"
+    END_NEGATION_CONDITIONAL_TAG = "<!--<![endif]-->"
+
+    def self.conditional_tag(content, negation: false)
+      start_tag = negation ? START_NEGATION_CONDITIONAL_TAG : START_CONDITIONAL_TAG
+      end_tag = negation ? END_NEGATION_CONDITIONAL_TAG : END_CONDITIONAL_TAG
+      "\n    #{start_tag}\n    #{content}\n    #{end_tag}\n  "
+    end
+
+    def self.mso_conditional_tag(content, negation: false)
+      start_tag = negation ? START_MSO_NEGATION_CONDITIONAL_TAG : START_MSO_CONDITIONAL_TAG
+      end_tag = negation ? END_NEGATION_CONDITIONAL_TAG : END_CONDITIONAL_TAG
+      "\n    #{start_tag}\n    #{content}\n    #{end_tag}\n  "
+    end
+  end
+end

data/lib/emjay/helpers/fonts.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Emjay
+  module Fonts
+    # Builds font import tags (<link> and @import) for fonts used in the content.
+    # Port of fonts.js buildFontsTags
+    def self.build_tags(content, inline_style, fonts = {})
+      to_import = []
+
+      fonts.each do |name, url|
+        regex = /"[^"]*font-family:[^"]*#{Regexp.escape(name)}[^"]*"/mi
+        inline_regex = /font-family:[^;}]*#{Regexp.escape(name)}/mi
+
+        if content.match?(regex) || inline_style.any? { |s| s.match?(inline_regex) }
+          to_import << url
+        end
+      end
+
+      return "" if to_import.empty?
+
+      links = to_import.map { |url| %(<link href="#{url}" rel="stylesheet" type="text/css">) }.join("\n")
+      imports = to_import.map { |url| "@import url(#{url});" }.join("\n")
+
+      <<~HTML
+        <!--[if !mso]><!-->
+          #{links}
+          <style type="text/css">
+            #{imports}
+          </style>
+        <!--<![endif]-->
+      HTML
+    end
+  end
+end

data/lib/emjay/helpers/gen_random_hex_string.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Emjay
+  module GenRandomHexString
+    def self.call(length)
+      length.times.map { rand(16).to_s(16) }.join
+    end
+  end
+end

data/lib/emjay/helpers/make_lower_breakpoint.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Emjay
+  module MakeLowerBreakpoint
+    # Given a breakpoint string like "600px", returns "599px".
+    # Port of mjml-core/src/helpers/makeLowerBreakpoint.js
+    def self.call(breakpoint)
+      match = breakpoint.to_s.match(/[0-9]+/)
+      return breakpoint unless match
+
+      pixels = match[0].to_i
+      "#{pixels - 1}px"
+    rescue
+      breakpoint
+    end
+  end
+end

data/lib/emjay/helpers/media_queries.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Emjay
+  module MediaQueries
+    # Builds <style> tags for responsive media queries.
+    # Port of mediaQueries.js
+    def self.build_tags(breakpoint, media_queries = {}, force_owa_desktop: false, printer_support: false)
+      return "" if media_queries.empty?
+
+      base = media_queries.map { |class_name, mq| ".#{class_name} #{mq}" }
+      thunderbird = media_queries.map { |class_name, mq| ".moz-text-html .#{class_name} #{mq}" }
+      owa = base.map { |mq| "[owa] #{mq}" }
+
+      result = +""
+      result << <<~HTML
+        <style type="text/css">
+          @media only screen and (min-width:#{breakpoint}) {
+            #{base.join("\n")}
+          }
+        </style>
+        <style media="screen and (min-width:#{breakpoint})">
+          #{thunderbird.join("\n")}
+        </style>
+      HTML
+
+      if printer_support
+        result << <<~HTML
+          <style type="text/css">
+            @media only print {
+              #{base.join("\n")}
+            }
+          </style>
+        HTML
+      end
+
+      if force_owa_desktop
+        result << <<~HTML
+          <style type="text/css">
+            #{owa.join("\n")}
+          </style>
+        HTML
+      end
+
+      result
+    end
+  end
+end

data/lib/emjay/helpers/merge_outlook_conditionals.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Emjay
+  module MergeOutlookConditionals
+    # Removes adjacent `<![endif]-->...<!--[if mso | IE]>` pairs.
+    # Port of mergeOutlookConditionnals.js
+    def self.call(content)
+      content.gsub(/<!\[endif\]-->\s*?<!--\[if mso \| IE\]>/m, "")
+    end
+  end
+end

data/lib/emjay/helpers/minify_outlook_conditionals.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Emjay
+  module MinifyOutlookConditionals
+    # Collapses whitespace inside Outlook conditional blocks.
+    # Port of minifyOutlookConditionnals.js
+    def self.call(content)
+      content.gsub(/(<!--\[if\s[^\]]+\]>)([\s\S]*?)(<!\[endif\]-->)/m) do
+        prefix = $1
+        inner = $2
+        suffix = $3
+        processed = inner.gsub(/(^|>)(\s+)(<|$)/m) { "#{$1}#{$3}" }
+          .gsub(/\s{2,}/m, " ")
+        "#{prefix}#{processed}#{suffix}"
+      end
+    end
+  end
+end

data/lib/emjay/helpers/shorthand_parser.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Emjay
+  module ShorthandParser
+    # Parses CSS shorthand values (like padding/margin) into per-direction integers.
+    # Port of shorthandParser.js
+    def self.call(css_value, direction)
+      parts = css_value.to_s.strip.gsub(/\s+/, " ").split(" ", 4)
+
+      directions = case parts.length
+      when 2
+        {top: 0, bottom: 0, left: 1, right: 1}
+      when 3
+        {top: 0, left: 1, right: 1, bottom: 2}
+      when 4
+        {top: 0, right: 1, bottom: 2, left: 3}
+      else
+        return css_value.to_i
+      end
+
+      (parts[directions[direction.to_sym]] || "0").to_i
+    end
+  end
+
+  module BorderParser
+    # Extracts the first number from a border string (e.g. "1px solid black" -> 1).
+    # Port of borderParser in shorthandParser.js
+    def self.call(border)
+      match = border.to_s.match(/(?:(?:^| )(\d+))/)
+      match ? match[1].to_i : 0
+    end
+  end
+end

data/lib/emjay/helpers/styles.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Emjay
+  module Styles
+    # Builds <style> tag from component head styles and head style functions.
+    # Port of styles.js buildStyleFromComponents
+    def self.build_from_components(breakpoint, components_head_style, head_style)
+      head_styles = head_style.values
+      all = components_head_style + head_styles
+
+      return "" if all.empty?
+
+      css = all.map { |style_fn| style_fn.call(breakpoint) }.join("\n")
+
+      <<~HTML.chomp
+        <style type="text/css">#{css}
+        </style>
+      HTML
+    end
+
+    # Builds <style> tag from user-provided style strings/procs.
+    # Port of styles.js buildStyleFromTags
+    def self.build_from_tags(breakpoint, styles)
+      return "" if styles.empty?
+
+      css = styles.map { |style| style.respond_to?(:call) ? style.call(breakpoint) : style }.join("\n")
+
+      <<~HTML.chomp
+        <style type="text/css">#{css}
+        </style>
+      HTML
+    end
+  end
+end

data/lib/emjay/helpers/suffix_css_classes.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Emjay
+  module SuffixCssClasses
+    # Appends a suffix to each CSS class in a space-separated string.
+    # Port of suffixCssClasses.js
+    def self.call(classes, suffix)
+      return "" unless classes && !classes.empty?
+      classes.split(" ").map { |c| "#{c}-#{suffix}" }.join(" ")
+    end
+  end
+end

data/lib/emjay/helpers/width_parser.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Emjay
+  module WidthParser
+    UNIT_REGEX = /[\d.,]*(\D*)$/
+
+    # Parses a width string like "600px" or "50%" into { parsed_width:, unit: }.
+    # Port of widthParser.js
+    def self.call(width, parse_float_to_int: true)
+      width_str = width.to_s
+      unit_match = UNIT_REGEX.match(width_str)
+      width_unit = unit_match ? unit_match[1] : ""
+
+      parsed_width = if width_unit == "%" && !parse_float_to_int
+        width_str.to_f
+      else
+        width_str.to_i
+      end
+
+      {
+        parsed_width: parsed_width,
+        unit: width_unit.empty? ? "px" : width_unit
+      }
+    end
+  end
+end

data/lib/emjay/rails/mail_interceptor.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Emjay
+  module Rails
+    class MailInterceptor
+      MJML_TAG_PATTERN = /<mjml[\s>]/i
+
+      def self.delivering_email(message)
+        new.compile_mjml!(message)
+      end
+
+      def self.previewing_email(message)
+        new.compile_mjml!(message)
+      end
+
+      def compile_mjml!(message)
+        if message.multipart?
+          message.parts.each { |part| compile_part!(part) }
+        else
+          compile_part!(message)
+        end
+      end
+
+      private
+
+      def compile_part!(part)
+        return if part.multipart?
+        return unless part.content_type&.include?("text/html") || part.content_type.nil?
+
+        body = part.body.decoded
+        return unless MJML_TAG_PATTERN.match?(body)
+
+        part.body = Emjay.to_html(body)
+      end
+    end
+  end
+end

data/lib/emjay/rails/template_handler.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Emjay
+  module Rails
+    module TemplateHandler
+      def self.call(template, source)
+        # Pure ERB passthrough — exists only to register .mjml as a valid
+        # template extension with ERB support. MJML → HTML compilation
+        # happens later via Emjay::Rails::MailInterceptor, after Rails
+        # has assembled the full render (template + layout).
+        erb_handler = ActionView::Template.registered_template_handler(:erb)
+        erb_handler.call(template, source)
+      end
+    end
+  end
+end

data/lib/emjay/railtie.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Emjay
+  class Railtie < Rails::Railtie
+    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)
+        ActionMailer::Base.register_preview_interceptor(interceptor)
+      end
+    end
+  end
+end

data/lib/emjay/registry.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Emjay
+  module Registry
+    @components = {}
+
+    def self.register(component_class)
+      @components[component_class.component_name] = component_class
+    end
+
+    def self.find(tag_name)
+      @components[tag_name]
+    end
+
+    def self.components
+      @components
+    end
+  end
+end