clipwise 0.5.2 → 0.6.1

package/dist/index.d.ts

@@ -176,14 +176,15 @@ declare const EffectsConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         /**
          * Numeric zoom scale (1.0 = no zoom).  Overridden by `intensity` when set.
-         * Default lowered from 1.8 → 1.35 to match "moderate" intensity.
+         * Default: 1.25 to match "light" intensity (industry standard).
          */
         scale: z.ZodDefault<z.ZodNumber>;
         /**
          * Intensity preset — overrides `scale` when set.
          * Calibrated against Loom (light≈1.25x) and Camtasia (moderate≈1.35x).
+         * Default: "light" (1.25x) — matches industry standard (Screen Studio, Loom).
          */
-        intensity: z.ZodOptional<z.ZodEnum<["subtle", "light", "moderate", "strong", "dramatic"]>>;
+        intensity: z.ZodDefault<z.ZodEnum<["subtle", "light", "moderate", "strong", "dramatic"]>>;
         duration: z.ZodDefault<z.ZodNumber>;
         easing: z.ZodDefault<z.ZodEnum<["ease-in-out", "ease-in", "ease-out", "linear"]>>;
         autoZoom: z.ZodDefault<z.ZodObject<{
@@ -207,6 +208,7 @@ declare const EffectsConfigSchema: z.ZodObject<{
         duration: number;
         enabled: boolean;
         scale: number;
+        intensity: "subtle" | "light" | "moderate" | "strong" | "dramatic";
         easing: "ease-in-out" | "ease-in" | "ease-out" | "linear";
         autoZoom: {
             followCursor: boolean;
@@ -214,7 +216,6 @@ declare const EffectsConfigSchema: z.ZodObject<{
             transitionDuration: number;
             padding: number;
         };
-        intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
     }, {
         duration?: number | undefined;
         enabled?: boolean | undefined;
@@ -387,6 +388,7 @@ declare const EffectsConfigSchema: z.ZodObject<{
         duration: number;
         enabled: boolean;
         scale: number;
+        intensity: "subtle" | "light" | "moderate" | "strong" | "dramatic";
         easing: "ease-in-out" | "ease-in" | "ease-out" | "linear";
         autoZoom: {
             followCursor: boolean;
@@ -394,7 +396,6 @@ declare const EffectsConfigSchema: z.ZodObject<{
             transitionDuration: number;
             padding: number;
         };
-        intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
     };
     cursor: {
         enabled: boolean;
@@ -521,6 +522,7 @@ declare const OutputConfigSchema: z.ZodObject<{
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     fps: z.ZodDefault<z.ZodNumber>;
+    /** @deprecated Use `preset` instead. Will be removed in v0.7. */
     quality: z.ZodDefault<z.ZodNumber>;
     preset: z.ZodOptional<z.ZodEnum<["social", "balanced", "archive"]>>;
     outputDir: z.ZodDefault<z.ZodString>;
@@ -545,155 +547,489 @@ declare const OutputConfigSchema: z.ZodObject<{
     filename?: string | undefined;
 }>;
 type OutputConfig = z.infer<typeof OutputConfigSchema>;
-declare const StepSchema: z.ZodObject<{
-    name: z.ZodOptional<z.ZodString>;
-    actions: z.ZodArray<z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
-        action: z.ZodLiteral<"navigate">;
-        url: z.ZodString;
-        waitUntil: z.ZodDefault<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
-    }, "strip", z.ZodTypeAny, {
-        action: "navigate";
-        url: string;
-        waitUntil: "load" | "domcontentloaded" | "networkidle";
-    }, {
-        action: "navigate";
-        url: string;
-        waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"click">;
-        selector: z.ZodString;
-        delay: z.ZodOptional<z.ZodNumber>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        action: "click";
-        selector: string;
-        delay?: number | undefined;
-        timeout?: number | undefined;
-    }, {
-        action: "click";
-        selector: string;
-        delay?: number | undefined;
-        timeout?: number | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"type">;
-        selector: z.ZodString;
-        text: z.ZodString;
-        delay: z.ZodDefault<z.ZodNumber>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        action: "type";
-        selector: string;
-        delay: number;
-        text: string;
-        timeout?: number | undefined;
-    }, {
-        action: "type";
-        selector: string;
-        text: string;
-        delay?: number | undefined;
-        timeout?: number | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"scroll">;
-        selector: z.ZodOptional<z.ZodString>;
-        y: z.ZodDefault<z.ZodNumber>;
-        x: z.ZodDefault<z.ZodNumber>;
-        smooth: z.ZodDefault<z.ZodBoolean>;
-        timeout: z.ZodOptional<z.ZodNumber>;
+/**
+ * Per-step effects override — allows each step to customize effects
+ * independently from the global effects config.  Only the fields
+ * specified here are merged; everything else falls back to global.
+ */
+declare const StepEffectsOverrideSchema: z.ZodOptional<z.ZodObject<{
+    zoom: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        scale: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        intensity: z.ZodOptional<z.ZodDefault<z.ZodEnum<["subtle", "light", "moderate", "strong", "dramatic"]>>>;
+        duration: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        easing: z.ZodOptional<z.ZodDefault<z.ZodEnum<["ease-in-out", "ease-in", "ease-out", "linear"]>>>;
+        autoZoom: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+            followCursor: z.ZodDefault<z.ZodBoolean>;
+            /** @deprecated Use `intensity` on the parent zoom config instead. */
+            maxScale: z.ZodDefault<z.ZodNumber>;
+            transitionDuration: z.ZodDefault<z.ZodNumber>;
+            padding: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            followCursor: boolean;
+            maxScale: number;
+            transitionDuration: number;
+            padding: number;
+        }, {
+            followCursor?: boolean | undefined;
+            maxScale?: number | undefined;
+            transitionDuration?: number | undefined;
+            padding?: number | undefined;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
-        action: "scroll";
-        y: number;
-        x: number;
-        smooth: boolean;
-        selector?: string | undefined;
-        timeout?: number | undefined;
+        duration?: number | undefined;
+        enabled?: boolean | undefined;
+        scale?: number | undefined;
+        intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+        easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+        autoZoom?: {
+            followCursor: boolean;
+            maxScale: number;
+            transitionDuration: number;
+            padding: number;
+        } | undefined;
     }, {
-        action: "scroll";
-        selector?: string | undefined;
-        timeout?: number | undefined;
-        y?: number | undefined;
-        x?: number | undefined;
-        smooth?: boolean | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"wait">;
-        duration: z.ZodNumber;
+        duration?: number | undefined;
+        enabled?: boolean | undefined;
+        scale?: number | undefined;
+        intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+        easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+        autoZoom?: {
+            followCursor?: boolean | undefined;
+            maxScale?: number | undefined;
+            transitionDuration?: number | undefined;
+            padding?: number | undefined;
+        } | undefined;
+    }>>;
+    cursor: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        size: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        color: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        speed: z.ZodOptional<z.ZodDefault<z.ZodEnum<["fast", "normal", "slow"]>>>;
+        smoothing: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        clickEffect: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        clickColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        clickRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        trail: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        trailLength: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        trailColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        highlight: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        highlightRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        highlightColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        action: "wait";
-        duration: number;
+        enabled?: boolean | undefined;
+        size?: number | undefined;
+        color?: string | undefined;
+        speed?: "fast" | "normal" | "slow" | undefined;
+        smoothing?: boolean | undefined;
+        clickEffect?: boolean | undefined;
+        clickColor?: string | undefined;
+        clickRadius?: number | undefined;
+        trail?: boolean | undefined;
+        trailLength?: number | undefined;
+        trailColor?: string | undefined;
+        highlight?: boolean | undefined;
+        highlightRadius?: number | undefined;
+        highlightColor?: string | undefined;
     }, {
-        action: "wait";
-        duration: number;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"hover">;
-        selector: z.ZodString;
-        timeout: z.ZodOptional<z.ZodNumber>;
+        enabled?: boolean | undefined;
+        size?: number | undefined;
+        color?: string | undefined;
+        speed?: "fast" | "normal" | "slow" | undefined;
+        smoothing?: boolean | undefined;
+        clickEffect?: boolean | undefined;
+        clickColor?: string | undefined;
+        clickRadius?: number | undefined;
+        trail?: boolean | undefined;
+        trailLength?: number | undefined;
+        trailColor?: string | undefined;
+        highlight?: boolean | undefined;
+        highlightRadius?: number | undefined;
+        highlightColor?: string | undefined;
+    }>>;
+    background: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodDefault<z.ZodEnum<["gradient", "solid", "image"]>>>;
+        value: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        padding: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        borderRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        shadow: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
-        action: "hover";
-        selector: string;
-        timeout?: number | undefined;
+        value?: string | undefined;
+        type?: "gradient" | "solid" | "image" | undefined;
+        padding?: number | undefined;
+        borderRadius?: number | undefined;
+        shadow?: boolean | undefined;
     }, {
-        action: "hover";
-        selector: string;
-        timeout?: number | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"screenshot">;
-        name: z.ZodOptional<z.ZodString>;
-        fullPage: z.ZodDefault<z.ZodBoolean>;
+        value?: string | undefined;
+        type?: "gradient" | "solid" | "image" | undefined;
+        padding?: number | undefined;
+        borderRadius?: number | undefined;
+        shadow?: boolean | undefined;
+    }>>;
+    deviceFrame: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        type: z.ZodOptional<z.ZodDefault<z.ZodEnum<["browser", "macbook", "iphone", "ipad", "android", "none"]>>>;
+        darkMode: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
-        action: "screenshot";
-        fullPage: boolean;
-        name?: string | undefined;
+        type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+        enabled?: boolean | undefined;
+        darkMode?: boolean | undefined;
     }, {
-        action: "screenshot";
-        name?: string | undefined;
-        fullPage?: boolean | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"waitForSelector">;
-        selector: z.ZodString;
-        state: z.ZodDefault<z.ZodEnum<["visible", "attached", "hidden"]>>;
-        timeout: z.ZodDefault<z.ZodNumber>;
+        type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+        enabled?: boolean | undefined;
+        darkMode?: boolean | undefined;
+    }>>;
+    speedRamp: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        idleSpeed: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        actionSpeed: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        transitionFrames: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     }, "strip", z.ZodTypeAny, {
-        action: "waitForSelector";
-        selector: string;
-        timeout: number;
-        state: "visible" | "attached" | "hidden";
+        enabled?: boolean | undefined;
+        idleSpeed?: number | undefined;
+        actionSpeed?: number | undefined;
+        transitionFrames?: number | undefined;
     }, {
-        action: "waitForSelector";
-        selector: string;
-        timeout?: number | undefined;
-        state?: "visible" | "attached" | "hidden" | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"waitForNavigation">;
-        waitUntil: z.ZodDefault<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
-        timeout: z.ZodDefault<z.ZodNumber>;
+        enabled?: boolean | undefined;
+        idleSpeed?: number | undefined;
+        actionSpeed?: number | undefined;
+        transitionFrames?: number | undefined;
+    }>>;
+    keystroke: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        showTyping: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        position: z.ZodOptional<z.ZodDefault<z.ZodEnum<["bottom-center", "bottom-left", "bottom-right"]>>>;
+        fontSize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        backgroundColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        textColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        padding: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        fadeAfter: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     }, "strip", z.ZodTypeAny, {
-        action: "waitForNavigation";
-        waitUntil: "load" | "domcontentloaded" | "networkidle";
-        timeout: number;
+        padding?: number | undefined;
+        enabled?: boolean | undefined;
+        showTyping?: boolean | undefined;
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        fontSize?: number | undefined;
+        backgroundColor?: string | undefined;
+        textColor?: string | undefined;
+        fadeAfter?: number | undefined;
     }, {
-        action: "waitForNavigation";
-        waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
-        timeout?: number | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"waitForURL">;
-        url: z.ZodString;
-        timeout: z.ZodDefault<z.ZodNumber>;
+        padding?: number | undefined;
+        enabled?: boolean | undefined;
+        showTyping?: boolean | undefined;
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        fontSize?: number | undefined;
+        backgroundColor?: string | undefined;
+        textColor?: string | undefined;
+        fadeAfter?: number | undefined;
+    }>>;
+    watermark: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        text: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        position: z.ZodOptional<z.ZodDefault<z.ZodEnum<["top-left", "top-right", "bottom-left", "bottom-right"]>>>;
+        opacity: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        fontSize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        color: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        action: "waitForURL";
-        url: string;
-        timeout: number;
+        text?: string | undefined;
+        enabled?: boolean | undefined;
+        color?: string | undefined;
+        position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+        fontSize?: number | undefined;
+        opacity?: number | undefined;
     }, {
-        action: "waitForURL";
-        url: string;
-        timeout?: number | undefined;
-    }>, z.ZodObject<{
-        action: z.ZodLiteral<"waitForFunction">;
-        expression: z.ZodString;
-        polling: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"raf">, z.ZodNumber]>>;
-        timeout: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        action: "waitForFunction";
-        timeout: number;
-        expression: string;
+        text?: string | undefined;
+        enabled?: boolean | undefined;
+        color?: string | undefined;
+        position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+        fontSize?: number | undefined;
+        opacity?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    zoom?: {
+        duration?: number | undefined;
+        enabled?: boolean | undefined;
+        scale?: number | undefined;
+        intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+        easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+        autoZoom?: {
+            followCursor: boolean;
+            maxScale: number;
+            transitionDuration: number;
+            padding: number;
+        } | undefined;
+    } | undefined;
+    cursor?: {
+        enabled?: boolean | undefined;
+        size?: number | undefined;
+        color?: string | undefined;
+        speed?: "fast" | "normal" | "slow" | undefined;
+        smoothing?: boolean | undefined;
+        clickEffect?: boolean | undefined;
+        clickColor?: string | undefined;
+        clickRadius?: number | undefined;
+        trail?: boolean | undefined;
+        trailLength?: number | undefined;
+        trailColor?: string | undefined;
+        highlight?: boolean | undefined;
+        highlightRadius?: number | undefined;
+        highlightColor?: string | undefined;
+    } | undefined;
+    background?: {
+        value?: string | undefined;
+        type?: "gradient" | "solid" | "image" | undefined;
+        padding?: number | undefined;
+        borderRadius?: number | undefined;
+        shadow?: boolean | undefined;
+    } | undefined;
+    deviceFrame?: {
+        type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+        enabled?: boolean | undefined;
+        darkMode?: boolean | undefined;
+    } | undefined;
+    speedRamp?: {
+        enabled?: boolean | undefined;
+        idleSpeed?: number | undefined;
+        actionSpeed?: number | undefined;
+        transitionFrames?: number | undefined;
+    } | undefined;
+    keystroke?: {
+        padding?: number | undefined;
+        enabled?: boolean | undefined;
+        showTyping?: boolean | undefined;
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        fontSize?: number | undefined;
+        backgroundColor?: string | undefined;
+        textColor?: string | undefined;
+        fadeAfter?: number | undefined;
+    } | undefined;
+    watermark?: {
+        text?: string | undefined;
+        enabled?: boolean | undefined;
+        color?: string | undefined;
+        position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+        fontSize?: number | undefined;
+        opacity?: number | undefined;
+    } | undefined;
+}, {
+    zoom?: {
+        duration?: number | undefined;
+        enabled?: boolean | undefined;
+        scale?: number | undefined;
+        intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+        easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+        autoZoom?: {
+            followCursor?: boolean | undefined;
+            maxScale?: number | undefined;
+            transitionDuration?: number | undefined;
+            padding?: number | undefined;
+        } | undefined;
+    } | undefined;
+    cursor?: {
+        enabled?: boolean | undefined;
+        size?: number | undefined;
+        color?: string | undefined;
+        speed?: "fast" | "normal" | "slow" | undefined;
+        smoothing?: boolean | undefined;
+        clickEffect?: boolean | undefined;
+        clickColor?: string | undefined;
+        clickRadius?: number | undefined;
+        trail?: boolean | undefined;
+        trailLength?: number | undefined;
+        trailColor?: string | undefined;
+        highlight?: boolean | undefined;
+        highlightRadius?: number | undefined;
+        highlightColor?: string | undefined;
+    } | undefined;
+    background?: {
+        value?: string | undefined;
+        type?: "gradient" | "solid" | "image" | undefined;
+        padding?: number | undefined;
+        borderRadius?: number | undefined;
+        shadow?: boolean | undefined;
+    } | undefined;
+    deviceFrame?: {
+        type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+        enabled?: boolean | undefined;
+        darkMode?: boolean | undefined;
+    } | undefined;
+    speedRamp?: {
+        enabled?: boolean | undefined;
+        idleSpeed?: number | undefined;
+        actionSpeed?: number | undefined;
+        transitionFrames?: number | undefined;
+    } | undefined;
+    keystroke?: {
+        padding?: number | undefined;
+        enabled?: boolean | undefined;
+        showTyping?: boolean | undefined;
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        fontSize?: number | undefined;
+        backgroundColor?: string | undefined;
+        textColor?: string | undefined;
+        fadeAfter?: number | undefined;
+    } | undefined;
+    watermark?: {
+        text?: string | undefined;
+        enabled?: boolean | undefined;
+        color?: string | undefined;
+        position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+        fontSize?: number | undefined;
+        opacity?: number | undefined;
+    } | undefined;
+}>>;
+type StepEffectsOverride = z.infer<typeof StepEffectsOverrideSchema>;
+declare const TransitionTypeSchema: z.ZodEnum<["none", "fade", "slide-left", "slide-up", "blur"]>;
+type TransitionType = z.infer<typeof TransitionTypeSchema>;
+declare const StepSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    actions: z.ZodArray<z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+        action: z.ZodLiteral<"navigate">;
+        url: z.ZodString;
+        waitUntil: z.ZodDefault<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
+    }, "strip", z.ZodTypeAny, {
+        action: "navigate";
+        url: string;
+        waitUntil: "load" | "domcontentloaded" | "networkidle";
+    }, {
+        action: "navigate";
+        url: string;
+        waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"click">;
+        selector: z.ZodString;
+        delay: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "click";
+        selector: string;
+        delay?: number | undefined;
+        timeout?: number | undefined;
+    }, {
+        action: "click";
+        selector: string;
+        delay?: number | undefined;
+        timeout?: number | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"type">;
+        selector: z.ZodString;
+        text: z.ZodString;
+        delay: z.ZodDefault<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "type";
+        selector: string;
+        delay: number;
+        text: string;
+        timeout?: number | undefined;
+    }, {
+        action: "type";
+        selector: string;
+        text: string;
+        delay?: number | undefined;
+        timeout?: number | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"scroll">;
+        selector: z.ZodOptional<z.ZodString>;
+        y: z.ZodDefault<z.ZodNumber>;
+        x: z.ZodDefault<z.ZodNumber>;
+        smooth: z.ZodDefault<z.ZodBoolean>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "scroll";
+        y: number;
+        x: number;
+        smooth: boolean;
+        selector?: string | undefined;
+        timeout?: number | undefined;
+    }, {
+        action: "scroll";
+        selector?: string | undefined;
+        timeout?: number | undefined;
+        y?: number | undefined;
+        x?: number | undefined;
+        smooth?: boolean | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"wait">;
+        duration: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        action: "wait";
+        duration: number;
+    }, {
+        action: "wait";
+        duration: number;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"hover">;
+        selector: z.ZodString;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "hover";
+        selector: string;
+        timeout?: number | undefined;
+    }, {
+        action: "hover";
+        selector: string;
+        timeout?: number | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"screenshot">;
+        name: z.ZodOptional<z.ZodString>;
+        fullPage: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        action: "screenshot";
+        fullPage: boolean;
+        name?: string | undefined;
+    }, {
+        action: "screenshot";
+        name?: string | undefined;
+        fullPage?: boolean | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"waitForSelector">;
+        selector: z.ZodString;
+        state: z.ZodDefault<z.ZodEnum<["visible", "attached", "hidden"]>>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "waitForSelector";
+        selector: string;
+        timeout: number;
+        state: "visible" | "attached" | "hidden";
+    }, {
+        action: "waitForSelector";
+        selector: string;
+        timeout?: number | undefined;
+        state?: "visible" | "attached" | "hidden" | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"waitForNavigation">;
+        waitUntil: z.ZodDefault<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "waitForNavigation";
+        waitUntil: "load" | "domcontentloaded" | "networkidle";
+        timeout: number;
+    }, {
+        action: "waitForNavigation";
+        waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+        timeout?: number | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"waitForURL">;
+        url: z.ZodString;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "waitForURL";
+        url: string;
+        timeout: number;
+    }, {
+        action: "waitForURL";
+        url: string;
+        timeout?: number | undefined;
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"waitForFunction">;
+        expression: z.ZodString;
+        polling: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"raf">, z.ZodNumber]>>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "waitForFunction";
+        timeout: number;
+        expression: string;
         polling: number | "raf";
     }, {
         action: "waitForFunction";
@@ -706,19 +1042,346 @@ declare const StepSchema: z.ZodObject<{
         status: z.ZodOptional<z.ZodNumber>;
         timeout: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        action: "waitForResponse";
-        url: string;
-        timeout: number;
-        status?: number | undefined;
+        action: "waitForResponse";
+        url: string;
+        timeout: number;
+        status?: number | undefined;
+    }, {
+        action: "waitForResponse";
+        url: string;
+        status?: number | undefined;
+        timeout?: number | undefined;
+    }>]>, "many">;
+    captureDelay: z.ZodDefault<z.ZodNumber>;
+    holdDuration: z.ZodDefault<z.ZodNumber>;
+    transition: z.ZodDefault<z.ZodEnum<["none", "fade", "slide-left", "slide-up", "blur"]>>;
+    /** Per-step effects override — merges with global effects config. */
+    effects: z.ZodOptional<z.ZodObject<{
+        zoom: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            scale: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            intensity: z.ZodOptional<z.ZodDefault<z.ZodEnum<["subtle", "light", "moderate", "strong", "dramatic"]>>>;
+            duration: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            easing: z.ZodOptional<z.ZodDefault<z.ZodEnum<["ease-in-out", "ease-in", "ease-out", "linear"]>>>;
+            autoZoom: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+                followCursor: z.ZodDefault<z.ZodBoolean>;
+                /** @deprecated Use `intensity` on the parent zoom config instead. */
+                maxScale: z.ZodDefault<z.ZodNumber>;
+                transitionDuration: z.ZodDefault<z.ZodNumber>;
+                padding: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                followCursor: boolean;
+                maxScale: number;
+                transitionDuration: number;
+                padding: number;
+            }, {
+                followCursor?: boolean | undefined;
+                maxScale?: number | undefined;
+                transitionDuration?: number | undefined;
+                padding?: number | undefined;
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            duration?: number | undefined;
+            enabled?: boolean | undefined;
+            scale?: number | undefined;
+            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+            easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+            autoZoom?: {
+                followCursor: boolean;
+                maxScale: number;
+                transitionDuration: number;
+                padding: number;
+            } | undefined;
+        }, {
+            duration?: number | undefined;
+            enabled?: boolean | undefined;
+            scale?: number | undefined;
+            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+            easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+            autoZoom?: {
+                followCursor?: boolean | undefined;
+                maxScale?: number | undefined;
+                transitionDuration?: number | undefined;
+                padding?: number | undefined;
+            } | undefined;
+        }>>;
+        cursor: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            size: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            color: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            speed: z.ZodOptional<z.ZodDefault<z.ZodEnum<["fast", "normal", "slow"]>>>;
+            smoothing: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            clickEffect: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            clickColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            clickRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            trail: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            trailLength: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            trailColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            highlight: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            highlightRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            highlightColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            enabled?: boolean | undefined;
+            size?: number | undefined;
+            color?: string | undefined;
+            speed?: "fast" | "normal" | "slow" | undefined;
+            smoothing?: boolean | undefined;
+            clickEffect?: boolean | undefined;
+            clickColor?: string | undefined;
+            clickRadius?: number | undefined;
+            trail?: boolean | undefined;
+            trailLength?: number | undefined;
+            trailColor?: string | undefined;
+            highlight?: boolean | undefined;
+            highlightRadius?: number | undefined;
+            highlightColor?: string | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            size?: number | undefined;
+            color?: string | undefined;
+            speed?: "fast" | "normal" | "slow" | undefined;
+            smoothing?: boolean | undefined;
+            clickEffect?: boolean | undefined;
+            clickColor?: string | undefined;
+            clickRadius?: number | undefined;
+            trail?: boolean | undefined;
+            trailLength?: number | undefined;
+            trailColor?: string | undefined;
+            highlight?: boolean | undefined;
+            highlightRadius?: number | undefined;
+            highlightColor?: string | undefined;
+        }>>;
+        background: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodDefault<z.ZodEnum<["gradient", "solid", "image"]>>>;
+            value: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            padding: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            borderRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            shadow: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            value?: string | undefined;
+            type?: "gradient" | "solid" | "image" | undefined;
+            padding?: number | undefined;
+            borderRadius?: number | undefined;
+            shadow?: boolean | undefined;
+        }, {
+            value?: string | undefined;
+            type?: "gradient" | "solid" | "image" | undefined;
+            padding?: number | undefined;
+            borderRadius?: number | undefined;
+            shadow?: boolean | undefined;
+        }>>;
+        deviceFrame: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            type: z.ZodOptional<z.ZodDefault<z.ZodEnum<["browser", "macbook", "iphone", "ipad", "android", "none"]>>>;
+            darkMode: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+            enabled?: boolean | undefined;
+            darkMode?: boolean | undefined;
+        }, {
+            type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+            enabled?: boolean | undefined;
+            darkMode?: boolean | undefined;
+        }>>;
+        speedRamp: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            idleSpeed: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            actionSpeed: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            transitionFrames: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            enabled?: boolean | undefined;
+            idleSpeed?: number | undefined;
+            actionSpeed?: number | undefined;
+            transitionFrames?: number | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            idleSpeed?: number | undefined;
+            actionSpeed?: number | undefined;
+            transitionFrames?: number | undefined;
+        }>>;
+        keystroke: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            showTyping: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            position: z.ZodOptional<z.ZodDefault<z.ZodEnum<["bottom-center", "bottom-left", "bottom-right"]>>>;
+            fontSize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            backgroundColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            textColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            padding: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            fadeAfter: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            padding?: number | undefined;
+            enabled?: boolean | undefined;
+            showTyping?: boolean | undefined;
+            position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+            fontSize?: number | undefined;
+            backgroundColor?: string | undefined;
+            textColor?: string | undefined;
+            fadeAfter?: number | undefined;
+        }, {
+            padding?: number | undefined;
+            enabled?: boolean | undefined;
+            showTyping?: boolean | undefined;
+            position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+            fontSize?: number | undefined;
+            backgroundColor?: string | undefined;
+            textColor?: string | undefined;
+            fadeAfter?: number | undefined;
+        }>>;
+        watermark: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            text: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            position: z.ZodOptional<z.ZodDefault<z.ZodEnum<["top-left", "top-right", "bottom-left", "bottom-right"]>>>;
+            opacity: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            fontSize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            color: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            text?: string | undefined;
+            enabled?: boolean | undefined;
+            color?: string | undefined;
+            position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+            fontSize?: number | undefined;
+            opacity?: number | undefined;
+        }, {
+            text?: string | undefined;
+            enabled?: boolean | undefined;
+            color?: string | undefined;
+            position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+            fontSize?: number | undefined;
+            opacity?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        zoom?: {
+            duration?: number | undefined;
+            enabled?: boolean | undefined;
+            scale?: number | undefined;
+            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+            easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+            autoZoom?: {
+                followCursor: boolean;
+                maxScale: number;
+                transitionDuration: number;
+                padding: number;
+            } | undefined;
+        } | undefined;
+        cursor?: {
+            enabled?: boolean | undefined;
+            size?: number | undefined;
+            color?: string | undefined;
+            speed?: "fast" | "normal" | "slow" | undefined;
+            smoothing?: boolean | undefined;
+            clickEffect?: boolean | undefined;
+            clickColor?: string | undefined;
+            clickRadius?: number | undefined;
+            trail?: boolean | undefined;
+            trailLength?: number | undefined;
+            trailColor?: string | undefined;
+            highlight?: boolean | undefined;
+            highlightRadius?: number | undefined;
+            highlightColor?: string | undefined;
+        } | undefined;
+        background?: {
+            value?: string | undefined;
+            type?: "gradient" | "solid" | "image" | undefined;
+            padding?: number | undefined;
+            borderRadius?: number | undefined;
+            shadow?: boolean | undefined;
+        } | undefined;
+        deviceFrame?: {
+            type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+            enabled?: boolean | undefined;
+            darkMode?: boolean | undefined;
+        } | undefined;
+        speedRamp?: {
+            enabled?: boolean | undefined;
+            idleSpeed?: number | undefined;
+            actionSpeed?: number | undefined;
+            transitionFrames?: number | undefined;
+        } | undefined;
+        keystroke?: {
+            padding?: number | undefined;
+            enabled?: boolean | undefined;
+            showTyping?: boolean | undefined;
+            position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+            fontSize?: number | undefined;
+            backgroundColor?: string | undefined;
+            textColor?: string | undefined;
+            fadeAfter?: number | undefined;
+        } | undefined;
+        watermark?: {
+            text?: string | undefined;
+            enabled?: boolean | undefined;
+            color?: string | undefined;
+            position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+            fontSize?: number | undefined;
+            opacity?: number | undefined;
+        } | undefined;
     }, {
-        action: "waitForResponse";
-        url: string;
-        status?: number | undefined;
-        timeout?: number | undefined;
-    }>]>, "many">;
-    captureDelay: z.ZodDefault<z.ZodNumber>;
-    holdDuration: z.ZodDefault<z.ZodNumber>;
-    transition: z.ZodDefault<z.ZodEnum<["fade", "none"]>>;
+        zoom?: {
+            duration?: number | undefined;
+            enabled?: boolean | undefined;
+            scale?: number | undefined;
+            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+            easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+            autoZoom?: {
+                followCursor?: boolean | undefined;
+                maxScale?: number | undefined;
+                transitionDuration?: number | undefined;
+                padding?: number | undefined;
+            } | undefined;
+        } | undefined;
+        cursor?: {
+            enabled?: boolean | undefined;
+            size?: number | undefined;
+            color?: string | undefined;
+            speed?: "fast" | "normal" | "slow" | undefined;
+            smoothing?: boolean | undefined;
+            clickEffect?: boolean | undefined;
+            clickColor?: string | undefined;
+            clickRadius?: number | undefined;
+            trail?: boolean | undefined;
+            trailLength?: number | undefined;
+            trailColor?: string | undefined;
+            highlight?: boolean | undefined;
+            highlightRadius?: number | undefined;
+            highlightColor?: string | undefined;
+        } | undefined;
+        background?: {
+            value?: string | undefined;
+            type?: "gradient" | "solid" | "image" | undefined;
+            padding?: number | undefined;
+            borderRadius?: number | undefined;
+            shadow?: boolean | undefined;
+        } | undefined;
+        deviceFrame?: {
+            type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+            enabled?: boolean | undefined;
+            darkMode?: boolean | undefined;
+        } | undefined;
+        speedRamp?: {
+            enabled?: boolean | undefined;
+            idleSpeed?: number | undefined;
+            actionSpeed?: number | undefined;
+            transitionFrames?: number | undefined;
+        } | undefined;
+        keystroke?: {
+            padding?: number | undefined;
+            enabled?: boolean | undefined;
+            showTyping?: boolean | undefined;
+            position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+            fontSize?: number | undefined;
+            backgroundColor?: string | undefined;
+            textColor?: string | undefined;
+            fadeAfter?: number | undefined;
+        } | undefined;
+        watermark?: {
+            text?: string | undefined;
+            enabled?: boolean | undefined;
+            color?: string | undefined;
+            position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+            fontSize?: number | undefined;
+            opacity?: number | undefined;
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     actions: ({
         action: "navigate";
@@ -779,8 +1442,75 @@ declare const StepSchema: z.ZodObject<{
     })[];
     captureDelay: number;
     holdDuration: number;
-    transition: "none" | "fade";
+    transition: "none" | "fade" | "slide-left" | "slide-up" | "blur";
     name?: string | undefined;
+    effects?: {
+        zoom?: {
+            duration?: number | undefined;
+            enabled?: boolean | undefined;
+            scale?: number | undefined;
+            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+            easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+            autoZoom?: {
+                followCursor: boolean;
+                maxScale: number;
+                transitionDuration: number;
+                padding: number;
+            } | undefined;
+        } | undefined;
+        cursor?: {
+            enabled?: boolean | undefined;
+            size?: number | undefined;
+            color?: string | undefined;
+            speed?: "fast" | "normal" | "slow" | undefined;
+            smoothing?: boolean | undefined;
+            clickEffect?: boolean | undefined;
+            clickColor?: string | undefined;
+            clickRadius?: number | undefined;
+            trail?: boolean | undefined;
+            trailLength?: number | undefined;
+            trailColor?: string | undefined;
+            highlight?: boolean | undefined;
+            highlightRadius?: number | undefined;
+            highlightColor?: string | undefined;
+        } | undefined;
+        background?: {
+            value?: string | undefined;
+            type?: "gradient" | "solid" | "image" | undefined;
+            padding?: number | undefined;
+            borderRadius?: number | undefined;
+            shadow?: boolean | undefined;
+        } | undefined;
+        deviceFrame?: {
+            type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+            enabled?: boolean | undefined;
+            darkMode?: boolean | undefined;
+        } | undefined;
+        speedRamp?: {
+            enabled?: boolean | undefined;
+            idleSpeed?: number | undefined;
+            actionSpeed?: number | undefined;
+            transitionFrames?: number | undefined;
+        } | undefined;
+        keystroke?: {
+            padding?: number | undefined;
+            enabled?: boolean | undefined;
+            showTyping?: boolean | undefined;
+            position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+            fontSize?: number | undefined;
+            backgroundColor?: string | undefined;
+            textColor?: string | undefined;
+            fadeAfter?: number | undefined;
+        } | undefined;
+        watermark?: {
+            text?: string | undefined;
+            enabled?: boolean | undefined;
+            color?: string | undefined;
+            position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+            fontSize?: number | undefined;
+            opacity?: number | undefined;
+        } | undefined;
+    } | undefined;
 }, {
     actions: ({
         action: "navigate";
@@ -842,9 +1572,100 @@ declare const StepSchema: z.ZodObject<{
     name?: string | undefined;
     captureDelay?: number | undefined;
     holdDuration?: number | undefined;
-    transition?: "none" | "fade" | undefined;
+    transition?: "none" | "fade" | "slide-left" | "slide-up" | "blur" | undefined;
+    effects?: {
+        zoom?: {
+            duration?: number | undefined;
+            enabled?: boolean | undefined;
+            scale?: number | undefined;
+            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+            easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+            autoZoom?: {
+                followCursor?: boolean | undefined;
+                maxScale?: number | undefined;
+                transitionDuration?: number | undefined;
+                padding?: number | undefined;
+            } | undefined;
+        } | undefined;
+        cursor?: {
+            enabled?: boolean | undefined;
+            size?: number | undefined;
+            color?: string | undefined;
+            speed?: "fast" | "normal" | "slow" | undefined;
+            smoothing?: boolean | undefined;
+            clickEffect?: boolean | undefined;
+            clickColor?: string | undefined;
+            clickRadius?: number | undefined;
+            trail?: boolean | undefined;
+            trailLength?: number | undefined;
+            trailColor?: string | undefined;
+            highlight?: boolean | undefined;
+            highlightRadius?: number | undefined;
+            highlightColor?: string | undefined;
+        } | undefined;
+        background?: {
+            value?: string | undefined;
+            type?: "gradient" | "solid" | "image" | undefined;
+            padding?: number | undefined;
+            borderRadius?: number | undefined;
+            shadow?: boolean | undefined;
+        } | undefined;
+        deviceFrame?: {
+            type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+            enabled?: boolean | undefined;
+            darkMode?: boolean | undefined;
+        } | undefined;
+        speedRamp?: {
+            enabled?: boolean | undefined;
+            idleSpeed?: number | undefined;
+            actionSpeed?: number | undefined;
+            transitionFrames?: number | undefined;
+        } | undefined;
+        keystroke?: {
+            padding?: number | undefined;
+            enabled?: boolean | undefined;
+            showTyping?: boolean | undefined;
+            position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+            fontSize?: number | undefined;
+            backgroundColor?: string | undefined;
+            textColor?: string | undefined;
+            fadeAfter?: number | undefined;
+        } | undefined;
+        watermark?: {
+            text?: string | undefined;
+            enabled?: boolean | undefined;
+            color?: string | undefined;
+            position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+            fontSize?: number | undefined;
+            opacity?: number | undefined;
+        } | undefined;
+    } | undefined;
 }>;
 type Step = z.infer<typeof StepSchema>;
+/**
+ * Audio narration configuration — mux an audio file into the MP4 output.
+ */
+declare const AudioConfigSchema: z.ZodObject<{
+    /** Path to the audio file (MP3, WAV, AAC, etc.). */
+    file: z.ZodString;
+    /** Volume level (0.0 = silent, 1.0 = full). */
+    volume: z.ZodDefault<z.ZodNumber>;
+    /** Fade-in duration in milliseconds. */
+    fadeIn: z.ZodDefault<z.ZodNumber>;
+    /** Fade-out duration in milliseconds. */
+    fadeOut: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    volume: number;
+    fadeIn: number;
+    fadeOut: number;
+}, {
+    file: string;
+    volume?: number | undefined;
+    fadeIn?: number | undefined;
+    fadeOut?: number | undefined;
+}>;
+type AudioConfig = z.infer<typeof AudioConfigSchema>;
 declare const ScenarioSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -863,14 +1684,15 @@ declare const ScenarioSchema: z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             /**
              * Numeric zoom scale (1.0 = no zoom).  Overridden by `intensity` when set.
-             * Default lowered from 1.8 → 1.35 to match "moderate" intensity.
+             * Default: 1.25 to match "light" intensity (industry standard).
              */
             scale: z.ZodDefault<z.ZodNumber>;
             /**
              * Intensity preset — overrides `scale` when set.
              * Calibrated against Loom (light≈1.25x) and Camtasia (moderate≈1.35x).
+             * Default: "light" (1.25x) — matches industry standard (Screen Studio, Loom).
              */
-            intensity: z.ZodOptional<z.ZodEnum<["subtle", "light", "moderate", "strong", "dramatic"]>>;
+            intensity: z.ZodDefault<z.ZodEnum<["subtle", "light", "moderate", "strong", "dramatic"]>>;
             duration: z.ZodDefault<z.ZodNumber>;
             easing: z.ZodDefault<z.ZodEnum<["ease-in-out", "ease-in", "ease-out", "linear"]>>;
             autoZoom: z.ZodDefault<z.ZodObject<{
@@ -894,6 +1716,7 @@ declare const ScenarioSchema: z.ZodObject<{
             duration: number;
             enabled: boolean;
             scale: number;
+            intensity: "subtle" | "light" | "moderate" | "strong" | "dramatic";
             easing: "ease-in-out" | "ease-in" | "ease-out" | "linear";
             autoZoom: {
                 followCursor: boolean;
@@ -901,7 +1724,6 @@ declare const ScenarioSchema: z.ZodObject<{
                 transitionDuration: number;
                 padding: number;
             };
-            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
         }, {
             duration?: number | undefined;
             enabled?: boolean | undefined;
@@ -1074,6 +1896,7 @@ declare const ScenarioSchema: z.ZodObject<{
             duration: number;
             enabled: boolean;
             scale: number;
+            intensity: "subtle" | "light" | "moderate" | "strong" | "dramatic";
             easing: "ease-in-out" | "ease-in" | "ease-out" | "linear";
             autoZoom: {
                 followCursor: boolean;
@@ -1081,7 +1904,6 @@ declare const ScenarioSchema: z.ZodObject<{
                 transitionDuration: number;
                 padding: number;
             };
-            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
         };
         cursor: {
             enabled: boolean;
@@ -1207,6 +2029,7 @@ declare const ScenarioSchema: z.ZodObject<{
         width: z.ZodDefault<z.ZodNumber>;
         height: z.ZodDefault<z.ZodNumber>;
         fps: z.ZodDefault<z.ZodNumber>;
+        /** @deprecated Use `preset` instead. Will be removed in v0.7. */
         quality: z.ZodDefault<z.ZodNumber>;
         preset: z.ZodOptional<z.ZodEnum<["social", "balanced", "archive"]>>;
         outputDir: z.ZodDefault<z.ZodString>;
@@ -1230,6 +2053,27 @@ declare const ScenarioSchema: z.ZodObject<{
         outputDir?: string | undefined;
         filename?: string | undefined;
     }>>;
+    /** Optional audio narration — muxed into MP4 output. */
+    audio: z.ZodOptional<z.ZodObject<{
+        /** Path to the audio file (MP3, WAV, AAC, etc.). */
+        file: z.ZodString;
+        /** Volume level (0.0 = silent, 1.0 = full). */
+        volume: z.ZodDefault<z.ZodNumber>;
+        /** Fade-in duration in milliseconds. */
+        fadeIn: z.ZodDefault<z.ZodNumber>;
+        /** Fade-out duration in milliseconds. */
+        fadeOut: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        volume: number;
+        fadeIn: number;
+        fadeOut: number;
+    }, {
+        file: string;
+        volume?: number | undefined;
+        fadeIn?: number | undefined;
+        fadeOut?: number | undefined;
+    }>>;
     steps: z.ZodArray<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         actions: z.ZodArray<z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
@@ -1403,7 +2247,334 @@ declare const ScenarioSchema: z.ZodObject<{
         }>]>, "many">;
         captureDelay: z.ZodDefault<z.ZodNumber>;
         holdDuration: z.ZodDefault<z.ZodNumber>;
-        transition: z.ZodDefault<z.ZodEnum<["fade", "none"]>>;
+        transition: z.ZodDefault<z.ZodEnum<["none", "fade", "slide-left", "slide-up", "blur"]>>;
+        /** Per-step effects override — merges with global effects config. */
+        effects: z.ZodOptional<z.ZodObject<{
+            zoom: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                scale: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                intensity: z.ZodOptional<z.ZodDefault<z.ZodEnum<["subtle", "light", "moderate", "strong", "dramatic"]>>>;
+                duration: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                easing: z.ZodOptional<z.ZodDefault<z.ZodEnum<["ease-in-out", "ease-in", "ease-out", "linear"]>>>;
+                autoZoom: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+                    followCursor: z.ZodDefault<z.ZodBoolean>;
+                    /** @deprecated Use `intensity` on the parent zoom config instead. */
+                    maxScale: z.ZodDefault<z.ZodNumber>;
+                    transitionDuration: z.ZodDefault<z.ZodNumber>;
+                    padding: z.ZodDefault<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    followCursor: boolean;
+                    maxScale: number;
+                    transitionDuration: number;
+                    padding: number;
+                }, {
+                    followCursor?: boolean | undefined;
+                    maxScale?: number | undefined;
+                    transitionDuration?: number | undefined;
+                    padding?: number | undefined;
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor: boolean;
+                    maxScale: number;
+                    transitionDuration: number;
+                    padding: number;
+                } | undefined;
+            }, {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor?: boolean | undefined;
+                    maxScale?: number | undefined;
+                    transitionDuration?: number | undefined;
+                    padding?: number | undefined;
+                } | undefined;
+            }>>;
+            cursor: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                size: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                color: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                speed: z.ZodOptional<z.ZodDefault<z.ZodEnum<["fast", "normal", "slow"]>>>;
+                smoothing: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                clickEffect: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                clickColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                clickRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                trail: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                trailLength: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                trailColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                highlight: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                highlightRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                highlightColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            }, {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            }>>;
+            background: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodDefault<z.ZodEnum<["gradient", "solid", "image"]>>>;
+                value: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                padding: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                borderRadius: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                shadow: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            }, "strip", z.ZodTypeAny, {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            }, {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            }>>;
+            deviceFrame: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                type: z.ZodOptional<z.ZodDefault<z.ZodEnum<["browser", "macbook", "iphone", "ipad", "android", "none"]>>>;
+                darkMode: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            }, "strip", z.ZodTypeAny, {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            }, {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            }>>;
+            speedRamp: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                idleSpeed: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                actionSpeed: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                transitionFrames: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            }, "strip", z.ZodTypeAny, {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            }, {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            }>>;
+            keystroke: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                showTyping: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                position: z.ZodOptional<z.ZodDefault<z.ZodEnum<["bottom-center", "bottom-left", "bottom-right"]>>>;
+                fontSize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                backgroundColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                textColor: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                padding: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                fadeAfter: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+            }, "strip", z.ZodTypeAny, {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            }, {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            }>>;
+            watermark: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                text: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                position: z.ZodOptional<z.ZodDefault<z.ZodEnum<["top-left", "top-right", "bottom-left", "bottom-right"]>>>;
+                opacity: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                fontSize: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                color: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            }, {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            zoom?: {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor: boolean;
+                    maxScale: number;
+                    transitionDuration: number;
+                    padding: number;
+                } | undefined;
+            } | undefined;
+            cursor?: {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            } | undefined;
+            background?: {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            } | undefined;
+            deviceFrame?: {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            } | undefined;
+            speedRamp?: {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            } | undefined;
+            keystroke?: {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            } | undefined;
+            watermark?: {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            } | undefined;
+        }, {
+            zoom?: {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor?: boolean | undefined;
+                    maxScale?: number | undefined;
+                    transitionDuration?: number | undefined;
+                    padding?: number | undefined;
+                } | undefined;
+            } | undefined;
+            cursor?: {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            } | undefined;
+            background?: {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            } | undefined;
+            deviceFrame?: {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            } | undefined;
+            speedRamp?: {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            } | undefined;
+            keystroke?: {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            } | undefined;
+            watermark?: {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            } | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         actions: ({
             action: "navigate";
@@ -1464,8 +2635,75 @@ declare const ScenarioSchema: z.ZodObject<{
         })[];
         captureDelay: number;
         holdDuration: number;
-        transition: "none" | "fade";
+        transition: "none" | "fade" | "slide-left" | "slide-up" | "blur";
         name?: string | undefined;
+        effects?: {
+            zoom?: {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor: boolean;
+                    maxScale: number;
+                    transitionDuration: number;
+                    padding: number;
+                } | undefined;
+            } | undefined;
+            cursor?: {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            } | undefined;
+            background?: {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            } | undefined;
+            deviceFrame?: {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            } | undefined;
+            speedRamp?: {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            } | undefined;
+            keystroke?: {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            } | undefined;
+            watermark?: {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            } | undefined;
+        } | undefined;
     }, {
         actions: ({
             action: "navigate";
@@ -1527,19 +2765,83 @@ declare const ScenarioSchema: z.ZodObject<{
         name?: string | undefined;
         captureDelay?: number | undefined;
         holdDuration?: number | undefined;
-        transition?: "none" | "fade" | undefined;
+        transition?: "none" | "fade" | "slide-left" | "slide-up" | "blur" | undefined;
+        effects?: {
+            zoom?: {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor?: boolean | undefined;
+                    maxScale?: number | undefined;
+                    transitionDuration?: number | undefined;
+                    padding?: number | undefined;
+                } | undefined;
+            } | undefined;
+            cursor?: {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            } | undefined;
+            background?: {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            } | undefined;
+            deviceFrame?: {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            } | undefined;
+            speedRamp?: {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            } | undefined;
+            keystroke?: {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            } | undefined;
+            watermark?: {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            } | undefined;
+        } | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
     effects: {
         zoom: {
             duration: number;
             enabled: boolean;
             scale: number;
+            intensity: "subtle" | "light" | "moderate" | "strong" | "dramatic";
             easing: "ease-in-out" | "ease-in" | "ease-out" | "linear";
             autoZoom: {
                 followCursor: boolean;
@@ -1547,7 +2849,6 @@ declare const ScenarioSchema: z.ZodObject<{
                 transitionDuration: number;
                 padding: number;
             };
-            intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
         };
         cursor: {
             enabled: boolean;
@@ -1602,6 +2903,10 @@ declare const ScenarioSchema: z.ZodObject<{
             opacity: number;
         };
     };
+    viewport: {
+        width: number;
+        height: number;
+    };
     output: {
         format: "gif" | "mp4" | "webm" | "png-sequence";
         width: number;
@@ -1672,10 +2977,83 @@ declare const ScenarioSchema: z.ZodObject<{
         })[];
         captureDelay: number;
         holdDuration: number;
-        transition: "none" | "fade";
+        transition: "none" | "fade" | "slide-left" | "slide-up" | "blur";
         name?: string | undefined;
+        effects?: {
+            zoom?: {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor: boolean;
+                    maxScale: number;
+                    transitionDuration: number;
+                    padding: number;
+                } | undefined;
+            } | undefined;
+            cursor?: {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            } | undefined;
+            background?: {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            } | undefined;
+            deviceFrame?: {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            } | undefined;
+            speedRamp?: {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            } | undefined;
+            keystroke?: {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            } | undefined;
+            watermark?: {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            } | undefined;
+        } | undefined;
     }[];
     description?: string | undefined;
+    audio?: {
+        file: string;
+        volume: number;
+        fadeIn: number;
+        fadeOut: number;
+    } | undefined;
 }, {
     name: string;
     steps: {
@@ -1739,13 +3117,75 @@ declare const ScenarioSchema: z.ZodObject<{
         name?: string | undefined;
         captureDelay?: number | undefined;
         holdDuration?: number | undefined;
-        transition?: "none" | "fade" | undefined;
+        transition?: "none" | "fade" | "slide-left" | "slide-up" | "blur" | undefined;
+        effects?: {
+            zoom?: {
+                duration?: number | undefined;
+                enabled?: boolean | undefined;
+                scale?: number | undefined;
+                intensity?: "subtle" | "light" | "moderate" | "strong" | "dramatic" | undefined;
+                easing?: "ease-in-out" | "ease-in" | "ease-out" | "linear" | undefined;
+                autoZoom?: {
+                    followCursor?: boolean | undefined;
+                    maxScale?: number | undefined;
+                    transitionDuration?: number | undefined;
+                    padding?: number | undefined;
+                } | undefined;
+            } | undefined;
+            cursor?: {
+                enabled?: boolean | undefined;
+                size?: number | undefined;
+                color?: string | undefined;
+                speed?: "fast" | "normal" | "slow" | undefined;
+                smoothing?: boolean | undefined;
+                clickEffect?: boolean | undefined;
+                clickColor?: string | undefined;
+                clickRadius?: number | undefined;
+                trail?: boolean | undefined;
+                trailLength?: number | undefined;
+                trailColor?: string | undefined;
+                highlight?: boolean | undefined;
+                highlightRadius?: number | undefined;
+                highlightColor?: string | undefined;
+            } | undefined;
+            background?: {
+                value?: string | undefined;
+                type?: "gradient" | "solid" | "image" | undefined;
+                padding?: number | undefined;
+                borderRadius?: number | undefined;
+                shadow?: boolean | undefined;
+            } | undefined;
+            deviceFrame?: {
+                type?: "browser" | "macbook" | "iphone" | "ipad" | "android" | "none" | undefined;
+                enabled?: boolean | undefined;
+                darkMode?: boolean | undefined;
+            } | undefined;
+            speedRamp?: {
+                enabled?: boolean | undefined;
+                idleSpeed?: number | undefined;
+                actionSpeed?: number | undefined;
+                transitionFrames?: number | undefined;
+            } | undefined;
+            keystroke?: {
+                padding?: number | undefined;
+                enabled?: boolean | undefined;
+                showTyping?: boolean | undefined;
+                position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+                fontSize?: number | undefined;
+                backgroundColor?: string | undefined;
+                textColor?: string | undefined;
+                fadeAfter?: number | undefined;
+            } | undefined;
+            watermark?: {
+                text?: string | undefined;
+                enabled?: boolean | undefined;
+                color?: string | undefined;
+                position?: "bottom-left" | "bottom-right" | "top-left" | "top-right" | undefined;
+                fontSize?: number | undefined;
+                opacity?: number | undefined;
+            } | undefined;
+        } | undefined;
     }[];
-    description?: string | undefined;
-    viewport?: {
-        width?: number | undefined;
-        height?: number | undefined;
-    } | undefined;
     effects?: {
         zoom?: {
             duration?: number | undefined;
@@ -1813,6 +3253,11 @@ declare const ScenarioSchema: z.ZodObject<{
             opacity?: number | undefined;
         } | undefined;
     } | undefined;
+    description?: string | undefined;
+    viewport?: {
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
     output?: {
         format?: "gif" | "mp4" | "webm" | "png-sequence" | undefined;
         width?: number | undefined;
@@ -1823,6 +3268,12 @@ declare const ScenarioSchema: z.ZodObject<{
         outputDir?: string | undefined;
         filename?: string | undefined;
     } | undefined;
+    audio?: {
+        file: string;
+        volume?: number | undefined;
+        fadeIn?: number | undefined;
+        fadeOut?: number | undefined;
+    } | undefined;
 }>;
 type Scenario = z.infer<typeof ScenarioSchema>;
 interface KeystrokeEvent {
@@ -1858,6 +3309,8 @@ interface CapturedFrame {
     stepIndex?: number;
     actionType?: string;
     keystrokes?: KeystrokeEvent[];
+    /** True when the frame was captured during a scroll action. */
+    isScrolling?: boolean;
 }
 interface ComposedFrame {
     index: number;
@@ -1917,6 +3370,7 @@ declare class ClipwiseRecorder {
      *  each input field's text on a separate line. */
     private keystrokeSessionId;
     private currentStepIndex;
+    private isScrolling;
     private cursorPosition;
     private viewport;
     private deviceScaleFactor;
@@ -2227,13 +3681,13 @@ declare function encodeGif(frames: ComposedFrame[], config: OutputConfig): Promi
  *
  * Requires ffmpeg to be installed and available in PATH.
  */
-declare function encodeMp4(frames: ComposedFrame[], config: OutputConfig): Promise<Buffer>;
+declare function encodeMp4(frames: ComposedFrame[], config: OutputConfig, audio?: AudioConfig): Promise<Buffer>;
 /**
  * Streaming variant of encodeMp4 — accepts an AsyncIterable so frames can
  * be piped to FFmpeg as they arrive from the composition pipeline,
  * overlapping composition and encoding rather than waiting for all frames.
  */
-declare function encodeMp4Stream(frames: AsyncIterable<ComposedFrame>, config: OutputConfig): Promise<Buffer>;
+declare function encodeMp4Stream(frames: AsyncIterable<ComposedFrame>, config: OutputConfig, audio?: AudioConfig): Promise<Buffer>;
 /**
  * Save a sequence of composed frames as individual PNG files.
  */
@@ -2460,22 +3914,31 @@ type RawInfo = {
     height: number;
     channels: 4;
 };
+type TransitionResult = {
+    buffer: Buffer;
+    rawInfo: RawInfo;
+};
 /**
  * Apply a crossfade transition between two frame buffers.
  * Uses raw pixel weighted averaging for accurate blending.
+ */
+declare function applyCrossfade(fromBuffer: Buffer, toBuffer: Buffer, progress: number, width: number, height: number, fromRawInfo?: RawInfo, toRawInfo?: RawInfo): Promise<TransitionResult>;
+/**
+ * Slide transition: the incoming frame slides in from the given direction,
+ * pushing the outgoing frame away.
  *
- * @param fromBuffer  - The outgoing frame (PNG or raw RGBA)
- * @param toBuffer    - The incoming frame (PNG or raw RGBA)
- * @param progress    - 0 = fully "from", 1 = fully "to"
- * @param width       - Frame width
- * @param height      - Frame height
- * @param fromRawInfo - Pass when fromBuffer is raw RGBA
- * @param toRawInfo   - Pass when toBuffer is raw RGBA
+ * @param direction - "left" = new frame enters from left; "up" = from bottom
  */
-declare function applyCrossfade(fromBuffer: Buffer, toBuffer: Buffer, progress: number, width: number, height: number, fromRawInfo?: RawInfo, toRawInfo?: RawInfo): Promise<{
-    buffer: Buffer;
-    rawInfo: RawInfo;
-}>;
+declare function applySlide(fromBuffer: Buffer, toBuffer: Buffer, progress: number, width: number, height: number, direction: "left" | "up", fromRawInfo?: RawInfo, toRawInfo?: RawInfo): Promise<TransitionResult>;
+/**
+ * Blur transition: outgoing frame blurs out while incoming frame fades in.
+ * Combines a Gaussian blur on the "from" frame with crossfade to "to".
+ */
+declare function applyBlur(fromBuffer: Buffer, toBuffer: Buffer, progress: number, width: number, height: number, fromRawInfo?: RawInfo, toRawInfo?: RawInfo): Promise<TransitionResult>;
+/**
+ * Apply any transition type between two frame buffers.
+ */
+declare function applyTransition(type: TransitionType, fromBuffer: Buffer, toBuffer: Buffer, progress: number, width: number, height: number, fromRawInfo?: RawInfo, toRawInfo?: RawInfo): Promise<TransitionResult>;
 
 type WatermarkConfig = EffectsConfig["watermark"];
 /**
@@ -2504,4 +3967,4 @@ interface ValidationResult {
  */
 declare function validateScenario(scenario: Scenario): ValidationResult;
 
-export { CanvasRenderer, type CapturedFrame, ClipwiseRecorder, type ComposedFrame, type ConcurrentResult, ConcurrentSession, type EffectsConfig, type FrameContext, type KeystrokeEvent, type OutputConfig, type PipelineProgress, type RecordingHandle, type RecordingSession, type Scenario, type Step, type StepAction, StreamingSession, ZOOM_INTENSITY_SCALES, type ZoomIntensity, applyCrossfade, buildZoomClickLookup, calculateAdaptiveZoom, calculateAdaptiveZoomFromLookup, calculateAdaptiveZoomInWindow, calculatePanOffset, encodeGif, encodeMp4, encodeMp4Stream, lerpZoom, loadScenario, parseScenario, renderCursorHighlight, renderCursorTrail, renderKeystrokeHud, renderWatermark, resolveZoomScale, savePngSequence, validateScenario };
+export { type AudioConfig, CanvasRenderer, type CapturedFrame, ClipwiseRecorder, type ComposedFrame, type ConcurrentResult, ConcurrentSession, type EffectsConfig, type FrameContext, type KeystrokeEvent, type OutputConfig, type PipelineProgress, type RecordingHandle, type RecordingSession, type Scenario, type Step, type StepAction, type StepEffectsOverride, StreamingSession, type TransitionType, ZOOM_INTENSITY_SCALES, type ZoomIntensity, applyBlur, applyCrossfade, applySlide, applyTransition, buildZoomClickLookup, calculateAdaptiveZoom, calculateAdaptiveZoomFromLookup, calculateAdaptiveZoomInWindow, calculatePanOffset, encodeGif, encodeMp4, encodeMp4Stream, lerpZoom, loadScenario, parseScenario, renderCursorHighlight, renderCursorTrail, renderKeystrokeHud, renderWatermark, resolveZoomScale, savePngSequence, validateScenario };