@reportforge/playwright-pdf 0.24.0 → 0.25.0

package/dist/index.js

@@ -14230,11 +14230,35 @@ var NETWORK_TIMEOUT_MS3 = 8e3;
 var LIVE_DRAIN_DEADLINE_MS = 1e4;
 var MAX_FLUSH_MS = 3e4;
 var WARN_THROTTLE_MS = 3e4;
+var TREE_UPDATE_WEIGHT = 25;
+function redactTestUpdate(update, redact) {
+  if (update.title !== void 0) update.title = redact(update.title);
+  if (update.currentStep !== void 0) update.currentStep = redact(update.currentStep);
+  if (update.file !== void 0) update.file = redact(update.file);
+  if (update.suitePath) update.suitePath = update.suitePath.map(redact);
+  if (update.projectName !== void 0) update.projectName = redact(update.projectName);
+  if (update.steps) redactStepNodes(update.steps, redact);
+  if (update.errors) update.errors.forEach((e) => redactError(e, redact));
+}
+function redactStepNodes(nodes, redact) {
+  for (const node of nodes) {
+    node.t = redact(node.t);
+    if (node.err) redactError(node.err, redact);
+    if (node.ch) redactStepNodes(node.ch, redact);
+  }
+}
+function redactError(err, redact) {
+  err.message = redact(err.message);
+  if (err.stack !== void 0) err.stack = redact(err.stack);
+  if (err.snippet !== void 0) err.snippet = redact(err.snippet);
+}
 var LiveStreamer = class {
   constructor(config) {
     this.config = config;
     this.testBuffer = [];
     this.eventBuffer = [];
+    /** Weighted size of the buffers (tree-bearing updates count TREE_UPDATE_WEIGHT). */
+    this.bufferWeight = 0;
     /** Monotonic per-shard event counter → stable `{shardKey}:{seq}` event ids. */
     this.eventSeq = 0;
     /**
@@ -14260,13 +14284,11 @@ var LiveStreamer = class {
   }
   enqueueTest(update) {
     if (!this.enabled) return;
-    if (this.config.redact) {
-      if (update.title !== void 0) update.title = this.config.redact(update.title);
-      if (update.currentStep !== void 0) update.currentStep = this.config.redact(update.currentStep);
-    }
+    if (this.config.redact) redactTestUpdate(update, this.config.redact);
     const prevRetry = this.testStates.get(update.id)?.retry;
     this.testStates.set(update.id, { status: update.status, retry: update.retry ?? prevRetry });
     this.testBuffer.push(update);
+    this.bufferWeight += update.steps ? TREE_UPDATE_WEIGHT : 1;
     this.capPreLicenseBuffer();
     this.scheduleFlush();
   }
@@ -14278,6 +14300,7 @@ var LiveStreamer = class {
     }
     event.id = `${this.config.shardKey}:${this.eventSeq++}`;
     this.eventBuffer.push(event);
+    this.bufferWeight += 1;
     this.capPreLicenseBuffer();
     this.scheduleFlush();
   }
@@ -14395,9 +14418,13 @@ var LiveStreamer = class {
     if (dropEvents > 0) this.eventBuffer.splice(0, dropEvents);
     overflow -= dropEvents;
     if (overflow > 0) this.testBuffer.splice(0, overflow);
+    this.bufferWeight = this.currentBufferWeight();
+  }
+  currentBufferWeight() {
+    return this.eventBuffer.length + this.testBuffer.reduce((w, t) => w + (t.steps ? TREE_UPDATE_WEIGHT : 1), 0);
   }
   scheduleFlush() {
-    if (this.testBuffer.length + this.eventBuffer.length >= this.flushMaxBatch) {
+    if (this.bufferWeight >= this.flushMaxBatch) {
       void this.flush("running");
       return;
     }
@@ -14418,6 +14445,7 @@ var LiveStreamer = class {
     if (status !== "finished" && tests.length === 0 && events.length === 0) return;
     this.testBuffer = [];
     this.eventBuffer = [];
+    this.bufferWeight = 0;
     const body = {
       runId: this.config.runId,
       shardKey: this.config.shardKey,
@@ -14452,6 +14480,7 @@ var LiveStreamer = class {
       this.enabled = false;
       this.testBuffer = [];
       this.eventBuffer = [];
+      this.bufferWeight = 0;
       logger.debug("Live streaming disabled \u2014 no active license or live entitlement.");
       return false;
     }
@@ -14538,25 +14567,213 @@ function shardKeyOf(shard) {
 
 // src/live/event-map.ts
 init_cjs_shims();
+
+// src/live/step-tree.ts
+init_cjs_shims();
+var MAX_TREE_DEPTH = 10;
+var MAX_TREE_NODES = 150;
+var MAX_TREE_JSON = 24e3;
+var MAX_NODE_TITLE = 200;
+var MAX_ERRORS = 3;
+var MAX_ERR_MESSAGE = 2e3;
+var MAX_ERR_STACK = 8192;
+var MAX_ERR_SNIPPET = 4096;
+var isHook = (c) => c === "hook" || c === "fixture";
+function flatten2(steps) {
+  const out = [];
+  const walk = (nodes, depth, ancestors) => {
+    for (const s of nodes ?? []) {
+      const index = out.length;
+      out.push({
+        raw: s,
+        category: s.category ?? "",
+        depth,
+        hasError: s.error != null,
+        ancestors
+      });
+      if (s.steps?.length) walk(s.steps, depth + 1, [...ancestors, index]);
+    }
+  };
+  walk(steps ?? [], 0, []);
+  return out;
+}
+var inHookSubtree2 = (flat, f) => isHook(f.category) || f.ancestors.some((a) => isHook(flat[a].category));
+function pickFailingIdx2(flat) {
+  const pick = (allowTeardown) => {
+    let idx = -1;
+    for (let i = 0; i < flat.length; i++) {
+      const f = flat[i];
+      if (!f.hasError || !allowTeardown && inHookSubtree2(flat, f)) continue;
+      if (idx === -1 || f.depth >= flat[idx].depth) idx = i;
+    }
+    return idx;
+  };
+  const body = pick(false);
+  return body >= 0 ? body : pick(true);
+}
+function mapCategory(category) {
+  if (category === "test.step") return "step";
+  if (category === "expect") return "expect";
+  if (isHook(category)) return "hook";
+  return "api";
+}
+function buildErrorInfo(err) {
+  if (!err?.message) return void 0;
+  return {
+    message: clampWithEllipsis(stripAnsi(err.message), MAX_ERR_MESSAGE),
+    ...err.stack ? { stack: clampWithEllipsis(stripAnsi(err.stack), MAX_ERR_STACK) } : {},
+    ...err.snippet ? { snippet: clampWithEllipsis(stripAnsi(err.snippet), MAX_ERR_SNIPPET) } : {}
+  };
+}
+function mapResultErrors(errors) {
+  if (!errors?.length) return void 0;
+  const out = errors.slice(0, MAX_ERRORS).map((e) => buildErrorInfo(e)).filter((e) => e !== void 0);
+  return out.length > 0 ? out : void 0;
+}
+function buildLiveStepTree(steps) {
+  if (!steps?.length) return void 0;
+  const flat = flatten2(steps);
+  if (flat.length === 0) return void 0;
+  const failingIdx = pickFailingIdx2(flat);
+  const failingPath = /* @__PURE__ */ new Set();
+  if (failingIdx >= 0) {
+    failingPath.add(flat[failingIdx].raw);
+    for (const a of flat[failingIdx].ancestors) failingPath.add(flat[a].raw);
+  }
+  const failingLeaf = failingIdx >= 0 ? flat[failingIdx].raw : void 0;
+  for (const level of [0, 1, 2, 3]) {
+    const budget = { left: MAX_TREE_NODES };
+    const tree = buildChildren(steps, {
+      level,
+      depth: 0,
+      underHook: false,
+      underApiOrExpect: false,
+      failingPath,
+      failingLeaf,
+      budget
+    });
+    if (tree.length === 0) return void 0;
+    if (budget.left >= 0 && JSON.stringify(tree).length <= MAX_TREE_JSON) return tree;
+  }
+  return void 0;
+}
+function keepNode(s, ctx) {
+  if (ctx.failingPath.has(s)) return true;
+  if (!s.title) return false;
+  const c = s.category ?? "";
+  if (isHook(c) || ctx.underHook) return false;
+  if (c === "test.step") return true;
+  if (ctx.underApiOrExpect) return false;
+  if (c === "expect") return ctx.level < 2;
+  if (c === "pw:api") return ctx.level < 1;
+  return false;
+}
+function containsFailing(s, leaf) {
+  if (!leaf) return false;
+  if (s === leaf) return true;
+  return (s.steps ?? []).some((child) => containsFailing(child, leaf));
+}
+function buildChildren(nodes, ctx) {
+  const out = [];
+  for (const s of nodes ?? []) {
+    if (ctx.budget.left <= 0) {
+      ctx.budget.left = -1;
+      break;
+    }
+    const c = s.category ?? "";
+    if (!keepNode(s, ctx)) {
+      if (containsFailing(s, ctx.failingLeaf)) {
+        out.push(
+          ...buildChildren(s.steps, {
+            ...ctx,
+            underHook: ctx.underHook || isHook(c),
+            underApiOrExpect: ctx.underApiOrExpect || c === "pw:api" || c === "expect"
+          })
+        );
+      }
+      continue;
+    }
+    ctx.budget.left -= 1;
+    const node = {
+      t: clampWithEllipsis(stripAnsi(s.title ?? ""), MAX_NODE_TITLE),
+      c: mapCategory(c),
+      ...Number.isFinite(s.duration) && s.duration >= 0 ? { d: Math.round(s.duration) } : {},
+      ...s.error != null ? { s: "failed" } : {},
+      ...s === ctx.failingLeaf ? errField(s) : {}
+    };
+    if (s.steps?.length) {
+      if (ctx.depth + 1 >= MAX_TREE_DEPTH) {
+        if (!node.err && containsFailing(s, ctx.failingLeaf) && s !== ctx.failingLeaf) {
+          const hoisted = errField(ctx.failingLeaf);
+          if (hoisted.err) {
+            node.err = hoisted.err;
+            node.s = "failed";
+          }
+        }
+      } else {
+        const ch = buildChildren(s.steps, {
+          ...ctx,
+          depth: ctx.depth + 1,
+          underHook: ctx.underHook || isHook(c),
+          underApiOrExpect: ctx.underApiOrExpect || c === "pw:api" || c === "expect"
+        });
+        if (ch.length > 0) node.ch = ch;
+      }
+    }
+    out.push(node);
+  }
+  return out;
+}
+function errField(s) {
+  const err = buildErrorInfo(s.error);
+  return err ? { err } : {};
+}
+
+// src/live/event-map.ts
 var MAX_TITLE_CHARS2 = 200;
 var MAX_STEP_TITLE_CHARS = 200;
 var MAX_CONSOLE_CHARS = 2048;
+var MAX_FILE_CHARS = 300;
+var MAX_PROJECT_CHARS = 100;
+var MAX_SUITE_SEGMENTS = 10;
+function suiteIdentity(test) {
+  const path15 = typeof test.titlePath === "function" ? test.titlePath() : [];
+  if (!Array.isArray(path15) || path15.length < 4) return {};
+  const [, project, file, ...rest] = path15;
+  const describes = rest.slice(0, -1);
+  const out = {};
+  if (typeof file === "string" && file) {
+    out.file = clampWithEllipsis(file.replace(/\\/g, "/"), MAX_FILE_CHARS);
+  }
+  const segs = describes.filter((s) => typeof s === "string" && s.length > 0).slice(0, MAX_SUITE_SEGMENTS).map((s) => clampWithEllipsis(s, MAX_STEP_TITLE_CHARS));
+  if (segs.length > 0) out.suitePath = segs;
+  if (typeof project === "string" && project) {
+    out.projectName = clampWithEllipsis(project, MAX_PROJECT_CHARS);
+  }
+  return out;
+}
 function mapTestBegin(test, shardKey) {
   return {
     id: test.id,
     title: clampWithEllipsis(test.title ?? "", MAX_TITLE_CHARS2),
     status: "running",
-    shardKey
+    shardKey,
+    ...suiteIdentity(test)
   };
 }
 function mapTestEnd(test, result, shardKey) {
+  const steps = buildLiveStepTree(result.steps);
+  const errors = mapResultErrors(result.errors);
   return {
     id: test.id,
     title: clampWithEllipsis(test.title ?? "", MAX_TITLE_CHARS2),
     status: result.status,
     durationMs: result.duration,
     retry: result.retry,
-    shardKey
+    shardKey,
+    ...suiteIdentity(test),
+    ...steps ? { steps } : {},
+    ...errors ? { errors } : {}
   };
 }
 function isLifecycleStep(step) {
@@ -14606,7 +14823,11 @@ function mapStep(testId, step, phase, shardKey) {
     startedAt: step.startTime?.getTime(),
     // Nesting depth (test.step ancestors) so the page indents children under their
     // parent step. 0 → flat, so a test without test.steps renders as a flat trail.
-    depth: testStepDepth2(step)
+    depth: testStepDepth2(step),
+    // Category so the trail styles pw:api actions and expects distinctly. Hooks
+    // and fixtures never reach here non-errored (shouldEmitStep drops them); an
+    // errored one maps to 'api' — the trail has no dedicated hook style.
+    category: step.category === "test.step" ? "step" : step.category === "expect" ? "expect" : "api"
   };
 }
 function mapConsole(kind, chunk, testId, shardKey) {
@@ -14638,7 +14859,7 @@ var PdfReporter = class {
     if (this.options.redact.enabled) {
       this.redactor = new Redactor(this.options.redact);
     }
-    this.version = true ? "0.24.0" : "0.x";
+    this.version = true ? "0.25.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/dist/index.mjs

@@ -14231,11 +14231,35 @@ var NETWORK_TIMEOUT_MS3 = 8e3;
 var LIVE_DRAIN_DEADLINE_MS = 1e4;
 var MAX_FLUSH_MS = 3e4;
 var WARN_THROTTLE_MS = 3e4;
+var TREE_UPDATE_WEIGHT = 25;
+function redactTestUpdate(update, redact) {
+  if (update.title !== void 0) update.title = redact(update.title);
+  if (update.currentStep !== void 0) update.currentStep = redact(update.currentStep);
+  if (update.file !== void 0) update.file = redact(update.file);
+  if (update.suitePath) update.suitePath = update.suitePath.map(redact);
+  if (update.projectName !== void 0) update.projectName = redact(update.projectName);
+  if (update.steps) redactStepNodes(update.steps, redact);
+  if (update.errors) update.errors.forEach((e) => redactError(e, redact));
+}
+function redactStepNodes(nodes, redact) {
+  for (const node of nodes) {
+    node.t = redact(node.t);
+    if (node.err) redactError(node.err, redact);
+    if (node.ch) redactStepNodes(node.ch, redact);
+  }
+}
+function redactError(err, redact) {
+  err.message = redact(err.message);
+  if (err.stack !== void 0) err.stack = redact(err.stack);
+  if (err.snippet !== void 0) err.snippet = redact(err.snippet);
+}
 var LiveStreamer = class {
   constructor(config) {
     this.config = config;
     this.testBuffer = [];
     this.eventBuffer = [];
+    /** Weighted size of the buffers (tree-bearing updates count TREE_UPDATE_WEIGHT). */
+    this.bufferWeight = 0;
     /** Monotonic per-shard event counter → stable `{shardKey}:{seq}` event ids. */
     this.eventSeq = 0;
     /**
@@ -14261,13 +14285,11 @@ var LiveStreamer = class {
   }
   enqueueTest(update) {
     if (!this.enabled) return;
-    if (this.config.redact) {
-      if (update.title !== void 0) update.title = this.config.redact(update.title);
-      if (update.currentStep !== void 0) update.currentStep = this.config.redact(update.currentStep);
-    }
+    if (this.config.redact) redactTestUpdate(update, this.config.redact);
     const prevRetry = this.testStates.get(update.id)?.retry;
     this.testStates.set(update.id, { status: update.status, retry: update.retry ?? prevRetry });
     this.testBuffer.push(update);
+    this.bufferWeight += update.steps ? TREE_UPDATE_WEIGHT : 1;
     this.capPreLicenseBuffer();
     this.scheduleFlush();
   }
@@ -14279,6 +14301,7 @@ var LiveStreamer = class {
     }
     event.id = `${this.config.shardKey}:${this.eventSeq++}`;
     this.eventBuffer.push(event);
+    this.bufferWeight += 1;
     this.capPreLicenseBuffer();
     this.scheduleFlush();
   }
@@ -14396,9 +14419,13 @@ var LiveStreamer = class {
     if (dropEvents > 0) this.eventBuffer.splice(0, dropEvents);
     overflow -= dropEvents;
     if (overflow > 0) this.testBuffer.splice(0, overflow);
+    this.bufferWeight = this.currentBufferWeight();
+  }
+  currentBufferWeight() {
+    return this.eventBuffer.length + this.testBuffer.reduce((w, t) => w + (t.steps ? TREE_UPDATE_WEIGHT : 1), 0);
   }
   scheduleFlush() {
-    if (this.testBuffer.length + this.eventBuffer.length >= this.flushMaxBatch) {
+    if (this.bufferWeight >= this.flushMaxBatch) {
       void this.flush("running");
       return;
     }
@@ -14419,6 +14446,7 @@ var LiveStreamer = class {
     if (status !== "finished" && tests.length === 0 && events.length === 0) return;
     this.testBuffer = [];
     this.eventBuffer = [];
+    this.bufferWeight = 0;
     const body = {
       runId: this.config.runId,
       shardKey: this.config.shardKey,
@@ -14453,6 +14481,7 @@ var LiveStreamer = class {
       this.enabled = false;
       this.testBuffer = [];
       this.eventBuffer = [];
+      this.bufferWeight = 0;
       logger.debug("Live streaming disabled \u2014 no active license or live entitlement.");
       return false;
     }
@@ -14539,25 +14568,213 @@ function shardKeyOf(shard) {
 
 // src/live/event-map.ts
 init_esm_shims();
+
+// src/live/step-tree.ts
+init_esm_shims();
+var MAX_TREE_DEPTH = 10;
+var MAX_TREE_NODES = 150;
+var MAX_TREE_JSON = 24e3;
+var MAX_NODE_TITLE = 200;
+var MAX_ERRORS = 3;
+var MAX_ERR_MESSAGE = 2e3;
+var MAX_ERR_STACK = 8192;
+var MAX_ERR_SNIPPET = 4096;
+var isHook = (c) => c === "hook" || c === "fixture";
+function flatten2(steps) {
+  const out = [];
+  const walk = (nodes, depth, ancestors) => {
+    for (const s of nodes ?? []) {
+      const index = out.length;
+      out.push({
+        raw: s,
+        category: s.category ?? "",
+        depth,
+        hasError: s.error != null,
+        ancestors
+      });
+      if (s.steps?.length) walk(s.steps, depth + 1, [...ancestors, index]);
+    }
+  };
+  walk(steps ?? [], 0, []);
+  return out;
+}
+var inHookSubtree2 = (flat, f) => isHook(f.category) || f.ancestors.some((a) => isHook(flat[a].category));
+function pickFailingIdx2(flat) {
+  const pick = (allowTeardown) => {
+    let idx = -1;
+    for (let i = 0; i < flat.length; i++) {
+      const f = flat[i];
+      if (!f.hasError || !allowTeardown && inHookSubtree2(flat, f)) continue;
+      if (idx === -1 || f.depth >= flat[idx].depth) idx = i;
+    }
+    return idx;
+  };
+  const body = pick(false);
+  return body >= 0 ? body : pick(true);
+}
+function mapCategory(category) {
+  if (category === "test.step") return "step";
+  if (category === "expect") return "expect";
+  if (isHook(category)) return "hook";
+  return "api";
+}
+function buildErrorInfo(err) {
+  if (!err?.message) return void 0;
+  return {
+    message: clampWithEllipsis(stripAnsi(err.message), MAX_ERR_MESSAGE),
+    ...err.stack ? { stack: clampWithEllipsis(stripAnsi(err.stack), MAX_ERR_STACK) } : {},
+    ...err.snippet ? { snippet: clampWithEllipsis(stripAnsi(err.snippet), MAX_ERR_SNIPPET) } : {}
+  };
+}
+function mapResultErrors(errors) {
+  if (!errors?.length) return void 0;
+  const out = errors.slice(0, MAX_ERRORS).map((e) => buildErrorInfo(e)).filter((e) => e !== void 0);
+  return out.length > 0 ? out : void 0;
+}
+function buildLiveStepTree(steps) {
+  if (!steps?.length) return void 0;
+  const flat = flatten2(steps);
+  if (flat.length === 0) return void 0;
+  const failingIdx = pickFailingIdx2(flat);
+  const failingPath = /* @__PURE__ */ new Set();
+  if (failingIdx >= 0) {
+    failingPath.add(flat[failingIdx].raw);
+    for (const a of flat[failingIdx].ancestors) failingPath.add(flat[a].raw);
+  }
+  const failingLeaf = failingIdx >= 0 ? flat[failingIdx].raw : void 0;
+  for (const level of [0, 1, 2, 3]) {
+    const budget = { left: MAX_TREE_NODES };
+    const tree = buildChildren(steps, {
+      level,
+      depth: 0,
+      underHook: false,
+      underApiOrExpect: false,
+      failingPath,
+      failingLeaf,
+      budget
+    });
+    if (tree.length === 0) return void 0;
+    if (budget.left >= 0 && JSON.stringify(tree).length <= MAX_TREE_JSON) return tree;
+  }
+  return void 0;
+}
+function keepNode(s, ctx) {
+  if (ctx.failingPath.has(s)) return true;
+  if (!s.title) return false;
+  const c = s.category ?? "";
+  if (isHook(c) || ctx.underHook) return false;
+  if (c === "test.step") return true;
+  if (ctx.underApiOrExpect) return false;
+  if (c === "expect") return ctx.level < 2;
+  if (c === "pw:api") return ctx.level < 1;
+  return false;
+}
+function containsFailing(s, leaf) {
+  if (!leaf) return false;
+  if (s === leaf) return true;
+  return (s.steps ?? []).some((child) => containsFailing(child, leaf));
+}
+function buildChildren(nodes, ctx) {
+  const out = [];
+  for (const s of nodes ?? []) {
+    if (ctx.budget.left <= 0) {
+      ctx.budget.left = -1;
+      break;
+    }
+    const c = s.category ?? "";
+    if (!keepNode(s, ctx)) {
+      if (containsFailing(s, ctx.failingLeaf)) {
+        out.push(
+          ...buildChildren(s.steps, {
+            ...ctx,
+            underHook: ctx.underHook || isHook(c),
+            underApiOrExpect: ctx.underApiOrExpect || c === "pw:api" || c === "expect"
+          })
+        );
+      }
+      continue;
+    }
+    ctx.budget.left -= 1;
+    const node = {
+      t: clampWithEllipsis(stripAnsi(s.title ?? ""), MAX_NODE_TITLE),
+      c: mapCategory(c),
+      ...Number.isFinite(s.duration) && s.duration >= 0 ? { d: Math.round(s.duration) } : {},
+      ...s.error != null ? { s: "failed" } : {},
+      ...s === ctx.failingLeaf ? errField(s) : {}
+    };
+    if (s.steps?.length) {
+      if (ctx.depth + 1 >= MAX_TREE_DEPTH) {
+        if (!node.err && containsFailing(s, ctx.failingLeaf) && s !== ctx.failingLeaf) {
+          const hoisted = errField(ctx.failingLeaf);
+          if (hoisted.err) {
+            node.err = hoisted.err;
+            node.s = "failed";
+          }
+        }
+      } else {
+        const ch = buildChildren(s.steps, {
+          ...ctx,
+          depth: ctx.depth + 1,
+          underHook: ctx.underHook || isHook(c),
+          underApiOrExpect: ctx.underApiOrExpect || c === "pw:api" || c === "expect"
+        });
+        if (ch.length > 0) node.ch = ch;
+      }
+    }
+    out.push(node);
+  }
+  return out;
+}
+function errField(s) {
+  const err = buildErrorInfo(s.error);
+  return err ? { err } : {};
+}
+
+// src/live/event-map.ts
 var MAX_TITLE_CHARS2 = 200;
 var MAX_STEP_TITLE_CHARS = 200;
 var MAX_CONSOLE_CHARS = 2048;
+var MAX_FILE_CHARS = 300;
+var MAX_PROJECT_CHARS = 100;
+var MAX_SUITE_SEGMENTS = 10;
+function suiteIdentity(test) {
+  const path16 = typeof test.titlePath === "function" ? test.titlePath() : [];
+  if (!Array.isArray(path16) || path16.length < 4) return {};
+  const [, project, file, ...rest] = path16;
+  const describes = rest.slice(0, -1);
+  const out = {};
+  if (typeof file === "string" && file) {
+    out.file = clampWithEllipsis(file.replace(/\\/g, "/"), MAX_FILE_CHARS);
+  }
+  const segs = describes.filter((s) => typeof s === "string" && s.length > 0).slice(0, MAX_SUITE_SEGMENTS).map((s) => clampWithEllipsis(s, MAX_STEP_TITLE_CHARS));
+  if (segs.length > 0) out.suitePath = segs;
+  if (typeof project === "string" && project) {
+    out.projectName = clampWithEllipsis(project, MAX_PROJECT_CHARS);
+  }
+  return out;
+}
 function mapTestBegin(test, shardKey) {
   return {
     id: test.id,
     title: clampWithEllipsis(test.title ?? "", MAX_TITLE_CHARS2),
     status: "running",
-    shardKey
+    shardKey,
+    ...suiteIdentity(test)
   };
 }
 function mapTestEnd(test, result, shardKey) {
+  const steps = buildLiveStepTree(result.steps);
+  const errors = mapResultErrors(result.errors);
   return {
     id: test.id,
     title: clampWithEllipsis(test.title ?? "", MAX_TITLE_CHARS2),
     status: result.status,
     durationMs: result.duration,
     retry: result.retry,
-    shardKey
+    shardKey,
+    ...suiteIdentity(test),
+    ...steps ? { steps } : {},
+    ...errors ? { errors } : {}
   };
 }
 function isLifecycleStep(step) {
@@ -14607,7 +14824,11 @@ function mapStep(testId, step, phase, shardKey) {
     startedAt: step.startTime?.getTime(),
     // Nesting depth (test.step ancestors) so the page indents children under their
     // parent step. 0 → flat, so a test without test.steps renders as a flat trail.
-    depth: testStepDepth2(step)
+    depth: testStepDepth2(step),
+    // Category so the trail styles pw:api actions and expects distinctly. Hooks
+    // and fixtures never reach here non-errored (shouldEmitStep drops them); an
+    // errored one maps to 'api' — the trail has no dedicated hook style.
+    category: step.category === "test.step" ? "step" : step.category === "expect" ? "expect" : "api"
   };
 }
 function mapConsole(kind, chunk, testId, shardKey) {
@@ -14639,7 +14860,7 @@ var PdfReporter = class {
     if (this.options.redact.enabled) {
       this.redactor = new Redactor(this.options.redact);
     }
-    this.version = true ? "0.24.0" : "0.x";
+    this.version = true ? "0.25.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,