slackblocks 3.1.0 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2854904b3e2e3ecbdf99f451ce5fa572336b2f9ed1946d18b9a5f6089d6ea889
-  data.tar.gz: 2fc7f9e644c71a5554b4095e2896374a9be3d8cd7366d7c700a9bbf4899fc604
+  metadata.gz: 827536ece4c547f433c37b5ea250d8df94e5cc1455675c5c6535bfc43a662f0f
+  data.tar.gz: 5a070516e5d8948924d79dd08d779678f3ae7d4af2dbbda540d9e0332df5e44c
 SHA512:
-  metadata.gz: 7e63f0c5e302a0ee9841fcd18cf143cb9995ab9a6314063efc5f8111a792423dec1c8dbdec3503602155823b71257d37a856953f973bf1e3d2a5c6a5eddec618
-  data.tar.gz: 3a30a4e84adb15803679cc90b2a7d1b1fc24d687b6a56e558f5278414067e962bc55782c6efdcb75324192ed5be45e2d113ef7bd129443e6352bdfdf0ba5e7c3
+  metadata.gz: fcb284a50cc685907415660a3308f4b7107f086d45dc523fd56c93ea996ae1605f9e8dd853b63cbcbfbdefa257e9af5019e0bd59a4f2c2a5bb8143c9f8a34283
+  data.tar.gz: 6fbaaae9df8455182841fa8102310f44e9d377fa48dd2c6218a963764033f1a57026af29142ca05544ae1fbfda802a6631a05153b31b23cd2e3b61c738d5fbce

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [3.2.0] — 2026-10-31
+
+- Add native layout blocks, rows and items with typed widths/alignment, closed child and fallback roles, checked nesting and receiving-surface validation (spec 1.5.0).
+- Preserve confirmed top-level message/view block counting, supported runtime minimums, legacy container-only behavior, and existing chart/text limits. No unconfirmed recursive block budget is imposed.
+- Add a runnable ten-language layout recipe and rendered preview; preserve outgoing 3.1.0 documentation.
+
 ## [3.1.0] — 2026-10-28
 
 - Coordinate this release with the new Haskell implementation and ten-language documentation. Existing runtime support remains unchanged.

data/lib/slackblocks/generated/limits.rb

@@ -1,7 +1,7 @@
 # Generated from spec/limits.json. Do not edit by hand.
 module Slackblocks
   module Limits
-    VALUES = {"action_id.max_length" => 255, "actions.elements.max_items" => 25, "alert.text.max_length" => 200, "block_id.max_length" => 255, "button.accessibility_label.max_length" => 75, "button.agent_prompt.max_length" => 4000, "button.text.max_length" => 75, "button.url.max_length" => 3000, "button.value.max_length" => 2000, "card.actions.max_items" => 3, "card.body.max_length" => 200, "card.subtext.max_length" => 200, "card.subtitle.max_length" => 150, "card.title.max_length" => 150, "carousel.elements.max_items" => 10, "carousel.elements.min_items" => 1, "checkboxes.options.max_items" => 10, "checkboxes.options.min_items" => 1, "confirmation.confirm.max_length" => 30, "confirmation.deny.max_length" => 30, "confirmation.text.max_length" => 300, "confirmation.title.max_length" => 100, "container.child_blocks.max_items" => 10, "container.child_blocks.min_items" => 1, "container.subtitle.max_length" => 150, "container.title.max_length" => 150, "context.elements.max_items" => 10, "context_actions.elements.max_items" => 5, "conversation_filter.include.min_items" => 1, "data_table.cell_text.min_length" => 1, "data_table.columns.max_items" => 20, "data_table.columns.min_items" => 1, "data_table.content.max_length" => 20000, "data_table.page_size.max" => 100, "data_table.page_size.min" => 1, "data_table.row_header_column_index.min" => 0, "data_table.rows.max_items" => 201, "data_table.rows.min_items" => 2, "data_table.total_content.max_length" => 20000, "data_visualization.axis_label.max_length" => 50, "data_visualization.categories.max_items" => 20, "data_visualization.categories.min_items" => 1, "data_visualization.category_label.max_length" => 20, "data_visualization.data.max_items" => 20, "data_visualization.data.min_items" => 1, "data_visualization.point_label.max_length" => 20, "data_visualization.segment.label.max_length" => 20, "data_visualization.segment.value.exclusive_min" => 0, "data_visualization.segments.max_items" => 12, "data_visualization.segments.min_items" => 1, "data_visualization.series.max_items" => 12, "data_visualization.series.min_items" => 1, "data_visualization.series_name.max_length" => 20, "data_visualization.title.max_length" => 50, "date_picker.placeholder.max_length" => 150, "dispatch_action_configuration.trigger_actions_on.max_items" => 2, "dispatch_action_configuration.trigger_actions_on.min_items" => 1, "email_input.placeholder.max_length" => 150, "feedback_button.accessibility_label.max_length" => 75, "feedback_button.text.max_length" => 75, "feedback_button.value.max_length" => 2000, "file_input.max_files.max" => 10, "file_input.max_files.min" => 1, "header.text.max_length" => 150, "icon_button.accessibility_label.max_length" => 75, "icon_button.value.max_length" => 2000, "icon_button.visible_to_user_ids.max_items" => 10, "image.alt_text.max_length" => 2000, "image.image_url.max_length" => 3000, "image.title.max_length" => 2000, "image_element.alt_text.max_length" => 2000, "image_element.image_url.max_length" => 3000, "input.hint.max_length" => 2000, "input.label.max_length" => 2000, "markdown.text.max_length" => 12000, "markdown.total_text.max_length" => 12000, "message.attachments.max_items" => 100, "message.blocks.max_items" => 50, "message.channel.min_length" => 1, "message.data_visualizations.max_items" => 2, "multi_select.max_selected_items.min" => 1, "number_input.placeholder.max_length" => 150, "option.description.max_length" => 75, "option.text.max_length" => 75, "option.url.max_length" => 3000, "option.value.max_length" => 150, "option_group.label.max_length" => 75, "option_group.options.max_items" => 100, "option_group.options.min_items" => 1, "overflow.options.max_items" => 5, "overflow.options.min_items" => 1, "plain_text_input.max_length.max" => 3000, "plain_text_input.max_length.min" => 1, "plain_text_input.min_length.max" => 3000, "plain_text_input.min_length.min" => 0, "plain_text_input.placeholder.max_length" => 150, "plan.tasks.max_items" => 50, "radio_buttons.options.max_items" => 10, "radio_buttons.options.min_items" => 1, "rich_text_input.max_lines.max" => 100, "rich_text_input.max_lines.min" => 1, "rich_text_input.min_lines.max" => 100, "rich_text_input.min_lines.min" => 1, "rich_text_input.placeholder.max_length" => 150, "rich_text_list.border.max" => 1, "rich_text_list.border.min" => 0, "rich_text_list.indent.max" => 8, "rich_text_list.indent.min" => 0, "rich_text_list.offset.min" => 0, "rich_text_preformatted.border.max" => 1, "rich_text_preformatted.border.min" => 0, "rich_text_quote.border.max" => 1, "rich_text_quote.border.min" => 0, "section.fields.item_max_length" => 2000, "section.fields.max_items" => 10, "section.text.max_length" => 3000, "select.min_query_length.min" => 0, "select.option_groups.max_items" => 100, "select.option_groups.min_items" => 1, "select.options.max_items" => 100, "select.options.min_items" => 1, "select.placeholder.max_length" => 150, "table.column_settings.max_items" => 20, "table.columns.max_items" => 20, "table.rows.max_items" => 100, "text.max_length" => 3000, "text.min_length" => 1, "time_picker.placeholder.max_length" => 150, "url_input.placeholder.max_length" => 150, "video.alt_text.max_length" => 2000, "video.author_name.max_length" => 50, "video.description.max_length" => 200, "video.provider_icon_url.max_length" => 2000, "video.provider_name.max_length" => 50, "video.thumbnail_url.max_length" => 3000, "video.title.max_length" => 200, "video.title_url.max_length" => 2000, "video.video_url.max_length" => 3000, "view.blocks.max_items" => 100, "view.callback_id.max_length" => 255, "view.close.max_length" => 24, "view.external_id.max_length" => 255, "view.private_metadata.max_length" => 3000, "view.submit.max_length" => 24, "view.title.max_length" => 24, "workflow_button.accessibility_label.max_length" => 75, "workflow_button.text.max_length" => 75}.freeze
+    VALUES = {"action_id.max_length" => 255, "actions.elements.max_items" => 25, "alert.text.max_length" => 200, "block_id.max_length" => 255, "button.accessibility_label.max_length" => 75, "button.agent_prompt.max_length" => 4000, "button.text.max_length" => 75, "button.url.max_length" => 3000, "button.value.max_length" => 2000, "card.actions.max_items" => 3, "card.body.max_length" => 200, "card.subtext.max_length" => 200, "card.subtitle.max_length" => 150, "card.title.max_length" => 150, "carousel.elements.max_items" => 10, "carousel.elements.min_items" => 1, "checkboxes.options.max_items" => 10, "checkboxes.options.min_items" => 1, "confirmation.confirm.max_length" => 30, "confirmation.deny.max_length" => 30, "confirmation.text.max_length" => 300, "confirmation.title.max_length" => 100, "container.child_blocks.max_items" => 10, "container.child_blocks.min_items" => 1, "container.subtitle.max_length" => 150, "container.title.max_length" => 150, "context.elements.max_items" => 10, "context_actions.elements.max_items" => 5, "conversation_filter.include.min_items" => 1, "data_table.cell_text.min_length" => 1, "data_table.columns.max_items" => 20, "data_table.columns.min_items" => 1, "data_table.content.max_length" => 20000, "data_table.page_size.max" => 100, "data_table.page_size.min" => 1, "data_table.row_header_column_index.min" => 0, "data_table.rows.max_items" => 201, "data_table.rows.min_items" => 2, "data_table.total_content.max_length" => 20000, "data_visualization.axis_label.max_length" => 50, "data_visualization.categories.max_items" => 20, "data_visualization.categories.min_items" => 1, "data_visualization.category_label.max_length" => 20, "data_visualization.data.max_items" => 20, "data_visualization.data.min_items" => 1, "data_visualization.point_label.max_length" => 20, "data_visualization.segment.label.max_length" => 20, "data_visualization.segment.value.exclusive_min" => 0, "data_visualization.segments.max_items" => 12, "data_visualization.segments.min_items" => 1, "data_visualization.series.max_items" => 12, "data_visualization.series.min_items" => 1, "data_visualization.series_name.max_length" => 20, "data_visualization.title.max_length" => 50, "date_picker.placeholder.max_length" => 150, "dispatch_action_configuration.trigger_actions_on.max_items" => 2, "dispatch_action_configuration.trigger_actions_on.min_items" => 1, "email_input.placeholder.max_length" => 150, "feedback_button.accessibility_label.max_length" => 75, "feedback_button.text.max_length" => 75, "feedback_button.value.max_length" => 2000, "file_input.max_files.max" => 10, "file_input.max_files.min" => 1, "header.text.max_length" => 150, "icon_button.accessibility_label.max_length" => 75, "icon_button.value.max_length" => 2000, "icon_button.visible_to_user_ids.max_items" => 10, "image.alt_text.max_length" => 2000, "image.image_url.max_length" => 3000, "image.title.max_length" => 2000, "image_element.alt_text.max_length" => 2000, "image_element.image_url.max_length" => 3000, "input.hint.max_length" => 2000, "input.label.max_length" => 2000, "layout.items.max_items" => 3, "layout.items.min_items" => 1, "layout.label.max_length" => 150, "layout.label.min_length" => 1, "layout.rows.max_items" => 5, "layout.rows.min_items" => 1, "markdown.text.max_length" => 12000, "markdown.total_text.max_length" => 12000, "message.attachments.max_items" => 100, "message.blocks.max_items" => 50, "message.channel.min_length" => 1, "message.data_visualizations.max_items" => 2, "multi_select.max_selected_items.min" => 1, "number_input.placeholder.max_length" => 150, "option.description.max_length" => 75, "option.text.max_length" => 75, "option.url.max_length" => 3000, "option.value.max_length" => 150, "option_group.label.max_length" => 75, "option_group.options.max_items" => 100, "option_group.options.min_items" => 1, "overflow.options.max_items" => 5, "overflow.options.min_items" => 1, "plain_text_input.max_length.max" => 3000, "plain_text_input.max_length.min" => 1, "plain_text_input.min_length.max" => 3000, "plain_text_input.min_length.min" => 0, "plain_text_input.placeholder.max_length" => 150, "plan.tasks.max_items" => 50, "radio_buttons.options.max_items" => 10, "radio_buttons.options.min_items" => 1, "rich_text_input.max_lines.max" => 100, "rich_text_input.max_lines.min" => 1, "rich_text_input.min_lines.max" => 100, "rich_text_input.min_lines.min" => 1, "rich_text_input.placeholder.max_length" => 150, "rich_text_list.border.max" => 1, "rich_text_list.border.min" => 0, "rich_text_list.indent.max" => 8, "rich_text_list.indent.min" => 0, "rich_text_list.offset.min" => 0, "rich_text_preformatted.border.max" => 1, "rich_text_preformatted.border.min" => 0, "rich_text_quote.border.max" => 1, "rich_text_quote.border.min" => 0, "section.fields.item_max_length" => 2000, "section.fields.max_items" => 10, "section.text.max_length" => 3000, "select.min_query_length.min" => 0, "select.option_groups.max_items" => 100, "select.option_groups.min_items" => 1, "select.options.max_items" => 100, "select.options.min_items" => 1, "select.placeholder.max_length" => 150, "table.column_settings.max_items" => 20, "table.columns.max_items" => 20, "table.rows.max_items" => 100, "text.max_length" => 3000, "text.min_length" => 1, "time_picker.placeholder.max_length" => 150, "url_input.placeholder.max_length" => 150, "video.alt_text.max_length" => 2000, "video.author_name.max_length" => 50, "video.description.max_length" => 200, "video.provider_icon_url.max_length" => 2000, "video.provider_name.max_length" => 50, "video.thumbnail_url.max_length" => 3000, "video.title.max_length" => 200, "video.title_url.max_length" => 2000, "video.video_url.max_length" => 3000, "view.blocks.max_items" => 100, "view.callback_id.max_length" => 255, "view.close.max_length" => 24, "view.external_id.max_length" => 255, "view.private_metadata.max_length" => 3000, "view.submit.max_length" => 24, "view.title.max_length" => 24, "workflow_button.accessibility_label.max_length" => 75, "workflow_button.text.max_length" => 75}.freeze
     def self.[](path)
       VALUES.fetch(path)
     end

data/lib/slackblocks/generated/models.rb

@@ -33,6 +33,12 @@ module Slackblocks
   module RichTextSectionElement
   end
 
+  module LayoutChild
+  end
+
+  module LayoutFallback
+  end
+
   module AlertLevel
     DEFAULT = :default
     INFO = :info
@@ -80,9 +86,28 @@ module Slackblocks
     EPHEMERAL = :ephemeral
   end
 
+  module LayoutWidth
+    NARROW = :narrow
+    STANDARD = :standard
+    WIDE = :wide
+  end
+
+  module LayoutAlignment
+    START = :start
+    CENTER = :center
+    END_ = :end
+  end
+
+  module LayoutGridLines
+    NONE = :none
+    ROWS = :rows
+    OUTER = :outer
+  end
+
   class ActionsBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :elements, :block_id, :additional_fields
   end
   ActionsBlock.const_set(:WIRE_TYPE, "actions")
@@ -93,6 +118,7 @@ module Slackblocks
   class AlertBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :text, :level, :block_id, :additional_fields
   end
   AlertBlock.const_set(:WIRE_TYPE, "alert")
@@ -103,6 +129,7 @@ module Slackblocks
   class CardBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :hero_image, :icon, :title, :subtitle, :body, :actions, :slack_icon, :subtext, :block_id, :additional_fields
   end
   CardBlock.const_set(:WIRE_TYPE, "card")
@@ -113,6 +140,7 @@ module Slackblocks
   class CarouselBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :elements, :block_id, :additional_fields
   end
   CarouselBlock.const_set(:WIRE_TYPE, "carousel")
@@ -123,6 +151,7 @@ module Slackblocks
   class ContainerBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :child_blocks, :title, :rich_text_title, :subtitle, :width, :icon, :is_collapsible, :default_collapsed, :has_header_divider, :block_id, :additional_fields
   end
   ContainerBlock.const_set(:WIRE_TYPE, "container")
@@ -143,6 +172,8 @@ module Slackblocks
   class ContextBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader :elements, :block_id, :additional_fields
   end
   ContextBlock.const_set(:WIRE_TYPE, "context")
@@ -153,6 +184,7 @@ module Slackblocks
   class DataTableBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :rows, :caption, :page_size, :row_header_column_index, :block_id, :additional_fields
   end
   DataTableBlock.const_set(:WIRE_TYPE, "data_table")
@@ -163,6 +195,7 @@ module Slackblocks
   class DataVisualizationBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :title, :chart, :block_id, :additional_fields
   end
   DataVisualizationBlock.const_set(:WIRE_TYPE, "data_visualization")
@@ -173,6 +206,8 @@ module Slackblocks
   class DividerBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader :block_id, :additional_fields
   end
   DividerBlock.const_set(:WIRE_TYPE, "divider")
@@ -183,6 +218,7 @@ module Slackblocks
   class FileBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :external_id, :source, :block_id, :additional_fields
   end
   FileBlock.const_set(:WIRE_TYPE, "file")
@@ -193,6 +229,8 @@ module Slackblocks
   class HeaderBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader :text, :block_id, :additional_fields
   end
   HeaderBlock.const_set(:WIRE_TYPE, "header")
@@ -203,6 +241,8 @@ module Slackblocks
   class ImageBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader :image_url, :slack_file, :alt_text, :title, :block_id, :additional_fields
   end
   ImageBlock.const_set(:WIRE_TYPE, "image")
@@ -213,6 +253,7 @@ module Slackblocks
   class InputBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader :label, :element, :dispatch_action, :block_id, :hint, :optional, :additional_fields
   end
   InputBlock.const_set(:WIRE_TYPE, "input")
@@ -244,6 +285,8 @@ module Slackblocks
     include Value
     include Block
     include DataTableCell
+    include LayoutChild
+    include LayoutFallback
     include TableCell
     attr_reader :elements, :block_id, :additional_fields
   end
@@ -255,6 +298,8 @@ module Slackblocks
   class SectionBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader :text, :fields, :accessory, :block_id, :additional_fields
   end
   SectionBlock.const_set(:WIRE_TYPE, "section")
@@ -265,6 +310,8 @@ module Slackblocks
   class TableBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader :rows, :column_settings, :block_id, :additional_fields
   end
   TableBlock.const_set(:WIRE_TYPE, "table")
@@ -285,6 +332,8 @@ module Slackblocks
   class VideoBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader :alt_text, :thumbnail_url, :title, :video_url, :block_id, :author_name, :description, :provider_icon_url, :provider_name, :title_url, :additional_fields
   end
   VideoBlock.const_set(:WIRE_TYPE, "video")
@@ -976,4 +1025,32 @@ module Slackblocks
   WebhookMessage.const_set(:DEFAULTS, Value.deep_freeze({}))
   WebhookMessage.singleton_class.prepend(KeywordOnly)
 
+  class LayoutBlock
+    include Value
+    include Block
+    attr_reader :label, :rows, :is_label_visible, :grid_lines, :fallback, :block_id, :additional_fields
+  end
+  LayoutBlock.const_set(:WIRE_TYPE, "layout")
+  LayoutBlock.const_set(:FIELD_SPECS, Value.deep_freeze([{"name" => "label", "wire" => "label", "kind" => "string", "target" => nil, "coerce" => nil, "flags" => nil, "limits" => "layout.label", "required" => true}, {"name" => "rows", "wire" => "rows", "kind" => "list", "target" => "LayoutRow", "coerce" => nil, "flags" => nil, "limits" => "layout.rows", "required" => true}, {"name" => "is_label_visible", "wire" => "is_label_visible", "kind" => "boolean", "target" => nil, "coerce" => nil, "flags" => nil, "limits" => nil, "required" => false}, {"name" => "grid_lines", "wire" => "grid_lines", "kind" => "enum", "target" => "LayoutGridLines", "coerce" => nil, "flags" => nil, "limits" => nil, "required" => false}, {"name" => "fallback", "wire" => "fallback", "kind" => "list", "target" => "LayoutFallback", "coerce" => nil, "flags" => nil, "limits" => nil, "required" => false}, {"name" => "block_id", "wire" => "block_id", "kind" => "string", "target" => nil, "coerce" => nil, "flags" => nil, "limits" => "block_id", "required" => false}]))
+  LayoutBlock.const_set(:DEFAULTS, Value.deep_freeze({}))
+  LayoutBlock.singleton_class.prepend(KeywordOnly)
+
+  class LayoutRow
+    include Value
+    attr_reader :items, :additional_fields
+  end
+  LayoutRow.const_set(:WIRE_TYPE, "")
+  LayoutRow.const_set(:FIELD_SPECS, Value.deep_freeze([{"name" => "items", "wire" => "items", "kind" => "list", "target" => "LayoutItem", "coerce" => nil, "flags" => nil, "limits" => "layout.items", "required" => true}]))
+  LayoutRow.const_set(:DEFAULTS, Value.deep_freeze({}))
+  LayoutRow.singleton_class.prepend(KeywordOnly)
+
+  class LayoutItem
+    include Value
+    attr_reader :block, :width, :horizontal_alignment, :additional_fields
+  end
+  LayoutItem.const_set(:WIRE_TYPE, "")
+  LayoutItem.const_set(:FIELD_SPECS, Value.deep_freeze([{"name" => "block", "wire" => "block", "kind" => "object", "target" => "LayoutChild", "coerce" => nil, "flags" => nil, "limits" => nil, "required" => true}, {"name" => "width", "wire" => "width", "kind" => "enum", "target" => "LayoutWidth", "coerce" => nil, "flags" => nil, "limits" => nil, "required" => false}, {"name" => "horizontal_alignment", "wire" => "horizontal_alignment", "kind" => "enum", "target" => "LayoutAlignment", "coerce" => nil, "flags" => nil, "limits" => nil, "required" => false}]))
+  LayoutItem.const_set(:DEFAULTS, Value.deep_freeze({}))
+  LayoutItem.singleton_class.prepend(KeywordOnly)
+
 end

data/lib/slackblocks/generated/vocabulary.rb

@@ -2,6 +2,6 @@
 module Slackblocks
   module Vocabulary
     ICON_NAMES = Value.deep_freeze(["archive", "book", "bookmark", "bot", "bug", "calendar", "call", "caret-left", "caret-right", "check", "clipboard", "code", "comment", "compass", "copy", "cube", "download", "edit", "email", "eye-closed", "eye-open", "file", "flag", "folder", "gear", "globe", "heart", "help", "image", "info", "key", "lightbulb", "link", "map", "mobile", "new-window", "pin", "plus", "refine", "refresh", "rocket", "save", "screen", "share", "sparkle", "star", "star-filled", "tag", "thumbs-down", "thumbs-up", "trash", "upload", "user", "warning"])
-    SURFACE_BLOCK_TYPES = Value.deep_freeze({"home" => ["actions", "card", "carousel", "container", "context", "data_table", "data_visualization", "divider", "header", "image", "input", "rich_text", "section", "table", "video"], "message" => ["actions", "card", "carousel", "container", "context", "context_actions", "data_table", "data_visualization", "divider", "file", "header", "image", "input", "markdown", "plan", "rich_text", "section", "table", "task_card", "video"], "modal" => ["actions", "alert", "card", "context", "divider", "header", "image", "input", "rich_text", "section", "video"]})
+    SURFACE_BLOCK_TYPES = Value.deep_freeze({"home" => ["actions", "card", "carousel", "container", "context", "data_table", "data_visualization", "divider", "header", "image", "input", "layout", "rich_text", "section", "table", "video"], "message" => ["actions", "card", "carousel", "container", "context", "context_actions", "data_table", "data_visualization", "divider", "file", "header", "image", "input", "layout", "markdown", "plan", "rich_text", "section", "table", "task_card", "video"], "modal" => ["actions", "alert", "card", "context", "divider", "header", "image", "input", "layout", "rich_text", "section", "video"]})
   end
 end

data/lib/slackblocks/validator.rb

@@ -73,7 +73,23 @@ module Slackblocks
         if wire.key?("icon") && wire.key?("slack_icon")
           fail!("mutually-exclusive", path, "icon and slack_icon cannot both be present")
         end
+      when "LayoutBlock"
+        composite_depth(wire, path)
+      when "LayoutRow"
+        fail!("type-mismatch", path, "a row only supports items") unless (wire.keys - ["items"]).empty?
+        items = wire.fetch("items")
+        wide = items.count { |item| %w[carousel data_table data_visualization].include?(item.fetch("block")["type"]) }
+        fail!("invalid-usage", path, "at most one wide-content block per row") if wide > 1
+        total = items.sum { |item| layout_weight(item) }
+        items.each do |item|
+          if item.fetch("block")["type"] == "data_visualization" && layout_weight(item) * 2 <= total
+            fail!("invalid-usage", path, "a data visualization requires more than half the row weight")
+          end
+        end
+      when "LayoutItem"
+        fail!("type-mismatch", path, "unsupported layout item property") unless (wire.keys - %w[block width horizontal_alignment]).empty?
       when "ContainerBlock"
+        composite_depth(wire, path)
         unless wire.key?("title") || wire.key?("rich_text_title")
           fail!("missing-required", path, "expected title")
         end
@@ -147,7 +163,7 @@ module Slackblocks
         message(wire, path)
       when "ModalView", "HomeTabView"
         surface(wire.fetch("blocks"), (klass == ModalView) ? "modal" : "home", "#{path}.blocks")
-        if klass == ModalView && !wire.key?("submit") && wire.fetch("blocks").any? { |block| block["type"] == "input" }
+        if klass == ModalView && !wire.key?("submit") && descendants(wire.fetch("blocks")).any? { |block| block["type"] == "input" }
           fail!("missing-required", "#{path}.submit", "required when modal contains an input")
         end
       end
@@ -179,12 +195,40 @@ module Slackblocks
       left[0] * (rank.zero? ? left[2].ljust(width, "0") <=> right[2].ljust(width, "0") : rank)
     end
 
+    def self.layout_weight(item)
+      {"narrow" => 1, "wide" => 3}.fetch(item["width"], 2)
+    end
+
+    def self.composite_children(block, fallback: true)
+      empty = [] # : Array[Hash[String, untyped]]
+      case block["type"]
+      when "container" then block.fetch("child_blocks")
+      when "layout"
+        block.fetch("rows").flat_map { |row| row.fetch("items").map { |item| item.fetch("block") } } + (fallback ? block.fetch("fallback", empty) : empty)
+      else []
+      end
+    end
+
+    def self.composite_depth(block, path, depth = 0, has_layout = false)
+      has_layout ||= block["type"] == "layout"
+      depth += 1 if %w[layout container].include?(block["type"])
+      fail!("invalid-usage", path, "layout/container nesting exceeds two composite levels") if has_layout && depth > 2
+      composite_children(block, fallback: false).each { |child| composite_depth(child, path, depth, has_layout) }
+    end
+
+    def self.descendants(blocks)
+      blocks.flat_map { |block| [block] + descendants(composite_children(block)) }
+    end
+
     def self.surface(blocks, name, path)
+      empty = [] # : Array[Hash[String, untyped]]
       allowed = Vocabulary::SURFACE_BLOCK_TYPES.fetch(name)
       blocks.each_with_index do |block, index|
         type = block["type"]
         fail!("type-mismatch", "#{path}[#{index}].type", "unsupported #{name} block") unless allowed.include?(type)
         standalone_task(block, "#{path}[#{index}]")
+        surface(composite_children(block, fallback: false), name, "#{path}[#{index}].children")
+        surface(block.fetch("fallback", empty), name, "#{path}[#{index}].fallback") if type == "layout"
       end
     end
 
@@ -227,8 +271,8 @@ module Slackblocks
           totals["data_visualization"] += 1
         elsif node["type"] == "data_table"
           totals["data_table"] += characters(node.fetch("rows"))
-        elsif node["type"] == "container"
-          tally(node["child_blocks"], totals)
+        elsif %w[container layout].include?(node["type"])
+          tally(composite_children(node), totals)
         end
       when Array
         node.each { |child| tally(child, totals) }

data/lib/slackblocks/version.rb

@@ -1,4 +1,4 @@
 module Slackblocks
-  VERSION = "3.1.0"
-  SPEC_VERSION = "1.4.0"
+  VERSION = "3.2.0"
+  SPEC_VERSION = "1.5.0"
 end

data/sig/slackblocks/generated.rbs

@@ -33,6 +33,12 @@ module Slackblocks
   module RichTextSectionElement
   end
 
+  module LayoutChild
+  end
+
+  module LayoutFallback
+  end
+
   module AlertLevel
     DEFAULT: :default
     INFO: :info
@@ -80,9 +86,28 @@ module Slackblocks
     EPHEMERAL: :ephemeral
   end
 
+  module LayoutWidth
+    NARROW: :narrow
+    STANDARD: :standard
+    WIDE: :wide
+  end
+
+  module LayoutAlignment
+    START: :start
+    CENTER: :center
+    END_: :end
+  end
+
+  module LayoutGridLines
+    NONE: :none
+    ROWS: :rows
+    OUTER: :outer
+  end
+
   class ActionsBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader elements: Array[Element]
     attr_reader block_id: (String)?
     attr_reader additional_fields: Hash[String, untyped]
@@ -94,6 +119,7 @@ module Slackblocks
   class AlertBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader text: Text
     attr_reader level: (:default | :info | :warning | :error | :success)?
     attr_reader block_id: (String)?
@@ -106,6 +132,7 @@ module Slackblocks
   class CardBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader hero_image: (ImageElement)?
     attr_reader icon: (ImageElement)?
     attr_reader title: (Text)?
@@ -124,6 +151,7 @@ module Slackblocks
   class CarouselBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader elements: Array[CardBlock]
     attr_reader block_id: (String)?
     attr_reader additional_fields: Hash[String, untyped]
@@ -135,6 +163,7 @@ module Slackblocks
   class ContainerBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader child_blocks: Array[Block]
     attr_reader title: (PlainText)?
     attr_reader rich_text_title: (RichTextBlock)?
@@ -165,6 +194,8 @@ module Slackblocks
   class ContextBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader elements: Array[ContextElement]
     attr_reader block_id: (String)?
     attr_reader additional_fields: Hash[String, untyped]
@@ -176,6 +207,7 @@ module Slackblocks
   class DataTableBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader rows: Array[Array[DataTableCell]]
     attr_reader caption: String
     attr_reader page_size: (Integer)?
@@ -190,6 +222,7 @@ module Slackblocks
   class DataVisualizationBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader title: String
     attr_reader chart: Chart
     attr_reader block_id: (String)?
@@ -202,6 +235,8 @@ module Slackblocks
   class DividerBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader block_id: (String)?
     attr_reader additional_fields: Hash[String, untyped]
     def initialize: (?block_id: (String)?, ?additional_fields: Hash[String | Symbol, untyped]?) -> void
@@ -212,6 +247,7 @@ module Slackblocks
   class FileBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader external_id: String
     attr_reader source: (String)?
     attr_reader block_id: (String)?
@@ -224,6 +260,8 @@ module Slackblocks
   class HeaderBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader text: PlainText
     attr_reader block_id: (String)?
     attr_reader additional_fields: Hash[String, untyped]
@@ -235,6 +273,8 @@ module Slackblocks
   class ImageBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader image_url: (String)?
     attr_reader slack_file: (SlackFile)?
     attr_reader alt_text: String
@@ -249,6 +289,7 @@ module Slackblocks
   class InputBlock
     include Value
     include Block
+    include LayoutChild
     attr_reader label: PlainText
     attr_reader element: InputElement
     attr_reader dispatch_action: (bool)?
@@ -288,6 +329,8 @@ module Slackblocks
     include Value
     include Block
     include DataTableCell
+    include LayoutChild
+    include LayoutFallback
     include TableCell
     attr_reader elements: Array[RichTextBlockElement]
     attr_reader block_id: (String)?
@@ -300,6 +343,8 @@ module Slackblocks
   class SectionBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader text: (Text)?
     attr_reader fields: (Array[Text])?
     attr_reader accessory: (Element)?
