Release v0.14.0: Add navigation blocks (TOC, Anchors, Siblings) and code blocks

- Add toc_block() for automatic table of contents
- Add anchors_block() for related documents and backlinks
- Add siblings_block() for same-level document navigation
- Add code_block() for syntax-highlighted code snippets
- Headings now auto-generate UIDs for TOC navigation
- Add 17 comprehensive tests
- Add examples: document_navigation_blocks.py, document_with_code_blocks.py
- Update documentation (guides and API reference)
- All code in English per project standards

Author: m-brtn

CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## [0.14.0] - 2025-10-24
+
+### Added
+
+- **📑 TOC Block**: Automatic table of contents generation
+  - `toc_block()` - Creates interactive document outline
+  - Automatically indexes all headings (h1-h6)
+  - Clickable navigation links to document sections
+  - Auto-updates when document content changes
+
+- **🔗 Anchors Block**: Related documents and backlinks
+  - `anchors_block()` - Displays document relationships
+  - Shows documents that this document links to
+  - Shows backlinks (documents linking to this one)
+  - Visualizes knowledge graph connections
+
+- **📄 Siblings Block**: Same-level document navigation
+  - `siblings_block()` - Shows sibling documents
+  - Displays documents in same folder/collection
+  - Helps navigate series of related pages
+  - Useful for guides and tutorials
+
+- **💻 Code Block**: Syntax-highlighted code snippets
+  - `code_block(code, language)` - Display code with highlighting
+  - Support for Python, JavaScript, TypeScript, Java, C++, Go, Rust, SQL, Bash, and many more
+  - Multiline code support
+  - Optional language specification
+
+### Changed
+
+- **🔧 Headings now auto-generate UIDs**: All headings created with `heading()` now automatically get unique IDs for TOC navigation support
+  - UIDs are 12-character alphanumeric strings (e.g., "sEeaN9ddIDsL")
+  - Required for TOC block to create working navigation links
+  - No breaking changes - UIDs added automatically
+
+---
+
 ## [0.13.0] - 2025-10-23
 
 ### Changed

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

@@ -881,17 +881,22 @@ milestone_id = milestones.milestones[0].id
 |-----------|-------------|---------|
 | `text` | Text content with optional marks | `{"type": "text", "text": "..."}` |
 | `paragraph` | Paragraph block | `{"type": "paragraph", "content": [...]}` |
-| `heading` | Heading (H1-H6) | `{"type": "heading", "attrs": {"level": 1}}` |
+| `heading` | Heading (H1-H6) with UID | `{"type": "heading", "attrs": {"level": 1, "uid": "..."}}` |
 | `bulletList` | Unordered list | `{"type": "bulletList", "content": [...]}` |
 | `orderedList` | Numbered list | `{"type": "orderedList", "content": [...]}` |
 | `listItem` | List item | `{"type": "listItem", "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": [...]}` |
 | `tableRow` | Table row with cells/headers | `{"type": "tableRow", "attrs": {"showRowNumbers": false}, "content": [...]}` |
 | `tableCell` | Table data cell | `{"type": "tableCell", "attrs": {"colspan": 1, "rowspan": 1}, "content": [...]}` |
 | `tableHeader` | Table header cell (th) | `{"type": "tableHeader", "attrs": {"colspan": 1, "rowspan": 1}, "content": [...]}` |
 | `horizontalRule` | Horizontal divider line | `{"type": "horizontalRule"}` |
 | `custom-mention` | Mention user/doc/task/milestone | `{"type": "custom-mention", "attrs": {"uid": "...", "custom": 1, "inline": true, "data": {"item": {"id": "...", "kind": "User"}}}}` |
+| `image-block` | Embedded image | `{"type": "image-block", "attrs": {"uid": "...", "custom": 1}, "content": [...]}` |
+| `files` | File attachments | `{"type": "files", "attrs": {"uid": "...", "custom": 1}, "content": [...]}` |
+| `doc-siblings` | Navigation blocks (TOC/Anchors/Siblings) | `{"type": "doc-siblings", "attrs": {"uid": "...", "custom": 1}, "content": [...]}` |
+| `codeBlock` | Code with syntax highlighting | `{"type": "codeBlock", "attrs": {"uid": "...", "language": "python"}, "content": [...]}` |
 
 ### Marks
 

docs-site/docs/guides/document-structure-helpers.md

