executable-stories-formatters 0.16.0 → 1.0.0

package/dist/index.d.ts

@@ -1,5 +1,27 @@
-import { C as CIInfo, T as TestRunResult, a as TestCaseResult, S as StoryStep, D as DocEntry, b as TestStatus$1, N as NormalizedTicket, A as Attachment, c as DocPhase, O as OtelSpan, d as StepResult, e as CIProvider, R as RawStatus, f as RawAttachment, g as RawRun, h as RawCIInfo, i as StepKeyword$1, j as adaptJestRun, k as adaptPlaywrightRun, l as adaptVitestRun } from './index-CXrzCk9p.js';
-export { m as CIInfo, n as CoverageSummary, J as JestAdapterOptions, o as JestAggregatedResult, p as JestFileResult, q as JestTestResult, r as OtelAttributeValue, P as PlaywrightAdapterOptions, s as PlaywrightAnnotation, t as PlaywrightAttachment, u as PlaywrightError, v as PlaywrightLocation, w as PlaywrightStatus, x as PlaywrightTestCase, y as PlaywrightTestResult, z as RawStepEvent, B as RawTestCase, E as STORY_META_KEY, F as StepMode, G as StoryFileReport, H as StoryMeta, I as TestCaseAttempt, K as TestCaseEvidence, V as VitestAdapterOptions, L as VitestSerializedError, M as VitestState, Q as VitestTestCase, U as VitestTestModule, W as VitestTestResult, X as toCIInfo, Y as toRawCIInfo } from './index-CXrzCk9p.js';
+import { TestRunResult, TestCaseResult, TestStatus, Attachment } from 'executable-stories-core/types/test-result';
+export { Attachment, CIInfo, CoverageSummary, StepResult, TestCaseAttempt, TestCaseEvidence, TestCaseResult, TestRunResult, TestStatus } from 'executable-stories-core/types/test-result';
+import { StoryStep, DocEntry, NormalizedTicket, StepKeyword } from 'executable-stories-core/types/story';
+export { DocEntry, DocPhase, NormalizedTicket, STORY_META_KEY, StepKeyword, StepMode, StoryMeta, StoryStep } from 'executable-stories-core/types/story';
+import { CIInfo, CIProvider } from 'executable-stories-core/types/ci';
+export { CIProvider, CIInfo as TypedCIInfo, toCIInfo, toRawCIInfo } from 'executable-stories-core/types/ci';
+import { adaptJestRun, adaptPlaywrightRun, adaptVitestRun } from './adapters.js';
+export { JestAdapterOptions, JestAggregatedResult, JestFileResult, JestTestResult, PlaywrightAdapterOptions, PlaywrightAnnotation, PlaywrightAttachment, PlaywrightError, PlaywrightLocation, PlaywrightStatus, PlaywrightTestCase, PlaywrightTestResult, StoryFileReport, VitestAdapterOptions, VitestSerializedError, VitestState, VitestTestCase, VitestTestModule, VitestTestResult } from './adapters.js';
+export { OtelAttributeValue, OtelSpan } from 'executable-stories-core/types/otel';
+import { RawCIInfo } from 'executable-stories-core/types/raw';
+export { RawAttachment, RawCIInfo, RawRun, RawStatus, RawStepEvent, RawTestCase } from 'executable-stories-core/types/raw';
+import { StoryReport, TestStatus as TestStatus$1, ReportStep } from 'executable-stories-core/types/story-report';
+export { ReportAttachment, ReportCIInfo, ReportCoverageSummary, ReportDocCode, ReportDocCustom, ReportDocEntry, ReportDocKv, ReportDocLink, ReportDocMermaid, ReportDocNote, ReportDocScreenshot, ReportDocSection, ReportDocTable, ReportDocTag, ReportFeature, ReportScenario, ReportStep, ReportSummary, ReportTicket, STORY_REPORT_SCHEMA_MAJOR, STORY_REPORT_SCHEMA_VERSION, StoryReport, StoryReportSchemaVersion } from 'executable-stories-core/types/story-report';
+export { ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES } from 'executable-stories-core/theme/tokens';
+export { canonicalizeRun, deriveStepResults, generateRunId, generateTestCaseId, mergeStepResults, normalizeStatus, resolveAttachment, resolveAttachments, slugify } from 'executable-stories-core/converters/acl/index';
+export { ValidationResult, assertValidRun, validateCanonicalRun } from 'executable-stories-core/converters/acl/validate';
+export { RunState, advanceState, initialRunState } from 'executable-stories-core';
+export { toStoryReport } from 'executable-stories-core/converters/story-report';
+import { Envelope } from 'executable-stories-core/types/cucumber-messages';
+export { parseEnvelopes, parseNdjson } from 'executable-stories-core/converters/ndjson-parser';
+export { formatDuration, msToNanoseconds, nanosecondsToMs } from 'executable-stories-core/utils/duration';
+export { HtmlDocOptions, buildHtmlDocEntry } from 'executable-stories-core/utils/doc-builders';
+import { CanonicalizeOptions } from 'executable-stories-core/types/canonicalize';
+export { CanonicalizeOptions } from 'executable-stories-core/types/canonicalize';
 
 /**
  * Notification types for webhook integrations (Slack, Teams).
@@ -125,32 +147,16 @@ declare class ConfluenceFormatter {
 /**
  * Configuration options for ACL and formatters.
  */
-/** Options for canonicalizing raw run data */
-interface CanonicalizeOptions {
-    /** Attachment handling options */
-    attachments?: {
-        /** Max bytes before attachment becomes external link. Default: 512KB (524288) */
-        maxEmbedBytes?: number;
-        /** Directory for external attachments */
-        externalDir?: string;
-    };
-    /** Cucumber compatibility options */
-    cucumber?: {
-        /** Include trailing space in keywords (e.g., "Given "). Default: true */
-        keywordSpacing?: boolean;
-        /** Generate deterministic line numbers. Default: true */
-        deterministicLines?: boolean;
-    };
-    /** Default timestamps if not provided in raw data */
-    defaults?: {
-        /** Default start time (epoch ms). Default: Date.now() */
-        startedAtMs?: number;
-        /** Default finish time (epoch ms). Default: Date.now() */
-        finishedAtMs?: number;
-    };
-}
+
 /** Output format for report generation */
-type OutputFormat = "astro" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "release-manifest" | "scenario-index-json" | "story-report-json" | "traceability-matrix";
+type OutputFormat = "astro-markdown" | "behavior-manifest-json" | "confluence" | "cucumber-json" | "cucumber-messages" | "cucumber-html" | "html" | "junit" | "markdown" | "release-manifest" | "scenario-index-json" | "story-report-json" | "traceability-matrix";
+/**
+ * Format names accepted as INPUT. Adds `"astro"` as a deprecated alias for
+ * `"astro-markdown"` — it is normalised (with a warning) wherever formats enter
+ * the pipeline, so existing programmatic/config callers keep working.
+ * @deprecated `"astro"` — use `"astro-markdown"`.
+ */
+type FormatInput = OutputFormat | "astro";
 /** Sort order for test cases in reports (deterministic for diff-friendly output) */
 type SortTestCasesMode = "id" | "source" | "none";
 /** Output mode for report routing */
