ultimate-notion / ultimate-notion / 28299699145

87%

push

github

feat(blocks): Add tab block support via new Tabs block (#188) (#420)

* feat(blocks): Add tab block support via new Tabs block (#188)

Add support for Notion tab blocks, which group content into labeled
tabs. A tab block is a container whose children are paragraph blocks,
each acting as a tab (rich text = label, optional icon, children =
content), mirroring the existing Columns/Column design.

- obj_api: add `Tab`/`TabTypeData`
- high-level: add `Tabs` block (create with labels, `add_tab`, indexing,
  markdown) and a `Paragraph.icon` property; wire `Tabs` into append
  batching; export `Tabs`
- docs + CHANGELOG; offline and live (VCR) tests

Live cassettes for the new tests and the docs example are not yet
recorded.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* refactor(blocks): Scope tabs PR to tab blocks only, drop Paragraph.icon

Remove the general-purpose `Paragraph.icon` property and the tab-icon
handling that came with it, keeping this change focused solely on tab
block support (#188). Tab icons can be added separately as their own
enhancement.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* refactor(blocks): Align Tabs API with Columns conventions

Make the new Tabs block consistent with the existing container blocks:

- `add_tab` now returns `Self` (like `add_column`/`insert_row`) instead
  of the created tab; index is positional and validation mirrors
  `add_column`'s if/else shape
- `Tabs(...)` requires a sequence of label strings (no empty default),
  validates the element type, rejects a bare `str`, and enforces a
  `MIN_TABS` minimum — mirroring `Columns`' type/`MIN_COLS` checks
- Update the docs example and add construction-validation tests

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* refactor(blocks): Drop Tabs init checks already covered by type hints

The `not isinstance(tabs, Sequence)` and per-element `isinstance(label,
str)` guards in `Tabs.__init__` on... (continued)

53 of 58 new or added lines in 2 files covered. (91.38%)

6885 of 7900 relevant lines covered (87.15%)

6.07 hits per line