executable-stories-react 0.10.0 → 0.11.0

package/dist/index.cjs

@@ -377,23 +377,11 @@ function useReport() {
   return ctx.report;
 }
 
-// ../executable-stories-core/dist/utils/duration.js
-function formatDuration(ms) {
-  if (ms < 1e3) {
-    return `${Math.round(ms)} ms`;
-  }
-  if (ms < 6e4) {
-    return `${(ms / 1e3).toFixed(2)} s`;
-  }
-  const minutes = Math.floor(ms / 6e4);
-  const seconds = Math.floor(ms % 6e4 / 1e3);
-  if (minutes < 60) {
-    return seconds > 0 ? `${minutes}m ${seconds}s` : `${minutes}m`;
-  }
-  const hours = Math.floor(minutes / 60);
-  const remainingMinutes = minutes % 60;
-  return `${hours}h ${remainingMinutes}m`;
-}
+// src/components/ReportScenario.tsx
+var import_duration3 = require("executable-stories-core/utils/duration");
+
+// src/components/ReportSteps.tsx
+var import_duration = require("executable-stories-core/utils/duration");
 
 // src/components/doc/DocNote.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
@@ -482,36 +470,29 @@ function DocLink({ entry }) {
   );
 }
 
-// src/components/doc/DocSection.tsx
+// src/lib/markdown.ts
 var import_marked = require("marked");
 
-// ../executable-stories-core/dist/utils/url.js
-function safeUrl(value) {
-  if (!value) return void 0;
-  const trimmed = value.trim();
-  const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(trimmed);
-  if (scheme && !/^https?$/i.test(scheme[1] ?? "")) return void 0;
-  return trimmed;
+// src/lib/url.ts
+var import_url = require("executable-stories-core/utils/url");
+
+// src/lib/markdown.ts
+function safeMarkdownHtml(markdown) {
+  const raw = import_marked.marked.parse(markdown, { async: false });
+  return raw.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<\/?(?:iframe|object|embed|form|base)\b[^>]*>/gi, "").replace(/\son[a-z]+\s*=\s*"[^"]*"/gi, "").replace(/\son[a-z]+\s*=\s*'[^']*'/gi, "").replace(/\son[a-z]+\s*=\s*[^\s>]+/gi, "").replace(/(href|src)\s*=\s*"([^"]*)"/gi, (_m, attr, val) => `${attr}="${neutralizeUrl(val)}"`).replace(/(href|src)\s*=\s*'([^']*)'/gi, (_m, attr, val) => `${attr}='${neutralizeUrl(val)}'`);
 }
