executable-stories-react 0.10.1 → 0.11.0

package/dist/index.js

@@ -379,21 +379,29 @@ function DocLink({ entry }) {
   );
 }
 
-// src/components/doc/DocSection.tsx
+// src/lib/markdown.ts
 import { marked } from "marked";
 
 // src/lib/url.ts
 import { safeUrl, safeImageUrl, isLocalFsPath } from "executable-stories-core/utils/url";
 
-// 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) ?? "#";
-}
+// 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 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 safeUrl(value) ?? "#";
+}
+
+// src/components/doc/DocSection.tsx
+import { Fragment as Fragment2, jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
 function DocSection({ entry }) {
   const renderers = useBuiltinRenderers();
   if (renderers.section) {
@@ -1270,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`;
@@ -1279,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,
@@ -1290,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",
@@ -1301,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"
                     ] })
@@ -1334,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 })
+          ] })
         ]
       }
     )
@@ -1342,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",
@@ -1365,7 +1407,7 @@ function Empty({ className, ...props }) {
   );
 }
 function EmptyHeader({ className, ...props }) {
-  return /* @__PURE__ */ jsx30(
+  return /* @__PURE__ */ jsx31(
     "div",
     {
       "data-slot": "empty-header",
@@ -1392,7 +1434,7 @@ var emptyMediaVariants = cva2(
   }
 );
 function EmptyTitle({ className, ...props }) {
-  return /* @__PURE__ */ jsx30(
+  return /* @__PURE__ */ jsx31(
     "div",
     {
       "data-slot": "empty-title",
@@ -1403,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,
@@ -1438,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(
@@ -1451,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
@@ -1524,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 = [];
@@ -1547,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}` : ""}`
@@ -1564,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;
@@ -1572,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({
@@ -1622,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;
@@ -1697,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",
@@ -1710,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",
@@ -1723,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
@@ -1745,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",
@@ -1766,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",
@@ -1792,7 +1834,7 @@ function CommandList({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.List,
     {
       "data-slot": "command-list",
@@ -1807,7 +1849,7 @@ function CommandList({
 function CommandEmpty({
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.Empty,
     {
       "data-slot": "command-empty",
@@ -1820,7 +1862,7 @@ function CommandGroup({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.Group,
     {
       "data-slot": "command-group",
@@ -1836,7 +1878,7 @@ function CommandItem({
   className,
   ...props
 }) {
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx40(
     CommandPrimitive.Item,
     {
       "data-slot": "command-item",
@@ -1850,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" },
@@ -1861,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",
@@ -1891,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
@@ -2057,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",
@@ -2073,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: [
@@ -2884,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
     }
   }
 };