feat: Add task lists (checklists) support v0.15.0

- Add task_list() and task_item() helper functions
- Support for nested checklists (unlimited depth)
- Add TaskListNode, TaskItemNode types
- Add checked attribute for completion tracking
- Add comprehensive documentation and examples
- Add 8 unit tests and 4 integration tests
- All tests passing

Author: m-brtn

CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [0.15.0] - 2025-10-24
+
+### Added
+
+- **✅ Task Lists (Checklists)**: Interactive checklists with checked/unchecked states
+  - `task_list(*items)` - Create a checklist container
+  - `task_item(content, checked=False)` - Create individual checklist items
+  - Support for nested checklists (unlimited depth)
+  - Each task item can contain paragraphs and nested task lists
+  - `checked` attribute tracks completion status (boolean)
+  - Auto-generated UIDs for task lists
+  - Full integration with document API (`replace_json_document`, `append_json_document`)
+  
+- **New Document Structure Types**:
+  - `TaskListNode` - Type for task list container
+  - `TaskItemNode` - Type for individual checklist items
+  - `TaskListAttrs` - Attributes for task lists (uid)
+  - `TaskItemAttrs` - Attributes for task items (checked status)
+
+### Documentation
+
+- Added comprehensive task list documentation in API reference
+- Added nested checklist examples and patterns
+- Updated document structure guide with task list blocks
+- Added task list to supported elements table
+
+### Examples
+
+- `examples/task_list_checklist.py` - Complete examples of task lists usage
+  - Simple checklists
+  - Nested checklists (multi-level)
+  - Mixed content (text + checklists)
+  - Complex nested structures (3+ levels)
+
+### Tests
+
+- Added 8 unit tests for task list functionality
+- Added 4 integration tests with real API
+- All tests passing
+
 ## [0.14.0] - 2025-10-24
 
 ### Added

docs-site/docs/api-reference/document-structure.md

@@ -350,6 +350,85 @@ Numbered list.
 **Attributes:**
 - `start` - Starting number (optional, default: 1)
 
+### Task List Node (Checklist)
+
+Interactive checklist with checkable items.
+
+```json
+{
+  "type": "taskList",
+  "attrs": {
+    "uid": "uniqueId123"
+  },
+  "content": [
+    {
+      "type": "taskItem",
+      "attrs": {
+        "checked": true
+      },
+      "content": [
+        {
+          "type": "paragraph",
+          "content": [{"type": "text", "text": "Completed task"}]
+        }
+      ]
+    },
+    {
+      "type": "taskItem",
+      "attrs": {
+        "checked": false
+      },
+      "content": [
+        {
+          "type": "paragraph",
+          "content": [{"type": "text", "text": "Todo task"}]
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Attributes:**
+- `uid` - Unique identifier (optional, auto-generated)
+
+**Features:**
+- Interactive checkboxes
+- Can be nested for multi-level checklists
+- Supports checked/unchecked states
+- Can contain paragraphs and nested task lists
+
+### Task Item Node
+
+Individual item in a task list (checklist).
+
+```json
+{
+  "type": "taskItem",
+  "attrs": {
+    "checked": false
+  },
+  "content": [
+    {
+      "type": "paragraph",
+      "content": [{"type": "text", "text": "Task description"}]
+    },
+    {
+      "type": "taskList",
+      "content": [...]  // Nested checklist
+    }
+  ]
+}
+```
+
+**Attributes:**
+- `checked` - Whether the task is completed (required, boolean)
+
+**Content:**
+- Can contain paragraphs
+- Can contain nested `taskList` nodes for sub-tasks
+- Supports multi-level nesting
+
 ### List Item Node
 
 Individual item in a list. Can contain paragraphs and nested lists.
@@ -611,6 +690,8 @@ Table header cell (`<th>` in HTML). Use for semantic table headers.
 
 ## Nested Structures
 
+### Nested Lists
+
 Lists can be nested within list items:
 
 ```json
