playwright-checkpoint 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { T as TestCheckpointConfig, C as CheckpointConfig, e as CheckpointManifest, f as CheckpointOptions, g as CheckpointRecord, c as CheckpointCollector, a as ReportGenerator, R as RunRecord, B as BoundingBox } from './types-G7w4n8kR.cjs';
-export { A as AriaSnapshotCollectorData, i as AxeCollectorData, j as CollectorArtifact, d as CollectorConfig, k as CollectorContext, l as CollectorOptions, m as CollectorResult, n as ConsoleErrorRecord, D as DomStatsCollectorData, F as FailedRequestRecord, o as FormFieldState, p as FormFieldValue, q as FormsCollectorData, H as HtmlCollectorData, N as NetworkTimingBreakdown, r as NetworkTimingCollectorData, s as NetworkTimingRecord, P as PageMetadata, b as ReportGenerationResults, t as ReportGeneratorContext, u as ReportGeneratorResult, v as ReporterConfig, h as ResolvedCollectorConfig, S as ScreenshotCollectorData, w as StorageCollectorData, x as StorageCookieState, y as StorageEntryState, W as WebVitalMetric, z as WebVitalRating, E as WebVitalsSnapshot } from './types-G7w4n8kR.cjs';
-export { C as CaptureCheckpointOptions, a as CheckpointSession, b as CheckpointSessionMetadata, c as CheckpointSessionOptions, R as RunCollectorPipelineArgs, d as captureCheckpoint, e as checkpointSlug, f as collectPageTitle, g as createCheckpointSession, h as getBuiltinCollectors, r as registerBuiltinCollector, i as registerBuiltinCollectors, j as resolveCollectors, k as runCollectorPipeline, l as runCollectorSetup, m as runCollectorTeardown, s as sanitizeSegment, n as settlePage, w as warn } from './core-CD4jHGgI.cjs';
+import { T as TestCheckpointConfig, C as CheckpointConfig, e as CheckpointManifest, f as CheckpointOptions, g as CheckpointRecord, c as CheckpointCollector, a as ReportGenerator, R as RunRecord, B as BoundingBox } from './types-wX4eB9mb.cjs';
+export { A as AriaSnapshotCollectorData, i as ArticleDefinition, j as ArticleMetadata, k as AxeCollectorData, l as CollectorArtifact, d as CollectorConfig, m as CollectorContext, n as CollectorOptions, o as CollectorResult, p as ConsoleErrorRecord, D as DomStatsCollectorData, F as FailedRequestRecord, q as FormFieldState, r as FormFieldValue, s as FormsCollectorData, H as HtmlCollectorData, N as NetworkTimingBreakdown, t as NetworkTimingCollectorData, u as NetworkTimingRecord, P as PageMetadata, b as ReportGenerationResults, v as ReportGeneratorContext, w as ReportGeneratorResult, x as ReporterConfig, h as ResolvedCollectorConfig, S as ScreenshotCollectorData, y as StorageCollectorData, z as StorageCookieState, E as StorageEntryState, W as WebVitalMetric, G as WebVitalRating, I as WebVitalsSnapshot } from './types-wX4eB9mb.cjs';
+export { C as CaptureCheckpointOptions, a as CheckpointSession, b as CheckpointSessionMetadata, c as CheckpointSessionOptions, R as RunCollectorPipelineArgs, d as captureCheckpoint, e as checkpointSlug, f as collectPageTitle, g as createCheckpointSession, h as getBuiltinCollectors, r as registerBuiltinCollector, i as registerBuiltinCollectors, j as resolveCollectors, k as runCollectorPipeline, l as runCollectorSetup, m as runCollectorTeardown, s as sanitizeSegment, n as settlePage, w as warn } from './core-Dd3WLuTs.cjs';
 import * as PlaywrightModule from '@playwright/test';
 import { TestInfo, Page, TestType, PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions } from '@playwright/test';
