Release v1.5.1

Maintenance patch on the v1.5 line.

- PDFBox bumped 3.0.5 → 3.0.7.
- ShapeContainerVisualRegressionTest tolerates cross-platform PDF
  font drift between Windows-rendered baselines and the Linux CI
  runner via a calibrated mismatchedPixelBudget.
- DocumentationCoverageTest scans the whole README for canonical-DSL
  coverage instead of pinning to the structural anchors that the
  v1.5.0 README slim removed.

No public API changes; v1.5.0 consumers can upgrade with no code
changes.

Author: DemchaAV

CHANGELOG.md

@@ -69,6 +69,30 @@ for the phased plan, verification gates, and ADRs.
 
 ---
 
+## v1.5.1 — 2026-05-05
+
+### Dependencies
+
+- **PDFBox 3.0.7.** Bumped from 3.0.5 to 3.0.7 (Apache PDFBox patch
+  release with upstream rendering and security fixes). No
+  public-API impact for GraphCompose consumers.
+
+### Tooling
+
+- `ShapeContainerVisualRegressionTest` tolerates the cross-platform
+  PDF font-rendering drift that surfaces between Windows-rendered
+  baselines and the Linux CI runner (~1-2% pixel diff), via a
+  calibrated `mismatchedPixelBudget` instead of bit-exact comparison.
+- `DocumentationCoverageTest` no longer pins to the structural
+  section anchors that the v1.5.0 README slim removed; the guard now
+  scans the whole README for canonical-DSL coverage and
+  legacy-API leakage in one whole-file pass.
+
+This is a maintenance patch release. There are no public API
+changes; v1.5.0 consumers can upgrade with no code changes.
+
+---
+
 ## v1.5.0 — 2026-05-04
 
 ### Headline — "intuitive"

README.md

@@ -29,7 +29,7 @@ Most Java PDF libraries hand you low-level drawing commands. GraphCompose gives
 - **PDFBox rendering, isolated.** PDF backend lives behind a single backend interface. The DOCX backend (Apache POI) is ready for callers who need an editable file.
 - **Tested at every layer.** 672 green tests on `develop` (525 → 672 across v1.5), including cinematic-feature tests, shape-as-container clip-path invariants, transform CTM checks, table row-span / zebra / repeated-header tests, public-API leak guards, and a `PdfVisualRegression` harness.
 
-The current release is **v1.5.0** — the "intuitive" release. v1.5 turns the surface intuitive: shape-as-container with clip path, rotate / scale + per-layer z-index, advanced tables (row span, zebra, totals, repeating header), and two new theme-driven cinematic templates (`InvoiceTemplateV2`, `ProposalTemplateV2`). v1.5 is fully source-compatible with v1.4 — every public record gained back-compat constructors that default the new fields. See [`docs/migration-v1-4-to-v1-5.md`](docs/migration-v1-4-to-v1-5.md).
+The current release is **v1.5.1** — the "intuitive" release. v1.5 turns the surface intuitive: shape-as-container with clip path, rotate / scale + per-layer z-index, advanced tables (row span, zebra, totals, repeating header), and two new theme-driven cinematic templates (`InvoiceTemplateV2`, `ProposalTemplateV2`). v1.5 is fully source-compatible with v1.4 — every public record gained back-compat constructors that default the new fields. See [`docs/migration-v1-4-to-v1-5.md`](docs/migration-v1-4-to-v1-5.md).
 
 ## Who is GraphCompose for?
 
@@ -65,13 +65,13 @@ Distributed through JitPack.
 <dependency>
     <groupId>com.github.DemchaAV</groupId>
     <artifactId>GraphCompose</artifactId>
-    <version>v1.5.0</version>
+    <version>v1.5.1</version>
 </dependency>
 ```
 
 ```kotlin
 repositories { maven("https://jitpack.io") }
-dependencies { implementation("com.github.demchaav:GraphCompose:v1.5.0") }
+dependencies { implementation("com.github.demchaav:GraphCompose:v1.5.1") }
 ```
 
 The DOCX backend depends on `org.apache.poi:poi-ooxml`, declared as `optional` &mdash; add it explicitly when you call `session.export(new DocxSemanticBackend())`.

examples/pom.xml

@@ -6,12 +6,12 @@
 
     <groupId>io.github.demchaav</groupId>
     <artifactId>graphcompose-examples</artifactId>
-    <version>1.5.0</version>
+    <version>1.5.1</version>
     <name>GraphCompose Examples</name>
     <description>Runnable file-render examples for GraphCompose templates.</description>
 
     <properties>
-        <graphcompose.version>1.5.0</graphcompose.version>
+        <graphcompose.version>1.5.1</graphcompose.version>
         <logback.version>1.5.18</logback.version>
         <maven.compiler.release>21</maven.compiler.release>
     </properties>

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>io.github.demchaav</groupId>
     <artifactId>graphcompose</artifactId>
-    <version>1.5.0</version>
+    <version>1.5.1</version>
 
     <name>GraphCompose</name>
     <description>A declarative layout engine for programmatic document generation, implemented primarily in Java.</description>