chore(api): close v1.9.0 engine-leak guard and metadata gaps (#253)

* test(api): extend the engine-leak guard to all public document.* packages

PublicApiNoEngineLeakTest pinned only eight document.* packages, while
output, snapshot, theme, exceptions, and emoji are equally public and must
stay free of com.demcha.compose.engine.* imports. Add all five to
PUBLIC_API_ROOTS; each is already engine-clean so the guard passes and
locks the property in. Engine-adjacent internals (layout, backend,
templates, debug) stay excluded by design.

* docs(api): complete v1.9.0 since/deprecation metadata and date-ready CHANGELOG

- DocumentSession.pageMargins(List<PageMarginRule>) gains @SInCE 1.9.0,
  matching its sibling 1.9.0 methods (viewerPreferences, pageIndex, toImage).
- HeadlineRenderer / ContactRenderer / BannerRenderer become
  @deprecated(since = "1.9.0", forRemoval = true) with the @deprecated Javadoc
  leading "since 1.9.0; removed in 2.0.", matching CoverLetterTemplate and the
  api-stability deprecation ledger.
- CHANGELOG in-progress header "v1.9.0 - unreleased" -> "v1.9.0 - Planned" so
  the release tooling rewrites it to the ISO date at cut time.

Author: DemchaAV

CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to GraphCompose are documented here. Versions
 follow semantic versioning; release dates are ISO 8601.
 
-## v1.9.0 — unreleased
+## v1.9.0 — Planned
 
 In-document navigation. Rendered PDFs can now declare named **anchors** and
 **internal links** that jump to them — clickable tables of contents,

src/main/java/com/demcha/compose/document/api/DocumentSession.java

@@ -475,6 +475,7 @@ public DocumentSession pageBackgrounds(List<PageBackgroundFill> fills) {
      * @param rules ordered list of per-page margin overrides, or {@code null}/empty to clear
      * @return this session
      * @throws IllegalStateException if this session has already been closed
+     * @since 1.9.0
      */
     public DocumentSession pageMargins(List<PageMarginRule> rules) {
         ensureOpen();

src/main/java/com/demcha/compose/document/templates/cv/v2/components/BannerRenderer.java

@@ -5,15 +5,15 @@
 import com.demcha.compose.document.templates.cv.v2.widgets.SectionHeader;
 
 /**
- * @deprecated Use
+ * @deprecated since 1.9.0; removed in 2.0. Use
  * {@link com.demcha.compose.document.templates.cv.v2.widgets.SectionHeader#banner}
  * instead — the widget groups the banner alongside its sibling
  * variants ({@code underlined}, {@code flat}) so picking a section-
  * title style becomes one choice in one place. Kept as a thin
  * delegating shim so v2 code written before the widgets layer keeps
  * compiling unchanged.
  */
-@Deprecated(forRemoval = true)
+@Deprecated(since = "1.9.0", forRemoval = true)
 public final class BannerRenderer {
 
     private BannerRenderer() {

src/main/java/com/demcha/compose/document/templates/cv/v2/components/ContactRenderer.java

@@ -6,14 +6,14 @@
 import com.demcha.compose.document.templates.cv.v2.widgets.ContactLine;
 
 /**
- * @deprecated Use
+ * @deprecated since 1.9.0; removed in 2.0. Use
  * {@link com.demcha.compose.document.templates.cv.v2.widgets.ContactLine#centered}
  * instead — the widget gives you named centred/right-aligned
  * variants plus a configurable field order. Kept as a thin
  * delegating shim so v2 code written before the widgets layer keeps
  * compiling unchanged.
  */
-@Deprecated(forRemoval = true)
+@Deprecated(since = "1.9.0", forRemoval = true)
 public final class ContactRenderer {
 
     private ContactRenderer() {

src/main/java/com/demcha/compose/document/templates/cv/v2/components/HeadlineRenderer.java

@@ -6,14 +6,14 @@
 import com.demcha.compose.document.templates.cv.v2.widgets.Headline;
 
 /**
- * @deprecated Use
+ * @deprecated since 1.9.0; removed in 2.0. Use
  * {@link com.demcha.compose.document.templates.cv.v2.widgets.Headline#spacedCentered}
  * instead — the widget gives you a named API plus alignment +
  * spaced-caps variants, while this class only ever did the
  * centred-spaced-caps form. Kept as a thin delegating shim so v2
  * code written before the widgets layer keeps compiling unchanged.
  */
-@Deprecated(forRemoval = true)
+@Deprecated(since = "1.9.0", forRemoval = true)
 public final class HeadlineRenderer {
 
     private HeadlineRenderer() {

src/test/java/com/demcha/documentation/PublicApiNoEngineLeakTest.java

@@ -41,6 +41,11 @@ class PublicApiNoEngineLeakTest {
             PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/style"),
             PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/table"),
             PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/image"),
+            PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/output"),
+            PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/snapshot"),
+            PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/theme"),
+            PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/exceptions"),
+            PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/document/emoji"),
             PROJECT_ROOT.resolve("src/main/java/com/demcha/compose/font"));
 
     /**