screenci 0.0.4 → 0.0.6

package/dist/src/caption.d.ts

@@ -0,0 +1,152 @@
+import type { IEventRecorder } from './events.js';
+import type { VoiceKey, VoiceForLang, Lang } from './voices.js';
+export declare const ONE_FRAME_MS: number;
+/** A percentage string, e.g. `'50%'` or `'100%'`. */
+export type Percentage = `${number}%`;
+export declare function setSleepFn(fn: (ms: number) => void): void;
+export declare function setActiveCaptionRecorder(recorder: IEventRecorder | null): void;
+export declare function resetCaptionChain(): void;
+export interface CaptionController {
+    /**
+     * Begins voiceover audio and shows the caption overlay.
+     *
+     * @example
+     * ```ts
+     * await captions.intro.start()
+     * await page.goto('/dashboard')
+     * await captions.intro.end()
+     * ```
+     */
+    start(): Promise<void>;
+    /**
+     * Pauses execution until the voiceover audio reaches the given playback position.
+     *
+     * Use this to time a page interaction to a specific moment in the narration —
+     * for example, clicking a button right as the voiceover mentions it.
+     *
+     * @param progress - Playback position as a percentage string, e.g. `'50%'`.
+     *
+     * @example
+     * ```ts
+     * await captions.intro.start()
+     * await captions.intro.waitUntil('70%')  // wait until 70% of audio has played
+     * await page.locator('#cta').click()     // then click
+     * await captions.intro.end()
+     * ```
+     */
+    waitUntil(progress: string): Promise<void>;
+    /**
+     * Hides the caption overlay and stops voiceover playback.
+     * Always call this after every `start()`.
+     */
+    end(): Promise<void>;
+}
+/** A single caption value in a multi-language map: either TTS text or a file-based entry. */
+export type CaptionMapValue = string | {
+    path: string;
+    subtitle?: string;
+};
+export type Captions<T extends Record<string, CaptionMapValue>> = {
+    [K in keyof T]: CaptionController;
+};
+export type VideoCaptionEntry = string | {
+    path: string;
+    subtitle?: string;
+};
+export type VideoCaptions<T extends Record<string, VideoCaptionEntry>> = {
+    [K in keyof T]: CaptionController;
+};
+/** Converts a union type to an intersection: `A | B` → `A & B` */
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+/**
+ * Produces a record requiring every key that appears in any language's captions.
+ * Uses each language's key set with CaptionMapValue values before intersecting,
+ * so value types don't conflict (e.g. string vs { path, subtitle } for the same key).
+ */
+type AllCaptions<M extends Partial<Record<Lang, {
+    captions: Record<string, CaptionMapValue>;
+}>>> = UnionToIntersection<{
+    [L in keyof M]: M[L] extends {
+        captions: infer C;
+    } ? Record<keyof C & string, CaptionMapValue> : never;
+}[keyof M]> & Record<string, CaptionMapValue>;
+/**
+ * Creates a set of typed caption controllers, one per key in the map.
+ *
+ * Each controller has `start()`, `waitUntil(percent)`, and `end()`.
+ * At render time screenci sends the caption text to ElevenLabs, generates
+ * a voiceover, and syncs the audio to the recording. You write text; the
+ * voice is handled for you.
+ *
+ * TypeScript enforces that every language has the same caption keys.
+ * Forget a translation key → compile error.
+ *
+ * @example
+ * ```ts
+ * const captions = createCaptions({
+ *   en: { voice: voices.en.Jude, captions: { intro: 'Welcome.' } },
+ *   fi: { voice: voices.fi.Martti, captions: { intro: 'Tervetuloa.' } },
+ * })
+ * ```
+ */
+export declare function createCaptions<M extends Partial<Record<Lang, {
+    voice: VoiceKey;
+    captions: Record<string, CaptionMapValue>;
+}>>>(languagesMap: M & {
+    [L in keyof M]: {
+        voice: VoiceForLang<L & string>;
+        captions: AllCaptions<M>;
+    };
+}): Captions<AllCaptions<M>>;
+type RequireAllSameVideoKeys<M extends Partial<Record<Lang, {
+    captions: Record<string, VideoCaptionEntry>;
+}>>> = {
+    [L in keyof M]: {
+        captions: UnionToIntersection<M[keyof M] extends {
+            captions: infer C;
+        } ? C : never>;
+    };
+};
+/**
+ * Creates caption controllers backed by pre-recorded asset files instead of
+ * TTS-generated audio. Each entry maps a name to either an asset path string
+ * or an object with `assetPath` and an optional `subtitle` text.
+ *
+ * At render time the asset file is used directly as the voiceover audio.
+ * If `subtitle` is provided, words are spread with equal timing across the
+ * audio duration (no word-level TTS data available).
+ *
+ * Same constraints as `createCaptions`: cannot overlap with other captions,
+ * and cannot fall inside input events.
+ *
+ * Two overloads:
+ *
+ * **1. Single-language:**
+ * ```ts
+ * const captions = createVideoCaptions({
+ *   intro: '/assets/intro.mp3',
+ *   demo: { assetPath: '/assets/demo.mp3', subtitle: 'Watch the demo.' },
+ * })
+ * ```
+ *
+ * **2. Multi-language (type-safe):**
+ * TypeScript enforces that every language has the same caption keys.
+ * ```ts
+ * const captions = createVideoCaptions({
+ *   en: { captions: { intro: '/assets/en/intro.mp3' } },
+ *   fi: { captions: { intro: '/assets/fi/intro.mp3' } },
+ * })
+ * ```
+ */
+export declare function createVideoCaptions<T extends Record<string, VideoCaptionEntry>>(captionsMap: T): VideoCaptions<T>;
+export declare function createVideoCaptions<L extends Lang, T extends Record<string, VideoCaptionEntry>>(languagesMap: {
+    [K in L]: {
+        captions: T;
+    };
+} & RequireAllSameVideoKeys<{
+    [K in L]: {
+        captions: Record<string, VideoCaptionEntry>;
+    };
+}>): VideoCaptions<T & Record<string, VideoCaptionEntry>>;
+export {};
+//# sourceMappingURL=caption.d.ts.map

