From 9a0f41c03e80c9440e681e9d6e5dbd79dd3f19fa Mon Sep 17 00:00:00 2001
From: DemchaAV <demchaav@gmail.com>
Date: Sun, 7 Jun 2026 13:33:08 +0100
Subject: [PATCH] build(japicmp): exclude internal layout.payloads from the
 binary-compat gate

The document.layout.payloads package is internal layout->render handoff plumbing: its records carry engine-internal types (TextStyle, Padding, ...) and evolve with rendering features. ParagraphFragmentPayload gained a verticalAlign component in 1.7.0 (9e25006d), changing its canonical record constructor -> japicmp flagged CONSTRUCTOR_REMOVED on every develop PR. These types are not part of the canonical public API (document.api/dsl/node/style) and carry no binary-compat promise, so exclude the package from the gate.

Also corrects the CI job label "vs v1.6.8" -> "vs v1.6.9" (the pom baseline japicmp.baseline is already v1.6.9; the label was stale). Verified locally: ./mvnw -DskipTests -P japicmp verify -pl . -> BUILD SUCCESS.
---
 .github/workflows/ci.yml |  2 +-
 pom.xml                  | 11 +++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a3f2e4f3..a6d07349 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -147,7 +147,7 @@ jobs:
         run: ./mvnw -B -ntp test -pl . -P no-poi
 
   binary-compat:
-    name: Binary Compatibility (japicmp vs v1.6.8)
+    name: Binary Compatibility (japicmp vs v1.6.9)
     if: github.event_name == 'pull_request'
     needs: architecture-and-documentation-guards
     runs-on: ubuntu-latest
diff --git a/pom.xml b/pom.xml
index 2fa085c8..fc5cfafa 100644
--- a/pom.xml
+++ b/pom.xml
@@ -682,6 +682,17 @@
                                 <includeSynthetic>false</includeSynthetic>
                                 <reportOnlyFilename>true</reportOnlyFilename>
                                 <skipPomModules>true</skipPomModules>
+                                <!--
+                                    Internal layout->render handoff DTOs. These records carry
+                                    engine-internal types (TextStyle, Padding, ...) and evolve
+                                    with rendering features (e.g. ParagraphFragmentPayload gained
+                                    verticalAlign in 1.7.0). They are not part of the canonical
+                                    public API (document.api/dsl/node/style) and carry no
+                                    binary-compatibility promise, so they are excluded from the gate.
+                                -->
+                                <excludes>
+                                    <exclude>com.demcha.compose.document.layout.payloads</exclude>
+                                </excludes>
                             </parameter>
                         </configuration>
                     </plugin>