-function safeImageUrl(value) {
-  if (!value) return void 0;
-  const trimmed = value.trim();
-  if (/^data:image\//i.test(trimmed)) return trimmed;
-  return safeUrl(trimmed);
+function dedent(text) {
+  const lines = text.replace(/\t/g, "  ").split("\n");
+  const indents = lines.filter((line) => line.trim().length > 0).map((line) => line.length - line.trimStart().length);
+  const shortest = indents.length > 0 ? Math.min(...indents) : 0;
+  return lines.map((line) => line.slice(shortest)).join("\n").trim();
 }
-function isLocalFsPath(value) {
-  return /^(?:[/\\]|[A-Za-z]:[/\\])/.test(value);
+function neutralizeUrl(value) {
+  return (0, import_url.safeUrl)(value) ?? "#";
 }
 
 // src/components/doc/DocSection.tsx
 var import_jsx_runtime9 = require("react/jsx-runtime");
-function neutralizeUrl(value) {
-  return safeUrl(value) ?? "#";
-}
-function safeMarkdownHtml(markdown) {
-  const raw = import_marked.marked.parse(markdown, { async: false });
-  return raw.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<\/?(?:iframe|object|embed|form|base)\b[^>]*>/gi, "").replace(/\son[a-z]+\s*=\s*"[^"]*"/gi, "").replace(/\son[a-z]+\s*=\s*'[^']*'/gi, "").replace(/\son[a-z]+\s*=\s*[^\s>]+/gi, "").replace(/(href|src)\s*=\s*"([^"]*)"/gi, (_m, attr, val) => `${attr}="${neutralizeUrl(val)}"`).replace(/(href|src)\s*=\s*'([^']*)'/gi, (_m, attr, val) => `${attr}='${neutralizeUrl(val)}'`);
-}
 function DocSection({ entry }) {
   const renderers = useBuiltinRenderers();
   if (renderers.section) {
@@ -557,7 +538,7 @@ function DocMermaid({ entry }) {
 // src/components/doc/DocScreenshot.tsx
 var import_jsx_runtime11 = require("react/jsx-runtime");
 function DocScreenshot({ entry }) {
-  const src = isLocalFsPath(entry.path) ? void 0 : safeImageUrl(entry.path);
+  const src = (0, import_url.isLocalFsPath)(entry.path) ? void 0 : (0, import_url.safeImageUrl)(entry.path);
   if (!src) {
     return /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("figure", { className: "my-3 rounded-md border border-dashed border-border p-3 text-sm text-muted-foreground", children: [
       /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "font-medium", children: "Screenshot unavailable" }),
@@ -582,15 +563,15 @@ function DocScreenshot({ entry }) {
 // src/components/doc/DocVideo.tsx
 var import_jsx_runtime12 = require("react/jsx-runtime");
 function DocVideo({ entry }) {
-  if (isLocalFsPath(entry.path)) {
+  if ((0, import_url.isLocalFsPath)(entry.path)) {
     return /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("figure", { className: "my-3 rounded-md border border-dashed border-border p-3 text-sm text-muted-foreground", children: [
       /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: "font-medium", children: "Video unavailable" }),
       /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: "mt-1 break-all font-mono text-xs", children: entry.path }),
       entry.caption ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("figcaption", { className: "mt-1.5 text-xs", children: entry.caption }) : null
     ] });
   }
-  const src = safeUrl(entry.path);
-  const poster = safeUrl(entry.poster);
+  const src = (0, import_url.safeUrl)(entry.path);
+  const poster = (0, import_url.safeUrl)(entry.poster);
   return /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("figure", { className: "my-3", children: [
     /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
       "video",
@@ -611,7 +592,7 @@ var import_jsx_runtime13 = require("react/jsx-runtime");
 function DocHtml({ entry }) {
   const height = typeof entry.height === "number" ? `${entry.height}px` : entry.height ?? "400px";
   const title = entry.title ?? "Embedded HTML";
-  const safeHref = safeUrl(entry.url ?? entry.path);
+  const safeHref = (0, import_url.safeUrl)(entry.url ?? entry.path);
   const frameProps = entry.content !== void 0 ? { srcDoc: entry.content } : { src: safeHref ?? "" };
   return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("figure", { className: "my-3 overflow-hidden rounded-md border border-border", children: [
     /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("figcaption", { className: "flex items-center justify-between border-b border-border bg-muted/40 px-3 py-1.5 text-xs font-medium text-muted-foreground", children: [
@@ -778,7 +759,7 @@ function ReportStepItem({ step }) {
             }
           ),
           /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", { className: "flex-1 text-foreground", children: highlightStepParams(step.text) }),
-          step.durationMs > 0 ? /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", { className: "shrink-0 whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: formatDuration(step.durationMs) }) : null
+          step.durationMs > 0 ? /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", { className: "shrink-0 whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: (0, import_duration.formatDuration)(step.durationMs) }) : null
         ] }),
         step.errorMessage ? /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
           "pre",
@@ -794,125 +775,10 @@ function ReportStepItem({ step }) {
   );
 }
 
-// ../executable-stories-core/dist/state-diff.js
-var isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-function deepEqual(a, b) {
-  if (Object.is(a, b)) return true;
-  if (Array.isArray(a) && Array.isArray(b)) {
-    return a.length === b.length && a.every((v, i) => deepEqual(v, b[i]));
-  }
-  if (isPlainObject(a) && isPlainObject(b)) {
-    const ak = Object.keys(a);
-    const bk = Object.keys(b);
-    return ak.length === bk.length && ak.every((k) => k in b && deepEqual(a[k], b[k]));
-  }
-  return false;
-}
-var joinKey = (path, key) => path === "" ? key : `${path}.${key}`;
-function walk(path, before, after, out) {
-  if (Object.is(before, after)) return;
-  if (Array.isArray(before) && Array.isArray(after)) {
-    const shared = Math.min(before.length, after.length);
-    for (let i = 0; i < shared; i++) walk(`${path}[${i}]`, before[i], after[i], out);
-    for (let i = shared; i < after.length; i++) out.push({ path: `${path}[${i}]`, kind: "added", after: after[i] });
-    for (let i = shared; i < before.length; i++) out.push({ path: `${path}[${i}]`, kind: "removed", before: before[i] });
-    return;
-  }
-  if (isPlainObject(before) && isPlainObject(after)) {
-    for (const key of Object.keys(after)) {
-      const p = joinKey(path, key);
-      if (key in before) walk(p, before[key], after[key], out);
-      else out.push({ path: p, kind: "added", after: after[key] });
-    }
-    for (const key of Object.keys(before)) {
-      if (!(key in after)) out.push({ path: joinKey(path, key), kind: "removed", before: before[key] });
-    }
-    return;
-  }
-  if (!deepEqual(before, after)) out.push({ path, kind: "changed", before, after });
-}
-function diffStateValues(before, after) {
-  const out = [];
-  walk("", before, after, out);
-  return out;
-}
-function formatStateValue(value, maxLen = 60) {
-  const s = value === void 0 ? "undefined" : JSON.stringify(value);
-  return s.length > maxLen ? `${s.slice(0, maxLen - 1)}\u2026` : s;
-}
-function summarizeStateChanges(changes) {
-  return changes.map((c) => {
-    const at = c.path === "" ? "(root)" : c.path;
-    switch (c.kind) {
-      case "added":
-        return `+ ${at}: ${formatStateValue(c.after)}`;
-      case "removed":
-        return `\u2212 ${at}`;
-      case "changed":
-        return `${at}: ${formatStateValue(c.before)} \u2192 ${formatStateValue(c.after)}`;
-    }
-  });
-}
-
-// ../executable-stories-core/dist/storyboard.js
-function findScreenshot(entries) {
-  for (const entry of entries) {
-    if (entry.kind === "screenshot") return entry;
-    if (entry.children) {
-      const nested = findScreenshot(entry.children);
-      if (nested) return nested;
-    }
-  }
-  return void 0;
-}
-function findStates(entries, out = []) {
-  for (const entry of entries) {
-    if (entry.kind === "state") out.push(entry);
-    if (entry.children) findStates(entry.children, out);
-  }
-  return out;
-}
-var laneOf = (label) => label ?? "";
-function extractStoryboardFrames(scenario) {
-  const frames = [];
-  const laneOrder = [];
-  const previous = /* @__PURE__ */ new Map();
-  for (const step of scenario.steps) {
-    const shot = findScreenshot(step.docEntries);
-    const stateDocs = findStates(step.docEntries);
-    if (!shot && stateDocs.length === 0) continue;
-    const byLane = /* @__PURE__ */ new Map();
-    for (const doc of stateDocs) {
-      const lane = laneOf(doc.label);
-      if (!byLane.has(lane) && !laneOrder.includes(lane)) laneOrder.push(lane);
-      byLane.set(lane, doc);
-    }
-    const states = [];
-    for (const lane of laneOrder) {
-      const doc = byLane.get(lane);
-      if (!doc) continue;
-      const card = {
-        ...doc.label !== void 0 && { label: doc.label },
-        value: doc.value
-      };
-      if (previous.has(lane)) card.changes = diffStateValues(previous.get(lane), doc.value);
-      previous.set(lane, doc.value);
-      states.push(card);
-    }
-    frames.push({
-      stepId: step.id,
-      stepIndex: step.index,
-      keyword: step.keyword,
-      text: step.text,
-      status: step.status,
-      ...shot && { screenshot: { path: shot.path, ...shot.alt !== void 0 && { alt: shot.alt } } },
-      states
-    });
-  }
-  return frames;
-}
-
 // src/components/ReportStoryboard.tsx
+var import_storyboard = require("executable-stories-core/storyboard");
+var import_state_diff = require("executable-stories-core/state-diff");
+var import_url6 = require("executable-stories-core/utils/url");
 var import_jsx_runtime20 = require("react/jsx-runtime");
 var FRAME_GLYPH = {
   passed: "\u2713",
@@ -927,7 +793,7 @@ var FRAME_GLYPH_COLOR = {
   pending: "text-pend"
 };
 function ReportStoryboard({ scenario }) {
-  const frames = extractStoryboardFrames(scenario);
+  const frames = (0, import_storyboard.extractStoryboardFrames)(scenario);
   if (frames.length < 2) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("section", { "data-slot": "storyboard", "aria-label": "Storyboard", className: "mb-3", children: [
     /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("h4", { className: "mb-1.5 text-xs font-semibold tracking-wide text-muted-foreground uppercase", children: "Storyboard" }),
@@ -961,7 +827,7 @@ function StoryboardFrameItem({ frame }) {
 }
 function FrameScreenshot({ frame, label }) {
   const path = frame.screenshot?.path ?? "";
-  const src = isLocalFsPath(path) ? void 0 : safeImageUrl(path);
+  const src = (0, import_url6.isLocalFsPath)(path) ? void 0 : (0, import_url6.safeImageUrl)(path);
   return /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
     "a",
     {
@@ -1007,7 +873,7 @@ function StateCardView({ card }) {
           "rounded-sm px-1.5 py-0.5 font-mono text-[0.625rem] leading-snug break-all",
           CHANGE_TONE[change.kind]
         ),
-        children: summarizeStateChanges([change])[0]
+        children: (0, import_state_diff.summarizeStateChanges)([change])[0]
       },
       i
     )) }) : /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("p", { className: "mt-1.5 text-[0.625rem] text-muted-foreground", children: "No changes" })),
@@ -1067,6 +933,9 @@ function ReportAttachments({ attachments }) {
   );
 }
 
+// src/components/ReportTrace.tsx
+var import_duration2 = require("executable-stories-core/utils/duration");
+
 // src/lib/trace.ts
 var VALID = /* @__PURE__ */ new Set(["ok", "error", "unset"]);
 var safeStatus = (s) => VALID.has(s) ? s : "unset";
@@ -1119,15 +988,15 @@ function toTraceRows(spans) {
   roots.sort((a, b) => a.span.startTimeMs - b.span.startTimeMs);
   const rows = [];
   const seen = /* @__PURE__ */ new Set();
-  const walk2 = (node, depth) => {
+  const walk = (node, depth) => {
     if (seen.has(node.span.spanId)) return;
     seen.add(node.span.spanId);
     rows.push({ ...node.span, depth });
-    for (const child of node.children) walk2(child, depth + 1);
+    for (const child of node.children) walk(child, depth + 1);
   };
-  for (const root of roots) walk2(root, 0);
+  for (const root of roots) walk(root, 0);
   for (const node of byId.values()) {
-    if (!seen.has(node.span.spanId)) walk2(node, 0);
+    if (!seen.has(node.span.spanId)) walk(node, 0);
   }
   return rows;
 }
@@ -1161,7 +1030,7 @@ function ReportTrace({ spans }) {
       " span",
       rows.length === 1 ? "" : "s",
       ", ",
-      formatDuration(totalMs),
+      (0, import_duration2.formatDuration)(totalMs),
       ")"
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("ul", { className: "flex flex-col gap-0.5 px-3 pb-3 font-mono text-[0.6875rem]", children: rows.map((row, i) => {
@@ -1184,7 +1053,7 @@ function ReportTrace({ spans }) {
             style: { left: `${leftPct}%`, width: `${widthPct}%` }
           }
         ) }),
-        /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "w-16 shrink-0 text-right text-muted-foreground", children: formatDuration(row.durationMs) })
+        /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "w-16 shrink-0 text-right text-muted-foreground", children: (0, import_duration2.formatDuration)(row.durationMs) })
       ] }, `${row.spanId}-${i}`);
     }) })
   ] });
