screenci 0.0.4 → 0.0.5

package/dist/src/config.js.map

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

package/dist/src/defaults.d.ts

@@ -0,0 +1,63 @@
+import type { AspectRatio, FPS, Quality, Trace, RecordOptions } from './types.js';
+/**
+ * Default zoom amount (fraction of output dimensions for the zoomed viewport)
+ */
+export declare const DEFAULT_ZOOM_AMOUNT: number;
+/**
+ * Default zoom transition duration in milliseconds
+ */
+export declare const DEFAULT_ZOOM_DURATION: number;
+/**
+ * Default delay in milliseconds after zoom-in and zoom-out animations
+ */
+export declare const DEFAULT_POST_ZOOM_IN_OUT_DELAY: number;
+/**
+ * Default zoom transition easing function
+ */
+export declare const DEFAULT_ZOOM_EASING: string;
+/**
+ * Default aspect ratio for recording and output
+ */
+export declare const DEFAULT_ASPECT_RATIO: AspectRatio;
+/**
+ * Default resolution quality preset
+ */
+export declare const DEFAULT_QUALITY: Quality;
+/**
+ * Default frames per second for video recording
+ */
+export declare const DEFAULT_FPS: FPS;
+/**
+ * Default trace recording mode
+ */
+export declare const DEFAULT_TRACE: Trace;
+/**
+ * Default setting for sending traces to screenci.com
+ */
+export declare const DEFAULT_SEND_TRACES: boolean;
+/**
+ * Default directory for video files
+ */
+export declare const DEFAULT_VIDEO_DIR: string;
+/**
+ * Default test timeout in milliseconds (30 minutes)
+ */
+export declare const DEFAULT_TIMEOUT: number;
+/**
+ * Default action timeout in milliseconds (30 seconds)
+ *
+ * Keeps individual actions (click, fill, etc.) at a sane timeout
+ * independent of the long test timeout.
+ */
+export declare const DEFAULT_ACTION_TIMEOUT: number;
+/**
+ * Default navigation timeout in milliseconds (30 seconds)
+ *
+ * Keeps page navigations at a sane timeout independent of the long test timeout.
+ */
+export declare const DEFAULT_NAVIGATION_TIMEOUT: number;
+/**
+ * Default video options combining all video-related defaults
+ */
+export declare const DEFAULT_VIDEO_OPTIONS: RecordOptions;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,GAAG,EACH,OAAO,EACP,KAAK,EACL,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAY,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAY,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAa,CAAA;AAE1D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAmB,CAAA;AAErD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAoB,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAAiB,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,GAAQ,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,KAA2B,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAc,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAuB,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAe,CAAA;AAEpD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAe,CAAA;AAExD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAInC,CAAA"}

package/dist/src/defaults.js

