activemail 1.1.1 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7cc246dce0922db6f211036614c9c09e61f07ec31be8a8f080ec5367b639162
-  data.tar.gz: f73779825c12264751b039b6fdac9bce76db075d26f058f432d9b85f79529f6a
+  metadata.gz: 3ad6c37435b356eecce625c0d03128d400a0684893d9fe74794038bd58d93e6e
+  data.tar.gz: 2bff13d848732be8df3643cc386c64b72dc0bde713a0b7df6873e97d55a41877
 SHA512:
-  metadata.gz: 6edee3036ed2af1fa135508c8b936a61a9045a48f8b44ada6e762dead35510f6a8fd0b8c623f82132d72b6726c4cb3a7adfa96c58f93eebb0eb239340cd69118
-  data.tar.gz: 1d49cbdcafea296842256ec928e626513d3fefe6f0d81d6ce1a2ea9229b9173735269c80123e94c832ba2bd691d8ce08468fba33cb65839cceb162de50af6c99
+  metadata.gz: b93e6c7efbeba96471a2989e74abf7308896255fa6338a25adadaaa1bdbde68625c4adb210b13cabf1752cd596d91168d19fe86ff77b4de00cb7e2d144aba4aa
+  data.tar.gz: 55fafc3be6f04051d719de0735bc3f89a7689357913da9da15242130a7e80fbd54ee65574397bcf509c873a2a1ef21000a951b00dafd8353c3ff2734941001dd

data/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.1] - 2026-07-01
+
+### Changed
+
+- Renamed the internal `ActiveMail::Core#release_the_kraken` to `#transpile`.
+- Neutralised test fixtures (example URLs) and severed the upstream fork link.
+
+## [1.2.0] - 2026-07-01
+
+### Added
+
+- `config.blank_link_rel` (default `"noopener"`): a `rel` is now emitted automatically on
+  `target="_blank"` anchors. Set `nil` to disable; an explicit `rel="…"` still wins.
+
 ## [1.1.1] - 2026-06-16
 
 ### Added

data/README.md

@@ -7,7 +7,7 @@ tokens, automatic CSS inlining, generators, and test-time quality guards — so
 responsive, accessible email renders **out of the box**, with every default
 overridable.
 
-A fork and modernization of the now-unmaintained `inky-rb`. Not affiliated with Rails core.
+Not affiliated with Rails core.
 
 Write this:
 
@@ -289,7 +289,7 @@ Helpers available from `Base`: `combine_classes`, `combine_attributes`,
 Per-instance overrides (including replacing a built-in tag) are also possible:
 
 ```ruby
-ActiveMail::Core.new(components: { 'button' => MyButton }).release_the_kraken(source)
+ActiveMail::Core.new(components: { 'button' => MyButton }).transpile(source)
 ```
 
 ## Generators
@@ -356,8 +356,8 @@ Targets the real-world client landscape as of 2026:
 ## Programmatic use
 
 ```ruby
-ActiveMail::Core.new.release_the_kraken('<container><row><columns>Hi</columns></row></container>')
-ActiveMail::Core.new(column_count: 24, container_width: 480).release_the_kraken(source)
+ActiveMail::Core.new.transpile('<container><row><columns>Hi</columns></row></container>')
+ActiveMail::Core.new(column_count: 24, container_width: 480).transpile(source)
 ```
 
 ## Development
@@ -371,4 +371,4 @@ bundle exec srb tc        # Sorbet
 
 ## License
 
-MIT. See [`LICENSE.txt`](LICENSE.txt).
+MIT. See [`LICENSE.txt`](LICENSE.txt), which retains the original ZURB copyright.

data/lib/activemail/components/base.rb

@@ -29,7 +29,7 @@ module ActiveMail
       abstract!
 
       IGNORED_ON_PASSTHROUGH = T.let(
-        %w[class id href size large no-expander small target up size-sm size-lg style].freeze,
+        %w[class id href size large no-expander small target rel up size-sm size-lg style].freeze,
         T::Array[String]
       )
 
