slack-ruby-block-kit 0.5.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 378d3c0f61c46eb14a2b94d00b17ec9c244651410ca1808af7a153799fd5aae3
-  data.tar.gz: 5c6e19732f13dca80bcb6903d33d2b74ab2276d1e3440f39c959ba693d56a0b0
+  metadata.gz: 31d357b44cc9c6e928a1ddc3e469393befde7bcc565416167e76767835551115
+  data.tar.gz: 942fb2311a0e388e7fe4d2fe40a76b2c398583fe06facdac05547b2d3102b6b1
 SHA512:
-  metadata.gz: f461f8b3321c739727690bf72f02598698e5de10a2a99626f1bffa68a47771777f9af783df6063df841ab85e8db6fea6dcce8e5cb027ae029fcf88253f7f13f5
-  data.tar.gz: 7c80bdbf03ce41fef6a11f816a3ffaf9eda92ddd2011a9e20e3c6e9653ebf3306e529aa1b5c53811792d532a18ba732ec55163df3467e490652f6c4c7b2df562
+  metadata.gz: 93c87de2988ede207c6950fd00ed7c68a84cb30cefeeeb105ce8309595f7135ef5db5ed3a9fa2ebf02e06b0744c0633ac3cd551ac9d93c43462ca1c8a1cb9d9f
+  data.tar.gz: 591a9b52614a626dccbe11dd1ddbf3ec6114f54f509209643d7e6eeac5a213d2e1262842c345ffab18af86e58fecec90ea7f5372403a2f8a03f36e131b5933dc

data/.circleci/config.yml

@@ -2,7 +2,7 @@ version: 2
 jobs:
   build:
     docker:
-      - image: circleci/ruby:2.5.3
+      - image: circleci/ruby:2.7
 
     working_directory: ~/repo
 

data/.github/dependabot.yml

@@ -0,0 +1,9 @@
+version: 2
+updates:
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 99
+  reviewers:
+  - CGA1123

data/.gitignore

@@ -11,3 +11,4 @@
 # rspec failure tracking
 .rspec_status
 *.gem
+.env

data/.rubocop.yml

@@ -4,7 +4,7 @@ inherit_from: .rubocop_todo.yml
 AllCops:
   TargetRubyVersion: 2.5.3
 
-Metrics/LineLength:
+Layout/LineLength:
   Max: 120
 
 Style/AsciiComments:
@@ -16,3 +16,52 @@ Naming/FileName:
 
 Metrics/ParameterLists:
   Max: 8
+
+Metrics/BlockLength:
+  Exclude:
+    - 'Rakefile'
+    - '**/*.rake'
+    - 'spec/**/*.rb'
+    - '**/*.gemspec'
+
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+
+Lint/RaiseException:
+  Enabled: true
+
+Lint/StructNewOverride:
+  Enabled: true
+
+Style/ExponentialNotation:
+  Enabled: true
+
+Style/HashEachMethods:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+
+Style/HashTransformValues:
+  Enabled: true
+
+Style/SlicingWithRange:
+  Enabled: true
+
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+
+Style/RedundantFetchBlock:
+  Enabled: true
+
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+
+Style/RedundantRegexpEscape:
+  Enabled: true

data/Gemfile.lock

@@ -1,53 +1,68 @@
 PATH
   remote: .
   specs:
-    slack-ruby-block-kit (0.5.0)
+    slack-ruby-block-kit (0.9.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.0)
+    ast (2.4.1)
+    coderay (1.1.2)
     diff-lcs (1.3)
-    jaro_winkler (1.5.2)
-    parallel (1.13.0)
-    parser (2.6.0.0)
-      ast (~> 2.4.0)
-    powerpack (0.1.2)
+    dotenv (2.7.5)
+    faraday (1.0.1)
+      multipart-post (>= 1.2, < 3)
+    method_source (1.0.0)
+    multipart-post (2.1.1)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
     rainbow (3.0.0)
     rake (13.0.1)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.2)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
     rspec_junit_formatter (0.4.1)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (0.63.1)
-      jaro_winkler (~> 1.5.1)
+    rubocop (0.86.0)
       parallel (~> 1.10)