@@ -0,0 +1,66 @@
+/**
+ * Default zoom amount (fraction of output dimensions for the zoomed viewport)
+ */
+export const DEFAULT_ZOOM_AMOUNT = 0.5;
+/**
+ * Default zoom transition duration in milliseconds
+ */
+export const DEFAULT_ZOOM_DURATION = 500;
+/**
+ * Default delay in milliseconds after zoom-in and zoom-out animations
+ */
+export const DEFAULT_POST_ZOOM_IN_OUT_DELAY = 1000;
+/**
+ * Default zoom transition easing function
+ */
+export const DEFAULT_ZOOM_EASING = 'ease-out';
+/**
+ * Default aspect ratio for recording and output
+ */
+export const DEFAULT_ASPECT_RATIO = '16:9';
+/**
+ * Default resolution quality preset
+ */
+export const DEFAULT_QUALITY = '1080p';
+/**
+ * Default frames per second for video recording
+ */
+export const DEFAULT_FPS = 30;
+/**
+ * Default trace recording mode
+ */
+export const DEFAULT_TRACE = 'retain-on-failure';
+/**
+ * Default setting for sending traces to screenci.com
+ */
+export const DEFAULT_SEND_TRACES = true;
+/**
+ * Default directory for video files
+ */
+export const DEFAULT_VIDEO_DIR = './videos';
+/**
+ * Default test timeout in milliseconds (30 minutes)
+ */
+export const DEFAULT_TIMEOUT = 30 * 60 * 1000;
+/**
+ * Default action timeout in milliseconds (30 seconds)
+ *
+ * Keeps individual actions (click, fill, etc.) at a sane timeout
+ * independent of the long test timeout.
+ */
+export const DEFAULT_ACTION_TIMEOUT = 30_000;
+/**
+ * Default navigation timeout in milliseconds (30 seconds)
+ *
+ * Keeps page navigations at a sane timeout independent of the long test timeout.
+ */
+export const DEFAULT_NAVIGATION_TIMEOUT = 30_000;
+/**
+ * Default video options combining all video-related defaults
+ */
+export const DEFAULT_VIDEO_OPTIONS = {
+    aspectRatio: DEFAULT_ASPECT_RATIO,
+    quality: DEFAULT_QUALITY,
+    fps: DEFAULT_FPS,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/src/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,GAAG,CAAA;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAW,GAAG,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAW,IAAI,CAAA;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,UAAU,CAAA;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB,MAAM,CAAA;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY,OAAO,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAQ,EAAE,CAAA;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAU,mBAAmB,CAAA;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAY,IAAI,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAW,UAAU,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAW,MAAM,CAAA;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAW,MAAM,CAAA;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IAClD,WAAW,EAAE,oBAAoB;IACjC,OAAO,EAAE,eAAe;IACxB,GAAG,EAAE,WAAW;CACjB,CAAA"}

package/dist/src/dimensions.d.ts

@@ -0,0 +1,29 @@
+import type { AspectRatio, Quality } from './types.js';
+/**
+ * Compute pixel dimensions from an aspect ratio and quality preset.
+ *
+ * The `quality` value determines the shorter side in pixels:
+ * - `'720p'`   → 720 px
+ * - `'1080p'`  → 1080 px
+ * - `'1440p'`  → 1440 px
+ * - `'2160p'`  → 2160 px
+ *
+ * The `aspectRatio` then sets the longer dimension. For landscape ratios
+ * (W > H) height equals the base; for portrait ratios (H > W) width equals
+ * the base. Dimension table:
+ *
+ * | Aspect Ratio | 720p      | 1080p      | 1440p      | 2160p      |
+ * |--------------|-----------|------------|------------|------------|
+ * | 16:9         | 1280×720  | 1920×1080  | 2560×1440  | 3840×2160  |
+ * | 9:16         | 720×1280  | 1080×1920  | 1440×2560  | 2160×3840  |
+ * | 1:1          | 720×720   | 1080×1080  | 1440×1440  | 2160×2160  |
+ * | 4:3          | 960×720   | 1440×1080  | 1920×1440  | 2880×2160  |
+ * | 3:4          | 720×960   | 1080×1440  | 1440×1920  | 2160×2880  |
+ * | 5:4          | 900×720   | 1350×1080  | 1800×1440  | 2700×2160  |
+ * | 4:5          | 720×900   | 1080×1350  | 1440×1800  | 2160×2700  |
+ */
+export declare function getDimensions(aspectRatio: AspectRatio, quality: Quality): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=dimensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/dimensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAwBnC"}

package/dist/src/dimensions.js

@@ -0,0 +1,47 @@
+/**
+ * Compute pixel dimensions from an aspect ratio and quality preset.
+ *
+ * The `quality` value determines the shorter side in pixels:
+ * - `'720p'`   → 720 px
+ * - `'1080p'`  → 1080 px
+ * - `'1440p'`  → 1440 px
+ * - `'2160p'`  → 2160 px
+ *
+ * The `aspectRatio` then sets the longer dimension. For landscape ratios
+ * (W > H) height equals the base; for portrait ratios (H > W) width equals
+ * the base. Dimension table:
+ *
+ * | Aspect Ratio | 720p      | 1080p      | 1440p      | 2160p      |
+ * |--------------|-----------|------------|------------|------------|
+ * | 16:9         | 1280×720  | 1920×1080  | 2560×1440  | 3840×2160  |
+ * | 9:16         | 720×1280  | 1080×1920  | 1440×2560  | 2160×3840  |
+ * | 1:1          | 720×720   | 1080×1080  | 1440×1440  | 2160×2160  |
+ * | 4:3          | 960×720   | 1440×1080  | 1920×1440  | 2880×2160  |
+ * | 3:4          | 720×960   | 1080×1440  | 1440×1920  | 2160×2880  |
+ * | 5:4          | 900×720   | 1350×1080  | 1800×1440  | 2700×2160  |
+ * | 4:5          | 720×900   | 1080×1350  | 1440×1800  | 2160×2700  |
+ */
+export function getDimensions(aspectRatio, quality) {
+    // Base size is the shorter side of the output frame.
+    const baseSize = {
+        '720p': 720,
+        '1080p': 1080,
+        '1440p': 1440,
+        '2160p': 2160,
+    };
+    const base = baseSize[quality];
+    // For landscape ratios (W > H): height = base, width = base × W/H.
+    // For portrait ratios  (H > W): width  = base, height = base × H/W.
+    // For square (1:1):             both sides equal base.
+    const dimensions = {
+        '16:9': { width: (base * 16) / 9, height: base },
+        '9:16': { width: base, height: (base * 16) / 9 },
+        '1:1': { width: base, height: base },
+        '4:3': { width: (base * 4) / 3, height: base },
+        '3:4': { width: base, height: (base * 4) / 3 },
+        '5:4': { width: (base * 5) / 4, height: base },
+        '4:5': { width: base, height: (base * 5) / 4 },
+    };
+    return dimensions[aspectRatio];
+}
+//# sourceMappingURL=dimensions.js.map

package/dist/src/dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/dimensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAwB,EACxB,OAAgB;IAEhB,qDAAqD;IACrD,MAAM,QAAQ,GAA4B;QACxC,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;KACd,CAAA;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B,mEAAmE;IACnE,oEAAoE;IACpE,uDAAuD;IACvD,MAAM,UAAU,GAA2D;QACzE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAChD,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE;QAChD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACpC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;KAC/C,CAAA;IAED,OAAO,UAAU,CAAC,WAAW,CAAC,CAAA;AAChC,CAAC"}

package/dist/src/events.d.ts

@@ -0,0 +1,203 @@
+import type { AutoZoomOptions, CaptionConfig, Easing, RecordOptions, RenderOptions } from './types.js';
+import type { VoiceKey } from './voices.js';
+export type VideoStartEvent = {
+    type: 'videoStart';
+    timeMs: 0;
+};
+export type ElementRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type MouseMoveEvent = {
+    type: 'mouseMove';
+    startMs: number;
+    endMs: number;
+    x: number;
+    y: number;
+    easing?: Easing;
+    zoomFollow?: boolean;
+    /** Bounding rect of the element the cursor moved to — used for zoom centering hints. */
+    elementRect?: ElementRect;
+};
+export type MouseDownEvent = {
+    type: 'mouseDown';
+    startMs: number;
+    endMs: number;
+    mouseSize?: number;
+    easing?: Easing;
+};
+export type MouseUpEvent = {
+    type: 'mouseUp';
+    startMs: number;
+    endMs: number;
+    easing?: Easing;
+};
+export type MouseShowEvent = {
+    type: 'mouseShow';
+    startMs: number;
+    endMs: number;
+};
+export type MouseHideEvent = {
+    type: 'mouseHide';
+    startMs: number;
+    endMs: number;
+};
+export type MouseWaitEvent = {
+    type: 'mouseWait';
+    startMs: number;
+    endMs: number;
+};
+/**
+ * A recorded user input action containing one or more inner mouse events.
+ * mouseMove, mouseShow, and mouseHide subtypes each contain exactly one inner event.
+ * All input events must not overlap in time; recording will throw if they do.
+ * Captions are automatically prevented from falling inside any input event's time range.
+ */
+export type InputEvent = {
+    type: 'input';
+    subType: 'click' | 'pressSequentially' | 'tap' | 'check' | 'uncheck' | 'select' | 'mouseMove' | 'mouseShow' | 'mouseHide' | 'hover' | 'selectText' | 'dragTo';
+    elementRect?: ElementRect;
+    events: Array<MouseMoveEvent | MouseDownEvent | MouseUpEvent | MouseShowEvent | MouseHideEvent | MouseWaitEvent>;
+};
+export type CaptionTranslation = {
+    text: string;
+    voice: VoiceKey;
+};
+export type CaptionStartEvent = {
+    type: 'captionStart';
+    timeMs: number;
+    name: string;
+    /** Single-language API (backward compat) */
+    text?: string;
+    captionConfig?: CaptionConfig;
+    /** Multi-language API — all language translations keyed by language code */
+    translations?: Record<string, CaptionTranslation>;
+};
+export type CaptionUntilEvent = {
+    type: 'captionUntil';
+    timeMs: number;
+    percentage: number;
+};
+export type CaptionEndEvent = {
+    type: 'captionEnd';
+    timeMs: number;
+};
+/** File-based video caption translation — uses a pre-recorded asset. */
+export type VideoCaptionTranslationFile = {
+    assetPath: string;
+    subtitle?: string;
+};
+/** TTS-based video caption translation — generates audio via text-to-speech. */
+export type VideoCaptionTranslationTTS = {
+    text: string;
+    voice: VoiceKey;
+};
+export type VideoCaptionTranslation = VideoCaptionTranslationFile | VideoCaptionTranslationTTS;
+export type VideoCaptionStartEvent = {
+    type: 'videoCaptionStart';
+    timeMs: number;
+    name: string;
+    /** Single-language API: absolute path to the pre-recorded audio/video file. */
+    assetPath?: string;
+    /** Optional subtitle text. Words are spread with equal timing at render time. */
+    subtitle?: string;
+    /** Multi-language API — per-language asset paths keyed by language code. */
+    translations?: Record<string, VideoCaptionTranslation>;
+};
+export type AssetStartEvent = {
+    type: 'assetStart';
+    timeMs: number;
+    name: string;
+    path: string;
+    audio: number;
+    fullScreen: boolean;
+};
+export type AssetEndEvent = {
+    type: 'assetEnd';
+    timeMs: number;
+    name: string;
+};
+export type HideStartEvent = {
+    type: 'hideStart';
+    timeMs: number;
+};
+export type HideEndEvent = {
+    type: 'hideEnd';
+    timeMs: number;
+};
+export type AutoZoomStartEvent = {
+    type: 'autoZoomStart';
+    timeMs: number;
+    easing: string;
+    duration: number;
+    amount: number;
+    centering?: {
+        cursor?: number;
+        input?: number;
+        click?: number;
+    };
+    allowZoomingOut?: boolean;
+};
+export type AutoZoomEndEvent = {
+    type: 'autoZoomEnd';
+    timeMs: number;
+    easing: string;
+    duration: number;
+};
+export type RecordingEvent = VideoStartEvent | InputEvent | CaptionStartEvent | CaptionUntilEvent | CaptionEndEvent | VideoCaptionStartEvent | AssetStartEvent | AssetEndEvent | HideStartEvent | HideEndEvent | AutoZoomStartEvent | AutoZoomEndEvent;
+export type RecordingMetadata = {
+    videoName: string;
+    /** Language codes present in multi-language captions, e.g. `['en', 'de']`. Omitted when no multi-language captions are used. */
+    languages?: string[];
+};
+export type RecordingData = {
+    events: RecordingEvent[];
+    renderOptions?: RenderOptions;
+    recordOptions?: RecordOptions;
+    metadata?: RecordingMetadata;
+};
+export interface IEventRecorder {
+    start(): void;
+    /**
+     * Records an input action. Inner event timestamps are absolute (e.g. Date.now())
+     * and are converted to recording-relative milliseconds internally.
+     * Throws if the event's time span overlaps with any previously recorded input event.
+     */
+    addInput(subType: InputEvent['subType'], elementRect: ElementRect | undefined, events: InputEvent['events']): void;
+    addCaptionStart(text: string, name: string, captionConfig?: CaptionConfig, translations?: Record<string, CaptionTranslation>): void;
+    addCaptionUntil(percentage: number): void;
+    addCaptionEnd(): void;
+    addVideoCaptionStart(name: string, assetPath: string | undefined, subtitle?: string, translations?: Record<string, VideoCaptionTranslation>): void;
+    addAssetStart(name: string, path: string, audio: number, fullScreen: boolean): void;
+    addAssetEnd(name: string): void;
+    addHideStart(): void;
+    addHideEnd(): void;
+    addAutoZoomStart(options?: AutoZoomOptions): void;
+    addAutoZoomEnd(options?: AutoZoomOptions): void;
+    getEvents(): RecordingEvent[];
+    writeToFile(dir: string, videoName: string): Promise<void>;
+}
+export declare class EventRecorder implements IEventRecorder {
+    private readonly events;
+    private startTime;
+    private readonly recordOptions;
+    private readonly renderOptions;
+    constructor(renderOptions?: RenderOptions, recordOptions?: RecordOptions);
+    start(): void;
+    addInput(subType: InputEvent['subType'], elementRect: ElementRect | undefined, events: InputEvent['events']): void;
+    addCaptionStart(text: string, name: string, captionConfig?: CaptionConfig, translations?: Record<string, CaptionTranslation>): void;
+    addCaptionUntil(percentage: number): void;
+    addCaptionEnd(): void;
+    addVideoCaptionStart(name: string, assetPath: string | undefined, subtitle?: string, translations?: Record<string, VideoCaptionTranslation>): void;
+    addAssetStart(name: string, path: string, audio: number, fullScreen: boolean): void;
+    addAssetEnd(name: string): void;
+    addHideStart(): void;
+    addHideEnd(): void;
+    addAutoZoomStart(options?: AutoZoomOptions): void;
+    addAutoZoomEnd(options?: AutoZoomOptions): void;
+    getEvents(): RecordingEvent[];
+    writeToFile(dir: string, videoName: string): Promise<void>;
+}
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/src/events.js

@@ -0,0 +1,227 @@
+import { writeFile } from 'fs/promises';
+import { join } from 'path';
+import { DEFAULT_ZOOM_AMOUNT, DEFAULT_ZOOM_DURATION, DEFAULT_ZOOM_EASING, } from './defaults.js';
+import { getDimensions } from './dimensions.js';
+export class EventRecorder {
+    events = [];
+    startTime = null;
+    recordOptions;
+    renderOptions;
+    constructor(renderOptions, recordOptions) {
+        this.recordOptions = recordOptions;
+        this.renderOptions = renderOptions;
+    }
+    start() {
+        this.startTime = Date.now();
+        this.events.push({ type: 'videoStart', timeMs: 0 });
+    }
+    addInput(subType, elementRect, events) {
+        if (this.startTime === null)
+            return;
+        if (events.length === 0)
+            return;
+        const st = this.startTime;
+        const relStart = events[0].startMs - st;
+        const relEnd = events[events.length - 1].endMs - st;
+        for (const existing of this.events) {
+            if (existing.type === 'input') {
+                const existingStart = existing.events[0].startMs;
+                const existingEnd = existing.events[existing.events.length - 1].endMs;
+                if (relStart < existingEnd && relEnd > existingStart) {
+                    throw new Error(`Input event '${subType}' [${relStart}ms, ${relEnd}ms] overlaps with existing '${existing.subType}' event [${existingStart}ms, ${existingEnd}ms]`);
+                }
+            }
+            else if (existing.type === 'autoZoomStart' ||
+                existing.type === 'autoZoomEnd') {
+                if (existing.timeMs > relStart && existing.timeMs < relEnd) {
+                    throw new Error(`Input event '${subType}' [${relStart}ms, ${relEnd}ms] contains ${existing.type} at ${existing.timeMs}ms`);
+                }
+            }
+        }
+        const relativeEvents = events.map((e) => ({
+            ...e,
+            startMs: e.startMs - st,
+            endMs: e.endMs - st,
+        }));
+        this.events.push({
+            type: 'input',
+            subType,
+            ...(elementRect !== undefined && { elementRect }),
+            events: relativeEvents,
+        });
+    }
+    addCaptionStart(text, name, captionConfig, translations) {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({
+            type: 'captionStart',
+            timeMs,
+            name,
+            ...(text.length > 0 && { text }),
+            ...(captionConfig !== undefined && { captionConfig }),
+            ...(translations !== undefined && { translations }),
+        });
+    }
+    addCaptionUntil(percentage) {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({ type: 'captionUntil', timeMs, percentage });
+    }
+    addCaptionEnd() {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({ type: 'captionEnd', timeMs });
+    }
+    addVideoCaptionStart(name, assetPath, subtitle, translations) {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({
+            type: 'videoCaptionStart',
+            timeMs,
+            name,
+            ...(assetPath !== undefined && { assetPath }),
+            ...(subtitle !== undefined && { subtitle }),
+            ...(translations !== undefined && { translations }),
+        });
+    }
+    addAssetStart(name, path, audio, fullScreen) {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({
+            type: 'assetStart',
+            timeMs,
+            name,
+            path,
+            audio,
+            fullScreen,
+        });
+    }
+    addAssetEnd(name) {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({ type: 'assetEnd', timeMs, name });
+    }
+    addHideStart() {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({ type: 'hideStart', timeMs });
+    }
+    addHideEnd() {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        this.events.push({ type: 'hideEnd', timeMs });
+    }
+    addAutoZoomStart(options) {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        for (const existing of this.events) {
+            if (existing.type !== 'input')
+                continue;
+            const existingStart = existing.events[0].startMs;
+            const existingEnd = existing.events[existing.events.length - 1].endMs;
+            if (timeMs > existingStart && timeMs < existingEnd) {
+                throw new Error(`autoZoomStart at ${timeMs}ms falls inside input '${existing.subType}' event [${existingStart}ms, ${existingEnd}ms]`);
+            }
+        }
+        this.events.push({
+            type: 'autoZoomStart',
+            timeMs,
+            easing: options?.easing ?? DEFAULT_ZOOM_EASING,
+            duration: options?.duration ?? DEFAULT_ZOOM_DURATION,
+            amount: options?.amount ?? DEFAULT_ZOOM_AMOUNT,
+            ...(options?.centering !== undefined && {
+                centering: options.centering,
+            }),
+            ...(options?.allowZoomingOut !== undefined && {
+                allowZoomingOut: options.allowZoomingOut,
+            }),
+        });
+    }
+    addAutoZoomEnd(options) {
+        if (this.startTime === null)
+            return;
+        const timeMs = Date.now() - this.startTime;
+        for (const existing of this.events) {
+            if (existing.type !== 'input')
+                continue;
+            const existingStart = existing.events[0].startMs;
+            const existingEnd = existing.events[existing.events.length - 1].endMs;
+            if (timeMs > existingStart && timeMs < existingEnd) {
+                throw new Error(`autoZoomEnd at ${timeMs}ms falls inside input '${existing.subType}' event [${existingStart}ms, ${existingEnd}ms]`);
+            }
+        }
+        this.events.push({
+            type: 'autoZoomEnd',
+            timeMs,
+            easing: options?.easing ?? DEFAULT_ZOOM_EASING,
+            duration: options?.duration ?? DEFAULT_ZOOM_DURATION,
+        });
+    }
+    getEvents() {
+        return [...this.events];
+    }
+    async writeToFile(dir, videoName) {
+        const filePath = join(dir, 'data.json');
+        // Always default output.aspectRatio to '16:9' if not explicitly set.
+        const renderOptionsWithDefaults = {
+            ...this.renderOptions,
+            output: {
+                ...this.renderOptions?.output,
+                aspectRatio: this.renderOptions?.output?.aspectRatio ?? '16:9',
+            },
+        };
+        let serializedRenderOptions = renderOptionsWithDefaults;
+        // outputOpts is always defined because renderOptionsWithDefaults.output is always set above
+        const outputOpts = renderOptionsWithDefaults.output;
+        if (outputOpts.aspectRatio !== undefined &&
+            outputOpts.quality !== undefined) {
+            const { width, height } = getDimensions(outputOpts.aspectRatio, outputOpts.quality);
+            const { aspectRatio: _aspectRatio, quality: _quality, ...restOutput } = outputOpts;
+            serializedRenderOptions = {
+                ...renderOptionsWithDefaults,
+                output: {
+                    ...restOutput,
+                    resolution: `${width}x${height}`,
+                },
+            };
+        }
+        const languageSet = new Set();
+        for (const event of this.events) {
+            if (event.type === 'captionStart') {
+                if (event.translations !== undefined) {
+                    for (const lang of Object.keys(event.translations)) {
+                        languageSet.add(lang);
+                    }
+                }
+                else if (event.captionConfig?.voice !== undefined) {
+                    const lang = event.captionConfig.voice.split('.')[0];
+                    if (lang)
+                        languageSet.add(lang);
+                }
+            }
+        }
+        const languages = languageSet.size > 0 ? [...languageSet].sort() : undefined;
+        const data = {
+            events: this.events,
+            renderOptions: serializedRenderOptions,
+            ...(this.recordOptions !== undefined && {
+                recordOptions: this.recordOptions,
+            }),
+            metadata: {
+                videoName,
+                ...(languages !== undefined && { languages }),
+            },
+        };
+        await writeFile(filePath, JSON.stringify(data, null, 2));
+    }
+}
+//# sourceMappingURL=events.js.map