@@ -103,8 +103,20 @@ module ActiveMail
       end
 
       sig { params(node: Nokogiri::XML::Node).returns(String) }
-      def target_attribute(node)
-        node.attributes['target'] ? %( target="#{escape_attr(node.attributes['target'])}") : ''
+      def link_attributes(node)
+        target = node.attributes['target']&.value
+        rel = resolve_rel(node, target)
+        [
+          target ? %( target="#{escape_attr(target)}") : '',
+          rel ? %( rel="#{escape_attr(rel)}") : ''
+        ].join
+      end
+
+      sig { params(node: Nokogiri::XML::Node, target: T.nilable(String)).returns(T.nilable(String)) }
+      def resolve_rel(node, target)
+        rel = node.attributes['rel']&.value
+        rel = nil if rel&.strip&.empty?
+        rel || (ActiveMail.configuration.blank_link_rel if target == '_blank')
       end
 
       # Outlook-safe nested-table structure kept in one place for <button> and <cta>.

data/lib/activemail/components/button.rb

@@ -28,11 +28,11 @@ module ActiveMail
 
       sig { params(node: Nokogiri::XML::Node, inner: String, expand: T::Boolean).returns(String) }
       def anchor(node, inner, expand)
-        target = target_attribute(node)
+        links = link_attributes(node)
         extra = expand ? ' align="center" class="float-center"' : ''
         # Padding on the <a> makes the whole button a clickable target.
         link_style = "display:inline-block;text-decoration:none;#{BUTTON_PADDING}"
