executable-stories-playwright 8.1.4 → 8.2.1

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as _playwright_test from '@playwright/test';
-import { TestInfo, PlaywrightTestArgs, PlaywrightTestOptions } from '@playwright/test';
+import { TestInfo, PlaywrightTestArgs, PlaywrightTestOptions, TestStepInfo } from '@playwright/test';
+export { TestStepInfo } from '@playwright/test';
 import * as executable_stories_formatters from 'executable-stories-formatters';
 import { DocEntry, StepKeyword } from 'executable-stories-formatters';
 export { DocEntry, NormalizedTicket, StepKeyword, StoryMeta, StoryStep } from 'executable-stories-formatters';
@@ -78,6 +79,15 @@ interface StoryOptions {
     /** Playwright fixtures (first argument of the test callback). When set, step callbacks receive this as their first argument. */
     fixtures?: unknown;
 }
+/** Options for story.console() – captures page console messages as a doc entry. */
+interface ConsoleOptions {
+    /** The Playwright Page object (typed as unknown to avoid importing Page here). */
+    page: unknown;
+    /** Label shown above the console output block. Defaults to "Console". */
+    label?: string;
+    /** Also capture page errors (uncaught exceptions). Defaults to false. */
+    includeErrors?: boolean;
+}
 /** Options for story.attach(). */
 interface AttachmentOptions {
     name: string;
@@ -134,67 +144,67 @@ declare const story: {
     given: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     when: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     then: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     and: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     but: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     arrange: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     act: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     assert: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     setup: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     context: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     execute: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     action: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     verify: {
         (text: string, docs?: StoryDocs): void;
         (text: string, children: DocEntry[]): void;
-        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;
     };
     note(text: string, children?: DocEntry[]): DocEntry;
     tag(name: string | string[], children?: DocEntry[]): DocEntry;
@@ -207,6 +217,21 @@ declare const story: {
     mermaid(options: MermaidOptions, children?: DocEntry[]): DocEntry;
     screenshot(options: ScreenshotOptions, children?: DocEntry[]): DocEntry;
     custom(options: CustomOptions, children?: DocEntry[]): DocEntry;
+    /**
+     * Snapshot the current page console messages (and optionally page errors)
+     * and attach them as a code doc entry.
+     *
+     * Uses page.consoleMessages() and page.pageErrors() introduced in Playwright v1.56.
+     * Safe to call on any Playwright version – silently produces empty output if the
+     * APIs are not present.
+     *
+     * @example
+     * story.when('the form is submitted', async ({ page }) => {
+     *   await page.click('#submit');
+     *   story.console({ page, label: 'Submit console output' });
+     * });
+     */
+    console(options: ConsoleOptions, children?: DocEntry[]): DocEntry;
     attach: typeof playwrightAttach;
     attachSpans(spans: ReadonlyArray<Record<string, unknown>>): void;
     startTimer(): number;
@@ -219,27 +244,27 @@ type Story = typeof story;
 declare const given: {
     (text: string, docs?: StoryDocs): void;
     (text: string, children: executable_stories_formatters.DocEntry[]): void;
-    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>, step?: _playwright_test.TestStepInfo) => T): T;
 };
 declare const when: {
     (text: string, docs?: StoryDocs): void;
     (text: string, children: executable_stories_formatters.DocEntry[]): void;
-    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>, step?: _playwright_test.TestStepInfo) => T): T;
 };
 declare const then: {
     (text: string, docs?: StoryDocs): void;
     (text: string, children: executable_stories_formatters.DocEntry[]): void;
-    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>, step?: _playwright_test.TestStepInfo) => T): T;
 };
 declare const and: {
     (text: string, docs?: StoryDocs): void;
     (text: string, children: executable_stories_formatters.DocEntry[]): void;
-    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>, step?: _playwright_test.TestStepInfo) => T): T;
 };
 declare const but: {
     (text: string, docs?: StoryDocs): void;
     (text: string, children: executable_stories_formatters.DocEntry[]): void;
-    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>, step?: _playwright_test.TestStepInfo) => T): T;
 };
 
-export { type CodeOptions, type CustomOptions, type JsonOptions, type KvOptions, type LinkOptions, type MermaidOptions, type ScreenshotOptions, type SectionOptions, type Story, type StoryDocs, type StoryOptions, type TableOptions, type TicketInput, and, but, given, story, then, when };
+export { type AttachmentOptions, type CodeOptions, type ConsoleOptions, type CustomOptions, type JsonOptions, type KvOptions, type LinkOptions, type MermaidOptions, type ScreenshotOptions, type SectionOptions, type Story, type StoryDocs, type StoryOptions, type TableOptions, type TicketInput, and, but, given, story, then, when };

package/dist/index.js

@@ -4,6 +4,41 @@ import {
   tryGetActiveOtelContext,
   resolveTraceUrl
 } from "executable-stories-formatters";
+
+// src/step-runner.ts
+import { test } from "@playwright/test";
+async function runStep(label, body, fixtures) {
+  const page = fixtures.page;
+  const context = fixtures.context ?? (typeof page?.context === "function" ? page.context() : void 0);
+  const screencast = page?.screencast;
+  if (screencast?.showChapter) {
+    try {
+      await screencast.showChapter(label);
+    } catch {
+    }
+  }
+  return test.step(label, async (stepInfo) => {
+    const tracing = context?.tracing;
+    if (tracing?.group) {
+      let bodyInvoked = false;
+      try {
+        return await tracing.group(label, async () => {
+          bodyInvoked = true;
+          return body(fixtures, stepInfo);
+        });
+      } catch (e) {
+        if (bodyInvoked) throw e;
+        return body(fixtures, stepInfo);
+      }
+    }
+    return body(fixtures, stepInfo);
+  });
+}
+function isAsyncFunction(fn2) {
+  return typeof fn2 === "function" && fn2.constructor?.name === "AsyncFunction";
+}
+
+// src/story-api.ts
 var activeContext = null;
 var activeTestInfo = null;
 var sourceOrderCounter = 0;
@@ -169,7 +204,29 @@ function createStepMarker(keyword) {
     }
     if (!isCallback) return;
     const body = docsOrBody;
+    const label = `${step.keyword}: ${text}`;
     const start = performance.now();
