@testspectra/reporter 1.3.5 → 1.3.7

package/dist/formatter.d.ts

@@ -36,3 +36,28 @@ export declare function formatAssertion(assertionKey: AssertionKey | string, tar
  * Parses raw JSON action/assertion payloads or native orchestrator payloads into English sentences.
  */
 export declare function parseAndFormat(cmdText: string): string;
+/** The key a `Spectra.step` group is stored under: its path, outermost first. */
+export declare function groupKey(path: readonly string[]): string;
+/** Reads `groupPath` from a step event's JSON payload (absent outside any `Spectra.step`). */
+export declare function readGroupPath(payloadText: string): string[] | undefined;
+/** One printed line of a test case's step tree: a `Spectra.step` heading or an action/assertion. */
+export interface StepTreeLine {
+    kind: 'group' | 'step';
+    text: string;
+    depth: number;
+    passed: boolean;
+    duration?: number;
+}
+/**
+ * Lays a test case's steps out as a tree: each `Spectra.step` heading once, before the first step
+ * it holds, and every step indented under the groups it ran inside.
+ */
+export declare function stepTree(steps: readonly {
+    text: string;
+    duration: number;
+    passed: boolean;
+    groupPath?: string[];
+}[], groups?: Record<string, {
+    passed: boolean;
+    duration: number;
+}>): StepTreeLine[];

package/dist/formatter.js

@@ -315,6 +315,9 @@ export function parseAndFormat(cmdText) {
     try {
         const payload = JSON.parse(cmdText);
         const target = payload.target;
+        // A plugin's step carries its own wording.
+        if (typeof payload.label === 'string' && payload.label)
+            return payload.label;
         if (payload.type === 'action') {
             return formatAction(payload.key, target, mapActionArgs(payload.key, payload.args || []));
         }
@@ -395,3 +398,44 @@ export function parseAndFormat(cmdText) {
         return cmdText;
     }
 }
+/** The key a `Spectra.step` group is stored under: its path, outermost first. */
+export function groupKey(path) {
+    return path.join(' › ');
+}
+/** Reads `groupPath` from a step event's JSON payload (absent outside any `Spectra.step`). */
+export function readGroupPath(payloadText) {
+    try {
+        const payload = JSON.parse(payloadText);
+        return Array.isArray(payload.groupPath) ? payload.groupPath.map(String) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Lays a test case's steps out as a tree: each `Spectra.step` heading once, before the first step
+ * it holds, and every step indented under the groups it ran inside.
+ */
+export function stepTree(steps, groups = {}) {
+    const lines = [];
+    let open = [];
+    for (const step of steps) {
+        const path = step.groupPath ?? [];
+        let shared = 0;
+        while (shared < open.length && shared < path.length && open[shared] === path[shared])
+            shared++;
+        for (let depth = shared; depth < path.length; depth++) {
+            const result = groups[groupKey(path.slice(0, depth + 1))];
+            lines.push({
+                kind: 'group',
+                text: path[depth],
+                depth,
+                passed: result ? result.passed : step.passed,
+                duration: result?.duration,
+            });
+        }
+        open = path;
+        lines.push({ kind: 'step', text: step.text, depth: path.length, passed: step.passed, duration: step.duration });
+    }
+    return lines;
+}

package/dist/parser.js

@@ -1,4 +1,4 @@
-import { parseAndFormat } from './formatter.js';
+import { parseAndFormat, readGroupPath } from './formatter.js';
 /**
  * Strips ANSI color and control escape sequences from a string.
  */
@@ -119,6 +119,28 @@ export class TestOutputParser {
             specPath = specPath.replace(/^[a-zA-Z0-9_-]+\s+-\s+/, '').trim();
             return { type: 'spec_file', specPath };
         }
+        // 2.5 `Spectra.step` group boundaries: "[TESTSPECTRA_GROUP_START|PASS|FAIL] {title, path, depth}"
+        const group = raw.match(/^\[TESTSPECTRA_GROUP_(START|PASS|FAIL)\]\s*(.*)$/);
+        if (group) {
+            const durationMatch = group[2].match(/\(([^)]+)ms\)$/);
+            try {
+                const payload = JSON.parse(group[2].replace(/\s*\([^)]+\)$/, '').trim());
+                const title = String(payload.title ?? '');
+                const depth = typeof payload.depth === 'number' ? payload.depth : 0;
+                if (group[1] === 'START')
+                    return { type: 'group_start', title, depth };
+                return {
+                    type: 'group_end',
+                    title,
+                    depth,
+                    passed: group[1] === 'PASS',
+                    durationMs: durationMatch ? parseInt(durationMatch[1], 10) : undefined,
+                };
+            }
+            catch {
+                return { type: 'none' };
+            }
+        }
         // 3. Step passed: "✔ <stepText> (<duration>ms)" or "[TESTSPECTRA_STEP_PASS]"
         if (raw.startsWith('✔ ') || raw.startsWith('[TESTSPECTRA_STEP_PASS]')) {
             const fullText = raw
@@ -129,7 +151,7 @@ export class TestOutputParser {
             const durationMs = match ? parseInt(match[1], 10) : undefined;
             const cmdText = fullText.replace(/\s*\([^)]+\)$/, '').trim();
             const formatted = parseAndFormat(cmdText);
-            return { type: 'step_pass', stepText: formatted, durationMs };
+            return { type: 'step_pass', stepText: formatted, durationMs, depth: readGroupPath(cmdText)?.length };
         }
         // 4. Step failed: "✖ <stepText> (<duration>ms)" or "[TESTSPECTRA_STEP_FAIL]"
         if (raw.startsWith('✖ ') || raw.startsWith('[TESTSPECTRA_STEP_FAIL]')) {
@@ -141,7 +163,7 @@ export class TestOutputParser {
             const durationMs = match ? parseInt(match[1], 10) : undefined;
             const cmdText = fullText.replace(/\s*\([^)]+\)$/, '').trim();
             const formatted = parseAndFormat(cmdText);
-            return { type: 'step_fail', stepText: formatted, durationMs };
+            return { type: 'step_fail', stepText: formatted, durationMs, depth: readGroupPath(cmdText)?.length };
         }
         // 5. Test error: "[TESTSPECTRA_TEST_ERROR]" or "↳ Error: <msg>"
         if (raw.startsWith('[TESTSPECTRA_TEST_ERROR]') || raw.includes('↳ Error:')) {

package/dist/reporter.js

@@ -1,4 +1,4 @@
-import { parseAndFormat } from './formatter.js';
+import { groupKey, parseAndFormat, readGroupPath } from './formatter.js';
 import { stripAnsi } from './parser.js';
 export class SemanticReporter {
     logs = [];
@@ -120,6 +120,25 @@ export class SemanticReporter {
             this.options.onStepStart?.(testTitle || testCase?.title || '', formatted, workerId ?? testCase?.workerId);
             return;
         }
+        // 2.5 A `Spectra.step` group ended -> record its outcome for the step tree
+        if (raw.startsWith('[TESTSPECTRA_GROUP_PASS]') || raw.startsWith('[TESTSPECTRA_GROUP_FAIL]')) {
+            const passed = raw.startsWith('[TESTSPECTRA_GROUP_PASS]');
+            const fullText = raw.replace(/^\[TESTSPECTRA_GROUP_(PASS|FAIL)\]/, '').trim();
+            const match = fullText.match(/\(([^)]+)ms\)$/);
+            const duration = match ? parseInt(match[1], 10) : 0;
+            try {
+                const payload = JSON.parse(fullText.replace(/\s*\([^)]+\)$/, '').trim());
+                const testCase = this.resolveTestCase(payload.test || '', payload.workerId);
+                if (testCase && Array.isArray(payload.path)) {
+                    testCase.groups = { ...testCase.groups, [groupKey(payload.path)]: { passed, duration } };
+                }
+            }
+            catch { }
+            return;
+        }
+        if (raw.startsWith('[TESTSPECTRA_GROUP_START]')) {
+            return;
+        }
         // 3. Step passed -> record step to matching test case
         if (raw.startsWith('[TESTSPECTRA_STEP_PASS]')) {
             const fullText = raw.replace('[TESTSPECTRA_STEP_PASS]', '').trim();
@@ -136,7 +155,7 @@ export class SemanticReporter {
             }
             catch { }
             const testCase = this.resolveTestCase(testTitle, workerId);
-            const step = { text: formatted, duration, passed: true };
+            const step = { text: formatted, duration, passed: true, groupPath: readGroupPath(cmdText) };
             if (testCase) {
                 testCase.steps.push(step);
                 testCase.currentStep = formatted;
@@ -160,7 +179,7 @@ export class SemanticReporter {
             }
             catch { }
             const testCase = this.resolveTestCase(testTitle, workerId);
-            const step = { text: formatted, duration, passed: false };
+            const step = { text: formatted, duration, passed: false, groupPath: readGroupPath(cmdText) };
             if (testCase) {
                 testCase.steps.push(step);
                 testCase.currentStep = formatted;

package/dist/types.d.ts

@@ -35,11 +35,20 @@ export interface PendingStep {
     text: string;
     duration: number;
     passed: boolean;
+    /** The `Spectra.step` titles the step ran inside, outermost first (absent outside any). */
+    groupPath?: string[];
+}
+/** How a `Spectra.step` ended, keyed by its path (`groupKey`). */
+export interface StepGroupResult {
+    passed: boolean;
+    duration: number;
 }
 export interface PendingTestCase {
     title: string;
     workerId?: number;
     steps: PendingStep[];
+    /** `Spectra.step` outcomes by `groupKey(path)`. */
+    groups?: Record<string, StepGroupResult>;
     currentStep?: string;
     errorMsg?: string;
     videoPath?: string;
@@ -96,10 +105,24 @@ export type ParsedToken = {
     type: 'step_pass';
     stepText: string;
     durationMs?: number;
+    /** How many `Spectra.step` groups the step ran inside. */
+    depth?: number;
 } | {
     type: 'step_fail';
     stepText: string;
     durationMs?: number;
+    depth?: number;
+} | {
+    type: 'group_start';
+    title: string;
+    /** 0 for a step directly in the test, 1 for one inside another step, … */
+    depth: number;
+} | {
+    type: 'group_end';
+    title: string;
+    depth: number;
+    passed: boolean;
+    durationMs?: number;
 } | {
     type: 'summary_banner';
     text: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/reporter",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "Canonical semantic reporter, output stream parser, and execution telemetry for TestSpectra",
   "files": [
     "dist",