From c5b0245d36dd65ad495f36617688d7e5bacbf5b1 Mon Sep 17 00:00:00 2001
From: DemchaAV <demchaav@gmail.com>
Date: Wed, 3 Jun 2026 10:10:52 +0100
Subject: [PATCH] ci(javadoc): validate public testing.* helpers under strict
 doclint (Track N N5)

Widen the maven-javadoc-plugin validation <subpackages> from com.demcha.compose.document to also include com.demcha.compose.testing, so the public testing-support helpers (testing.layout + testing.visual, @since 1.6.9) get the same doclint=all / failOnError gate as the canonical document API.

javadoc:javadoc BUILD SUCCESS; testing.* now documented and doclint-clean (pre-existing document.* template warnings unchanged). No artifact or behaviour change.
---
 CHANGELOG.md | 7 +++++++
 pom.xml      | 4 ++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2c6ee043..1545fd1c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -29,6 +29,13 @@ Housekeeping cycle plus the public pixel-level visual-regression API (Track N).
   baseline layout, and cross-platform tolerance calibration.
 - README "Which API should I use?" gains a pixel-level visual-regression row.
 
+### Build
+
+- CI Javadoc validation (`maven-javadoc-plugin`, `doclint=all`) now covers the
+  public `com.demcha.compose.testing.*` helpers (`testing.layout` + `testing.visual`)
+  in addition to the canonical `document` API, so Javadoc regressions on the
+  testing surface fail fast in CI. No artifact or behaviour change.
+
 ## v1.6.8 — 2026-06-01
 
 **CV v2 migration completion + design-token expansion.** v1.6.8
diff --git a/pom.xml b/pom.xml
index 033616cf..28b7ef6f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -434,7 +434,7 @@
                 </executions>
             </plugin>
 
-            <!-- Canonical API Javadoc validation -->
+            <!-- Public API Javadoc validation: canonical document API + public testing-support helpers (testing.layout / testing.visual) -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>
@@ -444,7 +444,7 @@
                     <failOnError>true</failOnError>
                     <show>public</show>
                     <quiet>true</quiet>
-                    <subpackages>com.demcha.compose.document</subpackages>
+                    <subpackages>com.demcha.compose.document:com.demcha.compose.testing</subpackages>
                 </configuration>
             </plugin>
         </plugins>