-      parser (>= 2.5, != 2.5.1.1)
-      powerpack (~> 0.1)
+      parser (>= 2.7.0.1)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.0.3, < 1.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (~> 1.4.0)
-    rubocop-rspec (1.32.0)
-      rubocop (>= 0.60.0)
-    ruby-progressbar (1.10.0)
-    unicode-display_width (1.4.1)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.0.3)
+      parser (>= 2.7.0.1)
+    rubocop-rspec (1.40.0)
+      rubocop (>= 0.68.1)
+    ruby-progressbar (1.10.1)
+    unicode-display_width (1.7.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (< 2.0)
+  bundler
+  dotenv
+  faraday
+  pry
   rake
   rspec
   rspec_junit_formatter
@@ -56,4 +71,4 @@ DEPENDENCIES
   slack-ruby-block-kit!
 
 BUNDLED WITH
-   1.17.3
+   2.1.4

data/README.md

@@ -1,4 +1,4 @@
-[![CircleCI](https://circleci.com/gh/CGA1123/slack-ruby-block-kit/tree/master.svg?style=svg)](https://circleci.com/gh/CGA1123/slack_block_kit-ruby/tree/master)
+[![CircleCI](https://circleci.com/gh/CGA1123/slack-ruby-block-kit/tree/master.svg?style=svg)](https://circleci.com/gh/CGA1123/slack-ruby-block-kit/tree/master)
 [![Gem Version](https://badge.fury.io/rb/slack-ruby-block-kit.svg)](https://badge.fury.io/rb/slack-ruby-block-kit)
 
 # Slack::BlockKit
@@ -86,7 +86,7 @@ You can also check out the [`slackerduty`](https://github.com/CGA1123/slackerdut
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/CGA1123/slack_block_kit-ruby
+Bug reports and pull requests are welcome on GitHub at https://github.com/CGA1123/slack-ruby-block-kit
 
 See [issues](https://github.com/CGA1123/slack-ruby-block-kit/issues) if you want any inspiration as to what to help with!
 

data/bin/console

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+lib = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'bundler/setup'
+require 'dotenv/load'
+require 'slack-ruby-block-kit'
+require 'faraday'
+require 'pry'
+
+Pry.start

data/lib/slack/block_kit.rb

@@ -6,12 +6,13 @@ module Slack
     module Element; end
     module Layout; end
 
-    VERSION = '0.5.0'
+    VERSION = '0.9.0'
 
-    Dir[File.join(__dir__, 'block_kit', 'composition', '*.rb')].each { |file| require file }
-    Dir[File.join(__dir__, 'block_kit', 'element', '*.rb')].each { |file| require file }
-    Dir[File.join(__dir__, 'block_kit', 'layout', '*.rb')].each { |file| require file }
-    Dir[File.join(__dir__, 'block_kit', '*.rb')].each { |file| require file }
+    Dir[File.join(__dir__, 'block_kit', 'composition', '*.rb')].sort.each { |file| require file }
+    Dir[File.join(__dir__, 'block_kit', 'element', '*.rb')].sort.each { |file| require file }
+    Dir[File.join(__dir__, 'block_kit', 'layout', '*.rb')].sort.each { |file| require file }
+    Dir[File.join(__dir__, 'block_kit', '*.rb')].sort.each { |file| require file }
+    Dir[File.join(__dir__, 'surfaces', '*.rb')].sort.each { |file| require file }
 
     module_function
 
@@ -22,5 +23,48 @@ module Slack
 
       blocks
     end
+
+    def home(blocks: nil,
+             private_metadata: nil, callback_id: nil, external_id: nil)
+      home_surface = Slack::Surfaces::Home.new(blocks: blocks,
+                                               private_metadata: private_metadata,
+                                               callback_id: callback_id,
+                                               external_id: external_id)
+
+      yield(home_surface) if block_given?
+
+      home_surface
+    end
+
+    def modal(title: nil,
+              blocks: nil,
+              private_metadata: nil, callback_id: nil, external_id: nil,
+              clear_on_close: nil, notify_on_close: nil)
+      modal_surface = Slack::Surfaces::Modal.new(title: title,
+                                                 blocks: blocks,
+                                                 private_metadata: private_metadata,
+                                                 callback_id: callback_id,
+                                                 external_id: external_id,
+                                                 clear_on_close: clear_on_close,
+                                                 notify_on_close: notify_on_close)
+
+      yield(modal_surface) if block_given?
+
+      modal_surface
+    end
+
+    def message(blocks: nil, channel: nil, thread_ts: nil, as_user: nil, text: nil)
+      message_surface = Slack::Surfaces::Message.new(
+        blocks: blocks,
+        channel: channel,
+        thread_ts: thread_ts,
+        text: text,
+        as_user: as_user
+      )
+
+      yield(message_surface) if block_given?
+
+      message_surface
+    end
   end
 end

data/lib/slack/block_kit/composition/confirmation_dialog.rb

@@ -9,6 +9,10 @@ module Slack
       #
       # https://api.slack.com/reference/messaging/composition-objects#confirm
       class ConfirmationDialog
+        def initialize
+          @title, @confirm, @text, @style = nil
+        end
+
         def title(text:, emoji: nil)
           @title = PlainText.new(text: text, emoji: emoji)
 
@@ -33,6 +37,12 @@ module Slack
           self
         end
 
+        def style(value)
+          @style = value
+
+          self
+        end
+
         def mrkdwn(text:, verbatim: nil)
           @text = Mrkdwn.new(text: text, verbatim: verbatim)
 
@@ -44,8 +54,9 @@ module Slack
             title: @title.as_json,
             text: @text.as_json,
             confirm: @confirm.as_json,
-            deny: @deny.as_json
-          }
+            deny: @deny.as_json,
+            style: @style
+          }.compact
         end
       end
     end

data/lib/slack/block_kit/composition/conversation_filter.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Composition
+      # Provides a way to filter the list of options in a conversations select menu
+      # or conversations multi-select menu.
+      #
+      # @param [Array] only - "include" field
+      #
+      # https://api.slack.com/reference/block-kit/composition-objects#filter_conversations
+      # https://api.slack.com/reference/block-kit/block-elements#conversation_multi_select
+      # https://api.slack.com/reference/block-kit/block-elements#conversation_select
+      class ConversationFilter
+        def initialize(only: nil,
+                       exclude_external_shared_channels: nil,
+                       exclude_bot_users: nil)
+          @only = only
+          @exclude_external_shared_channels = exclude_external_shared_channels
+          @exclude_bot_users = exclude_bot_users
+        end
+
+        def as_json(*)
+          {
+            include: @only,
+            exclude_external_shared_channels: @exclude_external_shared_channels,
+            exclude_bot_users: @exclude_bot_users
+          }.compact
+        end
+      end
+    end
+  end
+end

data/lib/slack/block_kit/composition/option.rb

@@ -8,16 +8,20 @@ module Slack
       # https://api.slack.com/reference/messaging/composition-objects#option
       # https://api.slack.com/reference/messaging/block-elements#select
       class Option
-        def initialize(value:, text:, emoji: nil)
+        def initialize(value:, text:, emoji: nil, description: nil, url: nil)
           @text = PlainText.new(text: text, emoji: emoji)
           @value = value
+          @description = description && PlainText.new(text: description, emoji: emoji)
+          @url = url
         end
 
         def as_json(*)
           {
             text: @text.as_json,
-            value: @value
-          }
+            value: @value,
+            description: @description&.as_json,
+            url: @url
+          }.compact
         end
       end
     end

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

@@ -22,6 +22,7 @@ module Slack
           @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
           @action_id = action_id
           @initial_conversation = initial
+          @filter = nil
 
           yield(self) if block_given?
         end
@@ -34,13 +35,26 @@ module Slack
           self
         end
 
+        def filter(only: nil,
+                   exclude_external_shared_channels: nil,
+                   exclude_bot_users: nil)
+          @filter = Composition::ConversationFilter.new(
+            only: only,
+            exclude_external_shared_channels: exclude_external_shared_channels,
+            exclude_bot_users: exclude_bot_users
+          )
+
+          self
+        end
+
         def as_json(*)
           {
             type: TYPE,
             placeholder: @placeholder.as_json,
             action_id: @action_id,
             initial_conversation: @initial_conversation,
-            confirm: @confirm&.as_json
+            confirm: @confirm&.as_json,
+            filter: @filter&.as_json
           }.compact
         end
       end

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

@@ -28,6 +28,7 @@ module Slack
           @action_id = action_id
           @initial_option = initial
           @min_query_length = min_query_length
+          @confirm = nil
 
           yield(self) if block_given?
         end
@@ -46,7 +47,7 @@ module Slack
             placeholder: @placeholder.as_json,
             action_id: @action_id,
             initial_option: @initial_option&.as_json,
-            min_query_length: min_query_length,
+            min_query_length: @min_query_length,
             confirm: @confirm&.as_json
           }.compact
         end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # A select menu, just as with a standard HTML <select> tag, creates a drop
+      # down menu with a list of options for a user to choose. The select menu
+      # also includes type-ahead functionality, where a user can type a part or
+      # all of an option string to filter the list.
+      #
+      # This multi-select menu will populate its options with a list of public
+      # channels visible to the current user in the active workspace.
+      #
+      # https://api.slack.com/reference/block-kit/block-elements#channel_multi_select
+      class MultiChannelsSelect
+        TYPE = 'multi_channels_select'
+
+        attr_accessor :confirm
+
+        def initialize(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
+          @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
+          @action_id = action_id
+          @initial_channel = initial
+          @confirm = nil
+          @max_selected_items = max_selected_items
+
+          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_channel: @initial_channel,
+            confirm: @confirm&.as_json,
+            max_selected_items: @max_selected_items
+          }.compact
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # A select menu, just as with a standard HTML <select> tag, creates a drop
+      # down menu with a list of options for a user to choose. The select menu
+      # also includes type-ahead functionality, where a user can type a part or
+      # all of an option string to filter the list.
+      #
+      # This multi-select menu will populate its options with a list of public and
+      # private channels, DMs, and MPIMs visible to the current user in the
+      # active workspace.
+      #
+      # https://api.slack.com/reference/block-kit/block-elements#conversation_multi_select
+      class MultiConversationsSelect
+        TYPE = 'multi_conversations_select'
+
+        attr_accessor :confirm
+
+        def initialize(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
+          @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
+          @action_id = action_id
+          @initial_conversation = initial
+          @confirm = nil
+          @max_selected_items = max_selected_items
+          @filter = nil
+
+          yield(self) if block_given?
+        end
+
+        def confirmation_dialog
+          @confirm = Composition::ConfirmationDialog.new
+
+          yield(@confirm) if block_given?
+
+          self
+        end
+
+        def filter(only: nil,
+                   exclude_external_shared_channels: nil,
+                   exclude_bot_users: nil)
+          @filter = Composition::ConversationFilter.new(
+            only: only,
+            exclude_external_shared_channels: exclude_external_shared_channels,
+            exclude_bot_users: exclude_bot_users
+          )
+
+          self
+        end
+
+        def as_json(*)
+          {
+            type: TYPE,
+            placeholder: @placeholder.as_json,
+            action_id: @action_id,
+            initial_conversation: @initial_conversation,
+            confirm: @confirm&.as_json,
+            max_selected_items: @max_selected_items,
+            filter: @filter&.as_json
+          }.compact
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # A select menu, just as with a standard HTML <select> tag, creates a drop
+      # down menu with a list of options for a user to choose. The select menu
+      # also includes type-ahead functionality, where a user can type a part or
+      # all of an option string to filter the list.
+      #
+      # This select menu will load its options from an external data source,
+      # allowing for a dynamic list of options.
+      #
+      # Each time a select menu of this type is opened or the user starts typing
+      # in the typeahead field, we'll send a request to your specified URL. Your
+      # app should return an HTTP 200 OK response, along with an
+      # application/json post body with an object containing either an options
+      # array, or an option_groups array.
+      #
+      # https://api.slack.com/reference/block-kit/block-elements#external_multi_select
+      class MultiExternalSelect
+        TYPE = 'multi_external_select'
+
+        attr_accessor :confirm
+
+        def initialize(placeholder:, action_id:,
+                       initial: nil, min_query_length: nil, emoji: nil, max_selected_items: nil)
+
+          @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
+          @action_id = action_id
+          @initial_option = initial
+          @min_query_length = min_query_length
+          @confirm = nil
+          @max_selected_items = max_selected_items
+
+          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_option: @initial_option&.as_json,
+            min_query_length: @min_query_length,
+            confirm: @confirm&.as_json,
+            max_selected_items: @max_selected_items
+          }.compact
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # A select menu, just as with a standard HTML <select> tag, creates a drop
+      # down menu with a list of options for a user to choose. The select menu
+      # also includes type-ahead functionality, where a user can type a part or
+      # all of an option string to filter the list.
+      #
+      # This is the simplest form of select menu, with a static list of options
+      # passed in when defining the element.
+      #
+      # https://api.slack.com/reference/block-kit/block-elements#static_multi_select
+      class MultiStaticSelect
+        TYPE = 'multi_static_select'
+
+        attr_accessor :confirm, :options, :option_groups, :initial_option
+
+        def initialize(placeholder:, action_id:, emoji: nil, max_selected_items: nil)
+          @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
+          @action_id = action_id
+          @confirm = nil
+          @max_selected_items = max_selected_items
+
+          @options = nil
+          @option_groups = nil
+          @initial_option = nil
+
+          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(
+            value: value,
+            text: text,
+            emoji: emoji
+          )
+
+          self
+        end
+
+        def option_group(label:, emoji: nil)
+          option_group = Composition::OptionGroup.new(label: label, emoji: emoji)
+
+          yield(option_group) if block_given?
+
+          @option_groups ||= []
+          @option_groups << option_group
+
+          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,
+            max_selected_items: @max_selected_items
+          }.compact
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # A select menu, just as with a standard HTML <select> tag, creates a drop
+      # down menu with a list of options for a user to choose. The select menu
+      # also includes type-ahead functionality, where a user can type a part or
+      # all of an option string to filter the list.
+      #
+      # This multi-select menu will populate its options with a list of Slack users
+      # visible to the current user in the active workspace.
+      #
+      # https://api.slack.com/reference/block-kit/block-elements#users_multi_select
+      class MultiUsersSelect
+        TYPE = 'multi_users_select'
+
+        attr_accessor :confirm
+
+        def initialize(placeholder:, action_id:, initial: nil, emoji: nil, max_selected_items: nil)
+          @placeholder = Composition::PlainText.new(text: placeholder, emoji: emoji)
+          @action_id = action_id
+          @initial_user = initial
+          @confirm = nil
+          @max_selected_items = max_selected_items
+
+          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,
+            max_selected_items: @max_selected_items
+          }.compact
+        end
+      end
+    end
+  end
+end

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

@@ -22,15 +22,17 @@ module Slack
         def initialize(action_id:)
           @action_id = action_id
           @options = []
+          @confirm = nil
 
           yield(self) if block_given?
         end
 
-        def option(value:, text:, emoji: nil)
+        def option(value:, text:, emoji: nil, url: nil)
           @options << Composition::Option.new(
             value: value,
             text: text,
-            emoji: emoji
+            emoji: emoji,
+            url: url
           )
 
           self

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/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
@@ -149,7 +157,7 @@ module Slack
         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

data/slack-ruby-block-kit.gemspec

@@ -28,7 +28,10 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
   spec.required_ruby_version = '>= 2.5'
 
-  spec.add_development_dependency 'bundler', '< 2.0'
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'dotenv'
+  spec.add_development_dependency 'faraday'
+  spec.add_development_dependency 'pry'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec'
   spec.add_development_dependency 'rspec_junit_formatter'

metadata

@@ -1,29 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: slack-ruby-block-kit
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Christian Gregg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-05 00:00:00.000000000 Z
+date: 2020-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -102,6 +144,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".circleci/config.yml"
+- ".github/dependabot.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -111,10 +154,12 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- bin/console
 - lib/slack-ruby-block-kit.rb
 - lib/slack/block_kit.rb
 - lib/slack/block_kit/blocks.rb
 - lib/slack/block_kit/composition/confirmation_dialog.rb
+- lib/slack/block_kit/composition/conversation_filter.rb
 - lib/slack/block_kit/composition/mrkdwn.rb
 - lib/slack/block_kit/composition/option.rb
 - lib/slack/block_kit/composition/option_group.rb
@@ -125,6 +170,11 @@ files:
 - lib/slack/block_kit/element/date_picker.rb
 - lib/slack/block_kit/element/external_select.rb
 - lib/slack/block_kit/element/image.rb
+- lib/slack/block_kit/element/multi_channels_select.rb
+- lib/slack/block_kit/element/multi_conversations_select.rb
+- lib/slack/block_kit/element/multi_external_select.rb
+- lib/slack/block_kit/element/multi_static_select.rb
+- lib/slack/block_kit/element/multi_users_select.rb
 - lib/slack/block_kit/element/overflow_menu.rb
 - lib/slack/block_kit/element/plain_text_input.rb
 - lib/slack/block_kit/element/static_select.rb
@@ -135,6 +185,10 @@ files:
 - lib/slack/block_kit/layout/image.rb
 - lib/slack/block_kit/layout/input.rb
 - lib/slack/block_kit/layout/section.rb
+- lib/slack/block_kit/layout/section/multi_select_elements.rb
+- lib/slack/surfaces/home.rb
+- lib/slack/surfaces/message.rb
+- lib/slack/surfaces/modal.rb
 - slack-ruby-block-kit.gemspec
 homepage: https://github.com/CGA1123/slack-ruby-block-kit
 licenses: