slackblocks 3.0.0__tar.gz → 3.2.0__tar.gz

{slackblocks-3.0.0 → slackblocks-3.2.0}/.gitignore

@@ -136,3 +136,8 @@ docs/docs/reference/php/
 !/elixir/integrations/lib/**
 
 /docs/docs/reference/elixir/
+
+/docs/docs/reference/haskell/
+
+# Prepared Hackage source/docs assets are CI artifacts.
+haskell/dist-release/

{slackblocks-3.0.0 → slackblocks-3.2.0}/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to `slackblocks` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [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.
+- Preserve real nested layout/container/fallback locations in surface-validation errors. `Block.from_dict` recognizes layout and raises the documented `NotImplementedError` for unsupported nested parsing.
+
+## [3.1.0] — 2026-10-28
+
+- Coordinate this release with the new Haskell implementation and ten-language documentation. Existing runtime support remains unchanged.
+
 ## [3.0.0] — 2026-10-24
 
 - Add native button `agent_prompt` and `agent_prompt_display` fields, Unicode prompt-length validation and the display/prompt dependency (spec 1.4.0). Document interaction acknowledgement regardless of Slackbot AI availability. Existing button calls remain compatible.

{slackblocks-3.0.0 → slackblocks-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: slackblocks
-Version: 3.0.0
+Version: 3.2.0
 Summary: Python wrapper for the Slack Blocks API
 Project-URL: Homepage, https://github.com/nicklambourne/slackblocks
 Project-URL: Repository, https://github.com/nicklambourne/slackblocks
@@ -113,14 +113,14 @@ The `**` operator unpacks `slackblocks` `Message` objects directly into the SDK
 
 | Surface             | Status |
 |---------------------|:------:|
-| Blocks              | ✅ All current block types, including Alert, Card, Carousel, Container, Context Actions, Data Table, Data Visualization, Plan, and Task Card |
+| Blocks              | ✅ All current block types, including Alert, Card, Carousel, Container, Layout (3.2.0+), Context Actions, Data Table, Data Visualization, Plan, and Task Card |
 | Elements            | ✅ Buttons, all select menus, date/time pickers, checkboxes, radio groups, all input types, overflow menus, workflow buttons |
 | Composition Objects | ✅ Text (+ `PlainText` / `Markdown` aliases), Option, Confirm, Conversation/Dispatch filters, Workflow, Trigger |
 | Rich Text           | ✅ Sections, lists, quotes, code blocks, inline links/users/channels/emoji |
 | Modals & Home Tabs  | ✅ Full views API |
 | Messages            | ✅ `chat.postMessage`, webhook messages, slash-command/interaction responses, threaded replies, ephemeral messages |
 | Attachments         | ⚠️ Supported but [deprecated by Slack](https://api.slack.com/reference/messaging/attachments) |
-| Round-tripping      | ✅ `Block.from_dict(data)` and per-class `from_dict` for parsing incoming Slack JSON back into objects |
+| Round-tripping      | ⚠️ Partial `Block.from_dict(data)` parsing; composite blocks including Layout raise `NotImplementedError`. See the [support table](https://nicklambourne.github.io/slackblocks/usage/migration#round-tripping-incoming-slack-json-with-from_dict) |
 
 ## What's new in 2.0
 
@@ -130,7 +130,7 @@ The `**` operator unpacks `slackblocks` `Message` objects directly into the SDK
 - **`PlainText` and `Markdown`** thin aliases for `Text(type_=...)`.
 - **`block_kit_builder_url(payload)`** — turn any block, message, or view into a [Block Kit Builder](https://app.slack.com/block-kit-builder) URL for browser preview.
 - **`Workflow.from_url(url, **params)`** — one-line workflow construction.
-- **`Block.from_dict(data)`** + per-class `from_dict` parsers — round-trip incoming Slack JSON back into `slackblocks` objects.
+- **`Block.from_dict(data)`** + per-class `from_dict` parsers — parse the supported subset of incoming Slack JSON into `slackblocks` objects.
 - **Typed exception subclasses** of `InvalidUsageError` (`LengthError`, `RangeError`, `TypeMismatchError`, `MutualExclusivityError`, `MissingRequiredError`) — existing `except InvalidUsageError` blocks continue to work.
 - **Tighter type signatures**: `Literal` narrowing on `Button.style`, `ColumnSettings.align`, `ConversationFilter.include`; `@overload` on `Text.to_text` so the return type narrows on `allow_none`.
 - **Modern annotation syntax** (`list[X]`, `X | Y`) throughout.
@@ -144,7 +144,7 @@ Existing 1.x code continues to work unchanged; see the [Migration Guide](https:/
 - [Compatibility](https://nicklambourne.github.io/slackblocks/usage/compatibility) — which Python versions each release line supports.
 - [Using Blocks](https://nicklambourne.github.io/slackblocks/usage/using_blocks) — every block type with code, JSON, and screenshots.
 - [Sending Messages](https://nicklambourne.github.io/slackblocks/usage/sending_messages)
-- [Cookbook](https://nicklambourne.github.io/slackblocks/usage/cookbook) — end-to-end recipes for build notifications, approval requests, modals, and more.
+- [Cookbook](https://nicklambourne.github.io/slackblocks/usage/recipes) — end-to-end recipes for build notifications, approval requests, modals, and more.
 - [Migrating from 1.x](https://nicklambourne.github.io/slackblocks/usage/migration) — upgrade guide for `1.x` users.
 - [Troubleshooting & FAQ](https://nicklambourne.github.io/slackblocks/usage/troubleshooting)
 - [Changelog](https://github.com/nicklambourne/slackblocks/blob/master/python/CHANGELOG.md)

{slackblocks-3.0.0 → slackblocks-3.2.0}/README.md

@@ -86,14 +86,14 @@ The `**` operator unpacks `slackblocks` `Message` objects directly into the SDK
 
 | Surface             | Status |
 |---------------------|:------:|
-| Blocks              | ✅ All current block types, including Alert, Card, Carousel, Container, Context Actions, Data Table, Data Visualization, Plan, and Task Card |
+| Blocks              | ✅ All current block types, including Alert, Card, Carousel, Container, Layout (3.2.0+), Context Actions, Data Table, Data Visualization, Plan, and Task Card |
 | Elements            | ✅ Buttons, all select menus, date/time pickers, checkboxes, radio groups, all input types, overflow menus, workflow buttons |
 | Composition Objects | ✅ Text (+ `PlainText` / `Markdown` aliases), Option, Confirm, Conversation/Dispatch filters, Workflow, Trigger |
 | Rich Text           | ✅ Sections, lists, quotes, code blocks, inline links/users/channels/emoji |
 | Modals & Home Tabs  | ✅ Full views API |
 | Messages            | ✅ `chat.postMessage`, webhook messages, slash-command/interaction responses, threaded replies, ephemeral messages |
 | Attachments         | ⚠️ Supported but [deprecated by Slack](https://api.slack.com/reference/messaging/attachments) |
-| Round-tripping      | ✅ `Block.from_dict(data)` and per-class `from_dict` for parsing incoming Slack JSON back into objects |
+| Round-tripping      | ⚠️ Partial `Block.from_dict(data)` parsing; composite blocks including Layout raise `NotImplementedError`. See the [support table](https://nicklambourne.github.io/slackblocks/usage/migration#round-tripping-incoming-slack-json-with-from_dict) |
 
 ## What's new in 2.0
 
@@ -103,7 +103,7 @@ The `**` operator unpacks `slackblocks` `Message` objects directly into the SDK
 - **`PlainText` and `Markdown`** thin aliases for `Text(type_=...)`.
 - **`block_kit_builder_url(payload)`** — turn any block, message, or view into a [Block Kit Builder](https://app.slack.com/block-kit-builder) URL for browser preview.
 - **`Workflow.from_url(url, **params)`** — one-line workflow construction.
-- **`Block.from_dict(data)`** + per-class `from_dict` parsers — round-trip incoming Slack JSON back into `slackblocks` objects.
+- **`Block.from_dict(data)`** + per-class `from_dict` parsers — parse the supported subset of incoming Slack JSON into `slackblocks` objects.
 - **Typed exception subclasses** of `InvalidUsageError` (`LengthError`, `RangeError`, `TypeMismatchError`, `MutualExclusivityError`, `MissingRequiredError`) — existing `except InvalidUsageError` blocks continue to work.
 - **Tighter type signatures**: `Literal` narrowing on `Button.style`, `ColumnSettings.align`, `ConversationFilter.include`; `@overload` on `Text.to_text` so the return type narrows on `allow_none`.
 - **Modern annotation syntax** (`list[X]`, `X | Y`) throughout.
@@ -117,7 +117,7 @@ Existing 1.x code continues to work unchanged; see the [Migration Guide](https:/
 - [Compatibility](https://nicklambourne.github.io/slackblocks/usage/compatibility) — which Python versions each release line supports.
 - [Using Blocks](https://nicklambourne.github.io/slackblocks/usage/using_blocks) — every block type with code, JSON, and screenshots.
 - [Sending Messages](https://nicklambourne.github.io/slackblocks/usage/sending_messages)
-- [Cookbook](https://nicklambourne.github.io/slackblocks/usage/cookbook) — end-to-end recipes for build notifications, approval requests, modals, and more.
+- [Cookbook](https://nicklambourne.github.io/slackblocks/usage/recipes) — end-to-end recipes for build notifications, approval requests, modals, and more.
 - [Migrating from 1.x](https://nicklambourne.github.io/slackblocks/usage/migration) — upgrade guide for `1.x` users.
 - [Troubleshooting & FAQ](https://nicklambourne.github.io/slackblocks/usage/troubleshooting)
 - [Changelog](https://github.com/nicklambourne/slackblocks/blob/master/python/CHANGELOG.md)

{slackblocks-3.0.0 → slackblocks-3.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "slackblocks"
-version = "3.0.0"
+version = "3.2.0"
 description = "Python wrapper for the Slack Blocks API"
 authors = [
     { name = "Nicholas Lambourne", email = "dev@ndl.im" },

{slackblocks-3.0.0 → slackblocks-3.2.0}/slackblocks/__init__.py

@@ -19,6 +19,14 @@ from .blocks import (
     HeaderBlock,
     ImageBlock,
     InputBlock,
+    LayoutAlignment,
+    LayoutBlock,
+    LayoutChild,
+    LayoutFallback,
+    LayoutGridLines,
+    LayoutItem,
+    LayoutRow,
+    LayoutWidth,
     MarkdownBlock,
     PlanBlock,
     RichTextBlock,
@@ -123,7 +131,7 @@ name = "slackblocks"
 
 # The version of the shared conformance spec (spec/SPEC.md) this
 # implementation conforms to.
-SPEC_VERSION: str = "1.4.0"
+SPEC_VERSION: str = "1.5.0"
 
 # Literal exports are visible to strict external type checkers.
 __all__ = [
@@ -182,6 +190,14 @@ __all__ = [
     "LengthError",
     "LineChart",
     "Markdown",
+    "LayoutBlock",
+    "LayoutRow",
+    "LayoutItem",
+    "LayoutWidth",
+    "LayoutAlignment",
+    "LayoutGridLines",
+    "LayoutChild",
+    "LayoutFallback",
     "MarkdownBlock",
     "Message",
     "MessageResponse",

slackblocks-3.2.0/slackblocks/_layout.py

@@ -0,0 +1,56 @@
+"""Modeled composite-block traversal. Opaque payload metadata is never visited."""
+
+from typing import Any
+
+from .errors import InvalidUsageError
+
+
+def child_blocks(block: dict[str, Any]) -> list[dict[str, Any]]:
+    if block.get("type") == "container":
+        return block.get("child_blocks", [])
+    if block.get("type") == "layout":
+        return [item["block"] for row in block.get("rows", []) for item in row["items"]]
+    return []
+
+
+def validate_composite_depth(
+    block: dict[str, Any], depth: int = 0, has_layout: bool = False
+) -> None:
+    kind = block.get("type")
+    has_layout = has_layout or kind == "layout"
+    if kind in ("layout", "container"):
+        depth += 1
+    if has_layout and depth > 2:
+        raise InvalidUsageError("Layout and container nesting cannot exceed two composite levels.")
+    for nested in child_blocks(block):
+        validate_composite_depth(nested, depth, has_layout)
+
+
+def descendants_with_paths(
+    blocks: list[dict[str, Any]], path: str = "blocks"
+) -> list[tuple[str, dict[str, Any]]]:
+    """Walk modeled children and fallback while retaining their wire locations."""
+    result = []
+
+    def visit(block: dict[str, Any], block_path: str) -> None:
+        result.append((block_path, block))
+        if block.get("type") == "container":
+            for index, nested in enumerate(block.get("child_blocks", [])):
+                visit(nested, f"{block_path}.child_blocks[{index}]")
+        elif block.get("type") == "layout":
+            for row_index, row in enumerate(block.get("rows", [])):
+                for item_index, item in enumerate(row["items"]):
+                    visit(
+                        item["block"], f"{block_path}.rows[{row_index}].items[{item_index}].block"
+                    )
+            for index, nested in enumerate(block.get("fallback", [])):
+                visit(nested, f"{block_path}.fallback[{index}]")
+
+    for index, block in enumerate(blocks):
+        visit(block, f"{path}[{index}]")
+    return result
+
+
+def descendants(blocks: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    """Walk actual children and fallback content, without interpreting application data."""
+    return [block for _, block in descendants_with_paths(blocks)]

{slackblocks-3.0.0 → slackblocks-3.2.0}/slackblocks/_limits.py

@@ -295,3 +295,15 @@ VIEW_TITLE_MAX_LENGTH = 24
 VIEW_CLOSE_MAX_LENGTH = 24
 # view.submit.max_length
 VIEW_SUBMIT_MAX_LENGTH = 24
+# layout.label.min_length
+LAYOUT_LABEL_MIN_LENGTH = 1
+# layout.label.max_length
+LAYOUT_LABEL_MAX_LENGTH = 150
+# layout.rows.min_items
+LAYOUT_ROWS_MIN_ITEMS = 1
+# layout.rows.max_items
+LAYOUT_ROWS_MAX_ITEMS = 5
+# layout.items.min_items
+LAYOUT_ITEMS_MIN_ITEMS = 1
+# layout.items.max_items
+LAYOUT_ITEMS_MAX_ITEMS = 3

{slackblocks-3.0.0 → slackblocks-3.2.0}/slackblocks/_surfaces.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from typing import Any, Literal
 
 from ._core import resolve
+from ._layout import descendants_with_paths
 from .errors import TypeMismatchError
 
 BlockSurface = Literal["home", "message", "modal"]
@@ -25,6 +26,7 @@ _BLOCK_TYPES_BY_SURFACE: dict[BlockSurface, frozenset[str]] = {
             "header",
             "image",
             "input",
+            "layout",
             "markdown",
             "plan",
             "rich_text",
@@ -44,6 +46,7 @@ _BLOCK_TYPES_BY_SURFACE: dict[BlockSurface, frozenset[str]] = {
             "header",
             "image",
             "input",
+            "layout",
             "rich_text",
             "section",
             "video",
@@ -62,6 +65,7 @@ _BLOCK_TYPES_BY_SURFACE: dict[BlockSurface, frozenset[str]] = {
             "header",
             "image",
             "input",
+            "layout",
             "rich_text",
             "section",
             "table",
@@ -83,12 +87,10 @@ def block_type(block: Any) -> str | None:
 def validate_surface_blocks(blocks: list[Any], surface: BlockSurface) -> None:
     """Reject block types that Slack does not support on ``surface``."""
     allowed = _BLOCK_TYPES_BY_SURFACE[surface]
-    for index, block in enumerate(blocks):
+    for path, block in descendants_with_paths([resolve(block) for block in blocks]):
         type_ = block_type(block)
         if type_ not in allowed:
-            raise TypeMismatchError(
-                f"blocks[{index}] type {type_!r} is not supported on {surface} surfaces"
-            )
+            raise TypeMismatchError(f"{path} type {type_!r} is not supported on {surface} surfaces")
     validate_standalone_task_cards(blocks)
 
 

{slackblocks-3.0.0 → slackblocks-3.2.0}/slackblocks/blocks.py

@@ -46,6 +46,12 @@ from slackblocks._limits import (
     IMAGE_TITLE_MAX_LENGTH,
     INPUT_HINT_MAX_LENGTH,
     INPUT_LABEL_MAX_LENGTH,
+    LAYOUT_ITEMS_MAX_ITEMS,
+    LAYOUT_ITEMS_MIN_ITEMS,
+    LAYOUT_LABEL_MAX_LENGTH,
+    LAYOUT_LABEL_MIN_LENGTH,
+    LAYOUT_ROWS_MAX_ITEMS,
+    LAYOUT_ROWS_MIN_ITEMS,
     MARKDOWN_TEXT_MAX_LENGTH,
     PLAN_TASKS_MAX_ITEMS,
     SECTION_FIELDS_ITEM_MAX_LENGTH,
@@ -184,6 +190,7 @@ class BlockType(Enum):
     HEADER = "header"
     IMAGE = "image"
     INPUT = "input"
+    LAYOUT = "layout"
     MARKDOWN = "markdown"
     PLAN = "plan"
     RICH_TEXT = "rich_text"
@@ -238,7 +245,7 @@ class Block(RenderableMixin, ABC):
                 containing nested elements, cards, tasks, charts, or
                 rich text -- ``ActionsBlock``, ``InputBlock``,
                 ``TableBlock``, ``CardBlock``, ``CarouselBlock``,
-                ``ContainerBlock``, ``ContextActionsBlock``,
+                ``ContainerBlock``, ``LayoutBlock``, ``ContextActionsBlock``,
                 ``DataTableBlock``, ``DataVisualizationBlock``,
                 ``TaskCardBlock``, and ``PlanBlock`` -- see Phase 7.4b
                 and 7.4c).
@@ -279,6 +286,7 @@ def _block_from_dict_registry() -> dict[str, Any]:
         BlockType.HEADER.value: HeaderBlock.from_dict,
         BlockType.IMAGE.value: ImageBlock.from_dict,
         BlockType.INPUT.value: InputBlock.from_dict,
+        BlockType.LAYOUT.value: LayoutBlock.from_dict,
         BlockType.MARKDOWN.value: MarkdownBlock.from_dict,
         BlockType.PLAN.value: PlanBlock.from_dict,
         BlockType.RICH_TEXT.value: RichTextBlock.from_dict,
@@ -1204,7 +1212,7 @@ class ContainerBlock(Block):
         child_blocks: a list of between 1 and 10 blocks to display inside
             the container. Supported child block types are actions, context,
             divider, file, header, image, input, rich text, section, table,
-            and video blocks.
+            layout, and video blocks.
         title: the container's title (plaintext only; max 150 chars).
         rich_text_title: a `RichTextBlock` used as the container's title in
             place of `title`.
@@ -1233,6 +1241,7 @@ class ContainerBlock(Block):
         BlockType.HEADER,
         BlockType.IMAGE,
         BlockType.INPUT,
+        BlockType.LAYOUT,
         BlockType.RICH_TEXT,
         BlockType.SECTION,
         BlockType.TABLE,
@@ -1285,6 +1294,9 @@ class ContainerBlock(Block):
         self.is_collapsible = is_collapsible
         self.default_collapsed = default_collapsed
         self.has_header_divider = has_header_divider
+        from ._layout import validate_composite_depth
+
+        validate_composite_depth(self._resolve())
 
     def _resolve(self) -> dict[str, Any]:
         return resolve(
@@ -1601,3 +1613,194 @@ class PlanBlock(Block):
         raise NotImplementedError(
             "PlanBlock.from_dict requires nested task parsing, which is not implemented."
         )
+
+
+LayoutWidth: TypeAlias = Literal["narrow", "standard", "wide"]
+LayoutAlignment: TypeAlias = Literal["start", "center", "end"]
+LayoutGridLines: TypeAlias = Literal["none", "rows", "outer"]
+LayoutChild: TypeAlias = (
+    ActionsBlock
+    | AlertBlock
+    | CardBlock
+    | CarouselBlock
+    | ContainerBlock
+    | ContextBlock
+    | DataTableBlock
+    | DataVisualizationBlock
+    | DividerBlock
+    | FileBlock
+    | HeaderBlock
+    | ImageBlock
+    | InputBlock
+    | RichTextBlock
+    | SectionBlock
+    | TableBlock
+    | VideoBlock
+)
+LayoutFallback: TypeAlias = (
+    ContextBlock
+    | DividerBlock
+    | HeaderBlock
+    | ImageBlock
+    | RichTextBlock
+    | SectionBlock
+    | TableBlock
+    | VideoBlock
+)
+
+
+class LayoutItem(RenderableMixin):
+    """One layout cell containing a supported block.
+
+    Widths are relative weights: narrow 1, standard 2, wide 3. Alignment is
+    direction-aware; omit it for fill behavior. The child must also be allowed
+    on the enclosing message, modal, or Home surface.
+
+    See: <https://docs.slack.dev/reference/block-kit/blocks/layout-block>.
+    """
+
+    _CHILD_TYPES = frozenset(
+        {
+            "actions",
+            "alert",
+            "card",
+            "carousel",
+            "container",
+            "context",
+            "data_table",
+            "data_visualization",
+            "divider",
+            "file",
+            "header",
+            "image",
+            "input",
+            "rich_text",
+            "section",
+            "table",
+            "video",
+        }
+    )
+
+    def __init__(
+        self,
+        block: LayoutChild,
+        width: LayoutWidth | None = None,
+        horizontal_alignment: LayoutAlignment | None = None,
+    ) -> None:
+        self.block = validate_type(block, Block, "block")
+        if self.block.type.value not in self._CHILD_TYPES:
+            raise TypeMismatchError("Unsupported layout child block.")
+        if width not in (None, "narrow", "standard", "wide"):
+            raise TypeMismatchError("Unknown layout item width.")
+        if horizontal_alignment not in (None, "start", "center", "end"):
+            raise TypeMismatchError("Unknown layout item alignment.")
+        self.width = width
+        self.horizontal_alignment = horizontal_alignment
+
+    def _resolve(self) -> dict[str, Any]:
+        return resolve(
+            {
+                "block": self.block,
+                "width": self.width,
+                "horizontal_alignment": self.horizontal_alignment,
+            }
+        )
+
+
+class LayoutRow(RenderableMixin):
+    """One to three items in source order, with at most one wide-content block.
+
+    A carousel, data table, or data visualization cannot share a row with
+    another such block. A data visualization requires more than half the total
+    row weight. Alignment belongs to each item, never to the row itself.
+    """
+
+    def __init__(self, items: list[LayoutItem]) -> None:
+        self.items: list[LayoutItem] = coerce_to_list_nonnull(
+            items, LayoutItem, min_size=LAYOUT_ITEMS_MIN_ITEMS, max_size=LAYOUT_ITEMS_MAX_ITEMS
+        )
+        wide = [
+            item
+            for item in self.items
+            if item.block.type
+            in (BlockType.CAROUSEL, BlockType.DATA_TABLE, BlockType.DATA_VISUALIZATION)
+        ]
+        if len(wide) > 1:
+            raise InvalidUsageError("A layout row permits at most one wide-content block.")
+        weights = {None: 2, "narrow": 1, "standard": 2, "wide": 3}
+        total = sum(weights[item.width] for item in self.items)
+        for item in self.items:
+            if item.block.type == BlockType.DATA_VISUALIZATION and weights[item.width] * 2 <= total:
+                raise InvalidUsageError(
+                    "A data visualization requires more than half the row width."
+                )
+
+    def _resolve(self) -> dict[str, Any]:
+        return resolve({"items": self.items})
+
+
+class LayoutBlock(Block):
+    """A visual grid of one to five rows on messages, modals, and App Home.
+
+    The label is required (1–150 Unicode characters). Slack hides it by default;
+    a visible label is bold text without heading semantics. Rows retain source
+    order when wrapping, and stack on mobile. Supply stable fallback blocks for
+    older clients: Slack never synthesizes them. Omitted optional fields remain
+    omitted on input; Slack normalizes an omitted fallback to an empty array.
+
+    See: <https://docs.slack.dev/reference/block-kit/blocks/layout-block>.
+    """
+
+    _FALLBACK_TYPES = frozenset(
+        {"context", "divider", "header", "image", "rich_text", "section", "table", "video"}
+    )
+
+    def __init__(
+        self,
+        label: str,
+        rows: list[LayoutRow],
+        *,
+        is_label_visible: bool | None = None,
+        grid_lines: LayoutGridLines | None = None,
+        fallback: list[LayoutFallback] | None = None,
+        block_id: str | None = None,
+    ) -> None:
+        super().__init__(BlockType.LAYOUT, block_id)
+        self.label = validate_string_nonnull(
+            label, "label", min_length=LAYOUT_LABEL_MIN_LENGTH, max_length=LAYOUT_LABEL_MAX_LENGTH
+        )
+        self.rows: list[LayoutRow] = coerce_to_list_nonnull(
+            rows, LayoutRow, min_size=LAYOUT_ROWS_MIN_ITEMS, max_size=LAYOUT_ROWS_MAX_ITEMS
+        )
+        self.is_label_visible = validate_type(
+            is_label_visible, bool, "is_label_visible", allow_none=True
+        )
+        if grid_lines not in (None, "none", "rows", "outer"):
+            raise TypeMismatchError("Unknown layout grid lines.")
+        self.grid_lines = grid_lines
+        self.fallback: list[Block] | None = None
+        if fallback is not None:
+            self.fallback = coerce_to_list_nonnull(list[Block](fallback), Block)
+            if any(b.type.value not in self._FALLBACK_TYPES for b in self.fallback):
+                raise TypeMismatchError("Unsupported layout fallback block.")
+        from ._layout import validate_composite_depth
+
+        validate_composite_depth(self._resolve())
+
+    def _resolve(self) -> dict[str, Any]:
+        return resolve(
+            {
+                **self._attributes(),
+                "label": self.label,
+                "rows": self.rows,
+                "is_label_visible": self.is_label_visible,
+                "grid_lines": self.grid_lines,
+                "fallback": self.fallback,
+            }
+        )
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> LayoutBlock:
+        raise NotImplementedError(
+            "LayoutBlock.from_dict requires nested block parsing, which is not implemented."
+        )

{slackblocks-3.0.0 → slackblocks-3.2.0}/slackblocks/messages.py

@@ -13,6 +13,7 @@ from json import dumps
 from typing import Any
 
 from slackblocks._core import resolve
+from slackblocks._layout import descendants
 from slackblocks._limits import (
     DATA_TABLE_TOTAL_CONTENT_MAX_LENGTH,
     MARKDOWN_TOTAL_TEXT_MAX_LENGTH,
@@ -27,10 +28,6 @@ from slackblocks.utils import coerce_to_list, validate_string_nonnull
 from .attachments import Attachment
 from .blocks import (
     Block,
-    ContainerBlock,
-    DataTableBlock,
-    DataVisualizationBlock,
-    MarkdownBlock,
     _text_character_count,
 )
 from .errors import LengthError, TypeMismatchError
@@ -62,25 +59,25 @@ def _validate_message_totals(
     """
     all_blocks = [*(blocks or []), *(block for att in attachments or [] for block in att.blocks)]
 
-    def chart_count(block: Block) -> int:
-        if isinstance(block, DataVisualizationBlock):
-            return 1
-        if isinstance(block, ContainerBlock):
-            return sum(chart_count(child) for child in block.child_blocks)
-        return 0
+    rendered_blocks = descendants([resolve(block) for block in all_blocks])
 
-    if sum(chart_count(block) for block in all_blocks) > MESSAGE_DATA_VISUALIZATIONS_MAX_ITEMS:
+    if (
+        sum(block.get("type") == "data_visualization" for block in rendered_blocks)
+        > MESSAGE_DATA_VISUALIZATIONS_MAX_ITEMS
+    ):
         raise LengthError("A message may contain at most two data visualization blocks.")
-    markdown = sum(len(block.text) for block in all_blocks if isinstance(block, MarkdownBlock))
+    markdown = sum(
+        len(block["text"]) for block in rendered_blocks if block.get("type") == "markdown"
+    )
     if markdown > MARKDOWN_TOTAL_TEXT_MAX_LENGTH:
         raise LengthError(
             f"Markdown block text ({markdown} characters) exceeds the message-wide limit of "
             f"{MARKDOWN_TOTAL_TEXT_MAX_LENGTH} characters."
         )
     data_table = sum(
-        _text_character_count(resolve(block.rows))
-        for block in all_blocks
-        if isinstance(block, DataTableBlock)
+        _text_character_count(block["rows"])
+        for block in rendered_blocks
+        if block.get("type") == "data_table"
     )
     if data_table > DATA_TABLE_TOTAL_CONTENT_MAX_LENGTH:
         raise LengthError(

{slackblocks-3.0.0 → slackblocks-3.2.0}/slackblocks/views.py

@@ -11,6 +11,7 @@ from json import dumps
 from typing import Any
 
 from slackblocks._core import resolve
+from slackblocks._layout import descendants
 from slackblocks._limits import (
     VIEW_BLOCKS_MAX_ITEMS,
     VIEW_CALLBACK_ID_MAX_LENGTH,
@@ -170,7 +171,9 @@ class ModalView(View):
         self.submit = Text.to_text(
             submit, force_plaintext=True, max_length=VIEW_SUBMIT_MAX_LENGTH, allow_none=True
         )
-        if self.submit is None and any(block_type(block) == "input" for block in self.blocks):
+        if self.submit is None and any(
+            block_type(block) == "input" for block in descendants([resolve(b) for b in self.blocks])
+        ):
             raise MissingRequiredError("submit is required when a modal contains an input block")
         self.clear_on_close = clear_on_close
         self.notify_on_close = notify_on_close

{slackblocks-3.0.0 → slackblocks-3.2.0}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 5
 requires-python = ">=3.10"
 resolution-markers = [
     "python_full_version >= '3.15'",
@@ -300,11 +300,11 @@ wheels = [
 
 [[package]]
 name = "certifi"
-version = "2026.4.22"
+version = "2026.10.18"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/25/ee/6caf7a40c36a1220410afe15a1cc64993a1f864871f698c0f93acb72842a/certifi-2026.4.22.tar.gz", hash = "sha256:8d455352a37b71bf76a79caa83a3d6c25afee4a385d632127b6afb3963f1c580", size = 137077, upload-time = "2026-04-22T11:26:11.191Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7e/eb/a2aa1ac3ea30dd3f30ca57f40232138b6b0040719316ecb85daf61167771/certifi-2026.10.18.tar.gz", hash = "sha256:b9995d97b64d0431a5af837d8ca8cd6238104d1f319f04bd93ea43124d6c861e", size = 135227, upload-time = "2026-10-18T16:21:07.655Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/22/30/7cd8fdcdfbc5b869528b079bfb76dcdf6056b1a2097a662e5e8c04f42965/certifi-2026.4.22-py3-none-any.whl", hash = "sha256:3cb2210c8f88ba2318d29b0388d1023c8492ff72ecdde4ebdaddbb13a31b1c4a", size = 135707, upload-time = "2026-04-22T11:26:09.372Z" },
+    { url = "https://files.pythonhosted.org/packages/08/ba/95dd616042484f7c83a06974388b37b837732740ee70bc5dc715b5fcd55a/certifi-2026.10.18-py3-none-any.whl", hash = "sha256:73191c47aaa79da394e8fee2dbc2ec827432cab56311122c9e47abf79e390f62", size = 134093, upload-time = "2026-10-18T16:21:06.276Z" },
 ]
 
 [[package]]
@@ -1695,7 +1695,7 @@ wheels = [
 
 [[package]]
 name = "slackblocks"
-version = "3.0.0"
+version = "3.2.0"
 source = { editable = "." }
 
 [package.dev-dependencies]