executable-stories-react 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -75,7 +75,7 @@ interface ReportCoverageSummary {
     functionsPct?: number;
     statementsPct?: number;
 }
-type ReportDocEntry = ReportDocNote | ReportDocTag | ReportDocKv | ReportDocCode | ReportDocTable | ReportDocLink | ReportDocSection | ReportDocMermaid | ReportDocScreenshot | ReportDocVideo | ReportDocHtml | ReportDocCustom;
+type ReportDocEntry = ReportDocNote | ReportDocTag | ReportDocKv | ReportDocCode | ReportDocTable | ReportDocLink | ReportDocSection | ReportDocMermaid | ReportDocScreenshot | ReportDocVideo | ReportDocHtml | ReportDocState | ReportDocCustom;
 interface ReportDocNote {
     kind: "note";
     text: string;
@@ -161,6 +161,15 @@ interface ReportDocHtml {
     phase: DocPhase;
     children?: ReportDocEntry[];
 }
+interface ReportDocState {
+    kind: "state";
+    /** Entity name ("Basket") — diff identity across steps. Unlabeled states share one lane. */
+    label?: string;
+    /** JSON-serializable snapshot of the state at this step. */
+    value: unknown;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
 interface ReportDocCustom {
     kind: "custom";
     type: string;
@@ -369,6 +378,25 @@ declare function ReportStepItem({ step }: {
     step: ReportStep;
 }): react.JSX.Element;
 
+interface ReportStoryboardProps {
+    scenario: ReportScenario$1;
+}
+/**
+ * Storyboard — a horizontal filmstrip of the scenario's step evidence
+ * (Given → When → Then), derived from the same step docs the vertical step
+ * list renders. A frame is a container: the step's screenshot (when present)
+ * plus its `story.state()` snapshot cards, so data-only scenarios get
+ * filmstrips too. Each frame links to its step's anchor.
+ *
+ * Renders nothing below 2 frames: a single capture is evidence, not a
+ * walkthrough, and it already shows under its step.
+ *
+ * Must stay hydration-free: the Astro story pages render this inside a static
+ * (no client JS) island, so navigation is plain anchors and snapshot expansion
+ * is a native <details> — no lightbox or toggle state.
+ */
+declare function ReportStoryboard({ scenario }: ReportStoryboardProps): react.JSX.Element | null;
+
 interface ReportDocEntriesProps {
     entries: readonly ReportDocEntry[];
 }
@@ -619,4 +647,4 @@ declare const STORY_REPORT_SCHEMA_MAJOR: 1;
 
 declare const storyReportSchema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
 
-export { type BuiltinRenderers, type CustomRenderer, type CustomRenderers, DocCode, DocCustom, DocEntry, DocHtml, DocKv, DocLink, DocMermaid, DocNote, DocScreenshot, DocSection, DocTable, DocTag, DocVideo, type ExplorerScenario, type ExplorerStatus, MermaidDiagram, MermaidSource, Report, ReportAttachments, ReportDocEntries, type ReportDocEntriesProps, ReportEmpty, type ReportEmptyProps, ReportFeature, ReportFeatureList, type ReportFeatureProps, ReportMeta, type ReportParseError, type ReportParseErrorCode, type ReportProps, ReportRoot, type ReportRootProps, ReportScenario, ReportScenarioList, type ReportScenarioListProps, type ReportScenarioProps, ReportSchemaError, type ReportSchemaErrorProps, ReportStepItem, ReportSteps, type ReportStepsProps, ReportSummary, type ReportSummaryProps, ReportSummaryView, type ReportSummaryViewProps, ReportTrace, type Result, type RunStreak, STORY_REPORT_SCHEMA_MAJOR, ScenarioExplorer, type ScenarioExplorerProps, type ScenarioHistoryMap, type ScenarioRunEvent, ScenarioRunHistory, type ScenarioRunStatus, type StoryReport, type ReportDocEntry as StoryReportDocEntry, type ReportFeature$1 as StoryReportFeature, type ReportScenario$1 as StoryReportScenario, type ReportStep as StoryReportStep, type ReportSummary$1 as StoryReportSummary, ciDisplayName, commitUrl, currentStreak, describeRunHistory, err, formatRelativeAge, isReportStale, ok, parseStoryReport, prUrl, reportLastRunMs, storyReportSchema, useBuiltinRenderers, useCustomRenderers, useReport };
+export { type BuiltinRenderers, type CustomRenderer, type CustomRenderers, DocCode, DocCustom, DocEntry, DocHtml, DocKv, DocLink, DocMermaid, DocNote, DocScreenshot, DocSection, DocTable, DocTag, DocVideo, type ExplorerScenario, type ExplorerStatus, MermaidDiagram, MermaidSource, Report, ReportAttachments, ReportDocEntries, type ReportDocEntriesProps, ReportEmpty, type ReportEmptyProps, ReportFeature, ReportFeatureList, type ReportFeatureProps, ReportMeta, type ReportParseError, type ReportParseErrorCode, type ReportProps, ReportRoot, type ReportRootProps, ReportScenario, ReportScenarioList, type ReportScenarioListProps, type ReportScenarioProps, ReportSchemaError, type ReportSchemaErrorProps, ReportStepItem, ReportSteps, type ReportStepsProps, ReportStoryboard, type ReportStoryboardProps, ReportSummary, type ReportSummaryProps, ReportSummaryView, type ReportSummaryViewProps, ReportTrace, type Result, type RunStreak, STORY_REPORT_SCHEMA_MAJOR, ScenarioExplorer, type ScenarioExplorerProps, type ScenarioHistoryMap, type ScenarioRunEvent, ScenarioRunHistory, type ScenarioRunStatus, type StoryReport, type ReportDocEntry as StoryReportDocEntry, type ReportFeature$1 as StoryReportFeature, type ReportScenario$1 as StoryReportScenario, type ReportStep as StoryReportStep, type ReportSummary$1 as StoryReportSummary, ciDisplayName, commitUrl, currentStreak, describeRunHistory, err, formatRelativeAge, isReportStale, ok, parseStoryReport, prUrl, reportLastRunMs, storyReportSchema, useBuiltinRenderers, useCustomRenderers, useReport };

package/dist/index.d.ts

@@ -75,7 +75,7 @@ interface ReportCoverageSummary {
     functionsPct?: number;
     statementsPct?: number;
 }
-type ReportDocEntry = ReportDocNote | ReportDocTag | ReportDocKv | ReportDocCode | ReportDocTable | ReportDocLink | ReportDocSection | ReportDocMermaid | ReportDocScreenshot | ReportDocVideo | ReportDocHtml | ReportDocCustom;
+type ReportDocEntry = ReportDocNote | ReportDocTag | ReportDocKv | ReportDocCode | ReportDocTable | ReportDocLink | ReportDocSection | ReportDocMermaid | ReportDocScreenshot | ReportDocVideo | ReportDocHtml | ReportDocState | ReportDocCustom;
 interface ReportDocNote {
     kind: "note";
     text: string;
@@ -161,6 +161,15 @@ interface ReportDocHtml {
     phase: DocPhase;
     children?: ReportDocEntry[];
 }
+interface ReportDocState {
+    kind: "state";
+    /** Entity name ("Basket") — diff identity across steps. Unlabeled states share one lane. */
+    label?: string;
+    /** JSON-serializable snapshot of the state at this step. */
+    value: unknown;
+    phase: DocPhase;
+    children?: ReportDocEntry[];
+}
 interface ReportDocCustom {
     kind: "custom";
     type: string;
@@ -369,6 +378,25 @@ declare function ReportStepItem({ step }: {
     step: ReportStep;
 }): react.JSX.Element;
 
+interface ReportStoryboardProps {
+    scenario: ReportScenario$1;
+}
+/**
+ * Storyboard — a horizontal filmstrip of the scenario's step evidence
+ * (Given → When → Then), derived from the same step docs the vertical step
+ * list renders. A frame is a container: the step's screenshot (when present)
+ * plus its `story.state()` snapshot cards, so data-only scenarios get
+ * filmstrips too. Each frame links to its step's anchor.
+ *
+ * Renders nothing below 2 frames: a single capture is evidence, not a
+ * walkthrough, and it already shows under its step.
+ *
+ * Must stay hydration-free: the Astro story pages render this inside a static
+ * (no client JS) island, so navigation is plain anchors and snapshot expansion
+ * is a native <details> — no lightbox or toggle state.
+ */
+declare function ReportStoryboard({ scenario }: ReportStoryboardProps): react.JSX.Element | null;
+
 interface ReportDocEntriesProps {
     entries: readonly ReportDocEntry[];
 }
@@ -619,4 +647,4 @@ declare const STORY_REPORT_SCHEMA_MAJOR: 1;
 
 declare const storyReportSchema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
 
-export { type BuiltinRenderers, type CustomRenderer, type CustomRenderers, DocCode, DocCustom, DocEntry, DocHtml, DocKv, DocLink, DocMermaid, DocNote, DocScreenshot, DocSection, DocTable, DocTag, DocVideo, type ExplorerScenario, type ExplorerStatus, MermaidDiagram, MermaidSource, Report, ReportAttachments, ReportDocEntries, type ReportDocEntriesProps, ReportEmpty, type ReportEmptyProps, ReportFeature, ReportFeatureList, type ReportFeatureProps, ReportMeta, type ReportParseError, type ReportParseErrorCode, type ReportProps, ReportRoot, type ReportRootProps, ReportScenario, ReportScenarioList, type ReportScenarioListProps, type ReportScenarioProps, ReportSchemaError, type ReportSchemaErrorProps, ReportStepItem, ReportSteps, type ReportStepsProps, ReportSummary, type ReportSummaryProps, ReportSummaryView, type ReportSummaryViewProps, ReportTrace, type Result, type RunStreak, STORY_REPORT_SCHEMA_MAJOR, ScenarioExplorer, type ScenarioExplorerProps, type ScenarioHistoryMap, type ScenarioRunEvent, ScenarioRunHistory, type ScenarioRunStatus, type StoryReport, type ReportDocEntry as StoryReportDocEntry, type ReportFeature$1 as StoryReportFeature, type ReportScenario$1 as StoryReportScenario, type ReportStep as StoryReportStep, type ReportSummary$1 as StoryReportSummary, ciDisplayName, commitUrl, currentStreak, describeRunHistory, err, formatRelativeAge, isReportStale, ok, parseStoryReport, prUrl, reportLastRunMs, storyReportSchema, useBuiltinRenderers, useCustomRenderers, useReport };
+export { type BuiltinRenderers, type CustomRenderer, type CustomRenderers, DocCode, DocCustom, DocEntry, DocHtml, DocKv, DocLink, DocMermaid, DocNote, DocScreenshot, DocSection, DocTable, DocTag, DocVideo, type ExplorerScenario, type ExplorerStatus, MermaidDiagram, MermaidSource, Report, ReportAttachments, ReportDocEntries, type ReportDocEntriesProps, ReportEmpty, type ReportEmptyProps, ReportFeature, ReportFeatureList, type ReportFeatureProps, ReportMeta, type ReportParseError, type ReportParseErrorCode, type ReportProps, ReportRoot, type ReportRootProps, ReportScenario, ReportScenarioList, type ReportScenarioListProps, type ReportScenarioProps, ReportSchemaError, type ReportSchemaErrorProps, ReportStepItem, ReportSteps, type ReportStepsProps, ReportStoryboard, type ReportStoryboardProps, ReportSummary, type ReportSummaryProps, ReportSummaryView, type ReportSummaryViewProps, ReportTrace, type Result, type RunStreak, STORY_REPORT_SCHEMA_MAJOR, ScenarioExplorer, type ScenarioExplorerProps, type ScenarioHistoryMap, type ScenarioRunEvent, ScenarioRunHistory, type ScenarioRunStatus, type StoryReport, type ReportDocEntry as StoryReportDocEntry, type ReportFeature$1 as StoryReportFeature, type ReportScenario$1 as StoryReportScenario, type ReportStep as StoryReportStep, type ReportSummary$1 as StoryReportSummary, ciDisplayName, commitUrl, currentStreak, describeRunHistory, err, formatRelativeAge, isReportStale, ok, parseStoryReport, prUrl, reportLastRunMs, storyReportSchema, useBuiltinRenderers, useCustomRenderers, useReport };