executable-stories-playwright 6.0.0 → 7.0.0

package/README.md

@@ -0,0 +1,169 @@
+# executable-stories-playwright
+
+BDD-style executable stories for Playwright Test with documentation generation. Uses Playwright’s native `test()`; step markers and optional callbacks register scenario metadata for the reporter.
+
+## Install
+
+```bash
+pnpm add -D executable-stories-playwright executable-stories-formatters
+```
+
+## Usage
+
+### Required test signature
+
+Your test callback **must** accept `testInfo` as the second argument (Playwright provides it). Call `story.init(testInfo)` at the start of each test that should be documented. If you omit `testInfo` or forget to pass it to `story.init()`, the reporter and story API will not work correctly.
+
+**When step callbacks need fixtures** (e.g. `async ({ page }) => { ... }`), pass the fixtures into `init` so the library can inject them into callbacks. Use either:
+
+- `story.init(fixtures, testInfo)` — pass the test's first argument as the first argument to `init` (recommended).
+- `story.init(testInfo, { fixtures })` — pass fixtures in the options object.
+
+If you only call `story.init(testInfo)`, step callbacks are still invoked but do **not** receive a fixtures argument. Use marker-only steps or pass fixtures when you need fixture-aware callbacks.
+
+```ts
+import { test, expect } from '@playwright/test';
+import { story } from 'executable-stories-playwright';
+
+// Minimal: no fixtures in step callbacks
+test('my scenario', async ({ page }, testInfo) => {
+  story.init(testInfo);
+  story.given('user is on page');
+  await page.goto('/');
+  story.then('page loaded');
+  await expect(page).toHaveURL('/');
+});
+
+// Fixture-aware step callbacks: pass fixtures into init
+test('login flow', async ({ page }, testInfo) => {
+  story.init({ page }, testInfo);
+  await story.given('user is on login page', async ({ page }) => {
+    await page.goto('/login');
+  });
+  await story.when('user submits credentials', async ({ page }) => {
+    await page.getByRole('button', { name: 'Sign in' }).click();
+  });
+  story.then('user sees dashboard');
+});
+```
+
+Signature: `test('title', async ({ page }, testInfo) => { ... })` or `test('title', async ({}, testInfo) => { ... })`. Always pass `testInfo` into `story.init(...)`; pass the fixtures object as the first argument to `init` when you want step callbacks to receive it.
+
+---
+
+## Reporter
+
+Add the executable-stories reporter to your Playwright config. Use the **reporter module path** (string). You can pass options as the second element of the tuple; the reporter does not require a constructor call at the call site.
+
+**Config (`playwright.config.ts`):**
+
+```ts
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  reporter: [
+    ['list'],
+    ['html'],
+    ['executable-stories-playwright/reporter', {
+      formats: ['markdown'],
+      outputDir: 'docs',
+      outputName: 'user-stories',
+      output: { mode: 'aggregated' },
+    }],
+  ],
+  use: { ...devices['Desktop Chrome'] },
+});
+```
+
+If you need a resolved path (e.g. in some setups):
+
+```ts
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const reporterPath = require.resolve('executable-stories-playwright/reporter');
+
+export default defineConfig({
+  reporter: [
+    ['list'],
+    [reporterPath, { formats: ['markdown'], outputDir: 'docs', outputName: 'user-stories' }],
+  ],
+});
+```
+
+Options match [FormatterOptions](https://github.com/jagreehal/executable-stories/tree/main/packages/executable-stories-formatters) (e.g. `formats`, `outputDir`, `outputName`, `output`, `markdown`, `html`). Optional `rawRunPath` writes the raw run JSON for use with the executable-stories CLI.
+
+---
+
+## Step styles
+
+Same two styles as the Vitest package: **marker-only** (code after the marker) and **optional callback** (function as second argument). When you pass a function, it is run and its return value (including a Promise) is returned so `await story.when('...', async () => { ... })` works.
+
+**Fixture-aware callbacks:** To have step callbacks receive Playwright fixtures (e.g. `{ page }`), pass fixtures into `story.init`: use `story.init({ page }, testInfo)` (or `story.init(testInfo, { fixtures: { page } })`). Then you can write e.g. `story.given('user is on login page', async ({ page }) => { await page.goto('/login'); });` and the callback will receive the same fixtures object.
+
+---
+
+## E2E example
+
+Typical browser flow with `page`, navigation, locators, and Playwright `expect`:
+
+```ts
+import { test, expect } from '@playwright/test';
+import { story } from 'executable-stories-playwright';
+
+test('user can play diagram animation', async ({ page }, testInfo) => {
+  story.init(testInfo, { tags: ['e2e', 'animation'] });
+
+  story.given('the user is on the diagram page');
+  await page.goto('/diagrams');
+  await page.waitForSelector('.mermaid');
+
+  story.when('the user clicks Play');
+  await page.getByRole('button', { name: 'Play' }).click();
+
+  story.then('an active node is visible');
+  await expect(page.locator('.mf-state-active')).toBeVisible();
+});
+```
+
+Marker-only keeps the test flat; for async work, the test is `async` and you `await` after each marker. To use step callbacks with fixtures, pass fixtures into `story.init` (see [Required test signature](#required-test-signature)) and then use callbacks that accept the fixtures argument.
+
+---
+
+## Story options (`story.init(testInfo, options)` or `story.init(fixtures, testInfo, options)`)
+
+| Option               | Description |
+| -------------------- | ----------- |
+| `tags`               | String array for categorization (e.g. `['e2e', 'auth']`). |
+| `ticket`             | Ticket/issue ID(s) for traceability. Single string or array (e.g. `'JIRA-123'` or `['JIRA-123', 'JIRA-456']`). Appears in reports and can be linked via `ticketUrlTemplate` in formatter options. |
+| `meta`               | Arbitrary key-value metadata. |
+| `traceUrlTemplate`   | URL template for OTel trace links; use `{traceId}` placeholder. When set (or via `OTEL_TRACE_URL_TEMPLATE`), the reporter can generate “View Trace” links in reports (e.g. to Grafana or your APM). |
+| `fixtures`           | Playwright fixtures object (same as the test callback's first argument). When set, step callbacks receive this as their first argument. You can instead pass fixtures as the first argument: `story.init(fixtures, testInfo)`. |
+
+Example:
+
+```ts
+story.init(testInfo, {
+  tags: ['e2e', 'animations', 'play'],
+  ticket: 'JIRA-123',
+  traceUrlTemplate: 'https://grafana.example.com/explore?traceId={traceId}',
+});
+```
+
+---
+
+## Developer experience
+
+- **API:** Top-level step functions: `given`, `when`, `then`, `and`, `but` from `executable-stories-playwright`, plus `story` object with `story.init()` and the same steps on `story` for a consistent entry point. Use `story.init(testInfo)` and then `story.given` / `story.when` / `story.then`, etc.
+- **Modifiers:** Playwright’s `.skip`, `.only`, `.fixme`, `.todo`, `.fail`, `.slow` on tests; use `story.skip` / `story.only` / `story.fixme` / `story.slow` for scenario-level modifiers.
+- **Attach story to a plain test:** Use `doc.story('Title', testInfo)` or `doc.story('Title', (s) => { s.given(...); ... })` inside a normal `test()` so that test still appears in generated docs.
+- **Rich step docs:** `story.note()`, `story.json()`, `story.code()`, `story.mermaid()`, etc., or pass a `StoryDocs` object as the second argument when not using a callback. See the root [Features matrix](https://github.com/jagreehal/executable-stories#features-matrix).
+
+---
+
+## Exports
+
+- **Main:** `story`, types from `executable-stories-playwright`.
+- **Reporter:** default reporter from `executable-stories-playwright/reporter` (use as module path in config); reporter option types are re-exported.
+
+For output formats and formatter options, see [executable-stories-formatters](https://github.com/jagreehal/executable-stories/tree/main/packages/executable-stories-formatters).

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { TestInfo } from '@playwright/test';
+import * as _playwright_test from '@playwright/test';
+import { TestInfo, PlaywrightTestArgs, PlaywrightTestOptions } from '@playwright/test';
 import { StepKeyword } from 'executable-stories-formatters';
 export { DocEntry, StepKeyword, StoryMeta, StoryStep } from 'executable-stories-formatters';
 
@@ -68,6 +69,8 @@ interface StoryOptions {
     meta?: Record<string, unknown>;
     /** URL template for OTel trace links. Uses {traceId} placeholder. Also settable via OTEL_TRACE_URL_TEMPLATE env var. */
     traceUrlTemplate?: string;
+    /** Playwright fixtures (first argument of the test callback). When set, step callbacks receive this as their first argument. */
+    fixtures?: unknown;
 }
 /** Options for story.attach(). */
 interface AttachmentOptions {
@@ -105,12 +108,15 @@ interface AttachmentOptions {
  * ```
  */
 
-declare function init(testInfo: TestInfo, options?: StoryOptions): void;
+/** Fixture type for step callbacks: Playwright test args + options; custom extend() fixtures as unknown. */
+type PlaywrightFixtures = PlaywrightTestArgs & PlaywrightTestOptions & Record<string, unknown>;
+/** init(testInfo) or init(fixtures, testInfo) or init(testInfo, { fixtures }). */
+declare function init(first: TestInfo | unknown, second?: StoryOptions | TestInfo, third?: StoryOptions): void;
 /**
  * Wrap a function as a step with timing and error capture.
  * Records the step with `wrapped: true` and `durationMs`.
  */
-declare function fn<T>(keyword: StepKeyword, text: string, body: () => T): T;
+declare function fn<T>(keyword: StepKeyword, text: string, body: (fixtures: PlaywrightFixtures) => T): T;
 /**
  * Wrap an assertion as a Then step with timing and error capture.
  * Shorthand for `story.fn('Then', text, body)`.
@@ -119,19 +125,58 @@ declare function storyExpect<T>(text: string, body: () => T): T;
 declare function playwrightAttach(options: AttachmentOptions): void;
 declare const story: {
     init: typeof init;
-    given: (text: string, docs?: StoryDocs) => void;
-    when: (text: string, docs?: StoryDocs) => void;
-    then: (text: string, docs?: StoryDocs) => void;
-    and: (text: string, docs?: StoryDocs) => void;
-    but: (text: string, docs?: StoryDocs) => void;
-    arrange: (text: string, docs?: StoryDocs) => void;
-    act: (text: string, docs?: StoryDocs) => void;
-    assert: (text: string, docs?: StoryDocs) => void;
-    setup: (text: string, docs?: StoryDocs) => void;
-    context: (text: string, docs?: StoryDocs) => void;
-    execute: (text: string, docs?: StoryDocs) => void;
-    action: (text: string, docs?: StoryDocs) => void;
-    verify: (text: string, docs?: StoryDocs) => void;
+    given: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    when: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    then: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    and: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    but: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    arrange: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    act: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    assert: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    setup: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    context: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    execute: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    action: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
+    verify: {
+        (text: string, docs?: StoryDocs): void;
+        <T>(text: string, body: (fixtures: PlaywrightFixtures) => T): T;
+    };
     note(text: string): void;
     tag(name: string | string[]): void;
     kv(options: KvOptions): void;
@@ -151,4 +196,25 @@ declare const story: {
 };
 type Story = typeof story;
 
-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, story };
+declare const given: {
+    (text: string, docs?: StoryDocs): void;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+};
+declare const when: {
+    (text: string, docs?: StoryDocs): void;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+};
+declare const then: {
+    (text: string, docs?: StoryDocs): void;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+};
+declare const and: {
+    (text: string, docs?: StoryDocs): void;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => T): T;
+};
+declare const but: {
+    (text: string, docs?: StoryDocs): void;
+    <T>(text: string, body: (fixtures: _playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & Record<string, unknown>) => 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, and, but, given, story, then, when };

package/dist/index.js

@@ -121,20 +121,66 @@ function extractSuitePath(testInfo) {
   return suitePath.length > 0 ? suitePath : void 0;
 }
 function createStepMarker(keyword) {
-  return function stepMarker(text, docs) {
+  function stepMarker(text, docsOrBody) {
     const ctx = getContext();
+    const isCallback = typeof docsOrBody === "function";
+    const resolvedKeyword = (keyword === "Given" || keyword === "When" || keyword === "Then") && ctx.meta.steps.some((s) => s.keyword === keyword) ? "And" : keyword;
     const step = {
       id: `step-${ctx.stepCounter++}`,
-      keyword,
+      keyword: resolvedKeyword,
       text,
-      docs: docs ? convertStoryDocsToEntries(docs) : []
+      docs: !isCallback && docsOrBody ? convertStoryDocsToEntries(docsOrBody) : [],
+      ...isCallback ? { wrapped: true } : {}
     };
     ctx.meta.steps.push(step);
     ctx.currentStep = step;
     syncAnnotationToTest();
-  };
+    if (!isCallback) return;
+    const body = docsOrBody;
+    const start = performance.now();
+    try {
+      const result = ctx.fixtures !== void 0 ? body(ctx.fixtures) : body();
+      if (result instanceof Promise) {
+        return result.then(
+          (val) => {
+            step.durationMs = performance.now() - start;
+            syncAnnotationToTest();
+            return val;
+          },
+          (err) => {
+            step.durationMs = performance.now() - start;
+            syncAnnotationToTest();
+            throw err;
+          }
+        );
+      }
+      step.durationMs = performance.now() - start;
+      syncAnnotationToTest();
+      return result;
+    } catch (err) {
+      step.durationMs = performance.now() - start;
+      syncAnnotationToTest();
+      throw err;
+    }
+  }
+  return stepMarker;
+}
+function isTestInfo(x) {
+  return typeof x === "object" && x !== null && "title" in x && "annotations" in x && Array.isArray(x.annotations);
 }
-function init(testInfo, options) {
+function init(first, second, third) {
+  let testInfo;
+  let options;
+  let fixtures;
+  if (second !== void 0 && isTestInfo(second)) {
+    fixtures = first;
+    testInfo = second;
+    options = third;
+  } else {
+    testInfo = first;
+    options = second;
+    fixtures = options?.fixtures;
+  }
   const meta = {
     scenario: testInfo.title,
     steps: [],
@@ -180,7 +226,8 @@ function init(testInfo, options) {
     stepCounter: 0,
     attachments: [],
     activeTimers: /* @__PURE__ */ new Map(),
-    timerCounter: 0
+    timerCounter: 0,
+    fixtures
   };
   activeTestInfo = testInfo;
 }
@@ -195,9 +242,10 @@ function syncAnnotationToTest() {
 }
 function fn(keyword, text, body) {
   const ctx = getContext();
+  const resolvedKeyword = (keyword === "Given" || keyword === "When" || keyword === "Then") && ctx.meta.steps.some((s) => s.keyword === keyword) ? "And" : keyword;
   const step = {
     id: `step-${ctx.stepCounter++}`,
-    keyword,
+    keyword: resolvedKeyword,
     text,
     docs: [],
     wrapped: true
@@ -207,7 +255,7 @@ function fn(keyword, text, body) {
   syncAnnotationToTest();
   const start = performance.now();
   try {
-    const result = body();
+    const result = ctx.fixtures !== void 0 ? body(ctx.fixtures) : body();
     if (result instanceof Promise) {
       return result.then(
         (val) => {
@@ -355,7 +403,19 @@ var story = {
   fn,
   expect: storyExpect
 };
+
+// src/index.ts
+var given = story.given;
+var when = story.when;
+var then = story.then;
+var and = story.and;
+var but = story.but;
 export {
-  story
+  and,
+  but,
+  given,
+  story,
+  then,
+  when
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/story-api.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 } from '@playwright/test';\nimport {\n  tryGetActiveOtelContext,\n  resolveTraceUrl,\n} from 'executable-stories-formatters';\nimport type {\n  StepKeyword,\n  StoryMeta,\n  StoryStep,\n  DocEntry,\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\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}\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(ticket: string | string[] | undefined): string[] | undefined {\n  if (!ticket) return undefined;\n  return Array.isArray(ticket) ? ticket : [ticket];\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): void {\n  const ctx = getContext();\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}\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  return function stepMarker(text: string, docs?: StoryDocs): void {\n    const ctx = getContext();\n    const step: StoryStep = {\n      id: `step-${ctx.stepCounter++}`,\n      keyword,\n      text,\n      docs: docs ? convertStoryDocsToEntries(docs) : [],\n    };\n    ctx.meta.steps.push(step);\n    ctx.currentStep = step;\n    syncAnnotationToTest();\n  };\n}\n\n// ============================================================================\n// story.init() - Playwright-specific\n// ============================================================================\n\nfunction init(testInfo: TestInfo, options?: StoryOptions): void {\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);\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  };\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: () => T): T {\n  const ctx = getContext();\n  const step: StoryStep = {\n    id: `step-${ctx.stepCounter++}`,\n    keyword,\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 = 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): void {\n    attachDoc({ kind: 'note', text, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  tag(name: string | string[]): void {\n    const names = Array.isArray(name) ? name : [name];\n    attachDoc({ kind: 'tag', names, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  kv(options: KvOptions): void {\n    attachDoc({ kind: 'kv', label: options.label, value: options.value, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  json(options: JsonOptions): void {\n    const content = JSON.stringify(options.value, null, 2);\n    attachDoc({ kind: 'code', label: options.label, content, lang: 'json', phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  code(options: CodeOptions): void {\n    attachDoc({ kind: 'code', label: options.label, content: options.content, lang: options.lang, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  table(options: TableOptions): void {\n    attachDoc({ kind: 'table', label: options.label, columns: options.columns, rows: options.rows, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  link(options: LinkOptions): void {\n    attachDoc({ kind: 'link', label: options.label, url: options.url, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  section(options: SectionOptions): void {\n    attachDoc({ kind: 'section', title: options.title, markdown: options.markdown, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  mermaid(options: MermaidOptions): void {\n    attachDoc({ kind: 'mermaid', code: options.code, title: options.title, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  screenshot(options: ScreenshotOptions): void {\n    attachDoc({ kind: 'screenshot', path: options.path, alt: options.alt, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  custom(options: CustomOptions): void {\n    attachDoc({ kind: 'custom', type: options.type, data: options.data, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  // Attachments\n  attach: playwrightAttach,\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"],"mappings":"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","names":[]}
+{"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} 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(ticket: string | string[] | undefined): string[] | undefined {\n  if (!ticket) return undefined;\n  return Array.isArray(ticket) ? ticket : [ticket];\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): void {\n  const ctx = getContext();\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}\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<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 | ((...args: any[]) => T)): T | void {\n    const ctx = getContext();\n    const isCallback = typeof docsOrBody === 'function';\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    const step: StoryStep = {\n      id: `step-${ctx.stepCounter++}`,\n      keyword: resolvedKeyword,\n      text,\n      docs: (!isCallback && docsOrBody) ? convertStoryDocsToEntries(docsOrBody) : [],\n      ...(isCallback ? { wrapped: true } : {}),\n    };\n\n    ctx.meta.steps.push(step);\n    ctx.currentStep = step;\n    syncAnnotationToTest();\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);\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): void {\n    attachDoc({ kind: 'note', text, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  tag(name: string | string[]): void {\n    const names = Array.isArray(name) ? name : [name];\n    attachDoc({ kind: 'tag', names, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  kv(options: KvOptions): void {\n    attachDoc({ kind: 'kv', label: options.label, value: options.value, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  json(options: JsonOptions): void {\n    const content = JSON.stringify(options.value, null, 2);\n    attachDoc({ kind: 'code', label: options.label, content, lang: 'json', phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  code(options: CodeOptions): void {\n    attachDoc({ kind: 'code', label: options.label, content: options.content, lang: options.lang, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  table(options: TableOptions): void {\n    attachDoc({ kind: 'table', label: options.label, columns: options.columns, rows: options.rows, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  link(options: LinkOptions): void {\n    attachDoc({ kind: 'link', label: options.label, url: options.url, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  section(options: SectionOptions): void {\n    attachDoc({ kind: 'section', title: options.title, markdown: options.markdown, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  mermaid(options: MermaidOptions): void {\n    attachDoc({ kind: 'mermaid', code: options.code, title: options.title, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  screenshot(options: ScreenshotOptions): void {\n    attachDoc({ kind: 'screenshot', path: options.path, alt: options.alt, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  custom(options: CustomOptions): void {\n    attachDoc({ kind: 'custom', type: options.type, data: options.data, phase: 'runtime' });\n    syncAnnotationToTest();\n  },\n\n  // Attachments\n  attach: playwrightAttach,\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  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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "executable-stories-playwright",
-  "version": "6.0.0",
+  "version": "7.0.0",
   "description": "BDD-style executable stories for Playwright Test with documentation generation",
   "type": "module",
   "sideEffects": false,
@@ -19,12 +19,13 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "peerDependencies": {
     "@playwright/test": ">=1.58.2",
-    "executable-stories-formatters": "^0.5.0",
-    "autotel": ">=0.1.0"
+    "executable-stories-formatters": "^0.6.0",
+    "autotel": ">=2.20.0"
   },
   "peerDependenciesMeta": {
     "autotel": {
@@ -34,11 +35,11 @@
   "dependencies": {},
   "devDependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@playwright/test": "^1.58.1",
-    "@types/node": "^25.2.3",
+    "@playwright/test": "^1.58.2",
+    "@types/node": "^25.3.0",
     "tsup": "^8.5.1",
     "typescript": "~5.9.3",
-    "executable-stories-formatters": "0.5.0"
+    "executable-stories-formatters": "0.6.0"
   },
   "repository": {
     "type": "git",