Merge develop (v1.9.0 line) into 2.0-dev

.gitignore

@@ -50,6 +50,10 @@ benchmarks/logs/
 # preview PDFs (hello/invoice/cv) bundled with site/public/previews/.
 !site/public/showcase/**/*.pdf
 !site/public/previews/*.pdf
+# Same whitelist for the live GitHub Pages showcase under web/. The showcase
+# moved out of docs/ into web/ but this list was not updated, so every newly
+# added example PDF was silently ignored and 404'd on the deployed site.
+!web/showcase/**/*.pdf
 /patch-root-position.diff
 /rectangle.pdf
 /Test.pdf

docs/first-document.md

@@ -12,6 +12,7 @@ with a page flow, and render. No coordinates, no manual page breaks.
 Open a session for a file path, add one page flow, render. The engine handles
 placement and pagination.
 
+<!-- doc-example: id=first-document-smallest mode=method -->
 ```java
 import com.demcha.compose.GraphCompose;
 import com.demcha.compose.document.api.DocumentPageSize;
@@ -41,6 +42,7 @@ modules, sections, paragraphs, lists, tables, and rows are added top to bottom.
 The same Flow model scales to a multi-section document. There are still no
 coordinates and no manual page breaks — just structure in reading order.
 
+<!-- doc-example: id=first-document-custom mode=method -->
 ```java
 import com.demcha.compose.GraphCompose;
 import com.demcha.compose.document.api.DocumentPageSize;

docs/templates/business-templates.md

@@ -30,6 +30,7 @@ decides file vs stream vs bytes. The caller does.
 
 ## Invoice
 
+<!-- doc-example: id=business-invoice mode=method -->
 ```java
 import com.demcha.compose.GraphCompose;
 import com.demcha.compose.document.api.DocumentPageSize;
@@ -91,6 +92,7 @@ Same shape, different spec. Use a proposal when the artifact is sales or
 project scope rather than billing. The timeline takes a three-argument
 `timelineItem(phase, duration, details)`.
 
+<!-- doc-example: id=business-proposal mode=method -->
 ```java
 import com.demcha.compose.GraphCompose;
 import com.demcha.compose.document.api.DocumentPageSize;
@@ -147,6 +149,7 @@ document is streamed to the caller's stream. The template composes the
 same way before any output method; create one session per request.
 `create()` without arguments uses the family's default theme.
 
+<!-- doc-example: id=business-stream mode=members -->
 ```java
 import com.demcha.compose.GraphCompose;
 import com.demcha.compose.document.api.DocumentSession;