@reportforge/playwright-pdf 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 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
+
+- **Expanded the Report Sections reference** — per-section descriptions for all 13 block toggles, the 5 display modifiers, a per-template defaults matrix, and the dependency rules (`trend` needs `charts`, data-gated sections, render-layer only) in both the README and the docs site.
+- Fixed the README documentation links to point at the real `/docs/<page>` routes instead of non-existent `/docs#<anchor>` anchors.
+
+_No runtime changes — `@reportforge/playwright-pdf@0.6.1` is identical in behaviour to `0.6.0`._
+
+---
+
 ## [0.6.0] — 2026-06-22
 
 ### Added

package/README.md

@@ -109,7 +109,7 @@ npx playwright test
 
 ### Chrome setup
 
-The reporter auto-detects Chrome via `PUPPETEER_EXECUTABLE_PATH`, then system Chrome, then `chrome-finder`. Full per-OS instructions: [reportforge.org/docs#chrome-setup](https://reportforge.org/docs#chrome-setup).
+The reporter auto-detects Chrome via `PUPPETEER_EXECUTABLE_PATH`, then system Chrome, then `chrome-finder`. Full per-OS instructions: [reportforge.org/docs/running-tests#chrome-setup](https://reportforge.org/docs/running-tests#chrome-setup).
 
 **Windows**
 
@@ -202,7 +202,7 @@ All options are the second element of the reporter tuple.
 | `sections` | `object` | per-template | Override which report sections appear, on top of the chosen template's defaults. Flat keys are the baseline for every chosen template; per-template keys (`minimal`\|`detailed`\|`executive`) override per template. Block toggles: `coverPage`, `analysisOneliner`, `releaseGate`, `summary`, `charts`, `trend`, `requirementsMatrix`, `ciEnvironment`, `suiteBreakdown`, `failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`. Display modifiers: `passRate`, `fullEnvironment`, `retries`, `fullFailures`, `stackTraces`. See the Report Sections docs. |
 <!-- AUTOGEN:options-table END -->
 
-Full reference: [reportforge.org/docs#configuration](https://reportforge.org/docs#configuration).
+Full reference: [reportforge.org/docs/configuration](https://reportforge.org/docs/configuration).
 
 ### Shard Merging
 
@@ -364,41 +364,86 @@ One license check, one data-collection pass — faster than multiple reporter in
 
 ### Report Sections
 
-Each template ships a curated set of sections. Override them per run with the
-`sections` option — add a section a template hides, or remove one it shows.
+Each built-in template ships a curated set of sections. The `sections` option lets you **add a section a template hides or remove one it shows — per template** — without writing a custom template.
 
 ```ts
 reporter: [['@reportforge/playwright-pdf', {
   template: ['minimal', 'detailed'],
   sections: {
-    defectLog: false,                 // baseline: drop the defect log everywhere
-    minimal:  { charts: true },       // add charts to the minimal report
+    defectLog: false,                 // flat key: baseline for EVERY chosen template
+    minimal:  { charts: true },       // per-template key: overrides the baseline
     detailed: { ciEnvironment: false },
   },
 }]]
 ```
 
-Flat keys form the baseline for every chosen template; per-template keys
-(`minimal` / `detailed` / `executive`) override the baseline for that template.
+**Resolution order** (lowest → highest): the template's defaults → flat keys (baseline for all chosen templates) → per-template keys (`minimal` / `detailed` / `executive`). An unknown key throws a configuration error (typo-safe).
 
-**Block toggles:** `coverPage`, `analysisOneliner`, `releaseGate`, `summary`,
-`charts`, `trend`, `requirementsMatrix`, `ciEnvironment`, `suiteBreakdown`,
-`failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`.
+#### Block toggles — which sections appear
 
-**Display modifiers:** `passRate` (summary), `fullEnvironment` (full env table vs
-compact), `retries` (suite retries column), `fullFailures` + `stackTraces`
-(failure detail depth).
-
-`trend` renders only when `charts` is also on **and** history data exists (`showTrend` enabled). Data-gated sections
-(`failureAnalysis`, `requirementsMatrix`, `slowTests`, `defectLog`) appear only
-when matching data exists — `sections` controls rendering, never data collection.
-An unknown key throws a config error (typo-safe).
+| Key | Renders |
+|---|---|
+| `coverPage` | Full-page cover: title, verdict badge, KPI stats strip, branch + commit |
+| `analysisOneliner` | One-line failure-analysis summary banner |
+| `releaseGate` | Ship/hold recommendation banner (APPROVED TO SHIP / HOLD) |
+| `summary` | KPI strip (total · passed · failed · timed-out · skipped · flaky), verdict, duration, pass rate, flaky callout |
+| `charts` | Pass-rate doughnut + stacked suite-results bar |
+| `trend` | Pass-rate trend line, run-history table, and flakiness table (rendered inside `charts`) |
+| `requirementsMatrix` | Tests grouped by `@tag('REQ-…')` with coverage bars (requirements traceability) |
+| `ciEnvironment` | Branch, commit, browsers, CI provider, OS, Node, Playwright, projects, workers |
+| `suiteBreakdown` | Per-suite → per-test table (status, duration, tags, retries) |
+| `failureDeepDive` | Failure cards: error message, stack trace, screenshot, retry history |
+| `failureAnalysis` | Clustered root-cause buckets from the offline classifier |
+| `slowTests` | Slowest tests, duration-ranked |
+| `defectLog` | `DEF-####` numbered failure table (severity, retries) |
+
+#### Display modifiers — tune a section that's on
+
+| Key | Effect |
+|---|---|
+| `passRate` | Show the pass-rate % on the Passed KPI card (`summary`) |
+| `fullEnvironment` | Full environment table instead of the compact grid (`ciEnvironment`) |
+| `retries` | Retries column in the suite breakdown (`suiteBreakdown`) |
+| `fullFailures` | Full failure cards instead of one-line summaries (`failureDeepDive`) |
+| `stackTraces` | Include `<pre>` stack traces in the failure cards (`failureDeepDive`) |
+
+#### Per-template defaults
+
+Omit `sections` entirely and each template renders exactly this (✓ = on):
+
+| Section | minimal | detailed | executive |
+|---|:-:|:-:|:-:|
+| `coverPage` | – | – | ✓ |
+| `analysisOneliner` | – | – | ✓ |
+| `releaseGate` | ✓ | ✓ | ✓ |
+| `summary` | ✓ | ✓ | ✓ |
+| `charts` | – | ✓ | ✓ |
+| `trend` | – | ✓ | ✓ |
+| `requirementsMatrix` | – | ✓ | – |
+| `ciEnvironment` | ✓ | ✓ | ✓ |
+| `suiteBreakdown` | ✓ | ✓ | – |
+| `failureDeepDive` | ✓ | ✓ | ✓ |
+| `failureAnalysis` | – | ✓ | – |
+| `slowTests` | – | ✓ | ✓ |
+| `defectLog` | – | ✓ | – |
+| `passRate` | ✓ | ✓ | ✓ |
+| `fullEnvironment` | – | ✓ | – |
+| `retries` | ✓ | ✓ | – |
+| `fullFailures` | ✓ | ✓ | – |
+| `stackTraces` | ✓ | ✓ | – |
+
+#### Dependencies & gotchas
+
+- **`trend` needs `charts`.** The trend line, run-history, and flakiness table live inside the charts block, so `trend: true` does nothing with `charts: false` (it's coerced off). It also needs history data — keep the top-level `showTrend` option on.
+- **Data-gated sections** — `failureAnalysis`, `requirementsMatrix`, `slowTests`, `defectLog` render only when there's matching data (clusters, tagged tests, timed tests, failures). Toggling them on with no data shows nothing.
+- **Render-layer only.** `sections` controls what's drawn, never what's collected — the data switches stay separate: `showTrend` (history), `flakinessTopN` (flaky-table size), `failureAnalysis.enabled` (classifier), `includeScreenshots` (images).
+- **Custom templates.** `sections` applies to the built-in templates; a custom `templatePath` controls its own layout (every section available) and ignores `sections` — you'll get a warning if both are set.
 
 ---
 
 ## CI/CD Integration
 
-Full workflows for all four CI providers: [reportforge.org/docs#ci-cd](https://reportforge.org/docs#ci-cd).
+Full workflows for all four CI providers: [reportforge.org/docs/ci-cd](https://reportforge.org/docs/ci-cd).
 
 ### GitHub Actions
 
@@ -534,7 +579,7 @@ export RF_LICENSE_KEY=RFSU-XXXX-XXXX-XXXX-XXXX
 npx playwright test
 ```
 
-Full lifecycle + offline failure modes: [reportforge.org/docs#license](https://reportforge.org/docs#license).
+Full lifecycle + offline failure modes: [reportforge.org/docs/licensing](https://reportforge.org/docs/licensing).
 
 ---
 
@@ -566,7 +611,7 @@ Common issues:
 - **`pdfPassword` ignored** → requires `qpdf` on `PATH` (`apt install qpdf` / `brew install qpdf` / `choco install qpdf`).
 - **No PDF generated** → verify `RF_LICENSE_KEY` is set and your subscription is active. `RF_DEBUG=1` will show the activation result; missing key, expired subscription, network failure, or no JWT cache all skip PDF generation.
 
-Full guide: [reportforge.org/docs#troubleshooting](https://reportforge.org/docs#troubleshooting).
+Full guide: [reportforge.org/docs/troubleshooting](https://reportforge.org/docs/troubleshooting).
 
 ---
 
@@ -574,15 +619,15 @@ Full guide: [reportforge.org/docs#troubleshooting](https://reportforge.org/docs#
 
 Full documentation at [reportforge.org/docs](https://reportforge.org/docs):
 
-- [Quick start](https://reportforge.org/docs#install) — install, configure, activate
-- [Chrome setup](https://reportforge.org/docs#chrome-setup) — Windows, Linux, macOS
-- [CI/CD integration](https://reportforge.org/docs#ci-cd) — GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins, Azure DevOps
-- [Configuration reference](https://reportforge.org/docs#configuration) — all options
-- [Filename tokens](https://reportforge.org/docs#tokens) — `{date}`, `{branch}`, `{status}`
-- [Templates](https://reportforge.org/docs#templates) — minimal, detailed, executive
-- [Report Sections](https://reportforge.org/docs#report-sections) — add or remove sections per template
-- [License & offline behaviour](https://reportforge.org/docs#license) — JWT cache, machine cap, cancellation
-- [Troubleshooting](https://reportforge.org/docs#troubleshooting) — common issues and debug flags
+- [Quick start](https://reportforge.org/docs/quickstart) — install, configure, activate
+- [Chrome setup](https://reportforge.org/docs/running-tests#chrome-setup) — Windows, Linux, macOS
+- [CI/CD integration](https://reportforge.org/docs/ci-cd) — GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins, Azure DevOps
+- [Configuration reference](https://reportforge.org/docs/configuration) — all options
+- [Filename tokens](https://reportforge.org/docs/configuration#tokens) — `{date}`, `{branch}`, `{status}`
+- [Templates](https://reportforge.org/docs/templates) — minimal, detailed, executive
+- [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)
 
 ---

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.0" : "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.0" : "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.0",
+  "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",