executable-stories-cypress 2.0.0

package/dist/plugin.js

@@ -0,0 +1,34 @@
+// src/store.ts
+function key(specRelative, titlePath) {
+  return `${specRelative}\0${titlePath.join("\0")}`;
+}
+var store = /* @__PURE__ */ new Map();
+function recordMeta(payload) {
+  store.set(key(payload.specRelative, payload.titlePath), {
+    specRelative: payload.specRelative,
+    titlePath: payload.titlePath,
+    meta: payload.meta,
+    attachments: payload.attachments
+  });
+  return null;
+}
+function getMeta(specRelative, titlePath) {
+  return store.get(key(specRelative, titlePath))?.meta;
+}
+
+// src/plugin.ts
+var TASK_NAME = "executableStories:recordMeta";
+var GET_STORED_META_TASK = "executableStories:getStoredMeta";
+function registerExecutableStoriesPlugin(on) {
+  on("task", {
+    [TASK_NAME]: (payload) => recordMeta(payload),
+    [GET_STORED_META_TASK]: (arg) => {
+      const { specRelative, titlePath } = arg;
+      return getMeta(specRelative, titlePath) ?? null;
+    }
+  });
+}
+export {
+  registerExecutableStoriesPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store.ts","../src/plugin.ts"],"sourcesContent":["/**\n * Node-only store for story meta sent from the browser via cy.task.\n * Plugin writes; reporter reads. Keyed by spec + titlePath for merging with run results.\n */\n\nimport type { StoryMeta, ScopedAttachment, RecordMetaPayload } from \"./types\";\n\nexport interface StoredMeta {\n  specRelative: string;\n  titlePath: string[];\n  meta: StoryMeta;\n  attachments?: ScopedAttachment[];\n}\n\nfunction key(specRelative: string, titlePath: string[]): string {\n  return `${specRelative}\\0${titlePath.join(\"\\0\")}`;\n}\n\nconst store = new Map<string, StoredMeta>();\n\nexport function recordMeta(payload: RecordMetaPayload): null {\n  store.set(key(payload.specRelative, payload.titlePath), {\n    specRelative: payload.specRelative,\n    titlePath: payload.titlePath,\n    meta: payload.meta,\n    attachments: payload.attachments,\n  });\n  return null;\n}\n\nexport function getAttachments(specRelative: string, titlePath: string[]): ScopedAttachment[] | undefined {\n  return store.get(key(specRelative, titlePath))?.attachments;\n}\n\nexport function getMeta(specRelative: string, titlePath: string[]): StoryMeta | undefined {\n  return store.get(key(specRelative, titlePath))?.meta;\n}\n\nexport function getAllMeta(): StoredMeta[] {\n  return Array.from(store.values());\n}\n\nexport function clearStore(): void {\n  store.clear();\n}\n","/**\n * Cypress Node plugin: registers the task that receives story meta from the browser.\n * Use in cypress.config.ts (or plugins file) so the reporter can merge meta with run results.\n *\n * @example\n * // cypress.config.ts\n * import { defineConfig } from 'cypress';\n * import { registerExecutableStoriesPlugin } from 'executable-stories-cypress/plugin';\n *\n * export default defineConfig({\n *   e2e: {\n *     setupNodeEvents(on) {\n *       registerExecutableStoriesPlugin(on);\n *     },\n *   },\n * });\n */\n\nimport { recordMeta, getMeta } from \"./store\";\n\nconst TASK_NAME = \"executableStories:recordMeta\";\nconst GET_STORED_META_TASK = \"executableStories:getStoredMeta\";\n\n/** Minimal type for Cypress plugin `on` (task registration) */\nexport interface PluginEvents {\n  (event: \"task\", tasks: Record<string, (arg: unknown) => unknown>): void;\n}\n\n/**\n * Register the executable-stories task on the Cypress `on` handler.\n * Call this from setupNodeEvents in your Cypress config.\n */\n/** Argument for getStoredMeta task (used by tests to assert on recorded meta). */\nexport interface GetStoredMetaArg {\n  specRelative: string;\n  titlePath: string[];\n}\n\nexport function registerExecutableStoriesPlugin(on: PluginEvents): void {\n  on(\"task\", {\n    [TASK_NAME]: (payload: unknown) => recordMeta(payload as import(\"./types\").RecordMetaPayload),\n    [GET_STORED_META_TASK]: (arg: unknown) => {\n      const { specRelative, titlePath } = arg as GetStoredMetaArg;\n      return getMeta(specRelative, titlePath) ?? null;\n    },\n  });\n}\n"],"mappings":";AAcA,SAAS,IAAI,cAAsB,WAA6B;AAC9D,SAAO,GAAG,YAAY,KAAK,UAAU,KAAK,IAAI,CAAC;AACjD;AAEA,IAAM,QAAQ,oBAAI,IAAwB;AAEnC,SAAS,WAAW,SAAkC;AAC3D,QAAM,IAAI,IAAI,QAAQ,cAAc,QAAQ,SAAS,GAAG;AAAA,IACtD,cAAc,QAAQ;AAAA,IACtB,WAAW,QAAQ;AAAA,IACnB,MAAM,QAAQ;AAAA,IACd,aAAa,QAAQ;AAAA,EACvB,CAAC;AACD,SAAO;AACT;AAMO,SAAS,QAAQ,cAAsB,WAA4C;AACxF,SAAO,MAAM,IAAI,IAAI,cAAc,SAAS,CAAC,GAAG;AAClD;;;AChBA,IAAM,YAAY;AAClB,IAAM,uBAAuB;AAiBtB,SAAS,gCAAgC,IAAwB;AACtE,KAAG,QAAQ;AAAA,IACT,CAAC,SAAS,GAAG,CAAC,YAAqB,WAAW,OAA8C;AAAA,IAC5F,CAAC,oBAAoB,GAAG,CAAC,QAAiB;AACxC,YAAM,EAAE,cAAc,UAAU,IAAI;AACpC,aAAO,QAAQ,cAAc,SAAS,KAAK;AAAA,IAC7C;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/reporter.cjs

