mjml-rb 0.4.1 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b8ae00ad7838acf9020b38b585a90fbf86981d234e813da8f9d45d52421dd1a
-  data.tar.gz: b6723a5a59e85e6db01ae7bcb8e8b185c6cbd5253fccd195f93aa6158fa08361
+  metadata.gz: a143101aa0a18f9aa1e77160d0810561f9b5e58fe6dbf8c68d9f809b91421d8d
+  data.tar.gz: b3fb93b17518384e6ce03e96162a30ef870ab4534bfc3c0fe62775b5db21c594
 SHA512:
-  metadata.gz: d7ad920fbb9996b3bdb4f0321420121695ebf3124ce466e19059b38f72add99284f8208fd2d985313b0e217762f5676ed669cb438cbaec6b68685366e43186c8
-  data.tar.gz: 853ffaae0d6889dc630837b73856204bc68d42c8eb7a01dc125c6629a2b9b0258a6fc73a22855e553f1c34a2b2d4876a04e76598e8e0f3be5c5bd6e99ef99fe1
+  metadata.gz: a811a85d468e8332b29c533efe918038c68fccb9f7383d82bfceff42954cbe7c9faeccbe72dde57380b422881b620a358db2d6032bef62928053a6b25c001d71
+  data.tar.gz: c04f1e1df5835cbf5d0c2f81835ba942aa6f9d3149e592662cffeec22ece7c2841d89f44d4834e5ba29ef8b2891070c402a9da277b04363a7f59541740f2c785

data/README.md

@@ -11,198 +11,98 @@
 > This is a **fully open source project** — feedback, bug reports, test cases,
 > and pull requests are welcome!
 
-This gem provides a Ruby-first implementation of the main MJML tooling:
+A pure-Ruby MJML v4 compiler — no Node.js required.
 
-- library API compatible with `mjml2html`
-- command-line interface (`mjml`)
-- validation commands
-- pure Ruby parser, AST, validator, and renderer
-- no Node.js runtime and no shelling out to the official npm renderer
+- Library API compatible with `mjml2html`
+- Command-line interface (`mjml`)
+- Rails integration (ActionView template handler for `.mjml` views)
+- Validation (soft, strict, skip)
+- Custom component support
+- Pure Ruby parser, AST, validator, and renderer
 
-Remaining parity work is tracked in [npm ↔ Ruby Parity Audit](docs/PARITY_AUDIT.md).
-
-## Compatibility
-
-This project targets **MJML v4 only**.
+**[Full Usage Guide](docs/USAGE.md)** — API reference, all compiler options, component attribute tables, CLI flags, Rails setup, custom components, and more.
 
-- parsing, validation, and rendering are implemented against the MJML v4 document structure
-- component rules and attribute validation follow the MJML v4 model
+## Installation
 
-## Quick start
-
-```bash
-bundle install
-bundle exec ruby -Ilib -e 'require "mjml-rb"; puts MjmlRb.mjml2html("<mjml><mj-body><mj-section><mj-column><mj-text>Hello</mj-text></mj-column></mj-section></mj-body></mjml>")[:html]'
+```ruby
+# Gemfile
+gem "mjml-rb"
 ```
 
-## CLI usage
+## Quick Start
 
-```bash
-bundle exec bin/mjml example.mjml -o output.html
-bundle exec bin/mjml --validate example.mjml
+```ruby
+require "mjml-rb"
+
+result = MjmlRb.mjml2html(<<~MJML)
+  <mjml>
+    <mj-body>
+      <mj-section>
+        <mj-column>
+          <mj-text>Hello World!</mj-text>
+        </mj-column>
+      </mj-section>
+    </mj-body>
+  </mjml>
+MJML
+
+puts result[:html]     # compiled HTML
+puts result[:errors]   # validation errors (if any)
 ```
 
-## Rails integration
-
-In a Rails app, requiring the gem registers an `ActionView` template handler for
-`.mjml` templates through a `Railtie`.
-
-By default, `.mjml` files are treated as raw MJML/XML source.
+## CLI
 
