executable-stories-formatters 0.7.12 → 0.7.13

package/dist/index.d.cts

@@ -1,12 +1,5 @@
-import { S as StoryMeta, C as CIInfo$1, a as StoryStep, D as DocEntry, N as NormalizedTicket, O as OtelSpan, b as CIProvider, R as RawStatus, c as RawAttachment, d as RawRun, e as RawCIInfo, f as adaptJestRun, g as adaptPlaywrightRun, h as adaptVitestRun } from './index-C0OOaaiK.cjs';
-export { i as DocPhase, J as JestAdapterOptions, j as JestAggregatedResult, k as JestFileResult, l as JestTestResult, m as OtelAttributeValue, P as PlaywrightAdapterOptions, n as PlaywrightAnnotation, o as PlaywrightAttachment, p as PlaywrightError, q as PlaywrightLocation, r as PlaywrightStatus, s as PlaywrightTestCase, t as PlaywrightTestResult, u as RawStepEvent, v as RawTestCase, w as STORY_META_KEY, x as StepKeyword, y as StepMode, z as StoryFileReport, V as VitestAdapterOptions, A as VitestSerializedError, B as VitestState, E as VitestTestCase, F as VitestTestModule, G as VitestTestResult, H as toCIInfo, I as toRawCIInfo } from './index-C0OOaaiK.cjs';
-
-/**
- * Canonical types for Layer 2: Anti-Corruption Layer output.
- *
- * These types are strict and have all required fields populated.
- * Formatters (Layer 3) accept only these canonical types.
- */
+import { S as StoryMeta, R as RawStatus, C as CIInfo$1, a as StoryStep, D as DocEntry, N as NormalizedTicket, O as OtelSpan, b as CIProvider, c as RawAttachment, d as RawRun, e as RawCIInfo, f as adaptJestRun, g as adaptPlaywrightRun, h as adaptVitestRun } from './index-fqrm5-Xr.cjs';
+export { i as DocPhase, J as JestAdapterOptions, j as JestAggregatedResult, k as JestFileResult, l as JestTestResult, m as OtelAttributeValue, P as PlaywrightAdapterOptions, n as PlaywrightAnnotation, o as PlaywrightAttachment, p as PlaywrightError, q as PlaywrightLocation, r as PlaywrightStatus, s as PlaywrightTestCase, t as PlaywrightTestResult, u as RawStepEvent, v as RawTestCase, w as STORY_META_KEY, x as StepKeyword, y as StepMode, z as StoryFileReport, V as VitestAdapterOptions, A as VitestSerializedError, B as VitestState, E as VitestTestCase, F as VitestTestModule, G as VitestTestResult, H as toCIInfo, I as toRawCIInfo } from './index-fqrm5-Xr.cjs';
 
 /** Canonical test status (Cucumber-compatible) */
 type TestStatus = "passed" | "failed" | "skipped" | "pending";
