executable-stories-react 0.1.0

package/dist/parse.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse-entry.ts","../src/result.ts","../src/schema/story-report.schema.ts","../../executable-stories-formatters/schemas/story-report-v1.json","../src/schema/parse.ts"],"sourcesContent":["/**\n * Server-safe entry: parseStoryReport, Result types, schema constants.\n *\n * No React, no hooks, no client-only code. Safe to call from Next.js Server\n * Components, build scripts, edge functions, or anywhere else outside the\n * browser. The main \"executable-stories-react\" entry is marked \"use client\"\n * because it touches createContext; this entry stays clean.\n */\n\nexport { parseStoryReport } from \"./schema/parse\";\nexport { storyReportSchema, STORY_REPORT_SCHEMA_MAJOR } from \"./schema/story-report.schema\";\nexport type { Result, ReportParseError, ReportParseErrorCode } from \"./result\";\nexport { ok, err } from \"./result\";\nexport type {\n  StoryReport,\n  ReportFeature as StoryReportFeature,\n  ReportScenario as StoryReportScenario,\n  ReportStep as StoryReportStep,\n  ReportDocEntry as StoryReportDocEntry,\n  ReportSummary as StoryReportSummary,\n} from \"executable-stories-formatters\";\n","/**\n * Result<T> — explicit success/error type matching the cookbook convention.\n *\n * Used at the boundary where a StoryReport is parsed: the consumer hands us\n * an unknown value (file contents, fetch body, prop) and we return a Result.\n */\n\nexport type Result<T, E = ReportParseError> =\n  | { ok: true; data: T }\n  | { ok: false; error: E };\n\nexport interface ReportParseError {\n  message: string;\n  code: ReportParseErrorCode;\n  issues?: readonly { path: string; message: string }[];\n}\n\nexport type ReportParseErrorCode =\n  | \"INVALID_INPUT\"\n  | \"SCHEMA_VERSION_MISMATCH\"\n  | \"VALIDATION_FAILED\";\n\nexport const ok = <T>(data: T): Result<T> => ({ ok: true, data });\nexport const err = (error: ReportParseError): Result<never> => ({ ok: false, error });\n","/**\n * StoryReport runtime Zod schema, derived from the canonical JSON Schema\n * at executable-stories-formatters/schemas/story-report-v1.json.\n *\n * Uses z.fromJSONSchema (experimental in Zod 4.x). If the API changes upstream,\n * only this file needs updating — the rest of the package consumes\n * `storyReportSchema` and `StoryReportSchemaShape` via parse.ts.\n *\n * The JSON Schema is bundled at build time by tsup (resolveJsonModule).\n */\n\nimport { z } from \"zod\";\nimport schemaJson from \"../../../executable-stories-formatters/schemas/story-report-v1.json\" with { type: \"json\" };\n\nconst compiled = z.fromJSONSchema(schemaJson as Parameters<typeof z.fromJSONSchema>[0]);\n\nexport const storyReportSchema = compiled;\nexport type StoryReportSchemaShape = z.infer<typeof compiled>;\n\nexport const STORY_REPORT_SCHEMA_MAJOR = 1 as const;\n","{\n  \"$schema\": \"https://json-schema.org/draft/2020-12/schema\",\n  \"$id\": \"https://executable-stories.dev/schemas/story-report-v1.schema.json\",\n  \"title\": \"StoryReport\",\n  \"description\": \"Pre-grouped, denormalized report shape consumed by UI renderers (React, Svelte, Vue, etc.). Stable public contract — additive-only within a major. Distinct from internal TestRunResult.\",\n  \"type\": \"object\",\n  \"$ref\": \"#/$defs/StoryReport\",\n  \"$defs\": {\n    \"StoryReport\": {\n      \"type\": \"object\",\n      \"description\": \"Top-level report containing all features, runtime metadata, and a pre-computed summary.\",\n      \"properties\": {\n        \"schemaVersion\": {\n          \"type\": \"string\",\n          \"pattern\": \"^1\\\\.[0-9]+$\",\n          \"description\": \"Schema version as 'major.minor'. Major bumps are breaking; minors are additive-only. UI packages must accept any 1.x.\"\n        },\n        \"runId\": {\n          \"type\": \"string\",\n          \"minLength\": 1,\n          \"description\": \"Unique deterministic identifier for this run.\"\n        },\n        \"startedAtMs\": {\n          \"type\": \"number\",\n          \"minimum\": 0,\n          \"description\": \"Run start time as Unix epoch milliseconds.\"\n        },\n        \"finishedAtMs\": {\n          \"type\": \"number\",\n          \"minimum\": 0,\n          \"description\": \"Run finish time as Unix epoch milliseconds.\"\n        },\n        \"durationMs\": {\n          \"type\": \"number\",\n          \"minimum\": 0,\n          \"description\": \"Total run duration in milliseconds.\"\n        },\n        \"projectRoot\": {\n          \"type\": \"string\",\n          \"minLength\": 1,\n          \"description\": \"Absolute path to the project root (for context only; relative paths in features.sourceFile are preferred).\"\n        },\n        \"packageVersion\": {\n          \"type\": \"string\",\n          \"description\": \"Version of the package under test, if known.\"\n        },\n        \"gitSha\": {\n          \"type\": \"string\",\n          \"description\": \"Git commit SHA at the time of the run.\"\n        },\n        \"ci\": {\n          \"$ref\": \"#/$defs/CIInfo\"\n        },\n        \"coverage\": {\n          \"$ref\": \"#/$defs/CoverageSummary\"\n        },\n        \"summary\": {\n          \"$ref\": \"#/$defs/Summary\",\n          \"description\": \"Pre-computed counts across all features and scenarios.\"\n        },\n        \"features\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/Feature\" },\n          \"description\": \"Features grouped by sourceFile, sorted by title.\"\n        }\n      },\n      \"required\": [\"schemaVersion\", \"runId\", \"startedAtMs\", \"finishedAtMs\", \"durationMs\", \"projectRoot\", \"summary\", \"features\"],\n      \"additionalProperties\": false\n    },\n    \"Summary\": {\n      \"type\": \"object\",\n      \"description\": \"Counts by status. Sums equal 'total'.\",\n      \"properties\": {\n        \"total\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"passed\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"failed\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"skipped\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"pending\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"durationMs\": { \"type\": \"number\", \"minimum\": 0 }\n      },\n      \"required\": [\"total\", \"passed\", \"failed\", \"skipped\", \"pending\", \"durationMs\"],\n      \"additionalProperties\": false\n    },\n    \"Feature\": {\n      \"type\": \"object\",\n      \"description\": \"A group of scenarios from the same source file.\",\n      \"properties\": {\n        \"id\": {\n          \"type\": \"string\",\n          \"minLength\": 1,\n          \"description\": \"Stable slug derived from the relative source path. Suitable for use as a deep-link anchor.\"\n        },\n        \"title\": {\n          \"type\": \"string\",\n          \"minLength\": 1,\n          \"description\": \"Display title. Derived from describe block when present, otherwise the file basename.\"\n        },\n        \"sourceFile\": {\n          \"type\": \"string\",\n          \"minLength\": 1,\n          \"description\": \"Source path, relative to projectRoot when possible.\"\n        },\n        \"summary\": { \"$ref\": \"#/$defs/Summary\" },\n        \"scenarios\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/Scenario\" },\n          \"description\": \"Scenarios in this feature, in declaration order.\"\n        }\n      },\n      \"required\": [\"id\", \"title\", \"sourceFile\", \"summary\", \"scenarios\"],\n      \"additionalProperties\": false\n    },\n    \"Scenario\": {\n      \"type\": \"object\",\n      \"description\": \"A single scenario with its steps, story-level doc entries, and attachments.\",\n      \"properties\": {\n        \"id\": {\n          \"type\": \"string\",\n          \"minLength\": 1,\n          \"description\": \"Stable identifier: '<feature.id>--<slug-of-title>'. Suitable for use as a deep-link anchor.\"\n        },\n        \"title\": { \"type\": \"string\", \"minLength\": 1 },\n        \"status\": { \"$ref\": \"#/$defs/TestStatus\" },\n        \"durationMs\": { \"type\": \"number\", \"minimum\": 0 },\n        \"tags\": {\n          \"type\": \"array\",\n          \"items\": { \"type\": \"string\" },\n          \"description\": \"Normalized tags, deduplicated, lowercased.\"\n        },\n        \"tickets\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/Ticket\" }\n        },\n        \"sourceLine\": { \"type\": \"integer\", \"minimum\": 1 },\n        \"errorMessage\": { \"type\": \"string\" },\n        \"errorStack\": { \"type\": \"string\" },\n        \"retry\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"retries\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"docEntries\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" },\n          \"description\": \"Story-level doc entries (rendered before steps).\"\n        },\n        \"steps\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/Step\" }\n        },\n        \"attachments\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/Attachment\" }\n        }\n      },\n      \"required\": [\"id\", \"title\", \"status\", \"durationMs\", \"tags\", \"retry\", \"retries\", \"docEntries\", \"steps\", \"attachments\"],\n      \"additionalProperties\": false\n    },\n    \"Step\": {\n      \"type\": \"object\",\n      \"description\": \"A single BDD step.\",\n      \"properties\": {\n        \"id\": { \"type\": \"string\", \"minLength\": 1 },\n        \"index\": { \"type\": \"integer\", \"minimum\": 0 },\n        \"keyword\": { \"$ref\": \"#/$defs/StepKeyword\" },\n        \"text\": { \"type\": \"string\" },\n        \"status\": { \"$ref\": \"#/$defs/TestStatus\" },\n        \"durationMs\": { \"type\": \"number\", \"minimum\": 0 },\n        \"errorMessage\": { \"type\": \"string\" },\n        \"mode\": { \"$ref\": \"#/$defs/StepMode\" },\n        \"docEntries\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" },\n          \"description\": \"Doc entries attached to this step.\"\n        }\n      },\n      \"required\": [\"id\", \"index\", \"keyword\", \"text\", \"status\", \"durationMs\", \"docEntries\"],\n      \"additionalProperties\": false\n    },\n    \"StepKeyword\": {\n      \"type\": \"string\",\n      \"enum\": [\"Given\", \"When\", \"Then\", \"And\", \"But\"]\n    },\n    \"StepMode\": {\n      \"type\": \"string\",\n      \"enum\": [\"normal\", \"skip\", \"only\", \"todo\", \"fails\", \"concurrent\"]\n    },\n    \"TestStatus\": {\n      \"type\": \"string\",\n      \"enum\": [\"passed\", \"failed\", \"skipped\", \"pending\"]\n    },\n    \"Ticket\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"id\": { \"type\": \"string\", \"minLength\": 1 },\n        \"url\": { \"type\": \"string\" }\n      },\n      \"required\": [\"id\"],\n      \"additionalProperties\": false\n    },\n    \"Attachment\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"name\": { \"type\": \"string\" },\n        \"mediaType\": { \"type\": \"string\", \"minLength\": 1 },\n        \"body\": { \"type\": \"string\" },\n        \"contentEncoding\": {\n          \"type\": \"string\",\n          \"enum\": [\"BASE64\", \"IDENTITY\"]\n        }\n      },\n      \"required\": [\"name\", \"mediaType\", \"body\", \"contentEncoding\"],\n      \"additionalProperties\": false\n    },\n    \"CIInfo\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"name\": { \"type\": \"string\" },\n        \"url\": { \"type\": \"string\" },\n        \"buildNumber\": { \"type\": \"string\" },\n        \"branch\": { \"type\": \"string\" },\n        \"commitSha\": { \"type\": \"string\" },\n        \"prNumber\": { \"type\": \"string\" }\n      },\n      \"required\": [\"name\"],\n      \"additionalProperties\": false\n    },\n    \"CoverageSummary\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"linesPct\": { \"type\": \"number\", \"minimum\": 0, \"maximum\": 100 },\n        \"branchesPct\": { \"type\": \"number\", \"minimum\": 0, \"maximum\": 100 },\n        \"functionsPct\": { \"type\": \"number\", \"minimum\": 0, \"maximum\": 100 },\n        \"statementsPct\": { \"type\": \"number\", \"minimum\": 0, \"maximum\": 100 }\n      },\n      \"additionalProperties\": false\n    },\n    \"DocPhase\": {\n      \"type\": \"string\",\n      \"enum\": [\"static\", \"runtime\"]\n    },\n    \"DocEntry\": {\n      \"oneOf\": [\n        { \"$ref\": \"#/$defs/DocNote\" },\n        { \"$ref\": \"#/$defs/DocTag\" },\n        { \"$ref\": \"#/$defs/DocKv\" },\n        { \"$ref\": \"#/$defs/DocCode\" },\n        { \"$ref\": \"#/$defs/DocTable\" },\n        { \"$ref\": \"#/$defs/DocLink\" },\n        { \"$ref\": \"#/$defs/DocSection\" },\n        { \"$ref\": \"#/$defs/DocMermaid\" },\n        { \"$ref\": \"#/$defs/DocScreenshot\" },\n        { \"$ref\": \"#/$defs/DocCustom\" }\n      ]\n    },\n    \"DocNote\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"note\" },\n        \"text\": { \"type\": \"string\" },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"text\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocTag\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"tag\" },\n        \"names\": { \"type\": \"array\", \"items\": { \"type\": \"string\" } },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"names\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocKv\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"kv\" },\n        \"label\": { \"type\": \"string\" },\n        \"value\": {},\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"label\", \"value\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocCode\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"code\" },\n        \"label\": { \"type\": \"string\" },\n        \"content\": { \"type\": \"string\" },\n        \"lang\": { \"type\": \"string\" },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"label\", \"content\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocTable\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"table\" },\n        \"label\": { \"type\": \"string\" },\n        \"columns\": { \"type\": \"array\", \"items\": { \"type\": \"string\" } },\n        \"rows\": {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\": \"array\",\n            \"items\": { \"type\": \"string\" }\n          }\n        },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"label\", \"columns\", \"rows\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocLink\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"link\" },\n        \"label\": { \"type\": \"string\" },\n        \"url\": { \"type\": \"string\" },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"label\", \"url\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocSection\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"section\" },\n        \"title\": { \"type\": \"string\" },\n        \"markdown\": { \"type\": \"string\" },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"title\", \"markdown\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocMermaid\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"mermaid\" },\n        \"code\": { \"type\": \"string\" },\n        \"title\": { \"type\": \"string\" },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"code\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocScreenshot\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"screenshot\" },\n        \"path\": { \"type\": \"string\" },\n        \"alt\": { \"type\": \"string\" },\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"path\", \"phase\"],\n      \"additionalProperties\": false\n    },\n    \"DocCustom\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"kind\": { \"const\": \"custom\" },\n        \"type\": { \"type\": \"string\", \"minLength\": 1 },\n        \"data\": {},\n        \"phase\": { \"$ref\": \"#/$defs/DocPhase\" },\n        \"children\": {\n          \"type\": \"array\",\n          \"items\": { \"$ref\": \"#/$defs/DocEntry\" }\n        }\n      },\n      \"required\": [\"kind\", \"type\", \"data\", \"phase\"],\n      \"additionalProperties\": false\n    }\n  }\n}\n","/**\n * parseStoryReport — boundary validator. Accepts unknown input (file contents,\n * fetch body, prop) and returns a Result-typed StoryReport.\n */\n\nimport type { StoryReport } from \"executable-stories-formatters\";\nimport type { Result } from \"../result\";\nimport { ok, err } from \"../result\";\nimport { storyReportSchema, STORY_REPORT_SCHEMA_MAJOR } from \"./story-report.schema\";\n\nexport function parseStoryReport(input: unknown): Result<StoryReport> {\n  if (input === null || typeof input !== \"object\") {\n    return err({\n      message: \"Expected a StoryReport object.\",\n      code: \"INVALID_INPUT\",\n    });\n  }\n\n  const versionRaw = (input as { schemaVersion?: unknown }).schemaVersion;\n  if (typeof versionRaw === \"string\") {\n    const major = versionRaw.split(\".\")[0];\n    if (major !== String(STORY_REPORT_SCHEMA_MAJOR)) {\n      return err({\n        message: `Schema major ${major} is not supported by this version of executable-stories-react (expected ${STORY_REPORT_SCHEMA_MAJOR}.x). Upgrade the package.`,\n        code: \"SCHEMA_VERSION_MISMATCH\",\n      });\n    }\n  }\n\n  const parsed = storyReportSchema.safeParse(input);\n  if (parsed.success) {\n    return ok(parsed.data as StoryReport);\n  }\n\n  const issues = parsed.error.issues.map((i) => ({\n    path: i.path.join(\".\") || \"/\",\n    message: i.message,\n  }));\n\n  return err({\n    message: `StoryReport failed validation (${issues.length} issue${issues.length === 1 ? \"\" : \"s\"}).`,\n    code: \"VALIDATION_FAILED\",\n    issues,\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/parse.d.cts

