@reportforge/playwright-pdf 0.6.3 → 0.7.1

package/README.md

@@ -46,7 +46,7 @@ Three templates, one reporter. Every PDF is fully offline — fonts, charts, and
 ## Features
 
 - **3 templates** — `minimal` (developer), `detailed` (QA team), `executive` (stakeholders)
-- **Detailed reports** — KPI dashboard, suite breakdown, failure deep-dive with screenshots, CI/CD environment
+- **Detailed reports** — KPI dashboard, suite breakdown with inline failure detail (error, screenshot, root-cause chip) under each failed test, CI/CD environment
 - **Embedded Chart.js** — pass-rate doughnut + per-suite bar chart, bundled inline (no CDN)
 - **Self-contained PDFs** — screenshots, fonts, logos all embedded; share or archive with confidence
 - **Custom branding** — logo, primary/accent colours, watermark, PDF password encryption
@@ -56,7 +56,7 @@ Three templates, one reporter. Every PDF is fully offline — fonts, charts, and
 - **Shard merging** — combine N Playwright JSON shard reports into one PDF via `shardResults`; accepts glob patterns or explicit paths
 - **Notifications** — post pass/fail summaries to Slack, Teams, Discord, or email after each run; configurable trigger (`always` / `failure` / `success`) per channel; email supports optional PDF attachment via `attachPdf`
 - **Flakiness trend** — top-N flakiest tests table with per-test dot sparkline across stored history runs in the `detailed` template; `flakinessTopN` option (default 5, `0` disables)
