block-kit 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a804a3dfaaa47d7d0681129b67ccfb0c788a3cef108babb81211f8cb2ac0ab1
-  data.tar.gz: 883d715af0d8b2b8554534ed61a25fd261a5abafa2973aa8438cd7164ec01585
+  metadata.gz: 033e781b6f1656644ae2038ad1c4d1575f9fe1e9179da732127edb43895612c7
+  data.tar.gz: dbb788025b21764ec964ccfa6c7b2409f47990e64990e62dde1d96ab11e28dd5
 SHA512:
-  metadata.gz: 30c5cdbe2baa09139289fcfe6863a8a4c54257434b0cd66cec794ad79a80697d07577aa87bb770d41ea06b6dc1894529c79b59f91f93206ba12b8c46b9abb216
-  data.tar.gz: 98e2d8afa52dc5a8198678b367f58b29fc6b22fe32f0b0319114b494d97374218c96b346f91b7577ba1c0089e3d076a9677e5b803dc25c5d7f1c8add7382edcb
+  metadata.gz: c9fac2d8adf017f7fcdb109ad1c55f011668c5ec3d2e716d895aaaf38e95d46846b8b7c7a78989e7c8cd40f2ec3a05bf3448d9f9332465757bf7ebe512a55caf
+  data.tar.gz: 777df84ebe6aa32be0ff508d52138bda2546fa5ce0ba60a00aa255637ae3274e78f89382a7cb7dbc70cbbbf91dee43fa937477c30e48aa88ead22e7ebe96dce9

data/README.md

@@ -18,7 +18,7 @@ gem install block-kit
 
 ## Usage
 
