executable-stories-react 0.10.0 → 0.11.0

package/dist/index.js

@@ -286,23 +286,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
+import { formatDuration as formatDuration3 } from "executable-stories-core/utils/duration";
+
+// src/components/ReportSteps.tsx
+import { formatDuration } from "executable-stories-core/utils/duration";
 
 // src/components/doc/DocNote.tsx
 import { jsx as jsx3 } from "react/jsx-runtime";
@@ -391,36 +379,29 @@ function DocLink({ entry }) {
   );
 }
 
-// src/components/doc/DocSection.tsx
+// src/lib/markdown.ts
 import { marked } from "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
+import { safeUrl, safeImageUrl, isLocalFsPath } from "executable-stories-core/utils/url";
+
+// src/lib/markdown.ts
+function safeMarkdownHtml(markdown) {
+  const raw = 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 safeUrl(value) ?? "#";
 }
 
 // src/components/doc/DocSection.tsx
 import { Fragment as Fragment2, jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
-function neutralizeUrl(value) {
-  return safeUrl(value) ?? "#";
-}
-function safeMarkdownHtml(markdown) {
-  const raw = 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) {
@@ -703,125 +684,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
+import { extractStoryboardFrames } from "executable-stories-core/storyboard";
+import { summarizeStateChanges } from "executable-stories-core/state-diff";
+import { isLocalFsPath as isLocalFsPath2, safeImageUrl as safeImageUrl2 } from "executable-stories-core/utils/url";
 import { jsx as jsx20, jsxs as jsxs12 } from "react/jsx-runtime";
 var FRAME_GLYPH = {
   passed: "\u2713",
@@ -870,7 +736,7 @@ function StoryboardFrameItem({ frame }) {
 }
 function FrameScreenshot({ frame, label }) {
   const path = frame.screenshot?.path ?? "";
-  const src = isLocalFsPath(path) ? void 0 : safeImageUrl(path);
+  const src = isLocalFsPath2(path) ? void 0 : safeImageUrl2(path);
   return /* @__PURE__ */ jsx20(
     "a",
     {
@@ -976,6 +842,9 @@ function ReportAttachments({ attachments }) {
   );
 }
 
+// src/components/ReportTrace.tsx
+import { formatDuration as formatDuration2 } from "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";
@@ -1028,15 +897,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;
 }
@@ -1070,7 +939,7 @@ function ReportTrace({ spans }) {
       " span",
       rows.length === 1 ? "" : "s",
       ", ",
-      formatDuration(totalMs),
+      formatDuration2(totalMs),
       ")"
     ] }),
     /* @__PURE__ */ jsx22("ul", { className: "flex flex-col gap-0.5 px-3 pb-3 font-mono text-[0.6875rem]", children: rows.map((row, i) => {
@@ -1093,7 +962,7 @@ function ReportTrace({ spans }) {
             style: { left: `${leftPct}%`, width: `${widthPct}%` }
           }
         ) }),
-        /* @__PURE__ */ jsx22("span", { className: "w-16 shrink-0 text-right text-muted-foreground", children: formatDuration(row.durationMs) })
+        /* @__PURE__ */ jsx22("span", { className: "w-16 shrink-0 text-right text-muted-foreground", children: formatDuration2(row.durationMs) })
       ] }, `${row.spanId}-${i}`);
     }) })
   ] });
