executable-stories-react 0.18.0 → 0.20.0

package/dist/index.d.cts

@@ -100,9 +100,9 @@ declare function ReportSummaryView({ summary, className, ariaLabel }: ReportSumm
 declare function ReportMeta(): react.JSX.Element | null;
 
 /**
- * Renders scenario attachments. Base64 images embed inline; everything else
- * becomes a labelled data-URI download link. Mirrors the report's attachments
- * block (which also inlines images and links other media).
+ * Renders scenario attachments. Images embed inline; text documents preview
+ * above their download link; other types get a labelled download link. An
+ * `external` attachment links to its file path and shows no preview.
  */
 declare function ReportAttachments({ attachments }: {
     attachments: ReportAttachment[];

package/dist/index.d.ts

@@ -100,9 +100,9 @@ declare function ReportSummaryView({ summary, className, ariaLabel }: ReportSumm
 declare function ReportMeta(): react.JSX.Element | null;
 
 /**
- * Renders scenario attachments. Base64 images embed inline; everything else
- * becomes a labelled data-URI download link. Mirrors the report's attachments
- * block (which also inlines images and links other media).
+ * Renders scenario attachments. Images embed inline; text documents preview
+ * above their download link; other types get a labelled download link. An
+ * `external` attachment links to its file path and shows no preview.
  */
 declare function ReportAttachments({ attachments }: {
     attachments: ReportAttachment[];

package/dist/index.js

@@ -658,7 +658,7 @@ function ReportDocEntries({ entries }) {
 }
 
 // src/components/ReportSteps.tsx
-import { jsx as jsx19, jsxs as jsxs11 } from "react/jsx-runtime";
+import { Fragment as Fragment6, jsx as jsx19, jsxs as jsxs11 } from "react/jsx-runtime";
 var STEP_GLYPH = {
   passed: "\u2713",
   failed: "\u2717",
@@ -735,6 +735,23 @@ function ReportStepItem({
             children: step.errorMessage
           }
         ) : null,
+        step.expected !== void 0 || step.actual !== void 0 ? /* @__PURE__ */ jsxs11(
+          "dl",
+          {
+            "data-slot": "step-comparison",
+            className: "mt-1.5 ml-6 grid grid-cols-[auto_1fr] gap-x-3 gap-y-1 font-mono text-xs",
+            children: [
+              step.expected !== void 0 ? /* @__PURE__ */ jsxs11(Fragment6, { children: [
+                /* @__PURE__ */ jsx19("dt", { className: "text-muted-foreground", children: "Expected" }),
+                /* @__PURE__ */ jsx19("dd", { className: "overflow-x-auto whitespace-pre-wrap text-pass", children: step.expected })
+              ] }) : null,
+              step.actual !== void 0 ? /* @__PURE__ */ jsxs11(Fragment6, { children: [
+                /* @__PURE__ */ jsx19("dt", { className: "text-muted-foreground", children: "Actual" }),
+                /* @__PURE__ */ jsx19("dd", { className: "overflow-x-auto whitespace-pre-wrap text-fail", children: step.actual })
+              ] }) : null
+            ]
+          }
+        ) : null,
         step.docEntries.length > 0 ? /* @__PURE__ */ jsx19("div", { "data-es-docs": true, className: "mt-2 ml-6", children: /* @__PURE__ */ jsx19(ReportDocEntries, { entries: step.docEntries }) }) : null
       ]
     }
@@ -858,43 +875,77 @@ function StateCardView({ card }) {
 }
 
 // src/components/ReportAttachments.tsx
-import { Fragment as Fragment6, jsx as jsx21, jsxs as jsxs13 } from "react/jsx-runtime";
+import { Fragment as Fragment7, jsx as jsx21, jsxs as jsxs13 } from "react/jsx-runtime";
+function attachmentText(att) {
+  if (att.contentEncoding !== "BASE64") return att.body;
+  try {
+    return new TextDecoder().decode(Uint8Array.from(atob(att.body), (c) => c.charCodeAt(0)));
+  } catch {
+    return void 0;
+  }
+}
+function preview(att) {
+  const type = att.mediaType.split(";")[0].trim().toLowerCase();
+  const text = attachmentText(att);
+  if (text === void 0) return null;
+  if (type === "text/plain") {
+    return /* @__PURE__ */ jsx21("pre", { className: "max-h-96 overflow-auto rounded-md border border-border bg-muted/40 p-3 text-xs whitespace-pre-wrap", children: text });
+  }
+  if (type === "text/markdown") {
+    return /* @__PURE__ */ jsx21(
+      "div",
+      {
+        className: "es-doc-prose prose prose-sm max-w-none rounded-md border border-border p-3",
+        dangerouslySetInnerHTML: { __html: safeMarkdownHtml(text) }
+      }
+    );
+  }
+  if (type === "text/html") {
+    return /* @__PURE__ */ jsx21(DocHtml, { entry: { kind: "html", content: text, title: att.name, phase: "runtime" } });
+  }
+  return null;
+}
 function ReportAttachments({ attachments }) {
   if (attachments.length === 0) return null;
   return (
     // role="group" (not a labelled <section>) so multiple scenarios' attachment
     // blocks don't create duplicate "Attachments" region landmarks.
     /* @__PURE__ */ jsx21("div", { role: "group", "aria-label": "Attachments", className: "mt-3 flex flex-col gap-2", children: attachments.map((att, i) => {
-      const dataUri = att.contentEncoding === "BASE64" ? `data:${att.mediaType};base64,${att.body}` : `data:${att.mediaType},${encodeURIComponent(att.body)}`;
-      const isImage = att.mediaType.startsWith("image/");
-      return /* @__PURE__ */ jsx21("figure", { className: "m-0", children: isImage ? /* @__PURE__ */ jsxs13(Fragment6, { children: [
+      const dataUri = att.external ? void 0 : att.contentEncoding === "BASE64" ? `data:${att.mediaType};base64,${att.body}` : `data:${att.mediaType},${encodeURIComponent(att.body)}`;
+      const href = dataUri ?? safeUrl(att.body);
+      const imageSrc = dataUri ?? safeImageUrl(att.body);
+      const isImage = att.mediaType.startsWith("image/") && imageSrc !== void 0;
+      return /* @__PURE__ */ jsx21("figure", { className: "m-0", children: isImage ? /* @__PURE__ */ jsxs13(Fragment7, { children: [
         /* @__PURE__ */ jsx21(
           "img",
           {
-            src: dataUri,
+            src: imageSrc,
             alt: att.name,
             loading: "lazy",
             className: "max-w-full rounded-md border border-border"
           }
         ),
         /* @__PURE__ */ jsx21("figcaption", { className: "mt-1 text-xs text-muted-foreground", children: att.name })
-      ] }) : /* @__PURE__ */ jsxs13(
-        "a",
-        {
-          href: dataUri,
-          download: att.name,
-          className: "text-xs text-link underline underline-offset-2",
-          children: [
-            att.name,
-            " ",
-            /* @__PURE__ */ jsxs13("span", { className: "text-muted-foreground", children: [
-              "(",
-              att.mediaType,
-              ")"
-            ] })
-          ]
-        }
-      ) }, `${att.name}-${i}`);
+      ] }) : /* @__PURE__ */ jsxs13(Fragment7, { children: [
+        att.external ? null : preview(att),
+        /* @__PURE__ */ jsxs13(
+          "a",
+          {
+            href,
+            download: att.name,
+            className: "text-xs text-link underline underline-offset-2",
+            children: [
+              att.name,
+              " ",
+              /* @__PURE__ */ jsxs13("span", { className: "text-muted-foreground", children: [
+                "(",
+                att.mediaType,
+                ")"
+              ] })
+            ]
+          }
+        )
+      ] }) }, `${att.name}-${i}`);
     }) })
   );
 }
@@ -1070,7 +1121,7 @@ function flakinessOf(entries) {
 }
 
 // src/components/ScenarioRunHistory.tsx
-import { Fragment as Fragment7, jsx as jsx23, jsxs as jsxs15 } from "react/jsx-runtime";
+import { Fragment as Fragment8, jsx as jsx23, jsxs as jsxs15 } from "react/jsx-runtime";
 var MAX_DOTS = 10;
 var DOT_COLOR = {
   passed: "bg-pass",
@@ -1090,7 +1141,7 @@ function ScenarioRunHistory({ scenarioId }) {
   const recent = entries.slice(-MAX_DOTS);
   const flaky = flakinessOf(recent) === "flaky";
   const summary = flaky ? `${describeRunHistory(recent)} \xB7 Flaky` : describeRunHistory(recent);
-  return /* @__PURE__ */ jsxs15(Fragment7, { children: [
+  return /* @__PURE__ */ jsxs15(Fragment8, { children: [
     flaky ? /* @__PURE__ */ jsx23(Badge, { variant: "pending", "aria-label": "Flaky: status flips between recent runs", title: summary, children: "Flaky" }) : null,
     /* @__PURE__ */ jsx23(
       "span",
@@ -1425,9 +1476,9 @@ function ReportScenario({ scenario, hideTitle = false }) {
 }
 
 // src/components/ReportScenarioList.tsx
-import { Fragment as Fragment8, jsx as jsx27 } from "react/jsx-runtime";
+import { Fragment as Fragment9, jsx as jsx27 } from "react/jsx-runtime";
 function ReportScenarioList({ feature }) {
-  return /* @__PURE__ */ jsx27(Fragment8, { children: feature.scenarios.map((scenario) => /* @__PURE__ */ jsx27(ReportScenario, { scenario }, scenario.id)) });
+  return /* @__PURE__ */ jsx27(Fragment9, { children: feature.scenarios.map((scenario) => /* @__PURE__ */ jsx27(ReportScenario, { scenario }, scenario.id)) });
 }
 
 // src/components/ReportFeatureIntro.tsx
@@ -1465,7 +1516,7 @@ function featureKindLabel(kind) {
 }
 
 // src/components/ReportFeature.tsx
-import { Fragment as Fragment9, jsx as jsx29, jsxs as jsxs20 } from "react/jsx-runtime";
+import { Fragment as Fragment10, jsx as jsx29, jsxs as jsxs20 } from "react/jsx-runtime";
 function ReportFeature({ feature }) {
   const titleId = `${feature.id}-title`;
   const bodyId = `${feature.id}-body`;
@@ -1525,14 +1576,14 @@ function ReportFeature({ feature }) {
                     s.failed,
                     " failed"
                   ] }),
-                  s.skipped > 0 ? /* @__PURE__ */ jsxs20(Fragment9, { children: [
+                  s.skipped > 0 ? /* @__PURE__ */ jsxs20(Fragment10, { children: [
                     /* @__PURE__ */ jsx29("span", { "aria-hidden": true, children: "\xB7" }),
                     /* @__PURE__ */ jsxs20("span", { children: [
                       s.skipped,
                       " skipped"
                     ] })
                   ] }) : null,
-                  s.pending > 0 ? /* @__PURE__ */ jsxs20(Fragment9, { children: [
+                  s.pending > 0 ? /* @__PURE__ */ jsxs20(Fragment10, { children: [
                     /* @__PURE__ */ jsx29("span", { "aria-hidden": true, children: "\xB7" }),
                     /* @__PURE__ */ jsxs20("span", { children: [
                       s.pending,
@@ -1779,9 +1830,9 @@ function ReportSchemaError({ error }) {
 }
 
 // src/components/ReportShell.tsx
-import { Fragment as Fragment10, jsx as jsx36, jsxs as jsxs24 } from "react/jsx-runtime";
+import { Fragment as Fragment11, jsx as jsx36, jsxs as jsxs24 } from "react/jsx-runtime";
 function ReportTitleBlock({ title }) {
-  return /* @__PURE__ */ jsxs24(Fragment10, { children: [
+  return /* @__PURE__ */ jsxs24(Fragment11, { children: [
     /* @__PURE__ */ jsx36("h1", { children: title ?? "Story Report" }),
     /* @__PURE__ */ jsx36(ReportSummary, {}),
     /* @__PURE__ */ jsx36(ReportMeta, {})
@@ -1875,7 +1926,7 @@ function Report(props) {
 
 // src/components/doc/MermaidView.tsx
 import { useEffect as useEffect3, useRef as useRef2, useState as useState4 } from "react";
-import { Fragment as Fragment11, jsx as jsx39, jsxs as jsxs27 } from "react/jsx-runtime";
+import { Fragment as Fragment12, jsx as jsx39, jsxs as jsxs27 } from "react/jsx-runtime";
 function prefersDark(el) {
   const themed = el?.closest("[data-theme]");
   if (themed?.dataset.theme === "dark") return true;
@@ -1945,7 +1996,7 @@ function MermaidView({ entry, load }) {
       )
     ] });
   }
-  return /* @__PURE__ */ jsxs27(Fragment11, { children: [
+  return /* @__PURE__ */ jsxs27(Fragment12, { children: [
     error ? /* @__PURE__ */ jsxs27(
       "p",
       {
@@ -2464,6 +2515,14 @@ var story_report_v1_default = {
         errorMessage: {
           type: "string"
         },
+        expected: {
+          type: "string",
+          description: "Serialized expected value of the failed assertion. Present only when the host framework reports one."
+        },
+        actual: {
+          type: "string",
+          description: "Serialized actual (observed) value of the failed assertion. Present only when the host framework reports one."
+        },
         mode: {
           $ref: "#/$defs/StepMode"
         },
@@ -2528,6 +2587,10 @@ var story_report_v1_default = {
         contentEncoding: {
           type: "string",
           enum: ["BASE64", "IDENTITY"]
+        },
+        external: {
+          const: true,
+          description: "body holds the file's path or URL (file missing or too large to embed)."
         }
       },
       required: ["name", "mediaType", "body", "contentEncoding"],