-Blocks can be built individually or as a surface or collection of blocks, which each block able to initialize with a simple Hash or attributes or via a block-based DSL. For example, each of the following declarations would result in the same `section` block:
+Blocks can be built individually or as a surface or collection of blocks, which each block able to initialize with a simple Hash of attributes or via a block-based DSL. For example, each of the following declarations would result in the same `section` block:
 
 ```ruby
 require "block-kit"
@@ -180,4 +180,8 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Block::Kit project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/davidcelis/block-kit/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the project's codebase, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/davidcelis/block-kit/blob/main/CODE_OF_CONDUCT.md).
+
+## Acknowledgements
+
+Special thanks to [FireHydrant](https://firehydrant.com) for allowing me to build the initial version on the job (and therefore sponsoring the project)!

data/lib/block_kit/base.rb

@@ -29,8 +29,8 @@ module BlockKit
       attribute_fixers[:base] << {name: method_name, dangerous: dangerous}
     end
 
-    def self.inherited(base)
-      base.attribute_fixers = attribute_fixers.dup
+    def self.inherited(subclass)
+      subclass.attribute_fixers = attribute_fixers.deep_dup
     end
 
     def initialize(attributes = {})

data/lib/block_kit/composition/option.rb

@@ -23,7 +23,11 @@ module BlockKit
       fixes :value, truncate: {maximum: MAX_VALUE_LENGTH, dangerous: true}
 
       validates :description, presence: true, length: {maximum: MAX_DESCRIPTION_LENGTH}, allow_nil: true
-      fixes :description, truncate: {maximum: MAX_DESCRIPTION_LENGTH}, null_value: [:blank]
+      fixes :description, truncate: {maximum: MAX_DESCRIPTION_LENGTH}, null_value: {error_types: [:blank]}
+
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
 
       def initial?
         !!initial

data/lib/block_kit/composition/overflow_option.rb

@@ -11,7 +11,7 @@ module BlockKit
 
       attribute :url, :string
       validates :url, presence: true, format: {with: URI::DEFAULT_PARSER.make_regexp, message: "is not a valid URI", allow_blank: true}, length: {maximum: MAX_URL_LENGTH}, allow_nil: true
-      fixes :url, truncate: {maximum: MAX_URL_LENGTH, dangerous: true, omission: ""}, null_value: [:blank]
+      fixes :url, truncate: {maximum: MAX_URL_LENGTH, dangerous: true, omission: ""}, null_value: {error_types: [:blank]}
 
       def as_json(*)
         super.merge(url: url).compact

data/lib/block_kit/composition/slack_file.rb

@@ -13,10 +13,10 @@ module BlockKit
       attribute :url, :string
 
       validates :id, presence: true, format: {with: /\AF[A-Z0-9]{8,}\z/, allow_blank: true}, allow_nil: true
-      fixes :id, null_value: [:blank]
+      fixes :id, null_value: {error_types: [:blank]}
 
       validates :url, presence: true, length: {maximum: MAX_URL_LENGTH}, format: {with: URI::DEFAULT_PARSER.make_regexp(%w[http https]), message: "is not a valid URI", allow_blank: true}, allow_nil: true
-      fixes :url, null_value: [:blank]
+      fixes :url, null_value: {error_types: [:blank]}
 
       validate :id_or_url_present
 

data/lib/block_kit/composition/text.rb

@@ -11,6 +11,10 @@ module BlockKit
 
       delegate :blank?, :present?, to: :text
 
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
+
       def length
         text&.length || 0
       end

data/lib/block_kit/composition/trigger.rb

@@ -14,7 +14,7 @@ module BlockKit
 
       validates :url, presence: true, length: {maximum: MAX_URL_LENGTH}, format: {with: URI::DEFAULT_PARSER.make_regexp(%w[http https]), message: "is not a valid URI", allow_blank: true}
       validates :customizable_input_parameters, presence: true, "block_kit/validators/associated": true, allow_nil: true
-      fixes :customizable_input_parameters, null_value: [:blank]
+      fixes :customizable_input_parameters, null_value: {error_types: [:blank]}
 
       dsl_method :customizable_input_parameters, as: :customizable_input_parameter, required_fields: [:name, :value], yields: false
 

data/lib/block_kit/elements/base.rb

@@ -9,6 +9,10 @@ module BlockKit
       validates :action_id, presence: true, length: {maximum: MAX_ACTION_ID_LENGTH}, allow_nil: true
       fixes :action_id, truncate: {maximum: MAX_ACTION_ID_LENGTH, dangerous: true, omission: ""}, null_value: {error_types: [:blank]}
 
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
+
       def initialize(attributes = {})
         raise NotImplementedError, "#{self.class} is an abstract class and can't be instantiated." if instance_of?(Base)
 

data/lib/block_kit/elements/base_button.rb

@@ -27,6 +27,10 @@ module BlockKit
       validates :accessibility_label, presence: true, length: {maximum: MAX_ACCESSIBILITY_LABEL_LENGTH}, allow_nil: true
       fixes :accessibility_label, truncate: {maximum: MAX_ACCESSIBILITY_LABEL_LENGTH}, null_value: {error_types: [:blank]}
 
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
+
       def initialize(attributes = {})
         raise NotImplementedError, "#{self.class} is an abstract class and can't be instantiated." if instance_of?(BaseButton)
 

data/lib/block_kit/elements/multi_select.rb

@@ -7,6 +7,10 @@ module BlockKit
       validates :max_selected_items, presence: true, numericality: {only_integer: true, greater_than: 0}, allow_nil: true
       fixes :max_selected_items, null_value: {error_types: [:greater_than]}
 
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
+
       def initialize(attributes = {})
         raise NotImplementedError, "#{self.class} is an abstract class and can't be instantiated." if instance_of?(MultiSelect)
 

data/lib/block_kit/elements/number_input.rb

@@ -42,9 +42,9 @@ module BlockKit
       def as_json(*)
         super.merge(
           is_decimal_allowed: is_decimal_allowed,
-          initial_value: initial_value.respond_to?(:to_digits) ? initial_value.to_digits : initial_value&.to_i,
-          min_value: min_value.respond_to?(:to_digits) ? min_value.to_digits : min_value&.to_i,
-          max_value: max_value.respond_to?(:to_digits) ? max_value.to_digits : max_value&.to_i
+          initial_value: initial_value.respond_to?(:to_digits) ? initial_value.to_digits : initial_value&.to_s,
+          min_value: min_value.respond_to?(:to_digits) ? min_value.to_digits : min_value&.to_s,
+          max_value: max_value.respond_to?(:to_digits) ? max_value.to_digits : max_value&.to_s
         ).compact
       end
     end

data/lib/block_kit/elements/select.rb

@@ -8,6 +8,10 @@ module BlockKit
       include Concerns::HasPlaceholder
       include Concerns::PlainTextEmojiAssignment.new(:placeholder)
 
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
+
       def initialize(attributes = {})
         raise NotImplementedError, "#{self.class} is an abstract class and can't be instantiated." if instance_of?(Select)
 

data/lib/block_kit/layout/base.rb

@@ -9,6 +9,10 @@ module BlockKit
       validates :block_id, presence: true, length: {maximum: MAX_BLOCK_ID_LENGTH}, allow_nil: true
       fixes :block_id, truncate: {maximum: MAX_BLOCK_ID_LENGTH, dangerous: true, omission: ""}, null_value: {error_types: [:blank]}
 
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
+
       def initialize(attributes = {})
         raise NotImplementedError, "#{self.class} is an abstract class and can't be instantiated." if instance_of?(Base)
 

data/lib/block_kit/surfaces/base.rb

@@ -45,6 +45,10 @@ module BlockKit
       dsl_method :blocks, as: :section, type: Layout::Section
       dsl_method :blocks, as: :video, type: Layout::Video, required_fields: [:alt_text, :title, :thumbnail_url, :video_url], yields: false
 
+      def self.inherited(subclass)
+        subclass.attribute_fixers = attribute_fixers.deep_dup
+      end
+
       def initialize(attributes = {})
         raise NotImplementedError, "#{self.class} is an abstract class and can't be instantiated." if instance_of?(Base)
 

data/lib/block_kit/surfaces/modal.rb

@@ -50,7 +50,9 @@ module BlockKit
       fixes :close, truncate: {maximum: MAX_BUTTON_LENGTH}, null_value: {error_types: [:blank]}
 
       validates :submit, presence: true, length: {maximum: MAX_BUTTON_LENGTH}, allow_nil: true
+      validate :submit_present_if_contains_input
       fixes :submit, truncate: {maximum: MAX_BUTTON_LENGTH}, null_value: {error_types: [:blank]}
+      fix :add_default_submit_button
 
       def initialize(attributes = {})
         attributes = attributes.with_indifferent_access
@@ -69,6 +71,20 @@ module BlockKit
           submit_disabled: submit_disabled
         ).compact
       end
+
+      private
+
+      def submit_present_if_contains_input
+        errors.add(:submit, "can't be blank when blocks contain input elements") if contains_input? && submit.blank?
+      end
+
+      def add_default_submit_button
+        self.submit = "Submit" if contains_input? && submit.blank?
+      end
+
+      def contains_input?
+        blocks.any? { |block| block.is_a?(Layout::Input) }
+      end
     end
   end
 end

data/lib/block_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BlockKit
-  VERSION = "1.0.1"
+  VERSION = "1.0.3"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: block-kit
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.3
 platform: ruby
 authors:
 - David Celis
 bindir: exe
 cert_chain: []
-date: 2025-04-17 00:00:00.000000000 Z
+date: 2025-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -72,7 +72,6 @@ files:
 - lib/block_kit/concerns/confirmable.rb
 - lib/block_kit/concerns/conversation_selection.rb
 - lib/block_kit/concerns/dispatchable.rb
-- lib/block_kit/concerns/dsl_generation.rb
 - lib/block_kit/concerns/external.rb
 - lib/block_kit/concerns/focusable_on_load.rb
 - lib/block_kit/concerns/has_initial_option.rb

data/lib/block_kit/concerns/dsl_generation.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-module BlockKit
-  module Concerns
-    module DSLGeneration
-      extend ActiveSupport::Concern
-
-      class_methods do
-        private
-
-        def dsl_method(attribute, as: nil, type: nil, required_fields: [], mutually_exclusive_fields: [], yields: true)
-          type ||= attribute_types[attribute.to_s]
-          type = Types::Generic.of_type(type) if type.is_a?(Class) && type < BlockKit::Base
-          raise ArgumentError, "attribute #{attribute} does not exist" if type.instance_of?(ActiveModel::Type::Value)
-
-          is_array_attribute = false
-
-          if type.instance_of?(Types::Array)
-            is_array_attribute = true
-            type = type.item_type
-          end
-
-          is_array_attribute ||= attribute_types[attribute.to_s].type == :array
-
-          fields = type.block_class.attribute_names.map(&:to_sym)
-          plain_text_fields = type.block_class.attribute_types.select { |_, v| v.respond_to?(:block_class) && v.block_class == Composition::PlainText }.keys.map(&:to_sym)
-
-          define_method(as || attribute) do |args = {}, &block|
-            args = args.symbolize_keys
-
-            # Return the existing attribute if no args or block are passed and we're not in a custom-named method
-            return super() if args.blank? && block.nil? && as.nil?
-
-            if (missing_required_fields = (required_fields - args.keys)) && missing_required_fields.any?
-              message = "missing keyword#{"s" if missing_required_fields.size > 1}: #{missing_required_fields.map(&:inspect).join(", ")}"
-              raise ArgumentError, message
-            end
-
-            unknown_fields = (args.keys - fields)
-            unknown_fields.delete(:emoji) if plain_text_fields.any?
-
-            if unknown_fields.any?
-              message = "unknown keyword#{"s" if unknown_fields.size > 1}: #{unknown_fields.map(&:inspect).join(", ")}"
-              raise ArgumentError, message
-            end
-
-            mutually_exclusive = mutually_exclusive_fields & args.keys
-            if mutually_exclusive.length > 1
-              message = "mutually exclusive keywords: #{mutually_exclusive.map(&:inspect).join(", ")}"
-              raise ArgumentError, message
-            end
-
-            new_value = if is_array_attribute
-              public_send(:"#{attribute}=", []) if public_send(attribute).nil?
-              public_send(attribute) << type.cast(args)
-              public_send(attribute).last
-            else
-              public_send(:"#{attribute}=", type.cast(args))
-              public_send(attribute)
-            end
-
-            plain_text_fields.each do |field|
-              next unless args.key?(field)
-
-              new_value.public_send(field).emoji = args[:emoji] if args.key?(:emoji)
-            end
-
-            block&.call(new_value) if yields
-
-            self
-          end
-        end
-      end
-    end
-  end
-end