@remotion/effects 4.0.464 → 4.0.465

package/README.md

@@ -1,7 +1,18 @@
 # @remotion/effects
 
-Experimental presets for Remotion canvas effect hooks
+Effects that can be applied to Remotion-based canvas components
+
+[![NPM Downloads](https://img.shields.io/npm/dm/@remotion/effects.svg?style=flat&color=black&label=Downloads)](https://npmcharts.com/compare/@remotion/effects?minimal=true)
+
+## Installation
+
+```bash
+npm install @remotion/effects --save-exact
+```
+
+When installing a Remotion package, make sure to align the version of all `remotion` and `@remotion/*` packages to the same version.
+Remove the `^` character from the version number to use the exact version.
 
 ## Usage
 
-This is an internal package and has no documentation.
+See the [documentation](https://www.remotion.dev/docs/effects/api) for more information.

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

@@ -26,6 +26,9 @@ type ApplyBlurParams = {
     readonly width: number;
     readonly height: number;
     readonly radius: number;
+    readonly horizontal: boolean;
+    readonly vertical: boolean;
+    readonly flipSourceY: boolean;
 };
-export declare const applyBlur: ({ state, source, width, height, radius, }: ApplyBlurParams) => void;
+export declare const applyBlur: ({ state, source, width, height, radius, horizontal, vertical, flipSourceY, }: ApplyBlurParams) => void;
 export {};

package/dist/blur/index.d.ts

@@ -1,5 +1,9 @@
 export type BlurParams = {
     readonly radius: number;
+    /** Apply blur along the horizontal axis. Defaults to `true`. */
+    readonly horizontal?: boolean;
+    /** Apply blur along the vertical axis. Defaults to `true`. */
+    readonly vertical?: boolean;
 };
 export declare const blur: (params: BlurParams & {
     readonly disabled?: boolean | undefined;

package/dist/blur.d.ts

@@ -0,0 +1 @@
+export { blur, type BlurParams } from './blur/index.js';

package/dist/effect-internals.d.ts

@@ -0,0 +1,8 @@
+export declare const EffectInternals: {
+    readonly halftone: (params?: (import("./halftone.js").HalftoneParams & {
+        readonly disabled?: boolean | undefined;
+    }) | undefined) => import("remotion").EffectDescriptor<unknown>;
+    readonly tint: (params: import("./tint.js").TintParams & {
+        readonly disabled?: boolean | undefined;
+    }) => import("remotion").EffectDescriptor<unknown>;
+};

package/dist/esm/blur.mjs

@@ -1,19 +1,4 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-
 // src/blur/index.ts
-var exports_blur = {};
-__export(exports_blur, {
-  blur: () => blur
-});
 import { Internals as Internals2 } from "remotion";
 
 // src/validate-effect-param.ts
@@ -155,7 +140,6 @@ var setupBlur = (target) => {
     throw createWebGL2ContextError("blur effect");
   }
   gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
-  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
   const programHorizontal = createProgram(gl, BLUR_VS, BLUR_FS_HORIZONTAL);
   const programVertical = createProgram(gl, BLUR_VS, BLUR_FS_VERTICAL);
   const vao = gl.createVertexArray();
@@ -262,12 +246,31 @@ var drawFullscreenQuad = (state) => {
   gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
   gl.bindVertexArray(null);
 };
+var uploadBlurSource = ({
+  gl,
+  textureSource,
+  source,
+  textureIntermediate,
+  width,
+  height,
+  flipSourceY
+}) => {
+  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, flipSourceY);
+  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, textureIntermediate);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+};
 var applyBlur = ({
   state,
   source,
   width,
   height,
-  radius
+  radius,
+  horizontal,
+  vertical,
+  flipSourceY
 }) => {
   const {
     gl,
@@ -278,32 +281,72 @@ var applyBlur = ({
     framebuffer
   } = 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, textureIntermediate);
-  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
-  gl.bindTexture(gl.TEXTURE_2D, null);
-  gl.clearColor(0, 0, 0, 0);
-  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
-  gl.clear(gl.COLOR_BUFFER_BIT);
-  gl.activeTexture(gl.TEXTURE0);
-  gl.bindTexture(gl.TEXTURE_2D, textureSource);
-  gl.useProgram(programHorizontal);
-  setBlurUniforms({
+  uploadBlurSource({
     gl,
-    uniforms: state.horizontal,
-    radius,
+    textureSource,
+    source,
+    textureIntermediate,
     width,
-    height
+    height,
+    flipSourceY
   });
-  drawFullscreenQuad(state);
+  gl.clearColor(0, 0, 0, 0);
+  if (!horizontal && !vertical) {
+    gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+    gl.clear(gl.COLOR_BUFFER_BIT);
+    gl.activeTexture(gl.TEXTURE0);
+    gl.bindTexture(gl.TEXTURE_2D, textureSource);
+    gl.useProgram(programVertical);
+    setBlurUniforms({
+      gl,
+      uniforms: state.vertical,
+      radius: 0,
+      width,
+      height
+    });
+    drawFullscreenQuad(state);
+    gl.bindTexture(gl.TEXTURE_2D, null);
+    gl.useProgram(null);
+    return;
+  }
+  if (horizontal && vertical) {
+    gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+    gl.clear(gl.COLOR_BUFFER_BIT);
+    gl.activeTexture(gl.TEXTURE0);
+    gl.bindTexture(gl.TEXTURE_2D, textureSource);
+    gl.useProgram(programHorizontal);
+    setBlurUniforms({
+      gl,
+      uniforms: state.horizontal,
+      radius,
+      width,
+      height
+    });
+    drawFullscreenQuad(state);
+    gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+    gl.clear(gl.COLOR_BUFFER_BIT);
+    gl.bindTexture(gl.TEXTURE_2D, textureIntermediate);
+    gl.useProgram(programVertical);
+    setBlurUniforms({
+      gl,
+      uniforms: state.vertical,
+      radius,
+      width,
+      height
+    });
+    drawFullscreenQuad(state);
+    gl.bindTexture(gl.TEXTURE_2D, null);
+    gl.useProgram(null);
+    return;
+  }
   gl.bindFramebuffer(gl.FRAMEBUFFER, null);
   gl.clear(gl.COLOR_BUFFER_BIT);
-  gl.bindTexture(gl.TEXTURE_2D, textureIntermediate);
-  gl.useProgram(programVertical);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  gl.useProgram(horizontal ? programHorizontal : programVertical);
   setBlurUniforms({
     gl,
-    uniforms: state.vertical,
+    uniforms: horizontal ? state.horizontal : state.vertical,
     radius,
     width,
     height
@@ -315,6 +358,11 @@ var applyBlur = ({
 
 // src/blur/index.ts
 var { createEffect } = Internals2;
+var resolveBlurParams = (params) => ({
+  radius: params.radius,
+  horizontal: params.horizontal ?? true,
+  vertical: params.vertical ?? true
+});
 var blurSchema = {
   radius: {
     type: "number",
@@ -322,7 +370,17 @@ var blurSchema = {
     max: 100,
     step: 1,
     default: undefined,
-    description: "Blur radius"
+    description: "Blur"
+  },
+  horizontal: {
+    type: "boolean",
+    default: true,
+    description: "Horizontal"
+  },
+  vertical: {
+    type: "boolean",
+    default: true,
+    description: "Vertical"
   }
 };
 var validateBlurParams = (params) => {
@@ -333,24 +391,28 @@ var blur = createEffect({
   type: "remotion/blur",
   label: "Blur",
   backend: "webgl2",
-  calculateKey: (params) => String(params.radius),
+  calculateKey: (params) => {
+    const r = resolveBlurParams(params);
+    return `${r.radius}-${r.horizontal ? 1 : 0}-${r.vertical ? 1 : 0}`;
+  },
   setup: (target) => setupBlur(target),
-  apply: ({ source, width, height, params, state }) => {
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolveBlurParams(params);
     applyBlur({
       state,
       source,
       width,
       height,
-      radius: params.radius
+      radius: r.radius,
+      horizontal: r.horizontal,
+      vertical: r.vertical,
+      flipSourceY
     });
   },
   cleanup: (state) => cleanupBlur(state),
   schema: blurSchema,
   validateParams: validateBlurParams
 });
-
-// src/entrypoints/blur.ts
-var { blur: blur2 } = exports_blur;
 export {
-  blur2 as blur
+  blur
 };

package/dist/esm/index.mjs

@@ -1 +1,428 @@
-export {};
+// src/halftone.ts
+import { Internals } from "remotion";
+var { createEffect, createWebGL2ContextError } = Internals;
+var SHADE_OUTSIDE_DOT_SCALE = 0.5;
+var halftoneSchema = {
+  dotSize: {
+    type: "number",
+    min: 1,
+    max: 200,
+    step: 1,
+    default: 20,
+    description: "Dot size"
+  },
+  dotSpacing: {
+    type: "number",
+    min: 1,
+    max: 200,
+    step: 1,
+    default: 20,
+    description: "Dot spacing"
+  },
+  rotation: {
+    type: "number",
+    min: -180,
+    max: 180,
+    step: 1,
+    default: 0,
+    description: "Rotation"
+  },
+  offsetX: {
+    type: "number",
+    step: 1,
+    default: 0,
+    description: "Offset X"
+  },
+  offsetY: {
+    type: "number",
+    step: 1,
+    default: 0,
+    description: "Offset Y"
+  },
+  shape: {
+    type: "enum",
+    variants: {
+      circle: {},
+      square: {},
+      line: {}
+    },
+    default: "circle",
+    description: "Shape"
+  }
+};
+var resolve = (p) => ({
+  shape: p.shape ?? "circle",
+  dotSize: p.dotSize ?? 20,
+  dotSpacing: p.dotSpacing ?? p.dotSize ?? 20,
+  rotation: p.rotation ?? 0,
+  offsetX: p.offsetX ?? 0,
+  offsetY: p.offsetY ?? 0,
+  sampling: p.sampling ?? "bilinear",
+  color: p.color ?? "black",
+  shadeOutside: p.shadeOutside ?? false
+});
+var HALFTONE_VS = `#version 300 es
+in vec2 aPos;
+in vec2 aUv;
+out vec2 vUv;
+void main() {
+	vUv = aUv;
+	gl_Position = vec4(aPos, 0.0, 1.0);
+}
+`;
+var HALFTONE_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform float uDotSize;
+uniform float uDotSpacing;
+uniform float uRotation;
+uniform vec2 uOffset;
+uniform vec4 uColor;
+uniform int uShape;
+uniform bool uShadeOutside;
+
+const float SHADE_OUTSIDE_SCALE = ${SHADE_OUTSIDE_DOT_SCALE.toFixed(1)};
+
+void main() {
+	vec2 fragPos = vUv * uResolution;
+	vec2 center = uResolution * 0.5;
+
+	vec2 d = fragPos - center;
+	float cosR = cos(uRotation);
+	float sinR = sin(uRotation);
+
+	vec2 gridPos = vec2(
+		d.x * cosR + d.y * sinR,
+		-d.x * sinR + d.y * cosR
+	);
+
+	float spacing = max(uDotSpacing, 0.001);
+	vec2 cellIndex = floor((gridPos + uOffset) / spacing + 0.5);
+	vec2 gridCenter = cellIndex * spacing - uOffset;
+
+	vec2 canvasPos = center + vec2(
+		gridCenter.x * cosR - gridCenter.y * sinR,
+		gridCenter.x * sinR + gridCenter.y * cosR
+	);
+
+	vec2 sampleUv = clamp(canvasPos / uResolution, vec2(0.0), vec2(1.0));
+	vec4 texColor = texture(uSource, sampleUv);
+
+	float alpha = texColor.a;
+	vec3 rgb = alpha > 0.001 ? texColor.rgb / alpha : vec3(0.0);
+	float lum = dot(rgb, vec3(0.299, 0.587, 0.114));
+
+	float lumDefault = lum * alpha + (1.0 - alpha);
+	float dotScale = uShadeOutside
+		? (1.0 - alpha) * SHADE_OUTSIDE_SCALE
+		: 1.0 - lumDefault;
+
+	if (dotScale <= 0.01) {
+		fragColor = vec4(0.0);
+		return;
+	}
+
+	vec2 diff = gridPos - gridCenter;
+	float halfSize = uDotSize * 0.5;
+	float coverage = 0.0;
+
+	if (uShape == 0) {
+		float radius = halfSize * dotScale;
+		float dist = length(diff);
+		coverage = 1.0 - smoothstep(radius - 0.75, radius + 0.75, dist);
+	} else if (uShape == 1) {
+		float s = uDotSize * dotScale * 0.5;
+		coverage = (1.0 - smoothstep(s - 0.5, s + 0.5, abs(diff.x)))
+				 * (1.0 - smoothstep(s - 0.5, s + 0.5, abs(diff.y)));
+	} else {
+		float lineHalf = uDotSize * dotScale * 0.5;
+		coverage = (1.0 - smoothstep(halfSize - 0.5, halfSize + 0.5, abs(diff.x)))
+				 * (1.0 - smoothstep(lineHalf - 0.5, lineHalf + 0.5, abs(diff.y)));
+	}
+
+	fragColor = uColor * coverage;
+}
+`;
+var SHAPE_INDEX = {
+  circle: 0,
+  square: 1,
+  line: 2
+};
+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(`Halftone 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(`Halftone program link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0] / 255, data[1] / 255, data[2] / 255, data[3] / 255];
+};
+var halftone = createEffect({
+  type: "remotion/halftone",
+  label: "Halftone",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    return `halftone-${r.shape}-${r.dotSize}-${r.dotSpacing}-${r.rotation}-${r.offsetX}-${r.offsetY}-${r.sampling}-${r.color}-${r.shadeOutside ? 1 : 0}`;
+  },
+  setup: (target) => {
+    const gl = target.getContext("webgl2", {
+      premultipliedAlpha: true,
+      alpha: true,
+      preserveDrawingBuffer: true
+    });
+    if (!gl) {
+      throw createWebGL2ContextError("halftone effect");
+    }
+    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+    const vs = compileShader(gl, gl.VERTEX_SHADER, HALFTONE_VS);
+    const fs = compileShader(gl, gl.FRAGMENT_SHADER, HALFTONE_FS);
+    const program = linkProgram(gl, vs, fs);
+    gl.deleteShader(vs);
+    gl.deleteShader(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);
+    const aPos = gl.getAttribLocation(program, "aPos");
+    const aUv = gl.getAttribLocation(program, "aUv");
+    gl.enableVertexAttribArray(aPos);
+    gl.vertexAttribPointer(aPos, 2, gl.FLOAT, false, 16, 0);
+    gl.enableVertexAttribArray(aUv);
+    gl.vertexAttribPointer(aUv, 2, gl.FLOAT, false, 16, 8);
+    gl.bindVertexArray(null);
+    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_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);
+    const colorCanvas = document.createElement("canvas");
+    colorCanvas.width = 1;
+    colorCanvas.height = 1;
+    const colorCtx = colorCanvas.getContext("2d", { willReadFrequently: true });
+    if (!colorCtx) {
+      throw new Error("Failed to acquire 2D context for color parsing");
+    }
+    return {
+      gl,
+      program,
+      vao,
+      vbo,
+      texture,
+      uSource: gl.getUniformLocation(program, "uSource"),
+      uResolution: gl.getUniformLocation(program, "uResolution"),
+      uDotSize: gl.getUniformLocation(program, "uDotSize"),
+      uDotSpacing: gl.getUniformLocation(program, "uDotSpacing"),
+      uRotation: gl.getUniformLocation(program, "uRotation"),
+      uOffset: gl.getUniformLocation(program, "uOffset"),
+      uColor: gl.getUniformLocation(program, "uColor"),
+      uShape: gl.getUniformLocation(program, "uShape"),
+      uShadeOutside: gl.getUniformLocation(program, "uShadeOutside"),
+      colorCtx,
+      cachedColorStr: "",
+      cachedColorRgba: [0, 0, 0, 1]
+    };
+  },
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolve(params);
+    const { gl, program, vao, texture } = state;
+    if (state.cachedColorStr !== r.color) {
+      state.cachedColorStr = r.color;
+      state.cachedColorRgba = parseColorRgba(state.colorCtx, r.color);
+    }
+    const [cr, cg, cb, ca] = state.cachedColorRgba;
+    const filter = r.sampling === "nearest" ? gl.NEAREST : gl.LINEAR;
+    gl.viewport(0, 0, width, height);
+    gl.clearColor(0, 0, 0, 0);
+    gl.clear(gl.COLOR_BUFFER_BIT);
+    gl.useProgram(program);
+    gl.bindVertexArray(vao);
+    gl.activeTexture(gl.TEXTURE0);
+    gl.bindTexture(gl.TEXTURE_2D, texture);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, filter);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, filter);
+    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, flipSourceY);
+    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+    if (state.uSource)
+      gl.uniform1i(state.uSource, 0);
+    if (state.uResolution)
+      gl.uniform2f(state.uResolution, width, height);
+    if (state.uDotSize)
+      gl.uniform1f(state.uDotSize, r.dotSize);
+    if (state.uDotSpacing)
+      gl.uniform1f(state.uDotSpacing, r.dotSpacing);
+    if (state.uRotation)
+      gl.uniform1f(state.uRotation, r.rotation * Math.PI / 180);
+    if (state.uOffset)
+      gl.uniform2f(state.uOffset, r.offsetX, r.offsetY);
+    if (state.uColor)
+      gl.uniform4f(state.uColor, cr * ca, cg * ca, cb * ca, ca);
+    if (state.uShape)
+      gl.uniform1i(state.uShape, SHAPE_INDEX[r.shape]);
+    if (state.uShadeOutside)
+      gl.uniform1i(state.uShadeOutside, r.shadeOutside ? 1 : 0);
+    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+    gl.bindVertexArray(null);
+    gl.bindTexture(gl.TEXTURE_2D, null);
+    gl.useProgram(null);
+  },
+  cleanup: ({ gl, program, vao, vbo, texture }) => {
+    gl.deleteBuffer(vbo);
+    gl.deleteProgram(program);
+    gl.deleteVertexArray(vao);
+    gl.deleteTexture(texture);
+  },
+  schema: halftoneSchema,
+  validateParams: () => {}
+});
+
+// src/tint.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/tint.ts
+var { createEffect: createEffect2 } = Internals2;
+var DEFAULT_AMOUNT = 0.5;
+var tintSchema = {
+  color: {
+    type: "color",
+    default: undefined,
+    description: "Color"
+  },
+  amount: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_AMOUNT,
+    description: "Amount"
+  }
+};
+var resolve2 = (p) => ({
+  color: p.color,
+  amount: p.amount ?? DEFAULT_AMOUNT
+});
+var validateTintParams = (params) => {
+  assertEffectParamsObject(params, "Tint");
+  assertRequiredColor(params.color, "color");
+};
+var tint = createEffect2({
+  type: "remotion/tint",
+  label: "Tint",
+  backend: "2d",
+  calculateKey: (params) => {
+    const r = resolve2(params);
+    return `tint-${r.color}-${r.amount}`;
+  },
+  setup: () => null,
+  apply: ({ source, target, width, height, params }) => {
+    const ctx = target.getContext("2d");
+    if (!ctx) {
+      throw new Error("Failed to acquire 2D context for tint effect. The canvas may have been assigned a different context type.");
+    }
+    const r = resolve2(params);
+    const amount = Math.max(0, Math.min(1, r.amount));
+    ctx.clearRect(0, 0, width, height);
+    ctx.globalAlpha = 1;
+    ctx.globalCompositeOperation = "source-over";
+    ctx.drawImage(source, 0, 0, width, height);
+    ctx.globalAlpha = amount;
+    ctx.globalCompositeOperation = "source-atop";
+    ctx.fillStyle = r.color;
+    ctx.fillRect(0, 0, width, height);
+    ctx.globalAlpha = 1;
+    ctx.globalCompositeOperation = "source-over";
+  },
+  cleanup: () => {
+    return;
+  },
+  schema: tintSchema,
+  validateParams: validateTintParams
+});
+
+// src/effect-internals.ts
+var EffectInternals = {
+  halftone,
+  tint
+};
+export {
+  tintSchema,
+  halftoneSchema,
+  EffectInternals
+};

package/dist/esm/wave.mjs

@@ -1,18 +1,254 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
+// 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,
@@ -28,65 +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
+    });
   },
+  cleanup: (state) => cleanupWave(state),
   schema: waveSchema,
-  validateParams: () => {}
+  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/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.464",
-	"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",
@@ -24,7 +24,7 @@
 		"url": "https://github.com/remotion-dev/remotion/issues"
 	},
 	"dependencies": {
-		"remotion": "4.0.464"
+		"remotion": "4.0.465"
 	},
 	"exports": {
 		".": {
@@ -32,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.464",
+		"@remotion/eslint-config-internal": "4.0.465",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},