-export { d as dedupeRuns, l as loadRuns, a as registerBuiltinReporter, r as runReporters } from './index-Cabk31qi.cjs';
+export { d as dedupeRuns, l as loadRuns, a as registerBuiltinReporter, r as runReporters } from './index-OQx9qcVO.cjs';
 
 type DeviceSurface = 'desktop' | 'mobile';
 type DeviceProfile = {

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { T as TestCheckpointConfig, C as CheckpointConfig, e as CheckpointManifest, f as CheckpointOptions, g as CheckpointRecord, c as CheckpointCollector, a as ReportGenerator, R as RunRecord, B as BoundingBox } from './types-G7w4n8kR.js';
-export { A as AriaSnapshotCollectorData, i as AxeCollectorData, j as CollectorArtifact, d as CollectorConfig, k as CollectorContext, l as CollectorOptions, m as CollectorResult, n as ConsoleErrorRecord, D as DomStatsCollectorData, F as FailedRequestRecord, o as FormFieldState, p as FormFieldValue, q as FormsCollectorData, H as HtmlCollectorData, N as NetworkTimingBreakdown, r as NetworkTimingCollectorData, s as NetworkTimingRecord, P as PageMetadata, b as ReportGenerationResults, t as ReportGeneratorContext, u as ReportGeneratorResult, v as ReporterConfig, h as ResolvedCollectorConfig, S as ScreenshotCollectorData, w as StorageCollectorData, x as StorageCookieState, y as StorageEntryState, W as WebVitalMetric, z as WebVitalRating, E as WebVitalsSnapshot } from './types-G7w4n8kR.js';
-export { C as CaptureCheckpointOptions, a as CheckpointSession, b as CheckpointSessionMetadata, c as CheckpointSessionOptions, R as RunCollectorPipelineArgs, d as captureCheckpoint, e as checkpointSlug, f as collectPageTitle, g as createCheckpointSession, h as getBuiltinCollectors, r as registerBuiltinCollector, i as registerBuiltinCollectors, j as resolveCollectors, k as runCollectorPipeline, l as runCollectorSetup, m as runCollectorTeardown, s as sanitizeSegment, n as settlePage, w as warn } from './core-CZvnc0rE.js';
+import { T as TestCheckpointConfig, C as CheckpointConfig, e as CheckpointManifest, f as CheckpointOptions, g as CheckpointRecord, c as CheckpointCollector, a as ReportGenerator, R as RunRecord, B as BoundingBox } from './types-wX4eB9mb.js';
+export { A as AriaSnapshotCollectorData, i as ArticleDefinition, j as ArticleMetadata, k as AxeCollectorData, l as CollectorArtifact, d as CollectorConfig, m as CollectorContext, n as CollectorOptions, o as CollectorResult, p as ConsoleErrorRecord, D as DomStatsCollectorData, F as FailedRequestRecord, q as FormFieldState, r as FormFieldValue, s as FormsCollectorData, H as HtmlCollectorData, N as NetworkTimingBreakdown, t as NetworkTimingCollectorData, u as NetworkTimingRecord, P as PageMetadata, b as ReportGenerationResults, v as ReportGeneratorContext, w as ReportGeneratorResult, x as ReporterConfig, h as ResolvedCollectorConfig, S as ScreenshotCollectorData, y as StorageCollectorData, z as StorageCookieState, E as StorageEntryState, W as WebVitalMetric, G as WebVitalRating, I as WebVitalsSnapshot } from './types-wX4eB9mb.js';
+export { C as CaptureCheckpointOptions, a as CheckpointSession, b as CheckpointSessionMetadata, c as CheckpointSessionOptions, R as RunCollectorPipelineArgs, d as captureCheckpoint, e as checkpointSlug, f as collectPageTitle, g as createCheckpointSession, h as getBuiltinCollectors, r as registerBuiltinCollector, i as registerBuiltinCollectors, j as resolveCollectors, k as runCollectorPipeline, l as runCollectorSetup, m as runCollectorTeardown, s as sanitizeSegment, n as settlePage, w as warn } from './core-6gyzs35M.js';
 import * as PlaywrightModule from '@playwright/test';
 import { TestInfo, Page, TestType, PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions } from '@playwright/test';
-export { d as dedupeRuns, l as loadRuns, a as registerBuiltinReporter, r as runReporters } from './index-BjYQX_hK.js';
+export { d as dedupeRuns, l as loadRuns, a as registerBuiltinReporter, r as runReporters } from './index-CvcgBzvl.js';
 
 type DeviceSurface = 'desktop' | 'mobile';
 type DeviceProfile = {

package/dist/index.js

@@ -1,3 +1,15 @@
+import {
+  annotateScreenshot,
+  dedupeRuns,
+  groupByStory,
+  htmlReporter,
+  loadRuns,
+  markdownReporter,
+  mdxReporter,
+  orderedCheckpointNames,
+  registerBuiltinReporter,
+  runReporters
+} from "./chunk-WXZOP7XI.js";
 import {
   ariaSnapshotCollector,
   axeCollector,
@@ -27,19 +39,7 @@ import {
   storageCollector,
   warn,
   webVitalsCollector
-} from "./chunk-KG37WSYS.js";
-import {
-  annotateScreenshot,
-  dedupeRuns,
-  groupByStory,
-  htmlReporter,
-  loadRuns,
-  markdownReporter,
-  mdxReporter,
-  orderedCheckpointNames,
-  registerBuiltinReporter,
-  runReporters
-} from "./chunk-X5IPL32H.js";
+} from "./chunk-M3BRR3LT.js";
 import "./chunk-DGUM43GV.js";
 
 // src/fixture.ts
@@ -91,11 +91,54 @@ function mergeCollectorOverrides(current, updates) {
 }
 function mergeTestConfig(current, update) {
   const collectors = mergeCollectorOverrides(current?.collectors, update.collectors);
+  const article = mergeArticleMetadata(current?.article, update.article);
+  const articles = update.articles ? cloneArticleDefinitions(update.articles) : current?.articles ? cloneArticleDefinitions(current.articles) : void 0;
   return {
     description: update.description ?? current?.description,
+    ...article ? { article } : {},
+    ...articles ? { articles } : {},
     ...collectors ? { collectors } : {}
   };
 }
+function mergeArticleMetadata(current, update) {
+  if (!current && !update) {
+    return void 0;
+  }
+  const merged = {
+    ...current ?? {},
+    ...update ?? {}
+  };
+  if (current?.frontmatter || update?.frontmatter) {
+    merged.frontmatter = {
+      ...current?.frontmatter ?? {},
+      ...update?.frontmatter ?? {}
+    };
+  }
+  return merged;
+}
+function cloneArticleMetadata(article) {
+  return {
+    ...article,
+    ...article.frontmatter ? { frontmatter: { ...article.frontmatter } } : {}
+  };
+}
+function cloneArticleDefinition(article) {
+  return {
+    ...cloneArticleMetadata(article),
+    steps: [...article.steps]
+  };
+}
+function cloneArticleDefinitions(articles) {
+  return articles.map((article) => cloneArticleDefinition(article));
+}
+function syncManifestArticle(manifest, testConfig) {
+  if (testConfig?.article) {
+    manifest.article = cloneArticleMetadata(testConfig.article);
+  }
+  if (testConfig?.articles) {
+    manifest.articles = cloneArticleDefinitions(testConfig.articles);
+  }
+}
 function manifestEnvironment() {
   return process.env.PLAYWRIGHT_CHECKPOINT_ENV || process.env.NODE_ENV || "test";
 }
@@ -172,6 +215,8 @@ function createCheckpoint(globalConfig = {}) {
   const base = playwright.test;
   const test2 = base.extend({
     checkpointManifest: [
+      // Playwright fixture callbacks must use object destructuring for the first arg.
+      // eslint-disable-next-line no-empty-pattern
       async ({}, use, testInfo) => {
         const manifest = createCheckpointManifestRecord(testInfo);
         try {
@@ -186,6 +231,8 @@ function createCheckpoint(globalConfig = {}) {
       },
       { auto: true }
     ],
+    // Playwright fixture callbacks must use object destructuring for the first arg.
+    // eslint-disable-next-line no-empty-pattern
     testCheckpointConfig: async ({}, use) => {
       let current = null;
       const controller = {
@@ -201,6 +248,8 @@ function createCheckpoint(globalConfig = {}) {
       };
       await use(controller);
     },
+    // Playwright fixture callbacks must use object destructuring for the first arg.
+    // eslint-disable-next-line no-empty-pattern
     deviceProfile: async ({}, use, testInfo) => {
       await use(createDeviceProfile(testInfo));
     },
@@ -209,15 +258,20 @@ function createCheckpoint(globalConfig = {}) {
         outputDir: testInfo.outputPath("checkpoints"),
         manifestPath: testInfo.outputPath("checkpoint-manifest.json"),
         manifest: checkpointManifest,
-        collectors: mergeConfig(globalConfig, testCheckpointConfig.get()),
+        collectors: globalConfig.collectors,
+        testConfig: () => testCheckpointConfig.get(),
         custom: globalConfig.custom,
         redact: globalConfig.redact,
         testInfo,
         adjustTimeout: createAdjustTimeout(testInfo)
       });
       try {
-        await use((name, options = {}) => session.checkpoint(name, options));
+        await use((name, options = {}) => {
+          syncManifestArticle(checkpointManifest, testCheckpointConfig.get());
+          return session.checkpoint(name, options);
+        });
       } finally {
+        syncManifestArticle(checkpointManifest, testCheckpointConfig.get());
         await session.finalize();
       }
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/fixture.ts","../src/device-profile.ts","../src/collectors/index.ts","../src/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\nimport type * as PlaywrightModule from '@playwright/test';\nimport type {\n  Page,\n  PlaywrightTestArgs,\n  PlaywrightTestOptions,\n  PlaywrightWorkerArgs,\n  PlaywrightWorkerOptions,\n  TestInfo,\n  TestType,\n} from '@playwright/test';\nimport {\n  createCheckpointSession,\n  registerBuiltinCollector,\n  resolveCollectors,\n  sanitizeSegment,\n  settlePage,\n  warn,\n} from './core';\nimport { createDeviceProfile, type DeviceProfile } from './device-profile';\nimport type {\n  CheckpointConfig,\n  CheckpointManifest,\n  CheckpointOptions,\n  CheckpointRecord,\n  CollectorConfig,\n  CollectorOptions,\n  TestCheckpointConfig,\n} from './types';\n\ntype PlaywrightRuntime = typeof PlaywrightModule;\n\ntype TestCheckpointConfigController = {\n  set(config: TestCheckpointConfig): void;\n  get(): TestCheckpointConfig | null;\n};\n\ntype CheckpointFixtures = {\n  checkpoint: (name: string, options?: CheckpointOptions) => Promise<CheckpointRecord>;\n  checkpointManifest: CheckpointManifest;\n  testCheckpointConfig: TestCheckpointConfigController;\n  deviceProfile: DeviceProfile;\n};\n\nconst require = (() => {\n  try {\n    return Function('return require')() as NodeRequire;\n  } catch {\n    return createRequire(path.join(process.cwd(), 'playwright-checkpoint-runtime.cjs'));\n  }\n})();\n\nfunction loadPlaywright(): PlaywrightRuntime {\n  return require('@playwright/test') as PlaywrightRuntime;\n}\n\nfunction mergeCollectorOverrides(\n  current: Partial<Record<string, boolean | CollectorOptions>> | undefined,\n  updates: Partial<Record<string, boolean | CollectorOptions>> | undefined,\n): Partial<Record<string, boolean | CollectorOptions>> | undefined {\n  if (!current && !updates) {\n    return undefined;\n  }\n\n  const merged: Partial<Record<string, boolean | CollectorOptions>> = {\n    ...(current ?? {}),\n  };\n\n  for (const [name, value] of Object.entries(updates ?? {})) {\n    const previous = merged[name];\n\n    if (value && typeof value === 'object' && !Array.isArray(value) && previous && typeof previous === 'object' && !Array.isArray(previous)) {\n      merged[name] = {\n        ...previous,\n        ...value,\n      };\n      continue;\n    }\n\n    merged[name] = value;\n  }\n\n  return merged;\n}\n\nfunction mergeTestConfig(current: TestCheckpointConfig | null, update: TestCheckpointConfig): TestCheckpointConfig {\n  const collectors = mergeCollectorOverrides(current?.collectors, update.collectors);\n\n  return {\n    description: update.description ?? current?.description,\n    ...(collectors ? { collectors } : {}),\n  };\n}\n\nfunction manifestEnvironment(): string {\n  return process.env.PLAYWRIGHT_CHECKPOINT_ENV || process.env.NODE_ENV || 'test';\n}\n\nfunction explicitTestTags(testInfo: TestInfo): string[] {\n  return (((testInfo as TestInfo & { tags?: string[] }).tags ?? []) as string[]).map((tag) => tag.toLowerCase());\n}\n\nexport function titleParts(testInfo: TestInfo): string[] {\n  const maybeTitlePath = (testInfo as { titlePath?: unknown }).titlePath;\n  return typeof maybeTitlePath === 'function' ? maybeTitlePath.call(testInfo) : [testInfo.title];\n}\n\nexport function collectTags(parts: string[]): Set<string> {\n  const tags = new Set<string>();\n\n  for (const part of parts) {\n    for (const token of part.match(/@[a-z0-9-]+/gi) || []) {\n      tags.add(token.toLowerCase());\n    }\n  }\n\n  return tags;\n}\n\nexport function manifestTags(testInfo: TestInfo): string[] {\n  return Array.from(new Set([...explicitTestTags(testInfo), ...collectTags(titleParts(testInfo))]));\n}\n\nexport function createCheckpointManifestRecord(testInfo: TestInfo): CheckpointManifest {\n  return {\n    environment: manifestEnvironment(),\n    project: testInfo.project.name,\n    testId: testInfo.testId,\n    title: testInfo.title,\n    tags: manifestTags(testInfo),\n    startedAt: new Date().toISOString(),\n    checkpoints: [],\n  };\n}\n\nexport async function writeCheckpointManifest(testInfo: TestInfo, manifest: CheckpointManifest): Promise<string> {\n  const manifestPath = testInfo.outputPath('checkpoint-manifest.json');\n  await fs.mkdir(path.dirname(manifestPath), { recursive: true });\n  await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`, 'utf8');\n  return manifestPath;\n}\n\nfunction createAdjustTimeout(testInfo: TestInfo): (ms: number) => void {\n  return (ms: number) => {\n    if (ms > 0 && typeof testInfo.setTimeout === 'function') {\n      testInfo.setTimeout(testInfo.timeout + ms);\n    }\n  };\n}\n\nfunction mergeConfig(\n  globalConfig: CheckpointConfig = {},\n  testConfig: TestCheckpointConfig | null,\n): Partial<Record<string, boolean | CollectorConfig>> | undefined {\n  return mergeCollectorOverrides(\n    globalConfig.collectors,\n    testConfig?.collectors,\n  ) as Partial<Record<string, boolean | CollectorConfig>> | undefined;\n}\n\nexport async function captureCheckpointRecord(args: {\n  globalConfig?: CheckpointConfig;\n  page: Page;\n  testInfo: TestInfo;\n  checkpointManifest: CheckpointManifest;\n  testConfig?: TestCheckpointConfig | null;\n  name: string;\n  options?: CheckpointOptions;\n}): Promise<CheckpointRecord> {\n  const globalConfig = args.globalConfig ?? {};\n  const session = await createCheckpointSession(args.page, {\n    outputDir: args.testInfo.outputPath('checkpoints'),\n    manifestPath: args.testInfo.outputPath('checkpoint-manifest.json'),\n    manifest: args.checkpointManifest,\n    collectors: mergeConfig(globalConfig, args.testConfig ?? null),\n    custom: globalConfig.custom,\n    redact: globalConfig.redact,\n    testInfo: args.testInfo,\n    adjustTimeout: createAdjustTimeout(args.testInfo),\n  });\n\n  try {\n    return await session.checkpoint(args.name, args.options);\n  } finally {\n    await session.finalize();\n  }\n}\n\nexport function createCheckpoint(globalConfig: CheckpointConfig = {}): {\n  test: TestType<PlaywrightTestArgs & PlaywrightTestOptions & CheckpointFixtures, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;\n} {\n  const playwright = loadPlaywright();\n  const base = playwright.test as TestType<\n    PlaywrightTestArgs & PlaywrightTestOptions,\n    PlaywrightWorkerArgs & PlaywrightWorkerOptions\n  >;\n\n  const test = base.extend<CheckpointFixtures>({\n    checkpointManifest: [\n      async ({}, use, testInfo) => {\n        const manifest = createCheckpointManifestRecord(testInfo);\n\n        try {\n          await use(manifest);\n        } finally {\n          try {\n            await writeCheckpointManifest(testInfo, manifest);\n          } catch (error) {\n            warn(`Failed to write checkpoint manifest for test \"${testInfo.title}\".`, error);\n          }\n        }\n      },\n      { auto: true },\n    ],\n\n    testCheckpointConfig: async ({}, use) => {\n      let current: TestCheckpointConfig | null = null;\n\n      const controller: TestCheckpointConfigController = {\n        set(config) {\n          current = mergeTestConfig(current, config);\n        },\n        get() {\n          return current\n            ? {\n                ...current,\n                ...(current.collectors ? { collectors: mergeCollectorOverrides(undefined, current.collectors) } : {}),\n              }\n            : null;\n        },\n      };\n\n      await use(controller);\n    },\n\n    deviceProfile: async ({}, use, testInfo) => {\n      await use(createDeviceProfile(testInfo));\n    },\n\n    checkpoint: async ({ page, checkpointManifest, testCheckpointConfig }, use, testInfo) => {\n      const session = await createCheckpointSession(page, {\n        outputDir: testInfo.outputPath('checkpoints'),\n        manifestPath: testInfo.outputPath('checkpoint-manifest.json'),\n        manifest: checkpointManifest,\n        collectors: mergeConfig(globalConfig, testCheckpointConfig.get()),\n        custom: globalConfig.custom,\n        redact: globalConfig.redact,\n        testInfo,\n        adjustTimeout: createAdjustTimeout(testInfo),\n      });\n\n      try {\n        await use((name, options = {}) => session.checkpoint(name, options));\n      } finally {\n        await session.finalize();\n      }\n    },\n  });\n\n  return { test };\n}\n\nexport const expect = loadPlaywright().expect;\nexport const { test } = createCheckpoint();\nexport { createCheckpointSession, createDeviceProfile, registerBuiltinCollector, resolveCollectors, sanitizeSegment, settlePage, warn };\nexport type { DeviceProfile, TestCheckpointConfigController };\n","import type { TestInfo } from '@playwright/test';\n\nexport type DeviceSurface = 'desktop' | 'mobile';\n\nexport type DeviceProfile = {\n  name: string;\n  isMobile: boolean;\n  surface: DeviceSurface;\n};\n\nexport function createDeviceProfile(testInfo: TestInfo): DeviceProfile {\n  const use = testInfo.project.use as { isMobile?: boolean } | undefined;\n  const isMobile = Boolean(use?.isMobile);\n\n  return {\n    name: testInfo.project.name,\n    isMobile,\n    surface: isMobile ? 'mobile' : 'desktop',\n  };\n}\n","import { builtinCollectors } from './builtin-collectors';\nimport { registerBuiltinCollectors } from './registry';\n\nregisterBuiltinCollectors(builtinCollectors);\n\nexport { registerBuiltinCollector, registerBuiltinCollectors, getBuiltinCollectors } from './registry';\nexport { screenshotCollector } from './screenshot';\nexport { htmlCollector } from './html';\nexport { axeCollector, setAxeLoaderForTests } from './axe';\nexport { webVitalsCollector } from './web-vitals';\nexport { consoleCollector } from './console';\nexport { networkCollector } from './network';\nexport { metadataCollector } from './metadata';\nexport { ariaSnapshotCollector } from './aria-snapshot';\nexport { domStatsCollector } from './dom-stats';\nexport { formsCollector } from './forms';\nexport { storageCollector } from './storage';\nexport { networkTimingCollector } from './network-timing';\nexport type { CheckpointCollector } from '../types';\n","export type * from './types';\nexport * from './core';\nexport * from './fixture';\nexport { type CheckpointCollector } from './types';\nexport { type ReportGenerator } from './types';\nexport * from './collectors';\nexport * from './report';\n\nexport const VERSION = '0.1.0';\n"],"mappings":"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","names":["require","test"]}
+{"version":3,"sources":["../src/fixture.ts","../src/device-profile.ts","../src/collectors/index.ts","../src/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\nimport type * as PlaywrightModule from '@playwright/test';\nimport type {\n  Page,\n  PlaywrightTestArgs,\n  PlaywrightTestOptions,\n  PlaywrightWorkerArgs,\n  PlaywrightWorkerOptions,\n  TestInfo,\n  TestType,\n} from '@playwright/test';\nimport {\n  createCheckpointSession,\n  registerBuiltinCollector,\n  resolveCollectors,\n  sanitizeSegment,\n  settlePage,\n  warn,\n} from './core';\nimport { createDeviceProfile, type DeviceProfile } from './device-profile';\nimport type {\n  ArticleDefinition,\n  ArticleMetadata,\n  CheckpointConfig,\n  CheckpointManifest,\n  CheckpointOptions,\n  CheckpointRecord,\n  CollectorConfig,\n  CollectorOptions,\n  TestCheckpointConfig,\n} from './types';\n\ntype PlaywrightRuntime = typeof PlaywrightModule;\n\ntype TestCheckpointConfigController = {\n  set(config: TestCheckpointConfig): void;\n  get(): TestCheckpointConfig | null;\n};\n\ntype CheckpointFixtures = {\n  checkpoint: (name: string, options?: CheckpointOptions) => Promise<CheckpointRecord>;\n  checkpointManifest: CheckpointManifest;\n  testCheckpointConfig: TestCheckpointConfigController;\n  deviceProfile: DeviceProfile;\n};\n\nconst require = (() => {\n  try {\n    return Function('return require')() as NodeRequire;\n  } catch {\n    return createRequire(path.join(process.cwd(), 'playwright-checkpoint-runtime.cjs'));\n  }\n})();\n\nfunction loadPlaywright(): PlaywrightRuntime {\n  return require('@playwright/test') as PlaywrightRuntime;\n}\n\nfunction mergeCollectorOverrides(\n  current: Partial<Record<string, boolean | CollectorOptions>> | undefined,\n  updates: Partial<Record<string, boolean | CollectorOptions>> | undefined,\n): Partial<Record<string, boolean | CollectorOptions>> | undefined {\n  if (!current && !updates) {\n    return undefined;\n  }\n\n  const merged: Partial<Record<string, boolean | CollectorOptions>> = {\n    ...(current ?? {}),\n  };\n\n  for (const [name, value] of Object.entries(updates ?? {})) {\n    const previous = merged[name];\n\n    if (value && typeof value === 'object' && !Array.isArray(value) && previous && typeof previous === 'object' && !Array.isArray(previous)) {\n      merged[name] = {\n        ...previous,\n        ...value,\n      };\n      continue;\n    }\n\n    merged[name] = value;\n  }\n\n  return merged;\n}\n\nfunction mergeTestConfig(current: TestCheckpointConfig | null, update: TestCheckpointConfig): TestCheckpointConfig {\n  const collectors = mergeCollectorOverrides(current?.collectors, update.collectors);\n  const article = mergeArticleMetadata(current?.article, update.article);\n  const articles = update.articles ? cloneArticleDefinitions(update.articles) : current?.articles ? cloneArticleDefinitions(current.articles) : undefined;\n\n  return {\n    description: update.description ?? current?.description,\n    ...(article ? { article } : {}),\n    ...(articles ? { articles } : {}),\n    ...(collectors ? { collectors } : {}),\n  };\n}\n\nfunction mergeArticleMetadata(\n  current: ArticleMetadata | undefined,\n  update: ArticleMetadata | undefined,\n): ArticleMetadata | undefined {\n  if (!current && !update) {\n    return undefined;\n  }\n\n  const merged: ArticleMetadata = {\n    ...(current ?? {}),\n    ...(update ?? {}),\n  };\n\n  if (current?.frontmatter || update?.frontmatter) {\n    merged.frontmatter = {\n      ...(current?.frontmatter ?? {}),\n      ...(update?.frontmatter ?? {}),\n    };\n  }\n\n  return merged;\n}\n\nfunction cloneArticleMetadata(article: ArticleMetadata): ArticleMetadata {\n  return {\n    ...article,\n    ...(article.frontmatter ? { frontmatter: { ...article.frontmatter } } : {}),\n  };\n}\n\nfunction cloneArticleDefinition(article: ArticleDefinition): ArticleDefinition {\n  return {\n    ...cloneArticleMetadata(article),\n    steps: [...article.steps],\n  };\n}\n\nfunction cloneArticleDefinitions(articles: ArticleDefinition[]): ArticleDefinition[] {\n  return articles.map((article) => cloneArticleDefinition(article));\n}\n\nfunction syncManifestArticle(manifest: CheckpointManifest, testConfig: TestCheckpointConfig | null): void {\n  if (testConfig?.article) {\n    manifest.article = cloneArticleMetadata(testConfig.article);\n  }\n\n  if (testConfig?.articles) {\n    manifest.articles = cloneArticleDefinitions(testConfig.articles);\n  }\n}\n\nfunction manifestEnvironment(): string {\n  return process.env.PLAYWRIGHT_CHECKPOINT_ENV || process.env.NODE_ENV || 'test';\n}\n\nfunction explicitTestTags(testInfo: TestInfo): string[] {\n  return (((testInfo as TestInfo & { tags?: string[] }).tags ?? []) as string[]).map((tag) => tag.toLowerCase());\n}\n\nexport function titleParts(testInfo: TestInfo): string[] {\n  const maybeTitlePath = (testInfo as { titlePath?: unknown }).titlePath;\n  return typeof maybeTitlePath === 'function' ? maybeTitlePath.call(testInfo) : [testInfo.title];\n}\n\nexport function collectTags(parts: string[]): Set<string> {\n  const tags = new Set<string>();\n\n  for (const part of parts) {\n    for (const token of part.match(/@[a-z0-9-]+/gi) || []) {\n      tags.add(token.toLowerCase());\n    }\n  }\n\n  return tags;\n}\n\nexport function manifestTags(testInfo: TestInfo): string[] {\n  return Array.from(new Set([...explicitTestTags(testInfo), ...collectTags(titleParts(testInfo))]));\n}\n\nexport function createCheckpointManifestRecord(testInfo: TestInfo): CheckpointManifest {\n  return {\n    environment: manifestEnvironment(),\n    project: testInfo.project.name,\n    testId: testInfo.testId,\n    title: testInfo.title,\n    tags: manifestTags(testInfo),\n    startedAt: new Date().toISOString(),\n    checkpoints: [],\n  };\n}\n\nexport async function writeCheckpointManifest(testInfo: TestInfo, manifest: CheckpointManifest): Promise<string> {\n  const manifestPath = testInfo.outputPath('checkpoint-manifest.json');\n  await fs.mkdir(path.dirname(manifestPath), { recursive: true });\n  await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`, 'utf8');\n  return manifestPath;\n}\n\nfunction createAdjustTimeout(testInfo: TestInfo): (ms: number) => void {\n  return (ms: number) => {\n    if (ms > 0 && typeof testInfo.setTimeout === 'function') {\n      testInfo.setTimeout(testInfo.timeout + ms);\n    }\n  };\n}\n\nfunction mergeConfig(\n  globalConfig: CheckpointConfig = {},\n  testConfig: TestCheckpointConfig | null,\n): Partial<Record<string, boolean | CollectorConfig>> | undefined {\n  return mergeCollectorOverrides(\n    globalConfig.collectors,\n    testConfig?.collectors,\n  ) as Partial<Record<string, boolean | CollectorConfig>> | undefined;\n}\n\nexport async function captureCheckpointRecord(args: {\n  globalConfig?: CheckpointConfig;\n  page: Page;\n  testInfo: TestInfo;\n  checkpointManifest: CheckpointManifest;\n  testConfig?: TestCheckpointConfig | null;\n  name: string;\n  options?: CheckpointOptions;\n}): Promise<CheckpointRecord> {\n  const globalConfig = args.globalConfig ?? {};\n  const session = await createCheckpointSession(args.page, {\n    outputDir: args.testInfo.outputPath('checkpoints'),\n    manifestPath: args.testInfo.outputPath('checkpoint-manifest.json'),\n    manifest: args.checkpointManifest,\n    collectors: mergeConfig(globalConfig, args.testConfig ?? null),\n    custom: globalConfig.custom,\n    redact: globalConfig.redact,\n    testInfo: args.testInfo,\n    adjustTimeout: createAdjustTimeout(args.testInfo),\n  });\n\n  try {\n    return await session.checkpoint(args.name, args.options);\n  } finally {\n    await session.finalize();\n  }\n}\n\nexport function createCheckpoint(globalConfig: CheckpointConfig = {}): {\n  test: TestType<PlaywrightTestArgs & PlaywrightTestOptions & CheckpointFixtures, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;\n} {\n  const playwright = loadPlaywright();\n  const base = playwright.test as TestType<\n    PlaywrightTestArgs & PlaywrightTestOptions,\n    PlaywrightWorkerArgs & PlaywrightWorkerOptions\n  >;\n\n  const test = base.extend<CheckpointFixtures>({\n    checkpointManifest: [\n      // Playwright fixture callbacks must use object destructuring for the first arg.\n      // eslint-disable-next-line no-empty-pattern\n      async ({}, use, testInfo) => {\n        const manifest = createCheckpointManifestRecord(testInfo);\n\n        try {\n          await use(manifest);\n        } finally {\n          try {\n            await writeCheckpointManifest(testInfo, manifest);\n          } catch (error) {\n            warn(`Failed to write checkpoint manifest for test \"${testInfo.title}\".`, error);\n          }\n        }\n      },\n      { auto: true },\n    ],\n\n    // Playwright fixture callbacks must use object destructuring for the first arg.\n    // eslint-disable-next-line no-empty-pattern\n    testCheckpointConfig: async ({}, use) => {\n      let current: TestCheckpointConfig | null = null;\n\n      const controller: TestCheckpointConfigController = {\n        set(config) {\n          current = mergeTestConfig(current, config);\n        },\n        get() {\n          return current\n            ? {\n                ...current,\n                ...(current.collectors ? { collectors: mergeCollectorOverrides(undefined, current.collectors) } : {}),\n              }\n            : null;\n        },\n      };\n\n      await use(controller);\n    },\n\n    // Playwright fixture callbacks must use object destructuring for the first arg.\n    // eslint-disable-next-line no-empty-pattern\n    deviceProfile: async ({}, use, testInfo) => {\n      await use(createDeviceProfile(testInfo));\n    },\n\n    checkpoint: async ({ page, checkpointManifest, testCheckpointConfig }, use, testInfo) => {\n      const session = await createCheckpointSession(page, {\n        outputDir: testInfo.outputPath('checkpoints'),\n        manifestPath: testInfo.outputPath('checkpoint-manifest.json'),\n        manifest: checkpointManifest,\n        collectors: globalConfig.collectors,\n        testConfig: () => testCheckpointConfig.get(),\n        custom: globalConfig.custom,\n        redact: globalConfig.redact,\n        testInfo,\n        adjustTimeout: createAdjustTimeout(testInfo),\n      });\n\n      try {\n        await use((name, options = {}) => {\n          syncManifestArticle(checkpointManifest, testCheckpointConfig.get());\n          return session.checkpoint(name, options);\n        });\n      } finally {\n        syncManifestArticle(checkpointManifest, testCheckpointConfig.get());\n        await session.finalize();\n      }\n    },\n  });\n\n  return { test };\n}\n\nexport const expect = loadPlaywright().expect;\nexport const { test } = createCheckpoint();\nexport { createCheckpointSession, createDeviceProfile, registerBuiltinCollector, resolveCollectors, sanitizeSegment, settlePage, warn };\nexport type { DeviceProfile, TestCheckpointConfigController };\n","import type { TestInfo } from '@playwright/test';\n\nexport type DeviceSurface = 'desktop' | 'mobile';\n\nexport type DeviceProfile = {\n  name: string;\n  isMobile: boolean;\n  surface: DeviceSurface;\n};\n\nexport function createDeviceProfile(testInfo: TestInfo): DeviceProfile {\n  const use = testInfo.project.use as { isMobile?: boolean } | undefined;\n  const isMobile = Boolean(use?.isMobile);\n\n  return {\n    name: testInfo.project.name,\n    isMobile,\n    surface: isMobile ? 'mobile' : 'desktop',\n  };\n}\n","import { builtinCollectors } from './builtin-collectors';\nimport { registerBuiltinCollectors } from './registry';\n\nregisterBuiltinCollectors(builtinCollectors);\n\nexport { registerBuiltinCollector, registerBuiltinCollectors, getBuiltinCollectors } from './registry';\nexport { screenshotCollector } from './screenshot';\nexport { htmlCollector } from './html';\nexport { axeCollector, setAxeLoaderForTests } from './axe';\nexport { webVitalsCollector } from './web-vitals';\nexport { consoleCollector } from './console';\nexport { networkCollector } from './network';\nexport { metadataCollector } from './metadata';\nexport { ariaSnapshotCollector } from './aria-snapshot';\nexport { domStatsCollector } from './dom-stats';\nexport { formsCollector } from './forms';\nexport { storageCollector } from './storage';\nexport { networkTimingCollector } from './network-timing';\nexport type { CheckpointCollector } from '../types';\n","export type * from './types';\nexport * from './core';\nexport * from './fixture';\nexport { type CheckpointCollector } from './types';\nexport { type ReportGenerator } from './types';\nexport * from './collectors';\nexport * from './report';\n\nexport const VERSION = '0.1.0';\n"],"mappings":"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","names":["require","test"]}

package/dist/mcp/index.cjs

@@ -2379,6 +2379,28 @@ function stripTags(value) {
   const stripped = value.replace(/\s+@[a-z0-9-]+/gi, " ").replace(/\s+/g, " ").trim();
   return stripped || value.trim() || "Untitled story";
 }
+function articleTitle(run) {
+  const override = run.article?.title?.trim();
+  return override || stripTags(run.title);
+}
+function articleDescription(run) {
+  const description = run.article?.description?.trim();
+  return description ? description : null;
+}
+function articleSlug(run) {
+  const override = run.article?.slug?.trim();
+  return slugify2(override || stripTags(run.title));
+}
+function uniqueArticleSlug(baseSlug, usedSlugs) {
+  if (!usedSlugs.has(baseSlug)) {
+    return baseSlug;
+  }
+  let index = 1;
+  while (usedSlugs.has(`${baseSlug}-${index}`)) {
+    index += 1;
+  }
+  return `${baseSlug}-${index}`;
+}
 function normalizeConfig(config) {
   return {
     storiesDir: typeof config.storiesDir === "string" ? config.storiesDir : ".",
@@ -2389,7 +2411,8 @@ function normalizeConfig(config) {
     footer: typeof config.footer === "string" ? config.footer : void 0,
     frontmatter: config.frontmatter === true || config.frontmatter === false || config.frontmatter != null && typeof config.frontmatter === "object" && !Array.isArray(config.frontmatter) ? config.frontmatter : false,
     imagePathPrefix: typeof config.imagePathPrefix === "string" ? config.imagePathPrefix : void 0,
-    copyScreenshots: typeof config.copyScreenshots === "boolean" ? config.copyScreenshots : true
+    copyScreenshots: typeof config.copyScreenshots === "boolean" ? config.copyScreenshots : true,
+    requireExplicitStep: typeof config.requireExplicitStep === "boolean" ? config.requireExplicitStep : false
   };
 }
 function normalizeTags(tags) {
@@ -2401,6 +2424,9 @@ function shouldIncludeRun(run, config) {
     const runTags = new Set(normalizeTags(run.tags));
     return includeTags.some((tag) => runTags.has(tag));
   }
+  if (run.articles) {
+    return true;
+  }
   return run.checkpoints.some((checkpoint) => {
     const hasDescription = typeof checkpoint.description === "string" && checkpoint.description.trim().length > 0;
     return hasDescription || typeof checkpoint.step === "number";
@@ -2519,17 +2545,22 @@ async function materializeScreenshot(args) {
   if (!sourcePath) {
     return null;
   }
+  const cachedTargetPath = args.screenshotCopies?.get(sourcePath);
+  if (cachedTargetPath) {
+    return rewriteImagePath(args.markdownFile, cachedTargetPath, args.outputDir, args.config.imagePathPrefix);
+  }
   const extension = import_node_path15.default.extname(sourcePath) || ".png";
   const targetPath = import_node_path15.default.join(
     args.outputDir,
     args.config.screenshotsDir ?? "screenshots",
-    args.storySlug,
-    `${String(args.stepOrder).padStart(2, "0")}-${slugify2(args.checkpoint.name)}${extension}`
+    args.screenshotDirSlug,
+    `${args.screenshotFileSlug}${extension}`
   );
   try {
     if (args.config.copyScreenshots !== false) {
       await import_promises14.default.mkdir(import_node_path15.default.dirname(targetPath), { recursive: true });
       await import_promises14.default.copyFile(sourcePath, targetPath);
+      args.screenshotCopies?.set(sourcePath, targetPath);
       args.writtenFiles.add(targetPath);
       return rewriteImagePath(args.markdownFile, targetPath, args.outputDir, args.config.imagePathPrefix);
     }
@@ -2549,10 +2580,31 @@ function orderedCheckpoints(checkpoints) {
   });
 }
 async function buildSteps(args) {
-  const checkpoints = orderedCheckpoints(args.run.checkpoints);
+  let checkpoints;
+  if (args.stepNames && args.stepNames.length > 0) {
+    const byName = /* @__PURE__ */ new Map();
+    for (const checkpoint of args.run.checkpoints) {
+      if (byName.has(checkpoint.name)) {
+        warn(`Duplicate checkpoint name "${checkpoint.name}" in "${args.run.title}". Using the latest capture for article generation.`);
+      }
+      byName.set(checkpoint.name, checkpoint);
+    }
+    checkpoints = args.stepNames.map((stepName) => {
+      const checkpoint = byName.get(stepName);
+      if (!checkpoint) {
+        warn(`Markdown article step "${stepName}" was not captured in "${args.run.title}". Skipping step.`);
+        return null;
+      }
+      return checkpoint;
+    }).filter((checkpoint) => checkpoint !== null);
+  } else {
+    checkpoints = orderedCheckpoints(args.run.checkpoints).filter(
+      (checkpoint) => !args.config.requireExplicitStep || typeof checkpoint.step === "number"
+    );
+  }
   const steps = [];
   for (const [index, checkpoint] of checkpoints.entries()) {
-    const order = typeof checkpoint.step === "number" ? checkpoint.step : index + 1;
+    const order = args.stepNames ? index + 1 : typeof checkpoint.step === "number" ? checkpoint.step : index + 1;
     steps.push({
       checkpoint,
       order,
@@ -2561,12 +2613,13 @@ async function buildSteps(args) {
       imagePath: await materializeScreenshot({
         run: args.run,
         checkpoint,
-        storySlug: args.storySlug,
-        stepOrder: order,
+        screenshotDirSlug: args.screenshotDirSlug,
+        screenshotFileSlug: args.stepNames ? checkpoint.slug : `${String(order).padStart(2, "0")}-${slugify2(checkpoint.name)}`,
         outputDir: args.outputDir,
         markdownFile: args.markdownFile,
         config: args.config,
-        writtenFiles: args.writtenFiles
+        writtenFiles: args.writtenFiles,
+        screenshotCopies: args.screenshotCopies
       }),
       urlLabel: urlLabel(checkpoint.url),
       breadcrumbLabel: breadcrumbLabel(checkpoint.url),
@@ -2577,13 +2630,14 @@ async function buildSteps(args) {
 }
 function renderMarkdown(args) {
   const frontmatterFields = args.config.frontmatter === true || typeof args.config.frontmatter === "object" ? {
-    title: args.title,
     project: args.run.project,
-    testId: args.run.testId,
     tags: args.run.tags,
+    ...args.config.frontmatter && typeof args.config.frontmatter === "object" ? args.config.frontmatter : {},
+    ...args.article?.frontmatter ?? {},
+    testId: args.run.testId,
     startedAt: args.run.startedAt,
     generatedAt: args.generatedAt,
-    ...args.config.frontmatter && typeof args.config.frontmatter === "object" ? args.config.frontmatter : {}
+    title: args.title
   } : null;
   const sections = args.steps.map((step) => {
     const lines = [`## Step ${step.order}: ${step.heading}`, ""];
@@ -2603,6 +2657,7 @@ function renderMarkdown(args) {
   const parts = [
     frontmatterFields ? serializeFrontmatter(frontmatterFields) : "",
     `# ${args.title}`,
+    args.description?.trim() ?? "",
     args.config.header ? args.config.header.trim() : "",
     sections,
     args.config.footer ? args.config.footer.trim() : ""
@@ -2610,6 +2665,42 @@ function renderMarkdown(args) {
   return `${parts.join("\n\n")}
 `;
 }
+function resolveArticles(run) {
+  const multiArticles = (run.articles ?? []).filter((article) => Array.isArray(article.steps));
+  if (run.articles && multiArticles.length === 0) {
+    warn(`Markdown reporter received an empty articles array for "${run.title}". Falling back to the default single-article output.`);
+  }
+  if (multiArticles.length === 0) {
+    return [
+      {
+        title: articleTitle(run),
+        description: articleDescription(run),
+        slug: articleSlug(run),
+        metadata: run.article,
+        screenshotDirSlug: articleSlug(run)
+      }
+    ];
+  }
+  const usedSlugs = /* @__PURE__ */ new Set();
+  const screenshotDirSlug = slugify2(stripTags(run.title));
+  return multiArticles.map((article, index) => {
+    const fallbackSlug = `${screenshotDirSlug}-${index + 1}`;
+    const baseSlug = slugify2(article.slug?.trim() || fallbackSlug);
+    const uniqueSlug = uniqueArticleSlug(baseSlug, usedSlugs);
+    if (uniqueSlug !== baseSlug) {
+      warn(`Markdown article slug collision for "${article.title ?? run.title}" resolved as "${uniqueSlug}".`);
+    }
+    usedSlugs.add(uniqueSlug);
+    return {
+      title: article.title?.trim() || stripTags(run.title),
+      description: article.description?.trim() || null,
+      slug: uniqueSlug,
+      metadata: article,
+      stepNames: [...article.steps],
+      screenshotDirSlug
+    };
+  });
+}
 var markdownReporter = {
   name: "markdown",
   description: "Generates one Markdown help article per captured story.",
@@ -2621,37 +2712,56 @@ var markdownReporter = {
     const stories = groupByStory(context.runs);
     const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
     const writtenFiles = /* @__PURE__ */ new Set();
+    const usedStorySlugs = /* @__PURE__ */ new Set();
+    const screenshotCopies = /* @__PURE__ */ new Map();
     let articleCount = 0;
     for (const [storyTitle, runs] of stories) {
       const primaryRun = choosePrimaryRun(runs, config.preferredProject);
       if (!primaryRun || !shouldIncludeRun(primaryRun, config)) {
         continue;
       }
-      const title = stripTags(storyTitle);
-      const storySlug = slugify2(title);
-      const markdownFile = import_node_path15.default.join(context.outputDir, config.storiesDir ?? ".", `${storySlug}.md`);
-      const steps = await buildSteps({
-        run: primaryRun,
-        storySlug,
-        outputDir: context.outputDir,
-        markdownFile,
-        config,
-        writtenFiles
-      });
-      await import_promises14.default.mkdir(import_node_path15.default.dirname(markdownFile), { recursive: true });
-      await import_promises14.default.writeFile(
-        markdownFile,
-        renderMarkdown({
-          title,
-          steps,
+      for (const article of resolveArticles(primaryRun)) {
+        let storySlug = article.slug;
+        if (usedStorySlugs.has(storySlug)) {
+          let index = 2;
+          while (usedStorySlugs.has(`${article.slug}-${index}`)) {
+            index += 1;
+          }
+          storySlug = `${article.slug}-${index}`;
+          warn(`Markdown article slug collision for "${article.title || storyTitle}" resolved as "${storySlug}".`);
+        }
+        usedStorySlugs.add(storySlug);
+        const markdownFile = import_node_path15.default.join(context.outputDir, config.storiesDir ?? ".", `${storySlug}.md`);
+        const steps = await buildSteps({
           run: primaryRun,
+          stepNames: article.stepNames,
+          screenshotDirSlug: article.screenshotDirSlug,
+          outputDir: context.outputDir,
+          markdownFile,
           config,
-          generatedAt
-        }),
-        "utf8"
-      );
-      writtenFiles.add(markdownFile);
-      articleCount += 1;
+          writtenFiles,
+          screenshotCopies
+        });
+        if (steps.length === 0) {
+          continue;
+        }
+        await import_promises14.default.mkdir(import_node_path15.default.dirname(markdownFile), { recursive: true });
+        await import_promises14.default.writeFile(
+          markdownFile,
+          renderMarkdown({
+            title: article.title,
+            description: article.description,
+            steps,
+            run: primaryRun,
+            article: article.metadata,
+            config,
+            generatedAt
+          }),
+          "utf8"
+        );
+        writtenFiles.add(markdownFile);
+        articleCount += 1;
+      }
     }
     return {
       files: [...writtenFiles],
@@ -3064,6 +3174,8 @@ function toRunRecord(manifest, sourceManifestPath) {
     project: manifest.project,
     testId: manifest.testId,
     title: manifest.title,
+    ...manifest.article ? { article: manifest.article } : {},
+    ...manifest.articles ? { articles: manifest.articles } : {},
     tags: manifest.tags,
     startedAt: manifest.startedAt,
     checkpoints: manifest.checkpoints
@@ -3075,6 +3187,8 @@ function toManifest(run) {
     project: run.project,
     testId: run.testId,
     title: run.title,
+    ...run.article ? { article: run.article } : {},
+    ...run.articles ? { articles: run.articles } : {},
     tags: run.tags,
     startedAt: run.startedAt,
     checkpoints: run.checkpoints