-        attrs = %(#{pass_through_attributes(node)}href="#{escape_attr(node.attr('href'))}"#{target}#{extra})
+        attrs = %(#{pass_through_attributes(node)}href="#{escape_attr(node.attr('href'))}"#{links}#{extra})
         %(<a #{attrs}#{style_attribute(node, link_style)}>#{inner}</a>)
       end
     end

data/lib/activemail/components/cta.rb

@@ -16,7 +16,7 @@ module ActiveMail
         raise ArgumentError, '<cta> requires an href attribute' if node.attr('href').to_s.strip.empty?
 
         style = ActiveMail.tokens.button_style(class?(node, 'secondary') ? :secondary : :primary)
-        anchor = %(<a href="#{escape_attr(node.attr('href'))}"#{target_attribute(node)} ) +
+        anchor = %(<a href="#{escape_attr(node.attr('href'))}"#{link_attributes(node)} ) +
                  %(style="#{link_style(style)}">#{inner}</a>)
         bulletproof_button_table(
           outer_classes: combine_classes(node, 'cta'),

data/lib/activemail/components/menu_item.rb

@@ -12,7 +12,7 @@ module ActiveMail
       def transform(node, inner)
         attributes = combine_attributes(node, 'menu-item')
         # No href → a non-link item, not a broken <a href="">; mirrors <button>.
-        content = node.attr('href') ? %(<a href="#{escape_attr(node.attr('href'))}"#{target_attribute(node)}>#{inner}</a>) : inner
+        content = node.attr('href') ? %(<a href="#{escape_attr(node.attr('href'))}"#{link_attributes(node)}>#{inner}</a>) : inner
         th = ::ActiveMail::Core::INTERIM_TH_TAG
         %(<#{th} #{attributes}#{style_attribute(node)}>#{content}</#{th}>)
       end

data/lib/activemail/configuration.rb

@@ -86,6 +86,13 @@ module ActiveMail
     value
   end
 
+  sig { params(name: Symbol, value: T.untyped).returns(Integer) }
+  def self.positive_integer!(name, value)
+    raise TypeError, "#{name} must be an Integer, got #{value.inspect} (#{value.class})" unless value.is_a?(Integer)
+
+    assert_positive_dimension!(name, value)
+  end
+
   class Configuration
     extend T::Sig
 
@@ -113,16 +120,13 @@ module ActiveMail
     end
 
     sig { returns(Symbol) }
-    attr_reader :template_engine
-
-    sig { returns(Symbol) }
-    attr_reader :on_parse_error
+    attr_reader :template_engine, :on_parse_error
 
     sig { returns(Integer) }
-    attr_reader :column_count
+    attr_reader :column_count, :container_width
 
-    sig { returns(Integer) }
-    attr_reader :container_width
+    sig { returns(T.nilable(String)) }
+    attr_reader :blank_link_rel
 
     # Mutating the returned hash would bypass validate_component!.
     sig { returns(ActiveMail::ComponentMap) }
@@ -146,6 +150,7 @@ module ActiveMail
       @inliner = T.let(:premailer, InlinerSetting)
       @resolved_inliner = T.let(nil, T.nilable(ActiveMail::Inliner::Base))
       @register_inline_interceptor = T.let(true, T::Boolean)
+      @blank_link_rel = T.let('noopener', T.nilable(String))
     end
 
     # Validates eagerly (like sibling setters): a typo fails at boot, not silently mid-delivery.
@@ -180,12 +185,20 @@ module ActiveMail
 
     sig { params(value: T.untyped).returns(Integer) }
     def column_count=(value)
-      @column_count = positive_integer!(:column_count, value)
+      @column_count = ActiveMail.positive_integer!(:column_count, value)
     end
 
     sig { params(value: T.untyped).returns(Integer) }
     def container_width=(value)
-      @container_width = positive_integer!(:container_width, value)
+      @container_width = ActiveMail.positive_integer!(:container_width, value)
+    end
+
+    sig { params(value: T.untyped).returns(T.nilable(String)) }
+    def blank_link_rel=(value)
+      raise TypeError, "blank_link_rel must be a String or nil, got #{value.inspect} (#{value.class})" unless value.nil? || value.is_a?(String)
+
+      normalized = value&.strip
+      @blank_link_rel = normalized&.empty? ? nil : normalized
     end
 
     sig { params(value: T.untyped).returns(ActiveMail::ComponentMap) }
@@ -216,14 +229,5 @@ module ActiveMail
 
       raise ArgumentError, "unknown inliner #{value.inspect}, expected one of #{INLINERS.keys.inspect}, an Inliner::Base subclass, or an instance"
     end
-
-    # Integer-only (no to_int): a Float would otherwise be silently truncated
-    # (12.9 -> 12), contradicting assert_positive_dimension!'s invariant.
-    sig { params(name: Symbol, value: T.untyped).returns(Integer) }
-    def positive_integer!(name, value)
-      raise TypeError, "#{name} must be an Integer, got #{value.inspect} (#{value.class})" unless value.is_a?(Integer)
-
-      ActiveMail.assert_positive_dimension!(name, value)
-    end
   end
 end

data/lib/activemail/rails/template_handler.rb

@@ -37,7 +37,7 @@ module ActiveMail
           else
             engine_handler.call(template)
           end
-        "ActiveMail::Core.new.release_the_kraken(begin; #{compiled_source};end)"
+        "ActiveMail::Core.new.transpile(begin; #{compiled_source};end)"
       end
 
       module Composer

data/lib/activemail/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module ActiveMail
-  VERSION = '1.1.1'
+  VERSION = '1.2.1'
 end

data/lib/activemail.rb

@@ -73,7 +73,7 @@ module ActiveMail
 
     # Object, not String: ActionView::OutputBuffer is no longer a String since Rails 7.1.
     sig { params(html_string: Object).returns(String) }
-    def release_the_kraken(html_string)
+    def transpile(html_string)
       raws, str = extract_raws(normalize_input(html_string))
       parse_cmd = ::ActiveMail.full_document?(str) ? :parse : :fragment
       html = Nokogiri::HTML.public_send(parse_cmd, str)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activemail
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.1
 platform: ruby
 authors:
 - Advitam