slack-ruby-block-kit 0.6.1 → 0.11.0

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

@@ -15,9 +15,11 @@ module Slack
       #
       # https://api.slack.com/reference/messaging/block-elements#overflow
       class OverflowMenu
+        include Composition::ConfirmationDialog::Confirmable
+
         TYPE = 'overflow'
 
-        attr_accessor :options, :confirm
+        attr_accessor :options
 
         def initialize(action_id:)
           @action_id = action_id
@@ -37,20 +39,12 @@ module Slack
           self
         end
 
-        def confirmation_dialog
-          @confirm = Composition::ConfirmationDialog.new
-
-          yield(@confirm) if block_given?
-
-          self
-        end
-
         def as_json(*)
           {
             type: TYPE,
             action_id: @action_id,
             options: @options.map(&:as_json),
-            confirm: @confirm&.as_json
+            confirm: confirm&.as_json
           }.compact
         end
       end

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

@@ -22,7 +22,7 @@ module Slack
           min_length: nil,
           max_length: nil
         )
-          @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji) if placeholder
+          @placeholder = placeholder && Composition::PlainText.new(text: placeholder, emoji: emoji)
           @initial_value = initial_value
           @action_id = action_id
           @multiline = multiline

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

@@ -0,0 +1,48 @@
+# 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, :initial_option
+
+        def initialize(action_id:)
+          @action_id = action_id
+
+          yield(self) if block_given?
+        end
+
+        def option(value:, text:, initial: false)
+          option = Composition::Option.new(
+            value: value,
+            text: text
+          )
+
+          @options ||= []
+          @options << option
+
+          @initial_option = option if initial
+
+          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
+      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, :initial_option
 
         def initialize(placeholder:, action_id:, emoji: nil)
           @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
@@ -24,14 +26,6 @@ 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)
           @options ||= []
           @options << Composition::Option.new(
@@ -72,7 +66,7 @@ module Slack
             options: @options&.map(&:as_json),
             option_groups: @option_groups&.map(&:as_json),
             initial_option: @initial_option&.as_json,
-            confirm: @confirm&.as_json
+            confirm: confirm&.as_json
           }.compact
         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/context.rb

@@ -10,6 +10,7 @@ module Slack
         TYPE = 'context'
 
         attr_accessor :elements
+
         def initialize(block_id: nil)
           @block_id = block_id
           @elements = []

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/section.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative './section/multi_select_elements'
+
 module Slack
   module BlockKit
     module Layout
@@ -8,13 +10,19 @@ module Slack
       # with any of the available block elements.
       #
       # https://api.slack.com/reference/messaging/blocks#section
+      # rubocop:disable Metrics/ClassLength
       class Section
+        # rubocop:enable Metrics/ClassLength
+
+        include Section::MultiSelectElements
         TYPE = 'section'
 
         attr_accessor :fields, :text, :accessory
 
         def initialize(block_id: nil)
           @block_id = block_id
+          @fields = nil
+          @accessory = nil
 
           yield(self) if block_given?
         end
@@ -148,8 +156,28 @@ module Slack
           accessorise(element)
         end
 
+        def checkboxes(action_id:)
+          element = Element::Checkboxes.new(
+            action_id: action_id
+          )
+
+          yield(element) if block_given?
+
+          accessorise(element)
+        end
+
+        def radio_buttons(action_id:)
+          element = Element::RadioButtons.new(
+            action_id: action_id
+          )
+
+          yield(element) if block_given?
+
+          accessorise(element)
+        end
+
         def image(url:, alt_text:)
-          accessorize(Element::Image.new(image_url: url, alt_text: alt_text))
+          accessorise(Element::Image.new(image_url: url, alt_text: alt_text))
         end
 
         def accessorise(element)