@@ -655,18 +655,175 @@ content = [
 client.replace_json_document("document_id", content)
 ```
 
+## Navigation Blocks
+
+### TOC Block - Table of Contents
+
+Automatically generate a table of contents from all headings in the document:
+
+```python
+from vaiz import toc_block, heading, paragraph
+
+content = [
+    # Add TOC at the beginning
+    toc_block(),
+    
+    heading(1, "Introduction"),
+    paragraph("Welcome to our documentation"),
+    
+    heading(2, "Getting Started"),
+    paragraph("First steps..."),
+    
+    heading(2, "Advanced Topics"),
+    paragraph("Deep dive into features...")
+]
+
+client.replace_json_document(document_id, content)
+```
+
+**Features:**
+- Automatically indexes all headings (h1-h6)
+- Creates clickable navigation links
+- Shows hierarchical document structure
+- Updates automatically when content changes
+
+**Note:** Headings created with `heading()` automatically get unique IDs required for TOC navigation.
+
+### Anchors Block - Related Documents
+
+Display related documents and backlinks:
+
+```python
+from vaiz import anchors_block, heading, paragraph
+
+content = [
+    anchors_block(),  # Shows related documents
+    
+    heading(1, "Main Content"),
+    paragraph("Content here...")
+]
+
+client.replace_json_document(document_id, content)
+```
+
+**Shows:**
+- Documents that this document links to
+- Documents that link to this one (backlinks)
+- Related documents from the space
+- Knowledge graph connections
+
+### Siblings Block - Same-Level Documents
+
+Display documents at the same hierarchical level:
+
+```python
+from vaiz import siblings_block, heading, paragraph
+
+content = [
+    siblings_block(),  # Shows sibling documents
+    
+    heading(1, "Current Page"),
+    paragraph("Sibling pages shown above...")
+]
+
+client.replace_json_document(document_id, content)
+```
+
+**Useful for:**
+- Series of tutorial pages
+- Multi-part guides
+- Related documentation pages
+- Folder/collection navigation
+
+### Code Block - Syntax Highlighting
+
+Display code with syntax highlighting:
+
+```python
+from vaiz import code_block, heading, paragraph
+
+python_code = '''def hello():
+    print("Hello, World!")
+    return True'''
+
+content = [
+    heading(1, "Code Example"),
+    paragraph("Here's a Python function:"),
+    
+    code_block(
+        code=python_code,
+        language="python"
+    ),
+    
+    paragraph("This code demonstrates a simple function.")
+]
+
+client.replace_json_document(document_id, content)
+```
+
+**Supported Languages:**
+- Python, JavaScript, TypeScript, Java, C++, Go, Rust
+- SQL, JSON, YAML, XML, HTML, CSS
+- Bash, Shell, PowerShell
+- And 50+ more languages
+
+**Features:**
+- Syntax highlighting
+- Multiline code support
+- Optional language specification
+- Automatic formatting
+
+### Complete Navigation Example
+
+Combine all navigation blocks:
+
+```python
+from vaiz import (
+    toc_block, anchors_block, siblings_block,
+    heading, paragraph, code_block, bullet_list
+)
+
+content = [
+    # All navigation blocks at the top
+    toc_block(),
+    anchors_block(),
+    siblings_block(),
+    
+    # Main content
+    heading(1, "API Documentation"),
+    
+    paragraph("This guide explains how to use our API."),
+    
+    heading(2, "Authentication"),
+    bullet_list(
+        "Get API key from settings",
+        "Set environment variable",
+        "Initialize client"
+    ),
+    
+    heading(2, "Example"),
+    code_block(
+        code='client = VaizClient(api_key="...")',
+        language="python"
+    )
+]
+
+client.replace_json_document(document_id, content)
+```
+
 ## Supported Elements
 
 All helper functions create nodes compatible with the document editor:
 
 ### Nodes
 - ✅ `text()` - Text with formatting marks
 - ✅ `paragraph()` - Paragraph blocks
-- ✅ `heading(level)` - Headings (H1-H6)
+- ✅ `heading(level)` - Headings (H1-H6) with automatic UID
 - ✅ `bullet_list()` - Unordered lists
 - ✅ `ordered_list()` - Numbered lists
 - ✅ `list_item()` - List items with content
 - ✅ `blockquote()` - Blockquotes for quotes and callouts
+- ✅ `details()` - Collapsible sections
 - ✅ `table()` - Tables with rows and cells
 - ✅ `table_row()` - Table row
 - ✅ `table_cell()` - Table cell (use for both data and headers)
@@ -676,6 +833,14 @@ All helper functions create nodes compatible with the document editor:
 - ✅ `mention_task()` - Reference a task
 - ✅ `mention_milestone()` - Reference a milestone
 - ✅ `mention(id, kind)` - Generic mention
+- ✅ `image_block()` - Embed images
+- ✅ `files_block()` - Attach files
+
+### Navigation & Special Blocks
+- ✅ `toc_block()` - Automatic table of contents
+- ✅ `anchors_block()` - Related documents and backlinks
+- ✅ `siblings_block()` - Same-level documents navigation
+- ✅ `code_block()` - Code with syntax highlighting
 
 ### Marks (Formatting)
 - ✅ `bold=True` - Bold text

docs-site/docs/patterns/ready-to-run.md

@@ -45,6 +45,8 @@ The SDK includes a collection of ready-to-run examples in the [`/examples`](http
 - **`advanced_document_workflows.py`** - Complex document scenarios
 - **`mention_blocks.py`** - Create documents with user, task, document, and milestone mentions
 - **`advanced_mention_usage.py`** - Advanced usage of mentions in tables, lists, and complex documents
+- **`document_navigation_blocks.py`** - TOC, Anchors, and Siblings navigation blocks
+- **`document_with_code_blocks.py`** - Code blocks with syntax highlighting
 
 ## Custom Fields
 

docs-site/docusaurus.config.ts

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