slack-ruby-block-kit 0.8.0 → 0.13.0

data/lib/slack/block_kit/element/radio_buttons.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # A radio button group that allows a user to choose one item from a list of possible options.
+      #
+      # https://api.slack.com/reference/messaging/block-elements#radio
+      class RadioButtons
+        include Composition::ConfirmationDialog::Confirmable
+
+        TYPE = 'radio_buttons'
+
+        attr_accessor :options
+
+        def initialize(action_id:)
+          @action_id = action_id
+          @options = []
+
+          yield(self) if block_given?
+        end
+
+        def option(value:, text:, initial: false)
+          option = Composition::Option.new(
+            value: value,
+            text: text,
+            initial: initial
+          )
+
+          @options << option
+
+          self
+        end
+
+        def as_json(*)
+          {
+            type: TYPE,
+            action_id: @action_id,
+            options: @options.map(&:as_json),
+            initial_option: initial_option&.as_json,
+            confirm: confirm&.as_json
+          }.compact
+        end
+
+        private
+
+        def initial_option
+          @options&.find(&:initial?)
+        end
+      end
+    end
+  end
+end

data/lib/slack/block_kit/element/static_select.rb

@@ -13,9 +13,11 @@ module Slack
       #
       # https://api.slack.com/reference/messaging/block-elements#static-select
       class StaticSelect
+        include Composition::ConfirmationDialog::Confirmable
+
         TYPE = 'static_select'
 
-        attr_accessor :confirm, :options, :option_groups, :initial_option
+        attr_accessor :options, :option_groups
 
         def initialize(placeholder:, action_id:, emoji: nil)
           @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
@@ -24,20 +26,13 @@ module Slack
           yield(self) if block_given?
         end
 
-        def confirmation_dialog
-          @confirm = Composition::ConfirmationDialog.new
-
-          yield(@confirm) if block_given?
-
-          self
-        end
-
-        def option(value:, text:, emoji: nil)
+        def option(value:, text:, initial: false, emoji: nil)
           @options ||= []
           @options << Composition::Option.new(
             value: value,
             text: text,
-            emoji: emoji
+            emoji: emoji,
+            initial: initial
           )
 
           self
@@ -54,27 +49,27 @@ module Slack
           self
         end
 
-        def initial(value:, text:, emoji: nil)
-          @initial_option = Composition::Option.new(
-            value: value,
-            text: text,
-            emoji: emoji
-          )
-
-          self
-        end
-
         def as_json(*)
           {
             type: TYPE,
             placeholder: @placeholder.as_json,
             action_id: @action_id,
-            options: @options&.map(&:as_json),
-            option_groups: @option_groups&.map(&:as_json),
-            initial_option: @initial_option&.as_json,
-            confirm: @confirm&.as_json
+            options: options&.map(&:as_json),
+            option_groups: option_groups&.map(&:as_json),
+            initial_option: initial_option&.as_json,
+            confirm: confirm&.as_json
           }.compact
         end
+
+        private
+
+        def initial_option
+          opts = options || option_groups&.flat_map(&:options)
+
+          return unless opts
+
+          opts.find(&:initial?)
+        end
       end
     end
   end

data/lib/slack/block_kit/element/timepicker.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # An element which allows selection of a time of day.
+      #
+      # On desktop clients, this time picker will take the form of a dropdown
+      # list with free-text entry for precise choices. On mobile clients, the
+      # time picker will use native time picker UIs.
+      #
+      # https://api.slack.com/reference/block-kit/block-elements#timepicker
+      class Timepicker
+        include Composition::ConfirmationDialog::Confirmable
+
+        TYPE = 'timepicker'
+
+        def initialize(action_id:)
+          @placeholder, @initial_time = nil
+          @action_id = action_id
+
+          yield(self) if block_given?
+        end
+
+        def placeholder(text:, emoji: nil)
+          @placeholder = Composition::PlainText.new(text: text, emoji: emoji)
+
+          self
+        end
+
+        def initial_time(time_str)
+          @initial_time = time_str
+
+          self
+        end
+
+        def as_json(*)
+          {
+            type: TYPE,
+            action_id: @action_id,
+            placeholder: @placeholder&.as_json,
+            initial_time: @initial_time,
+            confirm: confirm&.as_json
+          }.compact
+        end
+      end
+    end
+  end
+end

data/lib/slack/block_kit/element/users_select.rb

@@ -13,9 +13,9 @@ module Slack
       #
       # https://api.slack.com/reference/messaging/block-elements#users-select
       class UsersSelect
-        TYPE = 'users_select'
+        include Composition::ConfirmationDialog::Confirmable
 
-        attr_accessor :confirm
+        TYPE = 'users_select'
 
         def initialize(placeholder:, action_id:, initial: nil, emoji: nil)
           @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
@@ -25,21 +25,13 @@ module Slack
           yield(self) if block_given?
         end
 
