experiencePage2 = experienceEntries.stream()
.skip(EXPERIENCE_PAGE_ONE).toList();
- document.dsl()
+ PageFlowBuilder flow = document.dsl()
.pageFlow()
.name("CvV2MintEditorialRoot")
.spacing(theme.spacing().pageFlowSpacing())
.addSection("CvV2MintEditorialHeader",
- section -> addHeader(section, identity))
- .addLine(line -> line
- .name("CvV2MintEditorialHeaderRule")
- .horizontal(pageWidth)
- .color(accent)
- .thickness(theme.spacing().accentRuleWidth())
- .margin(new DocumentInsets(8, -ruleBleed, 14, -ruleBleed)))
+ section -> addHeader(section, identity, pageWidth, ruleBleed));
+ if (headerBandColor == null) {
+ // Stock masthead rule, full page width. When a band is present
+ // the rule is drawn flush at the band's bottom edge inside the
+ // header canvas instead (see addBandedHeader), so the separate
+ // flow rule is suppressed to avoid a doubled line.
+ flow.addLine(line -> line
+ .name("CvV2MintEditorialHeaderRule")
+ .horizontal(pageWidth)
+ .color(ruleColor)
+ .thickness(theme.spacing().accentRuleWidth())
+ .margin(new DocumentInsets(8, -ruleBleed, 14, -ruleBleed)));
+ }
+ flow
.addRow("CvV2MintEditorialPageOne", row -> {
row.spacing(COLUMN_GAP).weights(SIDEBAR_WEIGHT, MAIN_WEIGHT);
row.addSection("CvV2MintEditorialPageOneSidebar", sidebar -> {
@@ -314,17 +458,121 @@ public void compose(DocumentSession document, CvDocument doc) {
// -- Header --------------------------------------------------------
- private void addHeader(SectionBuilder section, CvIdentity identity) {
- // Headline.spacedCentered sets the section's spacing + padding;
- // it renders the centred spaced-caps name as the page's loudest
- // element. The tagline follows in the mint accent.
- Headline.spacedCentered(section, identity.name(), theme);
+ private void addHeader(SectionBuilder section, CvIdentity identity,
+ double pageWidth, double ruleBleed) {
+ if (headerBandColor != null) {
+ addBandedHeader(section, identity, pageWidth, ruleBleed);
+ } else {
+ addPlainHeader(section, identity);
+ }
+ }
+
+ /**
+ * Stock masthead: centred spaced-caps name (in {@code nameColor}) over
+ * a centred accent tagline, no background band. When
+ * {@code nameColor == theme.palette().ink()} the explicit style equals
+ * {@code theme.headlineStyle()}, so the default render is byte-identical
+ * to the pre-Options output.
+ */
+ private void addPlainHeader(SectionBuilder section, CvIdentity identity) {
+ // Render the name through Headline's style-override variant so only
+ // the colour can change — alignment, spaced-caps transform, font and
+ // size all stay exactly as Headline.spacedCentered produced them.
+ Headline.render(section, identity.name(), theme,
+ TextAlign.CENTER, true, mastheadNameStyle());
String jobTitle = identity.jobTitle();
if (jobTitle != null && !jobTitle.isBlank()) {
Subheadline.centeredSpacedCaps(section, jobTitle, taglineStyle());
}
}
+ /**
+ * Banded masthead (page 1 only): the whole masthead zone is one
+ * {@code CanvasLayerNode} (controlled absolute placement, the v1.6
+ * free-canvas primitive) with {@link ClipPolicy#OVERFLOW_VISIBLE}. The
+ * canvas reserves only {@value #MASTHEAD_CANVAS_HEIGHT}pt in the flow —
+ * its declared height — so the masthead footprint stays small and the
+ * dense page-1 row still fits, keeping the document at two pages.
+ *
+ * Inside the canvas (origin top-left, y down):
+ *
+ * - the band rectangle is positioned at {@code (-ruleBleed,
+ * -ruleBleed)} and sized {@code pageWidth × (ruleBleed +
+ * canvasHeight)}, so — because overflow is visible — it bleeds up
+ * to the top page edge, out to both side edges (full width), and
+ * down to the canvas bottom;
+ * - a thin rule sits flush at the band's bottom edge, reading as the
+ * band's underline (the separate flow rule is suppressed in this
+ * mode, see {@code compose});
+ * - the centred name (in {@code nameColor}) and tagline (in
+ * {@code accentColor}) render on top.
+ *
+ *
+ * The band consumes no extra flow height because the canvas footprint
+ * is fixed and the overflow draws outside it. Page 2 is untouched: the
+ * header canvas is the first page-flow child, so it lives on page 1
+ * only — no {@code pageBackgrounds} (which would repeat on page 2).
+ */
+ private void addBandedHeader(SectionBuilder section, CvIdentity identity,
+ double pageWidth, double ruleBleed) {
+ double canvasH = MASTHEAD_CANVAS_HEIGHT;
+ double ruleThickness = theme.spacing().accentRuleWidth();
+ // Band runs from the top page edge down to the rule's bottom edge.
+ double bandHeight = MASTHEAD_RULE_Y + ruleThickness;
+
+ // The masthead (name / tagline / rule) is positioned at the EXACT
+ // default flow coordinates, so the banded and bandless renders share
+ // identical masthead geometry — only the tan fill behind it is new.
+ // The band fills the canvas from y=0 to the rule bottom; no child
+ // overflows the canvas upward (which would overdraw the row beneath
+ // on the PDF backend) — instead the canvas itself is bled to the page
+ // edges via negative margins.
+ DocumentNode band = new ShapeBuilder()
+ .name("CvV2MintEditorialHeaderBand")
+ .size(pageWidth, bandHeight)
+ .fillColor(headerBandColor)
+ .build();
+ DocumentNode rule = new ShapeBuilder()
+ .name("CvV2MintEditorialHeaderRule")
+ .size(pageWidth, ruleThickness)
+ .fillColor(ruleColor)
+ .build();
+ ParagraphNode name = new ParagraphBuilder()
+ .name("CvV2MintEditorialHeaderName")
+ .text(TextOrnaments.spacedUpper(identity.name().full()))
+ .textStyle(mastheadNameStyle())
+ .align(TextAlign.CENTER)
+ .build();
+ String jobTitle = identity.jobTitle();
+ boolean hasTagline = jobTitle != null && !jobTitle.isBlank();
+ ParagraphNode tagline = hasTagline
+ ? new ParagraphBuilder()
+ .name("CvV2MintEditorialHeaderTagline")
+ .text(TextOrnaments.spacedUpper(jobTitle))
+ .textStyle(taglineStyle())
+ .align(TextAlign.CENTER)
+ .build()
+ : null;
+
+ section.addCanvas(pageWidth, canvasH, canvas -> {
+ canvas.name("CvV2MintEditorialHeaderCanvas")
+ .clipPolicy(ClipPolicy.OVERFLOW_VISIBLE)
+ // Bleed the whole canvas to the top + side page edges so
+ // the band reaches y=0 and both side edges.
+ .margin(new DocumentInsets(-ruleBleed, -ruleBleed, 0,
+ -ruleBleed))
+ // Band fills the masthead zone from the page top edge to
+ // the rule's bottom; rule + name + tagline sit at their
+ // default flow positions on top.
+ .position(band, 0.0, 0.0)
+ .position(rule, 0.0, MASTHEAD_RULE_Y)
+ .position(name, 0.0, MASTHEAD_NAME_Y);
+ if (tagline != null) {
+ canvas.position(tagline, 0.0, MASTHEAD_TAGLINE_Y);
+ }
+ });
+ }
+
// -- Sidebar: Contact ---------------------------------------------
private void addContact(SectionBuilder section, CvIdentity identity) {
@@ -513,6 +761,23 @@ private void addProfile(SectionBuilder section, CvSection profile) {
// -- Main: Experience ---------------------------------------------
+ /**
+ * Renders the Experience block with Mint's bespoke entry layout:
+ * a spaced-caps job title, a single {@code subtitle | date} meta line,
+ * a prose paragraph, and — uniquely for this preset — any trailing
+ * markdown bullet lines as a real bullet list.
+ *
+ * This is rendered locally rather than through the shared
+ * {@code EntryCompactRenderer} / {@code RichParagraphRenderer} because
+ * Mint's entry shape does not match those renderers: the title is
+ * transformed to letter-spaced uppercase, the subtitle and date are
+ * fused into one {@code "Company | Location | 2010 - Present"} meta line
+ * (the shared renderers keep them as separate title-row columns), and
+ * the body is split into prose + highlight bullets via
+ * {@link #splitBody(String)} — a transform no shared renderer performs.
+ * Bodies with no bullet lines (the canonical sample) take the plain
+ * single-paragraph path and are unaffected.
+ */
private void addExperience(SectionBuilder section, String title,
List entries) {
if (entries.isEmpty()) {
@@ -750,6 +1015,18 @@ private DocumentTableCell gridCell(String text, DocumentTableStyle style) {
// -- Style factories ----------------------------------------------
+ /**
+ * Masthead name style. With the default {@code nameColor} (ink) this is
+ * identical to {@code theme.headlineStyle()} — headline font, headline
+ * size, default decoration — so the stock render is unchanged; only the
+ * colour differs when a caller overrides {@code nameColor}.
+ */
+ private DocumentTextStyle mastheadNameStyle() {
+ return CvTextStyles.of(theme.typography().headlineFont(),
+ theme.typography().sizeHeadline(),
+ DocumentTextDecoration.DEFAULT, nameColor);
+ }
+
private DocumentTextStyle taglineStyle() {
return CvTextStyles.of(theme.typography().headlineFont(),
theme.typography().sizeContact(),
@@ -837,6 +1114,12 @@ private static List entriesOf(CvSection section) {
* {@code "* "}). Bodies with no bullet lines yield the whole text as
* prose and an empty bullet list, so the canonical sample renders
* exactly as before.
+ *
+ * Preset-local because the shared CV body renderers
+ * ({@code RichParagraphRenderer}, {@code EntryCompactRenderer}) treat the
+ * entry body as one rich paragraph and never break trailing bullet lines
+ * out into a list. This split is what lets a Mint experience entry show a
+ * paragraph followed by highlight bullets (see {@link Template#addExperience}).
*/
private static BodyParts splitBody(String body) {
if (body == null || body.isBlank()) {
diff --git a/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2VisualParityTest.java b/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2VisualParityTest.java
index bb796752..c61ba18c 100644
--- a/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2VisualParityTest.java
+++ b/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2VisualParityTest.java
@@ -114,7 +114,10 @@ private static Stream presets() {
(Supplier>) MonogramSidebarLetter::create),
Arguments.of("timeline_minimal",
TimelineMinimalLetter.RECOMMENDED_MARGIN,
- (Supplier>) TimelineMinimalLetter::create));
+ (Supplier>) TimelineMinimalLetter::create),
+ Arguments.of("mint-editorial-letter",
+ MintEditorialLetter.RECOMMENDED_MARGIN,
+ (Supplier>) MintEditorialLetter::create));
}
/**
diff --git a/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java
index addd9e78..0b6220be 100644
--- a/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java
+++ b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java
@@ -131,7 +131,10 @@ private static Stream presets() {
(Supplier>) MonogramSidebar::create),
Arguments.of("sidebar_portrait",
SidebarPortrait.RECOMMENDED_MARGIN,
- (Supplier>) SidebarPortrait::create));
+ (Supplier>) SidebarPortrait::create),
+ Arguments.of("mint_editorial",
+ MintEditorial.RECOMMENDED_MARGIN,
+ (Supplier>) MintEditorial::create));
}
/**
diff --git a/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorialSmokeTest.java b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorialSmokeTest.java
index ffa43d51..3901fcf1 100644
--- a/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorialSmokeTest.java
+++ b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorialSmokeTest.java
@@ -4,6 +4,7 @@
import com.demcha.compose.document.api.DocumentPageSize;
import com.demcha.compose.document.api.DocumentSession;
import com.demcha.compose.document.layout.LayoutGraph;
+import com.demcha.compose.document.layout.PlacedFragment;
import com.demcha.compose.document.templates.api.DocumentTemplate;
import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
import com.demcha.compose.document.templates.cv.v2.data.CvIdentity;
@@ -14,11 +15,13 @@
import com.demcha.compose.document.templates.cv.v2.data.RowsSection;
import com.demcha.compose.document.templates.cv.v2.data.SkillsSection;
import com.demcha.compose.document.templates.cv.v2.theme.CvTheme;
+import com.demcha.compose.document.style.DocumentColor;
import org.junit.jupiter.api.Test;
import java.util.List;
import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.within;
/**
* Smoke test for the v2 Mint Editorial preset. Covers stable identity,
@@ -64,6 +67,101 @@ void custom_theme_factory_renders() throws Exception {
}
}
+ @Test
+ void custom_colour_options_render_two_pages() throws Exception {
+ // Dark header band + white name + a contrasting rule and accent —
+ // exercises every Options knob at once. Still a clean two-page render.
+ MintEditorial.Options options = MintEditorial.Options.builder()
+ .headerBandColor(DocumentColor.rgb(24, 24, 24))
+ .nameColor(DocumentColor.WHITE)
+ .ruleColor(DocumentColor.rgb(220, 120, 90))
+ .accentColor(DocumentColor.rgb(139, 207, 190))
+ .build();
+ try (DocumentSession session = GraphCompose.document()
+ .pageSize(DocumentPageSize.A4)
+ .margin(48, 48, 48, 48)
+ .create()) {
+ MintEditorial.create(options).compose(session, fullDocument());
+ assertThat(session.roots()).isNotEmpty();
+ assertThat(session.layoutGraph().totalPages()).isEqualTo(2);
+ }
+ }
+
+ @Test
+ void default_options_equal_no_options() {
+ // The default Options factory must leave the stock surface identity
+ // intact (and, by the parity gate, the stock render).
+ DocumentTemplate withDefaults =
+ MintEditorial.create(MintEditorial.Options.defaults());
+ assertThat(withDefaults.id()).isEqualTo("mint-editorial");
+ assertThat(withDefaults.displayName()).isEqualTo("Mint Editorial");
+ }
+
+ @Test
+ void band_constants_match_default_masthead() throws Exception {
+ // Guard: the banded masthead reuses hand-measured MASTHEAD_* constants
+ // to place the name/tagline/rule at the SAME positions the default
+ // (bandless) flow produces. This test ties MASTHEAD_RULE_Y to the real
+ // default rule y, so any future typography / margin / spacing change
+ // that moves the masthead fails here and signals the constants must be
+ // re-measured.
+ try (DocumentSession session = GraphCompose.document()
+ .pageSize(DocumentPageSize.A4)
+ .margin(48, 48, 48, 48)
+ .create()) {
+ MintEditorial.create().compose(session, fullDocument());
+ LayoutGraph layout = session.layoutGraph();
+ PlacedFragment rule = layout.fragments().stream()
+ .filter(f -> f.pageIndex() == 0)
+ .filter(f -> f.path().contains("CvV2MintEditorialHeaderRule"))
+ .findFirst()
+ .orElseThrow(() -> new AssertionError(
+ "default masthead rule fragment not found"));
+ // PlacedFragment.y is the PDF bottom-left origin (y grows up);
+ // convert to the top-down page-edge coordinate the constant uses.
+ double pageHeight = session.canvas().height();
+ double ruleTop = pageHeight - (rule.y() + rule.height());
+ assertThat(ruleTop)
+ .as("default rule top must equal MASTHEAD_RULE_Y (re-measure "
+ + "the MASTHEAD_* band constants if this drifts)")
+ .isCloseTo(MintEditorial.MASTHEAD_RULE_Y, within(0.5));
+ }
+ }
+
+ @Test
+ void banded_and_bandless_place_first_row_identically() throws Exception {
+ // Complementary guard: the band must not shift the body. The first
+ // page-1 content row must start at the same y with and without a band.
+ double bandless = firstPageOneRowTop(MintEditorial.create());
+ double banded = firstPageOneRowTop(MintEditorial.create(
+ MintEditorial.Options.builder()
+ .headerBandColor(DocumentColor.rgb(228, 217, 198))
+ .build()));
+ assertThat(banded)
+ .as("banded masthead must place the first row at the same y as "
+ + "the bandless masthead")
+ .isCloseTo(bandless, within(0.5));
+ }
+
+ private static double firstPageOneRowTop(DocumentTemplate template)
+ throws Exception {
+ try (DocumentSession session = GraphCompose.document()
+ .pageSize(DocumentPageSize.A4)
+ .margin(48, 48, 48, 48)
+ .create()) {
+ template.compose(session, fullDocument());
+ LayoutGraph layout = session.layoutGraph();
+ double pageHeight = session.canvas().height();
+ return layout.fragments().stream()
+ .filter(f -> f.pageIndex() == 0)
+ .filter(f -> f.path().contains("CvV2MintEditorialPageOne"))
+ .mapToDouble(f -> pageHeight - (f.y() + f.height()))
+ .min()
+ .orElseThrow(() -> new AssertionError(
+ "page-1 row fragments not found"));
+ }
+ }
+
@Test
void renders_with_awards_and_references_grids() throws Exception {
try (DocumentSession session = GraphCompose.document()
diff --git a/src/test/resources/visual-baselines/coverletter-v2-layered/mint-editorial-letter-page-0.png b/src/test/resources/visual-baselines/coverletter-v2-layered/mint-editorial-letter-page-0.png
new file mode 100644
index 00000000..58d297b6
Binary files /dev/null and b/src/test/resources/visual-baselines/coverletter-v2-layered/mint-editorial-letter-page-0.png differ
diff --git a/src/test/resources/visual-baselines/cv-v2-layered/mint_editorial-page-0.png b/src/test/resources/visual-baselines/cv-v2-layered/mint_editorial-page-0.png
new file mode 100644
index 00000000..6d16b68d
Binary files /dev/null and b/src/test/resources/visual-baselines/cv-v2-layered/mint_editorial-page-0.png differ
diff --git a/src/test/resources/visual-baselines/cv-v2-layered/mint_editorial-page-1.png b/src/test/resources/visual-baselines/cv-v2-layered/mint_editorial-page-1.png
new file mode 100644
index 00000000..f747e92b
Binary files /dev/null and b/src/test/resources/visual-baselines/cv-v2-layered/mint_editorial-page-1.png differ