@remotion/effects 4.0.463 → 4.0.465

package/dist/esm/wave.mjs

@@ -1,22 +1,254 @@
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
+// src/wave/index.ts
+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/wave.ts
+// src/wave/wave-runtime.ts
 import { Internals } from "remotion";
-var { createEffect } = Internals;
+
+// src/wave/wave-shaders.ts
+var WAVE_VS = `#version 300 es
+layout(location = 0) in vec2 aPos;
+layout(location = 1) in vec2 aUv;
+out vec2 vUv;
+void main() {
+	vUv = aUv;
+	gl_Position = vec4(aPos, 0.0, 1.0);
+}
+`;
+var WAVE_FS = `#version 300 es
+precision highp float;
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform float uAmplitude;
+uniform float uWavelength;
+uniform float uPhase;
+uniform int uDirection;
+
+const float TWO_PI = 6.28318530718;
+
+void main() {
+	float wavelength = max(uWavelength, 0.001);
+	vec2 srcUv = vUv;
+
+	if (uDirection == 0) {
+		float coordPx = vUv.x * uResolution.x;
+		float offsetPx =
+			sin((coordPx / wavelength) * TWO_PI + uPhase) * uAmplitude;
+		srcUv.y -= offsetPx / uResolution.y;
+	} else {
+		float coordPx = vUv.y * uResolution.y;
+		float offsetPx =
+			sin((coordPx / wavelength) * TWO_PI + uPhase) * uAmplitude;
+		srcUv.x -= offsetPx / uResolution.x;
+	}
+
+	fragColor = texture(uSource, srcUv);
+}
+`;
+
+// src/wave/wave-runtime.ts
+var { createWebGL2ContextError } = Internals;
+var compileShader = (gl, type, source) => {
+  const shader = gl.createShader(type);
+  if (!shader) {
+    throw new Error("Failed to create WebGL shader");
+  }
+  gl.shaderSource(shader, source);
+  gl.compileShader(shader);
+  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
+    const log = gl.getShaderInfoLog(shader);
+    gl.deleteShader(shader);
+    throw new Error(`Shader compile failed: ${log ?? "(no log)"}`);
+  }
+  return shader;
+};
+var linkProgram = (gl, vs, fs) => {
+  const program = gl.createProgram();
+  if (!program) {
+    throw new Error("Failed to create WebGL program");
+  }
+  gl.attachShader(program, vs);
+  gl.attachShader(program, fs);
+  gl.linkProgram(program);
+  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+    const log = gl.getProgramInfoLog(program);
+    gl.deleteProgram(program);
+    throw new Error(`Program link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var createProgram = (gl, vertexSource, fragmentSource) => {
+  const vs = compileShader(gl, gl.VERTEX_SHADER, vertexSource);
+  const fs = compileShader(gl, gl.FRAGMENT_SHADER, fragmentSource);
+  const program = linkProgram(gl, vs, fs);
+  gl.deleteShader(vs);
+  gl.deleteShader(fs);
+  return program;
+};
+var getWaveUniforms = (gl, program) => ({
+  uSource: gl.getUniformLocation(program, "uSource"),
+  uResolution: gl.getUniformLocation(program, "uResolution"),
+  uAmplitude: gl.getUniformLocation(program, "uAmplitude"),
+  uWavelength: gl.getUniformLocation(program, "uWavelength"),
+  uPhase: gl.getUniformLocation(program, "uPhase"),
+  uDirection: gl.getUniformLocation(program, "uDirection")
+});
+var createRgbaTexture = (gl) => {
+  const texture = gl.createTexture();
+  if (!texture) {
+    throw new Error("Failed to create WebGL texture");
+  }
+  gl.bindTexture(gl.TEXTURE_2D, texture);
+  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+  return texture;
+};
+var setupWave = (target) => {
+  const gl = target.getContext("webgl2", {
+    premultipliedAlpha: true,
+    alpha: true,
+    preserveDrawingBuffer: true
+  });
+  if (!gl) {
+    throw createWebGL2ContextError("wave effect");
+  }
+  gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
+  const program = createProgram(gl, WAVE_VS, WAVE_FS);
+  const vao = gl.createVertexArray();
+  if (!vao) {
+    throw new Error("Failed to create WebGL vertex array");
+  }
+  gl.bindVertexArray(vao);
+  const data = new Float32Array([
+    -1,
+    -1,
+    0,
+    0,
+    1,
+    -1,
+    1,
+    0,
+    -1,
+    1,
+    0,
+    1,
+    1,
+    1,
+    1,
+    1
+  ]);
+  const vbo = gl.createBuffer();
+  if (!vbo) {
+    throw new Error("Failed to create WebGL buffer");
+  }
+  gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
+  gl.bufferData(gl.ARRAY_BUFFER, data, gl.STATIC_DRAW);
+  gl.enableVertexAttribArray(0);
+  gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 16, 0);
+  gl.enableVertexAttribArray(1);
+  gl.vertexAttribPointer(1, 2, gl.FLOAT, false, 16, 8);
+  gl.bindVertexArray(null);
+  const textureSource = createRgbaTexture(gl);
+  return {
+    gl,
+    program,
+    vao,
+    vbo,
+    textureSource,
+    uniforms: getWaveUniforms(gl, program)
+  };
+};
+var cleanupWave = (state) => {
+  const { gl, program, vao, vbo, textureSource } = state;
+  gl.deleteTexture(textureSource);
+  gl.deleteBuffer(vbo);
+  gl.deleteProgram(program);
+  gl.deleteVertexArray(vao);
+};
+var drawFullscreenQuad = (state) => {
+  const { gl, vao } = state;
+  gl.bindVertexArray(vao);
+  gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+  gl.bindVertexArray(null);
+};
+var applyWave = ({
+  state,
+  source,
+  width,
+  height,
+  amplitude,
+  wavelength,
+  phase,
+  direction
+}) => {
+  const { gl, program, textureSource, uniforms } = state;
+  gl.viewport(0, 0, width, height);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+  gl.clearColor(0, 0, 0, 0);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  gl.useProgram(program);
+  if (uniforms.uSource)
+    gl.uniform1i(uniforms.uSource, 0);
+  if (uniforms.uResolution)
+    gl.uniform2f(uniforms.uResolution, width, height);
+  if (uniforms.uAmplitude)
+    gl.uniform1f(uniforms.uAmplitude, amplitude);
+  if (uniforms.uWavelength)
+    gl.uniform1f(uniforms.uWavelength, wavelength);
+  if (uniforms.uPhase)
+    gl.uniform1f(uniforms.uPhase, phase);
+  if (uniforms.uDirection)
+    gl.uniform1i(uniforms.uDirection, direction === "horizontal" ? 0 : 1);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  drawFullscreenQuad(state);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+  gl.useProgram(null);
+};
+
+// src/wave/index.ts
+var { createEffect } = Internals2;
 var waveSchema = {
+  phase: {
+    type: "number",
+    default: 0,
+    description: "Phase"
+  },
+  direction: {
+    type: "enum",
+    variants: {
+      horizontal: {},
+      vertical: {}
+    },
+    default: "horizontal",
+    description: "Direction"
+  },
   amplitude: {
     type: "number",
     min: 0,
@@ -32,64 +264,62 @@ var waveSchema = {
     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) => ({
+  phase: p.phase ?? 0,
+  direction: p.direction ?? "horizontal",
   amplitude: p.amplitude ?? 60,
-  wavelength: p.wavelength ?? 240,
-  evolution: p.evolution ?? 0,
-  sliceWidth: p.sliceWidth ?? 4,
-  background: p.background ?? "transparent"
+  wavelength: p.wavelength ?? 240
 });
+var assertOptionalFiniteNumber = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredFiniteNumber(value, name);
+};
+var validateWaveParams = (params) => {
+  assertEffectParamsObject(params, "Wave");
+  assertOptionalFiniteNumber(params.phase, "phase");
+  assertOptionalFiniteNumber(params.amplitude, "amplitude");
+  assertOptionalFiniteNumber(params.wavelength, "wavelength");
+  if (params.direction !== undefined && params.direction !== "horizontal" && params.direction !== "vertical") {
+    throw new TypeError(`"direction" must be "horizontal" or "vertical", but got ${JSON.stringify(params.direction)}`);
+  }
+  const resolved = resolve(params);
+  if (resolved.amplitude < 0) {
+    throw new TypeError(`"amplitude" must be >= 0, but got ${JSON.stringify(resolved.amplitude)}`);
+  }
+  if (resolved.wavelength <= 0) {
+    throw new TypeError(`"wavelength" must be > 0, but got ${JSON.stringify(resolved.wavelength)}`);
+  }
+};
 var wave = createEffect({
   type: "remotion/wave",
   label: "Wave",
-  backend: "2d",
+  backend: "webgl2",
   calculateKey: (params) => {
     const r = resolve(params);
-    return `wave-${r.amplitude}-${r.wavelength}-${r.evolution}-${r.sliceWidth}-${r.background}`;
+    return `wave-${r.phase}-${r.direction}-${r.amplitude}-${r.wavelength}`;
   },
-  setup: () => null,
-  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.");
-    }
+  setup: (target) => setupWave(target),
+  apply: ({ source, width, height, params, state }) => {
     const r = resolve(params);
-    ctx.clearRect(0, 0, width, height);
-    if (r.background !== "transparent") {
-      ctx.fillStyle = r.background;
-      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 + r.evolution) * r.amplitude;
-      ctx.drawImage(source, x, 0, r.sliceWidth, height, x, offset, r.sliceWidth, height);
-    }
-  },
-  cleanup: () => {
-    return;
+    applyWave({
+      state,
+      source,
+      width,
+      height,
+      amplitude: r.amplitude,
+      wavelength: r.wavelength,
+      phase: r.phase,
+      direction: r.direction
+    });
   },
-  schema: waveSchema
+  cleanup: (state) => cleanupWave(state),
+  schema: waveSchema,
+  validateParams: validateWaveParams
 });
 export {
-  waveSchema,
   wave
 };

package/dist/index.d.ts

@@ -1 +1,3 @@
-export {};
+export { EffectInternals } from './effect-internals.js';
+export { halftoneSchema, type HalftoneParams } from './halftone.js';
+export { tintSchema, type TintParams } from './tint.js';

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: {

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/index.d.ts

@@ -0,0 +1,12 @@
+export type WaveDirection = 'horizontal' | 'vertical';
+export type WaveParams = {
+    /** Phase offset in radians. */
+    readonly phase?: number;
+    /** Wave propagation axis. Defaults to `horizontal`. */
+    readonly direction?: WaveDirection;
+    readonly amplitude?: number;
+    readonly wavelength?: number;
+};
+export declare const wave: (params?: (WaveParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/wave/wave-runtime.d.ts

@@ -0,0 +1,29 @@
+export type WaveState = {
+    gl: WebGL2RenderingContext;
+    program: WebGLProgram;
+    vao: WebGLVertexArrayObject;
+    vbo: WebGLBuffer;
+    textureSource: WebGLTexture;
+    uniforms: {
+        uSource: WebGLUniformLocation | null;
+        uResolution: WebGLUniformLocation | null;
+        uAmplitude: WebGLUniformLocation | null;
+        uWavelength: WebGLUniformLocation | null;
+        uPhase: WebGLUniformLocation | null;
+        uDirection: WebGLUniformLocation | null;
+    };
+};
+export declare const setupWave: (target: HTMLCanvasElement) => WaveState;
+export declare const cleanupWave: (state: WaveState) => void;
+type ApplyWaveParams = {
+    readonly state: WaveState;
+    readonly source: CanvasImageSource;
+    readonly width: number;
+    readonly height: number;
+    readonly amplitude: number;
+    readonly wavelength: number;
+    readonly phase: number;
+    readonly direction: 'horizontal' | 'vertical';
+};
+export declare const applyWave: ({ state, source, width, height, amplitude, wavelength, phase, direction, }: ApplyWaveParams) => void;
+export {};

package/dist/wave/wave-shaders.d.ts

@@ -0,0 +1,2 @@
+export declare const WAVE_VS = "#version 300 es\nlayout(location = 0) in vec2 aPos;\nlayout(location = 1) in vec2 aUv;\nout vec2 vUv;\nvoid main() {\n\tvUv = aUv;\n\tgl_Position = vec4(aPos, 0.0, 1.0);\n}\n";
+export declare const WAVE_FS = "#version 300 es\nprecision highp float;\nin vec2 vUv;\nout vec4 fragColor;\n\nuniform sampler2D uSource;\nuniform vec2 uResolution;\nuniform float uAmplitude;\nuniform float uWavelength;\nuniform float uPhase;\nuniform int uDirection;\n\nconst float TWO_PI = 6.28318530718;\n\nvoid main() {\n\tfloat wavelength = max(uWavelength, 0.001);\n\tvec2 srcUv = vUv;\n\n\tif (uDirection == 0) {\n\t\tfloat coordPx = vUv.x * uResolution.x;\n\t\tfloat offsetPx =\n\t\t\tsin((coordPx / wavelength) * TWO_PI + uPhase) * uAmplitude;\n\t\tsrcUv.y -= offsetPx / uResolution.y;\n\t} else {\n\t\tfloat coordPx = vUv.y * uResolution.y;\n\t\tfloat offsetPx =\n\t\t\tsin((coordPx / wavelength) * TWO_PI + uPhase) * uAmplitude;\n\t\tsrcUv.x -= offsetPx / uResolution.x;\n\t}\n\n\tfragColor = texture(uSource, srcUv);\n}\n";

package/dist/wave.d.ts

@@ -1,46 +1 @@
-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 evolution?: number;
-    readonly sliceWidth?: number;
-    readonly background?: string;
-};
-export declare const wave: (params?: (WaveParams & {
-    readonly disabled?: boolean | undefined;
-}) | undefined) => import("remotion").EffectDescriptor<unknown>;
+export { wave, type WaveDirection, type WaveParams } from './wave/index.js';

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@remotion/effects",
-	"version": "4.0.463",
-	"description": "Experimental presets for Remotion canvas effect hooks",
+	"version": "4.0.465",
+	"description": "Effects that can be applied to Remotion-based canvas components",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"module": "dist/esm/index.mjs",
@@ -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.463"
+		"remotion": "4.0.465"
 	},
 	"exports": {
 		".": {
@@ -31,46 +32,31 @@
 			"module": "./dist/esm/index.mjs",
 			"import": "./dist/esm/index.mjs"
 		},
-		"./halftone": {
-			"types": "./dist/halftone.d.ts",
-			"module": "./dist/esm/halftone.mjs",
-			"import": "./dist/esm/halftone.mjs"
-		},
-		"./tint": {
-			"types": "./dist/tint.d.ts",
-			"module": "./dist/esm/tint.mjs",
-			"import": "./dist/esm/tint.mjs"
+		"./blur": {
+			"types": "./dist/blur.d.ts",
+			"module": "./dist/esm/blur.mjs",
+			"import": "./dist/esm/blur.mjs"
 		},
 		"./wave": {
 			"types": "./dist/wave.d.ts",
 			"module": "./dist/esm/wave.mjs",
 			"import": "./dist/esm/wave.mjs"
 		},
-		"./blur": {
-			"types": "./dist/entrypoints/blur.d.ts",
-			"module": "./dist/esm/blur.mjs",
-			"import": "./dist/esm/blur.mjs"
-		},
 		"./package.json": "./package.json"
 	},
 	"typesVersions": {
 		">=1.0": {
-			"halftone": [
-				"dist/halftone.d.ts"
-			],
-			"tint": [
-				"dist/tint.d.ts"
+			"blur": [
+				"dist/blur.d.ts"
 			],
 			"wave": [
 				"dist/wave.d.ts"
-			],
-			"blur": [
-				"dist/entrypoints/blur.d.ts"
 			]
 		}
 	},
+	"homepage": "https://www.remotion.dev/docs/effects/api",
 	"devDependencies": {
-		"@remotion/eslint-config-internal": "4.0.463",
+		"@remotion/eslint-config-internal": "4.0.465",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},