@remotion/effects 4.0.462 → 4.0.464

package/dist/blur/index.d.ts

@@ -1,4 +1,6 @@
 export type BlurParams = {
     readonly radius: number;
 };
-export declare const blur: (params: BlurParams) => import("remotion").EffectDescriptor<unknown>;
+export declare const blur: (params: BlurParams & {
+    readonly disabled?: boolean | undefined;
+}) => import("remotion").EffectDescriptor<unknown>;

package/dist/entrypoints/blur.d.ts

@@ -1,4 +1,6 @@
 import * as blurExports from '../blur/index.js';
 export type { BlurParams } from '../blur/index.js';
-declare const blur: (params: blurExports.BlurParams) => import("remotion").EffectDescriptor<unknown>;
+declare const blur: (params: blurExports.BlurParams & {
+    readonly disabled?: boolean | undefined;
+}) => import("remotion").EffectDescriptor<unknown>;
 export { blur };

package/dist/esm/blur.mjs

@@ -14,6 +14,26 @@ var exports_blur = {};
 __export(exports_blur, {
   blur: () => blur
 });
+import { Internals as Internals2 } from "remotion";
+
+// src/validate-effect-param.ts
+var assertEffectParamsObject = (params, effectLabel) => {
+  if (params === null || typeof params !== "object") {
+    throw new TypeError(`${effectLabel} effect requires a parameters object, but got ${JSON.stringify(params)}`);
+  }
+};
+var assertRequiredFiniteNumber = (value, name) => {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`"${name}" must be a finite number, but got ${JSON.stringify(value)}`);
+  }
+};
+var assertRequiredColor = (value, name) => {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
+  }
+};
+
+// src/blur/blur-runtime.ts
 import { Internals } from "remotion";
 
 // src/blur/blur-shaders.ts
@@ -69,6 +89,7 @@ var BLUR_FS_HORIZONTAL = buildFs("horizontal");
 var BLUR_FS_VERTICAL = buildFs("vertical");
 
 // src/blur/blur-runtime.ts