@@ -644,6 +725,83 @@ Lists can be nested within list items:
 }
 ```
 
+### Nested Checklists
+
+Task lists support multi-level nesting:
+
+```json
+{
+  "type": "taskList",
+  "attrs": {"uid": "mainList"},
+  "content": [
+    {
+      "type": "taskItem",
+      "attrs": {"checked": false},
+      "content": [
+        {
+          "type": "paragraph",
+          "content": [{"type": "text", "text": "Main task"}]
+        },
+        {
+          "type": "taskList",
+          "attrs": {"uid": "nestedList"},
+          "content": [
+            {
+              "type": "taskItem",
+              "attrs": {"checked": true},
+              "content": [
+                {
+                  "type": "paragraph",
+                  "content": [{"type": "text", "text": "Subtask 1"}]
+                }
+              ]
+            },
+            {
+              "type": "taskItem",
+              "attrs": {"checked": false},
+              "content": [
+                {
+                  "type": "paragraph",
+                  "content": [{"type": "text", "text": "Subtask 2"}]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Using helpers for nested checklists:**
+
+```python
+from vaiz import task_list, task_item, paragraph
+
+content = [
+    task_list(
+        task_item(
+            paragraph("Phase 1: Planning"),
+            task_list(
+                task_item("Define requirements", checked=True),
+                task_item("Create wireframes", checked=True),
+                task_item("Review with stakeholders", checked=False)
+            ),
+            checked=True
+        ),
+        task_item(
+            paragraph("Phase 2: Development"),
+            task_list(
+                task_item("Setup project", checked=False),
+                task_item("Implement features", checked=False)
+            ),
+            checked=False
+        )
+    )
+]
+```
+
 ## Complete Example
 
 ```json
@@ -722,7 +880,7 @@ Lists can be nested within list items:
 Instead of manually constructing JSON, use the built-in helper functions:
 
 ```python
-from vaiz import heading, paragraph, text, bullet_list, blockquote, link_text, table, table_row, table_header
+from vaiz import heading, paragraph, text, bullet_list, task_list, task_item, blockquote, link_text, table, table_row, table_header
 
 content = [
     heading(1, "Project Documentation"),
@@ -738,6 +896,11 @@ content = [
         "Easy to use",
         "Type-safe"
     ),
+    heading(2, "Todo"),
+    task_list(
+        task_item("Review code", checked=True),
+        task_item("Deploy to production", checked=False)
+    ),
     blockquote(
         paragraph(
             text("Important: ", bold=True),
@@ -1091,6 +1254,8 @@ client.replace_json_document(document_id, content)
 | `bulletList` | Unordered list | `{"type": "bulletList", "content": [...]}` |
 | `orderedList` | Numbered list | `{"type": "orderedList", "content": [...]}` |
 | `listItem` | List item | `{"type": "listItem", "content": [...]}` |
+| `taskList` | Checklist with checkable items | `{"type": "taskList", "attrs": {"uid": "..."}, "content": [...]}` |
+| `taskItem` | Checklist item with checkbox | `{"type": "taskItem", "attrs": {"checked": false}, "content": [...]}` |
 | `blockquote` | Blockquote for quotes/callouts | `{"type": "blockquote", "content": [...]}` |
 | `details` | Collapsible section | `{"type": "details", "content": [...]}` |
 | `extension-table` | Table with rows | `{"type": "extension-table", "attrs": {"uid": "..."}, "content": [...]}` |

docs-site/docusaurus.config.ts

@@ -206,8 +206,8 @@ const config: Config = {
       },
       items: [
         {
-          label: "v0.14.0",
-          href: "https://pypi.org/project/vaiz-sdk/0.14.0/",
+          label: "v0.15.0",
+          href: "https://pypi.org/project/vaiz-sdk/0.15.0/",
           position: "left",
         },
         {