@@ -313,6 +358,8 @@ module Slackblocks
   class TableBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader rows: Array[Array[TableCell]]
     attr_reader column_settings: (Array[ColumnSettings])?
     attr_reader block_id: (String)?
@@ -341,6 +388,8 @@ module Slackblocks
   class VideoBlock
     include Value
     include Block
+    include LayoutChild
+    include LayoutFallback
     attr_reader alt_text: String
     attr_reader thumbnail_url: String
     attr_reader title: PlainText
@@ -1249,6 +1298,41 @@ module Slackblocks
     def self.[]: (?blocks: (Array[Block])?, ?attachments: (Array[Attachment])?, ?text: (String)?, ?response_type: (:in_channel | :ephemeral)?, ?replace_original: (bool)?, ?delete_original: (bool)?, ?unfurl_links: (bool)?, ?unfurl_media: (bool)?, ?metadata: (Hash[String | Symbol, untyped])?, ?additional_fields: Hash[String | Symbol, untyped]?) -> WebhookMessage
   end
 
+  class LayoutBlock
+    include Value
+    include Block
+    attr_reader label: String
+    attr_reader rows: Array[LayoutRow]
+    attr_reader is_label_visible: (bool)?
+    attr_reader grid_lines: (:none | :rows | :outer)?
+    attr_reader fallback: (Array[LayoutFallback])?
+    attr_reader block_id: (String)?
+    attr_reader additional_fields: Hash[String, untyped]
+    def initialize: (label: String, rows: Array[LayoutRow], ?is_label_visible: (bool)?, ?grid_lines: (:none | :rows | :outer)?, ?fallback: (Array[LayoutFallback])?, ?block_id: (String)?, ?additional_fields: Hash[String | Symbol, untyped]?) -> void
+    def self.new: (label: String, rows: Array[LayoutRow], ?is_label_visible: (bool)?, ?grid_lines: (:none | :rows | :outer)?, ?fallback: (Array[LayoutFallback])?, ?block_id: (String)?, ?additional_fields: Hash[String | Symbol, untyped]?) -> LayoutBlock
+    def self.[]: (label: String, rows: Array[LayoutRow], ?is_label_visible: (bool)?, ?grid_lines: (:none | :rows | :outer)?, ?fallback: (Array[LayoutFallback])?, ?block_id: (String)?, ?additional_fields: Hash[String | Symbol, untyped]?) -> LayoutBlock
+  end
+
+  class LayoutRow
+    include Value
+    attr_reader items: Array[LayoutItem]
+    attr_reader additional_fields: Hash[String, untyped]
+    def initialize: (items: Array[LayoutItem], ?additional_fields: Hash[String | Symbol, untyped]?) -> void
+    def self.new: (items: Array[LayoutItem], ?additional_fields: Hash[String | Symbol, untyped]?) -> LayoutRow
+    def self.[]: (items: Array[LayoutItem], ?additional_fields: Hash[String | Symbol, untyped]?) -> LayoutRow
+  end
+
+  class LayoutItem
+    include Value
+    attr_reader block: LayoutChild
+    attr_reader width: (:narrow | :standard | :wide)?
+    attr_reader horizontal_alignment: (:start | :center | :end)?
+    attr_reader additional_fields: Hash[String, untyped]
+    def initialize: (block: LayoutChild, ?width: (:narrow | :standard | :wide)?, ?horizontal_alignment: (:start | :center | :end)?, ?additional_fields: Hash[String | Symbol, untyped]?) -> void
+    def self.new: (block: LayoutChild, ?width: (:narrow | :standard | :wide)?, ?horizontal_alignment: (:start | :center | :end)?, ?additional_fields: Hash[String | Symbol, untyped]?) -> LayoutItem
+    def self.[]: (block: LayoutChild, ?width: (:narrow | :standard | :wide)?, ?horizontal_alignment: (:start | :center | :end)?, ?additional_fields: Hash[String | Symbol, untyped]?) -> LayoutItem
+  end
+
   module StyleFlags
     NAMES: Array[String]
   end

data/sig/slackblocks.rbs

@@ -38,6 +38,10 @@ module Slackblocks
   end
 
   module Validator
+    def self.layout_weight: (Hash[String, untyped] item) -> Integer
+    def self.composite_children: (Hash[String, untyped] block, ?fallback: bool) -> Array[Hash[String, untyped]]
+    def self.composite_depth: (Hash[String, untyped] block, String path, ?Integer depth, ?bool has_layout) -> untyped
+    def self.descendants: (Array[Hash[String, untyped]] blocks) -> Array[Hash[String, untyped]]
     def self.validate: (untyped klass, Hash[Symbol, untyped] values) -> untyped
     def self.limit: (String key) -> Integer
     def self.fail!: (String category, String path, String message) -> bot

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: slackblocks
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.2.0
 platform: ruby
 authors:
 - Nicholas Lambourne