@reportforge/playwright-pdf 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 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.6.2] — 2026-06-23
+
+### Fixed
+
+- **Watermark no longer prints over content** — the optional watermark sits behind charts, screenshots, and tables instead of across them (z-index + a body stacking context).
+- **Absent git metadata is hidden** — local runs with no branch/commit no longer render "unknown · unknown" or a stray separator; the environment table shows "n/a".
+- **Failure errors render once** — the message and stack are no longer printed twice; the formatted stack is shown when available (it already begins with the message).
+- **Executive analysis one-liner ordering** — the one-line summary sits below the header instead of orphaning at the top of page 2.
+- **Retry attempts are 1-based** — the retry history reads `#1`, `#2`… instead of a zero-based `#0`.
+- **Zero-count suite pill hidden** — the "passed" pill no longer renders when its count is 0.
+- **Suite-bar labels stop clipping** — long suite / describe labels are truncated and the axis gutter widened.
+- **Consistent footer copy** across all three templates.
+
+---
+
 ## [0.6.1] — 2026-06-22
 
 ### Documentation

package/dist/demo/cli.js

@@ -6342,9 +6342,9 @@ function buildDemoFailures() {
         stack: "Error: expect(received).toBe(expected)\n    at Object.<anonymous> (tests/auth.spec.ts:79:28)\n    at processTicksAndRejections (node:internal/process/task_queues:95:5)"
       },
       retryHistory: [
-        { attempt: 1, status: "failed", duration: 5200 },
-        { attempt: 2, status: "failed", duration: 4900 },
-        { attempt: 3, status: "failed", duration: 4900 }
+        { attempt: 0, status: "failed", duration: 5200 },
+        { attempt: 1, status: "failed", duration: 4900 },
+        { attempt: 2, status: "failed", duration: 4900 }
       ],
       severity: "critical"
     },
@@ -6357,9 +6357,9 @@ function buildDemoFailures() {
         stack: "TimeoutError: Locator.waitFor: Timeout 5000ms exceeded.\n    at tests/checkout.spec.ts:58:12"
       },
       retryHistory: [
-        { attempt: 1, status: "failed", duration: 5100 },
-        { attempt: 2, status: "failed", duration: 5e3 },
-        { attempt: 3, status: "failed", duration: 4900 }
+        { attempt: 0, status: "failed", duration: 5100 },
+        { attempt: 1, status: "failed", duration: 5e3 },
+        { attempt: 2, status: "failed", duration: 4900 }
       ],
       severity: "high"
     },
@@ -6372,9 +6372,9 @@ function buildDemoFailures() {
         stack: "Error: expect(locator).toBeVisible()\n    at tests/catalog.spec.ts:112:9"
       },
       retryHistory: [
-        { attempt: 1, status: "failed", duration: 4100 },
-        { attempt: 2, status: "failed", duration: 4e3 },
-        { attempt: 3, status: "failed", duration: 3900 }
+        { attempt: 0, status: "failed", duration: 4100 },
+        { attempt: 1, status: "failed", duration: 4e3 },
+        { attempt: 2, status: "failed", duration: 3900 }
       ],
       severity: "medium"
     }