@@ -0,0 +1,51 @@
+import { StoryReport } from 'executable-stories-formatters';
+export { StoryReport, ReportDocEntry as StoryReportDocEntry, ReportFeature as StoryReportFeature, ReportScenario as StoryReportScenario, ReportStep as StoryReportStep, ReportSummary as StoryReportSummary } from 'executable-stories-formatters';
+import { z } from 'zod';
+
+/**
+ * Result<T> — explicit success/error type matching the cookbook convention.
+ *
+ * Used at the boundary where a StoryReport is parsed: the consumer hands us
+ * an unknown value (file contents, fetch body, prop) and we return a Result.
+ */
+type Result<T, E = ReportParseError> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: E;
+};
+interface ReportParseError {
+    message: string;
+    code: ReportParseErrorCode;
+    issues?: readonly {
+        path: string;
+        message: string;
+    }[];
+}
+type ReportParseErrorCode = "INVALID_INPUT" | "SCHEMA_VERSION_MISMATCH" | "VALIDATION_FAILED";
+declare const ok: <T>(data: T) => Result<T>;
+declare const err: (error: ReportParseError) => Result<never>;
+
+/**
+ * parseStoryReport — boundary validator. Accepts unknown input (file contents,
+ * fetch body, prop) and returns a Result-typed StoryReport.
+ */
+
+declare function parseStoryReport(input: unknown): Result<StoryReport>;
+
+/**
+ * StoryReport runtime Zod schema, derived from the canonical JSON Schema
+ * at executable-stories-formatters/schemas/story-report-v1.json.
+ *
+ * Uses z.fromJSONSchema (experimental in Zod 4.x). If the API changes upstream,
+ * only this file needs updating — the rest of the package consumes
+ * `storyReportSchema` and `StoryReportSchemaShape` via parse.ts.
+ *
+ * The JSON Schema is bundled at build time by tsup (resolveJsonModule).
+ */
+
+declare const storyReportSchema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+declare const STORY_REPORT_SCHEMA_MAJOR: 1;
+
+export { type ReportParseError, type ReportParseErrorCode, type Result, STORY_REPORT_SCHEMA_MAJOR, err, ok, parseStoryReport, storyReportSchema };