@@ -0,0 +1,220 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key2 of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key2) && key2 !== except)
+        __defProp(to, key2, { get: () => from[key2], enumerable: !(desc = __getOwnPropDesc(from, key2)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/reporter.ts
+var reporter_exports = {};
+__export(reporter_exports, {
+  buildRawRunFromCypressResult: () => buildRawRunFromCypressResult,
+  default: () => reporter_default,
+  generateReportsFromRawRun: () => generateReportsFromRawRun
+});
+module.exports = __toCommonJS(reporter_exports);
+var fs = __toESM(require("fs"), 1);
+var path = __toESM(require("path"), 1);
+var import_executable_stories_formatters = require("executable-stories-formatters");
+
+// src/store.ts
+function key(specRelative, titlePath) {
+  return `${specRelative}\0${titlePath.join("\0")}`;
+}
+var store = /* @__PURE__ */ new Map();
+function getAttachments(specRelative, titlePath) {
+  return store.get(key(specRelative, titlePath))?.attachments;
+}
+function getMeta(specRelative, titlePath) {
+  return store.get(key(specRelative, titlePath))?.meta;
+}
+function getAllMeta() {
+  return Array.from(store.values());
+}
+function clearStore() {
+  store.clear();
+}
+
+// src/reporter.ts
+function getTitlePath(test) {
+  const path2 = [];
+  let current = test;
+  while (current) {
+    const title = "title" in current ? current.title : "";
+    if (title) path2.unshift(title);
+    current = "parent" in current ? current.parent : void 0;
+  }
+  return path2;
+}
+function collectTests(suite) {
+  const tests = [...suite.tests];
+  for (const s of suite.suites) {
+    tests.push(...collectTests(s));
+  }
+  return tests;
+}
+function mapCypressStateToRaw(state) {
+  switch (state) {
+    case "passed":
+      return "pass";
+    case "failed":
+      return "fail";
+    case "pending":
+      return "skip";
+    default:
+      return "unknown";
+  }
+}
+var DEFAULT_OPTIONS = {
+  projectRoot: process.cwd()
+};
+function createReporter(runner, options = {}) {
+  const reporterOpts = "reporterOptions" in options && options.reporterOptions ? options.reporterOptions : options;
+  const opts = { ...DEFAULT_OPTIONS, ...reporterOpts };
+  const projectRoot = opts.projectRoot ?? process.cwd();
+  const specPath = opts.specPath ?? "unknown";
+  const startTime = runner.startTime ?? Date.now();
+  runner.suite && runner.on?.("end", () => {
+    const tests = collectTests(runner.suite);
+    const rawTestCases = [];
+    const effectiveSpecPath = specPath !== "unknown" ? specPath : (() => {
+      const all = getAllMeta();
+      return all.length > 0 ? all[0].specRelative : "unknown";
+    })();
+    for (const test of tests) {
+      const titlePath = getTitlePath(test);
+      const meta = getMeta(effectiveSpecPath, titlePath);
+      if (!meta) continue;
+      const status = mapCypressStateToRaw(test.state);
+      const storedAttachments = getAttachments(effectiveSpecPath, titlePath);
+      const attachments = storedAttachments?.map((a) => ({
+        name: a.name,
+        mediaType: a.mediaType,
+        path: a.path,
+        body: typeof a.body === "string" ? a.body : a.body instanceof Buffer ? a.body.toString("base64") : void 0,
+        encoding: a.encoding ?? (a.body instanceof Buffer ? "BASE64" : void 0),
+        charset: a.charset,
+        fileName: a.fileName,
+        stepIndex: a.stepIndex,
+        stepId: a.stepId
+      }));
+      const stepEvents = meta.steps.filter((s) => s.durationMs !== void 0).map((s, i) => ({
+        index: i,
+        title: s.text,
+        durationMs: s.durationMs
+      }));
+      rawTestCases.push({
+        title: meta.scenario,
+        titlePath: meta.suitePath ? [...meta.suitePath, meta.scenario] : [meta.scenario],
+        story: meta,
+        sourceFile: effectiveSpecPath,
+        sourceLine: 1,
+        status,
+        durationMs: test.duration,
+        error: test.err ? { message: test.err.message, stack: test.err.stack } : void 0,
+        attachments: attachments && attachments.length > 0 ? attachments : void 0,
+        stepEvents: stepEvents.length > 0 ? stepEvents : void 0,
+        retry: 0,
+        retries: 0
+      });
+    }
+    if (rawTestCases.length === 0) {
+      clearStore();
+      return;
+    }
+    const includeMetadata = opts.markdown?.includeMetadata ?? true;
+    const rawRun = {
+      testCases: rawTestCases,
+      startedAtMs: startTime,
+      finishedAtMs: Date.now(),
+      projectRoot,
+      packageVersion: includeMetadata ? (0, import_executable_stories_formatters.readPackageVersion)(projectRoot) : void 0,
+      gitSha: includeMetadata ? (0, import_executable_stories_formatters.readGitSha)(projectRoot) : void 0,
+      ci: (0, import_executable_stories_formatters.detectCI)()
+    };
+    const rawRunPath = opts.rawRunPath;
+    if (rawRunPath) {
+      const absolutePath = path.isAbsolute(rawRunPath) ? rawRunPath : path.join(projectRoot, rawRunPath);
+      const dir = path.dirname(absolutePath);
+      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+      fs.writeFileSync(absolutePath, JSON.stringify({ schemaVersion: 1, ...rawRun }, null, 2), "utf8");
+    }
+    const canonicalRun = (0, import_executable_stories_formatters.canonicalizeRun)(rawRun);
+    const generator = new import_executable_stories_formatters.ReportGenerator(opts);
+    generator.generate(canonicalRun).catch((err) => {
+      console.error("Failed to generate reports:", err);
+    });
+    clearStore();
+  });
+}
+function buildRawRunFromCypressResult(result, options = {}) {
+  const projectRoot = options.projectRoot ?? result.config?.projectRoot ?? process.cwd();
+  const rawTestCases = [];
+  for (const run of result.runs ?? []) {
+    const specRelative = run.spec?.relative ?? "unknown";
+    for (const test of run.tests ?? []) {
+      const titlePath = test.title ?? [];
+      const meta = getMeta(specRelative, titlePath);
+      if (!meta) continue;
+      const lastAttempt = test.attempts?.length ? test.attempts[test.attempts.length - 1] : void 0;
+      const state = lastAttempt?.state ?? test.state;
+      const err = lastAttempt?.error ?? (test.displayError ? { message: test.displayError } : void 0);
+      const duration = lastAttempt?.duration ?? test.duration;
+      rawTestCases.push({
+        title: meta.scenario,
+        titlePath: meta.suitePath ? [...meta.suitePath, meta.scenario] : [meta.scenario],
+        story: meta,
+        sourceFile: specRelative,
+        sourceLine: 1,
+        status: mapCypressStateToRaw(state),
+        durationMs: duration,
+        error: err ? { message: err.message, stack: err.stack } : void 0
+      });
+    }
+  }
+  const includeMetadata = options.markdown?.includeMetadata ?? true;
+  return {
+    testCases: rawTestCases,
+    startedAtMs: void 0,
+    finishedAtMs: Date.now(),
+    projectRoot,
+    packageVersion: includeMetadata ? (0, import_executable_stories_formatters.readPackageVersion)(projectRoot) : void 0,
+    gitSha: includeMetadata ? (0, import_executable_stories_formatters.readGitSha)(projectRoot) : void 0,
+    ci: (0, import_executable_stories_formatters.detectCI)()
+  };
+}
+async function generateReportsFromRawRun(rawRun, options) {
+  if (rawRun.testCases.length === 0) return;
+  const canonicalRun = (0, import_executable_stories_formatters.canonicalizeRun)(rawRun);
+  const generator = new import_executable_stories_formatters.ReportGenerator(options);
+  await generator.generate(canonicalRun);
+}
+var reporter_default = createReporter;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildRawRunFromCypressResult,
+  generateReportsFromRawRun
+});
+//# sourceMappingURL=reporter.cjs.map

package/dist/reporter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reporter.ts","../src/store.ts"],"sourcesContent":["/**\n * Cypress/Mocha reporter for executable-stories.\n * Builds RawRun (formatters schema) from run results + stored story meta, then generates reports.\n */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { StoryMeta } from \"executable-stories-formatters\";\n\nimport {\n  ReportGenerator,\n  canonicalizeRun,\n  readGitSha,\n  readPackageVersion,\n  detectCI,\n  type RawRun,\n  type RawTestCase,\n  type RawAttachment,\n  type RawStepEvent,\n  type RawStatus,\n  type FormatterOptions,\n} from \"executable-stories-formatters\";\n\nimport { getMeta, getAttachments, getAllMeta, clearStore } from \"./store\";\n\n// Re-export types from formatters\nexport type {\n  OutputFormat,\n  OutputMode,\n  ColocatedStyle,\n  OutputRule,\n  FormatterOptions,\n} from \"executable-stories-formatters\";\n\n// ============================================================================\n// Reporter Options\n// ============================================================================\n\nexport interface StoryReporterOptions extends FormatterOptions {\n  /** If set, write raw run JSON (schemaVersion 1) to this path for CLI/binary */\n  rawRunPath?: string;\n  /** Spec file path (relative to projectRoot) for this run. If omitted, inferred from stored meta when possible. */\n  specPath?: string;\n  /** Project root. Defaults to process.cwd(). */\n  projectRoot?: string;\n}\n\n// ============================================================================\n// Mocha Runner / Test types (minimal for reporter)\n// ============================================================================\n\ninterface MochaSuite {\n  title: string;\n  suites: MochaSuite[];\n  tests: MochaTest[];\n  parent?: MochaSuite;\n}\n\ninterface MochaTest {\n  title: string;\n  state?: string;\n  duration?: number;\n  err?: Error & { message?: string; stack?: string };\n  parent?: MochaSuite;\n}\n\ninterface MochaRunner {\n  suite: MochaSuite;\n  startTime?: number;\n  on?(event: string, callback: () => void): void;\n}\n\nfunction getTitlePath(test: MochaTest): string[] {\n  const path: string[] = [];\n  let current: MochaSuite | MochaTest | undefined = test;\n  while (current) {\n    const title = \"title\" in current ? current.title : \"\";\n    if (title) path.unshift(title);\n    current = \"parent\" in current ? current.parent : undefined;\n  }\n  return path;\n}\n\nfunction collectTests(suite: MochaSuite): MochaTest[] {\n  const tests = [...suite.tests];\n  for (const s of suite.suites) {\n    tests.push(...collectTests(s));\n  }\n  return tests;\n}\n\nfunction mapCypressStateToRaw(state: string | undefined): RawStatus {\n  switch (state) {\n    case \"passed\":\n      return \"pass\";\n    case \"failed\":\n      return \"fail\";\n    case \"pending\":\n      return \"skip\";\n    default:\n      return \"unknown\";\n  }\n}\n\n// ============================================================================\n// Reporter Implementation\n// ============================================================================\n\nconst DEFAULT_OPTIONS: Partial<StoryReporterOptions> = {\n  projectRoot: process.cwd(),\n};\n\n/**\n * Create a Mocha reporter function that Cypress can use (--reporter path/to/reporter).\n * Cypress passes (runner, reporterOptions) with reporterOptions as the second argument directly.\n * Also supports options.reporterOptions for wrapped usage.\n */\nfunction createReporter(\n  runner: MochaRunner,\n  options: StoryReporterOptions | { reporterOptions?: StoryReporterOptions } = {}\n) {\n  const reporterOpts =\n    \"reporterOptions\" in options && options.reporterOptions\n      ? options.reporterOptions\n      : (options as StoryReporterOptions);\n  const opts: StoryReporterOptions = { ...DEFAULT_OPTIONS, ...reporterOpts };\n  const projectRoot = opts.projectRoot ?? process.cwd();\n  const specPath = opts.specPath ?? \"unknown\";\n  const startTime = runner.startTime ?? Date.now();\n\n  runner.suite && runner.on?.(\"end\", () => {\n    const tests = collectTests(runner.suite);\n    const rawTestCases: RawTestCase[] = [];\n\n    // If specPath not provided, infer from first stored meta (all stored entries are for this spec in a single-spec run)\n    const effectiveSpecPath =\n      specPath !== \"unknown\"\n        ? specPath\n        : (() => {\n            const all = getAllMeta();\n            return all.length > 0 ? all[0].specRelative : \"unknown\";\n          })();\n\n    for (const test of tests) {\n      const titlePath = getTitlePath(test);\n      const meta = getMeta(effectiveSpecPath, titlePath);\n      if (!meta) continue; // only document tests that used story.init()\n\n      const status = mapCypressStateToRaw(test.state);\n\n      // Map stored attachments to RawAttachment[]\n      const storedAttachments = getAttachments(effectiveSpecPath, titlePath);\n      const attachments: RawAttachment[] | undefined = storedAttachments?.map((a) => ({\n        name: a.name,\n        mediaType: a.mediaType,\n        path: a.path,\n        body: typeof a.body === 'string' ? a.body : a.body instanceof Buffer ? a.body.toString('base64') : undefined,\n        encoding: a.encoding ?? (a.body instanceof Buffer ? 'BASE64' : undefined),\n        charset: a.charset,\n        fileName: a.fileName,\n        stepIndex: a.stepIndex,\n        stepId: a.stepId,\n      }));\n\n      // Extract step events (timing)\n      const stepEvents: RawStepEvent[] = meta.steps\n        .filter((s: { durationMs?: number }) => s.durationMs !== undefined)\n        .map((s: { durationMs?: number; text: string }, i: number) => ({\n          index: i,\n          title: s.text,\n          durationMs: s.durationMs,\n        }));\n\n      rawTestCases.push({\n        title: meta.scenario,\n        titlePath: meta.suitePath ? [...meta.suitePath, meta.scenario] : [meta.scenario],\n        story: meta,\n        sourceFile: effectiveSpecPath,\n        sourceLine: 1,\n        status,\n        durationMs: test.duration,\n        error: test.err\n          ? { message: test.err.message, stack: test.err.stack }\n          : undefined,\n        attachments: attachments && attachments.length > 0 ? attachments : undefined,\n        stepEvents: stepEvents.length > 0 ? stepEvents : undefined,\n        retry: 0,\n        retries: 0,\n      });\n    }\n\n    if (rawTestCases.length === 0) {\n      clearStore();\n      return;\n    }\n\n    const includeMetadata = opts.markdown?.includeMetadata ?? true;\n    const rawRun: RawRun = {\n      testCases: rawTestCases,\n      startedAtMs: startTime,\n      finishedAtMs: Date.now(),\n      projectRoot,\n      packageVersion: includeMetadata ? readPackageVersion(projectRoot) : undefined,\n      gitSha: includeMetadata ? readGitSha(projectRoot) : undefined,\n      ci: detectCI(),\n    };\n\n    const rawRunPath = opts.rawRunPath;\n    if (rawRunPath) {\n      const absolutePath = path.isAbsolute(rawRunPath)\n        ? rawRunPath\n        : path.join(projectRoot, rawRunPath);\n      const dir = path.dirname(absolutePath);\n      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });\n      fs.writeFileSync(absolutePath, JSON.stringify({ schemaVersion: 1, ...rawRun }, null, 2), \"utf8\");\n    }\n\n    const canonicalRun = canonicalizeRun(rawRun);\n    const generator = new ReportGenerator(opts);\n    generator.generate(canonicalRun).catch((err) => {\n      console.error(\"Failed to generate reports:\", err);\n    });\n\n    clearStore();\n  });\n}\n\n/**\n * Alternative: build RawRun from Cypress Module API results + stored meta.\n * Use this when not using the Mocha reporter (e.g. in after:run plugin).\n * Call recordMeta via plugin during the run, then call this with cypress.run() result.\n */\nexport interface CypressRunResultTest {\n  title: string[];\n  state?: string;\n  displayError?: string;\n  duration?: number;\n  attempts?: Array<{\n    state?: string;\n    duration?: number;\n    error?: { message?: string; stack?: string };\n  }>;\n}\n\nexport interface CypressRunResultRun {\n  spec?: { relative?: string; absolute?: string };\n  tests?: CypressRunResultTest[];\n}\n\nexport interface CypressRunResult {\n  runs?: CypressRunResultRun[];\n  config?: { projectRoot?: string };\n}\n\nexport function buildRawRunFromCypressResult(\n  result: CypressRunResult,\n  options: StoryReporterOptions = {}\n): RawRun {\n  const projectRoot = options.projectRoot ?? result.config?.projectRoot ?? process.cwd();\n  const rawTestCases: RawTestCase[] = [];\n\n  for (const run of result.runs ?? []) {\n    const specRelative = run.spec?.relative ?? \"unknown\";\n    for (const test of run.tests ?? []) {\n      const titlePath = test.title ?? [];\n      const meta = getMeta(specRelative, titlePath);\n      if (!meta) continue;\n\n      const lastAttempt = test.attempts?.length\n        ? test.attempts[test.attempts.length - 1]\n        : undefined;\n      const state = lastAttempt?.state ?? test.state;\n      const err = lastAttempt?.error ?? (test.displayError ? { message: test.displayError } : undefined);\n      const duration = lastAttempt?.duration ?? test.duration;\n\n      rawTestCases.push({\n        title: meta.scenario,\n        titlePath: meta.suitePath ? [...meta.suitePath, meta.scenario] : [meta.scenario],\n        story: meta,\n        sourceFile: specRelative,\n        sourceLine: 1,\n        status: mapCypressStateToRaw(state),\n        durationMs: duration,\n        error: err ? { message: err.message, stack: err.stack } : undefined,\n      });\n    }\n  }\n\n  const includeMetadata = options.markdown?.includeMetadata ?? true;\n  return {\n    testCases: rawTestCases,\n    startedAtMs: undefined,\n    finishedAtMs: Date.now(),\n    projectRoot,\n    packageVersion: includeMetadata ? readPackageVersion(projectRoot) : undefined,\n    gitSha: includeMetadata ? readGitSha(projectRoot) : undefined,\n    ci: detectCI(),\n  };\n}\n\n/**\n * Generate reports from a RawRun (e.g. after buildRawRunFromCypressResult).\n */\nexport async function generateReportsFromRawRun(\n  rawRun: RawRun,\n  options: FormatterOptions\n): Promise<void> {\n  if (rawRun.testCases.length === 0) return;\n  const canonicalRun = canonicalizeRun(rawRun);\n  const generator = new ReportGenerator(options);\n  await generator.generate(canonicalRun);\n}\n\nexport default createReporter;\n","/**\n * Node-only store for story meta sent from the browser via cy.task.\n * Plugin writes; reporter reads. Keyed by spec + titlePath for merging with run results.\n */\n\nimport type { StoryMeta, ScopedAttachment, RecordMetaPayload } from \"./types\";\n\nexport interface StoredMeta {\n  specRelative: string;\n  titlePath: string[];\n  meta: StoryMeta;\n  attachments?: ScopedAttachment[];\n}\n\nfunction key(specRelative: string, titlePath: string[]): string {\n  return `${specRelative}\\0${titlePath.join(\"\\0\")}`;\n}\n\nconst store = new Map<string, StoredMeta>();\n\nexport function recordMeta(payload: RecordMetaPayload): null {\n  store.set(key(payload.specRelative, payload.titlePath), {\n    specRelative: payload.specRelative,\n    titlePath: payload.titlePath,\n    meta: payload.meta,\n    attachments: payload.attachments,\n  });\n  return null;\n}\n\nexport function getAttachments(specRelative: string, titlePath: string[]): ScopedAttachment[] | undefined {\n  return store.get(key(specRelative, titlePath))?.attachments;\n}\n\nexport function getMeta(specRelative: string, titlePath: string[]): StoryMeta | undefined {\n  return store.get(key(specRelative, titlePath))?.meta;\n}\n\nexport function getAllMeta(): StoredMeta[] {\n  return Array.from(store.values());\n}\n\nexport function clearStore(): void {\n  store.clear();\n}\n"],"mappings":"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","names":["path"]}

