Add PageBreak element to AST and all renderers

Introduces a PageBreak block element that forces a new page in the
rendered output. Supported in PDF (add_page), DOCX (add_page_break),
and HTML (hr with page-break-after style). Added to example.

https://claude.ai/code/session_01SxvyLgUV2FUhsqyEzrPq5Q

Author: claude

example.docx

@@ -104,6 +104,7 @@ <h2>
 					</dd>
 				</dl>
 			</section>
+			<hr style="page-break-after: always;">
 			<section>
 				<h2>
 					<span>A table</span>

example.html

@@ -2,7 +2,7 @@
 import io
 
 from red_tape_kit.ast import (
-    Attachment, Document, InlineSequence, Section, Strong, Table, TableCellSpan, Text, UnorderedList,
+    Attachment, Document, InlineSequence, PageBreak, Section, Strong, Table, TableCellSpan, Text, UnorderedList,
 )
 
 
@@ -68,6 +68,9 @@
 ))
 
 
+doc.body.append(PageBreak())
+
+
 doc.body.append(Section(
     title='A table',
     body=[

example.pdf

@@ -196,6 +196,11 @@ def normalized(self) -> 'DefinitionList':
         )
 
 
+class PageBreak(BlockElement):
+    def normalized(self) -> 'PageBreak':
+        return self
+
+
 @dataclass
 class Image(BlockElement):
     image_io: BinaryIO

example.py

@@ -5,7 +5,7 @@
 from docx.oxml.ns import qn
 from docx.oxml.shared import OxmlElement
 
-from .ast import DefinitionList, Image, Paragraph, Section, Sequence, Table, TableCellSpan, UnorderedList
+from .ast import DefinitionList, Image, PageBreak, Paragraph, Section, Sequence, Table, TableCellSpan, UnorderedList
 
 
 class DOCXRenderer:
@@ -84,6 +84,8 @@ def add_element(self, element, section_level=None, list_level=None, first_in_lis
             self.add_sequence(element, section_level, list_level, first_in_list_item)
         elif isinstance(element, Image):
             self.add_image(element)
+        elif isinstance(element, PageBreak):
+            self.add_page_break()
         else:
             raise ValueError(f'Unknown element type {element}')
 
@@ -92,6 +94,9 @@ def add_sequence(self, sequence, section_level, list_level, first_in_list_item):
             self.add_element(sub_element, section_level, list_level, first_in_list_item)
             first_in_list_item = False
 
+    def add_page_break(self):
+        self.docx.add_page_break()
+
     def add_section(self, section, section_level):
         self.docx.add_heading(section.title.plain_string, section_level)
         self.add_element(section.body, section_level + 1)

red_tape_kit/ast.py

@@ -2,8 +2,8 @@
 from base64 import b64encode
 
 from .ast import (
-    Attachment, DefinitionList, Image, InlineSequence, Paragraph, Section, Sequence, Strong, Table, TableCellSpan,
-    Text, UnorderedList,
+    Attachment, DefinitionList, Image, InlineSequence, PageBreak, Paragraph, Section, Sequence, Strong, Table,
+    TableCellSpan, Text, UnorderedList,
 )
 
 
@@ -55,6 +55,8 @@ def add_element(self, html_el, element, heading_level):
             self.add_sequence(html_el, element, heading_level)
         elif isinstance(element, Image):
             self.add_image(html_el, element)
+        elif isinstance(element, PageBreak):
+            ET.SubElement(html_el, 'hr', style='page-break-after: always;')
         else:
             raise ValueError(f'Unknown element type {type(element)}')
 

red_tape_kit/docx.py

@@ -5,8 +5,8 @@
 from fpdf.syntax import DestinationXYZ
 
 from .ast import (
-    Attachment, DefinitionList, Image, InlineSequence, Paragraph, Section, Sequence, Strong, Table, TableCellSpan,
-    Text, UnorderedList,
+    Attachment, DefinitionList, Image, InlineSequence, PageBreak, Paragraph, Section, Sequence, Strong, Table,
+    TableCellSpan, Text, UnorderedList,
 )
 
 
@@ -113,6 +113,8 @@ def add_element(self, element, level):
             return self.add_sequence(element, level)
         elif isinstance(element, Image):
             return self.add_image(element)
+        elif isinstance(element, PageBreak):
+            return self.add_page_break()
         else:
             raise ValueError(f'Unknown element type {element}')
 
@@ -202,6 +204,10 @@ def add_definition_list(self, definition_list):
         self.add_element(UnorderedList(list_items), level=None)
         return True
 
+    def add_page_break(self):
+        self.add_page()
+        return False
+
     def add_image(self, image):
         self.image(image.image_io, w=100)
         return True