slack-ruby-block-kit 0.4.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40f294a5c8ef52820a0db8fd474a4cba423dad298f14092217f6213b47ba45ad
-  data.tar.gz: e22e8b941d6d3c765c6f40735bd97ecd11f94ac4560e3ba038e0cef073a72241
+  metadata.gz: ba4b59b1f8d591f6560563d913833ea5193d3c0ad1ff46e30b4484949d8cfeda
+  data.tar.gz: 90c8576e1fadb6b9a17d8e6c76f9c871e073fa0cab1e9178a26959b80e62b1fa
 SHA512:
-  metadata.gz: d7d952242309b0906da8e5ae6072f618a200e3604ad304ceeb323e2387ec5185cadee7e1554729f9beaf004431f0c97053d30c462d40c0c9bee6aaaa1cd91b88
-  data.tar.gz: 639e9d8b9b57c99022e0080233a0ecae95f958e04732a0f2bd0fc41cc1b704918fa0eb04a28d6e451a2d373f823c1fb8e40c1890d24ebe5d60af58150e6c27cb
+  metadata.gz: 37e969657c3cd6f54fd0f4d9a77292b4740917463823b84af9325a87455b6b686af353d98769a09d6e36e2ddd503e62fc1d460f981c359326deb87232349d89c
+  data.tar.gz: af06784a17f10737b24c85b3ee2b59dd34f0bd61da21e19234d1cca04e213a195ca5698ec8ddbb876dd3a8fdf5894814b2c39da65305747f78a907401fbf5ccb

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:
@@ -13,3 +13,43 @@ Style/AsciiComments:
 Naming/FileName:
   Exclude:
     - lib/slack-ruby-block-kit.rb
+
+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

data/.rubocop_todo.yml

@@ -17,11 +17,6 @@ Metrics/BlockLength:
 Metrics/ClassLength:
   Max: 117
 
-# Offense count: 3
-# Configuration parameters: CountKeywordArgs.
-Metrics/ParameterLists:
-  Max: 6
-
 # Offense count: 5
 # Configuration parameters: Max.
 RSpec/ExampleLength:

data/Gemfile.lock

@@ -1,53 +1,68 @@
 PATH
   remote: .
   specs:
-    slack-ruby-block-kit (0.4.0)
+    slack-ruby-block-kit (0.8.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,5 +1,5 @@
-[![CircleCI](https://circleci.com/gh/CGA1123/slack_block_kit-ruby/tree/master.svg?style=svg)](https://circleci.com/gh/CGA1123/slack_block_kit-ruby/tree/master)
-[![Gem Version](https://badge.fury.io/rb/slack_block_kit.svg)](https://badge.fury.io/rb/slack_block_kit)
+[![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
 
@@ -18,7 +18,7 @@ The 'blocks' availables are split in line with how Slack documents them, that is
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'slack_block_kit'
+gem 'slack-ruby-block-kit'
 ```
 
 
@@ -29,12 +29,12 @@ And then execute:
 
 Or install it yourself as:
 
-    $ gem install slack_block_kit
+    $ gem install slack-ruby-block-kit
 
 Finally, require this:
 
 ```ruby
-require 'slack/block_kit'
+require 'slack-ruby-block-kit'
 ```
 
 ## Examples
@@ -43,7 +43,7 @@ Here are a few examples that might help you get started!
 
 ```ruby
 require 'faraday'
-require 'slack/block_kit'
+require 'slack-ruby-block-kit'
 require 'json'
 
 a_prebuilt_block = Slack::BlockKit::Layout::Section.new
@@ -86,9 +86,9 @@ 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_block_kit-ruby/issues) if you want any inspiration as to what to help with!
+See [issues](https://github.com/CGA1123/slack-ruby-block-kit/issues) if you want any inspiration as to what to help with!
 
 ## License
 

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,12 @@ module Slack
     module Element; end
     module Layout; end
 
-    VERSION = '0.4.0'
+    VERSION = '0.8.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 }
 
     module_function
 

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Slack
+  module BlockKit
+    module Element
+      # A plain-text input, similar to the HTML <input> tag, creates a field
+      # where a user can enter freeform data. It can appear as a single-line
+      # field or a larger textarea using the multiline flag.
+      #
+      # Plain-text input elements are currently only available in modals
+      #
+      # https://api.slack.com/reference/block-kit/block-elements#input
+      class PlainTextInput
+        TYPE = 'plain_text_input'
+
+        def initialize(
+          action_id:,
+          placeholder: nil,
+          emoji: nil,
+          initial_value: nil,
+          multiline: nil,
+          min_length: nil,
+          max_length: nil
+        )
+          @placeholder = placeholder && Composition::PlainText.new(text: placeholder, emoji: emoji)
+          @initial_value = initial_value
+          @action_id = action_id
+          @multiline = multiline
+          @min_length = min_length
+          @max_length = max_length
+        end
+
+        def as_json(*)
+          {
+            type: TYPE,
+            action_id: @action_id,
+            placeholder: @placeholder&.as_json,
+            multiline: @multiline,
+            min_length: @min_length,
+            max_length: @max_length,
+            initial_value: @initial_value
+          }.compact
+        end
+      end
+    end
+  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/input.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+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.
+      #
+      # https://api.slack.com/reference/block-kit/blocks#input
+      class Input
+        TYPE = 'input'
+
+        attr_accessor :label, :element, :block_id, :hint, :optional, :emoji
+
+        def initialize(
+          label:,
+          element:,
+          block_id: nil,
+          hint: nil,
+          optional: nil,
+          emoji: nil
+        )
+          @label = Composition::PlainText.new(text: label, emoji: emoji) if label
+          @hint = Composition::PlainText.new(text: hint, emoji: emoji) if hint
+          @block_id = block_id
+          @optional = optional
+          @element = element
+        end
+
+        def as_json(*)
+          {
+            type: TYPE,
+            element: @element.as_json,
+            label: @label&.as_json,
+            hint: @hint&.as_json,
+            block_id: @block_id,
+            optional: optional
+          }.compact
+        end
+      end
+    end
+  end
+end

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

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/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.4.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Christian Gregg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-29 00:00:00.000000000 Z
+date: 2020-06-26 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,14 +170,22 @@ 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
 - lib/slack/block_kit/element/users_select.rb
 - lib/slack/block_kit/layout/actions.rb
 - lib/slack/block_kit/layout/context.rb
 - lib/slack/block_kit/layout/divider.rb
 - 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
 - slack-ruby-block-kit.gemspec
 homepage: https://github.com/CGA1123/slack-ruby-block-kit
 licenses:
@@ -154,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: A ruby wrapper for Slack's Block Kit