package/dist/reporter.d.cts

@@ -0,0 +1,84 @@
+import { FormatterOptions, RawRun } from 'executable-stories-formatters';
+export { ColocatedStyle, FormatterOptions, OutputFormat, OutputMode, OutputRule } from 'executable-stories-formatters';
+
+/**
+ * Cypress/Mocha reporter for executable-stories.
+ * Builds RawRun (formatters schema) from run results + stored story meta, then generates reports.
+ */
+
+interface StoryReporterOptions extends FormatterOptions {
+    /** If set, write raw run JSON (schemaVersion 1) to this path for CLI/binary */
+    rawRunPath?: string;
+    /** Spec file path (relative to projectRoot) for this run. If omitted, inferred from stored meta when possible. */
+    specPath?: string;
+    /** Project root. Defaults to process.cwd(). */
+    projectRoot?: string;
+}
+interface MochaSuite {
+    title: string;
+    suites: MochaSuite[];
+    tests: MochaTest[];
+    parent?: MochaSuite;
+}
+interface MochaTest {
+    title: string;
+    state?: string;
+    duration?: number;
+    err?: Error & {
+        message?: string;
+        stack?: string;
+    };
+    parent?: MochaSuite;
+}
+interface MochaRunner {
+    suite: MochaSuite;
+    startTime?: number;
+    on?(event: string, callback: () => void): void;
+}
+/**
+ * Create a Mocha reporter function that Cypress can use (--reporter path/to/reporter).
+ * Cypress passes (runner, reporterOptions) with reporterOptions as the second argument directly.
+ * Also supports options.reporterOptions for wrapped usage.
+ */
+declare function createReporter(runner: MochaRunner, options?: StoryReporterOptions | {
+    reporterOptions?: StoryReporterOptions;
+}): void;
+/**
+ * Alternative: build RawRun from Cypress Module API results + stored meta.
+ * Use this when not using the Mocha reporter (e.g. in after:run plugin).
+ * Call recordMeta via plugin during the run, then call this with cypress.run() result.
+ */
+interface CypressRunResultTest {
+    title: string[];
+    state?: string;
+    displayError?: string;
+    duration?: number;
+    attempts?: Array<{
+        state?: string;
+        duration?: number;
+        error?: {
+            message?: string;
+            stack?: string;
+        };
+    }>;
+}
+interface CypressRunResultRun {
+    spec?: {
+        relative?: string;
+        absolute?: string;
+    };
+    tests?: CypressRunResultTest[];
+}
+interface CypressRunResult {
+    runs?: CypressRunResultRun[];
+    config?: {
+        projectRoot?: string;
+    };
+}
+declare function buildRawRunFromCypressResult(result: CypressRunResult, options?: StoryReporterOptions): RawRun;
+/**
+ * Generate reports from a RawRun (e.g. after buildRawRunFromCypressResult).
+ */
+declare function generateReportsFromRawRun(rawRun: RawRun, options: FormatterOptions): Promise<void>;
+
+export { type CypressRunResult, type CypressRunResultRun, type CypressRunResultTest, type StoryReporterOptions, buildRawRunFromCypressResult, createReporter as default, generateReportsFromRawRun };