-If you want Slim-backed MJML templates, configure it explicitly:
-
-```ruby
-config.mjml_rb.rails_template_language = :slim
+```bash
+mjml email.mjml -o email.html          # compile to file
+mjml -r "templates/*.mjml" -o output/  # batch compile
+mjml -v email.mjml                     # validate only
+mjml -i -s < email.mjml                # stdin → stdout
 ```
 
-Supported values are `:slim` and `:haml`.
+See the [Usage Guide — CLI section](docs/USAGE.md#cli) for all flags and config options.
 
-With a configured `rails_template_language`, `.mjml` templates are rendered
-through that template engine first, so partials and embedded Ruby can assemble
-MJML before the outer template is compiled to HTML. Without that setting,
-non-XML MJML source is rejected instead of being guessed.
+## Rails
 
-For `:slim` or `:haml`, the matching Rails template handler must already be
-registered in `ActionView` by the corresponding gem or integration layer.
+Add the gem to your Gemfile — that's it. The `.mjml` template handler is registered automatically.
 
-Create a view such as `app/views/user_mailer/welcome.html.mjml`:
-
-```mjml
+```erb
+<!-- app/views/user_mailer/welcome.html.mjml -->
 <mjml>
   <mj-body>
     <mj-section>
       <mj-column>
-        <mj-text>Hello from Rails</mj-text>
+        <mj-text>Welcome, <%= @user.name %>!</mj-text>
       </mj-column>
     </mj-section>
   </mj-body>
 </mjml>
 ```
 
-Then render it like any other Rails template:
-
 ```ruby
 class UserMailer < ApplicationMailer
-  def welcome
-    mail(to: "user@example.com", subject: "Welcome")
+  def welcome(user)
+    @user = user
+    mail(to: user.email, subject: "Welcome")
   end
 end
 ```
 
