slackblocks 2.7.0__tar.gz → 3.0.0__tar.gz

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

@@ -126,3 +126,13 @@ docs/docs/reference/php/
 # Root Composer package consumers
 /vendor/
 /composer.lock
+
+# Elixir sources are public package code, not Python build output.
+!/elixir/lib/
+!/elixir/lib/**
+
+# Elixir sending examples are source, including their native lib directory.
+!/elixir/integrations/lib/
+!/elixir/integrations/lib/**
+
+/docs/docs/reference/elixir/

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

@@ -5,12 +5,42 @@ 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.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.
+
+- Release the coordinated 3.0.0 API across all nine implementations; supported language/runtime minimums remain unchanged.
+- Breaking: number-input bounds are strings in stored values and getters; numeric construction conveniences remain. See the migration guide before upgrading.
+- Freeze the 2.8.0 documentation and fix shared language/version selector artwork and arrows across documentation versions.
+
+- Validate typed parser discriminators and consistently coerce named/wire button styles; document the supported parse subset.
+
+- Add native confirmation style, workflow confirmation, emoji skin tone and message metadata fields.
+
+- Preserve accepted legacy `Attachment.fields` values as JSON objects, including
+  `short=False`. Fields-only legacy content uses an explicit `blocks=[]`.
+- Distinguish omitted response visibility from explicit `ephemeral=False`, which
+  now emits `response_type: "in_channel"`. The no-argument wire default is unchanged.
+- Explicitly re-export the public Python API for strict installed-package type checking.
+- SB-006: reject messages with more than two data visualization blocks after composition, including attachment charts. The rule does not impose a two-chart limit on views.
+
+- SB-003: reject explicitly supplied `focus_on_load` on external multi-selects, including false. Omit this deprecated parameter; other selectors retain focus support.
+- Reject negative external-query thresholds, empty supplied static options/groups and malformed date/time strings, matching the retained Slack structural probes. Date shape checks do not add a calendar-validity guarantee; empty image alt text remains accepted (SB-013).
+
+- Reject a plain-text input whose supplied `min_length` exceeds `max_length` (`out-of-range`); equal, zero-minimum and omitted bounds remain supported (SB-013).
+
+- Correct number-input bounds to string wire values, retain native numeric convenience arguments, and reject nonfinite/inverted bounds (SB-001, spec 1.3.0). Bound getters now return strings; reflection/signature consumers must migrate.
+
+- Clarify that `submit_disabled`, including explicit false, is configuration-modal-only; ordinary modal examples omit it (SB-015).
+
+## [2.8.0] — 2026-10-18
+
+- Coordinate the first Elixir implementation release; existing language support remains unchanged.
+
 ## [2.7.0] — 2026-10-11
 
 - Add the PHP implementation to the coordinated release and documentation.
 
-## [Unreleased]
-
 ## [2.6.0] — 2026-10-09
 
 - Release alongside the new native Rust implementation; supported language versions are unchanged.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: slackblocks
-Version: 2.7.0
+Version: 3.0.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.7.0 → slackblocks-3.0.0}/pyproject.toml

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

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

@@ -123,4 +123,123 @@ name = "slackblocks"
 
 # The version of the shared conformance spec (spec/SPEC.md) this
 # implementation conforms to.
-SPEC_VERSION: str = "1.2.0"
+SPEC_VERSION: str = "1.4.0"
+
+# Literal exports are visible to strict external type checkers.
+__all__ = [
+    "ActionsBlock",
+    "AlertBlock",
+    "AlertLevel",
+    "AreaChart",
+    "Attachment",
+    "AxisConfig",
+    "BarChart",
+    "Block",
+    "Button",
+    "CardBlock",
+    "CarouselBlock",
+    "ChannelMultiSelectMenu",
+    "ChannelSelectMenu",
+    "Chart",
+    "ChartSegment",
+    "CheckboxGroup",
+    "Color",
+    "ColumnSettings",
+    "Confirm",
+    "ConfirmationDialogue",
+    "ContainerBlock",
+    "ContainerWidth",
+    "ContextActionsBlock",
+    "ContextBlock",
+    "ConversationFilter",
+    "ConversationMultiSelectMenu",
+    "ConversationSelectMenu",
+    "DataPoint",
+    "DataSeries",
+    "DataTableBlock",
+    "DataVisualizationBlock",
+    "DatePicker",
+    "DateTimePicker",
+    "DispatchActionConfiguration",
+    "DividerBlock",
+    "Element",
+    "EmailInput",
+    "ExternalMultiSelectMenu",
+    "ExternalSelectMenu",
+    "FeedbackButton",
+    "FeedbackButtons",
+    "Field",
+    "FileBlock",
+    "FileInput",
+    "HeaderBlock",
+    "HomeTabView",
+    "IconButton",
+    "Image",
+    "ImageBlock",
+    "InputBlock",
+    "InputParameter",
+    "InvalidUsageError",
+    "LengthError",
+    "LineChart",
+    "Markdown",
+    "MarkdownBlock",
+    "Message",
+    "MessageResponse",
+    "MissingRequiredError",
+    "Modal",
+    "ModalView",
+    "MutualExclusivityError",
+    "NumberInput",
+    "Option",
+    "OptionGroup",
+    "OverflowMenu",
+    "PieChart",
+    "PlainText",
+    "PlainTextInput",
+    "PlanBlock",
+    "RadioButtonGroup",
+    "RangeError",
+    "RawNumber",
+    "RawText",
+    "ResponseType",
+    "RichText",
+    "RichTextBlock",
+    "RichTextChannel",
+    "RichTextCodeBlock",
+    "RichTextElement",
+    "RichTextEmoji",
+    "RichTextInput",
+    "RichTextLink",
+    "RichTextList",
+    "RichTextObject",
+    "RichTextQuote",
+    "RichTextSection",
+    "RichTextUser",
+    "RichTextUserGroup",
+    "SPEC_VERSION",
+    "SectionBlock",
+    "SlackFile",
+    "SlackIcon",
+    "SlackIconName",
+    "StaticMultiSelectMenu",
+    "StaticSelectMenu",
+    "TableBlock",
+    "TaskCardBlock",
+    "TaskStatus",
+    "Text",
+    "TextType",
+    "TimePicker",
+    "Trigger",
+    "TypeMismatchError",
+    "URLInput",
+    "URLSource",
+    "UserMultiSelectMenu",
+    "UserSelectMenu",
+    "VideoBlock",
+    "View",
+    "WebhookMessage",
+    "Workflow",
+    "WorkflowButton",
+    "block_kit_builder_url",
+    "name",
+]

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

@@ -17,6 +17,8 @@ BUTTON_URL_MAX_LENGTH = 3000
 BUTTON_VALUE_MAX_LENGTH = 2000
 # button.accessibility_label.max_length
 BUTTON_ACCESSIBILITY_LABEL_MAX_LENGTH = 75
+# button.agent_prompt.max_length
+BUTTON_AGENT_PROMPT_MAX_LENGTH = 4000
 # confirmation.title.max_length
 CONFIRMATION_TITLE_MAX_LENGTH = 100
 # confirmation.text.max_length
@@ -41,10 +43,16 @@ OPTION_GROUP_OPTIONS_MIN_ITEMS = 1
 OPTION_GROUP_OPTIONS_MAX_ITEMS = 100
 # select.placeholder.max_length
 SELECT_PLACEHOLDER_MAX_LENGTH = 150
+# select.options.min_items
+SELECT_OPTIONS_MIN_ITEMS = 1
 # select.options.max_items
 SELECT_OPTIONS_MAX_ITEMS = 100
+# select.option_groups.min_items
+SELECT_OPTION_GROUPS_MIN_ITEMS = 1
 # select.option_groups.max_items
 SELECT_OPTION_GROUPS_MAX_ITEMS = 100
+# select.min_query_length.min
+SELECT_MIN_QUERY_LENGTH_MIN = 0
 # overflow.options.min_items
 OVERFLOW_OPTIONS_MIN_ITEMS = 1
 # overflow.options.max_items
@@ -265,6 +273,8 @@ VIDEO_VIDEO_URL_MAX_LENGTH = 3000
 VIDEO_TITLE_URL_MAX_LENGTH = 2000
 # video.provider_icon_url.max_length
 VIDEO_PROVIDER_ICON_URL_MAX_LENGTH = 2000
+# message.data_visualizations.max_items
+MESSAGE_DATA_VISUALIZATIONS_MAX_ITEMS = 2
 # message.channel.min_length
 MESSAGE_CHANNEL_MIN_LENGTH = 1
 # message.blocks.max_items

{slackblocks-2.7.0 → slackblocks-3.0.0}/slackblocks/attachments.py

@@ -77,14 +77,8 @@ class Field:
         self.value = value
         self.short = short
 
-    def _resolve(self):
-        field = dict()
-        field["short"] = self.short
-        if self.title:
-            field["title"] = self.title
-        if self.value:
-            field["value"] = self.value
-        return dumps(field)
+    def _resolve(self) -> dict[str, Any]:
+        return resolve({"title": self.title, "value": self.value, "short": self.short})
 
 
 class Attachment:
@@ -95,7 +89,9 @@ class Attachment:
 
     See <https://api.slack.com/reference/messaging/attachments>.
 
-    N.B: `fields` is a deprecated field, included only for legacy purposes. Other legacy
+    N.B: `fields` is a deprecated field, included only for legacy purposes. The
+    `blocks` argument remains required; use `blocks=[]` for legacy fields-only
+    content. Other legacy
     fields, e.g. `author_name` are deliberately omitted as they were never implemented in
     `slackblocks`.
 
@@ -138,12 +134,10 @@ class Attachment:
             self.color = None
 
     def _resolve(self) -> dict[str, Any]:
-        # Note: 'fields' is intentionally not included here. The attribute
-        # exists for legacy reasons but Attachment._resolve has historically
-        # never emitted it; preserving that behaviour.
         return resolve(
             {
                 "blocks": self.blocks if self.blocks else None,
+                "fields": self.fields if self.fields else None,
                 "color": self.color if self.color else None,
                 "fallback": self.fallback if self.fallback else None,
             }

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

@@ -254,6 +254,13 @@ class Block(RenderableMixin, ABC):
         return registry[type_str](data)
 
 
+def _require_block_type(data: dict[str, Any], expected: str) -> None:
+    if "type" not in data:
+        raise MissingRequiredError(f"{expected}.type is required.")
+    if data["type"] != expected:
+        raise TypeMismatchError(f"{expected}.type must be {expected!r}, got {data['type']!r}.")
+
+
 def _block_from_dict_registry() -> dict[str, Any]:
     """Lazy registry mapping ``BlockType`` values to subclass ``from_dict``
     callables. Built on first call to avoid forward-reference issues."""
@@ -363,6 +370,7 @@ class ContextBlock(Block):
         elements raise ``NotImplementedError`` because ``Element.from_dict``
         has not yet shipped (Phase 7.4b).
         """
+        _require_block_type(data, "context")
         elements: list[Element | CompositionObject] = []
         for raw in data.get("elements", []):
             etype = raw.get("type")
@@ -394,6 +402,7 @@ class DividerBlock(Block):
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> DividerBlock:
         """Parse a Slack ``divider`` block payload."""
+        _require_block_type(data, "divider")
         return cls(block_id=data.get("block_id"))
 
 
@@ -430,6 +439,7 @@ class FileBlock(Block):
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> FileBlock:
         """Parse a Slack ``file`` block payload."""
+        _require_block_type(data, "file")
         if "external_id" not in data:
             raise MissingRequiredError("FileBlock payload is missing required `external_id` field.")
         return cls(
@@ -460,6 +470,7 @@ class HeaderBlock(Block):
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> HeaderBlock:
         """Parse a Slack ``header`` block payload."""
+        _require_block_type(data, "header")
         if "text" not in data:
             raise MissingRequiredError("HeaderBlock payload is missing required `text` field.")
         return cls(text=Text.from_dict(data["text"]), block_id=data.get("block_id"))
@@ -527,6 +538,7 @@ class ImageBlock(Block):
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> ImageBlock:
         """Parse a Slack ``image`` block payload."""
+        _require_block_type(data, "image")
         title_raw = data.get("title")
         slack_file_raw = data.get("slack_file")
         return cls(
@@ -644,6 +656,7 @@ class MarkdownBlock(Block):
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> MarkdownBlock:
         """Parse a Slack ``markdown`` block payload."""
+        _require_block_type(data, "markdown")
         if "text" not in data:
             raise MissingRequiredError("MarkdownBlock payload is missing required `text` field.")
         return cls(text=data["text"], block_id=data.get("block_id"))
@@ -776,6 +789,7 @@ class SectionBlock(Block):
         ``Element`` and ``Element.from_dict`` is not yet implemented
         (Phase 7.4b).
         """
+        _require_block_type(data, "section")
         if data.get("accessory") is not None:
             raise NotImplementedError(
                 "SectionBlock.from_dict cannot yet parse an `accessory`; "
@@ -988,6 +1002,7 @@ class VideoBlock(Block):
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> VideoBlock:
         """Parse a Slack ``video`` block payload."""
+        _require_block_type(data, "video")
         required = ("alt_text", "thumbnail_url", "title", "video_url")
         for field in required:
             if field not in data:
@@ -1046,6 +1061,7 @@ class AlertBlock(Block):
 
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> AlertBlock:
+        _require_block_type(data, "alert")
         if "text" not in data:
             raise MissingRequiredError("AlertBlock payload is missing required `text` field.")
         return cls(