@reportforge/playwright-pdf 0.14.2 → 0.15.0

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.15.0] - 2026-07-07
+
+### Changed
+
+- **Suite Breakdown now always opens on a fresh page** in every template (`minimal`, `detailed`, `executive`), instead of starting mid-page after whatever section precedes it.
+- **Watermark now stamps from the Suite Breakdown page to the end of the report.** The cover, summary, and chart pages stay clean — a diagonal stamp behind the doughnut/trend charts hurt readability on exactly the pages built to be glanced at. The copies anchor inside the suite-breakdown section (its forced page break makes the section's top edge an exact page boundary), so every copy stays page-centred without estimating print pagination; custom templates and `sections` overrides without that section fall back to whole-document stamping. Also fixes a latent overshoot where the page-count pad could paint a blank trailing page containing only a watermark.
+- **Watermark opacity raised from 4% to 10%** — visible as a stamp rather than barely-there, still light enough to keep text underneath legible.
+- **Release Recommendation no longer says "fix before shipping."** A failure isn't necessarily a product defect, so the HOLD banner now reads: "Review each failure — it may be a product defect or an automation script issue — and verify manually before shipping." The timed-out variant matches ("often an environment or automation issue").
+
+---
+
+## [0.14.3] - 2026-07-06
+
+### Fixed
+
+- **Watermark now shows on every page instead of only one.** Chromium's print-to-PDF doesn't repeat `position: fixed` elements per page (only paged-media renderers like Prince/WeasyPrint do), so a single watermark div only ever printed once for the whole document. An inline script now measures the rendered page height and stamps one `position: absolute` copy per page. Also changed from `z-index: -1` to painting above content — at 4% opacity it doesn't affect legibility, and the negative z-index made it invisible on any page dense enough to have no background gaps.
+- **Executive report now leads with the pass-rate/suite-results charts, trend chart second.** Previously the trend chart was promoted above the doughnut/bar row; both now render in the same order as the other templates, landing on the same page as the summary stats.
+
+---
+
 ## [0.14.2] - 2026-07-06
 
 ### Fixed

package/README.md

@@ -183,7 +183,7 @@ All options are the second element of the reporter tuple.
 | `logo` | `string` | n/a | Path to a logo image (PNG, JPG, or SVG) to embed in the report header. Supports absolute and relative paths. |
 | `primaryColor` | `string` | `'#CC785C'` | Primary brand colour (3-, 6-, or 8-digit hex). Used for headers and accent bars. |
 | `accentColor` | `string` | `'#3F7D58'` | Accent brand colour (hex). Used for highlights and badges. |
-| `watermark` | `string` | n/a | Text to render as a diagonal watermark overlay on every page, e.g. `'CONFIDENTIAL'` or `'DRAFT'`. |
+| `watermark` | `string` | n/a | Text to render as a diagonal watermark overlay from the Suite Breakdown page onward (summary/chart pages stay clean), e.g. `'CONFIDENTIAL'` or `'DRAFT'`. |
 | `pdfPassword` | `string` | n/a | Password-protect the generated PDF. Requires `qpdf` installed on the system. |
 | `reportTitle` | `string` | `'Playwright Test Report'` | Custom title for the report cover page and running header. |
 | `projectName` | `string` | from `package.json` | Project or application name. Inferred from the `package.json` `name` field if absent. |
@@ -668,7 +668,7 @@ Full documentation at [reportforge.org/docs](https://reportforge.org/docs):
 - [Report Sections](https://reportforge.org/docs/configuration#report-sections): add or remove sections per template
 - [License & offline behaviour](https://reportforge.org/docs/licensing): JWT cache, machine cap, cancellation
 - [Troubleshooting](https://reportforge.org/docs/troubleshooting): common issues and debug flags
-- **Changelog**: [CHANGELOG.md](./CHANGELOG.md)
+- [Changelog](https://reportforge.org/changelog): version history and release notes
 
 ---
 

package/dist/cli/index.js

@@ -6590,7 +6590,7 @@ function deriveOptions(s) {
     showFullFailures: s.fullFailures
   };
 }
-var import_handlebars, import_fs, import_path, SLOW_MEDIAN_FACTOR, TemplateEngine;
+var import_handlebars, import_fs, import_path, A4_HEIGHT_MM, PAGE_MARGIN_Y_MM, PX_PER_MM, PAGE_CONTENT_HEIGHT_PX, SLOW_MEDIAN_FACTOR, TemplateEngine;
 var init_engine = __esm({
   "src/templates/engine.ts"() {
     "use strict";
@@ -6602,6 +6602,10 @@ var init_engine = __esm({
     init_duration();
     init_SummaryWriter();
     init_sections();
+    A4_HEIGHT_MM = 297;
+    PAGE_MARGIN_Y_MM = 16;
+    PX_PER_MM = 96 / 25.4;
+    PAGE_CONTENT_HEIGHT_PX = (A4_HEIGHT_MM - 2 * PAGE_MARGIN_Y_MM) * PX_PER_MM;
     SLOW_MEDIAN_FACTOR = 2;
     TemplateEngine = class {
       constructor() {
@@ -6661,7 +6665,8 @@ var init_engine = __esm({
           slowTests: slow.ranked,
           baseCSS: this.fontsBundleCss + "\n" + this.readStyle("base.css"),
           templateCSS: "",
-          chartjsScript: this.buildChartjsScript()
+          chartjsScript: this.buildChartjsScript(),
+          watermarkPageHeightPx: PAGE_CONTENT_HEIGHT_PX
         };
       }
       buildContext(data, template, userSections, slowTestThreshold) {
@@ -6684,7 +6689,8 @@ var init_engine = __esm({
           slowTests: slow.ranked,
           baseCSS,
           templateCSS,
-          chartjsScript: this.buildChartjsScript()
+          chartjsScript: this.buildChartjsScript(),
+          watermarkPageHeightPx: PAGE_CONTENT_HEIGHT_PX
         };
       }
       buildChartjsScript() {

package/dist/index.d.mts

@@ -67,7 +67,8 @@ interface ReporterOptions {
      */
     accentColor?: string;
     /**
-     * Text to render as a diagonal watermark overlay on every page.
+     * Text to render as a diagonal watermark overlay, stamped from the Suite
+     * Breakdown page to the end of the report (summary and chart pages stay clean).
      * Example: 'CONFIDENTIAL', 'DRAFT'
      */
     watermark?: string;

package/dist/index.d.ts

@@ -67,7 +67,8 @@ interface ReporterOptions {
      */
     accentColor?: string;
     /**
-     * Text to render as a diagonal watermark overlay on every page.
+     * Text to render as a diagonal watermark overlay, stamped from the Suite
+     * Breakdown page to the end of the report (summary and chart pages stay clean).
      * Example: 'CONFIDENTIAL', 'DRAFT'
      */
     watermark?: string;

package/dist/index.js

@@ -12365,6 +12365,10 @@ function formatDuration(ms) {
 function jsonForInlineScript(value) {
   return JSON.stringify(value).replace(/<\//g, "<\\/");
 }
+var A4_HEIGHT_MM = 297;
+var PAGE_MARGIN_Y_MM = 16;
+var PX_PER_MM = 96 / 25.4;
+var PAGE_CONTENT_HEIGHT_PX = (A4_HEIGHT_MM - 2 * PAGE_MARGIN_Y_MM) * PX_PER_MM;
 function isUnknownValue(v) {
   return !v || v === "unknown";
 }
@@ -12438,7 +12442,8 @@ var TemplateEngine = class {
       slowTests: slow.ranked,
       baseCSS: this.fontsBundleCss + "\n" + this.readStyle("base.css"),
       templateCSS: "",
-      chartjsScript: this.buildChartjsScript()
+      chartjsScript: this.buildChartjsScript(),
+      watermarkPageHeightPx: PAGE_CONTENT_HEIGHT_PX
     };
   }
   buildContext(data, template, userSections, slowTestThreshold) {
@@ -12461,7 +12466,8 @@ var TemplateEngine = class {
       slowTests: slow.ranked,
       baseCSS,
       templateCSS,
-      chartjsScript: this.buildChartjsScript()
+      chartjsScript: this.buildChartjsScript(),
+      watermarkPageHeightPx: PAGE_CONTENT_HEIGHT_PX
     };
   }
   buildChartjsScript() {
@@ -14056,7 +14062,7 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.14.2" : "0.x";
+    const version = true ? "0.15.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/dist/index.mjs

@@ -12366,6 +12366,10 @@ function formatDuration(ms) {
 function jsonForInlineScript(value) {
   return JSON.stringify(value).replace(/<\//g, "<\\/");
 }
+var A4_HEIGHT_MM = 297;
+var PAGE_MARGIN_Y_MM = 16;
+var PX_PER_MM = 96 / 25.4;
+var PAGE_CONTENT_HEIGHT_PX = (A4_HEIGHT_MM - 2 * PAGE_MARGIN_Y_MM) * PX_PER_MM;
 function isUnknownValue(v) {
   return !v || v === "unknown";
 }
@@ -12439,7 +12443,8 @@ var TemplateEngine = class {
       slowTests: slow.ranked,
       baseCSS: this.fontsBundleCss + "\n" + this.readStyle("base.css"),
       templateCSS: "",
-      chartjsScript: this.buildChartjsScript()
+      chartjsScript: this.buildChartjsScript(),
+      watermarkPageHeightPx: PAGE_CONTENT_HEIGHT_PX
     };
   }
   buildContext(data, template, userSections, slowTestThreshold) {
@@ -12462,7 +12467,8 @@ var TemplateEngine = class {
       slowTests: slow.ranked,
       baseCSS,
       templateCSS,
-      chartjsScript: this.buildChartjsScript()
+      chartjsScript: this.buildChartjsScript(),
+      watermarkPageHeightPx: PAGE_CONTENT_HEIGHT_PX
     };
   }
   buildChartjsScript() {
@@ -14057,7 +14063,7 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.14.2" : "0.x";
+    const version = true ? "0.15.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/dist/templates/partials/charts.hbs

@@ -1,7 +1,7 @@
 {{#if options.showCharts}}
 {{#if options.heroTrend}}
-{{> chart-trend-card options=options}}
 {{> chart-summary-grid options=options}}
+{{> chart-trend-card options=options}}
 {{else}}
 {{> chart-summary-grid options=options}}
 {{> chart-trend-card options=options}}

package/dist/templates/partials/release-gate.hbs

@@ -7,7 +7,8 @@
       HOLD — {{stats.failed}} FAILURE{{#if (gt stats.failed 1)}}S{{/if}}
     </div>
     <div class="release-gate__detail">
-      {{stats.failed}} of {{stats.total}} tests failed. Review and fix before shipping.
+      {{stats.failed}} of {{stats.total}} tests failed. Review each failure &mdash; it may be a
+      product defect or an automation script issue &mdash; and verify manually before shipping.
       {{#if stats.flaky}} &nbsp;&middot;&nbsp; {{stats.flaky}} flaky (additional risk).{{/if}}
     </div>
   </div>
@@ -26,7 +27,8 @@
         HOLD &mdash; {{stats.timedOut}} TIMED OUT
       </div>
       <div class="release-gate__detail">
-        {{stats.timedOut}} tests exceeded timeout. Investigate before shipping.
+        {{stats.timedOut}} tests exceeded timeout &mdash; often an environment or automation
+        issue. Review and verify manually before shipping.
       </div>
     </div>
     <div class="release-gate__meta">

package/dist/templates/partials/suite-breakdown.hbs

@@ -1,4 +1,4 @@
-<div class="section">
+<div class="section section--suite-breakdown">
   <h2>Suite Breakdown</h2>
   {{#if (and overflowFailureCount sections.failureDeepDive)}}
   <div class="overflow-banner">

package/dist/templates/partials/watermark.hbs

@@ -1,3 +1,42 @@
 {{#if meta.branding.watermark}}
-<div class="watermark" aria-hidden="true">{{meta.branding.watermark}}</div>
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+  // Chromium's print-to-PDF doesn't repeat position:fixed elements per page, so a
+  // single watermark div only ever prints on one page. Instead, measure the fully
+  // parsed document (this listener fires after all content above is in the DOM)
+  // and stamp one absolutely-positioned copy per page slot.
+  //
+  // Copies start at the suite breakdown, not page 1, so the summary/chart pages
+  // stay clean. That section opens on a forced page break (.section--suite-breakdown
+  // in base.css), which makes its top edge an exact page boundary — appending the
+  // copies INSIDE it keeps each one page-centred even when print pagination pushes
+  // in-flow content down, because the copies travel with the section rather than
+  // being estimated against shifted content. When the section is absent (sections
+  // override, custom templates), fall back to stamping the whole document.
+  var text = {{{safeJsonData meta.branding.watermark}}};
+  var pageHeightPx = {{watermarkPageHeightPx}};
+  var anchor = document.querySelector('.section--suite-breakdown');
+  var host = anchor || document.body;
+  var startPx = anchor ? anchor.offsetTop : 0;
+  // Copy count: ceil() of the measured span, NEVER padded in the anchor case — the
+  // anchor origin is page-aligned, so ceil is exact for unshifted content and every
+  // copy lands inside it (a padded copy would paint a blank trailing page with a
+  // lone watermark). Print pagination can still push content one page further than
+  // the screen measurement predicts (cards/rows refuse to split mid-way); in the
+  // anchor case that at worst leaves the final spill-over page unstamped, which is
+  // the cheaper failure. The body fallback keeps the +1: whole-document slack
+  // (cover break + every section) reliably exceeds a page, so there the pad fills
+  // a real page instead of minting an empty one.
+  var extra = anchor ? 0 : 1;
+  var pageCount = Math.min(500, Math.max(1, Math.ceil((document.body.scrollHeight - startPx) / pageHeightPx) + extra));
+  for (var i = 0; i < pageCount; i++) {
+    var el = document.createElement('div');
+    el.className = 'watermark';
+    el.setAttribute('aria-hidden', 'true');
+    el.style.top = (i * pageHeightPx + pageHeightPx / 2) + 'px';
+    el.textContent = text;
+    host.appendChild(el);
+  }
+});
+</script>
 {{/if}}

package/dist/templates/styles/base.css

@@ -43,8 +43,9 @@ html, body {
   color: var(--text-1);
   background: var(--bg);
 }
-/* Establish a stacking context on the body so the fixed watermark (z-index:-1)
-   paints behind all content instead of on top of cards, charts and screenshots. */
+/* Positioned so it's the containing block for the watermark's `position: absolute`
+   fallback copies (see watermark.hbs) — without this they'd position relative to
+   the document root. */
 body { position: relative; z-index: 0; }
 
 /* ── Typography ─────────────────────────────────────────────────────────── */
@@ -142,17 +143,37 @@ tr:last-child td { border-bottom: none; }
 .severity--low      { color: var(--text-3);  }
 
 /* ── Watermark ──────────────────────────────────────────────────────────── */
+/* `top` is set inline per copy (see watermark.hbs) — Chromium's print-to-PDF
+   doesn't repeat `position: fixed` elements per page, so one copy is stamped
+   at each page's vertical centre in document-flow coordinates instead.
+   Copies live inside .section--suite-breakdown (its forced page break makes its
+   top edge a page boundary) and run from there to the end of the report — the
+   summary/chart pages stay unstamped. body hosts the copies only as a fallback
+   when that section is absent.
+   z-index is high (not negative) so it paints over cards/badges too — at
+   10% opacity it stays light enough not to hurt legibility, and a negative
+   z-index made it invisible on any page dense enough to have no gaps in the
+   content. */
 .watermark {
-  position: fixed; top: 50%; left: 50%;
+  position: absolute; left: 50%;
   transform: translate(-50%, -50%) rotate(-30deg);
   font-family: 'Source Serif Pro', Georgia, serif; font-size: 60px; font-weight: 700;
-  color: rgba(31,31,28,0.04); pointer-events: none; z-index: -1;
+  color: rgba(31,31,28,0.10); pointer-events: none; z-index: 999;
   white-space: nowrap; letter-spacing: 8px; text-transform: uppercase;
   user-select: none;
 }
 
 /* ── Page breaks ────────────────────────────────────────────────────────── */
 .no-break { page-break-inside: avoid; }
+/* Suite breakdown always opens on a fresh page (every template) — and the forced
+   break puts its top edge exactly on a page boundary, which watermark.hbs relies
+   on to start the per-page watermark copies here. position:relative makes it
+   their containing block; no z-index, so the copies keep painting in the body
+   stacking context (above the sections that follow this one too). */
+.section--suite-breakdown {
+  break-before: page; page-break-before: always;
+  position: relative;
+}
 /* Keep a failed test row glued to the START of its inline failure detail so the
    title never orphans above it. The detail card itself may break internally (its
    small pieces are individually break-protected), so a tall screenshot flows to the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.14.2",
+  "version": "0.15.0",
   "description": "Playwright Test reporter that generates designed PDF reports: minimal, detailed, and executive templates with CI/CD integrations",
   "license": "MIT",
   "author": "ReportForge",