line-message-builder 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c49876bd79a2b1e98639a5e709a41736ebc11e8c7b5bf811ca478c52df762183
-  data.tar.gz: 65ceed1d2fbef231161bc7eb131269354875c39b202da96bb6fcd42edce4bf86
+  metadata.gz: e0b31fce5c00d5f47ade90df479d30b79361f73e3e08852e10f4f90996de5bb9
+  data.tar.gz: 6a72a291942bd3f7448f5a294da49dd3321424d5dad057745590e4b96b1a1abb
 SHA512:
-  metadata.gz: bf2111f3470856dc021330c2fa73e3275842596d858e636d198f3dd8dcea7bddf9a60a252e4a80eb5e6297126b0ec3afeeaf143181ef565db06af9cf558c93c6
-  data.tar.gz: e98ec6e6696268c00f599de55e6b6acb09067c2370c6fc5357f8d1ee7f74b9b6e7d2c9b59a527ae5bc806ca6c685163311648b3a78641bd028d8ba6b71dc3bf1
+  metadata.gz: bb358c2a18903395e07bfc878d3befe2048ad23c5d68b4e5cd23e17e1914bb300f7a692858a68f9c71daa3630b1f30761ab5fc603887296c1d1cffd4964b7414
+  data.tar.gz: 342237372588844319052e9be35b1014024f5f93552f99699137f19a5abf7f341bd03eda306f4f2c5d181c50f257f47fdf5f0a7899cc2093312a91d4cd42667f

data/.release-please-manifest.json