+    if (ctx.fixtures !== void 0 && (isAsyncFunction(body) || body.length >= 2)) {
+      const fixtures = ctx.fixtures;
+      const result = runStep(
+        label,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        body,
+        fixtures
+      );
+      return result.then(
+        (val) => {
+          step.durationMs = performance.now() - start;
+          syncAnnotationToTest();
+          return val;
+        },
+        (err) => {
+          step.durationMs = performance.now() - start;
+          syncAnnotationToTest();
+          throw err;
+        }
+      );
+    }
     try {
       const result = ctx.fixtures !== void 0 ? body(ctx.fixtures) : body();
       if (result instanceof Promise) {
@@ -252,6 +309,9 @@ function init(first, second, third) {
     type: "story-meta",
     description: JSON.stringify(meta)
   });
+  for (const tag of options?.tags ?? []) {
+    testInfo.annotations.push({ type: "tag", description: tag });
+  }
   activeContext = {
     meta,
     currentStep: null,
@@ -386,6 +446,45 @@ var story = {
   custom(options, children) {
     return attachDoc({ kind: "custom", type: options.type, data: options.data, phase: "runtime" }, children);
   },
+  // ── Feature: Console capture (v1.56) ────────────────────────────────────
+  /**
+   * Snapshot the current page console messages (and optionally page errors)
+   * and attach them as a code doc entry.
+   *
+   * Uses page.consoleMessages() and page.pageErrors() introduced in Playwright v1.56.
+   * Safe to call on any Playwright version – silently produces empty output if the
+   * APIs are not present.
+   *
+   * @example
+   * story.when('the form is submitted', async ({ page }) => {
+   *   await page.click('#submit');
+   *   story.console({ page, label: 'Submit console output' });
+   * });
+   */
+  console(options, children) {
+    const p = options.page;
+    const lines = [];
+    if (typeof p?.consoleMessages === "function") {
+      for (const msg of p.consoleMessages()) {
+        lines.push(`[${msg.type()}] ${msg.text()}`);
+      }
+    }
+    if (options.includeErrors === true && typeof p?.pageErrors === "function") {
+      for (const err of p.pageErrors()) {
+        lines.push(`[error] ${err.message}`);
+      }
+    }
+    return attachDoc(
+      {
+        kind: "code",
+        label: options.label ?? "Console",
+        content: lines.length > 0 ? lines.join("\n") : "(no console output)",
+        lang: "log",
+        phase: "runtime"
+      },
+      children
+    );
+  },
   // Attachments
   attach: playwrightAttach,
   // OTel span attachment

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/story-api.ts","../src/index.ts"],"sourcesContent":["/**\n * Playwright story.* API for executable-stories.\n *\n * Uses native Playwright test() with opt-in documentation:\n *\n * @example\n * ```ts\n * import { test, expect } from '@playwright/test';\n * import { story } from 'executable-stories-playwright';\n *\n * test.describe('Calculator', () => {\n *   test('adds two numbers', async ({ page }, testInfo) => {\n *     story.init(testInfo);\n *\n *     story.given('two numbers 5 and 3');\n *     const a = 5;\n *     const b = 3;\n *\n *     story.when('I add them together');\n *     const result = a + b;\n *\n *     story.then('the result is 8');\n *     expect(result).toBe(8);\n *   });\n * });\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { TestInfo, PlaywrightTestArgs, PlaywrightTestOptions } from '@playwright/test';\nimport {\n  tryGetActiveOtelContext,\n  resolveTraceUrl,\n} from 'executable-stories-formatters';\nimport type {\n  StepKeyword,\n  StoryMeta,\n  StoryStep,\n  DocEntry,\n  NormalizedTicket,\n  TicketInput,\n} from './types';\nimport type {\n  StoryDocs,\n  StoryOptions,\n  AttachmentOptions,\n  ScopedAttachment,\n  KvOptions,\n  JsonOptions,\n  CodeOptions,\n  TableOptions,\n  LinkOptions,\n  SectionOptions,\n  MermaidOptions,\n  ScreenshotOptions,\n  CustomOptions,\n} from './types';\n\n// Re-export types for consumers\nexport type {\n  StoryMeta,\n  StoryStep,\n  DocEntry,\n  StepKeyword,\n  StoryDocs,\n  StoryOptions,\n  AttachmentOptions,\n} from './types';\n\n// ============================================================================\n// Internal types\n// ============================================================================\n\n/** Fixture type for step callbacks: Playwright test args + options; custom extend() fixtures as unknown. */\ntype PlaywrightFixtures = PlaywrightTestArgs & PlaywrightTestOptions & Record<string, unknown>;\n\ninterface TimerEntry {\n  start: number;\n  stepIndex?: number;\n  stepId?: string;\n  consumed: boolean;\n}\n\ninterface StoryContext {\n  meta: StoryMeta;\n  currentStep: StoryStep | null;\n  stepCounter: number;\n  attachments: ScopedAttachment[];\n  activeTimers: Map<number, TimerEntry>;\n  timerCounter: number;\n  fixtures?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Playwright-specific context\n// ============================================================================\n\n/** Active story context - set by story.init() */\nlet activeContext: StoryContext | null = null;\n\n/** Reference to testInfo for attaching metadata */\nlet activeTestInfo: TestInfo | null = null;\n\n/** Counter to track source order of stories (increments on each story.init call) */\nlet sourceOrderCounter = 0;\n\n/**\n * Get the current story context. Throws if story.init() wasn't called.\n */\nfunction getContext(): StoryContext {\n  if (!activeContext) {\n    throw new Error(\n      \"story.init(testInfo) must be called first. Use: test('name', async ({ page }, testInfo) => { story.init(testInfo); ... });\",\n    );\n  }\n  return activeContext;\n}\n\n// ============================================================================\n// Helper functions (inlined from core)\n// ============================================================================\n\nfunction normalizeTickets(\n  ticket: TicketInput | TicketInput[] | undefined,\n): NormalizedTicket[] | undefined {\n  if (!ticket) return undefined;\n  const arr = Array.isArray(ticket) ? ticket : [ticket];\n  return arr.map((t) => (typeof t === 'string' ? { id: t } : t));\n}\n\nfunction convertStoryDocsToEntries(docs: StoryDocs): DocEntry[] {\n  const entries: DocEntry[] = [];\n\n  if (docs.note) {\n    entries.push({ kind: 'note', text: docs.note, phase: 'runtime' });\n  }\n  if (docs.tag) {\n    const names = Array.isArray(docs.tag) ? docs.tag : [docs.tag];\n    entries.push({ kind: 'tag', names, phase: 'runtime' });\n  }\n  if (docs.kv) {\n    for (const [label, value] of Object.entries(docs.kv)) {\n      entries.push({ kind: 'kv', label, value, phase: 'runtime' });\n    }\n  }\n  if (docs.code) {\n    entries.push({\n      kind: 'code',\n      label: docs.code.label,\n      content: docs.code.content,\n      lang: docs.code.lang,\n      phase: 'runtime',\n    });\n  }\n  if (docs.json) {\n    entries.push({\n      kind: 'code',\n      label: docs.json.label,\n      content: JSON.stringify(docs.json.value, null, 2),\n      lang: 'json',\n      phase: 'runtime',\n    });\n  }\n  if (docs.table) {\n    entries.push({\n      kind: 'table',\n      label: docs.table.label,\n      columns: docs.table.columns,\n      rows: docs.table.rows,\n      phase: 'runtime',\n    });\n  }\n  if (docs.link) {\n    entries.push({\n      kind: 'link',\n      label: docs.link.label,\n      url: docs.link.url,\n      phase: 'runtime',\n    });\n  }\n  if (docs.section) {\n    entries.push({\n      kind: 'section',\n      title: docs.section.title,\n      markdown: docs.section.markdown,\n      phase: 'runtime',\n    });\n  }\n  if (docs.mermaid) {\n    entries.push({\n      kind: 'mermaid',\n      code: docs.mermaid.code,\n      title: docs.mermaid.title,\n      phase: 'runtime',\n    });\n  }\n  if (docs.screenshot) {\n    entries.push({\n      kind: 'screenshot',\n      path: docs.screenshot.path,\n      alt: docs.screenshot.alt,\n      phase: 'runtime',\n    });\n  }\n  if (docs.custom) {\n    entries.push({\n      kind: 'custom',\n      type: docs.custom.type,\n      data: docs.custom.data,\n      phase: 'runtime',\n    });\n  }\n\n  return entries;\n}\n\nfunction attachDoc(entry: DocEntry, children?: DocEntry[]): DocEntry {\n  const ctx = getContext();\n  if (children && children.length > 0) {\n    entry.children = children;\n    const childSet = new Set<DocEntry>(children);\n    const filterDocs = (docs: DocEntry[]) => docs.filter((d) => !childSet.has(d));\n    // Remove children from ALL containers (story-level + every step)\n    ctx.meta.docs = filterDocs(ctx.meta.docs ?? []);\n    for (const step of ctx.meta.steps) {\n      if (step.docs) step.docs = filterDocs(step.docs);\n    }\n  }\n  if (ctx.currentStep) {\n    ctx.currentStep.docs ??= [];\n    ctx.currentStep.docs.push(entry);\n  } else {\n    ctx.meta.docs ??= [];\n    ctx.meta.docs.push(entry);\n  }\n  syncAnnotationToTest();\n  return entry;\n}\n\n// ============================================================================\n// Suite path extraction\n// ============================================================================\n\n/**\n * Extract the suite path from testInfo.titlePath.\n * Playwright's titlePath includes: [projectName, ...describeTitles, testTitle]\n * We want just the describe titles (excluding project and test name).\n */\nfunction extractSuitePath(testInfo: TestInfo): string[] | undefined {\n  const titlePath = testInfo.titlePath;\n  if (titlePath.length <= 2) {\n    return undefined;\n  }\n  const suitePath = titlePath.slice(1, -1);\n  return suitePath.length > 0 ? suitePath : undefined;\n}\n\n// ============================================================================\n// Step markers\n// ============================================================================\n\nfunction createStepMarker(keyword: StepKeyword) {\n  function stepMarker(text: string, docs?: StoryDocs): void;\n  function stepMarker(text: string, children: DocEntry[]): void;\n  function stepMarker<T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  function stepMarker<T>(text: string, docsOrBody?: StoryDocs | DocEntry[] | ((...args: any[]) => T)): T | void {\n    const ctx = getContext();\n    const isCallback = typeof docsOrBody === 'function';\n    const isChildrenArray = Array.isArray(docsOrBody);\n\n    const resolvedKeyword: StepKeyword =\n      (keyword === 'Given' || keyword === 'When' || keyword === 'Then') &&\n      ctx.meta.steps.some((s) => s.keyword === keyword)\n        ? 'And'\n        : keyword;\n\n    let stepDocs: DocEntry[] = [];\n    if (!isCallback && !isChildrenArray && docsOrBody) {\n      stepDocs = convertStoryDocsToEntries(docsOrBody as StoryDocs);\n    }\n\n    const step: StoryStep = {\n      id: `step-${ctx.stepCounter++}`,\n      keyword: resolvedKeyword,\n      text,\n      docs: stepDocs,\n      ...(isCallback ? { wrapped: true } : {}),\n    };\n\n    ctx.meta.steps.push(step);\n    ctx.currentStep = step;\n    syncAnnotationToTest();\n\n    // Handle DocEntry[] children: attach as step docs and deduplicate from story-level\n    if (isChildrenArray) {\n      const children = docsOrBody as DocEntry[];\n      if (children.length > 0) {\n        const childSet = new Set<DocEntry>(children);\n        // Deduplicate from story-level docs\n        ctx.meta.docs = (ctx.meta.docs ?? []).filter((d) => !childSet.has(d));\n        // Deduplicate from step docs of earlier steps\n        for (const prevStep of ctx.meta.steps) {\n          if (prevStep !== step && prevStep.docs) {\n            prevStep.docs = prevStep.docs.filter((d) => !childSet.has(d));\n          }\n        }\n        step.docs = [...(step.docs ?? []), ...children];\n      }\n      syncAnnotationToTest();\n      return;\n    }\n\n    if (!isCallback) return;\n\n    const body = docsOrBody as (fixtures?: PlaywrightFixtures) => T;\n    const start = performance.now();\n\n    try {\n      const result = ctx.fixtures !== undefined ? body(ctx.fixtures as PlaywrightFixtures) : body();\n      if (result instanceof Promise) {\n        return result.then(\n          (val) => { step.durationMs = performance.now() - start; syncAnnotationToTest(); return val; },\n          (err) => { step.durationMs = performance.now() - start; syncAnnotationToTest(); throw err; },\n        ) as T;\n      }\n      step.durationMs = performance.now() - start;\n      syncAnnotationToTest();\n      return result;\n    } catch (err) {\n      step.durationMs = performance.now() - start;\n      syncAnnotationToTest();\n      throw err;\n    }\n  }\n  return stepMarker;\n}\n\n// ============================================================================\n// story.init() - Playwright-specific\n// ============================================================================\n\nfunction isTestInfo(x: unknown): x is TestInfo {\n  return (\n    typeof x === 'object' &&\n    x !== null &&\n    'title' in x &&\n    'annotations' in x &&\n    Array.isArray((x as TestInfo).annotations)\n  );\n}\n\n/** init(testInfo) or init(fixtures, testInfo) or init(testInfo, { fixtures }). */\nfunction init(\n  first: TestInfo | unknown,\n  second?: StoryOptions | TestInfo,\n  third?: StoryOptions,\n): void {\n  let testInfo: TestInfo;\n  let options: StoryOptions | undefined;\n  let fixtures: unknown;\n\n  if (second !== undefined && isTestInfo(second)) {\n    fixtures = first;\n    testInfo = second;\n    options = third;\n  } else {\n    testInfo = first as TestInfo;\n    options = second;\n    fixtures = options?.fixtures;\n  }\n\n  const meta: StoryMeta = {\n    scenario: testInfo.title,\n    steps: [],\n    suitePath: extractSuitePath(testInfo),\n    tags: options?.tags,\n    tickets: normalizeTickets(options?.ticket),\n    meta: options?.meta,\n    sourceOrder: sourceOrderCounter++,\n  };\n\n  // OTel bridge: detect active span, flow data bidirectionally\n  const otelCtx = tryGetActiveOtelContext();\n  if (otelCtx) {\n    // OTel -> Story: capture traceId in structured meta\n    meta.meta = { ...meta.meta, otel: { traceId: otelCtx.traceId, spanId: otelCtx.spanId } };\n\n    // OTel -> Story: inject human-readable doc entries\n    meta.docs = meta.docs ?? [];\n    meta.docs.push({ kind: 'kv', label: 'Trace ID', value: otelCtx.traceId, phase: 'runtime' });\n\n    const template = options?.traceUrlTemplate ?? process.env.OTEL_TRACE_URL_TEMPLATE;\n    const url = resolveTraceUrl(template, otelCtx.traceId);\n    if (url) {\n      meta.docs.push({ kind: 'link', label: 'View Trace', url, phase: 'runtime' });\n    }\n\n    // Story -> OTel: enrich active span with story attributes\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      const reqUrl = import.meta.url\n        ?? (typeof __filename !== 'undefined' ? `file://${__filename}` : undefined);\n      const req = createRequire(reqUrl!);\n      const api = req('@opentelemetry/api');\n      const span = api.trace?.getActiveSpan?.();\n      if (span) {\n        span.setAttribute('story.scenario', testInfo.title);\n        if (options?.tags?.length) span.setAttribute('story.tags', options.tags);\n        if (options?.ticket) {\n          const tickets = Array.isArray(options.ticket) ? options.ticket : [options.ticket];\n          span.setAttribute('story.tickets', tickets.map((t) => typeof t === 'string' ? t : t.id));\n        }\n      }\n    } catch { /* OTel not available */ }\n  }\n\n  testInfo.annotations.push({\n    type: 'story-meta',\n    description: JSON.stringify(meta),\n  });\n\n  activeContext = {\n    meta,\n    currentStep: null,\n    stepCounter: 0,\n    attachments: [],\n    activeTimers: new Map(),\n    timerCounter: 0,\n    fixtures: fixtures as Record<string, unknown> | undefined,\n  };\n  activeTestInfo = testInfo;\n}\n\n/**\n * Update the story-meta annotation on testInfo with the current meta (including steps).\n * Called after each step/doc so the reporter sees the full story in onTestEnd.\n */\nfunction syncAnnotationToTest(): void {\n  if (!activeTestInfo || !activeContext) return;\n  const annotation = activeTestInfo.annotations.find(\n    (a) => a.type === 'story-meta',\n  );\n  if (annotation) {\n    annotation.description = JSON.stringify(activeContext.meta);\n  }\n}\n\n// ============================================================================\n// story.fn() and story.expect()\n// ============================================================================\n\n/**\n * Wrap a function as a step with timing and error capture.\n * Records the step with `wrapped: true` and `durationMs`.\n */\nfunction fn<T>(keyword: StepKeyword, text: string, body: (fixtures: PlaywrightFixtures) => T): T;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction fn<T>(keyword: StepKeyword, text: string, body: (...args: any[]) => T): T {\n  const ctx = getContext();\n  const resolvedKeyword: StepKeyword =\n    (keyword === 'Given' || keyword === 'When' || keyword === 'Then') &&\n    ctx.meta.steps.some((s) => s.keyword === keyword)\n      ? 'And'\n      : keyword;\n  const step: StoryStep = {\n    id: `step-${ctx.stepCounter++}`,\n    keyword: resolvedKeyword,\n    text,\n    docs: [],\n    wrapped: true,\n  };\n  ctx.meta.steps.push(step);\n  ctx.currentStep = step;\n  syncAnnotationToTest();\n\n  const start = performance.now();\n  try {\n    const result = ctx.fixtures !== undefined ? body(ctx.fixtures as PlaywrightFixtures) : body();\n    if (result instanceof Promise) {\n      return result.then(\n        (val) => {\n          step.durationMs = performance.now() - start;\n          syncAnnotationToTest();\n          return val;\n        },\n        (err) => {\n          step.durationMs = performance.now() - start;\n          syncAnnotationToTest();\n          throw err;\n        },\n      ) as T;\n    }\n    step.durationMs = performance.now() - start;\n    syncAnnotationToTest();\n    return result;\n  } catch (err) {\n    step.durationMs = performance.now() - start;\n    syncAnnotationToTest();\n    throw err;\n  }\n}\n\n/**\n * Wrap an assertion as a Then step with timing and error capture.\n * Shorthand for `story.fn('Then', text, body)`.\n */\nfunction storyExpect<T>(text: string, body: () => T): T {\n  return fn('Then', text, body);\n}\n\n// ============================================================================\n// Playwright-specific attach\n// ============================================================================\n\nfunction playwrightAttach(options: AttachmentOptions): void {\n  const ctx = getContext();\n  const stepIndex = ctx.currentStep\n    ? ctx.meta.steps.indexOf(ctx.currentStep)\n    : undefined;\n  ctx.attachments.push({\n    ...options,\n    stepId: ctx.currentStep?.id,\n  });\n  syncAnnotationToTest();\n\n  if (activeTestInfo) {\n    const attachOptions: { name: string; contentType: string; path?: string; body?: string | Buffer } = {\n      name: options.name,\n      contentType: options.mediaType,\n    };\n    if (options.path) attachOptions.path = options.path;\n    if (options.body) attachOptions.body = options.body;\n    activeTestInfo.attach(options.name, attachOptions);\n  }\n}\n\n// ============================================================================\n// Export story object\n// ============================================================================\n\nexport const story = {\n  init,\n\n  // BDD step markers\n  given: createStepMarker('Given'),\n  when: createStepMarker('When'),\n  then: createStepMarker('Then'),\n  and: createStepMarker('And'),\n  but: createStepMarker('But'),\n\n  // AAA pattern aliases\n  arrange: createStepMarker('Given'),\n  act: createStepMarker('When'),\n  assert: createStepMarker('Then'),\n\n  // Additional aliases\n  setup: createStepMarker('Given'),\n  context: createStepMarker('Given'),\n  execute: createStepMarker('When'),\n  action: createStepMarker('When'),\n  verify: createStepMarker('Then'),\n\n  // Standalone doc methods\n  note(text: string, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'note', text, phase: 'runtime' }, children);\n  },\n\n  tag(name: string | string[], children?: DocEntry[]): DocEntry {\n    const names = Array.isArray(name) ? name : [name];\n    return attachDoc({ kind: 'tag', names, phase: 'runtime' }, children);\n  },\n\n  kv(options: KvOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'kv', label: options.label, value: options.value, phase: 'runtime' }, children);\n  },\n\n  json(options: JsonOptions, children?: DocEntry[]): DocEntry {\n    const content = JSON.stringify(options.value, null, 2);\n    return attachDoc({ kind: 'code', label: options.label, content, lang: 'json', phase: 'runtime' }, children);\n  },\n\n  code(options: CodeOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'code', label: options.label, content: options.content, lang: options.lang, phase: 'runtime' }, children);\n  },\n\n  table(options: TableOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'table', label: options.label, columns: options.columns, rows: options.rows, phase: 'runtime' }, children);\n  },\n\n  link(options: LinkOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'link', label: options.label, url: options.url, phase: 'runtime' }, children);\n  },\n\n  section(options: SectionOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'section', title: options.title, markdown: options.markdown, phase: 'runtime' }, children);\n  },\n\n  mermaid(options: MermaidOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'mermaid', code: options.code, title: options.title, phase: 'runtime' }, children);\n  },\n\n  screenshot(options: ScreenshotOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'screenshot', path: options.path, alt: options.alt, phase: 'runtime' }, children);\n  },\n\n  custom(options: CustomOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'custom', type: options.type, data: options.data, phase: 'runtime' }, children);\n  },\n\n  // Attachments\n  attach: playwrightAttach,\n\n  // OTel span attachment\n  attachSpans(spans: ReadonlyArray<Record<string, unknown>>): void {\n    if (!activeTestInfo) return;\n    const existing = activeTestInfo.annotations.find(\n      (a) => a.type === 'story-otel-spans',\n    );\n    const description = JSON.stringify(spans);\n    if (existing) {\n      existing.description = description;\n    } else {\n      activeTestInfo.annotations.push({\n        type: 'story-otel-spans',\n        description,\n      });\n    }\n  },\n\n  // Step timing\n  startTimer(): number {\n    const ctx = getContext();\n    const token = ctx.timerCounter++;\n    const stepIndex = ctx.currentStep\n      ? ctx.meta.steps.indexOf(ctx.currentStep)\n      : undefined;\n    ctx.activeTimers.set(token, {\n      start: performance.now(),\n      stepIndex: stepIndex !== undefined && stepIndex >= 0 ? stepIndex : undefined,\n      stepId: ctx.currentStep?.id,\n      consumed: false,\n    });\n    syncAnnotationToTest();\n    return token;\n  },\n\n  endTimer(token: number): void {\n    const ctx = getContext();\n    const entry = ctx.activeTimers.get(token);\n    if (!entry || entry.consumed) return;\n\n    entry.consumed = true;\n    const durationMs = performance.now() - entry.start;\n\n    let step: StoryStep | undefined;\n    if (entry.stepId) {\n      step = ctx.meta.steps.find((s) => s.id === entry.stepId);\n    }\n    if (!step && entry.stepIndex !== undefined) {\n      step = ctx.meta.steps[entry.stepIndex];\n    }\n\n    if (step) {\n      step.durationMs = durationMs;\n    }\n    syncAnnotationToTest();\n  },\n\n  // Step wrappers\n  fn,\n  expect: storyExpect,\n};\n\nexport type Story = typeof story;\n","/**\n * Playwright Executable Stories\n *\n * BDD-style executable documentation for Playwright Test.\n *\n * @example\n * ```ts\n * import { test, expect } from '@playwright/test';\n * import { story } from 'executable-stories-playwright';\n *\n * test.describe('Calculator', () => {\n *   test('adds two numbers', async ({ page }, testInfo) => {\n *     story.init(testInfo);\n *\n *     story.given('two numbers 5 and 3');\n *     const a = 5;\n *     const b = 3;\n *\n *     story.when('I add them together');\n *     const result = a + b;\n *\n *     story.then('the result is 8');\n *     expect(result).toBe(8);\n *   });\n * });\n * ```\n */\n\n// Story API\nimport { story } from './story-api';\nexport { story };\nexport type { Story } from './story-api';\n\n// Top-level step helpers (framework contract)\nexport const given = story.given;\nexport const when = story.when;\nexport const then = story.then;\nexport const and = story.and;\nexport const but = story.but;\n\n// Re-export types from local types module\nexport type {\n  StoryMeta,\n  StoryStep,\n  DocEntry,\n  StepKeyword,\n  StoryDocs,\n  StoryOptions,\n  TicketInput,\n  NormalizedTicket,\n  KvOptions,\n  JsonOptions,\n  CodeOptions,\n  TableOptions,\n  LinkOptions,\n  SectionOptions,\n  MermaidOptions,\n  ScreenshotOptions,\n  CustomOptions,\n} from './types';\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/story-api.ts","../src/step-runner.ts","../src/index.ts"],"sourcesContent":["/**\n * Playwright story.* API for executable-stories.\n *\n * Uses native Playwright test() with opt-in documentation:\n *\n * @example\n * ```ts\n * import { test, expect } from '@playwright/test';\n * import { story } from 'executable-stories-playwright';\n *\n * test.describe('Calculator', () => {\n *   test('adds two numbers', async ({ page }, testInfo) => {\n *     story.init(testInfo);\n *\n *     story.given('two numbers 5 and 3');\n *     const a = 5;\n *     const b = 3;\n *\n *     story.when('I add them together');\n *     const result = a + b;\n *\n *     story.then('the result is 8');\n *     expect(result).toBe(8);\n *   });\n * });\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { TestInfo, PlaywrightTestArgs, PlaywrightTestOptions } from '@playwright/test';\nimport {\n  tryGetActiveOtelContext,\n  resolveTraceUrl,\n} from 'executable-stories-formatters';\nimport type {\n  StepKeyword,\n  StoryMeta,\n  StoryStep,\n  DocEntry,\n  NormalizedTicket,\n  TicketInput,\n} from './types';\nimport type {\n  StoryDocs,\n  StoryOptions,\n  AttachmentOptions,\n  ScopedAttachment,\n  KvOptions,\n  JsonOptions,\n  CodeOptions,\n  TableOptions,\n  LinkOptions,\n  SectionOptions,\n  MermaidOptions,\n  ScreenshotOptions,\n  CustomOptions,\n  ConsoleOptions,\n} from './types';\nimport { runStep, isAsyncFunction } from './step-runner';\nimport type { TestStepInfo } from './step-runner';\n\n// Re-export types for consumers\nexport type {\n  StoryMeta,\n  StoryStep,\n  DocEntry,\n  StepKeyword,\n  StoryDocs,\n  StoryOptions,\n  AttachmentOptions,\n} from './types';\n\n// ============================================================================\n// Internal types\n// ============================================================================\n\n/** Fixture type for step callbacks: Playwright test args + options; custom extend() fixtures as unknown. */\ntype PlaywrightFixtures = PlaywrightTestArgs & PlaywrightTestOptions & Record<string, unknown>;\n\ninterface TimerEntry {\n  start: number;\n  stepIndex?: number;\n  stepId?: string;\n  consumed: boolean;\n}\n\ninterface StoryContext {\n  meta: StoryMeta;\n  currentStep: StoryStep | null;\n  stepCounter: number;\n  attachments: ScopedAttachment[];\n  activeTimers: Map<number, TimerEntry>;\n  timerCounter: number;\n  fixtures?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Playwright-specific context\n// ============================================================================\n\n/** Active story context - set by story.init() */\nlet activeContext: StoryContext | null = null;\n\n/** Reference to testInfo for attaching metadata */\nlet activeTestInfo: TestInfo | null = null;\n\n/** Counter to track source order of stories (increments on each story.init call) */\nlet sourceOrderCounter = 0;\n\n/**\n * Get the current story context. Throws if story.init() wasn't called.\n */\nfunction getContext(): StoryContext {\n  if (!activeContext) {\n    throw new Error(\n      \"story.init(testInfo) must be called first. Use: test('name', async ({ page }, testInfo) => { story.init(testInfo); ... });\",\n    );\n  }\n  return activeContext;\n}\n\n// ============================================================================\n// Helper functions (inlined from core)\n// ============================================================================\n\nfunction normalizeTickets(\n  ticket: TicketInput | TicketInput[] | undefined,\n): NormalizedTicket[] | undefined {\n  if (!ticket) return undefined;\n  const arr = Array.isArray(ticket) ? ticket : [ticket];\n  return arr.map((t) => (typeof t === 'string' ? { id: t } : t));\n}\n\nfunction convertStoryDocsToEntries(docs: StoryDocs): DocEntry[] {\n  const entries: DocEntry[] = [];\n\n  if (docs.note) {\n    entries.push({ kind: 'note', text: docs.note, phase: 'runtime' });\n  }\n  if (docs.tag) {\n    const names = Array.isArray(docs.tag) ? docs.tag : [docs.tag];\n    entries.push({ kind: 'tag', names, phase: 'runtime' });\n  }\n  if (docs.kv) {\n    for (const [label, value] of Object.entries(docs.kv)) {\n      entries.push({ kind: 'kv', label, value, phase: 'runtime' });\n    }\n  }\n  if (docs.code) {\n    entries.push({\n      kind: 'code',\n      label: docs.code.label,\n      content: docs.code.content,\n      lang: docs.code.lang,\n      phase: 'runtime',\n    });\n  }\n  if (docs.json) {\n    entries.push({\n      kind: 'code',\n      label: docs.json.label,\n      content: JSON.stringify(docs.json.value, null, 2),\n      lang: 'json',\n      phase: 'runtime',\n    });\n  }\n  if (docs.table) {\n    entries.push({\n      kind: 'table',\n      label: docs.table.label,\n      columns: docs.table.columns,\n      rows: docs.table.rows,\n      phase: 'runtime',\n    });\n  }\n  if (docs.link) {\n    entries.push({\n      kind: 'link',\n      label: docs.link.label,\n      url: docs.link.url,\n      phase: 'runtime',\n    });\n  }\n  if (docs.section) {\n    entries.push({\n      kind: 'section',\n      title: docs.section.title,\n      markdown: docs.section.markdown,\n      phase: 'runtime',\n    });\n  }\n  if (docs.mermaid) {\n    entries.push({\n      kind: 'mermaid',\n      code: docs.mermaid.code,\n      title: docs.mermaid.title,\n      phase: 'runtime',\n    });\n  }\n  if (docs.screenshot) {\n    entries.push({\n      kind: 'screenshot',\n      path: docs.screenshot.path,\n      alt: docs.screenshot.alt,\n      phase: 'runtime',\n    });\n  }\n  if (docs.custom) {\n    entries.push({\n      kind: 'custom',\n      type: docs.custom.type,\n      data: docs.custom.data,\n      phase: 'runtime',\n    });\n  }\n\n  return entries;\n}\n\nfunction attachDoc(entry: DocEntry, children?: DocEntry[]): DocEntry {\n  const ctx = getContext();\n  if (children && children.length > 0) {\n    entry.children = children;\n    const childSet = new Set<DocEntry>(children);\n    const filterDocs = (docs: DocEntry[]) => docs.filter((d) => !childSet.has(d));\n    // Remove children from ALL containers (story-level + every step)\n    ctx.meta.docs = filterDocs(ctx.meta.docs ?? []);\n    for (const step of ctx.meta.steps) {\n      if (step.docs) step.docs = filterDocs(step.docs);\n    }\n  }\n  if (ctx.currentStep) {\n    ctx.currentStep.docs ??= [];\n    ctx.currentStep.docs.push(entry);\n  } else {\n    ctx.meta.docs ??= [];\n    ctx.meta.docs.push(entry);\n  }\n  syncAnnotationToTest();\n  return entry;\n}\n\n// ============================================================================\n// Suite path extraction\n// ============================================================================\n\n/**\n * Extract the suite path from testInfo.titlePath.\n * Playwright's titlePath includes: [projectName, ...describeTitles, testTitle]\n * We want just the describe titles (excluding project and test name).\n */\nfunction extractSuitePath(testInfo: TestInfo): string[] | undefined {\n  const titlePath = testInfo.titlePath;\n  if (titlePath.length <= 2) {\n    return undefined;\n  }\n  const suitePath = titlePath.slice(1, -1);\n  return suitePath.length > 0 ? suitePath : undefined;\n}\n\n// ============================================================================\n// Step markers\n// ============================================================================\n\nfunction createStepMarker(keyword: StepKeyword) {\n  function stepMarker(text: string, docs?: StoryDocs): void;\n  function stepMarker(text: string, children: DocEntry[]): void;\n  function stepMarker<T>(text: string, body: (fixtures: PlaywrightFixtures, step?: TestStepInfo) => T): T;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  function stepMarker<T>(text: string, docsOrBody?: StoryDocs | DocEntry[] | ((...args: any[]) => T)): T | void {\n    const ctx = getContext();\n    const isCallback = typeof docsOrBody === 'function';\n    const isChildrenArray = Array.isArray(docsOrBody);\n\n    const resolvedKeyword: StepKeyword =\n      (keyword === 'Given' || keyword === 'When' || keyword === 'Then') &&\n      ctx.meta.steps.some((s) => s.keyword === keyword)\n        ? 'And'\n        : keyword;\n\n    let stepDocs: DocEntry[] = [];\n    if (!isCallback && !isChildrenArray && docsOrBody) {\n      stepDocs = convertStoryDocsToEntries(docsOrBody as StoryDocs);\n    }\n\n    const step: StoryStep = {\n      id: `step-${ctx.stepCounter++}`,\n      keyword: resolvedKeyword,\n      text,\n      docs: stepDocs,\n      ...(isCallback ? { wrapped: true } : {}),\n    };\n\n    ctx.meta.steps.push(step);\n    ctx.currentStep = step;\n    syncAnnotationToTest();\n\n    // Handle DocEntry[] children: attach as step docs and deduplicate from story-level\n    if (isChildrenArray) {\n      const children = docsOrBody as DocEntry[];\n      if (children.length > 0) {\n        const childSet = new Set<DocEntry>(children);\n        // Deduplicate from story-level docs\n        ctx.meta.docs = (ctx.meta.docs ?? []).filter((d) => !childSet.has(d));\n        // Deduplicate from step docs of earlier steps\n        for (const prevStep of ctx.meta.steps) {\n          if (prevStep !== step && prevStep.docs) {\n            prevStep.docs = prevStep.docs.filter((d) => !childSet.has(d));\n          }\n        }\n        step.docs = [...(step.docs ?? []), ...children];\n      }\n      syncAnnotationToTest();\n      return;\n    }\n\n    if (!isCallback) return;\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const body = docsOrBody as (fixtures?: PlaywrightFixtures, stepInfo?: TestStepInfo) => T;\n    const label = `${step.keyword}: ${text}`;\n    const start = performance.now();\n\n    // ── Async or stepInfo-aware callbacks: route through runStep() for Playwright-native integrations ──\n    // Integrations: screencast chapters (v1.59), test.step/TestStepInfo (v1.51),\n    // tracing.group (v1.49). Activated when fixtures are available AND either:\n    //   1. callback is an async function, OR\n    //   2. callback expects TestStepInfo (arity >= 2)\n    if (ctx.fixtures !== undefined && (isAsyncFunction(body) || body.length >= 2)) {\n      const fixtures = ctx.fixtures as Record<string, unknown>;\n      const result = runStep(\n        label,\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        body as unknown as (fixtures: Record<string, unknown>, step?: TestStepInfo) => Promise<any>,\n        fixtures,\n      );\n      return result.then(\n        (val: T) => { step.durationMs = performance.now() - start; syncAnnotationToTest(); return val; },\n        (err: unknown) => { step.durationMs = performance.now() - start; syncAnnotationToTest(); throw err; },\n      ) as T;\n    }\n\n    // ── Sync callbacks or no-fixture context: existing behaviour ─────────────\n    try {\n      const result = ctx.fixtures !== undefined ? body(ctx.fixtures as PlaywrightFixtures) : body();\n      if (result instanceof Promise) {\n        return result.then(\n          (val) => { step.durationMs = performance.now() - start; syncAnnotationToTest(); return val; },\n          (err) => { step.durationMs = performance.now() - start; syncAnnotationToTest(); throw err; },\n        ) as T;\n      }\n      step.durationMs = performance.now() - start;\n      syncAnnotationToTest();\n      return result;\n    } catch (err) {\n      step.durationMs = performance.now() - start;\n      syncAnnotationToTest();\n      throw err;\n    }\n  }\n  return stepMarker;\n}\n\n// ============================================================================\n// story.init() - Playwright-specific\n// ============================================================================\n\nfunction isTestInfo(x: unknown): x is TestInfo {\n  return (\n    typeof x === 'object' &&\n    x !== null &&\n    'title' in x &&\n    'annotations' in x &&\n    Array.isArray((x as TestInfo).annotations)\n  );\n}\n\n/** init(testInfo) or init(fixtures, testInfo) or init(testInfo, { fixtures }). */\nfunction init(\n  first: TestInfo | unknown,\n  second?: StoryOptions | TestInfo,\n  third?: StoryOptions,\n): void {\n  let testInfo: TestInfo;\n  let options: StoryOptions | undefined;\n  let fixtures: unknown;\n\n  if (second !== undefined && isTestInfo(second)) {\n    fixtures = first;\n    testInfo = second;\n    options = third;\n  } else {\n    testInfo = first as TestInfo;\n    options = second;\n    fixtures = options?.fixtures;\n  }\n\n  const meta: StoryMeta = {\n    scenario: testInfo.title,\n    steps: [],\n    suitePath: extractSuitePath(testInfo),\n    tags: options?.tags,\n    tickets: normalizeTickets(options?.ticket),\n    meta: options?.meta,\n    sourceOrder: sourceOrderCounter++,\n  };\n\n  // OTel bridge: detect active span, flow data bidirectionally\n  const otelCtx = tryGetActiveOtelContext();\n  if (otelCtx) {\n    // OTel -> Story: capture traceId in structured meta\n    meta.meta = { ...meta.meta, otel: { traceId: otelCtx.traceId, spanId: otelCtx.spanId } };\n\n    // OTel -> Story: inject human-readable doc entries\n    meta.docs = meta.docs ?? [];\n    meta.docs.push({ kind: 'kv', label: 'Trace ID', value: otelCtx.traceId, phase: 'runtime' });\n\n    const template = options?.traceUrlTemplate ?? process.env.OTEL_TRACE_URL_TEMPLATE;\n    const url = resolveTraceUrl(template, otelCtx.traceId);\n    if (url) {\n      meta.docs.push({ kind: 'link', label: 'View Trace', url, phase: 'runtime' });\n    }\n\n    // Story -> OTel: enrich active span with story attributes\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      const reqUrl = import.meta.url\n        ?? (typeof __filename !== 'undefined' ? `file://${__filename}` : undefined);\n      const req = createRequire(reqUrl!);\n      const api = req('@opentelemetry/api');\n      const span = api.trace?.getActiveSpan?.();\n      if (span) {\n        span.setAttribute('story.scenario', testInfo.title);\n        if (options?.tags?.length) span.setAttribute('story.tags', options.tags);\n        if (options?.ticket) {\n          const tickets = Array.isArray(options.ticket) ? options.ticket : [options.ticket];\n          span.setAttribute('story.tickets', tickets.map((t) => typeof t === 'string' ? t : t.id));\n        }\n      }\n    } catch { /* OTel not available */ }\n  }\n\n  testInfo.annotations.push({\n    type: 'story-meta',\n    description: JSON.stringify(meta),\n  });\n\n  // ── Feature: Tag sync (v1.43) ─────────────────────────────────────────────\n  // Sync story tags to Playwright's native annotation system so they appear in\n  // UI Mode tag filters and the HTML reporter's tag display.\n  for (const tag of options?.tags ?? []) {\n    testInfo.annotations.push({ type: 'tag', description: tag });\n  }\n\n  activeContext = {\n    meta,\n    currentStep: null,\n    stepCounter: 0,\n    attachments: [],\n    activeTimers: new Map(),\n    timerCounter: 0,\n    fixtures: fixtures as Record<string, unknown> | undefined,\n  };\n  activeTestInfo = testInfo;\n}\n\n/**\n * Update the story-meta annotation on testInfo with the current meta (including steps).\n * Called after each step/doc so the reporter sees the full story in onTestEnd.\n */\nfunction syncAnnotationToTest(): void {\n  if (!activeTestInfo || !activeContext) return;\n  const annotation = activeTestInfo.annotations.find(\n    (a) => a.type === 'story-meta',\n  );\n  if (annotation) {\n    annotation.description = JSON.stringify(activeContext.meta);\n  }\n}\n\n// ============================================================================\n// story.fn() and story.expect()\n// ============================================================================\n\n/**\n * Wrap a function as a step with timing and error capture.\n * Records the step with `wrapped: true` and `durationMs`.\n */\nfunction fn<T>(keyword: StepKeyword, text: string, body: (fixtures: PlaywrightFixtures) => T): T;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction fn<T>(keyword: StepKeyword, text: string, body: (...args: any[]) => T): T {\n  const ctx = getContext();\n  const resolvedKeyword: StepKeyword =\n    (keyword === 'Given' || keyword === 'When' || keyword === 'Then') &&\n    ctx.meta.steps.some((s) => s.keyword === keyword)\n      ? 'And'\n      : keyword;\n  const step: StoryStep = {\n    id: `step-${ctx.stepCounter++}`,\n    keyword: resolvedKeyword,\n    text,\n    docs: [],\n    wrapped: true,\n  };\n  ctx.meta.steps.push(step);\n  ctx.currentStep = step;\n  syncAnnotationToTest();\n\n  const start = performance.now();\n  try {\n    const result = ctx.fixtures !== undefined ? body(ctx.fixtures as PlaywrightFixtures) : body();\n    if (result instanceof Promise) {\n      return result.then(\n        (val) => {\n          step.durationMs = performance.now() - start;\n          syncAnnotationToTest();\n          return val;\n        },\n        (err) => {\n          step.durationMs = performance.now() - start;\n          syncAnnotationToTest();\n          throw err;\n        },\n      ) as T;\n    }\n    step.durationMs = performance.now() - start;\n    syncAnnotationToTest();\n    return result;\n  } catch (err) {\n    step.durationMs = performance.now() - start;\n    syncAnnotationToTest();\n    throw err;\n  }\n}\n\n/**\n * Wrap an assertion as a Then step with timing and error capture.\n * Shorthand for `story.fn('Then', text, body)`.\n */\nfunction storyExpect<T>(text: string, body: () => T): T {\n  return fn('Then', text, body);\n}\n\n// ============================================================================\n// Playwright-specific attach\n// ============================================================================\n\nfunction playwrightAttach(options: AttachmentOptions): void {\n  const ctx = getContext();\n  const stepIndex = ctx.currentStep\n    ? ctx.meta.steps.indexOf(ctx.currentStep)\n    : undefined;\n  ctx.attachments.push({\n    ...options,\n    stepId: ctx.currentStep?.id,\n  });\n  syncAnnotationToTest();\n\n  if (activeTestInfo) {\n    const attachOptions: { name: string; contentType: string; path?: string; body?: string | Buffer } = {\n      name: options.name,\n      contentType: options.mediaType,\n    };\n    if (options.path) attachOptions.path = options.path;\n    if (options.body) attachOptions.body = options.body;\n    activeTestInfo.attach(options.name, attachOptions);\n  }\n}\n\n// ============================================================================\n// Export story object\n// ============================================================================\n\nexport const story = {\n  init,\n\n  // BDD step markers\n  given: createStepMarker('Given'),\n  when: createStepMarker('When'),\n  then: createStepMarker('Then'),\n  and: createStepMarker('And'),\n  but: createStepMarker('But'),\n\n  // AAA pattern aliases\n  arrange: createStepMarker('Given'),\n  act: createStepMarker('When'),\n  assert: createStepMarker('Then'),\n\n  // Additional aliases\n  setup: createStepMarker('Given'),\n  context: createStepMarker('Given'),\n  execute: createStepMarker('When'),\n  action: createStepMarker('When'),\n  verify: createStepMarker('Then'),\n\n  // Standalone doc methods\n  note(text: string, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'note', text, phase: 'runtime' }, children);\n  },\n\n  tag(name: string | string[], children?: DocEntry[]): DocEntry {\n    const names = Array.isArray(name) ? name : [name];\n    return attachDoc({ kind: 'tag', names, phase: 'runtime' }, children);\n  },\n\n  kv(options: KvOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'kv', label: options.label, value: options.value, phase: 'runtime' }, children);\n  },\n\n  json(options: JsonOptions, children?: DocEntry[]): DocEntry {\n    const content = JSON.stringify(options.value, null, 2);\n    return attachDoc({ kind: 'code', label: options.label, content, lang: 'json', phase: 'runtime' }, children);\n  },\n\n  code(options: CodeOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'code', label: options.label, content: options.content, lang: options.lang, phase: 'runtime' }, children);\n  },\n\n  table(options: TableOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'table', label: options.label, columns: options.columns, rows: options.rows, phase: 'runtime' }, children);\n  },\n\n  link(options: LinkOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'link', label: options.label, url: options.url, phase: 'runtime' }, children);\n  },\n\n  section(options: SectionOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'section', title: options.title, markdown: options.markdown, phase: 'runtime' }, children);\n  },\n\n  mermaid(options: MermaidOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'mermaid', code: options.code, title: options.title, phase: 'runtime' }, children);\n  },\n\n  screenshot(options: ScreenshotOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'screenshot', path: options.path, alt: options.alt, phase: 'runtime' }, children);\n  },\n\n  custom(options: CustomOptions, children?: DocEntry[]): DocEntry {\n    return attachDoc({ kind: 'custom', type: options.type, data: options.data, phase: 'runtime' }, children);\n  },\n\n  // ── Feature: Console capture (v1.56) ────────────────────────────────────\n  /**\n   * Snapshot the current page console messages (and optionally page errors)\n   * and attach them as a code doc entry.\n   *\n   * Uses page.consoleMessages() and page.pageErrors() introduced in Playwright v1.56.\n   * Safe to call on any Playwright version – silently produces empty output if the\n   * APIs are not present.\n   *\n   * @example\n   * story.when('the form is submitted', async ({ page }) => {\n   *   await page.click('#submit');\n   *   story.console({ page, label: 'Submit console output' });\n   * });\n   */\n  console(options: ConsoleOptions, children?: DocEntry[]): DocEntry {\n    const p = options.page as {\n      consoleMessages?: () => Array<{ type(): string; text(): string }>;\n      pageErrors?: () => Error[];\n    };\n\n    const lines: string[] = [];\n\n    if (typeof p?.consoleMessages === 'function') {\n      for (const msg of p.consoleMessages()) {\n        lines.push(`[${msg.type()}] ${msg.text()}`);\n      }\n    }\n\n    if (options.includeErrors === true && typeof p?.pageErrors === 'function') {\n      for (const err of p.pageErrors()) {\n        lines.push(`[error] ${err.message}`);\n      }\n    }\n\n    return attachDoc(\n      {\n        kind: 'code',\n        label: options.label ?? 'Console',\n        content: lines.length > 0 ? lines.join('\\n') : '(no console output)',\n        lang: 'log',\n        phase: 'runtime',\n      },\n      children,\n    );\n  },\n\n  // Attachments\n  attach: playwrightAttach,\n\n  // OTel span attachment\n  attachSpans(spans: ReadonlyArray<Record<string, unknown>>): void {\n    if (!activeTestInfo) return;\n    const existing = activeTestInfo.annotations.find(\n      (a) => a.type === 'story-otel-spans',\n    );\n    const description = JSON.stringify(spans);\n    if (existing) {\n      existing.description = description;\n    } else {\n      activeTestInfo.annotations.push({\n        type: 'story-otel-spans',\n        description,\n      });\n    }\n  },\n\n  // Step timing\n  startTimer(): number {\n    const ctx = getContext();\n    const token = ctx.timerCounter++;\n    const stepIndex = ctx.currentStep\n      ? ctx.meta.steps.indexOf(ctx.currentStep)\n      : undefined;\n    ctx.activeTimers.set(token, {\n      start: performance.now(),\n      stepIndex: stepIndex !== undefined && stepIndex >= 0 ? stepIndex : undefined,\n      stepId: ctx.currentStep?.id,\n      consumed: false,\n    });\n    syncAnnotationToTest();\n    return token;\n  },\n\n  endTimer(token: number): void {\n    const ctx = getContext();\n    const entry = ctx.activeTimers.get(token);\n    if (!entry || entry.consumed) return;\n\n    entry.consumed = true;\n    const durationMs = performance.now() - entry.start;\n\n    let step: StoryStep | undefined;\n    if (entry.stepId) {\n      step = ctx.meta.steps.find((s) => s.id === entry.stepId);\n    }\n    if (!step && entry.stepIndex !== undefined) {\n      step = ctx.meta.steps[entry.stepIndex];\n    }\n\n    if (step) {\n      step.durationMs = durationMs;\n    }\n    syncAnnotationToTest();\n  },\n\n  // Step wrappers\n  fn,\n  expect: storyExpect,\n};\n\nexport type Story = typeof story;\n","/**\n * Playwright-native step execution helper.\n *\n * Centralises the cross-cutting concerns for fixture-aware step callbacks:\n *   1. page.screencast.showChapter() – narrated chapter markers in video recordings (v1.59)\n *   2. test.step()                    – TestStepInfo access + trace/report visibility (v1.51)\n *   3. context.tracing.group()       – BDD phase grouping in trace viewer (v1.49)\n *\n * Used for callbacks that are either async functions or expect TestStepInfo.\n * Sync callbacks that don't need TestStepInfo follow the faster sync path.\n * All three integrations degrade gracefully if the API is absent.\n */\n\nimport { test } from '@playwright/test';\nimport type { TestStepInfo } from '@playwright/test';\n\nexport type { TestStepInfo };\n\n/** Async step callback that optionally receives TestStepInfo as a second argument. */\nexport type AsyncStepCallback<T = unknown> = (\n  fixtures: Record<string, unknown>,\n  step?: TestStepInfo,\n) => Promise<T>;\n\n/**\n * Execute an async step callback with full Playwright-native integration.\n *\n * Call order:\n *   1. page.screencast.showChapter(label) – sets chapter in the recording before the step runs\n *   2. test.step(label, …)               – wraps execution for trace/report visibility\n *   3. context.tracing.group(label, …)   – groups trace actions under the step label\n *   4. body(fixtures, stepInfo)          – user callback with injected TestStepInfo\n */\nexport async function runStep<T>(\n  label: string,\n  body: AsyncStepCallback<T>,\n  fixtures: Record<string, unknown>,\n): Promise<T> {\n  const page = fixtures.page as Record<string, unknown> | undefined;\n  // Derive context from fixtures or from page.context() (Playwright sync method)\n  const context =\n    (fixtures.context as Record<string, unknown> | undefined) ??\n    (typeof (page as { context?: () => Record<string, unknown> })?.context === 'function'\n      ? (page as { context: () => Record<string, unknown> }).context()\n      : undefined);\n\n  // ── Feature 1: Screencast chapter (v1.59) ─────────────────────────────────\n  // Show the chapter BEFORE the step body runs so the recording reflects the\n  // BDD step title at the right moment. Silently skipped on older Playwright.\n  const screencast = page?.screencast as\n    | { showChapter?: (label: string) => Promise<void> }\n    | undefined;\n  if (screencast?.showChapter) {\n    try {\n      await screencast.showChapter(label);\n    } catch {\n      // Graceful degradation: screencast not started or API unavailable\n    }\n  }\n\n  // ── Feature 2: test.step (v1.51) + Feature 3: tracing.group (v1.49) ──────\n  // test.step provides TestStepInfo for the callback and makes the step visible\n  // in the Playwright trace viewer and HTML report as a named action.\n  // tracing.group inside it groups the step's child actions under the label.\n  return test.step(label, async (stepInfo) => {\n    const tracing = context?.tracing as\n      | { group?: <R>(label: string, fn: () => Promise<R>) => Promise<R> }\n      | undefined;\n\n    if (tracing?.group) {\n      // Track whether body was invoked to avoid double-execution\n      // when body throws inside tracing.group\n      let bodyInvoked = false;\n      try {\n        return await tracing.group(label, async () => {\n          bodyInvoked = true;\n          return body(fixtures, stepInfo);\n        });\n      } catch (e) {\n        // If body was invoked, it threw - re-throw (don't retry)\n        if (bodyInvoked) throw e;\n        // Otherwise, tracing.group itself threw (e.g., tracing not recording)\n        // Fall back to calling body without tracing.group\n        return body(fixtures, stepInfo);\n      }\n    }\n\n    return body(fixtures, stepInfo);\n  });\n}\n\n/**\n * Returns true if fn is an async function (declared with `async`).\n * Used along with callback arity to decide whether to route a step callback through runStep().\n *\n * Callbacks are routed through runStep() if they are async functions OR if they\n * have arity >= 2 (meaning they expect TestStepInfo as the second argument).\n */\nexport function isAsyncFunction(fn: unknown): boolean {\n  return (\n    typeof fn === 'function' &&\n    (fn as { constructor?: { name?: string } }).constructor?.name === 'AsyncFunction'\n  );\n}\n","/**\n * Playwright Executable Stories\n *\n * BDD-style executable documentation for Playwright Test.\n *\n * @example\n * ```ts\n * import { test, expect } from '@playwright/test';\n * import { story } from 'executable-stories-playwright';\n *\n * test.describe('Calculator', () => {\n *   test('adds two numbers', async ({ page }, testInfo) => {\n *     story.init(testInfo);\n *\n *     story.given('two numbers 5 and 3');\n *     const a = 5;\n *     const b = 3;\n *\n *     story.when('I add them together');\n *     const result = a + b;\n *\n *     story.then('the result is 8');\n *     expect(result).toBe(8);\n *   });\n * });\n * ```\n */\n\n// Story API\nimport { story } from './story-api';\nexport { story };\nexport type { Story } from './story-api';\n\n// Top-level step helpers (framework contract)\nexport const given = story.given;\nexport const when = story.when;\nexport const then = story.then;\nexport const and = story.and;\nexport const but = story.but;\n\n// Re-export types from local types module\nexport type {\n  StoryMeta,\n  StoryStep,\n  DocEntry,\n  StepKeyword,\n  StoryDocs,\n  StoryOptions,\n  TicketInput,\n  NormalizedTicket,\n  KvOptions,\n  JsonOptions,\n  CodeOptions,\n  TableOptions,\n  LinkOptions,\n  SectionOptions,\n  MermaidOptions,\n  ScreenshotOptions,\n  CustomOptions,\n  ConsoleOptions,\n  AttachmentOptions,\n} from './types';\n\n// TestStepInfo re-exported from @playwright/test for consumer convenience\nexport type { TestStepInfo } from './step-runner';\n"],"mappings":"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","names":["fn"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "executable-stories-playwright",
-  "version": "8.1.4",
+  "version": "8.2.1",
   "description": "BDD-style executable stories for Playwright Test with documentation generation",
   "type": "module",
   "sideEffects": false,
@@ -25,8 +25,8 @@
     "bin"
   ],
   "peerDependencies": {
-    "@playwright/test": ">=1.58.2",
-    "autotel": ">=2.24.0"
+    "@playwright/test": ">=1.59.1",
+    "autotel": ">=2.26.0"
   },
   "peerDependenciesMeta": {
     "autotel": {
@@ -34,14 +34,14 @@
     }
   },
   "dependencies": {
-    "executable-stories-formatters": "0.7.3"
+    "executable-stories-formatters": "0.7.4"
   },
   "devDependencies": {
-    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api": "^1.9.1",
     "@playwright/test": "^1.58.2",
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.0",
     "tsup": "^8.5.1",
-    "typescript": "~5.9.3"
+    "typescript": "~6.0.2"
   },
   "repository": {
     "type": "git",
@@ -56,7 +56,7 @@
     "executable-stories"
   ],
   "bin": {
-    "intent": "./bin/intent.js"
+    "intent": "bin/intent.js"
   },
   "scripts": {
     "build": "tsup",

package/skills/playwright-converting-tests/SKILL.md

@@ -1,157 +0,0 @@
----
-name: playwright-converting-tests
-description: >
-  Incrementally adopt executable-stories in Playwright. Add story.init(testInfo)
-  and step markers to existing spec blocks. File naming .story.spec.ts.
-  TestInfo from test callback second argument. Progressive enhancement.
-type: lifecycle
-library: executable-stories-playwright
-library_version: "7.0.1"
-requires:
-  - playwright-story-api
-sources:
-  - "jagreehal/executable-stories:apps/docs-site/src/content/docs/guides/converting-playwright.md"
----
-
-This skill builds on playwright-story-api. Read playwright-story-api first.
-
-# Converting Existing Playwright Tests
-
-## Setup
-
-Install the packages and configure the reporter:
-
-```bash
-npm install -D executable-stories-playwright executable-stories-formatters
-```
-
-```typescript
-// playwright.config.ts
-import { defineConfig } from "@playwright/test";
-
-export default defineConfig({
-  reporter: [
-    ["html"],
-    ["executable-stories-playwright/reporter", { formats: ["markdown"] }],
-  ],
-});
-```
-
-## Core Patterns
-
-### Step 1: Rename the file
-
-```
-# Before
-tests/login.spec.ts
-
-# After
-tests/login.story.spec.ts
-```
-
-### Step 2: Add story.init() and step markers
-
-```typescript
-// Before
-import { test, expect } from "@playwright/test";
-
-test("logs in successfully", async ({ page }) => {
-  await page.goto("/login");
-  await page.fill("#email", "user@example.com");
-  await page.fill("#password", "secret");
-  await page.click("#submit");
-  await expect(page.locator("h1")).toHaveText("Dashboard");
-});
-```
-
-```typescript
-// After
-import { test, expect } from "@playwright/test";
-import { story, given, when, then } from "executable-stories-playwright";
-
-test("logs in successfully", async ({ page }, testInfo) => {
-  story.init(testInfo);
-
-  given("the login page is loaded");
-  await page.goto("/login");
-
-  when("valid credentials are entered");
-  await page.fill("#email", "user@example.com");
-  await page.fill("#password", "secret");
-  await page.click("#submit");
-
-  then("the dashboard is shown");
-  await expect(page.locator("h1")).toHaveText("Dashboard");
-});
-```
-
-Key change: add `testInfo` as the second parameter in the test callback.
-
-### Step 3: Minimal story
-
-```typescript
-test("loads homepage", async ({ page }, testInfo) => {
-  story.init(testInfo);
-  await page.goto("/");
-  await expect(page).toHaveTitle("My App");
-});
-```
-
-### Step 4: Add doc entries
-
-```typescript
-test("shows product details", async ({ page }, testInfo) => {
-  story.init(testInfo, { tags: ["e2e", "products"] });
-
-  given("the product page is loaded");
-  await page.goto("/products/123");
-
-  then("the product details are shown");
-  story.screenshot({ path: "screenshots/product.png", alt: "Product page" });
-  story.json({ label: "Product", value: { id: 123, name: "Widget" } });
-});
-```
-
-### Suite headings from test.describe
-
-```typescript
-test.describe("Authentication", () => {
-  test("valid login", async ({ page }, testInfo) => {
-    story.init(testInfo);
-    // "Authentication" becomes a ## heading in docs
-  });
-});
-```
-
-## Common Mistakes
-
-### HIGH Using .story.test.ts instead of .story.spec.ts
-
-Wrong: `tests/login.story.test.ts`
-Correct: `tests/login.story.spec.ts`
-
-Playwright convention uses `.spec.ts`. The reporter filters accordingly.
-
-Source: CLAUDE.md — file naming conventions
-
-### HIGH Forgetting testInfo parameter
-
-Wrong:
-
-```typescript
-test("my test", async ({ page }) => {
-  story.init();  // No testInfo
-});
-```
-
-Correct:
-
-```typescript
-test("my test", async ({ page }, testInfo) => {
-  story.init(testInfo);
-});
-```
-
-`testInfo` is the second parameter of Playwright's test callback. Without it, story metadata is not linked to the test.
-
-Source: packages/executable-stories-playwright/src/story-api.ts

package/skills/playwright-reporter-setup/SKILL.md

@@ -1,131 +0,0 @@
----
-name: playwright-reporter-setup
-description: >
-  Configure Playwright custom reporter for executable-stories-playwright.
-  playwright.config.ts reporter array. Default export from
-  executable-stories-playwright/reporter. Output formats, directory, naming.
-  Aggregated and colocated modes. rawRunPath for CLI.
-type: core
-library: executable-stories-playwright
-library_version: "7.0.1"
-sources:
-  - "jagreehal/executable-stories:packages/executable-stories-playwright/src/reporter.ts"
----
-
-# executable-stories-playwright — Reporter Setup
-
-## Setup
-
-```typescript
-// playwright.config.ts
-import { defineConfig } from "@playwright/test";
-
-export default defineConfig({
-  reporter: [
-    ["html"],
-    [
-      "executable-stories-playwright/reporter",
-      {
-        formats: ["markdown", "html"],
-        outputDir: "docs",
-        outputName: "user-stories",
-      },
-    ],
-  ],
-});
-```
-
-Peer dependency: `executable-stories-formatters` must be installed.
-
-## Core Patterns
-
-### Minimal config
-
-```typescript
-export default defineConfig({
-  reporter: [
-    ["html"],
-    ["executable-stories-playwright/reporter", { formats: ["markdown"] }],
-  ],
-});
-```
-
-### Full options
-
-```typescript
-export default defineConfig({
-  reporter: [
-    ["html"],
-    [
-      "executable-stories-playwright/reporter",
-      {
-        formats: ["markdown", "html", "junit", "cucumber-json"],
-        outputDir: "reports",
-        outputName: "test-results",
-        output: {
-          mode: "aggregated",
-        },
-        markdown: {
-          title: "User Stories",
-          includeStatusIcons: true,
-          includeErrors: true,
-          includeMetadata: true,
-          sortScenarios: "source",
-        },
-        html: {
-          title: "Test Report",
-          darkMode: true,
-          searchable: true,
-          embedScreenshots: true,
-        },
-        rawRunPath: "reports/raw-run.json",
-      },
-    ],
-  ],
-});
-```
-
-### Annotation-based metadata
-
-The reporter reads story metadata from test annotations with `type: "story-meta"`. This is handled automatically when using `story.init(testInfo)` — no manual annotation is needed.
-
-## Common Mistakes
-
-### HIGH Using default export syntax incorrectly
-
-Wrong:
-
-```typescript
-import StoryReporter from "executable-stories-playwright/reporter";
-
-export default defineConfig({
-  reporter: [
-    ["html"],
-    [new StoryReporter({ formats: ["markdown"] })],
-  ],
-});
-```
-
-Correct:
-
-```typescript
-export default defineConfig({
-  reporter: [
-    ["html"],
-    [
-      "executable-stories-playwright/reporter",
-      { formats: ["markdown"] },
-    ],
-  ],
-});
-```
-
-Playwright's reporter config expects a string path and options object tuple, not a class instance. Playwright instantiates the reporter itself from the path.
-
-Source: packages/executable-stories-playwright/src/reporter.ts
-
-### MEDIUM Default format is cucumber-json, not markdown
-
-The default `formats` is `["cucumber-json"]`. Always specify `formats: ["markdown"]` explicitly to get readable markdown output.
-
-Source: packages/executable-stories-playwright/src/reporter.ts

package/skills/playwright-story-api/SKILL.md

@@ -1,236 +0,0 @@
----
-name: playwright-story-api
-description: >
-  Write BDD stories in Playwright using executable-stories-playwright.
-  Top-level exports with TestInfo: story.init(testInfo). Async steps with
-  fixtures ({ page }). Steps: given, when, then, and, but. Doc entries:
-  json, kv, code, table, link, section, mermaid, screenshot, note, tag.
-  Auto-And keyword conversion. Aliases: arrange, act, assert.
-type: core
-library: executable-stories-playwright
-library_version: "7.0.1"
-sources:
-  - "jagreehal/executable-stories:packages/executable-stories-playwright/src/story-api.ts"
-  - "jagreehal/executable-stories:apps/docs-site/src/content/docs/playwright/playwright-story-api.md"
----
-
-# executable-stories-playwright — Story API
-
-## Setup
-
-```typescript
-import { test, expect } from "@playwright/test";
-import { story, given, when, then } from "executable-stories-playwright";
-
-test.describe("Login page", () => {
-  test("authenticates with valid credentials", async ({ page }, testInfo) => {
-    story.init(testInfo, { tags: ["auth"], ticket: "AUTH-42" });
-
-    given("the login page is loaded");
-    await page.goto("/login");
-
-    when("valid credentials are entered");
-    await page.fill("#email", "alice@example.com");
-    await page.fill("#password", "secret");
-    await page.click('button[type="submit"]');
-
-    then("the dashboard is shown");
-    await expect(page.locator("h1")).toHaveText("Dashboard");
-  });
-});
-```
-
-File naming: `*.story.spec.ts`.
-
-Playwright uses top-level step exports. `story.init(testInfo)` requires the `testInfo` parameter from the test callback.
-
-## Core Patterns
-
-### Top-level step exports with fixtures
-
-```typescript
-import { story, given, when, then, and, but } from "executable-stories-playwright";
-
-test("blocks suspended user login", async ({ page }, testInfo) => {
-  story.init(testInfo);
-
-  given("the user account exists");          // renders "Given"
-  given("the account is suspended");          // renders "And" (auto-converted)
-  when("the user submits valid credentials");
-  await page.fill("#email", "user@test.com");
-  await page.click("#submit");
-
-  then("the user sees an error message");
-  await expect(page.locator(".error")).toBeVisible();
-
-  but("the user is not logged in");           // renders "But" (always)
-  await expect(page).toHaveURL("/login");
-});
-```
-
-### Doc entries with screenshots
-
-```typescript
-test("checkout flow", async ({ page }, testInfo) => {
-  story.init(testInfo);
-
-  given("a cart with items");
-  story.json({ label: "Cart", value: { items: 3, total: 150 } });
-
-  when("the user completes checkout");
-  await page.click("#checkout");
-  await page.waitForURL("/confirmation");
-
-  then("the confirmation page is shown");
-  story.screenshot({ path: "screenshots/confirmation.png", alt: "Order confirmation" });
-  story.table({
-    label: "Order details",
-    columns: ["Item", "Qty", "Price"],
-    rows: [["Widget", "3", "$50"]],
-  });
-});
-```
-
-### Step wrappers with timing
-
-```typescript
-const response = await story.fn("When", "the API is called", async () => {
-  return page.request.get("/api/data");
-});
-
-await story.expect("the response is successful", async () => {
-  expect(response.status()).toBe(200);
-});
-```
-
-### Suite headings from test.describe
-
-```typescript
-test.describe("Authentication", () => {
-  test("valid login", async ({ page }, testInfo) => {
-    story.init(testInfo);
-    // Produces "## Authentication" heading in generated docs
-  });
-});
-```
-
-Suite path comes from `testInfo.titlePath`. Describe titles become `##` headings in generated docs.
-
-## Common Mistakes
-
-### CRITICAL Missing testInfo argument in story.init()
-
-Wrong:
-
-```typescript
-test("my test", async ({ page }) => {
-  story.init();
-  given("something");
-});
-```
-
-Correct:
-
-```typescript
-test("my test", async ({ page }, testInfo) => {
-  story.init(testInfo);
-  given("something");
-});
-```
-
-Without `testInfo`, story metadata is not linked to the test. The `testInfo` parameter must be the second argument in the Playwright test callback.
-
-Source: packages/executable-stories-playwright/src/story-api.ts
-
-### HIGH Using .story.test.ts file extension
-
-Wrong:
-
-```
-tests/login.story.test.ts
-```
-
-Correct:
-
-```
-tests/login.story.spec.ts
-```
-
-Playwright uses `.spec.ts` by convention. The reporter filters for `.story.spec.ts` files. Using `.test.ts` may cause the reporter to miss story metadata.
-
-Source: CLAUDE.md — "Story test files use .story.spec.ts (playwright)"
-
-### HIGH Forgetting testInfo in callback destructuring
-
-Wrong:
-
-```typescript
-test("my test", async ({ page }) => {
-  story.init(testInfo);  // testInfo is undefined
-});
-```
-
-Correct:
-
-```typescript
-test("my test", async ({ page }, testInfo) => {
-  story.init(testInfo);
-});
-```
-
-`testInfo` is the second parameter of the Playwright test callback, not a fixture. It must be explicitly named after the fixtures object.
-
-Source: packages/executable-stories-playwright/src/story-api.ts
-
-### MEDIUM Calling steps before story.init()
-
-Wrong:
-
-```typescript
-test("my test", async ({ page }, testInfo) => {
-  given("something");
-  story.init(testInfo);
-});
-```
-
-Correct:
-
-```typescript
-test("my test", async ({ page }, testInfo) => {
-  story.init(testInfo);
-  given("something");
-});
-```
-
-Steps called before `init()` are silently dropped because no story context exists.
-
-Source: packages/eslint-plugin-executable-stories-playwright/src/rules/require-story-context-for-steps.ts
-
-## Parameterized Scenarios (Scenario Outline equivalent)
-
-Use Playwright's data-driven pattern with `story()` to produce one scenario per data row — the framework-native replacement for Cucumber's Scenario Outline + Examples.
-
-```ts
-import { test } from "@playwright/test";
-import { story, given, when, then } from "executable-stories-playwright";
-
-const cases = [
-  { input: 1, expected: 2 },
-  { input: 2, expected: 4 },
-  { input: 3, expected: 6 },
-];
-
-for (const { input, expected } of cases) {
-  test(`doubles ${input} to ${expected}`, async ({ page }) => {
-    story(`Doubles ${input} to ${expected}`);
-    given(`the input is ${input}`);
-    when("the doubler runs");
-    then(`the result is ${expected}`);
-    // ... assertions
-  });
-}
-```
-
-Each iteration produces a separate scenario in the generated report. Use interpolated titles so each scenario has a distinct, descriptive name.
-
-Note: Playwright does not have `it.each` — use a `for...of` loop instead.