+var { createWebGL2ContextError } = Internals;
 var compileShader = (gl, type, source) => {
   const shader = gl.createShader(type);
   if (!shader) {
@@ -131,7 +152,7 @@ var setupBlur = (target) => {
     preserveDrawingBuffer: true
   });
   if (!gl) {
-    throw new Error("Failed to acquire WebGL2 context for blur effect");
+    throw createWebGL2ContextError("blur effect");
   }
   gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
   gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
@@ -293,17 +314,21 @@ var applyBlur = ({
 };
 
 // src/blur/index.ts
-var { createEffect } = Internals;
+var { createEffect } = Internals2;
 var blurSchema = {
   radius: {
     type: "number",
     min: 0,
     max: 100,
     step: 1,
-    default: 10,
+    default: undefined,
     description: "Blur radius"
   }
 };
+var validateBlurParams = (params) => {
+  assertEffectParamsObject(params, "Blur");
+  assertRequiredFiniteNumber(params.radius, "radius");
+};
 var blur = createEffect({
   type: "remotion/blur",
   label: "Blur",
@@ -320,7 +345,8 @@ var blur = createEffect({
     });
   },
   cleanup: (state) => cleanupBlur(state),
-  schema: blurSchema
+  schema: blurSchema,
+  validateParams: validateBlurParams
 });
 
 // src/entrypoints/blur.ts

package/dist/esm/halftone.mjs

@@ -11,7 +11,7 @@ var __export = (target, all) => {
 
 // src/halftone.ts
 import { Internals } from "remotion";
-var { createEffect } = Internals;
+var { createEffect, createWebGL2ContextError } = Internals;
 var SHADE_OUTSIDE_DOT_SCALE = 0.5;
 var halftoneSchema = {
   dotSize: {
@@ -49,6 +49,16 @@ var halftoneSchema = {
     step: 1,
     default: 0,
     description: "Offset Y"
+  },
+  shape: {
+    type: "enum",
+    variants: {
+      circle: {},
+      square: {},
+      line: {}
+    },
+    default: "circle",
+    description: "Shape"
   }
 };
 var resolve = (p) => ({
@@ -205,7 +215,7 @@ var halftone = createEffect({
       preserveDrawingBuffer: true
     });
     if (!gl) {
-      throw new Error("Failed to acquire WebGL2 context for halftone effect");
+      throw createWebGL2ContextError("halftone effect");
     }
     gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
     gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
@@ -333,7 +343,8 @@ var halftone = createEffect({
     gl.deleteVertexArray(vao);
     gl.deleteTexture(texture);
   },
-  schema: halftoneSchema
+  schema: halftoneSchema,
+  validateParams: () => {}
 });
 export {
   halftoneSchema,

package/dist/esm/tint.mjs

@@ -11,13 +11,31 @@ var __export = (target, all) => {
 
 // src/tint.ts
 import { Internals } from "remotion";
+
+// src/validate-effect-param.ts
+var assertEffectParamsObject = (params, effectLabel) => {
+  if (params === null || typeof params !== "object") {
+    throw new TypeError(`${effectLabel} effect requires a parameters object, but got ${JSON.stringify(params)}`);
+  }
+};
+var assertRequiredFiniteNumber = (value, name) => {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`"${name}" must be a finite number, but got ${JSON.stringify(value)}`);
+  }
+};
+var assertRequiredColor = (value, name) => {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
+  }
+};
+
+// src/tint.ts
 var { createEffect } = Internals;
 var DEFAULT_AMOUNT = 0.5;
-var DEFAULT_COLOR = "#ff0000";
 var tintSchema = {
   color: {
     type: "color",
-    default: DEFAULT_COLOR,
+    default: undefined,
     description: "Color"
   },
   amount: {
@@ -33,6 +51,10 @@ var resolve = (p) => ({
   color: p.color,
   amount: p.amount ?? DEFAULT_AMOUNT
 });
+var validateTintParams = (params) => {
+  assertEffectParamsObject(params, "Tint");
+  assertRequiredColor(params.color, "color");
+};
 var tint = createEffect({
   type: "remotion/tint",
   label: "Tint",
@@ -63,7 +85,8 @@ var tint = createEffect({
   cleanup: () => {
     return;
   },
-  schema: tintSchema
+  schema: tintSchema,
+  validateParams: validateTintParams
 });
 export {
   tintSchema,

package/dist/esm/wave.mjs

@@ -12,10 +12,46 @@ var __export = (target, all) => {
 // src/wave.ts
 import { Internals } from "remotion";
 var { createEffect } = Internals;
+var waveSchema = {
+  amplitude: {
+    type: "number",
+    min: 0,
+    max: 500,
+    step: 1,
+    default: 60,
+    description: "Amplitude"
+  },
+  wavelength: {
+    type: "number",
+    min: 1,
+    max: 2000,
+    step: 1,
+    default: 240,
+    description: "Wavelength"
+  },
+  evolution: {
+    type: "number",
+    default: 0,
+    description: "Evolution"
+  },
+  sliceWidth: {
+    type: "number",
+    min: 1,
+    max: 100,
+    step: 1,
+    default: 4,
+    description: "Slice width"
+  },
+  background: {
+    type: "color",
+    default: "transparent",
+    description: "Background"
+  }
+};
 var resolve = (p) => ({
   amplitude: p.amplitude ?? 60,
   wavelength: p.wavelength ?? 240,
-  speed: p.speed ?? 1 / 6,
+  evolution: p.evolution ?? 0,
   sliceWidth: p.sliceWidth ?? 4,
   background: p.background ?? "transparent"
 });
@@ -25,10 +61,10 @@ var wave = createEffect({
   backend: "2d",
   calculateKey: (params) => {
     const r = resolve(params);
-    return `wave-${r.amplitude}-${r.wavelength}-${r.speed}-${r.sliceWidth}-${r.background}`;
+    return `wave-${r.amplitude}-${r.wavelength}-${r.evolution}-${r.sliceWidth}-${r.background}`;
   },
   setup: () => null,
-  apply: ({ source, target, frame, width, height, params }) => {
+  apply: ({ source, target, width, height, params }) => {
     const ctx = target.getContext("2d");
     if (!ctx) {
       throw new Error("Failed to acquire 2D context for wave effect. The canvas may have been assigned a different context type.");
@@ -40,15 +76,17 @@ var wave = createEffect({
       ctx.fillRect(0, 0, width, height);
     }
     for (let x = 0;x < width; x += r.sliceWidth) {
-      const offset = Math.sin(x / r.wavelength * Math.PI * 2 + frame * r.speed) * r.amplitude;
+      const offset = Math.sin(x / r.wavelength * Math.PI * 2 + r.evolution) * r.amplitude;
       ctx.drawImage(source, x, 0, r.sliceWidth, height, x, offset, r.sliceWidth, height);
     }
   },
   cleanup: () => {
     return;
   },
-  schema: null
+  schema: waveSchema,
+  validateParams: () => {}
 });
 export {
+  waveSchema,
   wave
 };

package/dist/halftone.d.ts

@@ -35,6 +35,16 @@ export declare const halftoneSchema: {
         readonly default: 0;
         readonly description: "Offset Y";
     };
+    readonly shape: {
+        readonly type: "enum";
+        readonly variants: {
+            readonly circle: {};
+            readonly square: {};
+            readonly line: {};
+        };
+        readonly default: "circle";
+        readonly description: "Shape";
+    };
 };
 export type HalftoneShape = 'circle' | 'square' | 'line';
 export type HalftoneSampling = 'bilinear' | 'nearest';
@@ -60,4 +70,6 @@ export type HalftoneParams = {
      */
     readonly shadeOutside?: boolean;
 };
-export declare const halftone: (params?: HalftoneParams | undefined) => import("remotion").EffectDescriptor<unknown>;
+export declare const halftone: (params?: (HalftoneParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/tint.d.ts

@@ -1,7 +1,7 @@
 export declare const tintSchema: {
     readonly color: {
         readonly type: "color";
-        readonly default: "#ff0000";
+        readonly default: undefined;
         readonly description: "Color";
     };
     readonly amount: {
@@ -17,4 +17,6 @@ export type TintParams = {
     readonly color: string;
     readonly amount?: number;
 };
-export declare const tint: (params: TintParams) => import("remotion").EffectDescriptor<unknown>;
+export declare const tint: (params: TintParams & {
+    readonly disabled?: boolean | undefined;
+}) => import("remotion").EffectDescriptor<unknown>;

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

@@ -0,0 +1,3 @@
+export declare const assertEffectParamsObject: (params: unknown, effectLabel: string) => void;
+export declare const assertRequiredFiniteNumber: (value: unknown, name: string) => void;
+export declare const assertRequiredColor: (value: unknown, name: string) => void;

package/dist/wave.d.ts

@@ -1,8 +1,46 @@
+export declare const waveSchema: {
+    readonly amplitude: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 500;
+        readonly step: 1;
+        readonly default: 60;
+        readonly description: "Amplitude";
+    };
+    readonly wavelength: {
+        readonly type: "number";
+        readonly min: 1;
+        readonly max: 2000;
+        readonly step: 1;
+        readonly default: 240;
+        readonly description: "Wavelength";
+    };
+    readonly evolution: {
+        readonly type: "number";
+        readonly default: 0;
+        readonly description: "Evolution";
+    };
+    readonly sliceWidth: {
+        readonly type: "number";
+        readonly min: 1;
+        readonly max: 100;
+        readonly step: 1;
+        readonly default: 4;
+        readonly description: "Slice width";
+    };
+    readonly background: {
+        readonly type: "color";
+        readonly default: "transparent";
+        readonly description: "Background";
+    };
+};
 export type WaveParams = {
     readonly amplitude?: number;
     readonly wavelength?: number;
-    readonly speed?: number;
+    readonly evolution?: number;
     readonly sliceWidth?: number;
     readonly background?: string;
 };
-export declare const wave: (params?: WaveParams | undefined) => import("remotion").EffectDescriptor<unknown>;
+export declare const wave: (params?: (WaveParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@remotion/effects",
-	"version": "4.0.462",
+	"version": "4.0.464",
 	"description": "Experimental presets for Remotion canvas effect hooks",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -10,6 +10,7 @@
 	},
 	"type": "module",
 	"scripts": {
+		"test": "bun test src/test",
 		"formatting": "oxfmt src --check",
 		"format": "oxfmt src",
 		"lint": "eslint src",
@@ -23,7 +24,7 @@
 		"url": "https://github.com/remotion-dev/remotion/issues"
 	},
 	"dependencies": {
-		"remotion": "4.0.462"
+		"remotion": "4.0.464"
 	},
 	"exports": {
 		".": {
@@ -70,7 +71,7 @@
 		}
 	},
 	"devDependencies": {
-		"@remotion/eslint-config-internal": "4.0.462",
+		"@remotion/eslint-config-internal": "4.0.464",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},

package/dist/blur/blur-horizontal.d.ts

@@ -1,4 +0,0 @@
-export type BlurHorizontalParams = {
-    readonly radius: number;
-};
-export declare const blurHorizontal: (params: BlurHorizontalParams) => import("remotion").EffectDescriptor<unknown>;

package/dist/blur/blur-vertical.d.ts

@@ -1,4 +0,0 @@
-export type BlurVerticalParams = {
-    readonly radius: number;
-};
-export declare const blurVertical: (params: BlurVerticalParams) => import("remotion").EffectDescriptor<unknown>;