feat(models): add typed model classes for TableBlock cells and column_settings

[srtaalej]

Summary

Adds typed model classes for TableBlock cells and column settings, so developers get autocomplete and validation instead of hand-building dicts.

• TableBlockColumnSettings — typed class for column settings with align and is_wrapped
• RichTextBlock (pre-existing) — already covers rich_text table cells
• RawTextObject (pre-existing) — already covers raw_text cells

TableBlock type annotations are widened to accept both typed objects and raw dicts for full backward compatibility.

Note: raw_number cell support is not included in this PR because client rendering for that type is not yet confirmed across platforms.

Closes #1938

Testing

Test app.py

import os
import logging

from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler
from slack_sdk.models.blocks import (
    RawTextObject,
    RichTextBlock,
    TableBlock,
    TableBlockColumnSettings,
)

logging.basicConfig(level=logging.DEBUG)

app = App(token=os.environ["SLACK_BOT_TOKEN"], request_verification_enabled=False)


@app.message("table")
def handle_table_message(message, client):
    channel = message["channel"]

    table = TableBlock(
        rows=[
            [
                RawTextObject(text="Item"),
                RawTextObject(text="Qty"),
                RawTextObject(text="Notes"),
            ],
            [
                RawTextObject(text="Apples"),
                RawTextObject(text="5"),
                RichTextBlock(
                    elements=[{"type": "rich_text_section", "elements": [{"type": "text", "text": "Fresh from the market"}]}]
                ),
            ],
            [
                RawTextObject(text="Bananas"),
                RawTextObject(text="12"),
                RichTextBlock(elements=[{"type": "rich_text_section", "elements": [{"type": "text", "text": "Organic"}]}]),
            ],
        ],
        column_settings=[
            TableBlockColumnSettings(align="left"),
            TableBlockColumnSettings(align="right"),
            TableBlockColumnSettings(align="left", is_wrapped=True),
        ],
    )

    client.chat_postMessage(
        channel=channel,
        text="Here's a table with typed model classes:",
        blocks=[table.to_dict()],
    )


if __name__ == "__main__":
    SocketModeHandler(app, os.environ.get("SLACK_APP_TOKEN")).start()

Requirements

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.

[codecov]

Codecov Report

❌ Patch coverage is 61.11111% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 84.11%. Comparing base (ae87985) to head (e80261f).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
slack_sdk/models/blocks/basic_components.py	58.82%	7 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1939      +/-   ##
==========================================
- Coverage   84.17%   84.11%   -0.07%     
==========================================
  Files         118      118              
  Lines       13425    13442      +17     
==========================================
+ Hits        11301    11307       +6     
- Misses       2124     2135      +11     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

[zimeg]

@srtaalej Before marking this for merge I have a suggestions that reuses the rich_text block to save some duplication and keep the cell most current 🐣 I'll share the schema I find this at in channel!

[zimeg]

Suggested change

	class RichTextCell(JsonObject):
	"""A rich_text typed cell for use in TableBlock rows."""
	type = "rich_text"
	@property
	def attributes(self) -> Set[str]:
	return {"type", "elements"}
	def __init__(
	self,
	*,
	elements: Sequence[Union[Dict[str, Any], Any]],
	**others: dict,
	):
	"""A rich text cell used in table block rows.
	https://docs.slack.dev/reference/block-kit/blocks/table-block
	Args:
	elements (required): An array of rich text element objects
	(rich_text_section, rich_text_list, rich_text_quote, rich_text_preformatted).
	"""
	show_unknown_key_warning(self, others)
	self.type = self.__class__.type
	from slack_sdk.models.blocks.block_elements import BlockElement
	self.elements = BlockElement.parse_all(elements)
	@classmethod
	def parse(cls, cell: Optional[Union[Dict[str, Any], "RichTextCell"]]) -> Optional["RichTextCell"]:
	if cell is None:
	return None
	if isinstance(cell, RichTextCell):
	return cell
	if isinstance(cell, dict):
	d = {k: v for k, v in cell.items() if k != "type"}
	return RichTextCell(**d)
	return None

🪓 note: I think here we can use the existing RichTextBlock similar to @slack/types implementation:

https://github.com/slackapi/node-slack-sdk/blob/122865134ffa20ad080fcf447cfb93b7252da157/packages/types/src/block-kit/blocks.ts#L450-L467

[zimeg]

Suggested change

	class ColumnSettings(JsonObject):
	class TableBlockColumnSettings(JsonObject):

📣 note: Hoping to namespace this to match the @slack/types package too but also to avoid confusion on which columns this settings are applied:

https://github.com/slackapi/node-slack-sdk/blob/122865134ffa20ad080fcf447cfb93b7252da157/packages/types/src/block-kit/blocks.ts#L469-L482

👾 note: Please know I'm less confident about this change so consider it a non-blocking preference!