slackblocks 2.4.0__tar.gz → 2.6.0__tar.gz

{slackblocks-2.4.0 → slackblocks-2.6.0}/.gitignore

@@ -117,3 +117,7 @@ node_modules/
 /docs/docs/reference/csharp/
 /docs/scripts/csharp-reference/bin/
 /docs/scripts/csharp-reference/obj/
+
+/docs/docs/reference/rust/
+
+/rust/dist/

{slackblocks-2.4.0 → slackblocks-2.6.0}/CHANGELOG.md

@@ -5,6 +5,69 @@ 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).
 
+## [Unreleased]
+
+## [2.6.0] — 2026-10-09
+
+- Release alongside the new native Rust implementation; supported language versions are unchanged.
+- Update development type checking to mypy 2.4 and refresh its locked dependencies.
+
+## [2.5.0] — 2026-09-28
+
+### Changed
+
+- `WorkflowButton` now rejects an `accessibility_label` longer than 75 characters,
+  matching Slack's limit and the shared conformance contract.
+- `DispatchActionConfiguration` without `trigger_actions_on` now raises
+  `MissingRequiredError` instead of `LengthError`.
+- `VideoBlock` now accepts `alt_text` of up to 2000 characters, including an
+  empty string, matching Slack's validator (previously 1 to 200 characters).
+- `StaticMultiSelectMenu` and `ExternalMultiSelectMenu` no longer cap
+  `initial_options` at 100; Slack documents and enforces no such limit.
+- Validation now follows Slack's `blocks.validate`. Newly rejected:
+  - out-of-range `RichTextList` `indent` (0-8), `offset` (0 or more) and
+    `border` (0-1), and `RichTextQuote` / `RichTextCodeBlock` `border` (0-1);
+  - `PlainTextInput` `min_length` outside 0-3000 or `max_length` below 1;
+    `max_selected_items` below 1 on all five multi-select menus; a negative
+    `DataTableBlock` `row_header_column_index`;
+  - an `ImageBlock` `title` over 2000 characters, an `Image` element
+    `image_url` over 3000 or `alt_text` over 2000, `VideoBlock`
+    `thumbnail_url` / `video_url` over 3000 and `title_url` /
+    `provider_icon_url` over 2000, and a view `external_id` over 255;
+  - more than 20 `TableBlock` `column_settings`, a `ContainerBlock` with no
+    child blocks, and a `PlanBlock` with more than 50 tasks or duplicate
+    `task_id`s;
+  - a `ConversationFilter` whose `include` is empty or names anything other
+    than `im`, `mpim`, `private` or `public`;
+  - a `SlackFile` `id` that does not match `^F[A-Z0-9]{8,}$`;
+  - messages (`Message`, `MessageResponse`, `WebhookMessage`) whose markdown
+    blocks total more than 12,000 characters or whose data tables total more
+    than 20,000 characters of cell text, counting attachment blocks;
+  - a standalone `TaskCardBlock` with `pending` status in a message or
+    attachment (plan tasks may still be `pending`).
+- Newly required, raising `MissingRequiredError` when omitted (signatures are
+  unchanged): `PlanBlock` `tasks`, `TaskCardBlock` `status`, `SlackIcon`
+  `name`, `NumberInput` `is_decimal_allowed`, `Attachment` `blocks`, and
+  `WorkflowButton` `action_id`. `WorkflowButton` gains the `action_id`
+  keyword argument, which it now renders.
+- `ImageBlock` accepts a `slack_file` keyword argument (and parses it in
+  `from_dict`); exactly one of `image_url` and `slack_file` is required, so
+  `image_url` is now optional.
+- `RichTextInput` `initial_value` now takes a `RichTextBlock` instead of a
+  rich text element, and `RichTextInput` gains `min_lines` and `max_lines`
+  (1-100).
+- `TableBlock` no longer requires one `column_settings` entry per column.
+- Messages now accept `InputBlock`, and `HomeTabView` accepts
+  `DataVisualizationBlock`.
+- `action_id` is now optional (and omitted from the payload when unset) on
+  every interactive element except `RichTextInput` and `WorkflowButton`; it
+  defaults to `None`, except on `CheckboxGroup`, `OverflowMenu`,
+  `RadioButtonGroup` and `StaticMultiSelectMenu`, where a required `options`
+  follows it, so pass `action_id=None` there.
+- Newly accepted: a `URLSource` `url` of any length, an empty `MarkdownBlock`
+  `text`, a view with no blocks, and `TableBlock` rows with different numbers
+  of cells.
+
 ## [2.4.0] — 2026-09-17
 
 This coordinated release introduces the C# package, published to NuGet as