package/dist/reporter.d.ts

@@ -0,0 +1,84 @@
+import { FormatterOptions, RawRun } from 'executable-stories-formatters';
+export { ColocatedStyle, FormatterOptions, OutputFormat, OutputMode, OutputRule } from 'executable-stories-formatters';
+
+/**
+ * Cypress/Mocha reporter for executable-stories.
+ * Builds RawRun (formatters schema) from run results + stored story meta, then generates reports.
+ */
+
+interface StoryReporterOptions extends FormatterOptions {
+    /** If set, write raw run JSON (schemaVersion 1) to this path for CLI/binary */
+    rawRunPath?: string;
+    /** Spec file path (relative to projectRoot) for this run. If omitted, inferred from stored meta when possible. */
+    specPath?: string;
+    /** Project root. Defaults to process.cwd(). */
+    projectRoot?: string;
+}
+interface MochaSuite {
+    title: string;
+    suites: MochaSuite[];
+    tests: MochaTest[];
+    parent?: MochaSuite;
+}
+interface MochaTest {
+    title: string;
+    state?: string;
+    duration?: number;
+    err?: Error & {
+        message?: string;
+        stack?: string;
+    };
+    parent?: MochaSuite;
+}
+interface MochaRunner {
+    suite: MochaSuite;
+    startTime?: number;
+    on?(event: string, callback: () => void): void;
+}
+/**
+ * Create a Mocha reporter function that Cypress can use (--reporter path/to/reporter).
+ * Cypress passes (runner, reporterOptions) with reporterOptions as the second argument directly.
+ * Also supports options.reporterOptions for wrapped usage.
+ */
+declare function createReporter(runner: MochaRunner, options?: StoryReporterOptions | {
+    reporterOptions?: StoryReporterOptions;
+}): void;
+/**
+ * Alternative: build RawRun from Cypress Module API results + stored meta.
+ * Use this when not using the Mocha reporter (e.g. in after:run plugin).
+ * Call recordMeta via plugin during the run, then call this with cypress.run() result.
+ */
+interface CypressRunResultTest {
+    title: string[];
+    state?: string;
+    displayError?: string;
+    duration?: number;
+    attempts?: Array<{
+        state?: string;
+        duration?: number;
+        error?: {
+            message?: string;
+            stack?: string;
+        };
+    }>;
+}
+interface CypressRunResultRun {
+    spec?: {
+        relative?: string;
+        absolute?: string;
+    };
+    tests?: CypressRunResultTest[];
+}
+interface CypressRunResult {
+    runs?: CypressRunResultRun[];
+    config?: {
+        projectRoot?: string;
+    };
+}
+declare function buildRawRunFromCypressResult(result: CypressRunResult, options?: StoryReporterOptions): RawRun;
+/**
+ * Generate reports from a RawRun (e.g. after buildRawRunFromCypressResult).
+ */
+declare function generateReportsFromRawRun(rawRun: RawRun, options: FormatterOptions): Promise<void>;
+
+export { type CypressRunResult, type CypressRunResultRun, type CypressRunResultTest, type StoryReporterOptions, buildRawRunFromCypressResult, createReporter as default, generateReportsFromRawRun };

