executable-stories-react 0.1.0

package/dist/index.js

@@ -0,0 +1,964 @@
+"use client";
+
+// src/context/ReportRoot.tsx
+import { useMemo } from "react";
+
+// src/context/ReportContext.ts
+import { createContext } from "react";
+var ReportContext = createContext(null);
+
+// src/context/ReportRoot.tsx
+import { jsx } from "react/jsx-runtime";
+var EMPTY_CUSTOM = {};
+var EMPTY_RENDERERS = {};
+function ReportRoot({
+  report,
+  customRenderers,
+  renderers,
+  children
+}) {
+  const value = useMemo(
+    () => ({
+      report,
+      customRenderers: customRenderers ?? EMPTY_CUSTOM,
+      renderers: renderers ?? EMPTY_RENDERERS
+    }),
+    [report, customRenderers, renderers]
+  );
+  return /* @__PURE__ */ jsx(ReportContext.Provider, { value, children });
+}
+
+// src/hooks/useReport.ts
+import { useContext } from "react";
+function useReport() {
+  const ctx = useContext(ReportContext);
+  if (!ctx) {
+    throw new Error(
+      "useReport must be used inside <ReportRoot> or <Report>. Wrap your tree with one of those."
+    );
+  }
+  return ctx.report;
+}
+
+// src/components/ReportSummary.tsx
+import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
+function ReportSummary({ className }) {
+  const report = useReport();
+  return /* @__PURE__ */ jsx2(
+    ReportSummaryView,
+    {
+      summary: report.summary,
+      ...className !== void 0 && { className },
+      ariaLabel: "Run summary"
+    }
+  );
+}
+function ReportSummaryView({ summary, className, ariaLabel }) {
+  return /* @__PURE__ */ jsxs(
+    "p",
+    {
+      className: ["es-report-summary", className].filter(Boolean).join(" "),
+      "aria-label": ariaLabel,
+      children: [
+        /* @__PURE__ */ jsxs("span", { children: [
+          /* @__PURE__ */ jsx2("strong", { children: summary.total }),
+          " scenario",
+          summary.total === 1 ? "" : "s"
+        ] }),
+        " \xB7 ",
+        /* @__PURE__ */ jsxs("span", { "data-status": "passed", children: [
+          summary.passed,
+          " passed"
+        ] }),
+        " \xB7 ",
+        /* @__PURE__ */ jsxs("span", { "data-status": "failed", children: [
+          summary.failed,
+          " failed"
+        ] }),
+        summary.skipped > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          " \xB7 ",
+          /* @__PURE__ */ jsxs("span", { "data-status": "skipped", children: [
+            summary.skipped,
+            " skipped"
+          ] })
+        ] }) : null,
+        summary.pending > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          " \xB7 ",
+          /* @__PURE__ */ jsxs("span", { "data-status": "pending", children: [
+            summary.pending,
+            " pending"
+          ] })
+        ] }) : null
+      ]
+    }
+  );
+}
+
+// src/components/doc/DocNote.tsx
+import { jsx as jsx3 } from "react/jsx-runtime";
+function DocNote({ entry }) {
+  return /* @__PURE__ */ jsx3("p", { className: "es-doc es-doc-note", children: entry.text });
+}
+
+// src/components/doc/DocTag.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
+function DocTag({ entry }) {
+  return /* @__PURE__ */ jsx4("ul", { className: "es-doc es-tags", "aria-label": "Tags", children: entry.names.map((n) => /* @__PURE__ */ jsx4("li", { children: n }, n)) });
+}
+
+// src/components/doc/DocKv.tsx
+import { jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
+function formatValue(value) {
+  if (value === null) return "null";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function DocKv({ entry }) {
+  return /* @__PURE__ */ jsxs2("dl", { className: "es-doc es-doc-kv", children: [
+    /* @__PURE__ */ jsx5("dt", { children: entry.label }),
+    /* @__PURE__ */ jsx5("dd", { children: formatValue(entry.value) })
+  ] });
+}
+
+// src/hooks/useRenderers.ts
+import { useContext as useContext2 } from "react";
+var EMPTY_CUSTOM2 = {};
+var EMPTY_RENDERERS2 = {};
+function useCustomRenderers() {
+  const ctx = useContext2(ReportContext);
+  return ctx?.customRenderers ?? EMPTY_CUSTOM2;
+}
+function useBuiltinRenderers() {
+  const ctx = useContext2(ReportContext);
+  return ctx?.renderers ?? EMPTY_RENDERERS2;
+}
+
+// src/components/doc/DocCode.tsx
+import { Fragment as Fragment2, jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
+function DocCode({ entry }) {
+  const renderers = useBuiltinRenderers();
+  if (renderers.code) {
+    return /* @__PURE__ */ jsx6(Fragment2, { children: renderers.code(entry) });
+  }
+  return /* @__PURE__ */ jsxs3("figure", { className: "es-doc es-doc-code", children: [
+    /* @__PURE__ */ jsx6("figcaption", { children: entry.label }),
+    /* @__PURE__ */ jsx6("pre", { children: /* @__PURE__ */ jsx6("code", { className: entry.lang ? `language-${entry.lang}` : void 0, children: entry.content }) })
+  ] });
+}
+
+// src/components/doc/DocTable.tsx
+import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
+function DocTable({ entry }) {
+  return /* @__PURE__ */ jsxs4("figure", { className: "es-doc es-doc-table", children: [
+    /* @__PURE__ */ jsx7("figcaption", { children: entry.label }),
+    /* @__PURE__ */ jsxs4("table", { children: [
+      /* @__PURE__ */ jsx7("thead", { children: /* @__PURE__ */ jsx7("tr", { children: entry.columns.map((c) => /* @__PURE__ */ jsx7("th", { scope: "col", children: c }, c)) }) }),
+      /* @__PURE__ */ jsx7("tbody", { children: entry.rows.map((row, i) => /* @__PURE__ */ jsx7("tr", { children: row.map((cell, j) => /* @__PURE__ */ jsx7("td", { children: cell }, j)) }, i)) })
+    ] })
+  ] });
+}
+
+// src/components/doc/DocLink.tsx
+import { jsx as jsx8 } from "react/jsx-runtime";
+function DocLink({ entry }) {
+  return /* @__PURE__ */ jsx8(
+    "a",
+    {
+      className: "es-doc es-doc-link",
+      href: entry.url,
+      rel: "noreferrer noopener",
+      target: "_blank",
+      children: entry.label
+    }
+  );
+}
+
+// src/components/doc/DocSection.tsx
+import { marked } from "marked";
+import { Fragment as Fragment3, jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
+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(/\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*"\s*javascript:[^"]*"/gi, '$1="#"').replace(/(href|src)\s*=\s*'\s*javascript:[^']*'/gi, "$1='#'");
+}
+function DocSection({ entry }) {
+  const renderers = useBuiltinRenderers();
+  if (renderers.section) {
+    return /* @__PURE__ */ jsx9(Fragment3, { children: renderers.section(entry) });
+  }
+  const html = safeMarkdownHtml(entry.markdown);
+  return /* @__PURE__ */ jsxs5("section", { className: "es-doc es-doc-section", "aria-label": entry.title, children: [
+    entry.title ? /* @__PURE__ */ jsx9("h4", { className: "es-doc-section-title", children: entry.title }) : null,
+    /* @__PURE__ */ jsx9(
+      "div",
+      {
+        className: "es-doc-section-content",
+        dangerouslySetInnerHTML: { __html: html }
+      }
+    )
+  ] });
+}
+
+// src/components/doc/DocMermaid.tsx
+import { Fragment as Fragment4, jsx as jsx10, jsxs as jsxs6 } from "react/jsx-runtime";
+function DocMermaid({ entry }) {
+  const renderers = useBuiltinRenderers();
+  if (renderers.mermaid) {
+    return /* @__PURE__ */ jsx10(Fragment4, { children: renderers.mermaid(entry) });
+  }
+  return /* @__PURE__ */ jsxs6(
+    "figure",
+    {
+      className: "es-doc es-doc-mermaid",
+      "aria-label": entry.title ?? "Diagram",
+      children: [
+        entry.title ? /* @__PURE__ */ jsx10("figcaption", { children: entry.title }) : null,
+        /* @__PURE__ */ jsx10("pre", { "data-mermaid": true, children: entry.code })
+      ]
+    }
+  );
+}
+
+// src/components/doc/DocScreenshot.tsx
+import { jsx as jsx11, jsxs as jsxs7 } from "react/jsx-runtime";
+function DocScreenshot({ entry }) {
+  return /* @__PURE__ */ jsxs7("figure", { className: "es-doc es-doc-screenshot", children: [
+    /* @__PURE__ */ jsx11("img", { src: entry.path, alt: entry.alt ?? "", loading: "lazy" }),
+    entry.alt ? /* @__PURE__ */ jsx11("figcaption", { children: entry.alt }) : null
+  ] });
+}
+
+// src/components/doc/DocCustom.tsx
+import { Fragment as Fragment5, jsx as jsx12, jsxs as jsxs8 } from "react/jsx-runtime";
+function DocCustom({ entry }) {
+  const renderers = useCustomRenderers();
+  const renderer = renderers[entry.type];
+  if (renderer) {
+    return /* @__PURE__ */ jsx12(Fragment5, { children: renderer(entry) });
+  }
+  return /* @__PURE__ */ jsxs8("div", { className: "es-doc es-doc-custom", "data-type": entry.type, children: [
+    /* @__PURE__ */ jsx12("p", { className: "es-doc-custom-type", children: entry.type }),
+    /* @__PURE__ */ jsx12("pre", { children: safeStringify(entry.data) })
+  ] });
+}
+function safeStringify(value) {
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    return String(value);
+  }
+}
+
+// src/components/doc/DocEntry.tsx
+import { jsx as jsx13 } from "react/jsx-runtime";
+function DocEntry({ entry }) {
+  switch (entry.kind) {
+    case "note":
+      return /* @__PURE__ */ jsx13(DocNote, { entry });
+    case "tag":
+      return /* @__PURE__ */ jsx13(DocTag, { entry });
+    case "kv":
+      return /* @__PURE__ */ jsx13(DocKv, { entry });
+    case "code":
+      return /* @__PURE__ */ jsx13(DocCode, { entry });
+    case "table":
+      return /* @__PURE__ */ jsx13(DocTable, { entry });
+    case "link":
+      return /* @__PURE__ */ jsx13(DocLink, { entry });
+    case "section":
+      return /* @__PURE__ */ jsx13(DocSection, { entry });
+    case "mermaid":
+      return /* @__PURE__ */ jsx13(DocMermaid, { entry });
+    case "screenshot":
+      return /* @__PURE__ */ jsx13(DocScreenshot, { entry });
+    case "custom":
+      return /* @__PURE__ */ jsx13(DocCustom, { entry });
+  }
+}
+
+// src/components/ReportDocEntries.tsx
+import { Fragment as Fragment6, jsx as jsx14 } from "react/jsx-runtime";
+function ReportDocEntries({ entries }) {
+  if (entries.length === 0) return null;
+  return /* @__PURE__ */ jsx14(Fragment6, { children: entries.map((entry, i) => /* @__PURE__ */ jsx14(DocEntry, { entry }, i)) });
+}
+
+// src/components/ReportSteps.tsx
+import { jsx as jsx15, jsxs as jsxs9 } from "react/jsx-runtime";
+function ReportSteps({ scenario }) {
+  if (scenario.steps.length === 0) return null;
+  return /* @__PURE__ */ jsx15("ol", { className: "es-steps", children: scenario.steps.map((step) => /* @__PURE__ */ jsx15(ReportStepItem, { step }, step.id)) });
+}
+function ReportStepItem({ step }) {
+  return /* @__PURE__ */ jsxs9(
+    "li",
+    {
+      id: step.id,
+      className: `es-step es-step-${step.status}`,
+      "data-status": step.status,
+      children: [
+        /* @__PURE__ */ jsx15("span", { className: "es-step-keyword", children: step.keyword }),
+        /* @__PURE__ */ jsx15("span", { className: "es-step-text", children: step.text }),
+        step.errorMessage ? /* @__PURE__ */ jsx15("pre", { className: "es-scenario-error", role: "alert", children: step.errorMessage }) : null,
+        step.docEntries.length > 0 ? /* @__PURE__ */ jsx15("div", { className: "es-step-docs", children: /* @__PURE__ */ jsx15(ReportDocEntries, { entries: step.docEntries }) }) : null
+      ]
+    }
+  );
+}
+
+// src/components/ReportScenario.tsx
+import { jsx as jsx16, jsxs as jsxs10 } from "react/jsx-runtime";
+var STATUS_LABEL = {
+  passed: "Passed",
+  failed: "Failed",
+  skipped: "Skipped",
+  pending: "Pending"
+};
+function ReportScenario({ scenario }) {
+  const titleId = `${scenario.id}-title`;
+  return /* @__PURE__ */ jsxs10(
+    "article",
+    {
+      id: scenario.id,
+      className: `es-scenario es-status-${scenario.status}`,
+      "aria-labelledby": titleId,
+      "data-status": scenario.status,
+      children: [
+        /* @__PURE__ */ jsxs10("h3", { id: titleId, className: "es-scenario-title", children: [
+          /* @__PURE__ */ jsx16("span", { children: scenario.title }),
+          /* @__PURE__ */ jsx16("span", { className: "es-scenario-status", "aria-label": `Status: ${STATUS_LABEL[scenario.status]}`, children: STATUS_LABEL[scenario.status] })
+        ] }),
+        scenario.tags.length > 0 ? /* @__PURE__ */ jsx16("ul", { className: "es-tags", "aria-label": "Tags", children: scenario.tags.map((t) => /* @__PURE__ */ jsx16("li", { children: t }, t)) }) : null,
+        scenario.errorMessage ? /* @__PURE__ */ jsx16("pre", { className: "es-scenario-error", role: "alert", children: scenario.errorMessage }) : null,
+        scenario.docEntries.length > 0 ? /* @__PURE__ */ jsx16("div", { className: "es-scenario-docs", children: /* @__PURE__ */ jsx16(ReportDocEntries, { entries: scenario.docEntries }) }) : null,
+        /* @__PURE__ */ jsx16(ReportSteps, { scenario })
+      ]
+    }
+  );
+}
+
+// src/components/ReportScenarioList.tsx
+import { Fragment as Fragment7, jsx as jsx17 } from "react/jsx-runtime";
+function ReportScenarioList({ feature }) {
+  return /* @__PURE__ */ jsx17(Fragment7, { children: feature.scenarios.map((scenario) => /* @__PURE__ */ jsx17(ReportScenario, { scenario }, scenario.id)) });
+}
+
+// src/components/ReportFeature.tsx
+import { jsx as jsx18, jsxs as jsxs11 } from "react/jsx-runtime";
+function ReportFeature({ feature }) {
+  const titleId = `${feature.id}-title`;
+  return /* @__PURE__ */ jsxs11(
+    "section",
+    {
+      id: feature.id,
+      className: "es-feature",
+      "aria-labelledby": titleId,
+      children: [
+        /* @__PURE__ */ jsx18("h2", { id: titleId, className: "es-feature-title", children: feature.title }),
+        /* @__PURE__ */ jsx18("p", { className: "es-feature-source", children: feature.sourceFile }),
+        /* @__PURE__ */ jsx18(ReportSummaryView, { summary: feature.summary, className: "es-feature-summary" }),
+        /* @__PURE__ */ jsx18(ReportScenarioList, { feature })
+      ]
+    }
+  );
+}
+
+// src/components/ReportFeatureList.tsx
+import { Fragment as Fragment8, jsx as jsx19 } from "react/jsx-runtime";
+function ReportFeatureList() {
+  const report = useReport();
+  return /* @__PURE__ */ jsx19(Fragment8, { children: report.features.map((feature) => /* @__PURE__ */ jsx19(ReportFeature, { feature }, feature.id)) });
+}
+
+// src/components/ReportEmpty.tsx
+import { jsx as jsx20 } from "react/jsx-runtime";
+function ReportEmpty({ message }) {
+  return /* @__PURE__ */ jsx20("section", { className: "es-empty", "aria-live": "polite", children: /* @__PURE__ */ jsx20("p", { children: message ?? "No scenarios in this report." }) });
+}
+
+// src/components/ReportSchemaError.tsx
+import { jsx as jsx21, jsxs as jsxs12 } from "react/jsx-runtime";
+function ReportSchemaError({ error }) {
+  return /* @__PURE__ */ jsxs12("section", { className: "es-schema-error", role: "alert", "aria-live": "assertive", children: [
+    /* @__PURE__ */ jsx21("p", { children: /* @__PURE__ */ jsx21("strong", { children: "Report could not be displayed." }) }),
+    /* @__PURE__ */ jsx21("p", { children: error.message }),
+    error.code === "SCHEMA_VERSION_MISMATCH" ? /* @__PURE__ */ jsxs12("p", { children: [
+      "The report bundle is newer than this version of ",
+      /* @__PURE__ */ jsx21("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__ */ jsxs12("details", { children: [
+      /* @__PURE__ */ jsxs12("summary", { children: [
+        error.issues.length,
+        " validation issue",
+        error.issues.length === 1 ? "" : "s"
+      ] }),
+      /* @__PURE__ */ jsx21("pre", { children: error.issues.slice(0, 20).map((i) => `${i.path}: ${i.message}`).join("\n") })
+    ] }) : null
+  ] });
+}
+
+// src/components/Report.tsx
+import { jsx as jsx22, jsxs as jsxs13 } from "react/jsx-runtime";
+function isResult(value) {
+  return typeof value === "object" && value !== null && "ok" in value && typeof value.ok === "boolean";
+}
+function Report(props) {
+  const { report, customRenderers, renderers, className, title, dataTheme } = props;
+  if (isResult(report)) {
+    if (!report.ok) {
+      return /* @__PURE__ */ jsx22(
+        "main",
+        {
+          className: ["es-report", className].filter(Boolean).join(" "),
+          "aria-label": title ?? "Test report",
+          "data-theme": dataTheme,
+          children: /* @__PURE__ */ jsx22(ReportSchemaError, { error: report.error })
+        }
+      );
+    }
+    return /* @__PURE__ */ jsx22(
+      ReportView,
+      {
+        report: report.data,
+        customRenderers,
+        renderers,
+        className,
+        title,
+        dataTheme
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx22(
+    ReportView,
+    {
+      report,
+      customRenderers,
+      renderers,
+      className,
+      title,
+      dataTheme
+    }
+  );
+}
+function ReportView({
+  report,
+  customRenderers,
+  renderers,
+  className,
+  title,
+  dataTheme
+}) {
+  const hasContent = report.features.length > 0;
+  return /* @__PURE__ */ jsx22(ReportRoot, { report, customRenderers, renderers, children: /* @__PURE__ */ jsxs13(
+    "main",
+    {
+      className: ["es-report", className].filter(Boolean).join(" "),
+      "aria-label": title ?? "Test report",
+      "data-theme": dataTheme,
+      children: [
+        /* @__PURE__ */ jsxs13("header", { className: "es-report-header", children: [
+          /* @__PURE__ */ jsx22("h1", { children: title ?? "Story Report" }),
+          /* @__PURE__ */ jsx22(ReportSummary, {})
+        ] }),
+        hasContent ? /* @__PURE__ */ jsx22(ReportFeatureList, {}) : /* @__PURE__ */ jsx22(ReportEmpty, {})
+      ]
+    }
+  ) });
+}
+
+// src/result.ts
+var ok = (data) => ({ ok: true, data });
+var err = (error) => ({ ok: false, error });
+
+// src/schema/story-report.schema.ts
+import { z } from "zod";
+
+// ../executable-stories-formatters/schemas/story-report-v1.json
+var story_report_v1_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://executable-stories.dev/schemas/story-report-v1.schema.json",
+  title: "StoryReport",
+  description: "Pre-grouped, denormalized report shape consumed by UI renderers (React, Svelte, Vue, etc.). Stable public contract \u2014 additive-only within a major. Distinct from internal TestRunResult.",
+  type: "object",
+  $ref: "#/$defs/StoryReport",
+  $defs: {
+    StoryReport: {
+      type: "object",
+      description: "Top-level report containing all features, runtime metadata, and a pre-computed summary.",
+      properties: {
+        schemaVersion: {
+          type: "string",
+          pattern: "^1\\.[0-9]+$",
+          description: "Schema version as 'major.minor'. Major bumps are breaking; minors are additive-only. UI packages must accept any 1.x."
+        },
+        runId: {
+          type: "string",
+          minLength: 1,
+          description: "Unique deterministic identifier for this run."
+        },
+        startedAtMs: {
+          type: "number",
+          minimum: 0,
+          description: "Run start time as Unix epoch milliseconds."
+        },
+        finishedAtMs: {
+          type: "number",
+          minimum: 0,
+          description: "Run finish time as Unix epoch milliseconds."
+        },
+        durationMs: {
+          type: "number",
+          minimum: 0,
+          description: "Total run duration in milliseconds."
+        },
+        projectRoot: {
+          type: "string",
+          minLength: 1,
+          description: "Absolute path to the project root (for context only; relative paths in features.sourceFile are preferred)."
+        },
+        packageVersion: {
+          type: "string",
+          description: "Version of the package under test, if known."
+        },
+        gitSha: {
+          type: "string",
+          description: "Git commit SHA at the time of the run."
+        },
+        ci: {
+          $ref: "#/$defs/CIInfo"
+        },
+        coverage: {
+          $ref: "#/$defs/CoverageSummary"
+        },
+        summary: {
+          $ref: "#/$defs/Summary",
+          description: "Pre-computed counts across all features and scenarios."
+        },
+        features: {
+          type: "array",
+          items: { $ref: "#/$defs/Feature" },
+          description: "Features grouped by sourceFile, sorted by title."
+        }
+      },
+      required: ["schemaVersion", "runId", "startedAtMs", "finishedAtMs", "durationMs", "projectRoot", "summary", "features"],
+      additionalProperties: false
+    },
+    Summary: {
+      type: "object",
+      description: "Counts by status. Sums equal 'total'.",
+      properties: {
+        total: { type: "integer", minimum: 0 },
+        passed: { type: "integer", minimum: 0 },
+        failed: { type: "integer", minimum: 0 },
+        skipped: { type: "integer", minimum: 0 },
+        pending: { type: "integer", minimum: 0 },
+        durationMs: { type: "number", minimum: 0 }
+      },
+      required: ["total", "passed", "failed", "skipped", "pending", "durationMs"],
+      additionalProperties: false
+    },
+    Feature: {
+      type: "object",
+      description: "A group of scenarios from the same source file.",
+      properties: {
+        id: {
+          type: "string",
+          minLength: 1,
+          description: "Stable slug derived from the relative source path. Suitable for use as a deep-link anchor."
+        },
+        title: {
+          type: "string",
+          minLength: 1,
+          description: "Display title. Derived from describe block when present, otherwise the file basename."
+        },
+        sourceFile: {
+          type: "string",
+          minLength: 1,
+          description: "Source path, relative to projectRoot when possible."
+        },
+        summary: { $ref: "#/$defs/Summary" },
+        scenarios: {
+          type: "array",
+          items: { $ref: "#/$defs/Scenario" },
+          description: "Scenarios in this feature, in declaration order."
+        }
+      },
+      required: ["id", "title", "sourceFile", "summary", "scenarios"],
+      additionalProperties: false
+    },
+    Scenario: {
+      type: "object",
+      description: "A single scenario with its steps, story-level doc entries, and attachments.",
+      properties: {
+        id: {
+          type: "string",
+          minLength: 1,
+          description: "Stable identifier: '<feature.id>--<slug-of-title>'. Suitable for use as a deep-link anchor."
+        },
+        title: { type: "string", minLength: 1 },
+        status: { $ref: "#/$defs/TestStatus" },
+        durationMs: { type: "number", minimum: 0 },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Normalized tags, deduplicated, lowercased."
+        },
+        tickets: {
+          type: "array",
+          items: { $ref: "#/$defs/Ticket" }
+        },
+        sourceLine: { type: "integer", minimum: 1 },
+        errorMessage: { type: "string" },
+        errorStack: { type: "string" },
+        retry: { type: "integer", minimum: 0 },
+        retries: { type: "integer", minimum: 0 },
+        docEntries: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" },
+          description: "Story-level doc entries (rendered before steps)."
+        },
+        steps: {
+          type: "array",
+          items: { $ref: "#/$defs/Step" }
+        },
+        attachments: {
+          type: "array",
+          items: { $ref: "#/$defs/Attachment" }
+        }
+      },
+      required: ["id", "title", "status", "durationMs", "tags", "retry", "retries", "docEntries", "steps", "attachments"],
+      additionalProperties: false
+    },
+    Step: {
+      type: "object",
+      description: "A single BDD step.",
+      properties: {
+        id: { type: "string", minLength: 1 },
+        index: { type: "integer", minimum: 0 },
+        keyword: { $ref: "#/$defs/StepKeyword" },
+        text: { type: "string" },
+        status: { $ref: "#/$defs/TestStatus" },
+        durationMs: { type: "number", minimum: 0 },
+        errorMessage: { type: "string" },
+        mode: { $ref: "#/$defs/StepMode" },
+        docEntries: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" },
+          description: "Doc entries attached to this step."
+        }
+      },
+      required: ["id", "index", "keyword", "text", "status", "durationMs", "docEntries"],
+      additionalProperties: false
+    },
+    StepKeyword: {
+      type: "string",
+      enum: ["Given", "When", "Then", "And", "But"]
+    },
+    StepMode: {
+      type: "string",
+      enum: ["normal", "skip", "only", "todo", "fails", "concurrent"]
+    },
+    TestStatus: {
+      type: "string",
+      enum: ["passed", "failed", "skipped", "pending"]
+    },
+    Ticket: {
+      type: "object",
+      properties: {
+        id: { type: "string", minLength: 1 },
+        url: { type: "string" }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    Attachment: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        mediaType: { type: "string", minLength: 1 },
+        body: { type: "string" },
+        contentEncoding: {
+          type: "string",
+          enum: ["BASE64", "IDENTITY"]
+        }
+      },
+      required: ["name", "mediaType", "body", "contentEncoding"],
+      additionalProperties: false
+    },
+    CIInfo: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        url: { type: "string" },
+        buildNumber: { type: "string" },
+        branch: { type: "string" },
+        commitSha: { type: "string" },
+        prNumber: { type: "string" }
+      },
+      required: ["name"],
+      additionalProperties: false
+    },
+    CoverageSummary: {
+      type: "object",
+      properties: {
+        linesPct: { type: "number", minimum: 0, maximum: 100 },
+        branchesPct: { type: "number", minimum: 0, maximum: 100 },
+        functionsPct: { type: "number", minimum: 0, maximum: 100 },
+        statementsPct: { type: "number", minimum: 0, maximum: 100 }
+      },
+      additionalProperties: false
+    },
+    DocPhase: {
+      type: "string",
+      enum: ["static", "runtime"]
+    },
+    DocEntry: {
+      oneOf: [
+        { $ref: "#/$defs/DocNote" },
+        { $ref: "#/$defs/DocTag" },
+        { $ref: "#/$defs/DocKv" },
+        { $ref: "#/$defs/DocCode" },
+        { $ref: "#/$defs/DocTable" },
+        { $ref: "#/$defs/DocLink" },
+        { $ref: "#/$defs/DocSection" },
+        { $ref: "#/$defs/DocMermaid" },
+        { $ref: "#/$defs/DocScreenshot" },
+        { $ref: "#/$defs/DocCustom" }
+      ]
+    },
+    DocNote: {
+      type: "object",
+      properties: {
+        kind: { const: "note" },
+        text: { type: "string" },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "text", "phase"],
+      additionalProperties: false
+    },
+    DocTag: {
+      type: "object",
+      properties: {
+        kind: { const: "tag" },
+        names: { type: "array", items: { type: "string" } },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "names", "phase"],
+      additionalProperties: false
+    },
+    DocKv: {
+      type: "object",
+      properties: {
+        kind: { const: "kv" },
+        label: { type: "string" },
+        value: {},
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "label", "value", "phase"],
+      additionalProperties: false
+    },
+    DocCode: {
+      type: "object",
+      properties: {
+        kind: { const: "code" },
+        label: { type: "string" },
+        content: { type: "string" },
+        lang: { type: "string" },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "label", "content", "phase"],
+      additionalProperties: false
+    },
+    DocTable: {
+      type: "object",
+      properties: {
+        kind: { const: "table" },
+        label: { type: "string" },
+        columns: { type: "array", items: { type: "string" } },
+        rows: {
+          type: "array",
+          items: {
+            type: "array",
+            items: { type: "string" }
+          }
+        },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "label", "columns", "rows", "phase"],
+      additionalProperties: false
+    },
+    DocLink: {
+      type: "object",
+      properties: {
+        kind: { const: "link" },
+        label: { type: "string" },
+        url: { type: "string" },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "label", "url", "phase"],
+      additionalProperties: false
+    },
+    DocSection: {
+      type: "object",
+      properties: {
+        kind: { const: "section" },
+        title: { type: "string" },
+        markdown: { type: "string" },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "title", "markdown", "phase"],
+      additionalProperties: false
+    },
+    DocMermaid: {
+      type: "object",
+      properties: {
+        kind: { const: "mermaid" },
+        code: { type: "string" },
+        title: { type: "string" },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "code", "phase"],
+      additionalProperties: false
+    },
+    DocScreenshot: {
+      type: "object",
+      properties: {
+        kind: { const: "screenshot" },
+        path: { type: "string" },
+        alt: { type: "string" },
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "path", "phase"],
+      additionalProperties: false
+    },
+    DocCustom: {
+      type: "object",
+      properties: {
+        kind: { const: "custom" },
+        type: { type: "string", minLength: 1 },
+        data: {},
+        phase: { $ref: "#/$defs/DocPhase" },
+        children: {
+          type: "array",
+          items: { $ref: "#/$defs/DocEntry" }
+        }
+      },
+      required: ["kind", "type", "data", "phase"],
+      additionalProperties: false
+    }
+  }
+};
+
+// src/schema/story-report.schema.ts
+var compiled = z.fromJSONSchema(story_report_v1_default);
+var storyReportSchema = compiled;
+var STORY_REPORT_SCHEMA_MAJOR = 1;
+
+// src/schema/parse.ts
+function parseStoryReport(input) {
+  if (input === null || typeof input !== "object") {
+    return err({
+      message: "Expected a StoryReport object.",
+      code: "INVALID_INPUT"
+    });
+  }
+  const versionRaw = input.schemaVersion;
+  if (typeof versionRaw === "string") {
+    const major = versionRaw.split(".")[0];
+    if (major !== String(STORY_REPORT_SCHEMA_MAJOR)) {
+      return err({
+        message: `Schema major ${major} is not supported by this version of executable-stories-react (expected ${STORY_REPORT_SCHEMA_MAJOR}.x). Upgrade the package.`,
+        code: "SCHEMA_VERSION_MISMATCH"
+      });
+    }
+  }
+  const parsed = storyReportSchema.safeParse(input);
+  if (parsed.success) {
+    return ok(parsed.data);
+  }
+  const issues = parsed.error.issues.map((i) => ({
+    path: i.path.join(".") || "/",
+    message: i.message
+  }));
+  return err({
+    message: `StoryReport failed validation (${issues.length} issue${issues.length === 1 ? "" : "s"}).`,
+    code: "VALIDATION_FAILED",
+    issues
+  });
+}
+export {
+  DocCode,
+  DocCustom,
+  DocEntry,
+  DocKv,
+  DocLink,
+  DocMermaid,
+  DocNote,
+  DocScreenshot,
+  DocSection,
+  DocTable,
+  DocTag,
+  Report,
+  ReportDocEntries,
+  ReportEmpty,
+  ReportFeature,
+  ReportFeatureList,
+  ReportRoot,
+  ReportScenario,
+  ReportScenarioList,
+  ReportSchemaError,
+  ReportStepItem,
+  ReportSteps,
+  ReportSummary,
+  ReportSummaryView,
+  STORY_REPORT_SCHEMA_MAJOR,
+  err,
+  ok,
+  parseStoryReport,
+  storyReportSchema,
+  useBuiltinRenderers,
+  useCustomRenderers,
+  useReport
+};
+//# sourceMappingURL=index.js.map