@@ -1 +1 @@
-{".":"0.8.0"}
+{".":"0.9.0"}

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.9.0](https://github.com/elct9620/line-message-builder/compare/v0.8.0...v0.9.0) (2025-06-03)
+
+
+### Features
+
+* add flex separator matcher and tests for flex message components ([0d34bc9](https://github.com/elct9620/line-message-builder/commit/0d34bc9fcfeef9d2ca519548f4a83a3de046eb33))
+* add Flex::Span message builder for LINE messaging API ([a8377e9](https://github.com/elct9620/line-message-builder/commit/a8377e93861fa286e95a69d3cb3c9897c1992044))
+* add have_line_flex_span matcher and comprehensive tests for span component ([b9072cd](https://github.com/elct9620/line-message-builder/commit/b9072cd3e4c56c9346bb3d6cf98ee11374029807))
+* add Separator builder for Flex messages ([accb2aa](https://github.com/elct9620/line-message-builder/commit/accb2aa41f9a016445f377f97e93f085734764c4))
+* add separator method to Flex::Box for adding separator elements ([4125ae1](https://github.com/elct9620/line-message-builder/commit/4125ae15fd5666431ec864121cf40d3c4fb0f56f))
+* add Span component for styled text in Flex Messages ([a458d1d](https://github.com/elct9620/line-message-builder/commit/a458d1d2473e0859bc7e1c81254888a8c8fde9a7))
+* add span method to flex box builder and remove related specs ([af8dc8f](https://github.com/elct9620/line-message-builder/commit/af8dc8f9f4b8c8a7a12c15db23a50331dfc102cb))
+* add support for spans within flex text components ([90ab15d](https://github.com/elct9620/line-message-builder/commit/90ab15df7044d15308d23ef864a69f84d71e28e7))
+
+
+### Bug Fixes
+
+* add Flex::Separator component and require it in flex.rb ([4152c10](https://github.com/elct9620/line-message-builder/commit/4152c1024a7634b526f94fa4e76a518a6ff0787c))
+* ensure matcher finds flex separator in all nested containers ([d289ea1](https://github.com/elct9620/line-message-builder/commit/d289ea178e17d4ca00b796a9f666c527982d82f6))
+* remove duplicate Separator class definition in flex separator.rb ([2c6b6d0](https://github.com/elct9620/line-message-builder/commit/2c6b6d063a2da97a0781591a697cf3034cb135f6))
+
 ## [0.8.0](https://github.com/elct9620/line-message-builder/compare/v0.7.0...v0.8.0) (2025-05-24)
 
 

data/CONVENTIONS.md

@@ -16,6 +16,42 @@ This gem is designed to provide DSL (Domain Specific Language) for building LINE
 
 Only use comments for RDoc documentation. Do not use comments to explain anything in the code. The code should be self-explanatory. If you find yourself needing to write a comment to explain something, consider refactoring the code instead.
 
+## DSL
+
+When using the `Line::Message::Builder` DSL, following is recommended:
+
+```ruby
+Line::Message::Builder.with do
+  flex alt_text: "Hello, World!" do
+    bubble do
+      header do
+        text "Welcome to LINE Messaging API"
+      end
+      body do
+        text "This is a sample message."
+      end
+    end
+  end
+end
+```
+
+DO NOT use `do |container|` syntax as following:
+
+```ruby
+Line::Message::Builder.with do |builder|
+  builder.flex alt_text: "Hello, World!" do
+    builder.bubble do
+      builder.header do
+        builder.text "Welcome to LINE Messaging API"
+      end
+      builder.body do
+        builder.text "This is a sample message."
+      end
+    end
+  end
+end
+```
+
 ## RSpec
 
 - Write feature tests instead of unit tests, use `Line::Message::Builder` as test subject to verify the behavior of the DSL.

data/README.md

@@ -12,7 +12,7 @@ Build LINE messages using DSL (Domain Specific Language) in Ruby.
 - Build LINE messages using DSL
 - Validation of properties
 - RSpec matchers for testing
-- LINE Bot SDK v2 support (WIP)
+- LINE Bot SDK v2 support (Experimental)
 
 ## Installation
 
@@ -43,14 +43,22 @@ You can get it from [http://aotoki.me/line-message-builder/llm.txt](http://aotok
 
 ```ruby
 builder = Line::MessageBuilder::Builder.with do
-    text "Hello, world!"
+  text "Hello, world!"
 end
 
 pp builder.build
 # => [{ type: "text", text: "Hello, world!" }]
 
 puts builder.to_json
-# => {"type":"text","text":"Hello, world!"}
+# => "[{\"type\":\"text",\"text\":\"Hello, world!\"}"
+```
+
+To use with [line-bot-sdk-ruby](https://github.com/line/line-bot-sdk-ruby) v2, you can set mode to `sdkv2`:
+
+```ruby
+builder = Line::MessageBuilder::Builder.with(mode: :sdkv2) do
+  text "Hello, world!"
+end
 ```
 
 ### Context
@@ -59,18 +67,18 @@ The context can make `Builder` to access additional methods and variables.
 
 ```ruby
 context = OpenStruct.new(
-    name: "John Doe",
+  name: "John Doe",
 )
 
 builder = Line::MessageBuilder::Builder.with(context) do
-    text "Hello, #{name}!"
+  text "Hello, #{name}!"
 end
 
 pp builder.build
 # => [{ type: "text", text: "Hello, John Doe!" }]
 
 puts builder.to_json
-# => {"type":"text","text":"Hello, John Doe!"}
+# => "[{\"type\":\"text\",\"text\":\"Hello, John Doe!\"}"
 ```
 
 For Rails, you can use `view_context` to make `Builder` to access Rails helpers.
@@ -78,12 +86,12 @@ For Rails, you can use `view_context` to make `Builder` to access Rails helpers.
 ```ruby
 # app/controllers/line_controller.rb
 builder = Line::MessageBuilder::Builder.with(view_context) do
-    text "Anything you want?" do
-        quick_reply do
-            message "Yes", label: "Yes", image_url: image_url("yes.png")
-            message "No", label: "No", image_url: image_url("no.png")
-        end
+  text "Anything you want?" do
+    quick_reply do
+      message "Yes", label: "Yes", image_url: image_url("yes.png")
+      message "No", label: "No", image_url: image_url("no.png")
     end
+  end
 end
 ```
 
@@ -92,18 +100,18 @@ If not in controller, you can create a `ActionView::Base` instance and pass it t
 ```ruby
 # app/presenters/line_presenter.rb
 context = ActionView::Base.new(
-    ActionController::Base.view_paths,
-    {},
-    ActionController::Base.new,
+  ActionController::Base.view_paths,
+  {},
+  ActionController::Base.new,
 )
 
 builder = Line::MessageBuilder::Builder.with(context) do
-    text "Anything you want?" do
-        quick_reply do
-            message "Yes", label: "Yes", image_url: image_url("yes.png")
-            message "No", label: "No", image_url: image_url("no.png")
-        end
+  text "Anything you want?" do
+    quick_reply do
+      message "Yes", label: "Yes", image_url: image_url("yes.png")
+      message "No", label: "No", image_url: image_url("no.png")
     end
+  end
 end
 ```
 
@@ -171,6 +179,7 @@ end
 | `have_line_flex_image`      | Match a flex message with image      |
 | `have_line_flex_button`     | Match a flex message with button     |
 | `have_line_flex_box`        | Match a flex message with box        |
+| `have_line_flex_separator`  | Match a flex message with separator  |
 
 
 Add `line/message/rspec` to your `spec_helper.rb` or `rails_helper.rb`:
@@ -183,7 +192,7 @@ Include `Line::Message::RSpec::Matchers` in your RSpec configuration:
 
 ```ruby
 RSpec.configure do |config|
-    config.include Line::Message::RSpec::Matchers
+  config.include Line::Message::RSpec::Matchers
 end
 ```
 
@@ -191,10 +200,10 @@ Then the matchers are available in your specs:
 
 ```ruby
 let(:builder) do
-    Line::MessageBuilder::Builder.with do
-        text "Hello, world!"
-        text "Nice to meet you!"
-    end
+  Line::MessageBuilder::Builder.with do
+    text "Hello, world!"
+    text "Nice to meet you!"
+  end
 end
 
 subject { builder.build }
@@ -207,12 +216,13 @@ The matchers can work with webmock `a_request`:
 
 ```ruby
 it "reply with message" do
-    expect(a_request(:post, "https://api.line.me/v2/bot/message/reply")
-        .with(
-            body: hash_including({
-                messages: have_line_text_message(/Hello, world!/),
-            },
-        ))).to have_been_made.once
+  expect(a_request(:post, "https://api.line.me/v2/bot/message/reply")
+    .with(
+      body: hash_including({
+        messages: have_line_text_message(/Hello, world!/),
+      })
+    )
+  ).to have_been_made.once
 end
 ```
 
@@ -271,8 +281,8 @@ end
 | Video     | ❌            |
 | Icon      | ❌            |
 | Text      | 🚧            |
-| Span      | ❌            |
-| Separator | ❌            |
+| Span      | ✅            |
+| Separator | ✅            |
 | Filler    | ❌ Deprecated |
 
 ## Development

data/lib/line/message/builder/actions/message.rb

@@ -15,13 +15,13 @@ module Line
         # in quick replies or other interactive message components.
         #
         # @example Creating a message action for a quick reply button
-        #   Line::Message::Builder.with do |root|
-        #     root.text "Select your favorite food:"
-        #     root.quick_reply do |qr|
+        #   Line::Message::Builder.with do
+        #     text "Select your favorite food:"
+        #     quick_reply do
         #       # When this button is tapped, the user sends "Pizza"
-        #       qr.button action: :message, label: "Pizza", text: "Pizza"
+        #       button action: :message, label: "Pizza", text: "Pizza"
         #       # When this button is tapped, the user sends "Sushi"
-        #       qr.button action: :message, label: "Sushi", text: "Sushi"
+        #       button action: :message, label: "Sushi", text: "Sushi"
         #     end
         #   end
         #

data/lib/line/message/builder/actions/postback.rb

@@ -16,13 +16,13 @@ module Line
         # a different message than the data payload.
         #
         # @example Creating a postback action for a quick reply button
-        #   Line::Message::Builder.with do |root|
-        #     root.text "What do you want to do?"
-        #     root.quick_reply do |qr|
-        #       qr.button action: :postback,
-        #                 label: "Track Order",
-        #                 data: "action=track_order&order_id=123",
-        #                 display_text: "I want to track my order."
+        #   Line::Message::Builder.with do
+        #     text "What do you want to do?"
+        #     quick_reply do
+        #       button action: :postback,
+        #              label: "Track Order",
+        #              data: "action=track_order&order_id=123",
+        #              display_text: "I want to track my order."
         #     end
         #   end
         #

data/lib/line/message/builder/container.rb

@@ -16,11 +16,11 @@ module Line
       # Each message added to the container can also have its own quick reply.
       #
       # @example Building multiple messages
-      #   message_payload = Line::Message::Builder.with do |root|
-      #     root.text "Hello, this is the first message!"
-      #     root.flex alt_text: "This is a Flex Message" do |flex_builder|
-      #       flex_builder.bubble do |bubble|
-      #         bubble.body do |body|
+      #   message_payload = Line::Message::Builder.with do
+      #     text "Hello, this is the first message!"
+      #     flex alt_text: "This is a Flex Message" do
+      #       bubble do
+      #         body do
       #           body.text "This is a Flex Message body."
       #         end
       #       end
@@ -91,10 +91,10 @@ module Line
         #   is typically within Flex::Builder).
         #
         # @example
-        #   root.flex alt_text: "Important information" do |fb|
-        #     fb.bubble do |bubble|
-        #       bubble.header { |h| h.text "Header" }
-        #       bubble.body   { |b| b.text "Body" }
+        #   flex alt_text: "Important information" do
+        #     bubble do
+        #       header { text "Header" }
+        #       body   { text "Body" }
         #     end
         #   end
         def flex(**options, &)

data/lib/line/message/builder/context.rb

@@ -30,20 +30,16 @@ module Line
       # and data into the message building process.
       #
       # @example Using a custom context
-      #   class MyHelpers
+      #   class MyContext
       #     def current_user_name
       #       "Alice"
       #     end
       #   end
       #
-      #   helpers = MyHelpers.new
-      #   Line::Message::Builder.with(helpers) do |root|
-      #     # `current_user_name` is resolved from `helpers` by Context
-      #     root.text "Hello, #{current_user_name}!"
-      #
-      #     # Using assigns
-      #     assigns[:item_count] = 5
-      #     root.text "You have #{assigns[:item_count]} items."
+      #   context = MyContext.new
+      #   Line::Message::Builder.with(context) do
+      #     # `current_user_name` is resolved from `context` by Context
+      #     text "Hello, #{current_user_name}!"
       #   end
       class Context
         # @!attribute assigns

data/lib/line/message/builder/flex/box.rb

@@ -19,14 +19,14 @@ module Line
         # box area tappable.
         #
         # @example Creating a horizontal box with two text components
-        #   Line::Message::Builder.with do |root|
-        #     root.flex alt_text: "Box example" do |flex|
-        #       flex.bubble do |bubble|
-        #         bubble.body do |body_box| # body_box is an instance of Flex::Box
-        #           body_box.layout :horizontal
-        #           body_box.spacing :md
-        #           body_box.text "Item 1"
-        #           body_box.text "Item 2"
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Box example" do
+        #       bubble do
+        #         body do
+        #           layout :horizontal
+        #           spacing :md
+        #           text "Item 1"
+        #           text "Item 2"
         #         end
         #       end
         #     end
@@ -135,9 +135,21 @@ module Line
           #
           # @param text [String] The text content.
           # @param options [Hash] Options for the text component. See {Text#initialize}.
-          # @param block [Proc, nil] An optional block for the text component (e.g., for an action).
+          # @param block [Proc, nil] An optional block for the text component. This can be used
+          #   to define an action for the text or to add {Span} components within the text.
           # @return [Flex::Text] The newly created Text object.
-          def text(text, **options, &)
+          # @example Simple text component
+          #   text "Hello, World!"
+          # @example Text with an action
+          #   text "Click me" do
+          #     message "Action", text: "You clicked me!"
+          #   end
+          # @example Text with spans
+          #   text "This has " do
+          #     span "styled", color: "#FF0000"
+          #     span " parts"
+          #   end
+          def text(text = nil, **options, &)
             @contents << Flex::Text.new(text, context: context, **options, &)
           end
 
@@ -160,6 +172,18 @@ module Line
             @contents << Flex::Image.new(url, context: context, **options, &)
           end
 
+          # Adds a Flex {Separator} component to this box's contents.
+          #
+          # A separator is a simple component that draws a horizontal line,
+          # creating a visual division between other components in a container.
+          #
+          # @param options [Hash] Options for the separator component. See {Separator}.
+          # @param block [Proc, nil] An optional block for advanced separator configuration.
+          # @return [Flex::Separator] The newly created Separator object.
+          def separator(**options, &)
+            @contents << Flex::Separator.new(context: context, **options, &)
+          end
+
           def to_h
             raise RequiredError, "layout is required" if layout.nil?
 

data/lib/line/message/builder/flex/bubble.rb

@@ -11,11 +11,11 @@ module Line
         # for each item in a {Carousel} container.
         #
         # @example Creating a simple bubble with a body
-        #   Line::Message::Builder.with do |root|
-        #     root.flex alt_text: "Simple Bubble" do |flex|
-        #       flex.bubble do |bubble|
-        #         bubble.body do |body_box|
-        #           body_box.text "Hello, this is a bubble!"
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Simple Bubble" do
+        #       bubble do
+        #         body do
+        #           text "Hello, this is a bubble!"
         #         end
         #       end
         #     end

data/lib/line/message/builder/flex/builder.rb

@@ -14,16 +14,16 @@ module Line
         # It can also have a `quickReply` attached to it.
         #
         # @example Creating a Flex Message with a single bubble
-        #   Line::Message::Builder.with do |root|
-        #     root.flex alt_text: "My Product" do |flex_builder| # flex_builder is an instance of Flex::Builder
-        #       flex_builder.bubble size: :giga do |bubble_content|
-        #         bubble_content.hero_image "https://example.com/product.jpg"
-        #         bubble_content.body do |b|
-        #           b.text "Product Name", weight: :bold, size: :xl
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "My Product" do
+        #       flex_builder.bubble size: :giga do
+        #         hero_image "https://example.com/product.jpg"
+        #         body do
+        #           text "Product Name", weight: :bold, size: :xl
         #         end
         #       end
-        #       flex_builder.quick_reply do |qr|
-        #         qr.button action: :message, label: "Learn More", text: "Tell me more"
+        #       quick_reply do
+        #         button action: :message, label: "Learn More", text: "Tell me more"
         #       end
         #     end
         #   end

data/lib/line/message/builder/flex/button.rb

@@ -14,12 +14,12 @@ module Line
         # An action is mandatory for a button component.
         #
         # @example Creating a button that sends a message
-        #   Line::Message::Builder.with do |root|
-        #     root.flex alt_text: "Button Example" do |flex|
-        #       flex.bubble do |bubble|
-        #         bubble.body do |body_box|
-        #           body_box.button style: :primary, height: :sm do |btn|
-        #             btn.message "Buy Now", label: "Buy" # Action definition
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Button Example" do
+        #       bubble do
+        #         body do
+        #           button style: :primary, height: :sm do
+        #             message "Buy Now", label: "Buy" # Action definition
         #           end
         #         end
         #       end

data/lib/line/message/builder/flex/carousel.rb

@@ -13,16 +13,16 @@ module Line
         # articles, or options, in a compact and interactive way.
         #
         # @example Creating a carousel with two bubbles
-        #   Line::Message::Builder.with do |root|
-        #     root.flex alt_text: "Product Showcase" do |flex_builder|
-        #       flex_builder.carousel do |carousel_container| # carousel_container is an instance of Flex::Carousel
-        #         carousel_container.bubble size: :mega do |bubble1|
-        #           bubble1.hero_image "https://example.com/product1.jpg"
-        #           bubble1.body { |b| b.text "Product 1" }
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Product Showcase" do
+        #       carousel do
+        #         bubble size: :mega do
+        #           hero_image "https://example.com/product1.jpg"
+        #           body { text "Product 1" }
         #         end
-        #         carousel_container.bubble size: :mega do |bubble2|
-        #           bubble2.hero_image "https://example.com/product2.jpg"
-        #           bubble2.body { |b| b.text "Product 2" }
+        #         bubble size: :mega do
+        #           hero_image "https://example.com/product2.jpg"
+        #           body { text "Product 2" }
         #         end
         #       end
         #     end

data/lib/line/message/builder/flex/image.rb

@@ -13,15 +13,14 @@ module Line
         # {Actionable#action action} to make it tappable.
         #
         # @example Creating an image component within a box
-        #   Line::Message::Builder.with do |root|
-        #     root.flex alt_text: "Image Example" do |flex|
-        #       flex.bubble do |bubble|
-        #         bubble.body do |body_box|
-        #           body_box.image "https://example.com/image.png",
-        #                          aspect_ratio: "16:9",
-        #                          aspect_mode: :cover,
-        #                          size: :full do |img_action|
-        #             img_action.message "View Details", text: "Show details for image"
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Image Example" do
+        #       bubble do
+        #         body do
+        #           image "https://example.com/image.png",
+        #                 aspect_ratio: "16:9",
+        #                 aspect_mode: :cover,
+        #                 size: :full
         #           end
         #         end
         #       end

data/lib/line/message/builder/flex/partial.rb

@@ -13,19 +13,24 @@ module Line
         # @example Defining and using a partial
         #   # Define a reusable partial
         #   class MyButtonPartial < Line::Message::Builder::Flex::Partial
-        #     def call(label:, data:)
+        #     def call
         #       # `button` method is available from the context (e.g., a Box)
-        #       button style: :primary do |btn|
-        #         btn.postback data, label: label
+        #       button style: :primary do
+        #         # `data` and `label` are available from `context.assigns`
+        #         postback data, label: label
         #       end
         #     end
         #   end
         #
         #   # Use the partial within a Box component
-        #   a_box_component.instance_eval do
-        #     # ... other box content ...
-        #     partial! MyButtonPartial, label: "Action", data: "action=do_something"
-        #     # ... other box content ...
+        #   Line::Message::Builder.with do
+        #     flex do
+        #       bubble do
+        #         body do
+        #           partial! MyButtonPartial, label: "Action", data: "action=do_something"
+        #         end
+        #       end
+        #     end
         #   end
         #
         # @see Partial

data/lib/line/message/builder/flex/separator.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module Builder
+      module Flex
+        # Represents a "separator" component in a LINE Flex Message.
+        #
+        # Separator components are used to create a visual separation between components
+        # within a container. They draw a horizontal line that helps organize the layout
+        # and improve readability.
+        #
+        # @example Creating a separator within a box
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Separator Example" do
+        #       bubble do
+        #         body do
+        #           text "Section 1"
+        #           separator
+        #           text "Section 2"
+        #         end
+        #       end
+        #     end
+        #   end
+        #
+        # @see https://developers.line.biz/en/reference/messaging-api/#separator
+        class Separator < Line::Message::Builder::Base
+          # Converts the separator component to a hash representation compatible with
+          # the LINE Messaging API.
+          #
+          # @return [Hash] A hash containing the separator component's type.
+          def to_h
+            {
+              type: "separator"
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/message/builder/flex/span.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module Builder
+      module Flex
+        # Represents a "span" component in a LINE Flex Message.
+        #
+        # Span components are used within a Text component to apply different styling
+        # to specific portions of text. They offer various styling options, including
+        # `size`, `weight`, `color`, and `decoration`. Unlike Text components, spans
+        # cannot have actions attached to them.
+        #
+        # @example Creating a text component with spans
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Span Example" do
+        #       bubble do
+        #         body do
+        #           text do
+        #             span "Hello, ", color: "#FF0000"
+        #             span "Flex ", weight: :bold
+        #             span "World!", size: :xl, decoration: :underline
+        #           end
+        #         end
+        #       end
+        #     end
+        #   end
+        #
+        # @see https://developers.line.biz/en/reference/messaging-api/#span
+        # @see Size::Shared For common `size` keywords (e.g., `:xl`, `:sm`).
+        class Span < Line::Message::Builder::Base
+          include Size::Shared # Adds `size` option (e.g., :sm, :md, :xl).
+
+          # @!attribute [r] text
+          #   @return [String] The actual text content to be displayed.
+          #     This is a required attribute.
+          attr_reader :text
+
+          # Specifies the color of the text.
+          # @!method color(value)
+          #   @param value [String, nil] Hexadecimal color code (e.g., `"#RRGGBB"`, `"#RRGGBBAA"`).
+          #   @return [String, nil] The current text color.
+          option :color, default: nil
+
+          # Specifies the weight of the text.
+          # @!method weight(value)
+          #   @param value [Symbol, String, nil] Text weight. Valid values are `:regular` and `:bold`.
+          #   @return [Symbol, String, nil] The current text weight.
+          option :weight, default: nil, validator: Validators::Enum.new(:regular, :bold)
+
+          # Specifies the decoration of the text.
+          # @!method decoration(value)
+          #   @param value [Symbol, String, nil] Text decoration.
+          #     Valid values are `:none`, `:underline`, and `:line-through`.
+          #   @return [Symbol, String, nil] The current text decoration.
+          option :decoration, default: nil, validator: Validators::Enum.new(:none, :underline, :"line-through")
+
+          # Initializes a new Flex Message Span component.
+          #
+          # @param text_content [String] The text to display. This is required.
+          # @param context [Object, nil] An optional context for the builder.
+          # @param options [Hash] A hash of options to set instance variables
+          #   (e.g., `:color`, `:weight`, `:decoration`, and options from included modules).
+          # @param block [Proc, nil] An optional block, typically not used for spans.
+          # @raise [ArgumentError] if `text_content` is nil (though the more specific
+          #   `RequiredError` is raised in `to_h`).
+          def initialize(text_content, context: nil, **options, &)
+            @text = text_content # The text content is mandatory.
+
+            super(context: context, **options, &) # Sets options and evals block
+          end
+
+          # Sets weight to bold.
+          #
+          # @return [Symbol] Returns `:bold`.
+          def bold!
+            weight(:bold)
+          end
+
+          # Sets decoration to underline.
+          #
+          # @return [Symbol] Returns `:underline`.
+          def underline!
+            decoration(:underline)
+          end
+
+          # Sets decoration to line-through.
+          #
+          # @return [Symbol] Returns `:line-through`.
+          def line_through!
+            decoration(:"line-through")
+          end
+
+          def to_h
+            raise RequiredError, "text content is required for a span component" if text.nil?
+
+            {
+              type: "span",
+              text: text,
+              color: color,
+              size: size,
+              weight: weight,
+              decoration: decoration
+            }.compact
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/message/builder/flex/text.rb

@@ -12,16 +12,35 @@ module Line
         # `line_spacing`, and more. A text component can also have an
         # {Actionable#action action} to make it tappable.
         #
+        # Text components also support embedded {Span} components, which allow parts of
+        # the text to have different styling. Spans can be added to a text component
+        # using the {#span} method within the Text component block.
+        #
         # @example Creating a text component within a box
-        #   Line::Message::Builder.with do |root|
-        #     root.flex alt_text: "Text Example" do |flex|
-        #       flex.bubble do |bubble|
-        #         bubble.body do |body_box|
-        #           body_box.text "Hello, Flex World!",
-        #                         size: :xl,
-        #                         color: "#FF0000",
-        #                         wrap: true do |txt_action|
-        #             txt_action.message "More info", text: "Tell me more about text"
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Text Example" do
+        #       bubble do
+        #         body do
+        #           text "Hello, Flex World!",
+        #                size: :xl,
+        #                color: "#FF0000",
+        #                wrap: true do
+        #                  message "More info", text: "Tell me more about text"
+        #           end
+        #         end
+        #       end
+        #     end
+        #   end
+        #
+        # @example Creating a text component with spans
+        #   Line::Message::Builder.with do
+        #     flex alt_text: "Span Example" do
+        #       bubble do
+        #         body do
+        #           text "This message has styled spans:" do
+        #             span "Red", color: "#FF0000"
+        #             span " and ", size: :sm
+        #             span "Bold", weight: :bold
         #           end
         #         end
         #       end
@@ -50,7 +69,7 @@ module Line
           # @!attribute [r] text
           #   @return [String] The actual text content to be displayed.
           #     This is a required attribute.
-          attr_reader :text
+          attr_reader :text, :contents
 
           # Specifies whether the text should wrap or be truncated if it exceeds
           # the component's width.
@@ -82,8 +101,9 @@ module Line
           #   {Actionable#action action} for the text.
           # @raise [ArgumentError] if `text_content` is nil (though the more specific
           #   `RequiredError` is raised in `to_h`).
-          def initialize(text_content, context: nil, **options, &)
+          def initialize(text_content = nil, context: nil, **options, &)
             @text = text_content # The text content is mandatory.
+            @contents = []       # Initialize contents for spans, if any.
 
             super(context: context, **options, &) # Sets options and evals block (for action).
           end
@@ -99,8 +119,30 @@ module Line
             wrap(true) # Use the setter generated by `option`
           end
 
+          # Adds a {Span} component to this text component's contents.
+          #
+          # Spans allow different styling for parts of the text, such as color,
+          # weight, size, and decoration.
+          #
+          # @param text_content [String] The span text content.
+          # @param options [Hash] Options for the span. See {Span#initialize}.
+          # @param block [Proc, nil] An optional block for advanced span configuration.
+          # @return [Flex::Span] The newly created Span object.
+          # @example
+          #   text "Message with spans:" do
+          #     span "Important", color: "#FF0000", weight: :bold
+          #     span " normal text"
+          #   end
+          def span(text_content, **options, &)
+            @contents << Span.new(text_content, context: @context, **options, &)
+          end
+
+          def any_content?
+            !contents.empty? || !text.nil?
+          end
+
           def to_h
-            raise RequiredError, "text content is required for a text component" if text.nil?
+            raise RequiredError, "text content is required for a text component" unless any_content?
 
             return to_sdkv2 if context.sdkv2?
 
@@ -113,6 +155,7 @@ module Line
             {
               type: "text",
               text: text,
+              contents: contents.map(&:to_h), # Convert spans to hash
               wrap: wrap,               # From option
               color: color,             # From option
               lineSpacing: line_spacing, # From option (maps to API key)
@@ -141,6 +184,7 @@ module Line
             {
               type: "text",
               text: text,
+              contents: contents.map(&:to_h), # Convert spans to hash
               wrap: wrap,               # From option
               color: color,             # From option
               line_spacing: line_spacing, # From option (maps to API key)

data/lib/line/message/builder/flex.rb

@@ -26,10 +26,10 @@ module Line
       # instantiates and uses {Flex::Builder} to define the Flex Message structure.
       #
       # @example How a Flex Message is typically initiated (conceptual)
-      #   Line::Message::Builder.with do |root_container|
+      #   Line::Message::Builder.with do
       #     # This `flex` call on root_container would utilize Flex::Builder
-      #     root_container.flex(alt_text: "My Flex Message") do |flex_msg_builder|
-      #       flex_msg_builder.bubble do |bubble_builder|
+      #     flex alt_text: "My Flex Message"  do
+      #       bubble do
       #         # ... define bubble content ...
       #       end
       #     end
@@ -64,6 +64,8 @@ module Line
         require_relative "flex/text"     # Text display
         require_relative "flex/button"   # Interactive button
         require_relative "flex/image"    # Image display
+        require_relative "flex/separator" # Visual separator
+        require_relative "flex/span" # Text span for styling parts of text
       end
     end
   end

data/lib/line/message/builder/version.rb

@@ -3,7 +3,7 @@
 module Line
   module Message
     module Builder
-      VERSION = "0.8.0"
+      VERSION = "0.9.0"
     end
   end
 end

data/lib/line/message/builder.rb

@@ -48,8 +48,8 @@ module Line
       #   instance, allowing you to define the message structure using the DSL.
       # @return [Container] The initialized message container with the defined structure.
       # @example
-      #   message = Line::Message::Builder.with do |root|
-      #     root.text "Hello, world!"
+      #   message = Line::Message::Builder.with do
+      #     text "Hello, world!"
       #   end
       def with(context = nil, mode: :api, &)
         Container.new(context: context, mode: mode, &)

data/lib/line/message/rspec/matchers/have_flex_component.rb

@@ -49,6 +49,7 @@ module Line
               end || @expected.call(content)
             end
 
+            # Directly check if this is the component we're looking for
             @expected.call(content)
           end
 
@@ -114,6 +115,16 @@ module Line
             ::RSpec::Matchers::BuiltIn::Include.new({ "url" => url, **options }).matches?(content)
           end
         end
+
+        def have_line_flex_span(text, **options) # rubocop:disable Naming/PredicateName
+          options = Utils.stringify_keys!(options, deep: true)
+
+          HaveFlexComponent.new(expected_desc: "span(#{text.inspect})") do |content|
+            next false unless content["type"] == "span"
+
+            content["text"].match?(text) && ::RSpec::Matchers::BuiltIn::Include.new(options).matches?(content)
+          end
+        end
       end
     end
   end

data/lib/line/message/rspec/matchers/have_flex_separator.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Line
+  module Message
+    module RSpec
+      # :nodoc:
+      module Matchers
+        def have_line_flex_separator(**options) # rubocop:disable Naming/PredicateName
+          options = Utils.stringify_keys!(options, deep: true)
+
+          HaveFlexComponent.new(expected_desc: "separator(#{options.inspect})") do |content|
+            next false unless content["type"] == "separator"
+
+            options.empty? || ::RSpec::Matchers::BuiltIn::Include.new(options).matches?(content)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/message/rspec/matchers.rb

@@ -6,3 +6,4 @@ require_relative "matchers/have_quick_reply"
 require_relative "matchers/have_flex_message"
 require_relative "matchers/have_flex_bubble"
 require_relative "matchers/have_flex_component"
+require_relative "matchers/have_flex_separator"

data/llm.txt

@@ -18,6 +18,42 @@ end
 # json_output = messages.to_json
 ```
 
+### Coding Style
+
+When using the `Line::Message::Builder` DSL, following is recommended:
+
+```ruby
+Line::Message::Builder.with do
+  flex alt_text: "Hello, World!" do
+    bubble do
+      header do
+        text "Welcome to LINE Messaging API"
+      end
+      body do
+        text "This is a sample message."
+      end
+    end
+  end
+end
+```
+
+DO NOT use `do |container|` syntax as following:
+
+```ruby
+Line::Message::Builder.with do |builder|
+  builder.flex alt_text: "Hello, World!" do
+    builder.bubble do
+      builder.header do
+        builder.text "Welcome to LINE Messaging API"
+      end
+      builder.body do
+        builder.text "This is a sample message."
+      end
+    end
+  end
+end
+```
+
 ### Context
 
 The builder can accept a context object. Methods called within the builder block will first attempt to resolve against this context object. This allows for dynamic message content based on your application's data.
@@ -258,9 +294,18 @@ Displays text.
     - `flex`: (Integer, Optional) Flex factor.
     - `adjust_mode`: (Symbol, Optional) How text adjusts when it overflows. Valid value: `:shrink_to_fit` (reduces font size).
 - `action`: (Action Object, Optional) Makes the text tappable.
+- `span`: Within a Text component, you can add Span components to style parts of the text differently.
 
 ```ruby
+# Simple text component
 text "Special Offer!", size: :xl, weight: :bold, color: "#FF0000", align: :center, action: postback(data: "offer_details")
+
+# Text with spans for different styling of segments
+text "Welcome to our service:" do
+  span "Special ", color: "#FF0000"
+  span "Offer", weight: :bold
+  span "!", decoration: :underline
+end
 ```
 
 #### Button Component
@@ -298,23 +343,59 @@ Displays an image.
 image "https://example.com/product_image.png", size: :full, aspect_ratio: "1:1", aspect_mode: :cover, action: message(text: "View product")
 ```
 
-#### Separators and Spacers
+#### Span Component
+Spans are used within a Text component to apply different styling to specific portions of text. They cannot be used directly within boxes or other containers; they must be placed inside a Text component block.
+
+- `text`: (String, Required) The text content of the span.
+- Styling:
+    - `color`: (String, Optional) Hex color code (e.g., `'#RRGGBB'`, `'#RRGGBBAA'`).
+    - `size`: (Symbol or String, Optional) Font size. Valid keywords: `:xxs`, `:xs`, `:sm`, `:md`, `:lg`, `:xl`, `:xxl`, `:3xl`, `:4xl`, `:5xl`. Also accepts pixel values (e.g., `'16px'`).
+    - `weight`: (Symbol, Optional) Font weight. Valid values: `:regular`, `:bold`.
+    - `decoration`: (Symbol, Optional) Text decoration. Valid values: `:none`, `:underline`, `:line-through`.
+
+Spans also support helper methods to easily apply common styles:
+- `bold!`: Sets the weight to `:bold`.
+- `underline!`: Sets the decoration to `:underline`.
+- `line_through!`: Sets the decoration to `:line-through`.
 
-The LINE Flex Message specification includes `separator` and `spacer` component types. This DSL does not provide explicit `separator()` or `spacer()` methods. Instead:
+```ruby
+# Basic span usage
+text "This message contains:" do
+  span "colored", color: "#FF0000"
+  span " and "
+  span "bold", weight: :bold
+  span " text."
+end
 
-- **Separators**: Achieve a visual line by using a `box` component styled to look like a separator. Set its `height` (for horizontal line) or `width` (for vertical line) to a small value (e.g., `"1px"`) and give it a `background_color`.
-  ```ruby
-  # Example of a horizontal separator
-  box layout: :vertical, padding_all: :md do # Outer box for content
-    text "Content above separator"
-    box height: "1px", background_color: "#CCCCCC", margin: :md # This is the separator
-    text "Content below separator"
+# Using helper methods
+text "This message has:" do
+  span "underlined" do
+    underline!
   end
-  ```
-- **Spacers**: Create space between components using:
-    - `spacing` property on a parent `box` container.
-    - `margin` property on individual components (e.g., `text "Hello", margin: :xl`).
-    - An empty `box` with a defined `flex` value or `height`/`width` (e.g., `box height: "30px"`).
+  span " and "
+  span "bold" do
+    bold!
+  end
+  span " text."
+end
+```
+
+#### Separator Component
+A `separator` draws a horizontal line to create visual separation between components.
+
+```ruby
+box layout: :vertical do
+  text "Section 1"
+  separator
+  text "Section 2"
+end
+```
+
+#### Spacers
+Create space between components using:
+- `spacing` property on a parent `box` container.
+- `margin` property on individual components (e.g., `text "Hello", margin: :xl`).
+- An empty `box` with a defined `flex` value or `height`/`width` (e.g., `box height: "30px"`).
 
 ### Flex Message Partials
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: line-message-builder
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Aotokitsuruya
@@ -42,7 +42,9 @@ files:
 - lib/line/message/builder/flex/image.rb
 - lib/line/message/builder/flex/partial.rb
 - lib/line/message/builder/flex/position.rb
+- lib/line/message/builder/flex/separator.rb
 - lib/line/message/builder/flex/size.rb
+- lib/line/message/builder/flex/span.rb
 - lib/line/message/builder/flex/text.rb
 - lib/line/message/builder/quick_reply.rb
 - lib/line/message/builder/text.rb
@@ -55,6 +57,7 @@ files:
 - lib/line/message/rspec/matchers/have_flex_bubble.rb
 - lib/line/message/rspec/matchers/have_flex_component.rb
 - lib/line/message/rspec/matchers/have_flex_message.rb
+- lib/line/message/rspec/matchers/have_flex_separator.rb
 - lib/line/message/rspec/matchers/have_quick_reply.rb
 - lib/line/message/rspec/matchers/have_text_message.rb
 - lib/line/message/rspec/matchers/utils.rb