package/dist/parse.d.ts

@@ -0,0 +1,51 @@
+import { StoryReport } from 'executable-stories-formatters';
+export { StoryReport, ReportDocEntry as StoryReportDocEntry, ReportFeature as StoryReportFeature, ReportScenario as StoryReportScenario, ReportStep as StoryReportStep, ReportSummary as StoryReportSummary } from 'executable-stories-formatters';
+import { z } from 'zod';
+
+/**
+ * Result<T> — explicit success/error type matching the cookbook convention.
+ *
+ * Used at the boundary where a StoryReport is parsed: the consumer hands us
+ * an unknown value (file contents, fetch body, prop) and we return a Result.
+ */
+type Result<T, E = ReportParseError> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: E;
+};
+interface ReportParseError {
+    message: string;
+    code: ReportParseErrorCode;
+    issues?: readonly {
+        path: string;
+        message: string;
+    }[];
+}
+type ReportParseErrorCode = "INVALID_INPUT" | "SCHEMA_VERSION_MISMATCH" | "VALIDATION_FAILED";
+declare const ok: <T>(data: T) => Result<T>;
+declare const err: (error: ReportParseError) => Result<never>;
+
+/**
+ * parseStoryReport — boundary validator. Accepts unknown input (file contents,
+ * fetch body, prop) and returns a Result-typed StoryReport.
+ */
+
+declare function parseStoryReport(input: unknown): Result<StoryReport>;
+
+/**
+ * StoryReport runtime Zod schema, derived from the canonical JSON Schema
+ * at executable-stories-formatters/schemas/story-report-v1.json.
+ *
+ * Uses z.fromJSONSchema (experimental in Zod 4.x). If the API changes upstream,
+ * only this file needs updating — the rest of the package consumes
+ * `storyReportSchema` and `StoryReportSchemaShape` via parse.ts.
+ *
+ * The JSON Schema is bundled at build time by tsup (resolveJsonModule).
+ */
+
+declare const storyReportSchema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+declare const STORY_REPORT_SCHEMA_MAJOR: 1;
+
+export { type ReportParseError, type ReportParseErrorCode, type Result, STORY_REPORT_SCHEMA_MAJOR, err, ok, parseStoryReport, storyReportSchema };

package/dist/parse.js

@@ -0,0 +1,464 @@
+// 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 {
+  STORY_REPORT_SCHEMA_MAJOR,
+  err,
+  ok,
+  parseStoryReport,
+  storyReportSchema
+};
+//# sourceMappingURL=parse.js.map