-        def confirmation_dialog
-          @confirm = Composition::ConfirmationDialog.new
-
-          yield(@confirm) if block_given?
-
-          self
-        end
-
         def as_json(*)
           {
             type: TYPE,
             placeholder: @placeholder.as_json,
             action_id: @action_id,
             initial_user: @initial_user,
-            confirm: @confirm&.as_json
+            confirm: confirm&.as_json
           }.compact
         end
       end

data/lib/slack/block_kit/layout/header.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Layout
+      # A header is a plain-text block that displays in a larger, bold font.
+      # Use it to delineate between different groups of content in your app's
+      # surfaces.
+      #
+      # https://api.slack.com/reference/block-kit/blocks#header
+      class Header
+        TYPE = 'header'
+
+        def initialize(text:, block_id: nil, emoji: nil)
+          @text = Composition::PlainText.new(text: text, emoji: emoji)
+          @block_id = block_id
+        end
+
+        def as_json(*)
+          {
+            type: TYPE,
+            text: @text.as_json,
+            block_id: @block_id
+          }.compact
+        end
+      end
+    end
+  end
+end

data/lib/slack/block_kit/layout/image.rb

@@ -13,10 +13,7 @@ module Slack
           @image_url = url
           @alt_text = alt_text
           @block_id = block_id
-
-          return unless title
-
-          @title = Composition::PlainText.new(
+          @title = title && Composition::PlainText.new(
             text: title,
             emoji: emoji
           )

data/lib/slack/block_kit/layout/input.rb

@@ -4,18 +4,20 @@ module Slack
   module BlockKit
     module Layout
       # A block that collects information from users - it can hold a plain-text
-      # input element, a select menu element, a multi-select menu element, or a
-      # datepicker.
+      # input element, a checkbox element, a radio button element,
+      # a select menu element, a multi-select menu element, or a datepicker.
       #
       # https://api.slack.com/reference/block-kit/blocks#input
+      # rubocop:disable Metrics/ClassLength
       class Input
+        # rubocop:enable Metrics/ClassLength
         TYPE = 'input'
 
         attr_accessor :label, :element, :block_id, :hint, :optional, :emoji
 
         def initialize(
           label:,
-          element:,
+          element: nil,
           block_id: nil,
           hint: nil,
           optional: nil,
@@ -28,6 +30,199 @@ module Slack
           @element = element
         end
 
+        def conversation_select(placeholder:, action_id:, initial: nil, emoji: nil)
+          @element = Element::ConversationsSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def multi_conversations_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
+          @element = Element::MultiConversationsSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji,
+            max_selected_items: max_selected_items
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def channels_select(placeholder:, action_id:, initial: nil, emoji: nil)
+          @element = Element::ChannelsSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def checkboxes(action_id:)
+          @element = Element::Checkboxes.new(action_id: action_id)
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def datepicker(action_id:, placeholder: nil, initial: nil, emoji: nil)
+          @element = Element::DatePicker.new(
+            action_id: action_id,
+            placeholder: placeholder,
+            initial: initial,
+            emoji: emoji
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def multi_channels_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
+          @element = Element::MultiChannelsSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji,
+            max_selected_items: max_selected_items
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def static_select(placeholder:, action_id:, emoji: nil)
+          @element = Element::StaticSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            emoji: emoji
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def multi_static_select(placeholder:, action_id:, emoji: nil, max_selected_items: nil)
+          @element = Element::MultiStaticSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            emoji: emoji,
+            max_selected_items: max_selected_items
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def external_select(placeholder:, action_id:, initial: nil, min_query_length: nil, emoji: nil)
+          @element = Element::ExternalSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            min_query_length: min_query_length,
+            emoji: emoji
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def multi_external_select(
+          placeholder:,
+          action_id:,
+          initial: nil,
+          min_query_length: nil,
+          emoji: nil,
+          max_selected_items: nil
+        )
+          @element = Element::MultiExternalSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            min_query_length: min_query_length,
+            emoji: emoji,
+            max_selected_items: max_selected_items
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def plain_text_input(
+          action_id:,
+          placeholder: nil,
+          emoji: nil,
+          initial_value: nil,
+          multiline: nil,
+          min_length: nil,
+          max_length: nil
+        )
+          @element = Element::PlainTextInput.new(
+            action_id: action_id,
+            placeholder: placeholder,
+            emoji: emoji,
+            initial_value: initial_value,
+            multiline: multiline,
+            min_length: min_length,
+            max_length: max_length
+          )
+
+          self
+        end
+
+        def radio_buttons(action_id:)
+          @element = Element::RadioButtons.new(action_id: action_id)
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def users_select(placeholder:, action_id:, initial: nil, emoji: nil)
+          @element = Element::UsersSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
+        def multi_users_select(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
+          @element = Element::MultiUsersSelect.new(
+            placeholder: placeholder,
+            action_id: action_id,
+            initial: initial,
+            emoji: emoji,
+            max_selected_items: max_selected_items
+          )
+
+          yield(@element) if block_given?
+
+          self
+        end
+
         def as_json(*)
           {
             type: TYPE,