@@ -6642,6 +6642,9 @@ function allSectionsOn() {
 function jsonForInlineScript(value) {
   return JSON.stringify(value).replace(/<\//g, "<\\/");
 }
+function isUnknownValue(v) {
+  return !v || v === "unknown";
+}
 function deriveOptions(s) {
   return {
     showCharts: s.charts,
@@ -6862,6 +6865,9 @@ var TemplateEngine = class {
     );
     this.handlebars.registerHelper("lt", (a, b) => a < b);
     this.handlebars.registerHelper("or", (a, b) => Boolean(a) || Boolean(b));
+    this.handlebars.registerHelper("and", (a, b) => Boolean(a) && Boolean(b));
+    this.handlebars.registerHelper("isUnknown", (v) => isUnknownValue(v));
+    this.handlebars.registerHelper("gitVal", (v) => isUnknownValue(v) ? "n/a" : v);
     this.handlebars.registerHelper("categoryLabel", (cat) => CATEGORY_LABEL[cat] ?? cat);
     this.handlebars.registerHelper("strengthLabel", (s) => s ? s.charAt(0).toUpperCase() + s.slice(1) : "");
     this.handlebars.registerHelper("pluralise", (n, one, many) => n === 1 ? one : many);

package/dist/index.js

@@ -12030,6 +12030,9 @@ function formatDuration(ms) {
 function jsonForInlineScript(value) {
   return JSON.stringify(value).replace(/<\//g, "<\\/");
 }
+function isUnknownValue(v) {
+  return !v || v === "unknown";
+}
 function deriveOptions(s) {
   return {
     showCharts: s.charts,
@@ -12250,6 +12253,9 @@ var TemplateEngine = class {
     );
     this.handlebars.registerHelper("lt", (a, b) => a < b);
     this.handlebars.registerHelper("or", (a, b) => Boolean(a) || Boolean(b));
+    this.handlebars.registerHelper("and", (a, b) => Boolean(a) && Boolean(b));
+    this.handlebars.registerHelper("isUnknown", (v) => isUnknownValue(v));
+    this.handlebars.registerHelper("gitVal", (v) => isUnknownValue(v) ? "n/a" : v);
     this.handlebars.registerHelper("categoryLabel", (cat) => CATEGORY_LABEL[cat] ?? cat);
     this.handlebars.registerHelper("strengthLabel", (s) => s ? s.charAt(0).toUpperCase() + s.slice(1) : "");
     this.handlebars.registerHelper("pluralise", (n, one, many) => n === 1 ? one : many);
@@ -13231,7 +13237,7 @@ var PdfReporter = class {
     this.dataCollector = new DataCollector();
     this.pdfGenerator = new PdfGenerator();
     this.options = parseOptions(rawOptions);
-    const version = true ? "0.6.1" : "0.x";
+    const version = true ? "0.6.2" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/dist/index.mjs

@@ -12031,6 +12031,9 @@ function formatDuration(ms) {
 function jsonForInlineScript(value) {
   return JSON.stringify(value).replace(/<\//g, "<\\/");
 }
+function isUnknownValue(v) {
+  return !v || v === "unknown";
+}
 function deriveOptions(s) {
   return {
     showCharts: s.charts,
@@ -12251,6 +12254,9 @@ var TemplateEngine = class {
     );
     this.handlebars.registerHelper("lt", (a, b) => a < b);
     this.handlebars.registerHelper("or", (a, b) => Boolean(a) || Boolean(b));
+    this.handlebars.registerHelper("and", (a, b) => Boolean(a) && Boolean(b));
+    this.handlebars.registerHelper("isUnknown", (v) => isUnknownValue(v));
+    this.handlebars.registerHelper("gitVal", (v) => isUnknownValue(v) ? "n/a" : v);
     this.handlebars.registerHelper("categoryLabel", (cat) => CATEGORY_LABEL[cat] ?? cat);
     this.handlebars.registerHelper("strengthLabel", (s) => s ? s.charAt(0).toUpperCase() + s.slice(1) : "");
     this.handlebars.registerHelper("pluralise", (n, one, many) => n === 1 ? one : many);
@@ -13232,7 +13238,7 @@ var PdfReporter = class {
     this.dataCollector = new DataCollector();
     this.pdfGenerator = new PdfGenerator();
     this.options = parseOptions(rawOptions);
-    const version = true ? "0.6.1" : "0.x";
+    const version = true ? "0.6.2" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/dist/templates/layouts/detailed.hbs

@@ -37,8 +37,8 @@
 {{#if sections.defectLog}}{{> defect-log }}{{/if}}
 
 <div class="report-footer">
-  <span>Generated by ReportForge</span>
-  <span>{{formatDate meta.generatedAt}}</span>
+  <span>{{meta.projectName}} &nbsp;·&nbsp; Playwright Test Report</span>
+  <span>Generated by ReportForge &nbsp;·&nbsp; {{formatDate meta.generatedAt}}</span>
 </div>
 
 </body>

package/dist/templates/layouts/executive.hbs

@@ -4,8 +4,6 @@
 
 {{#if sections.coverPage}}{{> cover-page}}{{/if}}
 
-{{#if sections.analysisOneliner}}{{> analysis-oneliner}}{{/if}}
-
 <div class="report-header">
   <div class="report-header__left">
     {{#if meta.branding.logoBase64}}
@@ -16,6 +14,8 @@
   <div class="report-header__date">{{formatDate meta.generatedAt}}</div>
 </div>
 
+{{#if sections.analysisOneliner}}{{> analysis-oneliner}}{{/if}}
+
 {{#if sections.releaseGate}}{{> release-gate}}{{/if}}
 
 {{#if sections.summary}}{{> executive-summary options=(obj showPassRate=sections.passRate) }}{{/if}}

package/dist/templates/layouts/minimal.hbs

@@ -37,8 +37,8 @@
 {{#if sections.ciEnvironment}}{{> ci-environment options=(obj showFullEnvironment=sections.fullEnvironment) }}{{/if}}
 
 <div class="report-footer">
-  <span>Generated by ReportForge</span>
-  <span>{{formatDate meta.generatedAt}}</span>
+  <span>{{meta.projectName}} &nbsp;·&nbsp; Playwright Test Report</span>
+  <span>Generated by ReportForge &nbsp;·&nbsp; {{formatDate meta.generatedAt}}</span>
 </div>
 
 </body>

package/dist/templates/partials/charts.hbs

@@ -166,14 +166,14 @@
         y: {
           stacked: true,
           // Widen the label gutter so the longest label isn't clipped at the canvas edge.
-          afterFit: function(scale) { if (!scale.$rfPadded) { scale.$rfPadded = true; scale.width += 8; } },
+          afterFit: function(scale) { if (!scale.$rfPadded) { scale.$rfPadded = true; scale.width += 12; } },
           ticks: {
             font: { size: 9, family: 'Inter, sans-serif' }, color: '#1F1F1C', autoSkip: false,
             // Truncate long suite / describe labels so they fit the axis gutter
             // instead of clipping at the canvas edge.
             callback: function(value) {
               var l = this.getLabelForValue(value);
-              return l.length > 24 ? l.slice(0, 23) + '…' : l;
+              return l.length > 18 ? l.slice(0, 17) + '…' : l;
             }
           },
           grid:   { display: false },

package/dist/templates/partials/ci-environment.hbs

@@ -4,8 +4,8 @@
   <table class="env-table">
     <tbody>
       <tr><td>CI Provider</td><td class="env-value">{{environment.ciProvider}}</td></tr>
-      <tr><td>Branch</td>     <td class="env-value">{{environment.branch}}</td></tr>
-      <tr><td>Commit</td>     <td class="env-value">{{environment.commit}}</td></tr>
+      <tr><td>Branch</td>     <td class="env-value">{{gitVal environment.branch}}</td></tr>
+      <tr><td>Commit</td>     <td class="env-value">{{gitVal environment.commit}}</td></tr>
       {{#if environment.buildUrl}}
       <tr><td>Build URL</td>  <td class="env-value"><a href="{{environment.buildUrl}}" style="color:var(--primary,#CC785C);">{{environment.buildUrl}}</a></td></tr>
       {{/if}}
@@ -21,11 +21,11 @@
   <div class="env-grid">
     <div class="env-item">
       <span class="env-item__key">Branch</span>
-      <span class="env-item__val">{{environment.branch}}</span>
+      <span class="env-item__val">{{gitVal environment.branch}}</span>
     </div>
     <div class="env-item">
       <span class="env-item__key">Commit</span>
-      <span class="env-item__val">{{environment.commit}}</span>
+      <span class="env-item__val">{{gitVal environment.commit}}</span>
     </div>
     <div class="env-item">
       <span class="env-item__key">Browsers</span>

package/dist/templates/partials/cover-page.hbs

@@ -38,9 +38,11 @@
   <div class="cover-page__meta">
     Generated {{formatDate meta.generatedAt}}
   </div>
+  {{#unless (and (isUnknown environment.branch) (isUnknown environment.commit))}}
   <div class="cover-page__meta">
-    Branch: <strong style="color:var(--text-1);">{{environment.branch}}</strong>
-    &nbsp;·&nbsp;
-    Commit: <strong style="color:var(--text-1);">{{environment.commit}}</strong>
+    {{#unless (isUnknown environment.branch)}}Branch: <strong style="color:var(--text-1);">{{environment.branch}}</strong>{{/unless}}
+    {{#unless (or (isUnknown environment.branch) (isUnknown environment.commit))}}&nbsp;·&nbsp;{{/unless}}
+    {{#unless (isUnknown environment.commit)}}Commit: <strong style="color:var(--text-1);">{{environment.commit}}</strong>{{/unless}}
   </div>
+  {{/unless}}
 </div>

package/dist/templates/partials/failure-deep-dive.hbs

@@ -22,12 +22,13 @@
       </span>
     </div>
 
-    <div class="failure-item__message">{{error.message}}</div>
-
-    {{#if error.stack}}
-      {{#if ../options.showStackTraces}}
+    {{!-- Playwright's error.stack already begins with the message, so rendering
+          both duplicates it. Show the formatted stack when available; otherwise
+          fall back to the bare message. --}}
+    {{#if (and error.stack ../options.showStackTraces)}}
       <pre>{{error.stack}}</pre>
-      {{/if}}
+    {{else}}
+      <div class="failure-item__message">{{error.message}}</div>
     {{/if}}
 
     {{#if screenshotBase64}}
@@ -39,7 +40,7 @@
       Retry history:&nbsp;
       {{#each retryHistory}}
         <span class="retry-attempt retry-attempt--{{status}}">
-          #{{attempt}} {{status}} · {{formatDuration duration}}
+          #{{addOne attempt}} {{status}} · {{formatDuration duration}}
         </span>
       {{/each}}
     </div>

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

@@ -12,9 +12,8 @@
     </div>
   </div>
   <div class="release-gate__meta">
-    <span>{{environment.branch}}</span>
-    <span class="release-gate__sep">&middot;</span>
-    <span>{{environment.commit}}</span>
+    {{#unless (isUnknown environment.branch)}}<span>{{environment.branch}}</span>{{/unless}}
+    {{#unless (isUnknown environment.commit)}}<span>{{environment.commit}}</span>{{/unless}}
   </div>
 </div>
 {{else}}
@@ -31,9 +30,8 @@
       </div>
     </div>
     <div class="release-gate__meta">
-      <span>{{environment.branch}}</span>
-      <span class="release-gate__sep">&middot;</span>
-      <span>{{environment.commit}}</span>
+      {{#unless (isUnknown environment.branch)}}<span>{{environment.branch}}</span>{{/unless}}
+      {{#unless (isUnknown environment.commit)}}<span>{{environment.commit}}</span>{{/unless}}
     </div>
   </div>
   {{else}}
@@ -50,11 +48,9 @@
       </div>
     </div>
     <div class="release-gate__meta">
-      <span>{{environment.branch}}</span>
-      <span class="release-gate__sep">&middot;</span>
-      <span>{{environment.commit}}</span>
+      {{#unless (isUnknown environment.branch)}}<span>{{environment.branch}}</span>{{/unless}}
+      {{#unless (isUnknown environment.commit)}}<span>{{environment.commit}}</span>{{/unless}}
       {{#if stats.flaky}}
-      <span class="release-gate__sep">&middot;</span>
       <span class="release-gate__flaky-warn">&#9888; {{stats.flaky}} flaky</span>
       {{/if}}
     </div>

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

@@ -13,7 +13,7 @@
   <div class="suite-group__header">
     <span class="suite-title">{{title}}</span>
     <span class="suite-stats">
-      <span class="badge badge--passed">{{stats.passed}}</span>
+      {{#if stats.passed}}<span class="badge badge--passed">{{stats.passed}}</span>{{/if}}
       {{#if stats.failed}}<span class="badge badge--failed">{{stats.failed}}</span>{{/if}}
       {{#if stats.timedOut}}<span class="badge badge--timedout">{{stats.timedOut}}</span>{{/if}}
       {{#if stats.skipped}}<span class="badge badge--skipped">{{stats.skipped}}</span>{{/if}}

package/dist/templates/styles/base.css

@@ -43,6 +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. */
+body { position: relative; z-index: 0; }
 
 /* ── Typography ─────────────────────────────────────────────────────────── */
 h1 {
@@ -143,7 +146,7 @@ tr:last-child td { border-bottom: none; }
   position: fixed; top: 50%; 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: 0;
+  color: rgba(31,31,28,0.04); pointer-events: none; z-index: -1;
   white-space: nowrap; letter-spacing: 8px; text-transform: uppercase;
   user-select: none;
 }
@@ -239,7 +242,10 @@ code {
 }
 
 /* ── Failure-analysis one-liner — shared by detailed + executive templates ── */
-.analysis-oneliner { font-size: 0.9em; opacity: 0.9; margin-top: 4px; }
+.analysis-oneliner {
+  font-size: 0.9em; opacity: 0.9; margin-top: 4px;
+  page-break-after: avoid; break-after: avoid;
+}
 
 /* ── Release gate — ship/hold banner, shared by all templates ────────────── */
 .release-gate {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Enterprise-ready PDF reports for Playwright Test — minimal, detailed, and executive templates with CI/CD integrations",
   "license": "MIT",
   "author": "ReportForge",