package/dist/src/caption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption.d.ts","sourceRoot":"","sources":["../../src/caption.ts"],"names":[],"mappings":"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"}

package/dist/src/caption.js

@@ -0,0 +1,240 @@
+import { isInsideHide } from './hide.js';
+// One frame at 24fps — ensures at least one rendered frame captures each caption state.
+export const ONE_FRAME_MS = 1000 / 24;
+function parsePercentage(percent) {
+    const value = parseFloat(percent);
+    if (!isFinite(value) || value < 0 || value > 100) {
+        throw new Error(`Invalid percentage: "${percent}". Must be a finite number between 0 and 100 followed by %.`);
+    }
+    return value;
+}
+// Blocking sleep — spin until the elapsed time has passed
+let sleepFn = (ms) => {
+    const end = performance.now() + ms;
+    while (performance.now() < end) {
+        /* spin */
+    }
+};
+export function setSleepFn(fn) {
+    sleepFn = fn;
+}
+let activeRecorder = null;
+let captionStarted = false;
+export function setActiveCaptionRecorder(recorder) {
+    activeRecorder = recorder;
+}
+export function resetCaptionChain() {
+    captionStarted = false;
+}
+function captionWaitEnd() {
+    if (activeRecorder === null)
+        return;
+    if (isInsideHide())
+        throw new Error('Cannot call caption.waitEnd inside hide()');
+    if (!captionStarted)
+        throw new Error('No caption has been started');
+    activeRecorder.addCaptionEnd();
+    sleepFn(2 * ONE_FRAME_MS);
+}
+function captionWaitUntil(percent) {
+    if (activeRecorder === null)
+        return;
+    if (isInsideHide())
+        throw new Error('Cannot call caption.waitUntil inside hide()');
+    if (!captionStarted)
+        throw new Error('No caption has been started');
+    const percentage = parsePercentage(percent);
+    activeRecorder.addCaptionUntil(percentage);
+    sleepFn(2 * ONE_FRAME_MS);
+}
+/**
+ * Creates a set of typed caption controllers, one per key in the map.
+ *
+ * Each controller has `start()`, `waitUntil(percent)`, and `end()`.
+ * At render time screenci sends the caption text to ElevenLabs, generates
+ * a voiceover, and syncs the audio to the recording. You write text; the
+ * voice is handled for you.
+ *
+ * TypeScript enforces that every language has the same caption keys.
+ * Forget a translation key → compile error.
+ *
+ * @example
+ * ```ts
+ * const captions = createCaptions({
+ *   en: { voice: voices.en.Jude, captions: { intro: 'Welcome.' } },
+ *   fi: { voice: voices.fi.Martti, captions: { intro: 'Tervetuloa.' } },
+ * })
+ * ```
+ */
+export function createCaptions(languagesMap) {
+    return buildMultiLangCaptions(languagesMap);
+}
+function buildMultiLangCaptions(languagesMap) {
+    const langs = Object.keys(languagesMap);
+    const firstLang = langs[0];
+    if (firstLang === undefined)
+        return {};
+    const result = {};
+    for (const key in languagesMap[firstLang].captions) {
+        const keyStr = key;
+        // Determine if any language uses a file-based value for this key.
+        // If so, use videoCaptionStart with mixed translations (file or TTS per lang).
+        // Otherwise use captionStart with text translations (existing behaviour).
+        const hasFileEntry = langs.some((lang) => {
+            const val = languagesMap[lang].captions[keyStr];
+            return val !== undefined && typeof val !== 'string';
+        });
+        if (hasFileEntry) {
+            const videoTranslations = {};
+            for (const lang of langs) {
+                const val = languagesMap[lang].captions[keyStr];
+                if (val === undefined)
+                    continue;
+                if (typeof val === 'string') {
+                    videoTranslations[lang] = {
+                        text: val,
+                        voice: languagesMap[lang].voice,
+                    };
+                }
+                else {
+                    const fileTrans = {
+                        assetPath: val.path,
+                        ...(val.subtitle !== undefined && { subtitle: val.subtitle }),
+                    };
+                    videoTranslations[lang] = fileTrans;
+                }
+            }
+            result[key] = {
+                async start() {
+                    if (activeRecorder === null)
+                        return;
+                    if (isInsideHide())
+                        throw new Error('Cannot call caption.start inside hide()');
+                    captionStarted = true;
+                    sleepFn(2 * ONE_FRAME_MS);
+                    activeRecorder.addVideoCaptionStart(keyStr, undefined, undefined, videoTranslations);
+                },
+                async waitUntil(progress) {
+                    captionWaitUntil(progress);
+                },
+                async end() {
+                    captionWaitEnd();
+                },
+            };
+        }
+        else {
+            const textTranslations = {};
+            for (const lang of langs) {
+                const val = languagesMap[lang].captions[keyStr];
+                if (val !== undefined && typeof val === 'string') {
+                    textTranslations[lang] = {
+                        text: val,
+                        voice: languagesMap[lang].voice,
+                    };
+                }
+            }
+            result[key] = {
+                async start() {
+                    if (activeRecorder === null)
+                        return;
+                    if (isInsideHide())
+                        throw new Error('Cannot call caption.start inside hide()');
+                    captionStarted = true;
+                    sleepFn(2 * ONE_FRAME_MS);
+                    activeRecorder.addCaptionStart('', keyStr, undefined, textTranslations);
+                },
+                async waitUntil(progress) {
+                    captionWaitUntil(progress);
+                },
+                async end() {
+                    captionWaitEnd();
+                },
+            };
+        }
+    }
+    return result;
+}
+function entryToVideoTranslation(entry) {
+    if (typeof entry === 'string')
+        return { assetPath: entry };
+    return {
+        assetPath: entry.path,
+        ...(entry.subtitle !== undefined && { subtitle: entry.subtitle }),
+    };
+}
+export function createVideoCaptions(firstArg) {
+    // Distinguish single-language vs multi-language by checking if any value has a `captions` key
+    const firstValue = Object.values(firstArg)[0];
+    if (firstValue !== undefined &&
+        typeof firstValue === 'object' &&
+        !Array.isArray(firstValue) &&
+        'captions' in firstValue &&
+        typeof firstValue.captions === 'object') {
+        return buildMultiLangVideoCaptions(firstArg);
+    }
+    return buildSingleLangVideoCaptions(firstArg);
+}
+function buildSingleLangVideoCaptions(captionsMap) {
+    const result = {};
+    for (const key in captionsMap) {
+        const entry = captionsMap[key];
+        if (entry === undefined)
+            continue;
+        const assetPath = typeof entry === 'string' ? entry : entry.path;
+        const subtitle = typeof entry === 'string' ? undefined : entry.subtitle;
+        result[key] = {
+            async start() {
+                if (activeRecorder === null)
+                    return;
+                if (isInsideHide())
+                    throw new Error('Cannot call videoCaption.start inside hide()');
+                captionStarted = true;
+                sleepFn(2 * ONE_FRAME_MS);
+                activeRecorder.addVideoCaptionStart(key, assetPath, subtitle);
+            },
+            async waitUntil(progress) {
+                captionWaitUntil(progress);
+            },
+            async end() {
+                captionWaitEnd();
+            },
+        };
+    }
+    return result;
+}
+function buildMultiLangVideoCaptions(languagesMap) {
+    const langs = Object.keys(languagesMap);
+    const firstLang = langs[0];
+    if (firstLang === undefined)
+        return {};
+    const result = {};
+    for (const key in languagesMap[firstLang].captions) {
+        const keyStr = key;
+        const translations = {};
+        for (const lang of langs) {
+            const entry = languagesMap[lang].captions[keyStr];
+            if (entry !== undefined) {
+                translations[lang] = entryToVideoTranslation(entry);
+            }
+        }
+        result[key] = {
+            async start() {
+                if (activeRecorder === null)
+                    return;
+                if (isInsideHide())
+                    throw new Error('Cannot call videoCaption.start inside hide()');
+                captionStarted = true;
+                sleepFn(2 * ONE_FRAME_MS);
+                activeRecorder.addVideoCaptionStart(keyStr, undefined, undefined, translations);
+            },
+            async waitUntil(progress) {
+                captionWaitUntil(progress);
+            },
+            async end() {
+                captionWaitEnd();
+            },
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=caption.js.map

package/dist/src/caption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption.js","sourceRoot":"","sources":["../../src/caption.ts"],"names":[],"mappings":"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"}

package/dist/src/caption.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=caption.test-d.d.ts.map

package/dist/src/caption.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption.test-d.d.ts","sourceRoot":"","sources":["../../src/caption.test-d.ts"],"names":[],"mappings":""}

package/dist/src/caption.test-d.js

@@ -0,0 +1,50 @@
+import { describe, it, assertType } from 'vitest';
+import { createCaptions } from './caption.js';
+import { voices } from './voices.js';
+describe('createCaptions type constraints', () => {
+    it('accepts matching keys across all languages', () => {
+        createCaptions({
+            en: {
+                voice: voices.en.Jude,
+                captions: { intro: 'Hello', outro: 'Bye' },
+            },
+            fi: {
+                voice: voices.fi.Martti,
+                captions: { intro: 'Hei', outro: 'Näkemiin' },
+            },
+        });
+    });
+    it('accepts mixed value types (string vs file object) for the same key', () => {
+        createCaptions({
+            en: {
+                voice: voices.en.Jude,
+                captions: {
+                    intro: 'Hello',
+                    clip: { path: '/clip.mp4', subtitle: 'Watch' },
+                },
+            },
+            fi: {
+                voice: voices.fi.Martti,
+                captions: { intro: 'Hei', clip: 'Katso' },
+            },
+        });
+    });
+    it('rejects a language with a missing caption key', () => {
+        createCaptions({
+            en: {
+                voice: voices.en.Jude,
+                captions: { intro: 'Hello', outro: 'Bye' },
+            },
+            fi: {
+                voice: voices.fi.Martti,
+                // @ts-expect-error — 'outro' is missing
+                captions: { intro: 'Hei' },
+            },
+        });
+    });
+    it('rejects a wrong-language voice', () => {
+        // @ts-expect-error — fi voice is not assignable to VoiceForLang<'en'>
+        assertType(voices.fi.Martti);
+    });
+});
+//# sourceMappingURL=caption.test-d.js.map

package/dist/src/caption.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption.test-d.js","sourceRoot":"","sources":["../../src/caption.test-d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,cAAc,CAAC;YACb,EAAE,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;gBACrB,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE;aAC3C;YACD,EAAE,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;gBACvB,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE;aAC9C;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,cAAc,CAAC;YACb,EAAE,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;gBACrB,QAAQ,EAAE;oBACR,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE;iBAC/C;aACF;YACD,EAAE,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;gBACvB,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE;aAC1C;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,cAAc,CAAC;YACb,EAAE,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;gBACrB,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE;aAC3C;YACD,EAAE,EAAE;gBACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;gBACvB,wCAAwC;gBACxC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;aAC3B;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,sEAAsE;QACtE,UAAU,CAAqB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/config.d.ts

@@ -0,0 +1,42 @@
+import type { ScreenCIConfig, ExtendedScreenCIConfig } from './types.js';
+/**
+ * Defines a screenci configuration file.
+ *
+ * Extends Playwright's config with screenci-specific options and enforces
+ * settings required for reliable video recording. Some Playwright options
+ * are locked and cannot be set — `workers`, `fullyParallel`, `retries`,
+ * `testDir`, and `testMatch`. Attempting to set them throws at startup.
+ *
+ * @example
+ * Minimal — all options have sensible defaults:
+ * ```ts
+ * import { defineConfig } from 'screenci'
+ * export default defineConfig({})
+ * ```
+ *
+ * @example
+ * Full config:
+ * ```ts
+ * import { defineConfig } from 'screenci'
+ *
+ * export default defineConfig({
+ *   projectName: 'my-project',
+ *   videoDir: './videos',
+ *   use: {
+ *     baseURL: 'https://app.example.com',
+ *     recordOptions: {
+ *       aspectRatio: '16:9',  // '16:9' | '9:16' | '1:1' | '4:3' | ...
+ *       quality: '1080p',     // '720p' | '1080p' | '1440p' | '2160p'
+ *       fps: 30,              // 24 | 30 | 60
+ *     },
+ *     trace: 'retain-on-failure',
+ *     sendTraces: true,
+ *   },
+ * })
+ * ```
+ *
+ * @param config - screenci configuration options
+ * @returns Extended Playwright configuration with enforced sequential execution settings
+ */
+export declare function defineConfig(config: ScreenCIConfig): ExtendedScreenCIConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAyBxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,sBAAsB,CA+H3E"}

package/dist/src/config.js

@@ -0,0 +1,147 @@
+import { DEFAULT_VIDEO_DIR, DEFAULT_TRACE, DEFAULT_SEND_TRACES, DEFAULT_TIMEOUT, DEFAULT_ACTION_TIMEOUT, DEFAULT_NAVIGATION_TIMEOUT, } from './defaults.js';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { existsSync } from 'fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Resolve reporter path - try .js first (production), then .ts (development)
+const reporterPathJs = resolve(__dirname, 'reporter.js');
+const reporterPathTs = resolve(__dirname, 'reporter.ts');
+const reporterPath = existsSync(reporterPathJs)
+    ? reporterPathJs
+    : reporterPathTs;
+/**
+ * Defines a screenci configuration file.
+ *
+ * Extends Playwright's config with screenci-specific options and enforces
+ * settings required for reliable video recording. Some Playwright options
+ * are locked and cannot be set — `workers`, `fullyParallel`, `retries`,
+ * `testDir`, and `testMatch`. Attempting to set them throws at startup.
+ *
+ * @example
+ * Minimal — all options have sensible defaults:
+ * ```ts
+ * import { defineConfig } from 'screenci'
+ * export default defineConfig({})
+ * ```
+ *
+ * @example
+ * Full config:
+ * ```ts
+ * import { defineConfig } from 'screenci'
+ *
+ * export default defineConfig({
+ *   projectName: 'my-project',
+ *   videoDir: './videos',
+ *   use: {
+ *     baseURL: 'https://app.example.com',
+ *     recordOptions: {
+ *       aspectRatio: '16:9',  // '16:9' | '9:16' | '1:1' | '4:3' | ...
+ *       quality: '1080p',     // '720p' | '1080p' | '1440p' | '2160p'
+ *       fps: 30,              // 24 | 30 | 60
+ *     },
+ *     trace: 'retain-on-failure',
+ *     sendTraces: true,
+ *   },
+ * })
+ * ```
+ *
+ * @param config - screenci configuration options
+ * @returns Extended Playwright configuration with enforced sequential execution settings
+ */
+export function defineConfig(config) {
+    // Add the video name validator reporter if not already present
+    const existingReporters = config.reporter
+        ? Array.isArray(config.reporter)
+            ? config.reporter
+            : [config.reporter]
+        : ['list'];
+    // Check if our validator is already added
+    const hasValidator = existingReporters.some((r) => {
+        if (Array.isArray(r)) {
+            return r[0] === reporterPath || r[0]?.toString().endsWith('reporter.js');
+        }
+        return r === reporterPath || r?.toString().endsWith('reporter.js');
+    });
+    // Convert all reporters to tuple format for Playwright validation
+    const normalizedReporters = existingReporters.map((r) => Array.isArray(r) ? r : [r]);
+    // Check if list reporter is present for CLI output
+    const hasListReporter = normalizedReporters.some((r) => {
+        const name = Array.isArray(r) ? r[0] : r;
+        return name === 'list' || name === 'line' || name === 'dot';
+    });
+    // Build reporters array with proper typing - all reporters must be tuples
+    // Add list reporter if no CLI reporter is present
+    const reportersWithCLI = hasListReporter
+        ? normalizedReporters
+        : [['list'], ...normalizedReporters];
+    const reporters = hasValidator
+        ? reportersWithCLI
+        : [[reporterPath, {}], ...reportersWithCLI];
+    // Runtime check for viewport (check before testDir since test objects may not have testDir defined)
+    if (config.use && 'viewport' in config.use) {
+        throw new Error('screenci does not support "viewport" option. ' +
+            'The viewport is automatically set based on the recordOptions.resolution. ' +
+            'Use recordOptions.resolution to control the viewport size.');
+    }
+    // Runtime check for viewport in projects
+    if (config.projects) {
+        for (const project of config.projects) {
+            if (project.use && 'viewport' in project.use) {
+                throw new Error(`screenci does not support "viewport" option in project "${project.name}". ` +
+                    'The viewport is automatically set based on the recordOptions.resolution. ' +
+                    'Use recordOptions.resolution to control the viewport size.');
+            }
+        }
+    }
+    // Runtime check for testDir
+    if (Object.prototype.hasOwnProperty.call(config, 'testDir') &&
+        config.testDir !== undefined) {
+        throw new Error('screenci does not support "testDir" option. ' +
+            'Use "videoDir" instead to specify the directory containing your *.video.* files. ' +
+            'Defaults to "./videos".');
+    }
+    // Runtime check for testMatch
+    if ('testMatch' in config) {
+        throw new Error('screenci does not support "testMatch" option. ' +
+            'screenci automatically configures tests to only run *.video.* files.');
+    }
+    // Runtime check for workers
+    if ('workers' in config) {
+        throw new Error('screenci does not support "workers" option. ' +
+            'Tests must run sequentially to ensure proper video recording. ' +
+            'screenci automatically configures workers to 1.');
+    }
+    // Runtime check for fullyParallel
+    if ('fullyParallel' in config) {
+        throw new Error('screenci does not support "fullyParallel" option. ' +
+            'Tests must run sequentially to ensure proper video recording. ' +
+            'screenci automatically sets fullyParallel to false.');
+    }
+    // Runtime check for retries
+    if ('retries' in config) {
+        throw new Error('screenci does not support "retries" option. ' +
+            'Tests must succeed immediately or fail to ensure proper video recording. ' +
+            'screenci automatically sets retries to 0.');
+    }
+    const { videoDir, ...rest } = config;
+    // Force sequential execution with single worker and no retries, map videoDir to testDir
+    return {
+        testDir: videoDir ?? DEFAULT_VIDEO_DIR,
+        testMatch: '**/*.video.?(c|m)[jt]s?(x)',
+        ...rest,
+        reporter: reporters,
+        use: {
+            ...rest.use,
+            trace: rest.use?.trace ?? DEFAULT_TRACE,
+            sendTraces: rest.use?.sendTraces ?? DEFAULT_SEND_TRACES,
+            actionTimeout: rest.use?.actionTimeout ?? DEFAULT_ACTION_TIMEOUT,
+            navigationTimeout: rest.use?.navigationTimeout ?? DEFAULT_NAVIGATION_TIMEOUT,
+        },
+        timeout: rest.timeout ?? DEFAULT_TIMEOUT,
+        fullyParallel: false,
+        workers: 1,
+        retries: 0,
+    };
+}
+//# sourceMappingURL=config.js.map