executable-stories-formatters 0.14.0 → 0.15.0

package/dist/index.d.cts

@@ -364,6 +364,8 @@ interface MarkdownFormatterOptions {
     scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
     /** Render a badge line under a scenario heading (e.g. a what's-changed marker). Undefined to skip. */
     scenarioBadge?: (tc: TestCaseResult) => string | undefined;
+    /** Render a business-context link line under a scenario heading. Undefined to skip. */
+    scenarioNoteLink?: (tc: TestCaseResult) => string | undefined;
 }
 
 /** Astro/Starlight formatter options */
@@ -493,6 +495,7 @@ interface ResolvedFormatterOptions {
             customRenderers?: MarkdownRenderers;
             scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
             scenarioBadge?: (tc: TestCaseResult) => string | undefined;
+            scenarioNoteLink?: (tc: TestCaseResult) => string | undefined;
         };
     };
     assetMode: "none" | "copy";
@@ -1943,6 +1946,12 @@ interface MarkdownOptions {
      * line, or undefined to skip. Off by default — only the living-docs site opts in.
      */
     scenarioBadge?: (tc: TestCaseResult) => string | undefined;
+    /**
+     * Render a link line under a scenario heading pointing at hand-written context
+     * (the scenario's note page). Return the markdown line, or undefined to skip.
+     * Off by default — only the living-docs site opts in.
+     */
+    scenarioNoteLink?: (tc: TestCaseResult) => string | undefined;
 }
 /**
  * Markdown Formatter.

package/dist/index.d.ts

@@ -364,6 +364,8 @@ interface MarkdownFormatterOptions {
     scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
     /** Render a badge line under a scenario heading (e.g. a what's-changed marker). Undefined to skip. */
     scenarioBadge?: (tc: TestCaseResult) => string | undefined;
+    /** Render a business-context link line under a scenario heading. Undefined to skip. */
+    scenarioNoteLink?: (tc: TestCaseResult) => string | undefined;
 }
 
 /** Astro/Starlight formatter options */
@@ -493,6 +495,7 @@ interface ResolvedFormatterOptions {
             customRenderers?: MarkdownRenderers;
             scenarioAnchor?: (tc: TestCaseResult) => string | undefined;
             scenarioBadge?: (tc: TestCaseResult) => string | undefined;
+            scenarioNoteLink?: (tc: TestCaseResult) => string | undefined;
         };
     };
     assetMode: "none" | "copy";
@@ -1943,6 +1946,12 @@ interface MarkdownOptions {
      * line, or undefined to skip. Off by default — only the living-docs site opts in.
      */
     scenarioBadge?: (tc: TestCaseResult) => string | undefined;
+    /**
+     * Render a link line under a scenario heading pointing at hand-written context
+     * (the scenario's note page). Return the markdown line, or undefined to skip.
+     * Off by default — only the living-docs site opts in.
+     */
+    scenarioNoteLink?: (tc: TestCaseResult) => string | undefined;
 }
 /**
  * Markdown Formatter.

package/dist/index.js

@@ -15126,7 +15126,8 @@ var MarkdownFormatter = class {
       includeSourceLinks: options.includeSourceLinks ?? true,
       customRenderers: options.customRenderers,
       scenarioAnchor: options.scenarioAnchor,
-      scenarioBadge: options.scenarioBadge
+      scenarioBadge: options.scenarioBadge,
+      scenarioNoteLink: options.scenarioNoteLink
     };
   }
   /**
@@ -15337,6 +15338,10 @@ var MarkdownFormatter = class {
     if (badge) {
       lines.push(badge);
     }
+    const noteLink = this.options.scenarioNoteLink?.(tc);
+    if (noteLink) {
+      lines.push(noteLink);
+    }
     if (this.options.includeSourceLinks && this.options.permalinkBaseUrl && tc.sourceFile !== "unknown") {
       const permalink = this.buildPermalink(tc);
       lines.push(`Source: [${tc.sourceFile}](${permalink})`);
@@ -21879,7 +21884,8 @@ var ReportGenerator = class {
           traceUrlTemplate: options.astro?.markdown?.traceUrlTemplate,
           customRenderers: options.astro?.markdown?.customRenderers,
           scenarioAnchor: options.astro?.markdown?.scenarioAnchor,
-          scenarioBadge: options.astro?.markdown?.scenarioBadge
+          scenarioBadge: options.astro?.markdown?.scenarioBadge,
+          scenarioNoteLink: options.astro?.markdown?.scenarioNoteLink
         }
       },
       assetMode: options.assetMode ?? "none",