package/dist/reporter.js

@@ -0,0 +1,190 @@
+// src/reporter.ts
+import * as fs from "fs";
+import * as path from "path";
+import {
+  ReportGenerator,
+  canonicalizeRun,
+  readGitSha,
+  readPackageVersion,
+  detectCI
+} from "executable-stories-formatters";
+
+// src/store.ts
+function key(specRelative, titlePath) {
+  return `${specRelative}\0${titlePath.join("\0")}`;
+}
+var store = /* @__PURE__ */ new Map();
+function getAttachments(specRelative, titlePath) {
+  return store.get(key(specRelative, titlePath))?.attachments;
+}
+function getMeta(specRelative, titlePath) {
+  return store.get(key(specRelative, titlePath))?.meta;
+}
+function getAllMeta() {
+  return Array.from(store.values());
+}
+function clearStore() {
+  store.clear();
+}
+
+// src/reporter.ts
+function getTitlePath(test) {
+  const path2 = [];
+  let current = test;
+  while (current) {
+    const title = "title" in current ? current.title : "";
+    if (title) path2.unshift(title);
+    current = "parent" in current ? current.parent : void 0;
+  }
+  return path2;
+}
+function collectTests(suite) {
+  const tests = [...suite.tests];
+  for (const s of suite.suites) {
+    tests.push(...collectTests(s));
+  }
+  return tests;
+}
+function mapCypressStateToRaw(state) {
+  switch (state) {
+    case "passed":
+      return "pass";
+    case "failed":
+      return "fail";
+    case "pending":
+      return "skip";
+    default:
+      return "unknown";
+  }
+}
+var DEFAULT_OPTIONS = {
+  projectRoot: process.cwd()
+};
+function createReporter(runner, options = {}) {
+  const reporterOpts = "reporterOptions" in options && options.reporterOptions ? options.reporterOptions : options;
+  const opts = { ...DEFAULT_OPTIONS, ...reporterOpts };
+  const projectRoot = opts.projectRoot ?? process.cwd();
+  const specPath = opts.specPath ?? "unknown";
+  const startTime = runner.startTime ?? Date.now();
+  runner.suite && runner.on?.("end", () => {
+    const tests = collectTests(runner.suite);
+    const rawTestCases = [];
+    const effectiveSpecPath = specPath !== "unknown" ? specPath : (() => {
+      const all = getAllMeta();
+      return all.length > 0 ? all[0].specRelative : "unknown";
+    })();
+    for (const test of tests) {
+      const titlePath = getTitlePath(test);
+      const meta = getMeta(effectiveSpecPath, titlePath);
+      if (!meta) continue;
+      const status = mapCypressStateToRaw(test.state);
+      const storedAttachments = getAttachments(effectiveSpecPath, titlePath);
+      const attachments = storedAttachments?.map((a) => ({
+        name: a.name,
+        mediaType: a.mediaType,
+        path: a.path,
+        body: typeof a.body === "string" ? a.body : a.body instanceof Buffer ? a.body.toString("base64") : void 0,
+        encoding: a.encoding ?? (a.body instanceof Buffer ? "BASE64" : void 0),
+        charset: a.charset,
+        fileName: a.fileName,
+        stepIndex: a.stepIndex,
+        stepId: a.stepId
+      }));
+      const stepEvents = meta.steps.filter((s) => s.durationMs !== void 0).map((s, i) => ({
+        index: i,
+        title: s.text,
+        durationMs: s.durationMs
+      }));
+      rawTestCases.push({
+        title: meta.scenario,
+        titlePath: meta.suitePath ? [...meta.suitePath, meta.scenario] : [meta.scenario],
+        story: meta,
+        sourceFile: effectiveSpecPath,
+        sourceLine: 1,
+        status,
+        durationMs: test.duration,
+        error: test.err ? { message: test.err.message, stack: test.err.stack } : void 0,
+        attachments: attachments && attachments.length > 0 ? attachments : void 0,
+        stepEvents: stepEvents.length > 0 ? stepEvents : void 0,
+        retry: 0,
+        retries: 0
+      });
+    }
+    if (rawTestCases.length === 0) {
+      clearStore();
+      return;
+    }
+    const includeMetadata = opts.markdown?.includeMetadata ?? true;
+    const rawRun = {
+      testCases: rawTestCases,
+      startedAtMs: startTime,
+      finishedAtMs: Date.now(),
+      projectRoot,
+      packageVersion: includeMetadata ? readPackageVersion(projectRoot) : void 0,
+      gitSha: includeMetadata ? readGitSha(projectRoot) : void 0,
+      ci: detectCI()
+    };
+    const rawRunPath = opts.rawRunPath;
+    if (rawRunPath) {
+      const absolutePath = path.isAbsolute(rawRunPath) ? rawRunPath : path.join(projectRoot, rawRunPath);
+      const dir = path.dirname(absolutePath);
+      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+      fs.writeFileSync(absolutePath, JSON.stringify({ schemaVersion: 1, ...rawRun }, null, 2), "utf8");
+    }
+    const canonicalRun = canonicalizeRun(rawRun);
+    const generator = new ReportGenerator(opts);
+    generator.generate(canonicalRun).catch((err) => {
+      console.error("Failed to generate reports:", err);
+    });
+    clearStore();
+  });
+}
+function buildRawRunFromCypressResult(result, options = {}) {
+  const projectRoot = options.projectRoot ?? result.config?.projectRoot ?? process.cwd();
+  const rawTestCases = [];
+  for (const run of result.runs ?? []) {
+    const specRelative = run.spec?.relative ?? "unknown";
+    for (const test of run.tests ?? []) {
+      const titlePath = test.title ?? [];
+      const meta = getMeta(specRelative, titlePath);
+      if (!meta) continue;
+      const lastAttempt = test.attempts?.length ? test.attempts[test.attempts.length - 1] : void 0;
+      const state = lastAttempt?.state ?? test.state;
+      const err = lastAttempt?.error ?? (test.displayError ? { message: test.displayError } : void 0);
+      const duration = lastAttempt?.duration ?? test.duration;
+      rawTestCases.push({
+        title: meta.scenario,
+        titlePath: meta.suitePath ? [...meta.suitePath, meta.scenario] : [meta.scenario],
+        story: meta,
+        sourceFile: specRelative,
+        sourceLine: 1,
+        status: mapCypressStateToRaw(state),
+        durationMs: duration,
+        error: err ? { message: err.message, stack: err.stack } : void 0
+      });
+    }
+  }
+  const includeMetadata = options.markdown?.includeMetadata ?? true;
+  return {
+    testCases: rawTestCases,
+    startedAtMs: void 0,
+    finishedAtMs: Date.now(),
+    projectRoot,
+    packageVersion: includeMetadata ? readPackageVersion(projectRoot) : void 0,
+    gitSha: includeMetadata ? readGitSha(projectRoot) : void 0,
+    ci: detectCI()
+  };
+}
+async function generateReportsFromRawRun(rawRun, options) {
+  if (rawRun.testCases.length === 0) return;
+  const canonicalRun = canonicalizeRun(rawRun);
+  const generator = new ReportGenerator(options);
+  await generator.generate(canonicalRun);
+}
+var reporter_default = createReporter;
+export {
+  buildRawRunFromCypressResult,
+  reporter_default as default,
+  generateReportsFromRawRun
+};
+//# sourceMappingURL=reporter.js.map