@@ -1204,6 +1073,7 @@ function useCollapse() {
 
 // src/interactive/scenario-actions.tsx
 import { createContext as createContext4, useContext as useContext5 } from "react";
+import { scenarioToMarkdown as coreScenarioToMarkdown } from "executable-stories-core/utils/scenario-markdown";
 var ScenarioActionsContext = createContext4(null);
 var ScenarioActionsProvider = ScenarioActionsContext.Provider;
 function useScenarioActions() {
@@ -1349,7 +1219,7 @@ function ReportScenario({ scenario, hideTitle = false }) {
             ] }),
             /* @__PURE__ */ jsxs17("div", { className: "flex shrink-0 items-center gap-2", children: [
               /* @__PURE__ */ jsx26(ScenarioRunHistory, { scenarioId: scenario.id }),
-              scenario.durationMs > 0 ? /* @__PURE__ */ jsx26("span", { className: "whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: formatDuration(scenario.durationMs) }) : null,
+              scenario.durationMs > 0 ? /* @__PURE__ */ jsx26("span", { className: "whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: formatDuration3(scenario.durationMs) }) : null,
               meta.showPill ? /* @__PURE__ */ jsx26(Badge, { variant: meta.badgeVariant, "aria-label": `Status: ${label}`, children: label }) : /* @__PURE__ */ jsx26("span", { className: "sr-only", children: `Status: ${label}` }),
               actions ? /* @__PURE__ */ jsxs17(DropdownMenu, { children: [
                 /* @__PURE__ */ jsx26(
@@ -1408,8 +1278,35 @@ function ReportScenarioList({ feature }) {
   return /* @__PURE__ */ jsx27(Fragment8, { children: feature.scenarios.map((scenario) => /* @__PURE__ */ jsx27(ReportScenario, { scenario }, scenario.id)) });
 }
 
+// src/components/ReportFeatureIntro.tsx
+import { jsx as jsx28, jsxs as jsxs18 } from "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__ */ jsxs18("div", { className: "flex flex-col gap-3 border-l-2 border-border pl-4 text-sm", children: [
+    hasNarrative ? /* @__PURE__ */ jsx28(
+      "div",
+      {
+        className: "es-doc-prose prose prose-sm max-w-none text-muted-foreground",
+        dangerouslySetInnerHTML: { __html: safeMarkdownHtml(dedent(feature.narrative)) }
+      }
+    ) : null,
+    hasGlossary ? /* @__PURE__ */ jsx28("dl", { className: "grid gap-1.5", "aria-label": "Glossary", children: feature.glossary.map((entry) => /* @__PURE__ */ jsxs18("div", { className: "flex flex-wrap gap-x-2 text-xs", children: [
+      /* @__PURE__ */ jsx28("dt", { className: "font-medium text-foreground", children: entry.term }),
+      /* @__PURE__ */ jsx28("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
-import { Fragment as Fragment9, jsx as jsx28, jsxs as jsxs18 } from "react/jsx-runtime";
+import { Fragment as Fragment9, jsx as jsx29, jsxs as jsxs19 } from "react/jsx-runtime";
 function ReportFeature({ feature }) {
   const titleId = `${feature.id}-title`;
   const bodyId = `${feature.id}-body`;
@@ -1417,10 +1314,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__ */ jsxs18(
+    /* @__PURE__ */ jsxs19(
       "section",
       {
         id: feature.id,
@@ -1428,9 +1326,9 @@ function ReportFeature({ feature }) {
         "aria-labelledby": titleId,
         className: "flex flex-col gap-3",
         children: [
-          /* @__PURE__ */ jsxs18("div", { className: "flex items-end justify-between gap-4 border-b border-border pb-2", children: [
-            /* @__PURE__ */ jsxs18("div", { className: "min-w-0", children: [
-              /* @__PURE__ */ jsx28("h2", { id: titleId, className: "text-base font-semibold tracking-tight text-foreground", children: collapse ? /* @__PURE__ */ jsxs18(
+          /* @__PURE__ */ jsxs19("div", { className: "flex items-end justify-between gap-4 border-b border-border pb-2", children: [
+            /* @__PURE__ */ jsxs19("div", { className: "min-w-0", children: [
+              /* @__PURE__ */ jsx29("h2", { id: titleId, className: "text-base font-semibold tracking-tight text-foreground", children: collapse ? /* @__PURE__ */ jsxs19(
                 "button",
                 {
                   type: "button",
@@ -1439,31 +1337,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__ */ jsx28("span", { "aria-hidden": true, className: cn("shrink-0 text-xs text-muted-foreground transition-transform", !collapsed && "rotate-90"), children: "\u25B8" }),
-                    /* @__PURE__ */ jsx28("span", { className: "truncate", children: feature.title })
+                    /* @__PURE__ */ jsx29("span", { "aria-hidden": true, className: cn("shrink-0 text-xs text-muted-foreground transition-transform", !collapsed && "rotate-90"), children: "\u25B8" }),
+                    /* @__PURE__ */ jsx29("span", { className: "truncate", children: feature.title })
                   ]
                 }
               ) : feature.title }),
-              /* @__PURE__ */ jsx28("p", { className: cn("mt-0.5 truncate font-mono text-xs text-muted-foreground", collapse && "pl-5"), children: feature.sourceFile })
+              /* @__PURE__ */ jsxs19("p", { className: cn("mt-0.5 flex items-center gap-2 text-xs text-muted-foreground", collapse && "pl-5"), children: [
+                kindLabel ? /* @__PURE__ */ jsx29("span", { className: "shrink-0 rounded-sm bg-muted px-1.5 py-0.5 font-medium text-foreground", children: kindLabel }) : null,
+                /* @__PURE__ */ jsx29("span", { className: "truncate font-mono", children: feature.sourceFile })
+              ] })
             ] }),
-            /* @__PURE__ */ jsxs18(
+            /* @__PURE__ */ jsxs19(
               "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__ */ jsxs18("span", { children: [
+                  /* @__PURE__ */ jsxs19("span", { children: [
                     s.passed,
                     " passed"
                   ] }),
-                  /* @__PURE__ */ jsx28("span", { "aria-hidden": true, children: "\xB7" }),
-                  /* @__PURE__ */ jsxs18("span", { className: cn(s.failed > 0 && "font-medium text-fail"), children: [
+                  /* @__PURE__ */ jsx29("span", { "aria-hidden": true, children: "\xB7" }),
+                  /* @__PURE__ */ jsxs19("span", { className: cn(s.failed > 0 && "font-medium text-fail"), children: [
                     s.failed,
                     " failed"
                   ] }),
-                  skipped > 0 ? /* @__PURE__ */ jsxs18(Fragment9, { children: [
-                    /* @__PURE__ */ jsx28("span", { "aria-hidden": true, children: "\xB7" }),
-                    /* @__PURE__ */ jsxs18("span", { children: [
+                  skipped > 0 ? /* @__PURE__ */ jsxs19(Fragment9, { children: [
+                    /* @__PURE__ */ jsx29("span", { "aria-hidden": true, children: "\xB7" }),
+                    /* @__PURE__ */ jsxs19("span", { children: [
                       skipped,
                       " skipped"
                     ] })
@@ -1472,7 +1373,10 @@ function ReportFeature({ feature }) {
               }
             )
           ] }),
-          /* @__PURE__ */ jsx28("div", { id: bodyId, hidden: collapsed, className: "flex flex-col gap-3", children: /* @__PURE__ */ jsx28(ReportScenarioList, { feature }) })
+          /* @__PURE__ */ jsxs19("div", { id: bodyId, hidden: collapsed, className: "flex flex-col gap-3", children: [
+            /* @__PURE__ */ jsx29(ReportFeatureIntro, { feature }),
+            /* @__PURE__ */ jsx29(ReportScenarioList, { feature })
+          ] })
         ]
       }
     )
@@ -1480,17 +1384,17 @@ function ReportFeature({ feature }) {
 }
 
 // src/components/ReportFeatureList.tsx
-import { jsx as jsx29 } from "react/jsx-runtime";
+import { jsx as jsx30 } from "react/jsx-runtime";
 function ReportFeatureList() {
   const report = useReport();
-  return /* @__PURE__ */ jsx29("div", { className: "flex flex-col gap-8", children: report.features.map((feature) => /* @__PURE__ */ jsx29(ReportFeature, { feature }, feature.id)) });
+  return /* @__PURE__ */ jsx30("div", { className: "flex flex-col gap-8", children: report.features.map((feature) => /* @__PURE__ */ jsx30(ReportFeature, { feature }, feature.id)) });
 }
 
 // src/components/ui/empty.tsx
 import { cva as cva2 } from "class-variance-authority";
-import { jsx as jsx30 } from "react/jsx-runtime";
+import { jsx as jsx31 } from "react/jsx-runtime";
 function Empty({ className, ...props }) {
-  return /* @__PURE__ */ jsx30(
+  return /* @__PURE__ */ jsx31(
     "div",
     {
       "data-slot": "empty",
@@ -1503,7 +1407,7 @@ function Empty({ className, ...props }) {
   );
 }
 function EmptyHeader({ className, ...props }) {
-  return /* @__PURE__ */ jsx30(
+  return /* @__PURE__ */ jsx31(
     "div",
     {
       "data-slot": "empty-header",
@@ -1530,7 +1434,7 @@ var emptyMediaVariants = cva2(
   }
 );
 function EmptyTitle({ className, ...props }) {
-  return /* @__PURE__ */ jsx30(
+  return /* @__PURE__ */ jsx31(
     "div",
     {
       "data-slot": "empty-title",
@@ -1541,16 +1445,16 @@ function EmptyTitle({ className, ...props }) {
 }
 
 // src/components/ReportEmpty.tsx
-import { jsx as jsx31 } from "react/jsx-runtime";
+import { jsx as jsx32 } from "react/jsx-runtime";
 function ReportEmpty({ message }) {
-  return /* @__PURE__ */ jsx31(Empty, { "aria-live": "polite", className: "border", children: /* @__PURE__ */ jsx31(EmptyHeader, { children: /* @__PURE__ */ jsx31(EmptyTitle, { children: message ?? "No scenarios in this report." }) }) });
+  return /* @__PURE__ */ jsx32(Empty, { "aria-live": "polite", className: "border", children: /* @__PURE__ */ jsx32(EmptyHeader, { children: /* @__PURE__ */ jsx32(EmptyTitle, { children: message ?? "No scenarios in this report." }) }) });
 }
 
 // src/components/ReportSummary.tsx
-import { jsx as jsx32, jsxs as jsxs19 } from "react/jsx-runtime";
+import { jsx as jsx33, jsxs as jsxs20 } from "react/jsx-runtime";
 function ReportSummary({ className }) {
   const report = useReport();
-  return /* @__PURE__ */ jsx32(
+  return /* @__PURE__ */ jsx33(
     ReportSummaryView,
     {
       summary: report.summary,
@@ -1576,7 +1480,7 @@ function ReportSummaryView({ summary, className, ariaLabel }) {
   if (summary.pending > 0) {
     cards.push({ status: "pending", label: "Pending", value: summary.pending });
   }
-  return /* @__PURE__ */ jsx32(
+  return /* @__PURE__ */ jsx33(
     "dl",
     {
       className: cn(
@@ -1589,17 +1493,17 @@ function ReportSummaryView({ summary, className, ariaLabel }) {
       "aria-label": ariaLabel,
       children: cards.map((c) => {
         const tone = TONE[c.status];
-        return /* @__PURE__ */ jsxs19(
+        return /* @__PURE__ */ jsxs20(
           "div",
           {
             "data-status": c.status,
             className: "rounded-lg border bg-card px-4 py-3",
             children: [
-              /* @__PURE__ */ jsxs19("dt", { className: "flex items-center gap-1.5 font-mono text-[11px] font-medium uppercase tracking-wider text-muted-foreground", children: [
-                /* @__PURE__ */ jsx32("span", { className: cn("size-1.5 shrink-0 rounded-full", tone.dot), "aria-hidden": "true" }),
+              /* @__PURE__ */ jsxs20("dt", { className: "flex items-center gap-1.5 font-mono text-[11px] font-medium uppercase tracking-wider text-muted-foreground", children: [
+                /* @__PURE__ */ jsx33("span", { className: cn("size-1.5 shrink-0 rounded-full", tone.dot), "aria-hidden": "true" }),
                 c.label
               ] }),
-              /* @__PURE__ */ jsx32("dd", { className: cn("mt-2 text-3xl font-semibold leading-none tracking-tight tabular-nums", tone.num), children: c.value })
+              /* @__PURE__ */ jsx33("dd", { className: cn("mt-2 text-3xl font-semibold leading-none tracking-tight tabular-nums", tone.num), children: c.value })
             ]
           },
           c.status
@@ -1609,6 +1513,9 @@ function ReportSummaryView({ summary, className, ariaLabel }) {
   );
 }
 
+// src/components/ReportMeta.tsx
+import { formatDuration as formatDuration4 } from "executable-stories-core/utils/duration";
+
 // src/lib/provenance.ts
 function reportLastRunMs(report) {
   if (report.finishedAtMs && report.finishedAtMs > 0) return report.finishedAtMs;
@@ -1659,7 +1566,7 @@ function prUrl(ci) {
 }
 
 // src/components/ReportMeta.tsx
-import { jsx as jsx33, jsxs as jsxs20 } from "react/jsx-runtime";
+import { jsx as jsx34, jsxs as jsxs21 } from "react/jsx-runtime";
 function ReportMeta() {
   const report = useReport();
   const items = [];
@@ -1668,7 +1575,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: formatDuration4(report.durationMs) });
   }
   if (report.packageVersion) {
     items.push({ label: "Version", value: report.packageVersion });
@@ -1682,13 +1589,13 @@ function ReportMeta() {
     const short = sha.slice(0, 8);
     items.push({
       label: "Commit",
-      value: url ? /* @__PURE__ */ jsx33("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: short }) : short
+      value: url ? /* @__PURE__ */ jsx34("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__ */ jsxs20("a", { href: report.ci.url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: [
+      value: report.ci.url ? /* @__PURE__ */ jsxs21("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}` : ""}`
@@ -1699,7 +1606,7 @@ function ReportMeta() {
     const label = `#${report.ci.prNumber}`;
     items.push({
       label: "PR",
-      value: url ? /* @__PURE__ */ jsx33("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: label }) : label
+      value: url ? /* @__PURE__ */ jsx34("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: label }) : label
     });
   }
   if (items.length === 0) return null;
@@ -1707,48 +1614,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__ */ jsxs20("details", { "data-es-meta-card": true, className: "es-run-details group rounded-lg border border-border bg-card text-xs", children: [
-      /* @__PURE__ */ jsxs20("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__ */ jsx33("span", { "aria-hidden": true, className: "text-xs transition-transform group-open:rotate-90", children: "\u25B8" }),
+    /* @__PURE__ */ jsxs21("details", { "data-es-meta-card": true, className: "es-run-details group rounded-lg border border-border bg-card text-xs", children: [
+      /* @__PURE__ */ jsxs21("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__ */ jsx34("span", { "aria-hidden": true, className: "text-xs transition-transform group-open:rotate-90", children: "\u25B8" }),
         "Run details"
       ] }),
-      /* @__PURE__ */ jsx33("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__ */ jsxs20("div", { className: "flex items-baseline gap-1.5", children: [
-        /* @__PURE__ */ jsx33("dt", { className: "font-medium", children: item.label }),
-        /* @__PURE__ */ jsx33("dd", { className: "font-mono text-foreground", children: item.value })
+      /* @__PURE__ */ jsx34("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__ */ jsxs21("div", { className: "flex items-baseline gap-1.5", children: [
+        /* @__PURE__ */ jsx34("dt", { className: "font-medium", children: item.label }),
+        /* @__PURE__ */ jsx34("dd", { className: "font-mono text-foreground", children: item.value })
       ] }, item.label)) })
     ] })
   );
 }
 
 // src/components/ReportSchemaError.tsx
-import { jsx as jsx34, jsxs as jsxs21 } from "react/jsx-runtime";
+import { jsx as jsx35, jsxs as jsxs22 } from "react/jsx-runtime";
 function ReportSchemaError({ error }) {
-  return /* @__PURE__ */ jsxs21("section", { className: "es-schema-error", role: "alert", "aria-live": "assertive", children: [
-    /* @__PURE__ */ jsx34("p", { children: /* @__PURE__ */ jsx34("strong", { children: "Report could not be displayed." }) }),
-    /* @__PURE__ */ jsx34("p", { children: error.message }),
-    error.code === "SCHEMA_VERSION_MISMATCH" ? /* @__PURE__ */ jsxs21("p", { children: [
+  return /* @__PURE__ */ jsxs22("section", { className: "es-schema-error", role: "alert", "aria-live": "assertive", children: [
+    /* @__PURE__ */ jsx35("p", { children: /* @__PURE__ */ jsx35("strong", { children: "Report could not be displayed." }) }),
+    /* @__PURE__ */ jsx35("p", { children: error.message }),
+    error.code === "SCHEMA_VERSION_MISMATCH" ? /* @__PURE__ */ jsxs22("p", { children: [
       "The report bundle is newer than this version of ",
-      /* @__PURE__ */ jsx34("code", { children: "executable-stories-react" }),
+      /* @__PURE__ */ jsx35("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__ */ jsxs21("details", { children: [
-      /* @__PURE__ */ jsxs21("summary", { children: [
+    error.issues && error.issues.length > 0 ? /* @__PURE__ */ jsxs22("details", { children: [
+      /* @__PURE__ */ jsxs22("summary", { children: [
         error.issues.length,
         " validation issue",
         error.issues.length === 1 ? "" : "s"
       ] }),
-      /* @__PURE__ */ jsx34("pre", { children: error.issues.slice(0, 20).map((i) => `${i.path}: ${i.message}`).join("\n") })
+      /* @__PURE__ */ jsx35("pre", { children: error.issues.slice(0, 20).map((i) => `${i.path}: ${i.message}`).join("\n") })
     ] }) : null
   ] });
 }
 
 // src/components/ReportShell.tsx
-import { Fragment as Fragment10, jsx as jsx35, jsxs as jsxs22 } from "react/jsx-runtime";
+import { Fragment as Fragment10, jsx as jsx36, jsxs as jsxs23 } from "react/jsx-runtime";
 function ReportTitleBlock({ title }) {
-  return /* @__PURE__ */ jsxs22(Fragment10, { children: [
-    /* @__PURE__ */ jsx35("h1", { children: title ?? "Story Report" }),
-    /* @__PURE__ */ jsx35(ReportSummary, {}),
-    /* @__PURE__ */ jsx35(ReportMeta, {})
+  return /* @__PURE__ */ jsxs23(Fragment10, { children: [
+    /* @__PURE__ */ jsx36("h1", { children: title ?? "Story Report" }),
+    /* @__PURE__ */ jsx36(ReportSummary, {}),
+    /* @__PURE__ */ jsx36(ReportMeta, {})
   ] });
 }
 function ReportErrorShell({
@@ -1757,28 +1664,28 @@ function ReportErrorShell({
   title,
   dataTheme
 }) {
-  return /* @__PURE__ */ jsx35("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: /* @__PURE__ */ jsx35(ReportSchemaError, { error }) });
+  return /* @__PURE__ */ jsx36("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: /* @__PURE__ */ jsx36(ReportSchemaError, { error }) });
 }
 
 // src/components/Report.tsx
-import { jsx as jsx36, jsxs as jsxs23 } from "react/jsx-runtime";
+import { jsx as jsx37, jsxs as jsxs24 } from "react/jsx-runtime";
 function Report(props) {
   const { report, customRenderers, renderers, className, title, dataTheme } = props;
   const result = unwrapReport(report);
   if (!result.ok) {
-    return /* @__PURE__ */ jsx36(ReportErrorShell, { error: result.error, className, title, dataTheme });
+    return /* @__PURE__ */ jsx37(ReportErrorShell, { error: result.error, className, title, dataTheme });
   }
   const data = result.data;
   const hasContent = data.features.length > 0;
-  return /* @__PURE__ */ jsx36(ReportRoot, { report: data, customRenderers, renderers, children: /* @__PURE__ */ jsxs23("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: [
-    /* @__PURE__ */ jsx36("header", { className: "es-report-header", children: /* @__PURE__ */ jsx36(ReportTitleBlock, { title }) }),
-    hasContent ? /* @__PURE__ */ jsx36(ReportFeatureList, {}) : /* @__PURE__ */ jsx36(ReportEmpty, {})
+  return /* @__PURE__ */ jsx37(ReportRoot, { report: data, customRenderers, renderers, children: /* @__PURE__ */ jsxs24("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: [
+    /* @__PURE__ */ jsx37("header", { className: "es-report-header", children: /* @__PURE__ */ jsx37(ReportTitleBlock, { title }) }),
+    hasContent ? /* @__PURE__ */ jsx37(ReportFeatureList, {}) : /* @__PURE__ */ jsx37(ReportEmpty, {})
   ] }) });
 }
 
 // src/components/doc/MermaidView.tsx
 import { useEffect, useRef, useState as useState2 } from "react";
-import { Fragment as Fragment11, jsx as jsx37, jsxs as jsxs24 } from "react/jsx-runtime";
+import { Fragment as Fragment11, jsx as jsx38, jsxs as jsxs25 } from "react/jsx-runtime";
 function prefersDark(el) {
   const themed = el?.closest("[data-theme]");
   if (themed?.dataset.theme === "dark") return true;
@@ -1832,9 +1739,9 @@ function MermaidView({ entry, load }) {
     };
   }, [entry.code, load]);
   if (svg) {
-    return /* @__PURE__ */ jsxs24("figure", { ref, className: "my-3", children: [
-      entry.title ? /* @__PURE__ */ jsx37("figcaption", { className: "mb-1.5 text-xs font-medium text-muted-foreground", children: entry.title }) : null,
-      /* @__PURE__ */ jsx37(
+    return /* @__PURE__ */ jsxs25("figure", { ref, className: "my-3", children: [
+      entry.title ? /* @__PURE__ */ jsx38("figcaption", { className: "mb-1.5 text-xs font-medium text-muted-foreground", children: entry.title }) : null,
+      /* @__PURE__ */ jsx38(
         "div",
         {
           role: "img",
@@ -1845,8 +1752,8 @@ function MermaidView({ entry, load }) {
       )
     ] });
   }
-  return /* @__PURE__ */ jsxs24(Fragment11, { children: [
-    error ? /* @__PURE__ */ jsxs24(
+  return /* @__PURE__ */ jsxs25(Fragment11, { children: [
+    error ? /* @__PURE__ */ jsxs25(
       "p",
       {
         role: "alert",
@@ -1858,19 +1765,19 @@ function MermaidView({ entry, load }) {
         ]
       }
     ) : null,
-    /* @__PURE__ */ jsx37(MermaidSource, { entry, ref })
+    /* @__PURE__ */ jsx38(MermaidSource, { entry, ref })
   ] });
 }
 
 // src/components/doc/MermaidDiagram.tsx
-import { jsx as jsx38 } from "react/jsx-runtime";
+import { jsx as jsx39 } from "react/jsx-runtime";
 var mermaidLoader;
 function loadMermaid() {
   mermaidLoader ??= import("mermaid").then((m) => m.default);
   return mermaidLoader;
 }
 function MermaidDiagram({ entry, load = loadMermaid }) {
-  return /* @__PURE__ */ jsx38(MermaidView, { entry, load });
+  return /* @__PURE__ */ jsx39(MermaidView, { entry, load });
 }
 
 // src/components/ScenarioExplorer.tsx
@@ -1880,12 +1787,12 @@ import { useState as useState3 } from "react";
 import "react";
 import { Command as CommandPrimitive } from "cmdk";
 import { SearchIcon } from "lucide-react";
-import { jsx as jsx39, jsxs as jsxs25 } from "react/jsx-runtime";
+import { jsx as jsx40, jsxs as jsxs26 } from "react/jsx-runtime";
 function Command({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive,
     {
       "data-slot": "command",
@@ -1901,14 +1808,14 @@ function CommandInput({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsxs25(
+  return /* @__PURE__ */ jsxs26(
     "div",
     {
       "data-slot": "command-input-wrapper",
       className: "flex h-9 items-center gap-2 border-b px-3",
       children: [
-        /* @__PURE__ */ jsx39(SearchIcon, { className: "size-4 shrink-0 opacity-50" }),
-        /* @__PURE__ */ jsx39(
+        /* @__PURE__ */ jsx40(SearchIcon, { className: "size-4 shrink-0 opacity-50" }),
+        /* @__PURE__ */ jsx40(
           CommandPrimitive.Input,
           {
             "data-slot": "command-input",
@@ -1927,7 +1834,7 @@ function CommandList({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.List,
     {
       "data-slot": "command-list",
@@ -1942,7 +1849,7 @@ function CommandList({
 function CommandEmpty({
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.Empty,
     {
       "data-slot": "command-empty",
@@ -1955,7 +1862,7 @@ function CommandGroup({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.Group,
     {
       "data-slot": "command-group",
@@ -1971,7 +1878,7 @@ function CommandItem({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.Item,
     {
       "data-slot": "command-item",
@@ -1985,7 +1892,7 @@ function CommandItem({
 }
 
 // src/components/ScenarioExplorer.tsx
-import { jsx as jsx40, jsxs as jsxs26 } from "react/jsx-runtime";
+import { jsx as jsx41, jsxs as jsxs27 } from "react/jsx-runtime";
 var STATUS_FILTERS = [
   { value: "all", label: "All" },
   { value: "passed", label: "Passed" },
@@ -1996,22 +1903,22 @@ var STATUS_FILTERS = [
 function ScenarioExplorer({ scenarios, summary }) {
   const [status, setStatus] = useState3("all");
   const visible = status === "all" ? scenarios : scenarios.filter((s) => s.status === status);
-  return /* @__PURE__ */ jsxs26("div", { className: "font-sans text-foreground", children: [
-    summary ? /* @__PURE__ */ jsxs26("p", { className: "mb-3 text-sm text-muted-foreground", children: [
+  return /* @__PURE__ */ jsxs27("div", { className: "font-sans text-foreground", children: [
+    summary ? /* @__PURE__ */ jsxs27("p", { className: "mb-3 text-sm text-muted-foreground", children: [
       summary.total,
       " scenarios \xB7 ",
-      /* @__PURE__ */ jsxs26("span", { className: "text-pass", children: [
+      /* @__PURE__ */ jsxs27("span", { className: "text-pass", children: [
         summary.passed,
         " passed"
       ] }),
       " \xB7",
       " ",
-      /* @__PURE__ */ jsxs26("span", { className: "text-fail", children: [
+      /* @__PURE__ */ jsxs27("span", { className: "text-fail", children: [
         summary.failed,
         " failed"
       ] })
     ] }) : null,
-    /* @__PURE__ */ jsx40("div", { className: "mb-2 flex flex-wrap gap-1.5", role: "group", "aria-label": "Filter by status", children: STATUS_FILTERS.map((f) => /* @__PURE__ */ jsx40(
+    /* @__PURE__ */ jsx41("div", { className: "mb-2 flex flex-wrap gap-1.5", role: "group", "aria-label": "Filter by status", children: STATUS_FILTERS.map((f) => /* @__PURE__ */ jsx41(
       "button",
       {
         type: "button",
@@ -2026,26 +1933,26 @@ function ScenarioExplorer({ scenarios, summary }) {
       },
       f.value
     )) }),
-    /* @__PURE__ */ jsxs26(
+    /* @__PURE__ */ jsxs27(
       Command,
       {
         className: "rounded-lg border border-border bg-card",
         filter: (value, search) => value.toLowerCase().includes(search.toLowerCase()) ? 1 : 0,
         children: [
-          /* @__PURE__ */ jsx40(CommandInput, { placeholder: "Search scenarios\u2026" }),
-          /* @__PURE__ */ jsxs26(CommandList, { className: "max-h-none", children: [
-            /* @__PURE__ */ jsx40(CommandEmpty, { children: "No scenarios match your filters." }),
-            /* @__PURE__ */ jsx40(CommandGroup, { children: visible.map((s) => /* @__PURE__ */ jsx40(
+          /* @__PURE__ */ jsx41(CommandInput, { placeholder: "Search scenarios\u2026" }),
+          /* @__PURE__ */ jsxs27(CommandList, { className: "max-h-none", children: [
+            /* @__PURE__ */ jsx41(CommandEmpty, { children: "No scenarios match your filters." }),
+            /* @__PURE__ */ jsx41(CommandGroup, { children: visible.map((s) => /* @__PURE__ */ jsx41(
               CommandItem,
               {
                 value: `${s.title} ${s.feature} ${s.tags.join(" ")}`,
                 asChild: true,
                 className: "cursor-pointer",
-                children: /* @__PURE__ */ jsxs26("a", { href: s.href, className: "flex items-center gap-3", children: [
-                  /* @__PURE__ */ jsx40(Badge, { variant: s.status, children: s.status }),
-                  /* @__PURE__ */ jsx40("span", { className: "min-w-0 flex-1 truncate font-medium", children: s.title }),
-                  s.tags.slice(0, 3).map((t) => /* @__PURE__ */ jsx40(Badge, { variant: "tag", className: "hidden sm:inline-flex", children: t }, t)),
-                  /* @__PURE__ */ jsx40("code", { className: "hidden font-mono text-xs text-muted-foreground md:inline", children: s.feature })
+                children: /* @__PURE__ */ jsxs27("a", { href: s.href, className: "flex items-center gap-3", children: [
+                  /* @__PURE__ */ jsx41(Badge, { variant: s.status, children: s.status }),
+                  /* @__PURE__ */ jsx41("span", { className: "min-w-0 flex-1 truncate font-medium", children: s.title }),
+                  s.tags.slice(0, 3).map((t) => /* @__PURE__ */ jsx41(Badge, { variant: "tag", className: "hidden sm:inline-flex", children: t }, t)),
+                  /* @__PURE__ */ jsx41("code", { className: "hidden font-mono text-xs text-muted-foreground md:inline", children: s.feature })
                 ] })
               },
               s.id
@@ -2192,7 +2099,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",
@@ -2208,6 +2115,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: [
@@ -3019,6 +2946,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
     }
   }
 };