data/lib/slack/block_kit/layout/section/multi_select_elements.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Layout
+      class Section
+        # Helper methods for Multi Select to inject to section
+        module MultiSelectElements
+          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?
+
+            accessorise(element)
+          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?
+
+            accessorise(element)
+          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?
+
+            accessorise(element)
+          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?
+
+            accessorise(element)
+          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,
+              emoji: emoji,
+              initial: initial,
+              max_selected_items: max_selected_items
+            )
+
+            yield(element) if block_given?
+
+            accessorise(element)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/surfaces/home.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Slack
+  module Surfaces
+    # The Home tab is a persistent, yet dynamic interface
+    # for apps that lives within the App Home.
+    #
+    # https://api.slack.com/surfaces#tabs
+    # https://api.slack.com/reference/surfaces/views
+    class Home
+      TYPE = 'home'
+
+      def initialize(blocks: nil,
+                     private_metadata: nil, callback_id: nil, external_id: nil)
+        @blocks = blocks || Slack::BlockKit::Blocks.new
+
+        @private_metadata = private_metadata
+        @callback_id = callback_id
+        @external_id = external_id
+      end
+
+      attr_reader :blocks
+
+      def as_json(*)
+        {
+          type: TYPE,
+          blocks: @blocks.as_json,
+          private_metadata: @private_metadata,
+          callback_id: @callback_id,
+          external_id: @external_id
+        }.compact
+      end
+    end
+  end
+end

data/lib/slack/surfaces/message.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Slack
+  module Surfaces
+    # App-published messages are dynamic yet transient spaces.
+    # They allow users to complete workflows among their Slack conversations.
+    #
+    # https://api.slack.com/surfaces#messages
+    # https://api.slack.com/messaging/composing#complex_layouts
+    class Message
+      TYPE = 'message'
+
+      def initialize(blocks: nil, text: nil, channel: nil, thread_ts: nil, as_user: nil)
+        @blocks = blocks || Slack::BlockKit::Blocks.new
+        @channel = channel
+        @thread_ts = thread_ts
+        @as_user = as_user
+        @text = text
+      end
+
+      attr_reader :blocks
+
+      def as_json(*)
+        {
+          channel: @channel,
+          thread_ts: @thread_ts,
+          as_user: @as_user,
+          text: @text,
+          blocks: @blocks.as_json
+        }.compact
+      end
+    end
+  end
+end

data/lib/slack/surfaces/modal.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Slack
+  module Surfaces
+    # Modals provide focused spaces ideal for requesting and collecting data from users,
+    # or temporarily displaying dynamic and interactive information.
+    #
+    # https://api.slack.com/surfaces#modals
+    # https://api.slack.com/reference/surfaces/views
+    #
+    # @param title [String] title is required. Must be set as an initial argument
+    #   or using #title for detail setup
+    #
+    class Modal
+      TYPE = 'modal'
+
+      def initialize(
+        title: nil,
+        blocks: nil,
+        private_metadata: nil,
+        callback_id: nil,
+        external_id: nil,
+        clear_on_close: nil,
+        notify_on_close: nil
+      )
+        @blocks = blocks || Slack::BlockKit::Blocks.new
+
+        @private_metadata = private_metadata
+        @callback_id = callback_id
+        @external_id = external_id
+
+        @clear_on_close = clear_on_close
+        @notify_on_close = notify_on_close
+
+        @title = Slack::BlockKit::Composition::PlainText.new(text: title) if title
+
+        @close, @submit = nil
+      end
+
+      attr_reader :blocks
+
+      def title(text:, emoji: nil)
+        @title = Slack::BlockKit::Composition::PlainText.new(text: text, emoji: emoji)
+
+        self
+      end
+
+      def close(text:, emoji: nil)
+        @close = Slack::BlockKit::Composition::PlainText.new(text: text, emoji: emoji)
+
+        self
+      end
+
+      def submit(text:, emoji: nil)
+        @submit = Slack::BlockKit::Composition::PlainText.new(text: text, emoji: emoji)
+
+        self
+      end
+
+      def as_json(*) # rubocop:disable Metrics/MethodLength
+        {
+          type: TYPE,
+          blocks: @blocks.as_json,
+          title: @title&.as_json,
+          close: @close&.as_json,
+          submit: @submit&.as_json,
+          clear_on_close: @clear_on_close,
+          notify_on_close: @notify_on_close,
+          private_metadata: @private_metadata,
+          callback_id: @callback_id,
+          external_id: @external_id
+        }.compact
+      end
+    end
+  end
+end