screencli 0.1.0

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACH,IAAI,EAAE,MAAM;gBAApC,OAAO,EAAE,MAAM,EAAS,IAAI,EAAE,MAAM;CAIjD;AAED,qBAAa,YAAa,SAAQ,cAAc;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,cAAc;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/src/utils/errors.js

@@ -0,0 +1,39 @@
+export class ScreencliError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ScreencliError';
+    }
+}
+export class BrowserError extends ScreencliError {
+    constructor(message) {
+        super(message, 'BROWSER_ERROR');
+        this.name = 'BrowserError';
+    }
+}
+export class AgentError extends ScreencliError {
+    constructor(message) {
+        super(message, 'AGENT_ERROR');
+        this.name = 'AgentError';
+    }
+}
+export class FFmpegError extends ScreencliError {
+    constructor(message) {
+        super(message, 'FFMPEG_ERROR');
+        this.name = 'FFmpegError';
+    }
+}
+export class ExportError extends ScreencliError {
+    constructor(message) {
+        super(message, 'EXPORT_ERROR');
+        this.name = 'ExportError';
+    }
+}
+export class ConfigError extends ScreencliError {
+    constructor(message) {
+        super(message, 'CONFIG_ERROR');
+        this.name = 'ConfigError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACH;IAApC,YAAY,OAAe,EAAS,IAAY;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,SAAI,GAAJ,IAAI,CAAQ;QAE9C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,cAAc;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,9 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug(msg: string, data?: unknown): void;
+    info(msg: string, data?: unknown): void;
+    warn(msg: string, data?: unknown): void;
+    error(msg: string, data?: unknown): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAUD,eAAO,MAAM,MAAM;eACN,MAAM,SAAS,OAAO,GAAG,IAAI;cAK9B,MAAM,SAAS,OAAO,GAAG,IAAI;cAK7B,MAAM,SAAS,OAAO,GAAG,IAAI;eAK5B,MAAM,SAAS,OAAO,GAAG,IAAI;CAIzC,CAAC"}

package/dist/src/utils/logger.js

@@ -0,0 +1,40 @@
+import chalk from 'chalk';
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentLevel = 'info';
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];
+}
+function timestamp() {
+    return new Date().toISOString().slice(11, 23);
+}
+export const logger = {
+    debug(msg, data) {
+        if (!shouldLog('debug'))
+            return;
+        console.error(chalk.gray(`[${timestamp()}] DEBUG ${msg}`), data ?? '');
+    },
+    info(msg, data) {
+        if (!shouldLog('info'))
+            return;
+        console.error(chalk.blue(`[${timestamp()}] INFO  ${msg}`), data ?? '');
+    },
+    warn(msg, data) {
+        if (!shouldLog('warn'))
+            return;
+        console.error(chalk.yellow(`[${timestamp()}] WARN  ${msg}`), data ?? '');
+    },
+    error(msg, data) {
+        if (!shouldLog('error'))
+            return;
+        console.error(chalk.red(`[${timestamp()}] ERROR ${msg}`), data ?? '');
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,GAAW,EAAE,IAAc;QAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,WAAW,GAAG,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,IAAc;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAAE,OAAO;QAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,WAAW,GAAG,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,IAAc;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAAE,OAAO;QAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,EAAE,WAAW,GAAG,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,IAAc;QAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,WAAW,GAAG,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;CACF,CAAC"}

package/dist/src/utils/paths.d.ts

@@ -0,0 +1,9 @@
+export declare function ensureDir(dir: string): string;
+export declare function recordingDir(baseOutput: string, id: string): string;
+export declare function screenshotsDir(recDir: string): string;
+export declare function exportsDir(recDir: string): string;
+export declare function rawVideoPath(recDir: string): string;
+export declare function eventsPath(recDir: string): string;
+export declare function metadataPath(recDir: string): string;
+export declare function composedVideoPath(recDir: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/src/utils/paths.js

@@ -0,0 +1,28 @@
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+export function ensureDir(dir) {
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+export function recordingDir(baseOutput, id) {
+    return ensureDir(join(baseOutput, id));
+}
+export function screenshotsDir(recDir) {
+    return ensureDir(join(recDir, 'screenshots'));
+}
+export function exportsDir(recDir) {
+    return ensureDir(join(recDir, 'exports'));
+}
+export function rawVideoPath(recDir) {
+    return join(recDir, 'raw.webm');
+}
+export function eventsPath(recDir) {
+    return join(recDir, 'events.json');
+}
+export function metadataPath(recDir) {
+    return join(recDir, 'metadata.json');
+}
+export function composedVideoPath(recDir) {
+    return join(recDir, 'composed.mp4');
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,EAAU;IACzD,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/video/background.d.ts

@@ -0,0 +1,39 @@
+import type { Viewport } from '../recording/types.js';
+export type GradientPreset = 'aurora' | 'sunset' | 'ocean' | 'lavender' | 'mint' | 'ember';
+export declare const GRADIENT_PRESETS: GradientPreset[];
+export interface BackgroundOptions {
+    gradient: GradientPreset;
+    /** Padding as a percentage of output size (0–50). Default 8. */
+    padding: number;
+    /** Corner radius in pixels. Default 12. */
+    cornerRadius: number;
+    /** Add a drop shadow behind the video frame. Default true. */
+    shadow: boolean;
+}
+export declare const DEFAULT_BACKGROUND: BackgroundOptions;
+interface LayoutMetrics {
+    outW: number;
+    outH: number;
+    scaledW: number;
+    scaledH: number;
+    padX: number;
+    padY: number;
+}
+/**
+ * Compute layout when the source aspect ratio differs from the output.
+ * The video is fit (letterboxed) inside the padded area.
+ */
+export declare function computeFitLayout(source: Viewport, output: Viewport, padding: number): LayoutMetrics;
+/**
+ * Build an FFmpeg filter_complex that composites the video onto a colourful
+ * gradient background with optional rounded corners and drop shadow.
+ *
+ * @param effectFilters  Any pre-existing -vf style effect filters (may be empty).
+ * @param viewport       Output dimensions.
+ * @param opts           Background configuration.
+ * @param layout         Optional pre-computed layout (for fit/letterbox cases).
+ * @returns The full filter_complex string. Output label is `[out]`.
+ */
+export declare function buildBackgroundFilterComplex(effectFilters: string[], viewport: Viewport, opts: BackgroundOptions, layout?: LayoutMetrics): string;
+export {};
+//# sourceMappingURL=background.d.ts.map

package/dist/src/video/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/video/background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3F,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAA+D,CAAC;AA8C7G,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,iBAKhC,CAAC;AAEF,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAuBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,MAAM,GACd,aAAa,CAmBf;AAcD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,iBAAiB,EACvB,MAAM,CAAC,EAAE,aAAa,GACrB,MAAM,CA4CR"}

package/dist/src/video/background.js

@@ -0,0 +1,141 @@
+export const GRADIENT_PRESETS = ['aurora', 'sunset', 'ocean', 'lavender', 'mint', 'ember'];
+/**
+ * Gradient definitions using FFmpeg geq expressions.
+ * X/Y = pixel coords, W/H = frame dimensions.
+ * Trig functions at varying frequencies/phases produce organic colour blends.
+ */
+const gradients = {
+    aurora: {
+        r: '70+50*sin(2*PI*X/W+1.2)+30*cos(3*PI*Y/H)',
+        g: '90+80*sin(2*PI*Y/H+0.5)+40*cos(1.5*PI*X/W)',
+        b: '180+60*sin(1.5*PI*X/W)+40*cos(2*PI*Y/H+2)',
+    },
+    sunset: {
+        r: '210+40*sin(2*PI*Y/H)+20*cos(3*PI*X/W)',
+        g: '90+60*sin(2.5*PI*X/W+1)+30*cos(2*PI*Y/H)',
+        b: '130+80*cos(2*PI*X/W+PI*Y/H)+30*sin(3*PI*Y/H)',
+    },
+    ocean: {
+        r: '20+35*sin(2*PI*X/W*1.5)+15*cos(2*PI*Y/H)',
+        g: '100+70*sin(2*PI*Y/H+0.7)+35*cos(1.8*PI*X/W)',
+        b: '190+55*cos(PI*X/W+1.5*PI*Y/H)+30*sin(2.5*PI*X/W)',
+    },
+    lavender: {
+        r: '155+65*sin(2*PI*X/W+0.8)+25*cos(2.5*PI*Y/H)',
+        g: '95+45*sin(2.5*PI*Y/H+1.2)+20*cos(2*PI*X/W)',
+        b: '200+45*cos(1.5*PI*(X+Y)/(W+H))+25*sin(3*PI*X/W)',
+    },
+    mint: {
+        r: '130+55*sin(2*PI*Y/H+0.5)+20*cos(2.5*PI*X/W)',
+        g: '195+50*cos(1.5*PI*X/W+0.3)+25*sin(2*PI*Y/H)',
+        b: '165+55*sin(2*PI*X/W+2*PI*Y/H)+20*cos(3*PI*Y/H)',
+    },
+    ember: {
+        r: '200+50*sin(1.5*PI*X/W)+25*cos(2*PI*Y/H+1)',
+        g: '70+55*sin(2*PI*Y/H+0.8)+25*cos(2.5*PI*X/W)',
+        b: '40+35*cos(2*PI*(X+Y)/(W+H)+1.5)+20*sin(3*PI*X/W)',
+    },
+};
+export const DEFAULT_BACKGROUND = {
+    gradient: 'aurora',
+    padding: 8,
+    cornerRadius: 12,
+    shadow: true,
+};
+/** Ensure value is even (required by most video codecs). */
+function even(n) {
+    return n % 2 === 0 ? n : n - 1;
+}
+function computeLayout(viewport, padding) {
+    const outW = even(viewport.width);
+    const outH = even(viewport.height);
+    const fraction = padding / 100;
+    const padX = Math.round(outW * fraction);
+    const padY = Math.round(outH * fraction);
+    return {
+        outW,
+        outH,
+        scaledW: even(outW - 2 * padX),
+        scaledH: even(outH - 2 * padY),
+        padX,
+        padY,
+    };
+}
+/**
+ * Compute layout when the source aspect ratio differs from the output.
+ * The video is fit (letterboxed) inside the padded area.
+ */
+export function computeFitLayout(source, output, padding) {
+    const outW = even(output.width);
+    const outH = even(output.height);
+    const fraction = padding / 100;
+    const maxW = outW - 2 * Math.round(outW * fraction);
+    const maxH = outH - 2 * Math.round(outH * fraction);
+    const scale = Math.min(maxW / source.width, maxH / source.height);
+    const scaledW = even(Math.round(source.width * scale));
+    const scaledH = even(Math.round(source.height * scale));
+    return {
+        outW,
+        outH,
+        scaledW,
+        scaledH,
+        padX: Math.round((outW - scaledW) / 2),
+        padY: Math.round((outH - scaledH) / 2),
+    };
+}
+function buildCornerRadiusExpr(radius) {
+    const R = radius;
+    // geq alpha expression that rounds the four corners.
+    // Inside the corner quadrant: use circular distance check.
+    // Outside corner quadrants: fully opaque.
+    return (`a='if(gt(abs(X-W/2),W/2-${R})*gt(abs(Y-H/2),H/2-${R}),` +
+        `if(lte(hypot(abs(X-W/2)-(W/2-${R}),abs(Y-H/2)-(H/2-${R})),${R}),255,0),255)'` +
+        `:r='r(X,Y)':g='g(X,Y)':b='b(X,Y)'`);
+}
+/**
+ * Build an FFmpeg filter_complex that composites the video onto a colourful
+ * gradient background with optional rounded corners and drop shadow.
+ *
+ * @param effectFilters  Any pre-existing -vf style effect filters (may be empty).
+ * @param viewport       Output dimensions.
+ * @param opts           Background configuration.
+ * @param layout         Optional pre-computed layout (for fit/letterbox cases).
+ * @returns The full filter_complex string. Output label is `[out]`.
+ */
+export function buildBackgroundFilterComplex(effectFilters, viewport, opts, layout) {
+    const grad = gradients[opts.gradient];
+    const m = layout ?? computeLayout(viewport, opts.padding);
+    const { outW, outH, scaledW, scaledH, padX, padY } = m;
+    const chains = [];
+    // ── Chain 1: process input → scale → round corners ──
+    const effectStr = effectFilters.length > 0 ? effectFilters.join(',') + ',' : '';
+    let fgChain = `[0:v]${effectStr}scale=${scaledW}:${scaledH},format=rgba`;
+    if (opts.cornerRadius > 0) {
+        fgChain += `,geq=${buildCornerRadiusExpr(opts.cornerRadius)}`;
+    }
+    if (opts.shadow) {
+        fgChain += '[fg_raw]';
+        chains.push(fgChain);
+        chains.push('[fg_raw]split[fg][shadow_src]');
+        chains.push('[shadow_src]colorchannelmixer=rr=0:gg=0:bb=0:aa=0.4,boxblur=12:4[shadow]');
+    }
+    else {
+        fgChain += '[fg]';
+        chains.push(fgChain);
+    }
+    // ── Chain 2: generate gradient background ──
+    chains.push(`color=s=${outW}x${outH}:c=black:r=30,` +
+        `geq=r='${grad.r}':g='${grad.g}':b='${grad.b}',format=rgba[bg]`);
+    // ── Chain 3: composite ──
+    if (opts.shadow) {
+        const sx = padX + 4;
+        const sy = padY + 6;
+        chains.push(`[bg][shadow]overlay=${sx}:${sy}:shortest=1[bg_s]`);
+        chains.push(`[bg_s][fg]overlay=${padX}:${padY}:shortest=1[out]`);
+    }
+    else {
+        chains.push(`[bg][fg]overlay=${padX}:${padY}:shortest=1[out]`);
+    }
+    return chains.join(';');
+}
+//# sourceMappingURL=background.js.map

package/dist/src/video/background.js.map

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

package/dist/src/video/compose.d.ts

@@ -0,0 +1,14 @@
+import type { RecordingEvent, Viewport } from '../recording/types.js';
+import { type BackgroundOptions } from './background.js';
+export interface ComposeOptions {
+    rawVideoPath: string;
+    events: RecordingEvent[];
+    outputPath: string;
+    viewport: Viewport;
+    zoom: boolean;
+    highlight: boolean;
+    cursor: boolean;
+    background?: BackgroundOptions;
+}
+export declare function composeVideo(options: ComposeOptions): Promise<string>;
+//# sourceMappingURL=compose.d.ts.map

package/dist/src/video/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/video/compose.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtE,OAAO,EAAgC,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIvF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AA6BD,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuH3E"}

package/dist/src/video/compose.js

@@ -0,0 +1,149 @@
+import { join, dirname } from 'node:path';
+import { generateZoomKeyframes, buildZoomFilterExpr } from './zoom.js';
+import { buildHighlightFilters } from './highlight.js';
+import { buildCursorFilter } from './cursor.js';
+import { computeActiveSegments, buildTrimFilter, estimateTrimmedDuration } from './trim.js';
+import { runFFmpeg, getVideoDuration } from './ffmpeg.js';
+import { buildBackgroundFilterComplex } from './background.js';
+import { logger } from '../utils/logger.js';
+import { unlinkSync } from 'node:fs';
+/**
+ * Remap event timestamps after trimming.
+ * Each event's timestamp is shifted to account for removed gaps.
+ */
+function remapEvents(events, segments) {
+    return events.map((e) => {
+        const t_s = e.timestamp_ms / 1000;
+        let newT = 0;
+        for (const seg of segments) {
+            if (t_s < seg.start_s) {
+                // Event is before this segment — it's in a trimmed gap, snap to current newT
+                break;
+            }
+            else if (t_s <= seg.end_s) {
+                // Event is within this segment
+                newT += t_s - seg.start_s;
+                break;
+            }
+            else {
+                // Event is after this segment — accumulate the segment duration
+                newT += seg.end_s - seg.start_s;
+            }
+        }
+        return { ...e, timestamp_ms: Math.round(newT * 1000) };
+    });
+}
+export async function composeVideo(options) {
+    let videoDuration;
+    try {
+        videoDuration = await getVideoDuration(options.rawVideoPath);
+    }
+    catch {
+        videoDuration = options.events.length > 0
+            ? options.events[options.events.length - 1].timestamp_ms / 1000 + 2
+            : 30;
+    }
+    // Step 1: Trim idle time
+    const segments = computeActiveSegments(options.events, videoDuration);
+    const trimmedDuration = estimateTrimmedDuration(segments);
+    const savedTime = videoDuration - trimmedDuration;
+    let currentInput = options.rawVideoPath;
+    let trimmedPath;
+    let eventsForEffects = options.events;
+    if (savedTime > 2) {
+        // Worth trimming — do a first pass
+        trimmedPath = join(dirname(options.outputPath), '_trimmed.mp4');
+        const trimFilter = buildTrimFilter(segments);
+        logger.info(`Trimming idle time: ${videoDuration.toFixed(1)}s → ${trimmedDuration.toFixed(1)}s (saving ${savedTime.toFixed(1)}s)`);
+        await runFFmpeg({
+            input: options.rawVideoPath,
+            output: trimmedPath,
+            outputArgs: [
+                '-vf', trimFilter,
+                '-c:v', 'libx264',
+                '-preset', 'fast',
+                '-crf', '18',
+                '-pix_fmt', 'yuv420p',
+            ],
+        });
+        currentInput = trimmedPath;
+        eventsForEffects = remapEvents(options.events, segments);
+    }
+    else {
+        logger.info('No significant idle time to trim.');
+    }
+    // Step 2: Build effect filters using remapped timestamps
+    const filters = [];
+    if (options.zoom) {
+        const keyframes = generateZoomKeyframes(eventsForEffects, options.viewport);
+        const zoomFilter = buildZoomFilterExpr(keyframes, options.viewport);
+        if (zoomFilter) {
+            filters.push(zoomFilter);
+        }
+    }
+    if (options.highlight) {
+        const highlightFilters = buildHighlightFilters(eventsForEffects, options.viewport);
+        filters.push(...highlightFilters);
+    }
+    if (options.cursor) {
+        const cursorFilters = buildCursorFilter(eventsForEffects, options.viewport);
+        filters.push(...cursorFilters);
+    }
+    // Step 3: Apply effects + optional background
+    if (options.background) {
+        // Use filter_complex to composite video onto gradient background
+        const fc = buildBackgroundFilterComplex(filters, options.viewport, options.background);
+        logger.info(`Applying background (${options.background.gradient}) with ${filters.length} effect filters...`);
+        await runFFmpeg({
+            input: currentInput,
+            output: options.outputPath,
+            filterComplex: fc,
+            outputArgs: [
+                '-map', '[out]',
+                '-c:v', 'libx264',
+                '-preset', 'fast',
+                '-crf', '23',
+                '-pix_fmt', 'yuv420p',
+            ],
+        });
+    }
+    else if (filters.length > 0) {
+        const filterChain = filters.join(',');
+        logger.info(`Applying ${filters.length} effect filters...`);
+        await runFFmpeg({
+            input: currentInput,
+            output: options.outputPath,
+            outputArgs: [
+                '-vf', filterChain,
+                '-c:v', 'libx264',
+                '-preset', 'fast',
+                '-crf', '23',
+                '-pix_fmt', 'yuv420p',
+            ],
+        });
+    }
+    else {
+        if (currentInput !== options.outputPath) {
+            if (trimmedPath) {
+                const { renameSync } = await import('node:fs');
+                renameSync(trimmedPath, options.outputPath);
+                return options.outputPath;
+            }
+            await runFFmpeg({
+                input: currentInput,
+                output: options.outputPath,
+                outputArgs: ['-c:v', 'libx264', '-preset', 'fast', '-crf', '23', '-pix_fmt', 'yuv420p'],
+            });
+        }
+        return options.outputPath;
+    }
+    // Clean up intermediate file
+    if (trimmedPath) {
+        try {
+            unlinkSync(trimmedPath);
+        }
+        catch { /* ignore */ }
+    }
+    return options.outputPath;
+}
+//# sourceMappingURL=compose.js.map

package/dist/src/video/compose.js.map

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

package/dist/src/video/cursor.d.ts

@@ -0,0 +1,10 @@
+import type { RecordingEvent, Viewport } from '../recording/types.js';
+interface CursorPosition {
+    time_s: number;
+    x: number;
+    y: number;
+}
+export declare function extractCursorPositions(events: RecordingEvent[]): CursorPosition[];
+export declare function buildCursorFilter(events: RecordingEvent[], _viewport: Viewport): string[];
+export {};
+//# sourceMappingURL=cursor.d.ts.map

package/dist/src/video/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/video/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtE,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAcjF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,QAAQ,GAAG,MAAM,EAAE,CAmBzF"}

package/dist/src/video/cursor.js

@@ -0,0 +1,31 @@
+const CURSOR_RADIUS = 8;
+const CURSOR_COLOR = 'red@0.8';
+export function extractCursorPositions(events) {
+    const positions = [];
+    for (const event of events) {
+        if (event.bounding_box) {
+            positions.push({
+                time_s: event.timestamp_ms / 1000,
+                x: Math.round(event.bounding_box.x + event.bounding_box.width / 2),
+                y: Math.round(event.bounding_box.y + event.bounding_box.height / 2),
+            });
+        }
+    }
+    return positions;
+}
+export function buildCursorFilter(events, _viewport) {
+    const positions = extractCursorPositions(events);
+    if (positions.length === 0)
+        return [];
+    const filters = [];
+    // Draw a circle at each event's bounding box center, visible around the event time
+    for (let i = 0; i < positions.length; i++) {
+        const pos = positions[i];
+        const startT = Math.max(0, pos.time_s - 0.2);
+        const endT = pos.time_s + 0.5;
+        // drawbox approximation of a cursor dot
+        filters.push(`drawbox=x=${pos.x - CURSOR_RADIUS}:y=${pos.y - CURSOR_RADIUS}:w=${CURSOR_RADIUS * 2}:h=${CURSOR_RADIUS * 2}:color=${CURSOR_COLOR}:t=fill:enable='between(t,${startT.toFixed(3)},${endT.toFixed(3)})'`);
+    }
+    return filters;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/src/video/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/video/cursor.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,YAAY,GAAG,SAAS,CAAC;AAQ/B,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC;gBACb,MAAM,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI;gBACjC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC;gBAClE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;aACpE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAwB,EAAE,SAAmB;IAC7E,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,mFAAmF;IACnF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;QAE9B,wCAAwC;QACxC,OAAO,CAAC,IAAI,CACV,aAAa,GAAG,CAAC,CAAC,GAAG,aAAa,MAAM,GAAG,CAAC,CAAC,GAAG,aAAa,MAAM,aAAa,GAAG,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,YAAY,6BAA6B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACvM,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/video/ffmpeg.d.ts

@@ -0,0 +1,10 @@
+export interface FFmpegOptions {
+    input: string;
+    output: string;
+    filterComplex?: string;
+    outputArgs?: string[];
+    onProgress?: (percent: number) => void;
+}
+export declare function runFFmpeg(options: FFmpegOptions): Promise<void>;
+export declare function getVideoDuration(filePath: string): Promise<number>;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/src/video/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../../src/video/ffmpeg.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDrE;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BxE"}