@remotion/effects 4.0.473 → 4.0.474

package/dist/esm/noise.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -131,7 +139,7 @@ var resolve = (p) => ({
   seed: p.seed ?? DEFAULT_SEED,
   premultiply: p.premultiply ?? DEFAULT_PREMULTIPLY
 });
-var assertOptionalBoolean = (value, name) => {
+var assertOptionalBoolean2 = (value, name) => {
   if (value === undefined) {
     return;
   }
@@ -143,7 +151,7 @@ var validateNoiseParams = (params) => {
   assertEffectParamsObject(params, "Noise");
   assertOptionalFiniteNumber(params.amount, "amount");
   assertOptionalFiniteNumber(params.seed, "seed");
-  assertOptionalBoolean(params.premultiply, "premultiply");
+  assertOptionalBoolean2(params.premultiply, "premultiply");
   const r = resolve(params);
   validateUnitInterval(r.amount, "amount");
 };

package/dist/esm/pixel-dissolve.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/rings.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -105,6 +113,7 @@ var DEFAULT_CENTER = [0.5, 0.5];
 var DEFAULT_THICKNESS = 40;
 var DEFAULT_GAP = 0;
 var DEFAULT_OFFSET = 0;
+var DEFAULT_MASK_TO_SOURCE_ALPHA = false;
 var ringsSchema = {
   center: {
     type: "uv-coordinate",
@@ -138,6 +147,11 @@ var ringsSchema = {
     default: DEFAULT_OFFSET,
     description: "Offset",
     hiddenFromList: false
+  },
+  maskToSourceAlpha: {
+    type: "boolean",
+    default: DEFAULT_MASK_TO_SOURCE_ALPHA,
+    description: "Mask to source alpha"
   }
 };
 var resolve = (p) => {
@@ -148,7 +162,8 @@ var resolve = (p) => {
     center: [...p.center ?? DEFAULT_CENTER],
     thickness,
     spacing: thickness + gap,
-    offset: p.offset ?? DEFAULT_OFFSET
+    offset: p.offset ?? DEFAULT_OFFSET,
+    maskToSourceAlpha: p.maskToSourceAlpha ?? DEFAULT_MASK_TO_SOURCE_ALPHA
   };
 };
 var validatePositive = (value, name) => {
@@ -189,6 +204,7 @@ var validateRingsParams = (params) => {
   assertOptionalFiniteNumber(params.thickness, "thickness");
   assertOptionalFiniteNumber(params.gap, "gap");
   assertOptionalFiniteNumber(params.offset, "offset");
+  assertOptionalBoolean(params.maskToSourceAlpha, "maskToSourceAlpha");
   const thickness = params.thickness ?? DEFAULT_THICKNESS;
   const gap = params.gap ?? DEFAULT_GAP;
   validatePositive(thickness, "thickness");
@@ -218,6 +234,7 @@ uniform vec2 uCenter;
 uniform float uThickness;
 uniform float uSpacing;
 uniform float uOffset;
+uniform bool uMaskToSourceAlpha;
 
 void main() {
 	vec4 texColor = texture(uSource, vUv);
@@ -244,6 +261,14 @@ void main() {
 	float ringAlpha = ringColor.a;
 	vec3 premultipliedRing = ringColor.rgb * ringAlpha;
 
+	if (uMaskToSourceAlpha) {
+		fragColor = vec4(
+			premultipliedRing * texColor.a + texColor.rgb * (1.0 - ringAlpha),
+			texColor.a
+		);
+		return;
+	}
+
 	fragColor = vec4(
 		premultipliedRing + texColor.rgb * (1.0 - ringAlpha),
 		ringAlpha + texColor.a * (1.0 - ringAlpha)
@@ -370,7 +395,8 @@ var setupRings = (target) => {
       uCenter: gl.getUniformLocation(program, "uCenter"),
       uThickness: gl.getUniformLocation(program, "uThickness"),
       uSpacing: gl.getUniformLocation(program, "uSpacing"),
-      uOffset: gl.getUniformLocation(program, "uOffset")
+      uOffset: gl.getUniformLocation(program, "uOffset"),
+      uMaskToSourceAlpha: gl.getUniformLocation(program, "uMaskToSourceAlpha")
     },
     cachedPaletteKey: "",
     palettePixelData: new Uint8Array(0)
@@ -404,7 +430,8 @@ var rings = createEffect({
   backend: "webgl2",
   calculateKey: (params) => {
     const r = resolve(params);
-    return `rings-${r.colors.join("|")}-${r.center.join(":")}-${r.thickness}-${r.spacing}-${r.offset}`;
+    const maskSuffix = r.maskToSourceAlpha ? "-mask-to-source-alpha" : "";
+    return `rings-${r.colors.join("|")}-${r.center.join(":")}-${r.thickness}-${r.spacing}-${r.offset}${maskSuffix}`;
   },
   setup: (target) => setupRings(target),
   apply: ({ source, width, height, params, state, flipSourceY }) => {
@@ -445,6 +472,8 @@ var rings = createEffect({
       gl.uniform1f(uniforms.uSpacing, r.spacing);
     if (uniforms.uOffset)
       gl.uniform1f(uniforms.uOffset, r.offset);
+    if (uniforms.uMaskToSourceAlpha)
+      gl.uniform1i(uniforms.uMaskToSourceAlpha, r.maskToSourceAlpha ? 1 : 0);
     gl.bindVertexArray(vao);
     gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
     gl.bindVertexArray(null);

package/dist/esm/saturation.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/scale.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/scale/index.ts
 var { createEffect } = Internals;

package/dist/esm/scanlines.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -153,7 +161,7 @@ var resolve = (p) => ({
   offset: p.offset ?? DEFAULT_OFFSET,
   premultiply: p.premultiply ?? DEFAULT_PREMULTIPLY
 });
-var assertOptionalBoolean = (value, name) => {
+var assertOptionalBoolean2 = (value, name) => {
   if (value === undefined) {
     return;
   }
@@ -172,7 +180,7 @@ var validateScanlinesParams = (params) => {
   assertOptionalFiniteNumber(params.spacing, "spacing");
   assertOptionalFiniteNumber(params.thickness, "thickness");
   assertOptionalFiniteNumber(params.offset, "offset");
-  assertOptionalBoolean(params.premultiply, "premultiply");
+  assertOptionalBoolean2(params.premultiply, "premultiply");
   const r = resolve(params);
   validateUnitInterval(r.amount, "amount");
   validatePositive(r.spacing, "spacing");

package/dist/esm/shine.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/speckle.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/tint.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/translate.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/vignette.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/wave.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/wave/wave-runtime.ts
 import { Internals } from "remotion";

package/dist/esm/waves.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -110,6 +118,7 @@ var DEFAULT_OFFSET = 0;
 var DEFAULT_AMPLITUDE = 24;
 var DEFAULT_WAVELENGTH = 160;
 var DEFAULT_PHASE = 0;
+var DEFAULT_MASK_TO_SOURCE_ALPHA = false;
 var wavesSchema = {
   direction: {
     type: "enum",
@@ -177,6 +186,11 @@ var wavesSchema = {
     default: DEFAULT_PHASE,
     description: "Phase",
     hiddenFromList: false
+  },
+  maskToSourceAlpha: {
+    type: "boolean",
+    default: DEFAULT_MASK_TO_SOURCE_ALPHA,
+    description: "Mask to source alpha"
   }
 };
 var resolve = (p) => {
@@ -191,7 +205,8 @@ var resolve = (p) => {
     offset: p.offset ?? DEFAULT_OFFSET,
     amplitude: p.amplitude ?? DEFAULT_AMPLITUDE,
     wavelength: p.wavelength ?? DEFAULT_WAVELENGTH,
-    phase: p.phase ?? DEFAULT_PHASE
+    phase: p.phase ?? DEFAULT_PHASE,
+    maskToSourceAlpha: p.maskToSourceAlpha ?? DEFAULT_MASK_TO_SOURCE_ALPHA
   };
 };
 var formatEnum = (variants) => {
@@ -240,6 +255,7 @@ var validateWavesParams = (params) => {
   assertOptionalFiniteNumber(params.amplitude, "amplitude");
   assertOptionalFiniteNumber(params.wavelength, "wavelength");
   assertOptionalFiniteNumber(params.phase, "phase");
+  assertOptionalBoolean(params.maskToSourceAlpha, "maskToSourceAlpha");
   const thickness = params.thickness ?? DEFAULT_THICKNESS;
   const gap = params.gap ?? DEFAULT_GAP;
   const amplitude = params.amplitude ?? DEFAULT_AMPLITUDE;
@@ -277,6 +293,7 @@ uniform float uOffset;
 uniform float uAmplitude;
 uniform float uWavelength;
 uniform float uPhase;
+uniform bool uMaskToSourceAlpha;
 
 void main() {
 	vec4 texColor = texture(uSource, vUv);
@@ -312,6 +329,14 @@ void main() {
 	float lineAlpha = lineColor.a;
 	vec3 premultipliedLine = lineColor.rgb * lineAlpha;
 
+	if (uMaskToSourceAlpha) {
+		fragColor = vec4(
+			premultipliedLine * texColor.a + texColor.rgb * (1.0 - lineAlpha),
+			texColor.a
+		);
+		return;
+	}
+
 	fragColor = vec4(
 		premultipliedLine + texColor.rgb * (1.0 - lineAlpha),
 		lineAlpha + texColor.a * (1.0 - lineAlpha)
@@ -442,7 +467,8 @@ var setupWaves = (target) => {
       uOffset: gl.getUniformLocation(program, "uOffset"),
       uAmplitude: gl.getUniformLocation(program, "uAmplitude"),
       uWavelength: gl.getUniformLocation(program, "uWavelength"),
-      uPhase: gl.getUniformLocation(program, "uPhase")
+      uPhase: gl.getUniformLocation(program, "uPhase"),
+      uMaskToSourceAlpha: gl.getUniformLocation(program, "uMaskToSourceAlpha")
     },
     cachedPaletteKey: "",
     palettePixelData: new Uint8Array(0)
@@ -476,7 +502,8 @@ var waves = createEffect({
   backend: "webgl2",
   calculateKey: (params) => {
     const r = resolve(params);
-    return `waves-${r.colors.join("|")}-${r.direction}-${r.thickness}-${r.spacing}-${r.angle}-${r.offset}-${r.amplitude}-${r.wavelength}-${r.phase}`;
+    const maskSuffix = r.maskToSourceAlpha ? "-mask-to-source-alpha" : "";
+    return `waves-${r.colors.join("|")}-${r.direction}-${r.thickness}-${r.spacing}-${r.angle}-${r.offset}-${r.amplitude}-${r.wavelength}-${r.phase}${maskSuffix}`;
   },
   setup: (target) => setupWaves(target),
   apply: ({ source, width, height, params, state, flipSourceY }) => {
@@ -525,6 +552,8 @@ var waves = createEffect({
       gl.uniform1f(uniforms.uWavelength, r.wavelength);
     if (uniforms.uPhase)
       gl.uniform1f(uniforms.uPhase, r.phase * Math.PI / 180);
+    if (uniforms.uMaskToSourceAlpha)
+      gl.uniform1i(uniforms.uMaskToSourceAlpha, r.maskToSourceAlpha ? 1 : 0);
     gl.bindVertexArray(vao);
     gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
     gl.bindVertexArray(null);

package/dist/esm/white-noise.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;

package/dist/esm/zigzag.mjs

@@ -23,6 +23,14 @@ var assertOptionalColor = (value, name) => {
   }
   assertRequiredColor(value, name);
 };
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -109,6 +117,7 @@ var DEFAULT_ANGLE = 0;
 var DEFAULT_OFFSET = 0;
 var DEFAULT_AMPLITUDE = 40;
 var DEFAULT_WAVELENGTH = 160;
+var DEFAULT_MASK_TO_SOURCE_ALPHA = false;
 var zigzagSchema = {
   direction: {
     type: "enum",
@@ -167,6 +176,11 @@ var zigzagSchema = {
     default: DEFAULT_WAVELENGTH,
     description: "Wavelength",
     hiddenFromList: false
+  },
+  maskToSourceAlpha: {
+    type: "boolean",
+    default: DEFAULT_MASK_TO_SOURCE_ALPHA,
+    description: "Mask to source alpha"
   }
 };
 var resolve = (p) => {
@@ -180,7 +194,8 @@ var resolve = (p) => {
     angle: p.angle ?? DEFAULT_ANGLE,
     offset: p.offset ?? DEFAULT_OFFSET,
     amplitude: p.amplitude ?? DEFAULT_AMPLITUDE,
-    wavelength: p.wavelength ?? DEFAULT_WAVELENGTH
+    wavelength: p.wavelength ?? DEFAULT_WAVELENGTH,
+    maskToSourceAlpha: p.maskToSourceAlpha ?? DEFAULT_MASK_TO_SOURCE_ALPHA
   };
 };
 var formatEnum = (variants) => {
@@ -228,6 +243,7 @@ var validateZigzagParams = (params) => {
   assertOptionalFiniteNumber(params.offset, "offset");
   assertOptionalFiniteNumber(params.amplitude, "amplitude");
   assertOptionalFiniteNumber(params.wavelength, "wavelength");
+  assertOptionalBoolean(params.maskToSourceAlpha, "maskToSourceAlpha");
   const thickness = params.thickness ?? DEFAULT_THICKNESS;
   const gap = params.gap ?? DEFAULT_GAP;
   const amplitude = params.amplitude ?? DEFAULT_AMPLITUDE;
@@ -264,6 +280,7 @@ uniform float uAngle;
 uniform float uOffset;
 uniform float uAmplitude;
 uniform float uWavelength;
+uniform bool uMaskToSourceAlpha;
 
 void main() {
 	vec4 texColor = texture(uSource, vUv);
@@ -298,6 +315,14 @@ void main() {
 	float lineAlpha = lineColor.a;
 	vec3 premultipliedLine = lineColor.rgb * lineAlpha;
 
+	if (uMaskToSourceAlpha) {
+		fragColor = vec4(
+			premultipliedLine * texColor.a + texColor.rgb * (1.0 - lineAlpha),
+			texColor.a
+		);
+		return;
+	}
+
 	fragColor = vec4(
 		premultipliedLine + texColor.rgb * (1.0 - lineAlpha),
 		lineAlpha + texColor.a * (1.0 - lineAlpha)
@@ -427,7 +452,8 @@ var setupZigzag = (target) => {
       uAngle: gl.getUniformLocation(program, "uAngle"),
       uOffset: gl.getUniformLocation(program, "uOffset"),
       uAmplitude: gl.getUniformLocation(program, "uAmplitude"),
-      uWavelength: gl.getUniformLocation(program, "uWavelength")
+      uWavelength: gl.getUniformLocation(program, "uWavelength"),
+      uMaskToSourceAlpha: gl.getUniformLocation(program, "uMaskToSourceAlpha")
     },
     cachedPaletteKey: "",
     palettePixelData: new Uint8Array(0)
@@ -461,7 +487,8 @@ var zigzag = createEffect({
   backend: "webgl2",
   calculateKey: (params) => {
     const r = resolve(params);
-    return `zigzag-${r.colors.join("|")}-${r.direction}-${r.thickness}-${r.spacing}-${r.angle}-${r.offset}-${r.amplitude}-${r.wavelength}`;
+    const maskSuffix = r.maskToSourceAlpha ? "-mask-to-source-alpha" : "";
+    return `zigzag-${r.colors.join("|")}-${r.direction}-${r.thickness}-${r.spacing}-${r.angle}-${r.offset}-${r.amplitude}-${r.wavelength}${maskSuffix}`;
   },
   setup: (target) => setupZigzag(target),
   apply: ({ source, width, height, params, state, flipSourceY }) => {
@@ -508,6 +535,8 @@ var zigzag = createEffect({
       gl.uniform1f(uniforms.uAmplitude, r.amplitude);
     if (uniforms.uWavelength)
       gl.uniform1f(uniforms.uWavelength, r.wavelength);
+    if (uniforms.uMaskToSourceAlpha)
+      gl.uniform1i(uniforms.uMaskToSourceAlpha, r.maskToSourceAlpha ? 1 : 0);
     gl.bindVertexArray(vao);
     gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
     gl.bindVertexArray(null);

package/dist/halftone-linear-gradient.d.ts

@@ -59,6 +59,11 @@ export declare const halftoneLinearGradientSchema: {
             readonly source: {};
         };
     };
+    readonly maskToSourceAlpha: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Mask to source alpha";
+    };
 };
 export type HalftoneLinearGradientColorMode = (typeof HALFTONE_LINEAR_GRADIENT_COLOR_MODES)[number];
 export type UvCoordinate = readonly [number, number];
@@ -83,6 +88,10 @@ type HalftoneLinearGradientCommonParams = {
      * Distance between adjacent dot centers.
      */
     readonly gridSize?: number;
+    /**
+     * Masks solid-color dots to the source alpha channel. Defaults to `false`.
+     */
+    readonly maskToSourceAlpha?: boolean;
 };
 export type HalftoneLinearGradientParams = HalftoneLinearGradientCommonParams & ({
     readonly colorMode?: 'solid';

package/dist/lines.d.ts

@@ -40,6 +40,11 @@ export declare const linesSchema: {
         readonly description: "Offset";
         readonly hiddenFromList: false;
     };
+    readonly maskToSourceAlpha: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Mask to source alpha";
+    };
 };
 export type LinesDirection = (typeof LINE_DIRECTIONS)[number];
 export type LinesParams = {
@@ -55,6 +60,8 @@ export type LinesParams = {
     readonly angle?: number;
     /** Offset in pixels. Animate this value to scroll the lines. Defaults to `0`. */
     readonly offset?: number;
+    /** Masks the generated line pattern to the source alpha channel. Defaults to `false`. */
+    readonly maskToSourceAlpha?: boolean;
 };
 export declare const lines: (params?: (LinesParams & {
     readonly disabled?: boolean | undefined;

package/dist/noise-displacement.d.ts

@@ -0,0 +1,26 @@
+export type NoiseDisplacementCenter = readonly [number, number];
+export type NoiseDisplacementParams = {
+    /** Center of the affected area in UV coordinates. */
+    readonly center: NoiseDisplacementCenter;
+    /** Radius of the affected area, relative to the shorter canvas side. */
+    readonly radius: number;
+    /** Maximum displacement in pixels at the center. Defaults to `36`. */
+    readonly strength?: number;
+    /** Seed for the deterministic noise field. Defaults to `0`. */
+    readonly seed?: number;
+    /** Size of each noise cell in pixels. Defaults to `8`. */
+    readonly grainSize?: number;
+    /** Number of source samples along the displacement path. Defaults to `6`. */
+    readonly passes?: number;
+    /** Additional local blur in pixels. Defaults to `0`. */
+    readonly blur?: number;
+    /** Edge softness as a fraction of the radius. Defaults to `0.25`. */
+    readonly feather?: number;
+    /** Direction of the optional bias pull in degrees. Defaults to `0`. */
+    readonly biasDirection?: number;
+    /** Directional pull multiplier relative to `strength`. Defaults to `0`. */
+    readonly biasAmount?: number;
+};
+export declare const noiseDisplacement: (params: NoiseDisplacementParams & {
+    readonly disabled?: boolean | undefined;
+}) => import("remotion").EffectDescriptor<unknown>;

package/dist/rings.d.ts

@@ -32,6 +32,11 @@ export declare const ringsSchema: {
         readonly description: "Offset";
         readonly hiddenFromList: false;
     };
+    readonly maskToSourceAlpha: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Mask to source alpha";
+    };
 };
 export type RingsCenter = readonly [number, number];
 export type RingsParams = {
@@ -45,6 +50,8 @@ export type RingsParams = {
     readonly gap?: number;
     /** Radial offset in pixels. Animate to expand or contract the rings. */
     readonly offset?: number;
+    /** Masks the generated ring pattern to the source alpha channel. Defaults to `false`. */
+    readonly maskToSourceAlpha?: boolean;
 };
 export declare const rings: (params?: (RingsParams & {
     readonly disabled?: boolean | undefined;

package/dist/validate-effect-param.d.ts

@@ -2,3 +2,4 @@ export declare const assertEffectParamsObject: (params: unknown, effectLabel: st
 export declare const assertRequiredFiniteNumber: (value: unknown, name: string) => void;
 export declare const assertRequiredColor: (value: unknown, name: string) => void;
 export declare const assertOptionalColor: (value: unknown, name: string) => void;
+export declare const assertOptionalBoolean: (value: unknown, name: string) => void;

package/dist/waves.d.ts

@@ -67,6 +67,11 @@ export declare const wavesSchema: {
         readonly description: "Phase";
         readonly hiddenFromList: false;
     };
+    readonly maskToSourceAlpha: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Mask to source alpha";
+    };
 };
 export type WavesDirection = (typeof WAVE_DIRECTIONS)[number];
 export type WavesParams = {
@@ -88,6 +93,8 @@ export type WavesParams = {
     readonly wavelength?: number;
     /** Wave phase in degrees. Defaults to `0`. */
     readonly phase?: number;
+    /** Masks the generated wave pattern to the source alpha channel. Defaults to `false`. */
+    readonly maskToSourceAlpha?: boolean;
 };
 export declare const waves: (params?: (WavesParams & {
     readonly disabled?: boolean | undefined;

package/dist/zigzag.d.ts

@@ -58,6 +58,11 @@ export declare const zigzagSchema: {
         readonly description: "Wavelength";
         readonly hiddenFromList: false;
     };
+    readonly maskToSourceAlpha: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Mask to source alpha";
+    };
 };
 export type ZigzagDirection = (typeof ZIGZAG_DIRECTIONS)[number];
 export type ZigzagParams = {
@@ -77,6 +82,8 @@ export type ZigzagParams = {
     readonly amplitude?: number;
     /** Distance in pixels before the zig-zag repeats. */
     readonly wavelength?: number;
+    /** Masks the generated zig-zag pattern to the source alpha channel. Defaults to `false`. */
+    readonly maskToSourceAlpha?: boolean;
 };
 export declare const zigzag: (params?: (ZigzagParams & {
     readonly disabled?: boolean | undefined;