{slackblocks-2.4.0 → slackblocks-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: slackblocks
-Version: 2.4.0
+Version: 2.6.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

slackblocks-2.6.0/generator/generate_limits.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+"""Generate python/slackblocks/_limits.py from spec/limits.json.
+
+The wheel and sdist are built from python/ and cannot read spec/ at runtime, so every
+limit is written out as a module-level constant named after its dotted path, e.g.
+button.url.max_length becomes BUTTON_URL_MAX_LENGTH.
+
+Usage:
+    python3 python/generator/generate_limits.py
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
+ROOT = Path(__file__).resolve().parents[2]
+LIMITS = ROOT / "spec/limits.json"
+OUTPUT = ROOT / "python/slackblocks/_limits.py"
+HEADER = '''\
+# Generated by python/generator/generate_limits.py from spec/limits.json. Do not edit.
+"""Slack Block Kit limits from spec/limits.json, the normative limit registry."""
+'''
+
+
+def leaves(node: dict[str, Any], prefix: str = "") -> Iterator[tuple[str, int | float]]:
+    for key, value in node.items():
+        path = f"{prefix}.{key}" if prefix else key
+        if isinstance(value, dict):
+            yield from leaves(value, path)
+        elif isinstance(value, int | float) and not isinstance(value, bool):
+            yield path, value
+        else:
+            raise TypeError(f"{path}: expected a number, got {value!r}")
+
+
+def render(limits: dict[str, Any]) -> str:
+    lines = [HEADER]
+    paths: dict[str, str] = {}
+    for path, value in leaves(limits):
+        name = path.replace(".", "_").upper()
+        if name in paths:
+            raise ValueError(f"{path} and {paths[name]} both map to {name}")
+        paths[name] = path
+        lines.append(f"# {path}\n{name} = {value!r}")
+    return "\n".join(lines) + "\n"
+
+
+def main() -> None:
+    limits = json.loads(LIMITS.read_text(encoding="utf-8"))
+    OUTPUT.write_text(render(limits), encoding="utf-8", newline="\n")
+
+
+if __name__ == "__main__":
+    main()

{slackblocks-2.4.0 → slackblocks-2.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "slackblocks"
-version = "2.4.0"
+version = "2.6.0"
 description = "Python wrapper for the Slack Blocks API"
 authors = [
     { name = "Nicholas Lambourne", email = "dev@ndl.im" },
@@ -45,7 +45,7 @@ exclude = ["test/**", "docs/**"]
 dev = [
     "aiohttp>=3.10.11,<4.0.0",
     "hypothesis>=6.100.0,<7.0.0",
-    "mypy>=1.14.1,<2.4.0",
+    "mypy>=1.14.1,<2.5.0",
     "pytest>=8.3.4,<10.0.0",
     "pytest-cov>=6.0.0,<8.0.0",
     "ruff>=0.8.0,<1.0.0",

{slackblocks-2.4.0 → slackblocks-2.6.0}/slackblocks/__init__.py

@@ -123,4 +123,4 @@ name = "slackblocks"
 
 # The version of the shared conformance spec (spec/SPEC.md) this
 # implementation conforms to.
-SPEC_VERSION: str = "1.1.0"
+SPEC_VERSION: str = "1.2.0"

slackblocks-2.6.0/slackblocks/_limits.py

@@ -0,0 +1,287 @@
+# Generated by python/generator/generate_limits.py from spec/limits.json. Do not edit.
+"""Slack Block Kit limits from spec/limits.json, the normative limit registry."""
+
+# text.min_length
+TEXT_MIN_LENGTH = 1
+# text.max_length
+TEXT_MAX_LENGTH = 3000
+# action_id.max_length
+ACTION_ID_MAX_LENGTH = 255
+# block_id.max_length
+BLOCK_ID_MAX_LENGTH = 255
+# button.text.max_length
+BUTTON_TEXT_MAX_LENGTH = 75
+# button.url.max_length
+BUTTON_URL_MAX_LENGTH = 3000
+# button.value.max_length
+BUTTON_VALUE_MAX_LENGTH = 2000
+# button.accessibility_label.max_length
+BUTTON_ACCESSIBILITY_LABEL_MAX_LENGTH = 75
+# confirmation.title.max_length
+CONFIRMATION_TITLE_MAX_LENGTH = 100
+# confirmation.text.max_length
+CONFIRMATION_TEXT_MAX_LENGTH = 300
+# confirmation.confirm.max_length
+CONFIRMATION_CONFIRM_MAX_LENGTH = 30
+# confirmation.deny.max_length
+CONFIRMATION_DENY_MAX_LENGTH = 30
+# option.text.max_length
+OPTION_TEXT_MAX_LENGTH = 75
+# option.value.max_length
+OPTION_VALUE_MAX_LENGTH = 150
+# option.description.max_length
+OPTION_DESCRIPTION_MAX_LENGTH = 75
+# option.url.max_length
+OPTION_URL_MAX_LENGTH = 3000
+# option_group.label.max_length
+OPTION_GROUP_LABEL_MAX_LENGTH = 75
+# option_group.options.min_items
+OPTION_GROUP_OPTIONS_MIN_ITEMS = 1
+# option_group.options.max_items
+OPTION_GROUP_OPTIONS_MAX_ITEMS = 100
+# select.placeholder.max_length
+SELECT_PLACEHOLDER_MAX_LENGTH = 150
+# select.options.max_items
+SELECT_OPTIONS_MAX_ITEMS = 100
+# select.option_groups.max_items
+SELECT_OPTION_GROUPS_MAX_ITEMS = 100
+# overflow.options.min_items
+OVERFLOW_OPTIONS_MIN_ITEMS = 1
+# overflow.options.max_items
+OVERFLOW_OPTIONS_MAX_ITEMS = 5
+# checkboxes.options.min_items
+CHECKBOXES_OPTIONS_MIN_ITEMS = 1
+# checkboxes.options.max_items
+CHECKBOXES_OPTIONS_MAX_ITEMS = 10
+# radio_buttons.options.min_items
+RADIO_BUTTONS_OPTIONS_MIN_ITEMS = 1
+# radio_buttons.options.max_items
+RADIO_BUTTONS_OPTIONS_MAX_ITEMS = 10
+# file_input.max_files.min
+FILE_INPUT_MAX_FILES_MIN = 1
+# file_input.max_files.max
+FILE_INPUT_MAX_FILES_MAX = 10
+# plain_text_input.min_length.min
+PLAIN_TEXT_INPUT_MIN_LENGTH_MIN = 0
+# plain_text_input.min_length.max
+PLAIN_TEXT_INPUT_MIN_LENGTH_MAX = 3000
+# plain_text_input.max_length.min
+PLAIN_TEXT_INPUT_MAX_LENGTH_MIN = 1
+# plain_text_input.max_length.max
+PLAIN_TEXT_INPUT_MAX_LENGTH_MAX = 3000
+# plain_text_input.placeholder.max_length
+PLAIN_TEXT_INPUT_PLACEHOLDER_MAX_LENGTH = 150
+# email_input.placeholder.max_length
+EMAIL_INPUT_PLACEHOLDER_MAX_LENGTH = 150
+# url_input.placeholder.max_length
+URL_INPUT_PLACEHOLDER_MAX_LENGTH = 150
+# number_input.placeholder.max_length
+NUMBER_INPUT_PLACEHOLDER_MAX_LENGTH = 150
+# date_picker.placeholder.max_length
+DATE_PICKER_PLACEHOLDER_MAX_LENGTH = 150
+# time_picker.placeholder.max_length
+TIME_PICKER_PLACEHOLDER_MAX_LENGTH = 150
+# rich_text_input.placeholder.max_length
+RICH_TEXT_INPUT_PLACEHOLDER_MAX_LENGTH = 150
+# rich_text_input.min_lines.min
+RICH_TEXT_INPUT_MIN_LINES_MIN = 1
+# rich_text_input.min_lines.max
+RICH_TEXT_INPUT_MIN_LINES_MAX = 100
+# rich_text_input.max_lines.min
+RICH_TEXT_INPUT_MAX_LINES_MIN = 1
+# rich_text_input.max_lines.max
+RICH_TEXT_INPUT_MAX_LINES_MAX = 100
+# multi_select.max_selected_items.min
+MULTI_SELECT_MAX_SELECTED_ITEMS_MIN = 1
+# conversation_filter.include.min_items
+CONVERSATION_FILTER_INCLUDE_MIN_ITEMS = 1
+# dispatch_action_configuration.trigger_actions_on.min_items
+DISPATCH_ACTION_CONFIGURATION_TRIGGER_ACTIONS_ON_MIN_ITEMS = 1
+# dispatch_action_configuration.trigger_actions_on.max_items
+DISPATCH_ACTION_CONFIGURATION_TRIGGER_ACTIONS_ON_MAX_ITEMS = 2
+# actions.elements.max_items
+ACTIONS_ELEMENTS_MAX_ITEMS = 25
+# alert.text.max_length
+ALERT_TEXT_MAX_LENGTH = 200
+# card.title.max_length
+CARD_TITLE_MAX_LENGTH = 150
+# card.subtitle.max_length
+CARD_SUBTITLE_MAX_LENGTH = 150
+# card.body.max_length
+CARD_BODY_MAX_LENGTH = 200
+# card.actions.max_items
+CARD_ACTIONS_MAX_ITEMS = 3
+# card.subtext.max_length
+CARD_SUBTEXT_MAX_LENGTH = 200
+# carousel.elements.min_items
+CAROUSEL_ELEMENTS_MIN_ITEMS = 1
+# carousel.elements.max_items
+CAROUSEL_ELEMENTS_MAX_ITEMS = 10
+# container.title.max_length
+CONTAINER_TITLE_MAX_LENGTH = 150
+# container.subtitle.max_length
+CONTAINER_SUBTITLE_MAX_LENGTH = 150
+# container.child_blocks.min_items
+CONTAINER_CHILD_BLOCKS_MIN_ITEMS = 1
+# container.child_blocks.max_items
+CONTAINER_CHILD_BLOCKS_MAX_ITEMS = 10
+# context.elements.max_items
+CONTEXT_ELEMENTS_MAX_ITEMS = 10
+# context_actions.elements.max_items
+CONTEXT_ACTIONS_ELEMENTS_MAX_ITEMS = 5
+# feedback_button.text.max_length
+FEEDBACK_BUTTON_TEXT_MAX_LENGTH = 75
+# feedback_button.value.max_length
+FEEDBACK_BUTTON_VALUE_MAX_LENGTH = 2000
+# feedback_button.accessibility_label.max_length
+FEEDBACK_BUTTON_ACCESSIBILITY_LABEL_MAX_LENGTH = 75
+# icon_button.value.max_length
+ICON_BUTTON_VALUE_MAX_LENGTH = 2000
+# icon_button.accessibility_label.max_length
+ICON_BUTTON_ACCESSIBILITY_LABEL_MAX_LENGTH = 75
+# icon_button.visible_to_user_ids.max_items
+ICON_BUTTON_VISIBLE_TO_USER_IDS_MAX_ITEMS = 10
+# workflow_button.text.max_length
+WORKFLOW_BUTTON_TEXT_MAX_LENGTH = 75
+# workflow_button.accessibility_label.max_length
+WORKFLOW_BUTTON_ACCESSIBILITY_LABEL_MAX_LENGTH = 75
+# table.rows.max_items
+TABLE_ROWS_MAX_ITEMS = 100
+# table.columns.max_items
+TABLE_COLUMNS_MAX_ITEMS = 20
+# table.column_settings.max_items
+TABLE_COLUMN_SETTINGS_MAX_ITEMS = 20
+# data_table.rows.min_items
+DATA_TABLE_ROWS_MIN_ITEMS = 2
+# data_table.rows.max_items
+DATA_TABLE_ROWS_MAX_ITEMS = 201
+# data_table.columns.min_items
+DATA_TABLE_COLUMNS_MIN_ITEMS = 1
+# data_table.columns.max_items
+DATA_TABLE_COLUMNS_MAX_ITEMS = 20
+# data_table.page_size.min
+DATA_TABLE_PAGE_SIZE_MIN = 1
+# data_table.page_size.max
+DATA_TABLE_PAGE_SIZE_MAX = 100
+# data_table.cell_text.min_length
+DATA_TABLE_CELL_TEXT_MIN_LENGTH = 1
+# data_table.content.max_length
+DATA_TABLE_CONTENT_MAX_LENGTH = 20000
+# data_table.total_content.max_length
+DATA_TABLE_TOTAL_CONTENT_MAX_LENGTH = 20000
+# data_table.row_header_column_index.min
+DATA_TABLE_ROW_HEADER_COLUMN_INDEX_MIN = 0
+# data_visualization.title.max_length
+DATA_VISUALIZATION_TITLE_MAX_LENGTH = 50
+# data_visualization.segments.min_items
+DATA_VISUALIZATION_SEGMENTS_MIN_ITEMS = 1
+# data_visualization.segments.max_items
+DATA_VISUALIZATION_SEGMENTS_MAX_ITEMS = 12
+# data_visualization.segment.label.max_length
+DATA_VISUALIZATION_SEGMENT_LABEL_MAX_LENGTH = 20
+# data_visualization.segment.value.exclusive_min
+DATA_VISUALIZATION_SEGMENT_VALUE_EXCLUSIVE_MIN = 0
+# data_visualization.series.min_items
+DATA_VISUALIZATION_SERIES_MIN_ITEMS = 1
+# data_visualization.series.max_items
+DATA_VISUALIZATION_SERIES_MAX_ITEMS = 12
+# data_visualization.series_name.max_length
+DATA_VISUALIZATION_SERIES_NAME_MAX_LENGTH = 20
+# data_visualization.data.min_items
+DATA_VISUALIZATION_DATA_MIN_ITEMS = 1
+# data_visualization.data.max_items
+DATA_VISUALIZATION_DATA_MAX_ITEMS = 20
+# data_visualization.point_label.max_length
+DATA_VISUALIZATION_POINT_LABEL_MAX_LENGTH = 20
+# data_visualization.categories.min_items
+DATA_VISUALIZATION_CATEGORIES_MIN_ITEMS = 1
+# data_visualization.categories.max_items
+DATA_VISUALIZATION_CATEGORIES_MAX_ITEMS = 20
+# data_visualization.category_label.max_length
+DATA_VISUALIZATION_CATEGORY_LABEL_MAX_LENGTH = 20
+# data_visualization.axis_label.max_length
+DATA_VISUALIZATION_AXIS_LABEL_MAX_LENGTH = 50
+# header.text.max_length
+HEADER_TEXT_MAX_LENGTH = 150
+# image.image_url.max_length
+IMAGE_IMAGE_URL_MAX_LENGTH = 3000
+# image.alt_text.max_length
+IMAGE_ALT_TEXT_MAX_LENGTH = 2000
+# image.title.max_length
+IMAGE_TITLE_MAX_LENGTH = 2000
+# image_element.image_url.max_length
+IMAGE_ELEMENT_IMAGE_URL_MAX_LENGTH = 3000
+# image_element.alt_text.max_length
+IMAGE_ELEMENT_ALT_TEXT_MAX_LENGTH = 2000
+# input.label.max_length
+INPUT_LABEL_MAX_LENGTH = 2000
+# input.hint.max_length
+INPUT_HINT_MAX_LENGTH = 2000
+# markdown.text.max_length
+MARKDOWN_TEXT_MAX_LENGTH = 12000
+# markdown.total_text.max_length
+MARKDOWN_TOTAL_TEXT_MAX_LENGTH = 12000
+# plan.tasks.max_items
+PLAN_TASKS_MAX_ITEMS = 50
+# rich_text_list.indent.min
+RICH_TEXT_LIST_INDENT_MIN = 0
+# rich_text_list.indent.max
+RICH_TEXT_LIST_INDENT_MAX = 8
+# rich_text_list.offset.min
+RICH_TEXT_LIST_OFFSET_MIN = 0
+# rich_text_list.border.min
+RICH_TEXT_LIST_BORDER_MIN = 0
+# rich_text_list.border.max
+RICH_TEXT_LIST_BORDER_MAX = 1
+# rich_text_quote.border.min
+RICH_TEXT_QUOTE_BORDER_MIN = 0
+# rich_text_quote.border.max
+RICH_TEXT_QUOTE_BORDER_MAX = 1
+# rich_text_preformatted.border.min
+RICH_TEXT_PREFORMATTED_BORDER_MIN = 0
+# rich_text_preformatted.border.max
+RICH_TEXT_PREFORMATTED_BORDER_MAX = 1
+# section.text.max_length
+SECTION_TEXT_MAX_LENGTH = 3000
+# section.fields.max_items
+SECTION_FIELDS_MAX_ITEMS = 10
+# section.fields.item_max_length
+SECTION_FIELDS_ITEM_MAX_LENGTH = 2000
+# video.alt_text.max_length
+VIDEO_ALT_TEXT_MAX_LENGTH = 2000
+# video.title.max_length
+VIDEO_TITLE_MAX_LENGTH = 200
+# video.author_name.max_length
+VIDEO_AUTHOR_NAME_MAX_LENGTH = 50
+# video.description.max_length
+VIDEO_DESCRIPTION_MAX_LENGTH = 200
+# video.provider_name.max_length
+VIDEO_PROVIDER_NAME_MAX_LENGTH = 50
+# video.thumbnail_url.max_length
+VIDEO_THUMBNAIL_URL_MAX_LENGTH = 3000
+# video.video_url.max_length
+VIDEO_VIDEO_URL_MAX_LENGTH = 3000
+# video.title_url.max_length
+VIDEO_TITLE_URL_MAX_LENGTH = 2000
+# video.provider_icon_url.max_length
+VIDEO_PROVIDER_ICON_URL_MAX_LENGTH = 2000
+# message.channel.min_length
+MESSAGE_CHANNEL_MIN_LENGTH = 1
+# message.blocks.max_items
+MESSAGE_BLOCKS_MAX_ITEMS = 50
+# message.attachments.max_items
+MESSAGE_ATTACHMENTS_MAX_ITEMS = 100
+# view.blocks.max_items
+VIEW_BLOCKS_MAX_ITEMS = 100
+# view.private_metadata.max_length
+VIEW_PRIVATE_METADATA_MAX_LENGTH = 3000
+# view.callback_id.max_length
+VIEW_CALLBACK_ID_MAX_LENGTH = 255
+# view.external_id.max_length
+VIEW_EXTERNAL_ID_MAX_LENGTH = 255
+# view.title.max_length
+VIEW_TITLE_MAX_LENGTH = 24
+# view.close.max_length
+VIEW_CLOSE_MAX_LENGTH = 24
+# view.submit.max_length
+VIEW_SUBMIT_MAX_LENGTH = 24

{slackblocks-2.4.0 → slackblocks-2.6.0}/slackblocks/_surfaces.py

@@ -24,6 +24,7 @@ _BLOCK_TYPES_BY_SURFACE: dict[BlockSurface, frozenset[str]] = {
             "file",
             "header",
             "image",
+            "input",
             "markdown",
             "plan",
             "rich_text",
@@ -56,6 +57,7 @@ _BLOCK_TYPES_BY_SURFACE: dict[BlockSurface, frozenset[str]] = {
             "container",
             "context",
             "data_table",
+            "data_visualization",
             "divider",
             "header",
             "image",
@@ -87,3 +89,19 @@ def validate_surface_blocks(blocks: list[Any], surface: BlockSurface) -> None:
             raise TypeMismatchError(
                 f"blocks[{index}] type {type_!r} is not supported on {surface} surfaces"
             )
+    validate_standalone_task_cards(blocks)
+
+
+def validate_standalone_task_cards(blocks: list[Any]) -> None:
+    """Reject standalone task cards with ``pending`` status; only plan tasks may be pending."""
+    for index, block in enumerate(blocks):
+        rendered = resolve(block)
+        if (
+            isinstance(rendered, dict)
+            and rendered.get("type") == "task_card"
+            and rendered.get("status") == "pending"
+        ):
+            raise TypeMismatchError(
+                f"blocks[{index}] is a standalone task card with `pending` status; "
+                "only plan tasks can be pending"
+            )

{slackblocks-2.4.0 → slackblocks-2.6.0}/slackblocks/attachments.py

@@ -12,9 +12,10 @@ from json import dumps
 from typing import Any
 
 from slackblocks._core import resolve
+from slackblocks._surfaces import validate_standalone_task_cards
 from slackblocks.blocks import Block
-from slackblocks.errors import TypeMismatchError
-from slackblocks.utils import coerce_to_list, is_hex
+from slackblocks.errors import MissingRequiredError, TypeMismatchError
+from slackblocks.utils import coerce_to_list, coerce_to_list_nonnull, is_hex
 
 
 class Color(Enum):
@@ -99,7 +100,7 @@ class Attachment:
     `slackblocks`.
 
     Args:
-        blocks: an array of Blocks that define the content of the attachment.
+        blocks: an array of Blocks that define the content of the attachment (required).
         color: the color (in hex format, e.g. #ffffff) of the vertical bar to the left of the
             attachment content. Consider using the `Color` enum from this module.
         fields: a list of `Field` objects to be included in what's rendered in the attachment.
@@ -107,7 +108,7 @@ class Attachment:
             formatted text (eg. IRC, mobile notifications).
 
     Throws:
-        InvalidUsageError: if the `color` code provided is invalid.
+        InvalidUsageError: if `blocks` is missing or the `color` code provided is invalid.
     """
 
     def __init__(
@@ -117,7 +118,10 @@ class Attachment:
         fields: Field | list[Field] | None = None,
         fallback: str | None = None,
     ):
-        self.blocks = coerce_to_list(blocks, Block, allow_none=True)
+        if blocks is None:
+            raise MissingRequiredError("Attachment requires `blocks`.")
+        self.blocks: list[Block] = coerce_to_list_nonnull(blocks, Block)
+        validate_standalone_task_cards(self.blocks)
         self.fields = coerce_to_list(fields, Field, allow_none=True)
         self.fallback = fallback
         self.color: str | None