@@ -1295,6 +1164,7 @@ function useCollapse() {
 
 // src/interactive/scenario-actions.tsx
 var import_react7 = require("react");
+var import_scenario_markdown = require("executable-stories-core/utils/scenario-markdown");
 var ScenarioActionsContext = (0, import_react7.createContext)(null);
 var ScenarioActionsProvider = ScenarioActionsContext.Provider;
 function useScenarioActions() {
@@ -1440,7 +1310,7 @@ function ReportScenario({ scenario, hideTitle = false }) {
             ] }),
             /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("div", { className: "flex shrink-0 items-center gap-2", children: [
               /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(ScenarioRunHistory, { scenarioId: scenario.id }),
-              scenario.durationMs > 0 ? /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("span", { className: "whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: formatDuration(scenario.durationMs) }) : null,
+              scenario.durationMs > 0 ? /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("span", { className: "whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: (0, import_duration3.formatDuration)(scenario.durationMs) }) : null,
               meta.showPill ? /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(Badge, { variant: meta.badgeVariant, "aria-label": `Status: ${label}`, children: label }) : /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("span", { className: "sr-only", children: `Status: ${label}` }),
               actions ? /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)(DropdownMenu, { children: [
                 /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
@@ -1499,8 +1369,35 @@ function ReportScenarioList({ feature }) {
   return /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(import_jsx_runtime27.Fragment, { children: feature.scenarios.map((scenario) => /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(ReportScenario, { scenario }, scenario.id)) });
 }
 
-// src/components/ReportFeature.tsx
+// src/components/ReportFeatureIntro.tsx
 var import_jsx_runtime28 = require("react/jsx-runtime");
+function ReportFeatureIntro({ feature }) {
+  const hasNarrative = Boolean(feature.narrative?.trim());
+  const hasGlossary = Boolean(feature.glossary?.length);
+  if (!hasNarrative && !hasGlossary) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("div", { className: "flex flex-col gap-3 border-l-2 border-border pl-4 text-sm", children: [
+    hasNarrative ? /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
+      "div",
+      {
+        className: "es-doc-prose prose prose-sm max-w-none text-muted-foreground",
+        dangerouslySetInnerHTML: { __html: safeMarkdownHtml(dedent(feature.narrative)) }
+      }
+    ) : null,
+    hasGlossary ? /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("dl", { className: "grid gap-1.5", "aria-label": "Glossary", children: feature.glossary.map((entry) => /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("div", { className: "flex flex-wrap gap-x-2 text-xs", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("dt", { className: "font-medium text-foreground", children: entry.term }),
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("dd", { className: "flex-1 text-muted-foreground", children: entry.definition })
+    ] }, entry.term)) }) : null
+  ] });
+}
+function featureKindLabel(kind) {
+  if (kind === "ability") return "Ability";
+  if (kind === "business-need") return "Business need";
+  if (kind === "feature") return "Feature";
+  return null;
+}
+
+// src/components/ReportFeature.tsx
+var import_jsx_runtime29 = require("react/jsx-runtime");
 function ReportFeature({ feature }) {
   const titleId = `${feature.id}-title`;
   const bodyId = `${feature.id}-body`;
@@ -1508,10 +1405,11 @@ function ReportFeature({ feature }) {
   const skipped = s.skipped + s.pending;
   const collapse = useCollapse();
   const collapsed = collapse?.isCollapsed(feature.id) ?? false;
+  const kindLabel = featureKindLabel(feature.kind);
   return (
     // Suite = a section heading + a divider, NOT another bordered card. Drops a
     // layer of nesting so the scenario cards below read as the primary unit.
-    /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(
+    /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(
       "section",
       {
         id: feature.id,
@@ -1519,9 +1417,9 @@ function ReportFeature({ feature }) {
         "aria-labelledby": titleId,
         className: "flex flex-col gap-3",
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("div", { className: "flex items-end justify-between gap-4 border-b border-border pb-2", children: [
-            /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("div", { className: "min-w-0", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("h2", { id: titleId, className: "text-base font-semibold tracking-tight text-foreground", children: collapse ? /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(
+          /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("div", { className: "flex items-end justify-between gap-4 border-b border-border pb-2", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("div", { className: "min-w-0", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("h2", { id: titleId, className: "text-base font-semibold tracking-tight text-foreground", children: collapse ? /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(
                 "button",
                 {
                   type: "button",
@@ -1530,31 +1428,34 @@ function ReportFeature({ feature }) {
                   "aria-controls": bodyId,
                   className: "flex w-full cursor-pointer items-center gap-2 text-left hover:text-foreground/80",
                   children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("span", { "aria-hidden": true, className: cn("shrink-0 text-xs text-muted-foreground transition-transform", !collapsed && "rotate-90"), children: "\u25B8" }),
-                    /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("span", { className: "truncate", children: feature.title })
+                    /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("span", { "aria-hidden": true, className: cn("shrink-0 text-xs text-muted-foreground transition-transform", !collapsed && "rotate-90"), children: "\u25B8" }),
+                    /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("span", { className: "truncate", children: feature.title })
                   ]
                 }
               ) : feature.title }),
-              /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("p", { className: cn("mt-0.5 truncate font-mono text-xs text-muted-foreground", collapse && "pl-5"), children: feature.sourceFile })
+              /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("p", { className: cn("mt-0.5 flex items-center gap-2 text-xs text-muted-foreground", collapse && "pl-5"), children: [
+                kindLabel ? /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("span", { className: "shrink-0 rounded-sm bg-muted px-1.5 py-0.5 font-medium text-foreground", children: kindLabel }) : null,
+                /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("span", { className: "truncate font-mono", children: feature.sourceFile })
+              ] })
             ] }),
-            /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(
+            /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(
               "p",
               {
                 className: "flex shrink-0 items-center gap-1.5 text-xs text-muted-foreground",
                 "aria-label": `${s.passed} passed, ${s.failed} failed, ${skipped} skipped`,
                 children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("span", { children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("span", { children: [
                     s.passed,
                     " passed"
                   ] }),
-                  /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("span", { "aria-hidden": true, children: "\xB7" }),
-                  /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("span", { className: cn(s.failed > 0 && "font-medium text-fail"), children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("span", { "aria-hidden": true, children: "\xB7" }),
+                  /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("span", { className: cn(s.failed > 0 && "font-medium text-fail"), children: [
                     s.failed,
                     " failed"
                   ] }),
-                  skipped > 0 ? /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(import_jsx_runtime28.Fragment, { children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("span", { "aria-hidden": true, children: "\xB7" }),
-                    /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("span", { children: [
+                  skipped > 0 ? /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(import_jsx_runtime29.Fragment, { children: [
+                    /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("span", { "aria-hidden": true, children: "\xB7" }),
+                    /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("span", { children: [
                       skipped,
                       " skipped"
                     ] })
@@ -1563,7 +1464,10 @@ function ReportFeature({ feature }) {
               }
             )
           ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("div", { id: bodyId, hidden: collapsed, className: "flex flex-col gap-3", children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(ReportScenarioList, { feature }) })
+          /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("div", { id: bodyId, hidden: collapsed, className: "flex flex-col gap-3", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(ReportFeatureIntro, { feature }),
+            /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(ReportScenarioList, { feature })
+          ] })
         ]
       }
     )
@@ -1571,17 +1475,17 @@ function ReportFeature({ feature }) {
 }
 
 // src/components/ReportFeatureList.tsx
-var import_jsx_runtime29 = require("react/jsx-runtime");
+var import_jsx_runtime30 = require("react/jsx-runtime");
 function ReportFeatureList() {
   const report = useReport();
-  return /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("div", { className: "flex flex-col gap-8", children: report.features.map((feature) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(ReportFeature, { feature }, feature.id)) });
+  return /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("div", { className: "flex flex-col gap-8", children: report.features.map((feature) => /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(ReportFeature, { feature }, feature.id)) });
 }
 
 // src/components/ui/empty.tsx
 var import_class_variance_authority2 = require("class-variance-authority");
-var import_jsx_runtime30 = require("react/jsx-runtime");
+var import_jsx_runtime31 = require("react/jsx-runtime");
 function Empty({ className, ...props }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
     "div",
     {
       "data-slot": "empty",
@@ -1594,7 +1498,7 @@ function Empty({ className, ...props }) {
   );
 }
 function EmptyHeader({ className, ...props }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
     "div",
     {
       "data-slot": "empty-header",
@@ -1621,7 +1525,7 @@ var emptyMediaVariants = (0, import_class_variance_authority2.cva)(
   }
 );
 function EmptyTitle({ className, ...props }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
     "div",
     {
       "data-slot": "empty-title",
@@ -1632,16 +1536,16 @@ function EmptyTitle({ className, ...props }) {
 }
 
 // src/components/ReportEmpty.tsx
-var import_jsx_runtime31 = require("react/jsx-runtime");
+var import_jsx_runtime32 = require("react/jsx-runtime");
 function ReportEmpty({ message }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Empty, { "aria-live": "polite", className: "border", children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(EmptyHeader, { children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(EmptyTitle, { children: message ?? "No scenarios in this report." }) }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(Empty, { "aria-live": "polite", className: "border", children: /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(EmptyHeader, { children: /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(EmptyTitle, { children: message ?? "No scenarios in this report." }) }) });
 }
 
 // src/components/ReportSummary.tsx
-var import_jsx_runtime32 = require("react/jsx-runtime");
+var import_jsx_runtime33 = require("react/jsx-runtime");
 function ReportSummary({ className }) {
   const report = useReport();
-  return /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)(
     ReportSummaryView,
     {
       summary: report.summary,
@@ -1667,7 +1571,7 @@ function ReportSummaryView({ summary, className, ariaLabel }) {
   if (summary.pending > 0) {
     cards.push({ status: "pending", label: "Pending", value: summary.pending });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)(
     "dl",
     {
       className: cn(
@@ -1680,17 +1584,17 @@ function ReportSummaryView({ summary, className, ariaLabel }) {
       "aria-label": ariaLabel,
       children: cards.map((c) => {
         const tone = TONE[c.status];
-        return /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)(
+        return /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)(
           "div",
           {
             "data-status": c.status,
             className: "rounded-lg border bg-card px-4 py-3",
             children: [
-              /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("dt", { className: "flex items-center gap-1.5 font-mono text-[11px] font-medium uppercase tracking-wider text-muted-foreground", children: [
-                /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("span", { className: cn("size-1.5 shrink-0 rounded-full", tone.dot), "aria-hidden": "true" }),
+              /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("dt", { className: "flex items-center gap-1.5 font-mono text-[11px] font-medium uppercase tracking-wider text-muted-foreground", children: [
+                /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("span", { className: cn("size-1.5 shrink-0 rounded-full", tone.dot), "aria-hidden": "true" }),
                 c.label
               ] }),
-              /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("dd", { className: cn("mt-2 text-3xl font-semibold leading-none tracking-tight tabular-nums", tone.num), children: c.value })
+              /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("dd", { className: cn("mt-2 text-3xl font-semibold leading-none tracking-tight tabular-nums", tone.num), children: c.value })
             ]
           },
           c.status
@@ -1700,6 +1604,9 @@ function ReportSummaryView({ summary, className, ariaLabel }) {
   );
 }
 
+// src/components/ReportMeta.tsx
+var import_duration4 = require("executable-stories-core/utils/duration");
+
 // src/lib/provenance.ts
 function reportLastRunMs(report) {
   if (report.finishedAtMs && report.finishedAtMs > 0) return report.finishedAtMs;
@@ -1750,7 +1657,7 @@ function prUrl(ci) {
 }
 
 // src/components/ReportMeta.tsx
-var import_jsx_runtime33 = require("react/jsx-runtime");
+var import_jsx_runtime34 = require("react/jsx-runtime");
 function ReportMeta() {
   const report = useReport();
   const items = [];
@@ -1759,7 +1666,7 @@ function ReportMeta() {
     items.push({ label: "Started", value: new Date(report.startedAtMs).toLocaleString() });
   }
   if (report.durationMs) {
-    items.push({ label: "Duration", value: formatDuration(report.durationMs) });
+    items.push({ label: "Duration", value: (0, import_duration4.formatDuration)(report.durationMs) });
   }
   if (report.packageVersion) {
     items.push({ label: "Version", value: report.packageVersion });
@@ -1773,13 +1680,13 @@ function ReportMeta() {
     const short = sha.slice(0, 8);
     items.push({
       label: "Commit",
-      value: url ? /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: short }) : short
+      value: url ? /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: short }) : short
     });
   }
   if (report.ci) {
     items.push({
       label: "CI",
-      value: report.ci.url ? /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("a", { href: report.ci.url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: [
+      value: report.ci.url ? /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("a", { href: report.ci.url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: [
         ciDisplayName(report.ci.name),
         report.ci.buildNumber ? ` #${report.ci.buildNumber}` : ""
       ] }) : `${ciDisplayName(report.ci.name)}${report.ci.buildNumber ? ` #${report.ci.buildNumber}` : ""}`
@@ -1790,7 +1697,7 @@ function ReportMeta() {
     const label = `#${report.ci.prNumber}`;
     items.push({
       label: "PR",
-      value: url ? /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: label }) : label
+      value: url ? /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: label }) : label
     });
   }
   if (items.length === 0) return null;
@@ -1798,48 +1705,48 @@ function ReportMeta() {
     // Run metadata is useful but secondary to "what failed" — tuck it into a
     // collapsed disclosure so it doesn't push the result down. Native <details>
     // so it works with no JS (the SSR/no-hydration report still toggles).
-    /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("details", { "data-es-meta-card": true, className: "es-run-details group rounded-lg border border-border bg-card text-xs", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("summary", { className: "flex cursor-pointer list-none select-none items-center gap-1.5 px-4 py-2 font-medium text-muted-foreground [&::-webkit-details-marker]:hidden", children: [
-        /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("span", { "aria-hidden": true, className: "text-xs transition-transform group-open:rotate-90", children: "\u25B8" }),
+    /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("details", { "data-es-meta-card": true, className: "es-run-details group rounded-lg border border-border bg-card text-xs", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("summary", { className: "flex cursor-pointer list-none select-none items-center gap-1.5 px-4 py-2 font-medium text-muted-foreground [&::-webkit-details-marker]:hidden", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("span", { "aria-hidden": true, className: "text-xs transition-transform group-open:rotate-90", children: "\u25B8" }),
         "Run details"
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("dl", { className: "flex flex-wrap gap-x-5 gap-y-2 border-t border-border px-4 py-3 text-muted-foreground", "aria-label": "Run metadata", children: items.map((item) => /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("div", { className: "flex items-baseline gap-1.5", children: [
-        /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("dt", { className: "font-medium", children: item.label }),
-        /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("dd", { className: "font-mono text-foreground", children: item.value })
+      /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("dl", { className: "flex flex-wrap gap-x-5 gap-y-2 border-t border-border px-4 py-3 text-muted-foreground", "aria-label": "Run metadata", children: items.map((item) => /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("div", { className: "flex items-baseline gap-1.5", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("dt", { className: "font-medium", children: item.label }),
+        /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("dd", { className: "font-mono text-foreground", children: item.value })
       ] }, item.label)) })
     ] })
   );
 }
 
 // src/components/ReportSchemaError.tsx
-var import_jsx_runtime34 = require("react/jsx-runtime");
+var import_jsx_runtime35 = require("react/jsx-runtime");
 function ReportSchemaError({ error }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("section", { className: "es-schema-error", role: "alert", "aria-live": "assertive", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("p", { children: /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("strong", { children: "Report could not be displayed." }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("p", { children: error.message }),
-    error.code === "SCHEMA_VERSION_MISMATCH" ? /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("p", { children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)("section", { className: "es-schema-error", role: "alert", "aria-live": "assertive", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("p", { children: /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("strong", { children: "Report could not be displayed." }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("p", { children: error.message }),
+    error.code === "SCHEMA_VERSION_MISMATCH" ? /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)("p", { children: [
       "The report bundle is newer than this version of ",
-      /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("code", { children: "executable-stories-react" }),
+      /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("code", { children: "executable-stories-react" }),
       ". Upgrade the package, or regenerate the report with an older formatters CLI."
     ] }) : null,
-    error.issues && error.issues.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("details", { children: [
-      /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("summary", { children: [
+    error.issues && error.issues.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)("details", { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)("summary", { children: [
         error.issues.length,
         " validation issue",
         error.issues.length === 1 ? "" : "s"
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("pre", { children: error.issues.slice(0, 20).map((i) => `${i.path}: ${i.message}`).join("\n") })
+      /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("pre", { children: error.issues.slice(0, 20).map((i) => `${i.path}: ${i.message}`).join("\n") })
     ] }) : null
   ] });
 }
 
 // src/components/ReportShell.tsx
-var import_jsx_runtime35 = require("react/jsx-runtime");
+var import_jsx_runtime36 = require("react/jsx-runtime");
 function ReportTitleBlock({ title }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)(import_jsx_runtime35.Fragment, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("h1", { children: title ?? "Story Report" }),
-    /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(ReportSummary, {}),
-    /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(ReportMeta, {})
+  return /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(import_jsx_runtime36.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("h1", { children: title ?? "Story Report" }),
+    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportSummary, {}),
+    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportMeta, {})
   ] });
 }
 function ReportErrorShell({
@@ -1848,28 +1755,28 @@ function ReportErrorShell({
   title,
   dataTheme
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(ReportSchemaError, { error }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportSchemaError, { error }) });
 }
 
 // src/components/Report.tsx
-var import_jsx_runtime36 = require("react/jsx-runtime");
+var import_jsx_runtime37 = require("react/jsx-runtime");
 function Report(props) {
   const { report, customRenderers, renderers, className, title, dataTheme } = props;
   const result = unwrapReport(report);
   if (!result.ok) {
-    return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportErrorShell, { error: result.error, className, title, dataTheme });
+    return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(ReportErrorShell, { error: result.error, className, title, dataTheme });
   }
   const data = result.data;
   const hasContent = data.features.length > 0;
-  return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportRoot, { report: data, customRenderers, renderers, children: /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("header", { className: "es-report-header", children: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportTitleBlock, { title }) }),
-    hasContent ? /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportFeatureList, {}) : /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ReportEmpty, {})
+  return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(ReportRoot, { report: data, customRenderers, renderers, children: /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("header", { className: "es-report-header", children: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(ReportTitleBlock, { title }) }),
+    hasContent ? /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(ReportFeatureList, {}) : /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(ReportEmpty, {})
   ] }) });
 }
 
 // src/components/doc/MermaidView.tsx
 var import_react8 = require("react");
-var import_jsx_runtime37 = require("react/jsx-runtime");
+var import_jsx_runtime38 = require("react/jsx-runtime");
 function prefersDark(el) {
   const themed = el?.closest("[data-theme]");
   if (themed?.dataset.theme === "dark") return true;
@@ -1923,9 +1830,9 @@ function MermaidView({ entry, load }) {
     };
   }, [entry.code, load]);
   if (svg) {
-    return /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)("figure", { ref, className: "my-3", children: [
-      entry.title ? /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("figcaption", { className: "mb-1.5 text-xs font-medium text-muted-foreground", children: entry.title }) : null,
-      /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime38.jsxs)("figure", { ref, className: "my-3", children: [
+      entry.title ? /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("figcaption", { className: "mb-1.5 text-xs font-medium text-muted-foreground", children: entry.title }) : null,
+      /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(
         "div",
         {
           role: "img",
@@ -1936,8 +1843,8 @@ function MermaidView({ entry, load }) {
       )
     ] });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)(import_jsx_runtime37.Fragment, { children: [
-    error ? /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime38.jsxs)(import_jsx_runtime38.Fragment, { children: [
+    error ? /* @__PURE__ */ (0, import_jsx_runtime38.jsxs)(
       "p",
       {
         role: "alert",
@@ -1949,19 +1856,19 @@ function MermaidView({ entry, load }) {
         ]
       }
     ) : null,
-    /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(MermaidSource, { entry, ref })
+    /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(MermaidSource, { entry, ref })
   ] });
 }
 
 // src/components/doc/MermaidDiagram.tsx
-var import_jsx_runtime38 = require("react/jsx-runtime");
+var import_jsx_runtime39 = require("react/jsx-runtime");
 var mermaidLoader;
 function loadMermaid() {
   mermaidLoader ??= import("mermaid").then((m) => m.default);
   return mermaidLoader;
 }
 function MermaidDiagram({ entry, load = loadMermaid }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(MermaidView, { entry, load });
+  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(MermaidView, { entry, load });
 }
 
 // src/components/ScenarioExplorer.tsx
@@ -1971,12 +1878,12 @@ var import_react9 = require("react");
 var React4 = require("react");
 var import_cmdk = require("cmdk");
 var import_lucide_react3 = require("lucide-react");
-var import_jsx_runtime39 = require("react/jsx-runtime");
+var import_jsx_runtime40 = require("react/jsx-runtime");
 function Command({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
     import_cmdk.Command,
     {
       "data-slot": "command",
@@ -1992,14 +1899,14 @@ function CommandInput({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)(
     "div",
     {
       "data-slot": "command-input-wrapper",
       className: "flex h-9 items-center gap-2 border-b px-3",
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_lucide_react3.SearchIcon, { className: "size-4 shrink-0 opacity-50" }),
-        /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react3.SearchIcon, { className: "size-4 shrink-0 opacity-50" }),
+        /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
           import_cmdk.Command.Input,
           {
             "data-slot": "command-input",
@@ -2018,7 +1925,7 @@ function CommandList({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
     import_cmdk.Command.List,
     {
       "data-slot": "command-list",
@@ -2033,7 +1940,7 @@ function CommandList({
 function CommandEmpty({
   ...props
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
     import_cmdk.Command.Empty,
     {
       "data-slot": "command-empty",
@@ -2046,7 +1953,7 @@ function CommandGroup({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
     import_cmdk.Command.Group,
     {
       "data-slot": "command-group",
@@ -2062,7 +1969,7 @@ function CommandItem({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
     import_cmdk.Command.Item,
     {
       "data-slot": "command-item",
@@ -2076,7 +1983,7 @@ function CommandItem({
 }
 
 // src/components/ScenarioExplorer.tsx
-var import_jsx_runtime40 = require("react/jsx-runtime");
+var import_jsx_runtime41 = require("react/jsx-runtime");
 var STATUS_FILTERS = [
   { value: "all", label: "All" },
   { value: "passed", label: "Passed" },
@@ -2087,22 +1994,22 @@ var STATUS_FILTERS = [
 function ScenarioExplorer({ scenarios, summary }) {
   const [status, setStatus] = (0, import_react9.useState)("all");
   const visible = status === "all" ? scenarios : scenarios.filter((s) => s.status === status);
-  return /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("div", { className: "font-sans text-foreground", children: [
-    summary ? /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("p", { className: "mb-3 text-sm text-muted-foreground", children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime41.jsxs)("div", { className: "font-sans text-foreground", children: [
+    summary ? /* @__PURE__ */ (0, import_jsx_runtime41.jsxs)("p", { className: "mb-3 text-sm text-muted-foreground", children: [
       summary.total,
       " scenarios \xB7 ",
-      /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("span", { className: "text-pass", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime41.jsxs)("span", { className: "text-pass", children: [
         summary.passed,
         " passed"
       ] }),
       " \xB7",
       " ",
-      /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("span", { className: "text-fail", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime41.jsxs)("span", { className: "text-fail", children: [
         summary.failed,
         " failed"
       ] })
     ] }) : null,
-    /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("div", { className: "mb-2 flex flex-wrap gap-1.5", role: "group", "aria-label": "Filter by status", children: STATUS_FILTERS.map((f) => /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime41.jsx)("div", { className: "mb-2 flex flex-wrap gap-1.5", role: "group", "aria-label": "Filter by status", children: STATUS_FILTERS.map((f) => /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(
       "button",
       {
         type: "button",
@@ -2117,26 +2024,26 @@ function ScenarioExplorer({ scenarios, summary }) {
       },
       f.value
     )) }),
-    /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)(
+    /* @__PURE__ */ (0, import_jsx_runtime41.jsxs)(
       Command,
       {
         className: "rounded-lg border border-border bg-card",
         filter: (value, search) => value.toLowerCase().includes(search.toLowerCase()) ? 1 : 0,
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(CommandInput, { placeholder: "Search scenarios\u2026" }),
-          /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)(CommandList, { className: "max-h-none", children: [
-            /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(CommandEmpty, { children: "No scenarios match your filters." }),
-            /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(CommandGroup, { children: visible.map((s) => /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(CommandInput, { placeholder: "Search scenarios\u2026" }),
+          /* @__PURE__ */ (0, import_jsx_runtime41.jsxs)(CommandList, { className: "max-h-none", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(CommandEmpty, { children: "No scenarios match your filters." }),
+            /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(CommandGroup, { children: visible.map((s) => /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(
               CommandItem,
               {
                 value: `${s.title} ${s.feature} ${s.tags.join(" ")}`,
                 asChild: true,
                 className: "cursor-pointer",
-                children: /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("a", { href: s.href, className: "flex items-center gap-3", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(Badge, { variant: s.status, children: s.status }),
-                  /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("span", { className: "min-w-0 flex-1 truncate font-medium", children: s.title }),
-                  s.tags.slice(0, 3).map((t) => /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(Badge, { variant: "tag", className: "hidden sm:inline-flex", children: t }, t)),
-                  /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("code", { className: "hidden font-mono text-xs text-muted-foreground md:inline", children: s.feature })
+                children: /* @__PURE__ */ (0, import_jsx_runtime41.jsxs)("a", { href: s.href, className: "flex items-center gap-3", children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(Badge, { variant: s.status, children: s.status }),
+                  /* @__PURE__ */ (0, import_jsx_runtime41.jsx)("span", { className: "min-w-0 flex-1 truncate font-medium", children: s.title }),
+                  s.tags.slice(0, 3).map((t) => /* @__PURE__ */ (0, import_jsx_runtime41.jsx)(Badge, { variant: "tag", className: "hidden sm:inline-flex", children: t }, t)),
+                  /* @__PURE__ */ (0, import_jsx_runtime41.jsx)("code", { className: "hidden font-mono text-xs text-muted-foreground md:inline", children: s.feature })
                 ] })
               },
               s.id
@@ -2283,7 +2190,7 @@ var story_report_v1_default = {
         title: {
           type: "string",
           minLength: 1,
-          description: "Display title. Derived from describe block when present, otherwise the file basename."
+          description: "Display title. Comes from story.feature(...) when declared, otherwise the describe block or file basename."
         },
         sourceFile: {
           type: "string",
@@ -2299,6 +2206,26 @@ var story_report_v1_default = {
             $ref: "#/$defs/Scenario"
           },
           description: "Scenarios in this feature, in declaration order."
+        },
+        kind: {
+          type: "string",
+          enum: [
+            "feature",
+            "ability",
+            "business-need"
+          ],
+          description: "How the feature was declared. Absent when the title was derived rather than declared."
+        },
+        narrative: {
+          type: "string",
+          description: "Markdown explaining why the feature exists and who it serves."
+        },
+        glossary: {
+          type: "array",
+          items: {
+            $ref: "#/$defs/GlossaryTerm"
+          },
+          description: "Terms this feature defines, linked wherever they appear in scenario text."
         }
       },
       required: [
@@ -3110,6 +3037,25 @@ var story_report_v1_default = {
         }
       },
       additionalProperties: false
+    },
+    GlossaryTerm: {
+      type: "object",
+      description: "One glossary entry: a term the scenarios use and what it means.",
+      properties: {
+        term: {
+          type: "string",
+          minLength: 1
+        },
+        definition: {
+          type: "string",
+          minLength: 1
+        }
+      },
+      required: [
+        "term",
+        "definition"
+      ],
+      additionalProperties: false
     }
   }
 };