@@ -176,7 +182,7 @@ interface OutputRule {
     /** Output filename override (without extension) */
     outputName?: string;
     /** Formats to generate for matched files */
-    formats?: OutputFormat[];
+    formats?: FormatInput[];
 }
 /** Output configuration for report routing */
 interface OutputConfig {
@@ -206,7 +212,7 @@ interface FormatterOptions {
     /** Tags to exclude test cases (any match). Applied after includeTags. */
     excludeTags?: string[];
     /** Output formats to generate. Default: ["html"] */
-    formats?: OutputFormat[];
+    formats?: FormatInput[];
     /** Output directory for generated reports. Default: "reports" */
     outputDir?: string;
     /** Base filename (without extension). Default: "index" */
@@ -237,36 +243,19 @@ interface FormatterOptions {
         /** Pretty-print JSON output. Default: true */
         pretty?: boolean;
     };
-    /** HTML specific options */
+    /**
+     * HTML specific options. The HTML report renders via executable-stories-react;
+     * only these CDN toggles and the title affect it. The string renderer's
+     * darkMode, searchable, startCollapsed, embed, toc, and markdown options were
+     * removed with it — the React report owns that behavior.
+     */
     html?: {
         /** Report title. Default: "Test Results" */
         title?: string;
-        /** Include dark mode toggle. Default: true */
-        darkMode?: boolean;
-        /** Include search/filter functionality. Default: true */
-        searchable?: boolean;
-        /** Start with scenarios collapsed. Default: false */
-        startCollapsed?: boolean;
-        /** Embed screenshots inline (base64). Default: true */
-        embedScreenshots?: boolean;
-        /** Inline local html doc files as iframe srcdoc. Default: true ("none" asset mode), false under "copy". */
-        embedHtmlFiles?: boolean;
         /** Enable syntax highlighting for code blocks (via highlight.js CDN). Default: true */
         syntaxHighlighting?: boolean;
         /** Enable live Mermaid diagram rendering (via Mermaid.js CDN). Default: true */
         mermaidEnabled?: boolean;
-        /** Enable Markdown parsing for section doc entries (via marked.js CDN). Default: true */
-        markdownEnabled?: boolean;
-        /** Base URL for source permalinks. E.g., "https://github.com/user/repo/blob/main" */
-        permalinkBaseUrl?: string;
-        /** URL template for ticket links. Use {ticket} as placeholder. E.g., "https://jira.example.com/browse/{ticket}" */
-        ticketUrlTemplate?: string;
-        /** Theme name. Default: "default". Available: default, corporate, terminal, minimal, dashboard, playful */
-        theme?: string;
-        /** Show table of contents sidebar. Default: true */
-        tocEnabled?: boolean;
-        /** Include theme picker with all CSS-only themes embedded. Default: false */
-        themePickerEnabled?: boolean;
     };
     /** JUnit XML specific options */
     junit?: {
@@ -428,19 +417,8 @@ interface ResolvedFormatterOptions {
     };
     html: {
         title: string;
-        darkMode: boolean;
-        searchable: boolean;
-        startCollapsed: boolean;
-        embedScreenshots: boolean;
-        embedHtmlFiles: boolean;
         syntaxHighlighting: boolean;
         mermaidEnabled: boolean;
-        markdownEnabled: boolean;
-        permalinkBaseUrl?: string;
-        ticketUrlTemplate?: string;
-        theme: string;
-        tocEnabled: boolean;
-        themePickerEnabled: boolean;
     };
     junit: {
         suiteName: string;
@@ -520,7 +498,7 @@ interface ScenarioSnapshot {
     scenario: string;
     sourceFile: string;
     sourceLine: number;
-    status: TestStatus$1;
+    status: TestStatus;
     durationMs: number;
     tags: string[];
     titlePath: string[];
@@ -687,199 +665,6 @@ interface ExecutableStoriesConfig {
     formatters?: Record<string, Formatter>;
 }
 
-/**
- * StoryReport — public, frozen contract for UI renderers.
- *
- * Distinct from internal TestRunResult. Pre-grouped feature → scenario tree,
- * with pre-computed summaries at every level. Adapter concerns (rawStatus,
- * projectName, titlePath) are stripped at the toStoryReport boundary.
- *
- * Versioning: semver-style "<major>.<minor>". Additive-only within a major.
- * Source of truth: schemas/story-report-v1.json. Types here must stay in sync.
- */
-
-type StoryReportSchemaVersion = `1.${number}`;
-type TestStatus = "passed" | "failed" | "skipped" | "pending";
-type StepKeyword = "Given" | "When" | "Then" | "And" | "But";
-type StepMode = "normal" | "skip" | "only" | "todo" | "fails" | "concurrent";
-interface ReportSummary {
-    total: number;
-    passed: number;
-    failed: number;
-    skipped: number;
-    pending: number;
-    durationMs: number;
-}
-interface ReportTicket {
-    id: string;
-    url?: string;
-}
-interface ReportAttachment {
-    name: string;
-    mediaType: string;
-    body: string;
-    contentEncoding: "BASE64" | "IDENTITY";
-}
-interface ReportCIInfo {
-    name: string;
-    url?: string;
-    buildNumber?: string;
-    branch?: string;
-    commitSha?: string;
-    prNumber?: string;
-}
-interface ReportCoverageSummary {
-    linesPct?: number;
-    branchesPct?: number;
-    functionsPct?: number;
-    statementsPct?: number;
-}
-type ReportDocEntry = ReportDocNote | ReportDocTag | ReportDocKv | ReportDocCode | ReportDocTable | ReportDocLink | ReportDocSection | ReportDocMermaid | ReportDocScreenshot | ReportDocVideo | ReportDocHtml | ReportDocCustom;
-interface ReportDocNote {
-    kind: "note";
-    text: string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocTag {
-    kind: "tag";
-    names: string[];
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocKv {
-    kind: "kv";
-    label: string;
-    value: unknown;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocCode {
-    kind: "code";
-    label: string;
-    content: string;
-    lang?: string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocTable {
-    kind: "table";
-    label: string;
-    columns: string[];
-    rows: string[][];
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocLink {
-    kind: "link";
-    label: string;
-    url: string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocSection {
-    kind: "section";
-    title: string;
-    markdown: string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocMermaid {
-    kind: "mermaid";
-    code: string;
-    title?: string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocScreenshot {
-    kind: "screenshot";
-    path: string;
-    alt?: string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocVideo {
-    kind: "video";
-    path: string;
-    caption?: string;
-    poster?: string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocHtml {
-    kind: "html";
-    /** Local HTML file path (exactly one of path/url/content) */
-    path?: string;
-    /** Remote URL rendered via iframe src (exactly one of path/url/content) */
-    url?: string;
-    /** Inline HTML content rendered via iframe srcdoc (exactly one of path/url/content) */
-    content?: string;
-    title?: string;
-    /** Iframe height: number → px, string passed through (e.g. "60vh"). Default 400px. */
-    height?: number | string;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportDocCustom {
-    kind: "custom";
-    type: string;
-    data: unknown;
-    phase: DocPhase;
-    children?: ReportDocEntry[];
-}
-interface ReportStep {
-    id: string;
-    index: number;
-    keyword: StepKeyword;
-    text: string;
-    status: TestStatus;
-    durationMs: number;
-    errorMessage?: string;
-    mode?: StepMode;
-    docEntries: ReportDocEntry[];
-}
-interface ReportScenario {
-    id: string;
-    title: string;
-    status: TestStatus;
-    durationMs: number;
-    tags: string[];
-    tickets?: ReportTicket[];
-    /** Product-code paths/globs this scenario exercises (project-root-relative). */
-    covers?: string[];
-    sourceLine?: number;
-    errorMessage?: string;
-    errorStack?: string;
-    retry: number;
-    retries: number;
-    docEntries: ReportDocEntry[];
-    steps: ReportStep[];
-    attachments: ReportAttachment[];
-}
-interface ReportFeature {
-    id: string;
-    title: string;
-    sourceFile: string;
-    summary: ReportSummary;
-    scenarios: ReportScenario[];
-}
-interface StoryReport {
-    schemaVersion: StoryReportSchemaVersion;
-    runId: string;
-    startedAtMs: number;
-    finishedAtMs: number;
-    durationMs: number;
-    projectRoot: string;
-    packageVersion?: string;
-    gitSha?: string;
-    ci?: ReportCIInfo;
-    coverage?: ReportCoverageSummary;
-    summary: ReportSummary;
-    features: ReportFeature[];
-}
-declare const STORY_REPORT_SCHEMA_VERSION: StoryReportSchemaVersion;
-declare const STORY_REPORT_SCHEMA_MAJOR: 1;
-
 /**
  * Review types — the model behind the Evidence-Driven Review report.
  *
@@ -941,7 +726,7 @@ interface ReviewClaim {
     sourceFile: string;
     sourceLine: number;
     /** Test outcome. */
-    status: TestStatus$1;
+    status: TestStatus;
     /** Derived from file convention / `audience:` tag. */
     audience: ReviewAudience;
     /** Declared via `change:*` tag (defaults to `unknown`). */
@@ -992,497 +777,6 @@ interface ReviewResult {
     changedFiles: ChangedFileReview[];
 }
 
-/**
- * Render an OTel trace waterfall (fn(args, deps)).
- */
-
-interface RenderTraceViewArgs {
-    spans: OtelSpan[] | undefined;
-}
-interface RenderTraceViewDeps {
-    escapeHtml: (str: string) => string;
-}
-
-/**
- * Render attachments section (fn(args, deps)).
- */
-
-interface RenderAttachmentsArgs {
-    attachments: Attachment[];
-}
-interface RenderAttachmentsDeps {
-    escapeHtml: (str: string) => string;
-    embedScreenshots: boolean;
-}
-
-/**
- * Render error box (fn(args, deps)).
- */
-interface RenderErrorBoxArgs {
-    message: string;
-    stack?: string;
-}
-interface RenderErrorBoxDeps {
-    escapeHtml: (str: string) => string;
-}
-
-interface RenderStepsArgs {
-    steps: StoryStep[];
-    stepResults: StepResult[];
-}
-interface RenderStepsDeps {
-    escapeHtml: (str: string) => string;
-    getStatusIcon: (status: TestStatus$1) => string;
-    renderDocs: (docs: DocEntry[] | undefined, containerClass: string) => string;
-    highlightStepParams?: (text: string) => string;
-}
-
-/**
- * Types for history tracking and test metrics.
- */
-
-interface HistoryEntry {
-    runId: string;
-    timestamp: number;
-    status: "passed" | "failed" | "skipped" | "pending";
-    durationMs: number;
-    ci?: {
-        provider?: CIProvider;
-        branch?: string;
-        commitSha?: string;
-    };
-}
-interface TestHistory {
-    testId: string;
-    testName: string;
-    sourceFile: string;
-    sourceLine?: number;
-    entries: HistoryEntry[];
-}
-interface HistoryStore {
-    version: 1;
-    maxRuns: number;
-    tests: Record<string, TestHistory>;
-    lastUpdated: number;
-}
-type StabilityGrade = "A" | "B" | "C" | "D" | "F";
-type FlakinessLevel = "stable" | "unstable" | "flaky";
-type PerformanceTrend = "improving" | "stable" | "regressing";
-interface TestMetrics {
-    testId: string;
-    flakinessLevel: FlakinessLevel;
-    flakinessScore: number;
-    failureRate: number;
-    stabilityGrade: StabilityGrade;
-    performanceTrend: PerformanceTrend;
-    avgDurationMs: number;
-    passRate: number;
-    longestPassStreak: number;
-    consecutiveFailures: number;
-    sampleSize: number;
-}
-
-interface RenderScenarioArgs {
-    tc: TestCaseResult;
-    metrics?: TestMetrics;
-}
-interface RenderScenarioDeps {
-    escapeHtml: (str: string) => string;
-    getStatusIcon: (status: TestStatus$1) => string;
-    startCollapsed: boolean;
-    renderSteps: (args: RenderStepsArgs, deps: RenderStepsDeps) => string;
-    renderDocs: (docs: DocEntry[] | undefined, containerClass: string) => string;
-    renderErrorBox: (args: RenderErrorBoxArgs, deps: RenderErrorBoxDeps) => string;
-    renderAttachments: (args: RenderAttachmentsArgs, deps: RenderAttachmentsDeps) => string;
-    renderTraceView: (args: RenderTraceViewArgs, deps: RenderTraceViewDeps) => string;
-    embedScreenshots: boolean;
-    permalinkBaseUrl?: string;
-    ticketUrlTemplate?: string;
-}
-
-interface RenderFeatureArgs {
-    file: string;
-    testCases: TestCaseResult[];
-    metricsMap?: Map<string, TestMetrics>;
-}
-interface RenderFeatureDeps {
-    escapeHtml: (str: string) => string;
-    startCollapsed: boolean;
-    renderScenario: (args: RenderScenarioArgs, deps: RenderScenarioDeps) => string;
-    scenarioDeps: RenderScenarioDeps;
-}
-
-/**
- * Render summary cards section (fn(args, deps)).
- * No deps: pure counts to HTML.
- */
-interface RenderSummaryArgs {
-    total: number;
-    passed: number;
-    failed: number;
-    skipped: number;
-}
-interface RenderSummaryDeps {
-}
-
-/**
- * Render meta info section (fn(args, deps)).
- */
-interface RenderMetaInfoArgs {
-    startedAtMs: number;
-    durationMs: number;
-    packageVersion?: string;
-    gitSha?: string;
-    ciName?: string;
-    ciBranch?: string;
-    ciUrl?: string;
-    ciCommitSha?: string;
-    ciBuildNumber?: string;
-}
-interface RenderMetaInfoDeps {
-    escapeHtml: (str: string) => string;
-}
-
-/**
- * Render tag filter bar (fn(args, deps)).
- * Displays a collapsible tag bar with clickable tag pills for filtering scenarios,
- * ARIA attributes for accessibility, and a results counter.
- */
-interface RenderTagBarArgs {
-    tags: string[];
-    totalScenarios: number;
-}
-interface RenderTagBarDeps {
-    escapeHtml: (str: string) => string;
-}
-
-/**
- * Render failure summary block with deep links to failed scenarios (fn(args, deps)).
- */
-
-interface RenderFailureSummaryArgs {
-    failedCases: TestCaseResult[];
-}
-interface RenderFailureSummaryDeps {
-    escapeHtml: (str: string) => string;
-}
-
-interface BuildBodyArgs {
-    run: TestRunResult;
-    metricsMap?: Map<string, TestMetrics>;
-}
-interface BuildBodyDeps {
-    renderMetaInfo: (args: RenderMetaInfoArgs, deps: RenderMetaInfoDeps) => string;
-    renderSummary: (args: RenderSummaryArgs, deps: RenderSummaryDeps) => string;
-    renderTagBar: (args: RenderTagBarArgs, deps: RenderTagBarDeps) => string;
-    renderFeature: (args: RenderFeatureArgs, deps: RenderFeatureDeps) => string;
-    renderFailureSummary: (args: RenderFailureSummaryArgs, deps: RenderFailureSummaryDeps) => string;
-    metaDeps: RenderMetaInfoDeps;
-    summaryDeps: RenderSummaryDeps;
-    tagBarDeps: RenderTagBarDeps;
-    featureDeps: RenderFeatureDeps;
-    failureSummaryDeps: RenderFailureSummaryDeps;
-}
-
-/**
- * HTML Report Template.
- *
- * Assembles the report document and inlines the browser-side interactivity
- * scripts (defined in ./template-scripts) into a <script> tag.
- */
-/** Options for HTML template generation */
-interface HtmlTemplateOptions {
-    includeSearch?: boolean;
-    includeDarkMode?: boolean;
-    syntaxHighlighting?: boolean;
-    mermaidEnabled?: boolean;
-    markdownEnabled?: boolean;
-    /** Additional inline JS injected after core JS (used by themes). */
-    additionalJs?: string;
-    /** Additional ESM import statements for CDN libraries (used by themes). */
-    additionalImports?: string[];
-    /** Pre-rendered TOC sidebar HTML. Placed as sibling of .container inside .report-layout. */
-    tocHtml?: string;
-    /** Pre-rendered theme picker HTML (select element). */
-    themePickerHtml?: string;
-    /** Additional theme CSS blocks to embed (for theme picker). */
-    additionalThemeCss?: Array<{
-        name: string;
-        label: string;
-        css: string;
-    }>;
-    /** Name of the currently active theme (for data-theme-name attribute). */
-    activeThemeName?: string;
-}
-
-/**
- * HTML theme type definitions.
- */
-
-/** Built-in theme names */
-type HtmlThemeName = "default" | "corporate" | "terminal" | "minimal" | "dashboard" | "playful";
-/** A theme definition */
-interface HtmlTheme {
-    /** Theme identifier */
-    name: string;
-    /** Display label */
-    label: string;
-    /** Full CSS string (replaces CSS_STYLES). Must define all custom properties for both light and dark modes. */
-    css: string;
-    /** Optional: override body rendering. Receives the same (args, deps) as buildBody. */
-    buildBody?: (args: BuildBodyArgs, deps: BuildBodyDeps) => string;
-    /** Optional: override the HTML template wrapper. */
-    generateTemplate?: (title: string, styles: string, body: string, options: HtmlTemplateOptions) => string;
-    /** Optional: additional inline JS injected after core JS. */
-    additionalJs?: string;
-    /** Optional: additional ESM import statements for CDN libraries. */
-    additionalImports?: string[];
-}
-
-/**
- * Theme registry — resolves theme names to theme objects.
- */
-
-/** Resolve a theme by name or pass through a custom theme object. */
-declare function resolveTheme(nameOrTheme: string | HtmlTheme): HtmlTheme;
-/** List available built-in theme names. */
-declare function getAvailableThemes(): string[];
-/** Get all themes that only use CSS (no custom body/template overrides). */
-declare function getCssOnlyThemes(): HtmlTheme[];
-
-/**
- * Canonical executable-stories theme tokens (--es-*).
- *
- * Source of truth for the `--es-color-*`, `--es-space-*`, `--es-font-*`,
- * `--es-size-*`, `--es-radius`, `--es-line`, and `--es-measure` CSS custom
- * properties consumed by:
- *
- * - executable-stories-react (styles.css)
- * - executable-stories-formatters HTML report (CSS_STYLES, via this module)
- *
- * Consumer-side overrides on `:root` or any ancestor of the report cascade
- * through both: setting `--es-color-failed: red` on body re-colors failures
- * in both the standalone HTML report and the React component.
- *
- * The HTML formatter's pre-existing tokens (--success, --error, etc.)
- * remain in place for backward compatibility; the --es-* tokens are emitted
- * alongside them as the public override surface.
- */
-declare const ES_THEME_TOKENS_CSS: string;
-/**
- * JS-level mirror of the token values (for cases where TypeScript code needs
- * to read them — e.g., dynamic style injection or theme generators).
- */
-declare const ES_THEME_TOKEN_VALUES: {
-    readonly light: {
-        readonly "--es-color-bg": "#ffffff";
-        readonly "--es-color-fg": "#111827";
-        readonly "--es-color-muted": "#6b7280";
-        readonly "--es-color-border": "#e5e7eb";
-        readonly "--es-color-surface": "#f9fafb";
-        readonly "--es-color-link": "#2563eb";
-        readonly "--es-color-passed": "#16a34a";
-        readonly "--es-color-failed": "#dc2626";
-        readonly "--es-color-skipped": "#9ca3af";
-        readonly "--es-color-pending": "#d97706";
-    };
-    readonly dark: {
-        readonly "--es-color-bg": "#0b0f17";
-        readonly "--es-color-fg": "#e5e7eb";
-        readonly "--es-color-muted": "#9ca3af";
-        readonly "--es-color-border": "#1f2937";
-        readonly "--es-color-surface": "#111827";
-        readonly "--es-color-link": "#60a5fa";
-        readonly "--es-color-passed": "#4ade80";
-        readonly "--es-color-failed": "#f87171";
-        readonly "--es-color-skipped": "#6b7280";
-        readonly "--es-color-pending": "#fbbf24";
-    };
-};
-
-/**
- * Status mapping from raw framework statuses to canonical TestStatus.
- */
-
-/**
- * Convert a raw status to canonical TestStatus.
- *
- * @param raw - The raw status from a framework
- * @returns The canonical TestStatus
- */
-declare function normalizeStatus(raw: RawStatus): TestStatus$1;
-
-/**
- * ID generation and slug helpers for deterministic, Cucumber-compatible IDs.
- */
-/**
- * Generate a deterministic test case ID from source file and scenario name.
- *
- * @param sourceFile - The source file path
- * @param scenario - The scenario name
- * @returns A 12-character hex ID
- */
-declare function generateTestCaseId(sourceFile: string, scenario: string): string;
-/**
- * Generate a deterministic run ID from timestamp and project root.
- *
- * @param startedAtMs - Run start timestamp
- * @param projectRoot - Project root directory
- * @returns A 16-character hex ID
- */
-declare function generateRunId(startedAtMs: number, projectRoot: string): string;
-/**
- * Slugify a string for Cucumber JSON IDs.
- *
- * Converts to lowercase, replaces path separators/spaces with hyphens,
- * removes other special chars, and trims leading/trailing hyphens.
- *
- * @param text - The text to slugify
- * @returns A URL-safe slug
- */
-declare function slugify(text: string): string;
-
-/**
- * Step fallback rules for deriving step results from scenario status.
- *
- * When frameworks don't provide step-level results, we derive them
- * from the overall scenario status using these rules.
- */
-
-/**
- * Derive step results from story steps and scenario status.
- *
- * Rules:
- * - Passed: All steps are passed
- * - Skipped/Pending: All steps are skipped/pending
- * - Failed: Steps up to failure are passed, failing step is failed, rest are skipped
- *   (Heuristic: last step is the failure, or use error info if available)
- *
- * @param steps - Story steps with keywords and text
- * @param scenarioStatus - Overall scenario status
- * @param error - Optional error information to help identify failing step
- * @returns Array of step results
- */
-declare function deriveStepResults(steps: StoryStep[], scenarioStatus: TestStatus$1, error?: {
-    message?: string;
-    stack?: string;
-}): StepResult[];
-/**
- * Merge raw step events with derived step results.
- *
- * When we have partial step data from the framework, merge it with
- * the derived results, preferring actual data over derived.
- *
- * @param derived - Derived step results from fallback rules
- * @param events - Raw step events from framework (if any)
- * @returns Merged step results
- */
-declare function mergeStepResults(derived: StepResult[], events?: Array<{
-    index?: number;
-    stepId?: string;
-    status?: string;
-    durationMs?: number;
-    errorMessage?: string;
-}>): StepResult[];
-
-/**
- * Attachment resolution: embed vs link decision.
- *
- * Attachments can either be embedded inline (base64) or linked to
- * external files based on size thresholds.
- */
-
-/** Options for attachment resolution */
-interface AttachmentOptions {
-    /** Max bytes before attachment becomes external link. Default: 512KB */
-    maxEmbedBytes?: number;
-    /** Directory for external attachments */
-    externalDir?: string;
-    /** Project root for relative paths */
-    projectRoot?: string;
-}
-/**
- * Resolve a raw attachment to a canonical attachment.
- *
- * Decision logic:
- * 1. If body is already provided, use it (check size for encoding decision)
- * 2. If path is provided, read file and decide embed vs link
- * 3. For large files, return a URL reference instead of embedding
- *
- * @param raw - Raw attachment from framework
- * @param options - Resolution options
- * @returns Resolved canonical attachment
- */
-declare function resolveAttachment(raw: RawAttachment, options?: AttachmentOptions): Attachment;
-/**
- * Resolve multiple attachments.
- *
- * @param attachments - Raw attachments array
- * @param options - Resolution options
- * @returns Resolved canonical attachments
- */
-declare function resolveAttachments(attachments: RawAttachment[] | undefined, options?: AttachmentOptions): Attachment[];
-
-/**
- * Anti-Corruption Layer (ACL) - Layer 2.
- *
- * Transforms permissive RawRun data from framework adapters into
- * strict canonical TestRunResult for formatters.
- */
-
-/**
- * Canonicalize a raw run into a strict TestRunResult.
- *
- * This is the main entry point for the ACL. It:
- * - Enforces required fields with defaults
- * - Normalizes statuses to TestStatus enum
- * - Applies step fallback rules
- * - Resolves attachments (embed vs link)
- * - Generates deterministic IDs
- *
- * @param raw - Raw run data from a framework adapter
- * @param options - Canonicalization options
- * @returns Strict canonical TestRunResult
- */
-declare function canonicalizeRun(raw: RawRun, options?: CanonicalizeOptions): TestRunResult;
-
-/**
- * Validation helpers for canonical TestRunResult.
- *
- * Used in tests to verify ACL output meets all invariants.
- */
-
-/** Validation result */
-interface ValidationResult {
-    /** Whether the run is valid */
-    valid: boolean;
-    /** List of validation errors */
-    errors: string[];
-}
-/**
- * Validate a canonical TestRunResult.
- *
- * Checks:
- * - All required fields are present
- * - stepResults length matches story.steps length
- * - stepResults indexes are valid and unique
- * - Durations are non-negative
- * - Timestamps are valid
- *
- * @param run - The TestRunResult to validate
- * @returns Validation result with errors if any
- */
-declare function validateCanonicalRun(run: TestRunResult): ValidationResult;
-/**
- * Assert that a run is valid, throwing if not.
- *
- * Useful in tests.
- *
- * @param run - The TestRunResult to validate
- * @throws Error if validation fails
- */
-declare function assertValidRun(run: TestRunResult): void;
-
 /**
  * Cucumber JSON Formatter - Layer 3.
  *
@@ -1602,7 +896,7 @@ interface ScenarioIndex {
 interface ScenarioIndexItem {
     id: string;
     title: string;
-    status: TestStatus;
+    status: TestStatus$1;
     feature: string;
     sourceFile: string;
     sourceLine?: number;
@@ -1625,13 +919,13 @@ interface ScenarioIndexStep {
     index: number;
     keyword: ReportStep["keyword"];
     text: string;
-    status: TestStatus;
+    status: TestStatus$1;
     durationMs: number;
     errorMessage?: string;
     docKinds: string[];
 }
 interface ScenarioIndexFilters {
-    statuses?: TestStatus[];
+    statuses?: TestStatus$1[];
     tags?: string[];
     sourceFiles?: string[];
 }
@@ -1713,11 +1007,17 @@ interface RegenerateDeps {
     readFile?: (filePath: string) => string;
 }
 /**
- * Read a raw-run (or canonical) file and regenerate the requested agent
- * artifacts via the canonical {@link ReportGenerator}. Returns the written
- * file paths. This is the unit of work the watcher repeats; it is also useful
- * standalone for a one-shot regenerate.
+ * Read a raw-run (or canonical) file once, canonicalize it, and regenerate the
+ * requested agent artifacts via the canonical {@link ReportGenerator}. Returns
+ * both the written file paths and the canonical run, so a caller that also needs
+ * the run (e.g. `serve`, to diff it) does not read and canonicalize a second
+ * time. This is the unit of work the watcher repeats.
  */
+declare function regenerateRun(options: WatchOptions, deps?: RegenerateDeps): Promise<{
+    files: string[];
+    run: TestRunResult;
+}>;
+/** Regenerate artifacts and return just the written file paths. */
 declare function regenerateArtifacts(options: WatchOptions, deps?: RegenerateDeps): Promise<string[]>;
 interface WatchDeps extends RegenerateDeps {
     /** Watch a path, calling the listener on every change. Injectable for tests. */
@@ -1744,8 +1044,8 @@ interface BehaviorDiffEntry {
     title: string;
     sourceFile: string;
     kind: ScenarioChangeKind;
-    baselineStatus?: TestStatus;
-    currentStatus?: TestStatus;
+    baselineStatus?: TestStatus$1;
+    currentStatus?: TestStatus$1;
 }
 interface BehaviorDiff {
     schemaVersion: "1.0";
@@ -1763,7 +1063,7 @@ interface BehaviorDiff {
  * Classify a single scenario's status transition between two runs.
  * Shares the `ScenarioChangeKind` vocabulary with the full compare engine.
  */
-declare function classifyStatusChange(baseline: TestStatus | undefined, current: TestStatus | undefined): ScenarioChangeKind;
+declare function classifyStatusChange(baseline: TestStatus$1 | undefined, current: TestStatus$1 | undefined): ScenarioChangeKind;
 /**
  * Scenario-level diff of two StoryReports, keyed by scenario id. Reports status
  * transitions (the agent triage signal), not the full field-by-field diff that
@@ -1771,83 +1071,6 @@ declare function classifyStatusChange(baseline: TestStatus | undefined, current:
  */
 declare function diffStoryReports(baseline: StoryReport, current: StoryReport): BehaviorDiff;
 
-/**
- * toStoryReport — convert a canonical TestRunResult into the public
- * StoryReport shape consumed by UI renderers.
- *
- * - Groups by sourceFile (relative to projectRoot when possible).
- * - Derives feature title from titlePath[0] when available, otherwise file basename.
- * - Strips adapter-only fields (rawStatus, projectName, raw titlePath).
- * - Pre-computes summary counts at every level.
- * - Generates stable IDs suitable for deep linking.
- */
-
-/**
- * Convert a canonical TestRunResult into a frozen-shape StoryReport for UI renderers.
- */
-declare function toStoryReport(run: TestRunResult): StoryReport;
-
-/**
- * HTML Formatter - Layer 3.
- *
- * Transforms canonical TestRunResult into a standalone HTML report.
- * Implemented via createHtmlFormatter (fn(args, deps) pattern).
- */
-
-/** Options for HTML formatting */
-interface HtmlOptions {
-    /** Report title. Default: "Test Results" */
-    title?: string;
-    /** Include dark mode toggle. Default: true */
-    darkMode?: boolean;
-    /** Include search/filter functionality. Default: true */
-    searchable?: boolean;
-    /** Start scenarios collapsed. Default: false */
-    startCollapsed?: boolean;
-    /** Embed screenshots inline (base64). Default: true */
-    embedScreenshots?: boolean;
-    /** Inline local html doc files as iframe srcdoc (self-contained report). Default: true */
-    embedHtmlFiles?: boolean;
-    /** Enable syntax highlighting for code blocks (via highlight.js CDN). Default: true */
-    syntaxHighlighting?: boolean;
-    /** Enable live Mermaid diagram rendering (via Mermaid.js CDN). Default: true */
-    mermaidEnabled?: boolean;
-    /** Enable Markdown parsing for section doc entries (via marked.js CDN). Default: true */
-    markdownEnabled?: boolean;
-    /** Base URL for source permalinks. E.g., "https://github.com/user/repo/blob/main" */
-    permalinkBaseUrl?: string;
-    /** URL template for ticket links. Use {ticket} as placeholder. E.g., "https://jira.example.com/browse/{ticket}" */
-    ticketUrlTemplate?: string;
-    /** Show table of contents sidebar. Default: true */
-    tocEnabled?: boolean;
-    /** Theme name or custom theme object. Default: "default" */
-    theme?: string | HtmlTheme;
-    /** Include theme picker with all CSS-only themes embedded. Default: false */
-    themePickerEnabled?: boolean;
-}
-/**
- * HTML Formatter.
- *
- * Transforms TestRunResult into a standalone HTML report with:
- * - Dark/light mode toggle
- * - Search/filter functionality
- * - Collapsible features and scenarios
- * - Modern, accessible design
- *
- * Thin wrapper around createHtmlFormatter for backward compatibility.
- */
-declare class HtmlFormatter {
-    private formatFn;
-    constructor(options?: HtmlOptions);
-    /**
-     * Format a test run into standalone HTML.
-     *
-     * @param run - Canonical test run result
-     * @returns HTML string
-     */
-    format(run: TestRunResult): string;
-}
-
 /**
  * JUnit XML Formatter - Layer 3.
  *
@@ -2217,243 +1440,6 @@ declare function rewriteAssetPaths(markdown: string, assetsBaseUrl: string, path
  */
 declare function copyMarkdownAssets(options: CopyMarkdownAssetsOptions): AstroAssetResult;
 
-/**
- * Cucumber Messages types for NDJSON output.
- *
- * Minimal own types (no @cucumber/messages dependency) — consistent with
- * the project's zero-external-deps-at-runtime approach.
- *
- * Based on the Cucumber Messages protocol:
- * https://github.com/cucumber/messages
- */
-/** Protobuf-style timestamp { seconds, nanos } */
-interface Timestamp {
-    seconds: number;
-    nanos: number;
-}
-/** Protobuf-style duration { seconds, nanos } */
-interface Duration {
-    seconds: number;
-    nanos: number;
-}
-/** Location in a source file */
-interface Location {
-    line: number;
-    column?: number;
-}
-interface Meta {
-    protocolVersion: string;
-    implementation: {
-        name: string;
-        version: string;
-    };
-    runtime: {
-        name: string;
-        version: string;
-    };
-    os: {
-        name: string;
-    };
-    cpu: {
-        name: string;
-    };
-}
-interface Source {
-    uri: string;
-    data: string;
-    mediaType: "text/x.cucumber.gherkin+plain";
-}
-interface Tag {
-    location: Location;
-    name: string;
-    id: string;
-}
-type KeywordType = "Unknown" | "Context" | "Action" | "Outcome" | "Conjunction";
-interface DocString {
-    location: Location;
-    mediaType?: string;
-    content: string;
-    delimiter: string;
-}
-interface TableCell {
-    location: Location;
-    value: string;
-}
-interface TableRow {
-    location: Location;
-    cells: TableCell[];
-    id: string;
-}
-interface DataTable {
-    location: Location;
-    rows: TableRow[];
-}
-interface Step {
-    location: Location;
-    keyword: string;
-    keywordType: KeywordType;
-    text: string;
-    id: string;
-    docString?: DocString;
-    dataTable?: DataTable;
-}
-interface Scenario {
-    location: Location;
-    tags: Tag[];
-    keyword: string;
-    name: string;
-    description: string;
-    steps: Step[];
-    id: string;
-}
-interface Background {
-    location: Location;
-    keyword: string;
-    name: string;
-    description: string;
-    steps: Step[];
-    id: string;
-}
-type FeatureChild = {
-    background: Background;
-    scenario?: undefined;
-} | {
-    scenario: Scenario;
-    background?: undefined;
-};
-interface Feature {
-    location: Location;
-    tags: Tag[];
-    language: string;
-    keyword: string;
-    name: string;
-    description: string;
-    children: FeatureChild[];
-}
-interface GherkinDocument {
-    uri: string;
-    feature: Feature;
-}
-type PickleStepType = "Unknown" | "Context" | "Action" | "Outcome";
-interface PickleDocString {
-    mediaType?: string;
-    content: string;
-}
-interface PickleTableCell {
-    value: string;
-}
-interface PickleTableRow {
-    cells: PickleTableCell[];
-}
-interface PickleTable {
-    rows: PickleTableRow[];
-}
-interface PickleStepArgument {
-    docString?: PickleDocString;
-    dataTable?: PickleTable;
-}
-interface PickleStep {
-    astNodeIds: string[];
-    id: string;
-    type: PickleStepType;
-    text: string;
-    argument?: PickleStepArgument;
-}
-interface PickleTag {
-    name: string;
-    astNodeId: string;
-}
-interface Pickle {
-    id: string;
-    uri: string;
-    name: string;
-    language: string;
-    steps: PickleStep[];
-    tags: PickleTag[];
-    astNodeIds: string[];
-}
-type TestStepResultStatus = "UNKNOWN" | "PASSED" | "SKIPPED" | "PENDING" | "UNDEFINED" | "AMBIGUOUS" | "FAILED";
-interface TestStepResult {
-    duration: Duration;
-    status: TestStepResultStatus;
-    message?: string;
-}
-interface TestStep {
-    id: string;
-    pickleStepId?: string;
-    stepDefinitionIds?: string[];
-}
-interface TestCase {
-    id: string;
-    pickleId: string;
-    testSteps: TestStep[];
-}
-interface TestRunStarted {
-    timestamp: Timestamp;
-}
-interface TestCaseStarted {
-    id: string;
-    testCaseId: string;
-    timestamp: Timestamp;
-    attempt: number;
-}
-interface TestStepStarted {
-    testCaseStartedId: string;
-    testStepId: string;
-    timestamp: Timestamp;
-}
-interface TestStepFinished {
-    testCaseStartedId: string;
-    testStepId: string;
-    testStepResult: TestStepResult;
-    timestamp: Timestamp;
-}
-interface TestCaseFinished {
-    testCaseStartedId: string;
-    timestamp: Timestamp;
-    willBeRetried: boolean;
-}
-interface TestRunFinished {
-    timestamp: Timestamp;
-    success: boolean;
-}
-type AttachmentContentEncoding = "IDENTITY" | "BASE64";
-interface CucumberAttachment {
-    testCaseStartedId: string;
-    testStepId?: string;
-    body: string;
-    mediaType: string;
-    contentEncoding: AttachmentContentEncoding;
-}
-/**
- * Each NDJSON line is one Envelope with exactly one field set.
- */
-type Envelope = {
-    meta: Meta;
-} | {
-    source: Source;
-} | {
-    gherkinDocument: GherkinDocument;
-} | {
-    pickle: Pickle;
-} | {
-    testRunStarted: TestRunStarted;
-} | {
-    testCase: TestCase;
-} | {
-    testCaseStarted: TestCaseStarted;
-} | {
-    testStepStarted: TestStepStarted;
-} | {
-    testStepFinished: TestStepFinished;
-} | {
-    testCaseFinished: TestCaseFinished;
-} | {
-    testRunFinished: TestRunFinished;
-} | {
-    attachment: CucumberAttachment;
-};
-
 /**
  * CucumberMessagesFormatter — produces NDJSON compatible with @cucumber/html-formatter.
  *
@@ -2524,14 +1510,11 @@ declare class CucumberHtmlFormatter {
 
 interface RunDiffHtmlOptions {
     title?: string;
-    /** Theme name or custom theme object. Default: "default" */
-    theme?: string | HtmlTheme;
     /** Enable dark mode toggle. Default: true */
     darkMode?: boolean;
 }
 declare class RunDiffHtmlFormatter {
     private title;
-    private theme;
     private darkMode;
     constructor(options?: RunDiffHtmlOptions);
     format(diff: RunDiffResult): string;
@@ -2546,32 +1529,6 @@ declare class RunDiffMarkdownFormatter {
     format(diff: RunDiffResult): string;
 }
 
-/**
- * NDJSON-to-TestRunResult parser.
- *
- * Parses Cucumber Messages NDJSON (one JSON envelope per line) back into
- * a TestRunResult suitable for rendering by HtmlFormatter or other formatters.
- *
- * This is the NDJSON compat path: it produces a minimal but sufficient
- * TestRunResult. Fields not present in the NDJSON stream are given
- * sensible defaults.
- */
-
-/**
- * Parse an NDJSON string into a TestRunResult.
- *
- * @param ndjson - NDJSON string (one JSON envelope per line)
- * @returns TestRunResult reconstructed from the envelopes
- */
-declare function parseNdjson(ndjson: string): TestRunResult;
-/**
- * Parse an array of Envelope objects into a TestRunResult.
- *
- * @param envelopes - Array of Cucumber Messages envelopes
- * @returns TestRunResult reconstructed from the envelopes
- */
-declare function parseEnvelopes(envelopes: Envelope[]): TestRunResult;
-
 /**
  * Git information utilities.
  *
@@ -2601,33 +1558,6 @@ declare function findGitDir(start: string): string | undefined;
  */
 declare function readBranchName(cwd?: string): string | undefined;
 
-/**
- * Duration formatting utilities.
- */
-/**
- * Format milliseconds as human-readable duration.
- *
- * @param ms - Duration in milliseconds
- * @returns Formatted string (e.g., "123 ms", "1.5 s", "2m 30s")
- */
-declare function formatDuration(ms: number): string;
-/**
- * Convert milliseconds to nanoseconds.
- *
- * Used for Cucumber JSON format which expects nanoseconds.
- *
- * @param ms - Duration in milliseconds
- * @returns Duration in nanoseconds
- */
-declare function msToNanoseconds(ms: number): number;
-/**
- * Convert nanoseconds to milliseconds.
- *
- * @param ns - Duration in nanoseconds
- * @returns Duration in milliseconds
- */
-declare function nanosecondsToMs(ns: number): number;
-
 /**
  * Metadata utilities for reading package information.
  */
@@ -2691,31 +1621,6 @@ declare function tryGetActiveOtelContext(): OtelTraceContext | undefined;
  */
 declare function resolveTraceUrl(template: string | undefined, traceId: string): string | undefined;
 
-/**
- * Canonical builders for doc entries whose construction carries a rule worth
- * keeping in one place. Adapters import these instead of re-implementing the
- * logic (the `html` exactly-one-of-source rule was previously copied verbatim
- * across the Vitest, Jest, Cypress, and Playwright adapters).
- */
-
-/** Source/presentation options for an `html` doc entry. */
-interface HtmlDocOptions {
-    /** Local HTML file path (inlined into the report by default). */
-    path?: string;
-    /** Remote URL rendered via iframe src. */
-    url?: string;
-    /** Inline HTML content rendered via iframe srcdoc. */
-    content?: string;
-    title?: string;
-    /** Iframe height: number → px, string passed through (e.g. '60vh'). Default 400px. */
-    height?: number | string;
-}
-/**
- * Build an `html` DocEntry, enforcing that exactly one of path/url/content is
- * set. Throws otherwise — this is the single source of that rule.
- */
-declare function buildHtmlDocEntry(options: HtmlDocOptions): DocEntry;
-
 /**
  * Notification orchestrator.
  *
@@ -2894,6 +1799,51 @@ declare function signBody(args: {
 /** Strip ANSI escape sequences. Regex: \x1B\[[0-?]*[ -/]*[@-~] */
 declare function stripAnsi(text: string): string;
 
+/**
+ * Types for history tracking and test metrics.
+ */
+
+interface HistoryEntry {
+    runId: string;
+    timestamp: number;
+    status: "passed" | "failed" | "skipped" | "pending";
+    durationMs: number;
+    ci?: {
+        provider?: CIProvider;
+        branch?: string;
+        commitSha?: string;
+    };
+}
+interface TestHistory {
+    testId: string;
+    testName: string;
+    sourceFile: string;
+    sourceLine?: number;
+    entries: HistoryEntry[];
+}
+interface HistoryStore {
+    version: 1;
+    maxRuns: number;
+    tests: Record<string, TestHistory>;
+    lastUpdated: number;
+}
+type StabilityGrade = "A" | "B" | "C" | "D" | "F";
+type FlakinessLevel = "stable" | "unstable" | "flaky";
+type PerformanceTrend = "improving" | "stable" | "regressing";
+interface TestMetrics {
+    testId: string;
+    flakinessLevel: FlakinessLevel;
+    flakinessScore: number;
+    failureRate: number;
+    stabilityGrade: StabilityGrade;
+    performanceTrend: PerformanceTrend;
+    avgDurationMs: number;
+    passRate: number;
+    longestPassStreak: number;
+    consecutiveFailures: number;
+    sampleSize: number;
+}
+
 /**
  * History store: load, save, update (fn(args, deps) pattern).
  */
@@ -2993,6 +1943,8 @@ declare function hasSufficientHistory(entries: unknown[], min: number): boolean;
 interface ListScenariosArgs {
     testCases: TestCaseResult[];
     format: "text" | "json" | "csv" | "markdown-table";
+    /** Emit compact (single-line) JSON for agent consumption. Only affects "json". Default false. */
+    minify?: boolean;
 }
 type ListScenariosDeps = Record<string, never>;
 declare function listScenarios(args: ListScenariosArgs, _deps: ListScenariosDeps): string;
@@ -3014,13 +1966,13 @@ declare function listScenarios(args: ListScenariosArgs, _deps: ListScenariosDeps
 interface CheckArgs {
     testCases: TestCaseResult[];
     /** Baseline scenario statuses keyed by scenario id, for regressed/fixed deltas. */
-    baseline?: Map<string, TestStatus$1>;
+    baseline?: Map<string, TestStatus>;
     format: "text" | "json";
 }
 type CheckDeps = Record<string, never>;
 /** A single rendered step inside a failing scenario. */
 interface CheckStep {
-    keyword: StepKeyword$1;
+    keyword: StepKeyword;
     text: string;
     /** True when this step is the one that failed. */
     failed: boolean;
@@ -3138,7 +2090,7 @@ interface TriageItem {
     rank: number;
     id: string;
     scenario: string;
-    status: TestStatus$1;
+    status: TestStatus;
     /** `sourceFile:sourceLine` */
     location: string;
     /** Product-code paths to fix. Empty when the scenario declared no `covers`. */
@@ -3160,7 +2112,7 @@ interface TriageReport {
 interface TriageArgs {
     testCases: TestCaseResult[];
     /** Baseline statuses by scenario id, to flag regressions and rank them first. */
-    baseline?: Map<string, TestStatus$1>;
+    baseline?: Map<string, TestStatus>;
     format: "text" | "json";
 }
 type TriageDeps = Record<string, never>;
@@ -3256,14 +2208,11 @@ declare class ReviewMarkdownFormatter {
 
 interface ReviewHtmlOptions {
     title?: string;
-    /** Theme name or custom theme object. Default: "default" */
-    theme?: string | HtmlTheme;
     /** Enable dark mode toggle. Default: true */
     darkMode?: boolean;
 }
 declare class ReviewHtmlFormatter {
     private title;
-    private theme;
     private darkMode;
     constructor(options?: ReviewHtmlOptions);
     format(review: ReviewResult): string;
@@ -3393,7 +2342,7 @@ interface TraceabilityRequirement {
     scenarios: Array<{
         id: string;
         title: string;
-        status: TestStatus$1;
+        status: TestStatus;
         sourceFile: string;
         sourceLine: number;
         covers: string[];
@@ -3422,7 +2371,7 @@ interface TraceabilityMatrix {
     untraced: Array<{
         id: string;
         title: string;
-        status: TestStatus$1;
+        status: TestStatus;
         sourceFile: string;
         sourceLine: number;
     }>;
@@ -3441,7 +2390,8 @@ declare function toTraceabilityMatrix(run: TestRunResult): TraceabilityMatrix;
  * Architecture:
  * - Layer 1: Framework Adapters (adaptJestRun, adaptVitestRun, adaptPlaywrightRun)
  * - Layer 2: Anti-Corruption Layer (canonicalizeRun)
- * - Layer 3: Formatters (CucumberJsonFormatter, HtmlFormatter, JUnitFormatter, MarkdownFormatter)
+ * - Layer 3: Formatters (CucumberJsonFormatter, JUnitFormatter, MarkdownFormatter; the
+ *   HTML report renders via executable-stories-react — the `html` format)
  */
 
 /** Arguments for generate function */
@@ -3473,16 +2423,12 @@ interface GenerateCompareResult {
  */
 declare function joinNameAndExt(name: string, ext: string): string;
 /**
- * High-level report generator that combines multiple formatters.
- *
- * Accepts ONLY canonical TestRunResult - use adapters + canonicalizeRun first.
- *
- * Supports output routing:
- * - Aggregated: All test cases in a single file
- * - Colocated mirrored: Files mirrored under outputDir preserving directory structure
- * - Colocated adjacent: Files written next to source files
- * - Rule-based: Different routing based on source file patterns
+ * Normalise input formats to canonical {@link OutputFormat}s. Accepts the
+ * deprecated `"astro"` alias (renamed to `"astro-markdown"`) and warns once per
+ * process — so programmatic/config callers passing `"astro"` keep working
+ * instead of throwing, matching the CLI's deprecation behaviour.
  */
+declare function normalizeFormats(formats: ReadonlyArray<FormatInput>): OutputFormat[];
 declare class ReportGenerator {
     private options;
     private deps;
@@ -3506,6 +2452,13 @@ declare class ReportGenerator {
      * Format content for a specific format.
      */
     private formatContent;
+    /**
+     * Render a standalone HTML report via the shared React component tree
+     * (executable-stories-react). This is the same renderer the Astro docs site
+     * uses, so the two outputs cannot drift. Imported lazily so React stays out
+     * of the eager bundle unless this format is requested.
+     */
+    private formatHtmlReact;
 }
 /**
  * Factory function to create a ReportGenerator with dependency injection.
@@ -3541,4 +2494,4 @@ declare function normalizeVitestResults(testModules: Parameters<typeof adaptVite
  */
 declare function normalizePlaywrightResults(testResults: Parameters<typeof adaptPlaywrightRun>[0], adapterOptions?: Parameters<typeof adaptPlaywrightRun>[1], canonicalizeOptions?: CanonicalizeOptions): TestRunResult;
 
-export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, Attachment, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, CIProvider, type CanonicalizeOptions, type ChangeType, type ChangedFile, type ChangedFileReview, type CheckArgs, type CheckDeps, type CheckFailure, type CheckReport, type CheckStep, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, DocEntry, DocPhase, ES_THEME_TOKENS_CSS, ES_THEME_TOKEN_VALUES, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type HtmlDocOptions, HtmlFormatter, type HtmlOptions, type HtmlTheme, type HtmlThemeName, type IJsonDataTable, type IJsonDocString, type IJsonEmbedding, type IJsonFeature, type IJsonScenario, type IJsonStep, type IJsonStepArgument, type IJsonStepResult, type IJsonTableRow, type IJsonTag, JUnitFormatter, type JUnitOptions, type JiraAuth, type JiraPublishMode, type ListScenariosArgs, type ListScenariosDeps, type Logger, MIN_FLAKINESS_SAMPLES, MIN_METRIC_SAMPLES, MIN_PERF_SAMPLES, MarkdownFormatter, type MarkdownFormatterOptions, type MarkdownOptions, type MarkdownRenderers, NormalizedTicket, type NotificationSummary, type NotifyCondition, OtelSpan, type OtelTraceContext, type OutputConfig, type OutputFormat, type OutputMode, type OutputRule, type PerformanceTrend, type PublishConfluenceArgs, type PublishConfluenceDeps, type PublishConfluenceResult, type PublishJiraArgs, type PublishJiraDeps, type PublishJiraResult, type RatchetViolation, RawAttachment, RawCIInfo, RawRun, RawStatus, type RecordDeploymentArgs, type RecordDeploymentResult, type ReleaseManifest, ReleaseManifestFormatter, type ReportAttachment, type ReportCIInfo, type ReportCoverageSummary, type ReportDocCode, type ReportDocCustom, type ReportDocEntry, type ReportDocKv, type ReportDocLink, type ReportDocMermaid, type ReportDocNote, type ReportDocScreenshot, type ReportDocSection, type ReportDocTable, type ReportDocTag, type ReportFeature, ReportGenerator, type ReportScenario, type ReportStep, type ReportSummary, type ReportTicket, type ResolvedFormatterOptions, type ReviewAudience, type ReviewBand, type ReviewClaim, type ReviewContext, ReviewHtmlFormatter, type ReviewHtmlOptions, ReviewMarkdownFormatter, type ReviewMarkdownOptions, type ReviewResult, type ReviewSummary, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, STORY_REPORT_SCHEMA_MAJOR, STORY_REPORT_SCHEMA_VERSION, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioIndex, type ScenarioIndexFilters, type ScenarioIndexItem, ScenarioIndexJsonFormatter, type ScenarioIndexJsonOptions, type ScenarioIndexStep, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, StepKeyword$1 as StepKeyword, StepResult, type StoryReport, StoryReportJsonFormatter, type StoryReportJsonOptions, type StoryReportSchemaVersion, StoryStep, TestCaseResult, type TestHistory, type TestMetrics, TestRunResult, TestStatus$1 as TestStatus, type TraceabilityMatrix, TraceabilityMatrixFormatter, type TraceabilityRequirement, type TriageArgs, type TriageDeps, type TriageItem, type TriageReport, CIInfo as TypedCIInfo, type ValidationResult, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, assertValidRun, buildCheck, buildGoal, buildHtmlDocEntry, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, canonicalizeRun, classifyStatusChange, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, deriveStepResults, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, formatDuration, generateRunComparison, generateRunId, generateTestCaseId, getAvailableThemes, getCssOnlyThemes, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, mergeStepResults, msToNanoseconds, nanosecondsToMs, normalizeJestResults, normalizePlaywrightResults, normalizeStatus, normalizeVitestResults, parseEnvelopes, parseNdjson, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, renderCheck, renderGoal, renderTriage, resolveAttachment, resolveAttachments, resolveTheme, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, slugify, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toStoryReport, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory, validateCanonicalRun };
+export { type AstroAssetResult, AstroFormatter, type AstroFormatterOptions as AstroFormatterOpts, type BehaviorDebuggerIssue, type BehaviorDiff, type BehaviorDiffEntry, type BehaviorManifest, BehaviorManifestJsonFormatter, type BehaviorManifestJsonOptions, type BehaviorSourceFile, type BehaviorTag, type BundleOptions, type BundleResult, type ChangeType, type ChangedFile, type ChangedFileReview, type CheckArgs, type CheckDeps, type CheckFailure, type CheckReport, type CheckStep, type ColocatedStyle, type CompareFormat, type CompareFormatterOptions, type ConfluenceAuth, ConfluenceFormatter, type ConfluenceFormatterOptions as ConfluenceFormatterOpts, type CopyMarkdownAssetsOptions, CucumberHtmlFormatter, type CucumberHtmlOptions, CucumberJsonFormatter, type CucumberJsonOptions, CucumberMessagesFormatter, type CucumberMessagesOptions, type DeploymentEntry, type DeploymentLedger, type DeploymentStatus, type EnvironmentDrift, type EvidenceStrength, type ExecutableStoriesConfig, type FetchFn, type FileChangeKind, type FlakinessLevel, type Formatter, type FormatterOptions, type GenerateArgs, type GenerateCompareResult, type GenerateDeps, type GenerateResult, type GenericWebhookNotifierOptions, type GoalArgs, type GoalDeps, type GoalReport, type GoalRequirementResult, type HistoryEntry, type HistoryStore, type IJsonDataTable, type IJsonDocString, type IJsonEmbedding, type IJsonFeature, type IJsonScenario, type IJsonStep, type IJsonStepArgument, type IJsonStepResult, type IJsonTableRow, type IJsonTag, JUnitFormatter, type JUnitOptions, type JiraAuth, type JiraPublishMode, type ListScenariosArgs, type ListScenariosDeps, type Logger, MIN_FLAKINESS_SAMPLES, MIN_METRIC_SAMPLES, MIN_PERF_SAMPLES, MarkdownFormatter, type MarkdownFormatterOptions, type MarkdownOptions, type MarkdownRenderers, type NotificationSummary, type NotifyCondition, type OtelTraceContext, type OutputConfig, type OutputFormat, type OutputMode, type OutputRule, type PerformanceTrend, type PublishConfluenceArgs, type PublishConfluenceDeps, type PublishConfluenceResult, type PublishJiraArgs, type PublishJiraDeps, type PublishJiraResult, type RatchetViolation, type RecordDeploymentArgs, type RecordDeploymentResult, type ReleaseManifest, ReleaseManifestFormatter, ReportGenerator, type ResolvedFormatterOptions, type ReviewAudience, type ReviewBand, type ReviewClaim, type ReviewContext, ReviewHtmlFormatter, type ReviewHtmlOptions, ReviewMarkdownFormatter, type ReviewMarkdownOptions, type ReviewResult, type ReviewSummary, RunDiffHtmlFormatter, type RunDiffHtmlOptions, RunDiffMarkdownFormatter, type RunDiffMarkdownOptions, type RunDiffResult, type RunDiffSummary, type ScenarioChangeFlags, type ScenarioChangeKind, type ScenarioDiff, type ScenarioIndex, type ScenarioIndexFilters, type ScenarioIndexItem, ScenarioIndexJsonFormatter, type ScenarioIndexJsonOptions, type ScenarioIndexStep, type ScenarioSnapshot, type SortTestCasesMode, type StabilityGrade, type StarlightBadge, StoryReportJsonFormatter, type StoryReportJsonOptions, type TestHistory, type TestMetrics, type TraceabilityMatrix, TraceabilityMatrixFormatter, type TraceabilityRequirement, type TriageArgs, type TriageDeps, type TriageItem, type TriageReport, type WatchDeps, type WatchHandle, type WatchOptions, type WebhookPayload, type WebhookSignerHmac, type WriteFile, adaptJestRun, adaptPlaywrightRun, adaptVitestRun, buildCheck, buildGoal, buildReview, buildTriage, bundleAssets, calculateFlakiness, calculateStability, classifyStatusChange, clearVersionCache, computeTestMetrics, copyMarkdownAssets, createPrCommentSummary, createReportGenerator, deriveAudience, deriveChangeType, detectCI, detectPerformanceTrend, diffRuns, diffStoryReports, findGitDir, generateRunComparison, getDeploymentStatus, getEnvironmentDrift, gradeEvidence, hasSufficientHistory, isReviewableSource, isTestFile, joinNameAndExt, listScenarios, loadHistory, normalizeFormats, normalizeJestResults, normalizePlaywrightResults, normalizeVitestResults, publishConfluencePage, publishJiraIssue, readBranchName, readGitSha, readPackageVersion, recordDeployment, regenerateArtifacts, regenerateRun, renderCheck, renderGoal, renderTriage, resolveTraceUrl, rewriteAssetPaths, saveHistory, scenariosCoveringPaths, sendNotifications, sendSlackNotification, sendTeamsNotification, sendWebhookNotification, signBody, startWatch, stripAnsi, toBehaviorManifest, toReleaseManifest, toScenarioIndex, toTraceabilityMatrix, tryGetActiveOtelContext, updateHistory };