executable-stories-react 0.10.1 → 0.11.0

package/dist/index.cjs

@@ -470,21 +470,29 @@ function DocLink({ entry }) {
   );
 }
 
-// src/components/doc/DocSection.tsx
+// src/lib/markdown.ts
 var import_marked = require("marked");
 
 // src/lib/url.ts
 var import_url = require("executable-stories-core/utils/url");
 
-// src/components/doc/DocSection.tsx
-var import_jsx_runtime9 = require("react/jsx-runtime");
-function neutralizeUrl(value) {
-  return (0, import_url.safeUrl)(value) ?? "#";
-}
+// 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 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 neutralizeUrl(value) {
+  return (0, import_url.safeUrl)(value) ?? "#";
+}
+
+// src/components/doc/DocSection.tsx
+var import_jsx_runtime9 = require("react/jsx-runtime");
 function DocSection({ entry }) {
   const renderers = useBuiltinRenderers();
   if (renderers.section) {
@@ -1361,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`;
@@ -1370,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,
@@ -1381,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",
@@ -1392,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"
                     ] })
@@ -1425,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 })
+          ] })
         ]
       }
     )
@@ -1433,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",
@@ -1456,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",
@@ -1483,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",
@@ -1494,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,
@@ -1529,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(
@@ -1542,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
@@ -1615,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 = [];
@@ -1638,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}` : ""}`
@@ -1655,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;
@@ -1663,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({
@@ -1713,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;
@@ -1788,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",
@@ -1801,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",
@@ -1814,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
@@ -1836,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",
@@ -1857,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",
@@ -1883,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",
@@ -1898,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",
@@ -1911,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",
@@ -1927,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",
@@ -1941,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" },
@@ -1952,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",
@@ -1982,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
@@ -2148,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",
@@ -2164,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: [
@@ -2975,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
     }
   }
 };