-Rails rendering uses strict MJML validation by default. You can override the
-compiler options in your application config:
-
-```ruby
-config.mjml_rb.compiler_options = { validation_level: "soft" }
-```
-
-## Custom components
+Supports Slim and Haml via `config.mjml_rb.rails_template_language = :slim`. See the [Usage Guide — Rails section](docs/USAGE.md#rails-integration) for full configuration.
 
-You can register custom MJML components written in Ruby:
-
-```ruby
-class MjRating < MjmlRb::Components::Base
-  TAGS = ["mj-rating"].freeze
-  ALLOWED_ATTRIBUTES = { "stars" => "integer", "color" => "color" }.freeze
-  DEFAULT_ATTRIBUTES = { "stars" => "5", "color" => "#f4b400" }.freeze
-
-  def render(tag_name:, node:, context:, attrs:, parent:)
-    stars = (attrs["stars"] || "5").to_i
-    color = attrs["color"] || "#f4b400"
-    %(<div style="color:#{escape_attr(color)}">#{"\u2605" * stars}</div>)
-  end
-end
-
-MjmlRb.register_component(MjRating,
-  dependencies: { "mj-column" => ["mj-rating"] },
-  ending_tags: ["mj-rating"]
-)
-```
-
-The `dependencies` hash declares which parent tags accept the new component as a child. The `ending_tags` list tells the parser to treat content as raw HTML (like `mj-text`). Both are optional.
-
-Once registered, the component works in MJML markup and is validated like any built-in component.
-
-## `.mjmlrc` config file
-
-Place a `.mjmlrc` file (JSON) in your project root to auto-register custom components and set default compiler options:
+## Architecture
 
-```json
-{
-  "packages": [
-    "./lib/mjml_components/mj_rating.rb"
-  ],
-  "options": {
-    "beautify": true,
-    "validation-level": "soft"
-  }
-}
 ```
-
-- **`packages`** — Ruby files to `require`. Each file should call `MjmlRb.register_component` to register its components.
-- **`options`** — Default compiler options. CLI flags and programmatic options override these.
-
-The CLI loads `.mjmlrc` automatically from the working directory. For the library API, load it explicitly:
-
-```ruby
-MjmlRb::ConfigFile.load("/path/to/project")
-result = MjmlRb.mjml2html(mjml_string)
+MJML string → Parser → AST → Validator → Renderer → HTML
 ```
 
-## Architecture
+1. **Parser** — normalizes source, expands `mj-include`, builds `AstNode` tree
+2. **Validator** — checks structure, hierarchy, and attribute types
+3. **Renderer** — resolves head metadata, applies defaults, emits responsive HTML
 
-The compile pipeline is intentionally simple and fully Ruby-based:
-
-1. `MjmlRb.mjml2html` calls `MjmlRb::Compiler`.
-2. `MjmlRb::Parser` normalizes the source, expands `mj-include`, and builds an `AstNode` tree.
-3. `MjmlRb::Validator` checks structural rules and supported attributes.
-4. `MjmlRb::Renderer` resolves head metadata, applies component defaults, and renders HTML.
-5. `MjmlRb::Compiler` post-processes the output and returns a `Result`.
-
-The key architectural idea is that the project uses a small shared AST plus a component registry:
-
-- the parser produces generic `AstNode` objects instead of component-specific node types
-- structure rules live in `lib/mjml-rb/dependencies.rb`
-- rendering logic lives in `lib/mjml-rb/components/*`
-- head components populate a shared rendering context
-- body components consume that context and emit the final HTML
-
-That split keeps the compiler pipeline predictable:
-
-- parsing is responsible for source normalization and include expansion
-- validation is responsible for MJML structure and attribute checks
-- rendering is responsible for HTML generation and responsive email output
-
-## Project structure
-
-The main files are organized like this:
-
-```text
-lib/mjml-rb.rb                    # public gem entry point
-lib/mjml-rb/compiler.rb           # orchestration: parse -> validate -> render
-lib/mjml-rb/parser.rb             # MJML/XML normalization, includes, AST building
-lib/mjml-rb/ast_node.rb           # shared tree representation
-lib/mjml-rb/validator.rb          # structural and attribute validation
-lib/mjml-rb/dependencies.rb       # allowed parent/child relationships
-lib/mjml-rb/renderer.rb           # HTML document assembly and render context
-lib/mjml-rb/components/*          # per-component rendering and head handling
-lib/mjml-rb/result.rb             # result object returned by the compiler
-lib/mjml-rb/cli.rb                # CLI implementation used by bin/mjml
-docs/ARCHITECTURE.md              # deeper architecture notes
-docs/PARITY_AUDIT.md              # npm vs Ruby parity tracking
-```
+For the full internal walkthrough, see [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
 
-If you want the full internal walkthrough, see [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
+Remaining parity work is tracked in [npm ↔ Ruby Parity Audit](docs/PARITY_AUDIT.md).
 
-## Implementation goal
+## License
 
-> **Ruby MJML pipeline without the Node.js renderer.**
->
-> The npm `mjml` package requires Node.js at build time (or runtime via a child
-> process / FFI bridge). This project replaces that entire pipeline with a single
-> Ruby library: XML parsing, AST construction, attribute resolution, validation,
-> and HTML rendering — all in Ruby, with no Node.js runtime and no need to
-> shell out to the official MJML renderer. Drop it into a Rails, Sinatra, or
-> plain Ruby project and render MJML templates the same way you render ERB — no
-> extra runtime, no
-> `package.json`, no `node_modules`.
+MIT

data/lib/mjml-rb/components/accordion.rb

@@ -104,7 +104,7 @@ module MjmlRb
         .moz-text-html input.mj-accordion-checkbox + * .mj-accordion-ico { display:none; }
       CSS
 
-      DEFAULTS = {
+      DEFAULT_ATTRIBUTES = {
         "border" => "2px solid black",
         "font-family" => "Ubuntu, Helvetica, Arial, sans-serif",
         "icon-align" => "middle",
@@ -118,21 +118,17 @@ module MjmlRb
         "padding" => "10px 25px"
       }.freeze
 
-      TITLE_DEFAULTS = {
+      TITLE_DEFAULT_ATTRIBUTES = {
         "font-size" => "13px",
         "padding" => "16px"
       }.freeze
 
-      TEXT_DEFAULTS = {
+      TEXT_DEFAULT_ATTRIBUTES = {
         "font-size" => "13px",
         "line-height" => "1",
         "padding" => "16px"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def head_style
         HEAD_STYLE
       end
@@ -146,11 +142,11 @@ module MjmlRb
         when "mj-accordion"
           render_accordion(node, context, attrs)
         when "mj-accordion-element"
-          render_accordion_element(node, context, DEFAULTS.merge(attrs))
+          render_accordion_element(node, context, DEFAULT_ATTRIBUTES.merge(attrs))
         when "mj-accordion-title"
-          render_accordion_title(node, DEFAULTS.merge(attrs))
+          render_accordion_title(node, DEFAULT_ATTRIBUTES.merge(attrs))
         when "mj-accordion-text"
-          render_accordion_text(node, DEFAULTS.merge(attrs))
+          render_accordion_text(node, DEFAULT_ATTRIBUTES.merge(attrs))
         else
           render_children(node, context, parent: parent)
         end
@@ -159,7 +155,7 @@ module MjmlRb
       private
 
       def render_accordion(node, context, attrs)
-        accordion_attrs = DEFAULTS.merge(attrs)
+        accordion_attrs = DEFAULT_ATTRIBUTES.merge(attrs)
         outer_style = style_join(
           "padding" => accordion_attrs["padding"],
           "background-color" => accordion_attrs["container-background-color"]
@@ -225,7 +221,7 @@ module MjmlRb
       end
 
       def render_accordion_title(node, attrs)
-        title_attrs = TITLE_DEFAULTS.merge(attrs)
+        title_attrs = TITLE_DEFAULT_ATTRIBUTES.merge(attrs)
         td_style = style_join(
           "width" => "100%",
           "background-color" => title_attrs["background-color"],
@@ -262,7 +258,7 @@ module MjmlRb
       end
 
       def render_accordion_text(node, attrs)
-        text_attrs = TEXT_DEFAULTS.merge(attrs)
+        text_attrs = TEXT_DEFAULT_ATTRIBUTES.merge(attrs)
         td_style = style_join(
           "background" => text_attrs["background-color"],
           "font-size" => text_attrs["font-size"],

data/lib/mjml-rb/components/attributes.rb

@@ -15,10 +15,6 @@ module MjmlRb
         end
       end
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         ""
       end

data/lib/mjml-rb/components/base.rb

@@ -14,13 +14,7 @@ module MjmlRb
         end
 
         def default_attributes
-          if const_defined?(:DEFAULT_ATTRIBUTES)
-            const_get(:DEFAULT_ATTRIBUTES)
-          elsif const_defined?(:DEFAULTS)
-            const_get(:DEFAULTS)
-          else
-            {}
-          end
+          const_defined?(:DEFAULT_ATTRIBUTES) ? const_get(:DEFAULT_ATTRIBUTES) : {}
         end
       end
 

data/lib/mjml-rb/components/body.rb

@@ -14,10 +14,6 @@ module MjmlRb
         "width" => "600px"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         return render_children(node, context, parent: parent) unless tag_name == "mj-body"
 

data/lib/mjml-rb/components/breakpoint.rb

@@ -13,10 +13,6 @@ module MjmlRb
         "width" => "480px"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         ""
       end

data/lib/mjml-rb/components/button.rb

@@ -41,7 +41,7 @@ module MjmlRb
         "width" => "unit(px,%)"
       }.freeze
 
-      DEFAULTS = {
+      DEFAULT_ATTRIBUTES = {
         "align" => "center",
         "background-color" => "#414141",
         "border" => "none",
@@ -59,12 +59,8 @@ module MjmlRb
         "vertical-align" => "middle"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
-        a = DEFAULTS.merge(attrs)
+        a = DEFAULT_ATTRIBUTES.merge(attrs)
 
         bg_color = a["background-color"]
         inner_padding = a["inner-padding"]

data/lib/mjml-rb/components/carousel.rb

@@ -40,10 +40,6 @@ module MjmlRb
         "tb-selected-border-color" => "#ccc"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         a = DEFAULT_ATTRIBUTES.merge(attrs)
         children = carousel_images(node)

data/lib/mjml-rb/components/carousel_image.rb

@@ -23,10 +23,6 @@ module MjmlRb
         "target" => "_blank"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         render_item(
           node,

data/lib/mjml-rb/components/divider.rb

@@ -19,7 +19,7 @@ module MjmlRb
         "align" => "enum(left,center,right)"
       }.freeze
 
-      DEFAULTS = {
+      DEFAULT_ATTRIBUTES = {
         "align" => "center",
         "border-color" => "#000000",
         "border-style" => "solid",
@@ -28,12 +28,8 @@ module MjmlRb
         "width" => "100%"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
-        a = DEFAULTS.merge(attrs)
+        a = DEFAULT_ATTRIBUTES.merge(attrs)
 
         outer_td_style = style_join(
           "background" => a["container-background-color"],

data/lib/mjml-rb/components/group.rb

@@ -16,10 +16,6 @@ module MjmlRb
         "direction" => "ltr"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         width_pct = context.delete(:_column_width_pct) || 100.0
         a = DEFAULT_ATTRIBUTES.merge(attrs)

data/lib/mjml-rb/components/head.rb

@@ -25,10 +25,6 @@ module MjmlRb
         end
       end
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         ""
       end

data/lib/mjml-rb/components/hero.rb

@@ -43,10 +43,6 @@ module MjmlRb
         "vertical-align" => "top"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         a = DEFAULT_ATTRIBUTES.merge(attrs)
         container_width = normalize_container_width(context[:container_width] || "600px")

data/lib/mjml-rb/components/image.rb

@@ -37,7 +37,7 @@ module MjmlRb
         "usemap" => "string"
       }.freeze
 
-      DEFAULTS = {
+      DEFAULT_ATTRIBUTES = {
         "alt" => "",
         "align" => "center",
         "border" => "0",
@@ -47,10 +47,6 @@ module MjmlRb
         "font-size" => "13px"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def head_style(breakpoint)
         lower_breakpoint = make_lower_breakpoint(breakpoint)
 
@@ -67,7 +63,7 @@ module MjmlRb
       end
 
       def render(tag_name:, node:, context:, attrs:, parent:)
-        a = DEFAULTS.merge(attrs)
+        a = DEFAULT_ATTRIBUTES.merge(attrs)
 
         fluid = a["fluid-on-mobile"] == "true"
         full_width = a["full-width"] == "full-width"

data/lib/mjml-rb/components/navbar.rb

@@ -91,10 +91,6 @@ module MjmlRb
         end
       end
 
-      def tags
-        TAGS
-      end
-
       def head_style(breakpoint)
         lower_breakpoint = make_lower_breakpoint(breakpoint)
 

data/lib/mjml-rb/components/raw.rb

@@ -9,10 +9,6 @@ module MjmlRb
         "position" => "enum(file-start)"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         raw_inner(node)
       end

data/lib/mjml-rb/components/section.rb

@@ -54,10 +54,6 @@ module MjmlRb
         end
       end
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         case tag_name
         when "mj-wrapper"
@@ -607,7 +603,7 @@ module MjmlRb
             "overflow"         => (has_border_radius ? "hidden" : nil),
             "margin"           => "0px auto",
             "margin-top"       => wrapper_gap,
-            "max-width"        => (full_width ? nil : "#{container_px}px")
+            "max-width"        => "#{container_px}px"
           }.merge(full_width ? {} : background_styles)
         )
 

data/lib/mjml-rb/components/social.rb

@@ -107,7 +107,7 @@ module MjmlRb
         icon-size icon-height icon-padding text-padding line-height text-decoration
       ].freeze
 
-      SOCIAL_DEFAULTS = {
+      SOCIAL_DEFAULT_ATTRIBUTES = {
         "align"           => "center",
         "border-radius"   => "3px",
         "color"           => "#333333",
@@ -120,7 +120,7 @@ module MjmlRb
         "text-decoration" => "none"
       }.freeze
 
-      ELEMENT_DEFAULTS = {
+      ELEMENT_DEFAULT_ATTRIBUTES = {
         "alt"             => "",
         "align"           => "left",
         "icon-position"   => "left",
@@ -136,17 +136,13 @@ module MjmlRb
         "vertical-align"  => "middle"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         case tag_name
         when "mj-social"
           render_social(node, context, attrs)
         when "mj-social-element"
           # Direct dispatch (no parent attrs merging) — fallback for standalone use
-          render_social_element(node, ELEMENT_DEFAULTS.merge(attrs))
+          render_social_element(node, ELEMENT_DEFAULT_ATTRIBUTES.merge(attrs))
         end
       end
 
@@ -155,7 +151,7 @@ module MjmlRb
       # ── mj-social ──────────────────────────────────────────────────────────
 
       def render_social(node, context, attrs)
-        a = SOCIAL_DEFAULTS.merge(attrs)
+        a = SOCIAL_DEFAULT_ATTRIBUTES.merge(attrs)
 
         outer_td_style = style_join(
           "background"     => a["container-background-color"],
@@ -211,7 +207,7 @@ module MjmlRb
         children_html = with_inherited_mj_class(context, node) do
           elements.map.with_index do |child, idx|
             child_attrs  = resolved_attributes(child, context)
-            merged_attrs = ELEMENT_DEFAULTS.merge(inherited).merge(child_attrs)
+            merged_attrs = ELEMENT_DEFAULT_ATTRIBUTES.merge(inherited).merge(child_attrs)
             el_html      = render_social_element(child, merged_attrs)
 
             outlook_td_open  = idx == 0 ? "<td>" : "</td><td>"
@@ -229,7 +225,7 @@ module MjmlRb
         children_html = with_inherited_mj_class(context, node) do
           elements.map do |child|
             child_attrs  = resolved_attributes(child, context)
-            merged_attrs = ELEMENT_DEFAULTS.merge(inherited).merge(child_attrs)
+            merged_attrs = ELEMENT_DEFAULT_ATTRIBUTES.merge(inherited).merge(child_attrs)
             render_social_element(child, merged_attrs)
           end.join
         end

data/lib/mjml-rb/components/spacer.rb

@@ -24,10 +24,6 @@ module MjmlRb
         "height" => "20px"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
         a = self.class.default_attributes.merge(attrs)
         height = a["height"]

data/lib/mjml-rb/components/table.rb

@@ -27,7 +27,7 @@ module MjmlRb
         "width" => "unit(px,%,auto)"
       }.freeze
 
-      DEFAULTS = {
+      DEFAULT_ATTRIBUTES = {
         "align"        => "left",
         "border"       => "none",
         "cellpadding"  => "0",
@@ -41,12 +41,8 @@ module MjmlRb
         "width"        => "100%"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
-        a = DEFAULTS.merge(attrs)
+        a = DEFAULT_ATTRIBUTES.merge(attrs)
 
         outer_td_style = style_join(
           "background"     => a["container-background-color"],

data/lib/mjml-rb/components/text.rb

@@ -27,7 +27,7 @@ module MjmlRb
         "vertical-align" => "enum(top,bottom,middle)"
       }.freeze
 
-      DEFAULTS = {
+      DEFAULT_ATTRIBUTES = {
         "align" => "left",
         "color" => "#000000",
         "font-family" => "Ubuntu, Helvetica, Arial, sans-serif",
@@ -36,12 +36,8 @@ module MjmlRb
         "padding" => "10px 25px"
       }.freeze
 
-      def tags
-        TAGS
-      end
-
       def render(tag_name:, node:, context:, attrs:, parent:)
-        a = DEFAULTS.merge(attrs)
+        a = DEFAULT_ATTRIBUTES.merge(attrs)
         height = a["height"]
 
         outer_td_style = style_join(

data/lib/mjml-rb/renderer.rb

@@ -545,6 +545,12 @@ module MjmlRb
     end
 
     def normalize_background_fallbacks!(node, declarations)
+      background_image = declaration_value(declarations["background-image"])
+      if background_image && !background_image.empty?
+        declarations.delete("background") if syncable_background?(declaration_value(declarations["background"]))
+        return
+      end
+
       background_color = declaration_value(declarations["background-color"])
       return if background_color.nil? || background_color.empty?
 

data/lib/mjml-rb/version.rb

@@ -1,3 +1,3 @@
 module MjmlRb
-  VERSION = "0.4.1".freeze
+  VERSION = "0.4.3".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mjml-rb
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.3
 platform: ruby
 authors:
 - Andrei Andriichuk