more examples

examples/README.md

@@ -101,6 +101,81 @@ Demonstrates:
 
 ![Functional Elements Example](../docs/images/example_06_functional_elements.png)
 
+---
+
+## 🆕 New Examples (2024-11)
+
+These examples address critical coverage gaps and demonstrate advanced features:
+
+### 08. Pagination with PageBreak (NEW) ✅
+**`08_pagination_demo.py`** - Multi-page documents with explicit and automatic pagination
+
+```bash
+python 08_pagination_demo.py
+```
+
+**Test Coverage:** [tests/examples/test_08_pagination_demo.py](../tests/examples/test_08_pagination_demo.py) - 11 tests
+
+Demonstrates:
+- Using `PageBreak` to force content onto new pages
+- Multi-page document layout with explicit breaks
+- Automatic pagination when content overflows
+- Page numbering functionality
+- Document flow control
+- Combining pages into vertical strips
+
+**Coverage Impact:** Fills critical gap - PageBreak layouter had NO examples before this!
+
+![Pagination Example](../docs/images/example_08_pagination_explicit.png)
+
+### 09. Link Navigation (NEW) ✅
+**`09_link_navigation_demo.py`** - All link types and interactive navigation
+
+```bash
+python 09_link_navigation_demo.py
+```
+
+**Test Coverage:** [tests/examples/test_09_link_navigation_demo.py](../tests/examples/test_09_link_navigation_demo.py) - 10 tests
+
+Demonstrates:
+- **Internal links** - Document navigation (`#section1`, `#section2`)
+- **External links** - Web URLs (`https://example.com`)
+- **API links** - API endpoints (`/api/settings`, `/api/save`)
+- **Function links** - Direct function calls (`calculate()`, `process()`)
+- Link styling (underlined, color-coded by type)
+- Link callbacks and interactivity
+- Mixed text and link paragraphs
+
+**Coverage Impact:** Comprehensive - All 4 LinkType variations demonstrated!
+
+![Link Navigation Example](../docs/images/example_09_link_navigation.png)
+
+### 10. Comprehensive Forms (NEW) ✅
+**`10_forms_demo.py`** - All 14 form field types with validation
+
+```bash
+python 10_forms_demo.py
+```
+
+**Test Coverage:** [tests/examples/test_10_forms_demo.py](../tests/examples/test_10_forms_demo.py) - 9 tests
+
+Demonstrates all 14 FormFieldType variations:
+
+**Text-Based Fields:**
+- TEXT, EMAIL, PASSWORD, URL, TEXTAREA
+
+**Number/Date/Time Fields:**
+- NUMBER, DATE, TIME, RANGE, COLOR
+
+**Selection Fields:**
+- CHECKBOX, RADIO, SELECT, HIDDEN
+
+**Coverage Impact:** Complete - All 14 field types across 4 practical form examples!
+
+![Comprehensive Forms Example](../docs/images/example_10_forms.png)
+
+---
+
 ## Advanced Examples
 
 ### HTML Rendering
@@ -119,21 +194,46 @@ All examples can be run directly from the examples directory:
 
 ```bash
 cd examples
+
+# Getting Started
 python 01_simple_page_rendering.py
 python 02_text_and_layout.py
 python 03_page_layouts.py
 python 04_table_rendering.py
 python 05_table_with_images.py
 python 06_functional_elements_demo.py
+
+# NEW: Advanced Features
+python 08_pagination_demo.py       # Multi-page documents
+python 09_link_navigation_demo.py  # All link types
+python 10_forms_demo.py            # All form field types
 ```
 
 Output images are saved to the `docs/images/` directory.
 
+### Running Tests
+
+All new examples (08, 09, 10) include comprehensive test coverage:
+
+```bash
+# Run all example tests
+python -m pytest tests/examples/ -v
+
+# Run specific test file
+python -m pytest tests/examples/test_08_pagination_demo.py -v
+python -m pytest tests/examples/test_09_link_navigation_demo.py -v
+python -m pytest tests/examples/test_10_forms_demo.py -v
+```
+
+**Total Test Coverage:** 30 tests (11 + 10 + 9), all passing ✅
+
 ## Additional Documentation
 
 - `README_HTML_MULTIPAGE.md` - HTML multi-page rendering guide
+- `../docs/NEW_EXAMPLES_AND_TESTS_SUMMARY.md` - Detailed summary of new examples (08, 09, 10)
 - `../ARCHITECTURE.md` - Detailed explanation of the Abstract/Concrete architecture
 - `../docs/images/` - Rendered example outputs
+- `../docs/images/README.md` - Visual documentation index
 
 ## Debug/Development Scripts