-- **Offline failure analysis** — sorts failures into 7 root-cause buckets and clusters them, right inside the `detailed` PDF (one-liner in `executive`). No network, no AI service — a small embedded classifier that updates itself safely over your existing license refresh; pin it any time. Full details at [reportforge.org/docs/advanced/failure-analysis](https://reportforge.org/docs/advanced/failure-analysis).
+- **Offline failure analysis** — sorts each failure into one of 7 root-cause buckets and renders a per-test root-cause chip inline under the failed test in the `detailed` PDF (dominant-cause one-liner in `executive`). No network, no AI service — a small embedded classifier that updates itself safely over your existing license refresh; pin it any time. Full details at [reportforge.org/docs/advanced/failure-analysis](https://reportforge.org/docs/advanced/failure-analysis).
 - `npx @reportforge/playwright-pdf export-feedback` — exports locally-collected unrecognized failures (tokenized, local-only) for optional manual sharing.
 - **Configurable sections** — add or remove any report section per template via `sections`.
 - **Hybrid licensing** — one short key unlocks it; reports keep rendering offline via a cached JWT between refreshes
@@ -198,6 +198,7 @@ All options are the second element of the reporter tuple.
 | `historySize` | `number` | `10` | Maximum number of test runs to keep in the history file (integer ≥ 2). Older runs are pruned on append. |
 | `showTrend` | `boolean` | `true` | Show the pass-rate sparkline and delta badge in the `detailed` template. Set to `false` to disable history tracking entirely. |
 | `flakinessTopN` | `number` | `5` | Maximum flaky tests to show in the flakiness table (`detailed` template). Set to `0` to disable the table entirely. |
+| `slowTestThreshold` | `number` | `10` | Minimum timed-test count before `SLOW` badges appear in the suite breakdown — below this, every test is trivially the "slowest" so badges stay hidden. On larger runs only genuine outliers (at least 2× the median test duration) are badged, so the badge stays rare. Set to `0` to drop the run-size gate (outliers still required). |
 | `templatePath` | `string \| string[]` | — | Path to a custom Handlebars (`.hbs`) template file. Takes precedence over `template`. Pass an array to generate one PDF per custom template. See the Custom Templates docs. |
 | `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 -->
@@ -391,10 +392,10 @@ reporter: [['@reportforge/playwright-pdf', {
 | `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 |
+| `suiteBreakdown` | Per-suite → per-test table (status, duration, tags, retries). Failed tests carry their failure detail, root-cause chip, and a `SLOW` badge inline (the three keys below) |
+| `failureDeepDive` | Inline failure detail under each failed test in the breakdown: error message, stack trace, screenshot, retry history |
+| `failureAnalysis` | Inline per-test root-cause chip under each failed test (category + representative error + match strength, from the offline classifier) |
+| `slowTests` | `SLOW` badge on the duration-ranked slowest tests, shown inline in the breakdown |
 | `defectLog` | `DEF-####` numbered failure table (severity, retries) |
 
 #### Display modifiers — tune a section that's on
@@ -404,8 +405,8 @@ reporter: [['@reportforge/playwright-pdf', {
 | `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`) |
+| `fullFailures` | Include the screenshot in the inline failure detail (compact templates omit it) (`failureDeepDive`) |
+| `stackTraces` | Include `<pre>` stack traces in the inline failure detail (`failureDeepDive`) |
 
 #### Per-template defaults
 
@@ -421,7 +422,7 @@ Omit `sections` entirely and each template renders exactly this (✓ = on):
 | `trend` | – | ✓ | ✓ |
 | `requirementsMatrix` | – | ✓ | – |
 | `ciEnvironment` | ✓ | ✓ | ✓ |
-| `suiteBreakdown` | ✓ | ✓ | – |
+| `suiteBreakdown` | ✓ | ✓ | ✓ |
 | `failureDeepDive` | ✓ | ✓ | ✓ |
 | `failureAnalysis` | – | ✓ | – |
 | `slowTests` | – | ✓ | ✓ |
@@ -435,7 +436,8 @@ Omit `sections` entirely and each template renders exactly this (✓ = on):
 #### 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.
+- **Inline failure detail needs `suiteBreakdown`.** `failureDeepDive` (failure detail), `failureAnalysis` (root-cause chip), and `slowTests` (`SLOW` badge) now render *inside* the suite breakdown, so they show nothing when `suiteBreakdown` is off. The chip (`failureAnalysis`) also needs `failureDeepDive` — it lives inside the failure detail, so it's coerced off without it.
+- **Data-gated sections** — `failureAnalysis`, `requirementsMatrix`, `slowTests`, `defectLog` render only when there's matching data (classified failures, tagged tests, a meaningful slow set, 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.
 

package/dist/cli/index.js

@@ -6243,6 +6243,29 @@ var require_lib = __commonJS({
   }
 });
 
+// src/config/defaults.ts
+var DEFAULT_OPTIONS;
+var init_defaults = __esm({
+  "src/config/defaults.ts"() {
+    "use strict";
+    init_cjs_shims();
+    DEFAULT_OPTIONS = {
+      outputFile: "playwright-report/{date}-report.pdf",
+      template: "minimal",
+      primaryColor: "#CC785C",
+      accentColor: "#3F7D58",
+      reportTitle: "Playwright Test Report",
+      open: false,
+      compressionLevel: "auto",
+      maxFileSizeMb: 8,
+      historySize: 10,
+      showTrend: true,
+      flakinessTopN: 5,
+      slowTestThreshold: 10
+    };
+  }
+});
+
 // src/utils/duration.ts
 function formatDuration(ms) {
   if (ms < 1e3) return `${ms}ms`;
@@ -6316,6 +6339,7 @@ function resolveSections(template, userSections) {
   }
   const result = { ...base, ...flat, ...perTemplate };
   if (!result.charts) result.trend = false;
+  if (!result.failureDeepDive) result.failureAnalysis = false;
   return result;
 }
 function allSectionsOn() {
@@ -6398,7 +6422,10 @@ var init_sections = __esm({
         trend: true,
         requirementsMatrix: false,
         ciEnvironment: true,
-        suiteBreakdown: false,
+        // Suite breakdown now hosts the inline failure detail + slow badge, so the
+        // executive layout renders it too (compact: fullFailures stays false → no
+        // screenshots; failureAnalysis stays off → no per-test chip).
+        suiteBreakdown: true,
         failureDeepDive: true,
         failureAnalysis: false,
         slowTests: true,
@@ -6446,7 +6473,7 @@ function deriveOptions(s) {
     showFullFailures: s.fullFailures
   };
 }
-var import_handlebars, import_fs, import_path, TemplateEngine;
+var import_handlebars, import_fs, import_path, SLOW_MEDIAN_FACTOR, TemplateEngine;
 var init_engine = __esm({
   "src/templates/engine.ts"() {
     "use strict";
@@ -6454,9 +6481,11 @@ var init_engine = __esm({
     import_handlebars = __toESM(require_lib());
     import_fs = __toESM(require("fs"));
     import_path = __toESM(require("path"));
+    init_defaults();
     init_duration();
     init_SummaryWriter();
     init_sections();
+    SLOW_MEDIAN_FACTOR = 2;
     TemplateEngine = class {
       constructor() {
         this.chartjsInline = "";
@@ -6482,17 +6511,17 @@ var init_engine = __esm({
       setChartjsBundle(inline) {
         this.chartjsInline = inline;
       }
-      render(data, template, userSections) {
+      render(data, template, userSections, slowTestThreshold) {
         const layoutPath = import_path.default.join(this.templatesDir, "layouts", `${template}.hbs`);
         if (!import_fs.default.existsSync(layoutPath)) {
           throw new Error(`[reportforge] Template layout not found: ${layoutPath}`);
         }
         const layoutSource = import_fs.default.readFileSync(layoutPath, "utf8");
         const compiledLayout = this.handlebars.compile(layoutSource);
-        const ctx = this.buildContext(data, template, userSections);
+        const ctx = this.buildContext(data, template, userSections, slowTestThreshold);
         return compiledLayout(ctx);
       }
-      renderFromPath(data, filePath) {
+      renderFromPath(data, filePath, slowTestThreshold) {
         if (!this.customTemplateCache.has(filePath)) {
           if (!import_fs.default.existsSync(filePath)) {
             throw new Error(`[reportforge] Custom template not found: ${filePath}`);
@@ -6501,32 +6530,41 @@ var init_engine = __esm({
           this.customTemplateCache.set(filePath, this.handlebars.compile(source));
         }
         const compiledFn = this.customTemplateCache.get(filePath);
-        return compiledFn(this.buildCustomContext(data));
+        return compiledFn(this.buildCustomContext(data, slowTestThreshold));
       }
-      buildCustomContext(data) {
+      buildCustomContext(data, slowTestThreshold) {
         const sections = allSectionsOn();
+        const slow = this.buildSlowTests(data);
         return {
           ...data,
+          projects: this.enrichProjects(data, slow, sections, slowTestThreshold ?? DEFAULT_OPTIONS.slowTestThreshold),
           options: deriveOptions(sections),
           sections,
           tagGroups: this.buildTagGroups(data),
-          slowTests: this.buildSlowTests(data),
+          slowTests: slow.ranked,
           baseCSS: this.fontsBundleCss + "\n" + this.readStyle("base.css"),
           templateCSS: "",
           chartjsScript: this.buildChartjsScript()
         };
       }
-      buildContext(data, template, userSections) {
+      buildContext(data, template, userSections, slowTestThreshold) {
         const baseCSS = this.fontsBundleCss + "\n" + this.readStyle("base.css");
         const templateCSS = this.readStyle(`${template}.css`);
         const sections = resolveSections(template, userSections);
         const options = deriveOptions(sections);
+        const slow = this.buildSlowTests(data);
         return {
           ...data,
+          projects: this.enrichProjects(
+            data,
+            slow,
+            sections,
+            slowTestThreshold ?? DEFAULT_OPTIONS.slowTestThreshold
+          ),
           options,
           sections,
           tagGroups: this.buildTagGroups(data),
-          slowTests: this.buildSlowTests(data),
+          slowTests: slow.ranked,
           baseCSS,
           templateCSS,
           chartjsScript: this.buildChartjsScript()
@@ -6563,6 +6601,7 @@ var init_engine = __esm({
             for (const test of suite.tests) {
               if (test.duration > 0) {
                 tests.push({
+                  id: test.id,
                   title: test.title,
                   suiteTitle: suite.title,
                   durationMs: test.duration,
@@ -6574,7 +6613,39 @@ var init_engine = __esm({
             }
           }
         }
-        return tests.sort((a, b) => b.durationMs - a.durationMs).slice(0, 10);
+        const sortedDurations = tests.map((t) => t.durationMs).sort((a, b) => a - b);
+        const medianMs = sortedDurations.length ? sortedDurations[Math.floor((sortedDurations.length - 1) / 2)] : 0;
+        const ranked = tests.sort((a, b) => b.durationMs - a.durationMs).slice(0, 10);
+        return { ranked, timedTotal: tests.length, medianMs };
+      }
+      /**
+       * Project the suite tree into its render form: attach each test's failure detail
+       * (by testId), root-cause chip, and slow rank. A pure projection — the source
+       * ReportData is never mutated. Gating lives here (not the template): a field is
+       * attached only when its section is on, so the template just checks presence.
+       * `failuresById` is built from the (possibly overflow-trimmed) `failures` array,
+       * so a trimmed failure yields no inline card; the overflow note points to the sidecar.
+       */
+      enrichProjects(data, slow, sections, slowTestThreshold) {
+        const failuresById = sections.failureDeepDive ? new Map(data.failures.map((f) => [f.testId, f])) : /* @__PURE__ */ new Map();
+        const chipById = sections.failureAnalysis ? new Map((data.classifications ?? []).map((c) => [c.testId, c])) : /* @__PURE__ */ new Map();
+        const slowRankById = /* @__PURE__ */ new Map();
+        if (sections.slowTests && slow.timedTotal > slowTestThreshold) {
+          const floorMs = slow.medianMs * SLOW_MEDIAN_FACTOR;
+          slow.ranked.filter((t) => t.durationMs >= floorMs).forEach((t, i) => slowRankById.set(t.id, i + 1));
+        }
+        const enrichTest = (t) => ({
+          ...t,
+          failure: failuresById.get(t.id),
+          chip: chipById.get(t.id),
+          slowRank: slowRankById.get(t.id)
+        });
+        const enrichSuite = (s) => ({
+          ...s,
+          suites: s.suites.map(enrichSuite),
+          tests: s.tests.map(enrichTest)
+        });
+        return data.projects.map((p) => ({ ...p, suites: p.suites.map(enrichSuite) }));
       }
       readStyle(filename) {
         const cached = this.styleCache.get(filename);
@@ -7598,7 +7669,7 @@ var init_PdfGenerator = __esm({
         }
         const templateLabel = source.kind === "builtin" ? source.id : source.label;
         logger.info(`Rendering template: ${templateLabel}`);
-        const html = source.kind === "builtin" ? this.templateEngine.render(renderData, source.id, options.sections) : this.templateEngine.renderFromPath(renderData, source.absolutePath);
+        const html = source.kind === "builtin" ? this.templateEngine.render(renderData, source.id, options.sections, options.slowTestThreshold) : this.templateEngine.renderFromPath(renderData, source.absolutePath, options.slowTestThreshold);
         const tempHtmlPath = await this.htmlWriter.write(html);
         const fileUrl = this.htmlWriter.toFileUrl(tempHtmlPath);
         try {
@@ -11747,28 +11818,6 @@ var init_zod = __esm({
   }
 });
 
-// src/config/defaults.ts
-var DEFAULT_OPTIONS;
-var init_defaults = __esm({
-  "src/config/defaults.ts"() {
-    "use strict";
-    init_cjs_shims();
-    DEFAULT_OPTIONS = {
-      outputFile: "playwright-report/{date}-report.pdf",
-      template: "minimal",
-      primaryColor: "#CC785C",
-      accentColor: "#3F7D58",
-      reportTitle: "Playwright Test Report",
-      open: false,
-      compressionLevel: "auto",
-      maxFileSizeMb: 8,
-      historySize: 10,
-      showTrend: true,
-      flakinessTopN: 5
-    };
-  }
-});
-
 // src/config/schema.ts
 function parseOptions(raw) {
   const result = ReporterOptionsSchema.safeParse(raw ?? {});
@@ -11856,6 +11905,7 @@ var init_schema = __esm({
       historySize: external_exports.number().int().min(2).optional().default(DEFAULT_OPTIONS.historySize),
       showTrend: external_exports.boolean().optional().default(DEFAULT_OPTIONS.showTrend),
       flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
+      slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
       failureAnalysis: failureAnalysisConfigSchema,
       templatePath: external_exports.union([
         external_exports.string().regex(/\.hbs$/, "templatePath must end with .hbs").refine((v) => v.slice(0, -4).trim().length > 0, "templatePath basename must not be empty"),
@@ -12074,6 +12124,14 @@ function classifyOne(f, model) {
 function classifyAll(failures, model) {
   return failures.map((f) => classifyOne(f, model));
 }
+function perTestClassifications(classified) {
+  return classified.map((c) => ({
+    testId: c.failure.testId,
+    category: c.category,
+    message: representativeMessage(c.failure.error.message),
+    strength: strengthOf(c.margin)
+  }));
+}
 function clusterClassified(classified) {
   const groups = /* @__PURE__ */ new Map();
   for (const c of classified) {
@@ -12246,6 +12304,7 @@ function runFailureAnalysis(reportData, options, cwd) {
   const analysed = reportData.failures.slice(0, cap);
   const model = loadModel(fa.autoUpdateModel);
   const classified = classifyAll(analysed, model);
+  reportData.classifications = perTestClassifications(classified);
   if (templatesConsumeAnalysis(options)) {
     reportData.analysis = analyseClassified(classified, reportData.failures.length, fa);
   }

package/dist/index.d.mts

@@ -234,6 +234,15 @@ interface ReporterOptions {
      * @default 5
      */
     flakinessTopN?: number;
+    /**
+     * Minimum number of timed tests before `SLOW` badges appear in the suite
+     * breakdown — below this, every test is trivially the "slowest", so badges
+     * stay hidden. On larger runs only genuine outliers (at least 2× the median
+     * test duration) are badged, so the badge stays rare. Set to 0 to drop the
+     * run-size gate (outliers are still required). Must be a non-negative integer.
+     * @default 10
+     */
+    slowTestThreshold?: number;
     /**
      * Path to a custom Handlebars (.hbs) template file. When set, takes
      * precedence over `template`. Relative paths resolve from `process.cwd()`.

package/dist/index.d.ts

@@ -234,6 +234,15 @@ interface ReporterOptions {
      * @default 5
      */
     flakinessTopN?: number;
+    /**
+     * Minimum number of timed tests before `SLOW` badges appear in the suite
+     * breakdown — below this, every test is trivially the "slowest", so badges
+     * stay hidden. On larger runs only genuine outliers (at least 2× the median
+     * test duration) are badged, so the badge stays rare. Set to 0 to drop the
+     * run-size gate (outliers are still required). Must be a non-negative integer.
+     * @default 10
+     */
+    slowTestThreshold?: number;
     /**
      * Path to a custom Handlebars (.hbs) template file. When set, takes
      * precedence over `template`. Relative paths resolve from `process.cwd()`.

package/dist/index.js

@@ -10329,7 +10329,8 @@ var DEFAULT_OPTIONS = {
   maxFileSizeMb: 8,
   historySize: 10,
   showTrend: true,
-  flakinessTopN: 5
+  flakinessTopN: 5,
+  slowTestThreshold: 10
 };
 
 // src/templates/sections.ts
@@ -10406,7 +10407,10 @@ var SECTION_DEFAULTS = {
     trend: true,
     requirementsMatrix: false,
     ciEnvironment: true,
-    suiteBreakdown: false,
+    // Suite breakdown now hosts the inline failure detail + slow badge, so the
+    // executive layout renders it too (compact: fullFailures stays false → no
+    // screenshots; failureAnalysis stays off → no per-test chip).
+    suiteBreakdown: true,
     failureDeepDive: true,
     failureAnalysis: false,
     slowTests: true,
@@ -10433,6 +10437,7 @@ function resolveSections(template, userSections) {
   }
   const result = { ...base, ...flat, ...perTemplate };
   if (!result.charts) result.trend = false;
+  if (!result.failureDeepDive) result.failureAnalysis = false;
   return result;
 }
 function allSectionsOn() {
@@ -10509,6 +10514,7 @@ var ReporterOptionsSchema = external_exports.object({
   historySize: external_exports.number().int().min(2).optional().default(DEFAULT_OPTIONS.historySize),
   showTrend: external_exports.boolean().optional().default(DEFAULT_OPTIONS.showTrend),
   flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
+  slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
   failureAnalysis: failureAnalysisConfigSchema,
   templatePath: external_exports.union([
     external_exports.string().regex(/\.hbs$/, "templatePath must end with .hbs").refine((v) => v.slice(0, -4).trim().length > 0, "templatePath basename must not be empty"),
@@ -11172,6 +11178,14 @@ function classifyOne(f, model) {
 function classifyAll(failures, model) {
   return failures.map((f) => classifyOne(f, model));
 }
+function perTestClassifications(classified) {
+  return classified.map((c) => ({
+    testId: c.failure.testId,
+    category: c.category,
+    message: representativeMessage(c.failure.error.message),
+    strength: strengthOf(c.margin)
+  }));
+}
 function clusterClassified(classified) {
   const groups = /* @__PURE__ */ new Map();
   for (const c of classified) {
@@ -11347,6 +11361,7 @@ function runFailureAnalysis(reportData, options, cwd) {
   const analysed = reportData.failures.slice(0, cap);
   const model = loadModel(fa.autoUpdateModel);
   const classified = classifyAll(analysed, model);
+  reportData.classifications = perTestClassifications(classified);
   if (templatesConsumeAnalysis(options)) {
     reportData.analysis = analyseClassified(classified, reportData.failures.length, fa);
   }
@@ -12033,6 +12048,7 @@ function jsonForInlineScript(value) {
 function isUnknownValue(v) {
   return !v || v === "unknown";
 }
+var SLOW_MEDIAN_FACTOR = 2;
 function deriveOptions(s) {
   return {
     showCharts: s.charts,
@@ -12069,17 +12085,17 @@ var TemplateEngine = class {
   setChartjsBundle(inline) {
     this.chartjsInline = inline;
   }
-  render(data, template, userSections) {
+  render(data, template, userSections, slowTestThreshold) {
     const layoutPath = import_path3.default.join(this.templatesDir, "layouts", `${template}.hbs`);
     if (!import_fs4.default.existsSync(layoutPath)) {
       throw new Error(`[reportforge] Template layout not found: ${layoutPath}`);
     }
     const layoutSource = import_fs4.default.readFileSync(layoutPath, "utf8");
     const compiledLayout = this.handlebars.compile(layoutSource);
-    const ctx = this.buildContext(data, template, userSections);
+    const ctx = this.buildContext(data, template, userSections, slowTestThreshold);
     return compiledLayout(ctx);
   }
-  renderFromPath(data, filePath) {
+  renderFromPath(data, filePath, slowTestThreshold) {
     if (!this.customTemplateCache.has(filePath)) {
       if (!import_fs4.default.existsSync(filePath)) {
         throw new Error(`[reportforge] Custom template not found: ${filePath}`);
@@ -12088,32 +12104,41 @@ var TemplateEngine = class {
       this.customTemplateCache.set(filePath, this.handlebars.compile(source));
     }
     const compiledFn = this.customTemplateCache.get(filePath);
-    return compiledFn(this.buildCustomContext(data));
+    return compiledFn(this.buildCustomContext(data, slowTestThreshold));
   }
-  buildCustomContext(data) {
+  buildCustomContext(data, slowTestThreshold) {
     const sections = allSectionsOn();
+    const slow = this.buildSlowTests(data);
     return {
       ...data,
+      projects: this.enrichProjects(data, slow, sections, slowTestThreshold ?? DEFAULT_OPTIONS.slowTestThreshold),
       options: deriveOptions(sections),
       sections,
       tagGroups: this.buildTagGroups(data),
-      slowTests: this.buildSlowTests(data),
+      slowTests: slow.ranked,
       baseCSS: this.fontsBundleCss + "\n" + this.readStyle("base.css"),
       templateCSS: "",
       chartjsScript: this.buildChartjsScript()
     };
   }
-  buildContext(data, template, userSections) {
+  buildContext(data, template, userSections, slowTestThreshold) {
     const baseCSS = this.fontsBundleCss + "\n" + this.readStyle("base.css");
     const templateCSS = this.readStyle(`${template}.css`);
     const sections = resolveSections(template, userSections);
     const options = deriveOptions(sections);
+    const slow = this.buildSlowTests(data);
     return {
       ...data,
+      projects: this.enrichProjects(
+        data,
+        slow,
+        sections,
+        slowTestThreshold ?? DEFAULT_OPTIONS.slowTestThreshold
+      ),
       options,
       sections,
       tagGroups: this.buildTagGroups(data),
-      slowTests: this.buildSlowTests(data),
+      slowTests: slow.ranked,
       baseCSS,
       templateCSS,
       chartjsScript: this.buildChartjsScript()
@@ -12150,6 +12175,7 @@ var TemplateEngine = class {
         for (const test of suite.tests) {
           if (test.duration > 0) {
             tests.push({
+              id: test.id,
               title: test.title,
               suiteTitle: suite.title,
               durationMs: test.duration,
@@ -12161,7 +12187,39 @@ var TemplateEngine = class {
         }
       }
     }
-    return tests.sort((a, b) => b.durationMs - a.durationMs).slice(0, 10);
+    const sortedDurations = tests.map((t) => t.durationMs).sort((a, b) => a - b);
+    const medianMs = sortedDurations.length ? sortedDurations[Math.floor((sortedDurations.length - 1) / 2)] : 0;
+    const ranked = tests.sort((a, b) => b.durationMs - a.durationMs).slice(0, 10);
+    return { ranked, timedTotal: tests.length, medianMs };
+  }
+  /**
+   * Project the suite tree into its render form: attach each test's failure detail
+   * (by testId), root-cause chip, and slow rank. A pure projection — the source
+   * ReportData is never mutated. Gating lives here (not the template): a field is
+   * attached only when its section is on, so the template just checks presence.
+   * `failuresById` is built from the (possibly overflow-trimmed) `failures` array,
+   * so a trimmed failure yields no inline card; the overflow note points to the sidecar.
+   */
+  enrichProjects(data, slow, sections, slowTestThreshold) {
+    const failuresById = sections.failureDeepDive ? new Map(data.failures.map((f) => [f.testId, f])) : /* @__PURE__ */ new Map();
+    const chipById = sections.failureAnalysis ? new Map((data.classifications ?? []).map((c) => [c.testId, c])) : /* @__PURE__ */ new Map();
+    const slowRankById = /* @__PURE__ */ new Map();
+    if (sections.slowTests && slow.timedTotal > slowTestThreshold) {
+      const floorMs = slow.medianMs * SLOW_MEDIAN_FACTOR;
+      slow.ranked.filter((t) => t.durationMs >= floorMs).forEach((t, i) => slowRankById.set(t.id, i + 1));
+    }
+    const enrichTest = (t) => ({
+      ...t,
+      failure: failuresById.get(t.id),
+      chip: chipById.get(t.id),
+      slowRank: slowRankById.get(t.id)
+    });
+    const enrichSuite = (s) => ({
+      ...s,
+      suites: s.suites.map(enrichSuite),
+      tests: s.tests.map(enrichTest)
+    });
+    return data.projects.map((p) => ({ ...p, suites: p.suites.map(enrichSuite) }));
   }
   readStyle(filename) {
     const cached = this.styleCache.get(filename);
@@ -12840,7 +12898,7 @@ var PdfGenerator = class {
     }
     const templateLabel = source.kind === "builtin" ? source.id : source.label;
     logger.info(`Rendering template: ${templateLabel}`);
-    const html = source.kind === "builtin" ? this.templateEngine.render(renderData, source.id, options.sections) : this.templateEngine.renderFromPath(renderData, source.absolutePath);
+    const html = source.kind === "builtin" ? this.templateEngine.render(renderData, source.id, options.sections, options.slowTestThreshold) : this.templateEngine.renderFromPath(renderData, source.absolutePath, options.slowTestThreshold);
     const tempHtmlPath = await this.htmlWriter.write(html);
     const fileUrl = this.htmlWriter.toFileUrl(tempHtmlPath);
     try {
@@ -13237,7 +13295,7 @@ var PdfReporter = class {
     this.dataCollector = new DataCollector();
     this.pdfGenerator = new PdfGenerator();
     this.options = parseOptions(rawOptions);
-    const version = true ? "0.6.3" : "0.x";
+    const version = true ? "0.7.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,