@@ -14,6 +7,8 @@ type TestStatus = "passed" | "failed" | "skipped" | "pending";
 interface StepResult {
     /** Step index (0-based) */
     index: number;
+    /** Stable step ID when available */
+    stepId?: string;
     /** Step status */
     status: TestStatus;
     /** Duration in milliseconds (default 0) */
@@ -57,6 +52,8 @@ interface TestCaseResult {
     sourceLine: number;
     /** Test status (required) */
     status: TestStatus;
+    /** Original adapter/framework status (preserved for diagnostics). */
+    rawStatus?: RawStatus;
     /** Duration in milliseconds (required, default 0) */
     durationMs: number;
     /** Error message if failed */
@@ -1094,6 +1091,7 @@ declare function deriveStepResults(steps: StoryStep[], scenarioStatus: TestStatu
  */
 declare function mergeStepResults(derived: StepResult[], events?: Array<{
     index?: number;
+    stepId?: string;
     status?: string;
     durationMs?: number;
     errorMessage?: string;

package/dist/index.d.ts

@@ -1,12 +1,5 @@
-import { S as StoryMeta, C as CIInfo$1, a as StoryStep, D as DocEntry, N as NormalizedTicket, O as OtelSpan, b as CIProvider, R as RawStatus, c as RawAttachment, d as RawRun, e as RawCIInfo, f as adaptJestRun, g as adaptPlaywrightRun, h as adaptVitestRun } from './index-C0OOaaiK.js';
-export { i as DocPhase, J as JestAdapterOptions, j as JestAggregatedResult, k as JestFileResult, l as JestTestResult, m as OtelAttributeValue, P as PlaywrightAdapterOptions, n as PlaywrightAnnotation, o as PlaywrightAttachment, p as PlaywrightError, q as PlaywrightLocation, r as PlaywrightStatus, s as PlaywrightTestCase, t as PlaywrightTestResult, u as RawStepEvent, v as RawTestCase, w as STORY_META_KEY, x as StepKeyword, y as StepMode, z as StoryFileReport, V as VitestAdapterOptions, A as VitestSerializedError, B as VitestState, E as VitestTestCase, F as VitestTestModule, G as VitestTestResult, H as toCIInfo, I as toRawCIInfo } from './index-C0OOaaiK.js';
-
-/**
- * Canonical types for Layer 2: Anti-Corruption Layer output.
- *
- * These types are strict and have all required fields populated.
- * Formatters (Layer 3) accept only these canonical types.
- */
+import { S as StoryMeta, R as RawStatus, C as CIInfo$1, a as StoryStep, D as DocEntry, N as NormalizedTicket, O as OtelSpan, b as CIProvider, c as RawAttachment, d as RawRun, e as RawCIInfo, f as adaptJestRun, g as adaptPlaywrightRun, h as adaptVitestRun } from './index-fqrm5-Xr.js';
+export { i as DocPhase, J as JestAdapterOptions, j as JestAggregatedResult, k as JestFileResult, l as JestTestResult, m as OtelAttributeValue, P as PlaywrightAdapterOptions, n as PlaywrightAnnotation, o as PlaywrightAttachment, p as PlaywrightError, q as PlaywrightLocation, r as PlaywrightStatus, s as PlaywrightTestCase, t as PlaywrightTestResult, u as RawStepEvent, v as RawTestCase, w as STORY_META_KEY, x as StepKeyword, y as StepMode, z as StoryFileReport, V as VitestAdapterOptions, A as VitestSerializedError, B as VitestState, E as VitestTestCase, F as VitestTestModule, G as VitestTestResult, H as toCIInfo, I as toRawCIInfo } from './index-fqrm5-Xr.js';
 
 /** Canonical test status (Cucumber-compatible) */
 type TestStatus = "passed" | "failed" | "skipped" | "pending";
@@ -14,6 +7,8 @@ type TestStatus = "passed" | "failed" | "skipped" | "pending";
 interface StepResult {
     /** Step index (0-based) */
     index: number;
+    /** Stable step ID when available */
+    stepId?: string;
     /** Step status */
     status: TestStatus;
     /** Duration in milliseconds (default 0) */
@@ -57,6 +52,8 @@ interface TestCaseResult {
     sourceLine: number;
     /** Test status (required) */
     status: TestStatus;
+    /** Original adapter/framework status (preserved for diagnostics). */
+    rawStatus?: RawStatus;
     /** Duration in milliseconds (required, default 0) */
     durationMs: number;
     /** Error message if failed */
@@ -1094,6 +1091,7 @@ declare function deriveStepResults(steps: StoryStep[], scenarioStatus: TestStatu
  */
 declare function mergeStepResults(derived: StepResult[], events?: Array<{
     index?: number;
+    stepId?: string;
     status?: string;
     durationMs?: number;
     errorMessage?: string;

package/dist/index.js

@@ -51,6 +51,7 @@ function deriveStepResults(steps, scenarioStatus, error) {
   if (scenarioStatus === "passed") {
     return steps.map((_, index) => ({
       index,
+      stepId: steps[index].id,
       status: "passed",
       durationMs: 0
     }));
@@ -58,6 +59,7 @@ function deriveStepResults(steps, scenarioStatus, error) {
   if (scenarioStatus === "skipped" || scenarioStatus === "pending") {
     return steps.map((_, index) => ({
       index,
+      stepId: steps[index].id,
       status: scenarioStatus,
       durationMs: 0
     }));
@@ -65,16 +67,17 @@ function deriveStepResults(steps, scenarioStatus, error) {
   const failingIndex = findFailingStepIndex(steps, error);
   return steps.map((_, index) => {
     if (index < failingIndex) {
-      return { index, status: "passed", durationMs: 0 };
+      return { index, stepId: steps[index].id, status: "passed", durationMs: 0 };
     } else if (index === failingIndex) {
       return {
         index,
+        stepId: steps[index].id,
         status: "failed",
         durationMs: 0,
         errorMessage: error?.message
       };
     } else {
-      return { index, status: "skipped", durationMs: 0 };
+      return { index, stepId: steps[index].id, status: "skipped", durationMs: 0 };
     }
   });
 }
@@ -96,18 +99,23 @@ function mergeStepResults(derived, events) {
     return derived;
   }
   const actualByIndex = /* @__PURE__ */ new Map();
+  const actualByStepId = /* @__PURE__ */ new Map();
   for (const event of events) {
     if (event.index !== void 0) {
       actualByIndex.set(event.index, event);
     }
+    if (event.stepId) {
+      actualByStepId.set(event.stepId, event);
+    }
   }
   return derived.map((step) => {
-    const actual = actualByIndex.get(step.index);
+    const actual = (step.stepId ? actualByStepId.get(step.stepId) : void 0) ?? actualByIndex.get(step.index);
     if (!actual) {
       return step;
     }
     return {
       index: step.index,
+      stepId: step.stepId ?? actual.stepId,
       status: normalizeStepStatus(actual.status) ?? step.status,
       durationMs: actual.durationMs ?? step.durationMs,
       errorMessage: actual.errorMessage ?? step.errorMessage
@@ -241,6 +249,7 @@ function canonicalizeTestCase(raw, options, projectRoot) {
     derivedSteps,
     raw.stepEvents?.map((e) => ({
       index: e.index,
+      stepId: e.stepId,
       status: e.status,
       durationMs: e.durationMs,
       errorMessage: e.errorMessage
@@ -262,6 +271,7 @@ function canonicalizeTestCase(raw, options, projectRoot) {
     sourceFile,
     sourceLine: raw.sourceLine ?? 1,
     status,
+    rawStatus: raw.status,
     durationMs: raw.durationMs ?? 0,
     errorMessage: raw.error?.message,
     errorStack: raw.error?.stack,
@@ -629,19 +639,34 @@ ${doc.markdown}`,
           }
         };
       }
-      case "tag":
+      case "custom":
+        if (doc.type === "visual" && doc.data && typeof doc.data === "object") {
+          const data = doc.data;
+          const status = typeof data.status === "string" ? data.status : "unknown";
+          const lines = [`Visual Check (${status})`];
+          if (typeof data.baseline === "string") lines.push(`Baseline: ${data.baseline}`);
+          if (typeof data.actual === "string") lines.push(`Actual: ${data.actual}`);
+          if (typeof data.diff === "string") lines.push(`Diff: ${data.diff}`);
+          return {
+            doc_string: {
+              content: lines.join("\n"),
+              content_type: "text/plain",
+              line: 0
+            }
+          };
+        }
         return {
           doc_string: {
-            content: doc.names.map((n) => `@${n}`).join(" "),
-            content_type: "text/plain",
+            content: JSON.stringify(doc.data, null, 2),
+            content_type: "application/json",
             line: 0
           }
         };
-      case "custom":
+      case "tag":
         return {
           doc_string: {
-            content: JSON.stringify(doc.data, null, 2),
-            content_type: "application/json",
+            content: doc.names.map((n) => `@${n}`).join(" "),
+            content_type: "text/plain",
             line: 0
           }
         };
@@ -2159,6 +2184,14 @@ body {
   font-family: var(--font-mono);
 }
 
+.outcome-tag {
+  background: var(--status-fail-bg, color-mix(in srgb, var(--destructive, #ef4444) 12%, transparent));
+  color: var(--destructive, #b91c1c);
+  border-color: color-mix(in srgb, var(--destructive, #ef4444) 35%, transparent);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
 .scenario-duration {
   font-size: 0.75rem;
   color: var(--muted-foreground);
@@ -2922,6 +2955,63 @@ body {
   opacity: 0.8;
 }
 
+/* ============================================================================
+   Documentation Entries - Visual Check
+   ============================================================================ */
+.doc-visual {
+  margin-bottom: 0.5rem;
+  padding: 0.75rem;
+  border: 1px solid var(--border);
+  border-radius: calc(var(--radius) - 2px);
+  background: var(--muted, transparent);
+}
+
+.doc-visual:last-child {
+  margin-bottom: 0;
+}
+
+.doc-visual-header {
+  font-size: 0.8125rem;
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.doc-visual-status {
+  font-size: 0.6875rem;
+  font-family: var(--font-mono);
+  font-weight: 500;
+  padding: 0.125rem 0.5rem;
+  border-radius: 9999px;
+  background: var(--tag-bg);
+  color: var(--tag-color);
+  border: 1px solid var(--tag-border);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+.doc-visual-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+  gap: 0.5rem;
+}
+
+.doc-visual-item {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+.doc-visual-label {
+  font-size: 0.6875rem;
+  font-weight: 600;
+  color: var(--muted-foreground);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
 /* ============================================================================
    Documentation Entries - Custom
    ============================================================================ */
@@ -13044,6 +13134,22 @@ function renderDocScreenshot(entry, deps) {
 </div>`;
 }
 function renderDocCustom(entry, deps) {
+  if (entry.type === "visual" && entry.data && typeof entry.data === "object") {
+    const data = entry.data;
+    const status = typeof data.status === "string" ? data.status : "unknown";
+    const baseline = typeof data.baseline === "string" ? data.baseline : void 0;
+    const actual = typeof data.actual === "string" ? data.actual : void 0;
+    const diff = typeof data.diff === "string" ? data.diff : void 0;
+    const maybeImg = (src, label) => src ? `<div class="doc-visual-item"><div class="doc-visual-label">${deps.escapeHtml(label ?? "")}</div><img src="${deps.escapeHtml(src)}" alt="${deps.escapeHtml(label ?? "visual image")}" class="doc-screenshot-img" /></div>` : "";
+    return `<div class="doc-visual">
+  <div class="doc-visual-header">Visual Check <span class="doc-visual-status">${deps.escapeHtml(status)}</span></div>
+  <div class="doc-visual-grid">
+    ${maybeImg(baseline, "Baseline")}
+    ${maybeImg(actual, "Actual")}
+    ${maybeImg(diff, "Diff")}
+  </div>
+</div>`;
+  }
   const dataStr = JSON.stringify(entry.data, null, 2);
   return `<div class="doc-custom">
   <div class="doc-custom-type">${deps.escapeHtml(entry.type)}</div>
@@ -13112,8 +13218,11 @@ function renderStep(step, stepResult, index, deps) {
 </div>${stepDocs}`;
 }
 function renderSteps(args, deps) {
+  const byStepId = new Map(
+    args.stepResults.filter((sr) => typeof sr.stepId === "string" && sr.stepId.length > 0).map((sr) => [sr.stepId, sr])
+  );
   const stepsHtml = args.steps.map((step, index) => {
-    const stepResult = args.stepResults.find((sr) => sr.index === index);
+    const stepResult = (step.id ? byStepId.get(step.id) : void 0) ?? args.stepResults.find((sr) => sr.index === index);
     return renderStep(step, stepResult, index, deps);
   }).join("");
   return `<div class="steps">${stepsHtml}</div>`;
@@ -13166,6 +13275,7 @@ function renderScenario(args, deps) {
   const duration = tc.durationMs > 0 ? `${(tc.durationMs / 1e3).toFixed(2)}s` : "";
   const tags = tc.tags.map((t) => `<span class="tag">${deps.escapeHtml(t)}</span>`).join("");
   const tickets = (tc.story.tickets ?? []).map((t) => renderTicket(t, deps.ticketUrlTemplate, deps.escapeHtml)).join("");
+  const outcomeBadge = tc.rawStatus === "timeout" || tc.rawStatus === "interrupted" ? `<span class="tag outcome-tag">${deps.escapeHtml(tc.rawStatus)}</span>` : "";
   const otelMeta = tc.story.meta?.otel;
   let traceBadge = "";
   if (otelMeta?.traceId) {
@@ -13233,7 +13343,7 @@ function renderScenario(args, deps) {
         <span class="status-icon ${statusClass}">${statusIcon2}</span>
         <span class="scenario-name">${deps.escapeHtml(tc.story.scenario)}</span>
       </div>
-      <div class="scenario-meta">${tags}${tickets}${sourceLink}${traceBadge}${metricBadges}</div>
+      <div class="scenario-meta">${tags}${tickets}${outcomeBadge}${sourceLink}${traceBadge}${metricBadges}</div>
     </div>
     <div class="scenario-actions">
       <button class="copy-scenario-btn" onclick="copyScenarioAsMarkdown('scenario-${tc.id}')" aria-label="Copy scenario as markdown" title="Copy as Markdown"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg></button>
@@ -14237,6 +14347,9 @@ var MarkdownFormatter = class {
       });
       meta.push(`Tickets: ${ticketLinks.join(", ")}`);
     }
+    if (tc.rawStatus === "timeout" || tc.rawStatus === "interrupted") {
+      meta.push(`Outcome: \`${tc.rawStatus}\``);
+    }
     const otelMeta = tc.story.meta?.otel;
     if (otelMeta?.traceId) {
       const traceTemplate = this.options.traceUrlTemplate;
@@ -14399,6 +14512,16 @@ var MarkdownFormatter = class {
         lines.push(`${indent}![${entry.alt ?? "Screenshot"}](${entry.path})`);
         break;
       case "custom":
+        if (entry.type === "visual" && entry.data && typeof entry.data === "object") {
+          const data = entry.data;
+          const status = typeof data.status === "string" ? data.status : "unknown";
+          lines.push(`${indent}**Visual Check** (${status})`);
+          if (typeof data.baseline === "string") lines.push(`${indent}- Baseline: ${data.baseline}`);
+          if (typeof data.actual === "string") lines.push(`${indent}- Actual: ${data.actual}`);
+          if (typeof data.diff === "string") lines.push(`${indent}- Diff: ${data.diff}`);
+          lines.push(`${indent}`);
+          break;
+        }
         lines.push(`${indent}**[${entry.type}]**`);
         lines.push(`${indent}`);
         lines.push(`${indent}\`\`\`json`);
@@ -17050,6 +17173,14 @@ function adaptPlaywrightRun(testResults, options = {}) {
       message: result.errors[0].message,
       stack: result.errors[0].stack
     } : void 0;
+    const stepEvents = result.stepEvents?.length ? result.stepEvents : story.steps.map(
+      (step, index) => step.durationMs !== void 0 ? {
+        index,
+        stepId: step.id,
+        title: step.text,
+        durationMs: step.durationMs
+      } : void 0
+    ).filter((e) => e !== void 0);
     testCases.push({
       externalId: test.titlePath().join(" > "),
       title: story.scenario,
@@ -17060,8 +17191,7 @@ function adaptPlaywrightRun(testResults, options = {}) {
       status: mapPlaywrightStatus(result.status),
       durationMs: result.duration,
       error,
-      stepEvents: void 0,
-      // Playwright could provide step info, but we don't capture it yet
+      stepEvents: stepEvents.length > 0 ? stepEvents : void 0,
       attachments,
       meta: {
         playwrightStatus: result.status,