trycourier 4.24.0 → 4.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92699878aa77a9b29adce8e814e87b0c2369708e4eaff80d4cb39281d2a2fac3
-  data.tar.gz: 47907b5604d18e1f827398c5a24c21b80ed4b1fb4660d7c45c0cf3b15d5f3099
+  metadata.gz: 6479592040b865063a1f1d9bec5fbea1650cdd5025a335068c39feefb4ae6fd9
+  data.tar.gz: da1ecb2bc7246befec1f12882a02c59d95e6e28b51f3348fbd75286c416cc1c1
 SHA512:
-  metadata.gz: 42442c5a895cc9f1403944cef33abf7cb6673ba331d177291b3355239489c5f0fd991bd1201d3867a48e5b28fac32a43dc4de819157ad59639bc69c9a6ddc355
-  data.tar.gz: 3d90bfd02cfa4270aff7e8af390d966137481c6849be7c3062b171675311aa462f3a56272e879b79be6755e1989171ab3bd8e277650b028e5d5cc5a3036216e9
+  metadata.gz: a2550c508b661f15771d19f7c3d090641f439bd10031a5cbfa9a4323e09c42ce866d58575b53333255adeeb41fe462a7108c5505dc7123b434596c62bd331412
+  data.tar.gz: 4e3d97189c87af8c1165756d3a7a9fe69d583b0d4c3a9e223bdcefadd782e7f371aeff7c5e9548908547e85e107e34aaf11e21bd3a0c29cd5e79ab99cbddcc1b

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.25.0 (2026-08-04)
+
+Full Changelog: [v4.24.0...v4.25.0](https://github.com/trycourier/courier-ruby/compare/v4.24.0...v4.25.0)
+
+### Features
+
+* Merge pull request [#178](https://github.com/trycourier/courier-ruby/issues/178) from trycourier/geraldosilva/c-19484-elemental-formatting-controls ([00857bd](https://github.com/trycourier/courier-ruby/commit/00857bd332c959f343c6344b58e4cc19ff916700))
+
 ## 4.24.0 (2026-08-03)
 
 Full Changelog: [v4.23.0...v4.24.0](https://github.com/trycourier/courier-ruby/compare/v4.23.0...v4.24.0)

data/lib/courier/models/elemental_channel_node.rb

@@ -10,6 +10,28 @@ module Courier
       #   @return [String, nil]
       optional :channel, String
 
+      # @!attribute font_size
+      #   Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+      #   — text, quote, list and action button labels. Heading styles (`h1`/`h2`/`h3`)
+      #   and `subtext` keep their preset sizes.
+      #
+      #   @return [String, nil]
+      optional :font_size, String, nil?: true
+
+      # @!attribute line_height
+      #   Email only. Document-level line height (CSS px or unitless multiplier, e.g.
+      #   `24px` or `1.5`) applied to all body content unless overridden per block.
+      #
+      #   @return [String, nil]
+      optional :line_height, String, nil?: true
+
+      # @!attribute padding
+      #   Email only. Document-level body padding applied once around the email body, as a
+      #   CSS px shorthand (1–4 values), e.g. `48px 64px`.
+      #
+      #   @return [String, nil]
+      optional :padding, String, nil?: true
+
       # @!attribute raw
       #   Raw data to apply to the channel. If `elements` has not been specified, `raw` is
       #   required.
@@ -17,7 +39,7 @@ module Courier
       #   @return [Hash{Symbol=>Object}, nil]
       optional :raw, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
 
-      # @!method initialize(channel: nil, raw: nil)
+      # @!method initialize(channel: nil, font_size: nil, line_height: nil, padding: nil, raw: nil)
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::ElementalChannelNode} for more details.
       #
@@ -34,6 +56,12 @@ module Courier
       #
       #   @param channel [String] The channel the contents of this element should be applied to. Can be `email`,
       #
+      #   @param font_size [String, nil] Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+      #
+      #   @param line_height [String, nil] Email only. Document-level line height (CSS px or unitless multiplier, e.g. `24p
+      #
+      #   @param padding [String, nil] Email only. Document-level body padding applied once around the email body, as a
+      #
       #   @param raw [Hash{Symbol=>Object}, nil] Raw data to apply to the channel. If `elements` has not been specified, `raw` is
     end
   end

data/lib/courier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "4.24.0"
+  VERSION = "4.25.0"
 end

data/rbi/courier/models/elemental_channel_node.rbi

@@ -16,6 +16,22 @@ module Courier
       sig { params(channel: String).void }
       attr_writer :channel
 
+      # Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+      # — text, quote, list and action button labels. Heading styles (`h1`/`h2`/`h3`)
+      # and `subtext` keep their preset sizes.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :font_size
+
+      # Email only. Document-level line height (CSS px or unitless multiplier, e.g.
+      # `24px` or `1.5`) applied to all body content unless overridden per block.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :line_height
+
+      # Email only. Document-level body padding applied once around the email body, as a
+      # CSS px shorthand (1–4 values), e.g. `48px 64px`.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :padding
+
       # Raw data to apply to the channel. If `elements` has not been specified, `raw` is
       # required.
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
@@ -34,6 +50,9 @@ module Courier
       sig do
         params(
           channel: String,
+          font_size: T.nilable(String),
+          line_height: T.nilable(String),
+          padding: T.nilable(String),
           raw: T.nilable(T::Hash[Symbol, T.anything])
         ).returns(T.attached_class)
       end
@@ -41,6 +60,16 @@ module Courier
         # The channel the contents of this element should be applied to. Can be `email`,
         # `push`, `direct_message`, `sms` or a provider such as slack
         channel: nil,
+        # Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+        # — text, quote, list and action button labels. Heading styles (`h1`/`h2`/`h3`)
+        # and `subtext` keep their preset sizes.
+        font_size: nil,
+        # Email only. Document-level line height (CSS px or unitless multiplier, e.g.
+        # `24px` or `1.5`) applied to all body content unless overridden per block.
+        line_height: nil,
+        # Email only. Document-level body padding applied once around the email body, as a
+        # CSS px shorthand (1–4 values), e.g. `48px 64px`.
+        padding: nil,
         # Raw data to apply to the channel. If `elements` has not been specified, `raw` is
         # required.
         raw: nil
@@ -49,7 +78,13 @@ module Courier
 
       sig do
         override.returns(
-          { channel: String, raw: T.nilable(T::Hash[Symbol, T.anything]) }
+          {
+            channel: String,
+            font_size: T.nilable(String),
+            line_height: T.nilable(String),
+            padding: T.nilable(String),
+            raw: T.nilable(T::Hash[Symbol, T.anything])
+          }
         )
       end
       def to_hash

data/sig/courier/models/elemental_channel_node.rbs

@@ -1,19 +1,50 @@
 module Courier
   module Models
-    type elemental_channel_node = { channel: String, raw: ::Hash[Symbol, top]? }
+    type elemental_channel_node =
+      {
+        channel: String,
+        font_size: String?,
+        line_height: String?,
+        padding: String?,
+        raw: ::Hash[Symbol, top]?
+      }
 
     class ElementalChannelNode < Courier::Models::ElementalBaseNode
       def channel: -> String?
 
       def channel=: (String _) -> String
 
+      def font_size: -> String?
+
+      def font_size=: (String? _) -> String?
+
+      def line_height: -> String?
+
+      def line_height=: (String? _) -> String?
+
+      def padding: -> String?
+
+      def padding=: (String? _) -> String?
+
       def raw: -> ::Hash[Symbol, top]?
 
       def raw=: (::Hash[Symbol, top]? _) -> ::Hash[Symbol, top]?
 
-      def initialize: (?channel: String, ?raw: ::Hash[Symbol, top]?) -> void
+      def initialize: (
+        ?channel: String,
+        ?font_size: String?,
+        ?line_height: String?,
+        ?padding: String?,
+        ?raw: ::Hash[Symbol, top]?
+      ) -> void
 
-      def to_hash: -> { channel: String, raw: ::Hash[Symbol, top]? }
+      def to_hash: -> {
+        channel: String,
+        font_size: String?,
+        line_height: String?,
+        padding: String?,
+        raw: ::Hash[Symbol, top]?
+      }
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 4.24.0
+  version: 4.25.0
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-03 00:00:00.000000000 Z
+date: 2026-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi