Skip to content

Code-first video & image, rendered natively on WebGPU.

audio capability

okanasl7ddb9d924c8a
diff --git a/.changeset/add-missing-node-effects.md b/.changeset/add-missing-node-effects.md
new file mode 100644
index 00000000..9c24d329
--- /dev/null
+++ b/.changeset/add-missing-node-effects.md
@@ -0,0 +1,5 @@
+---
+"framefields": patch
+---
+
+Register all remaining effect and audio DSP nodes with the effects generator and catalog, bundle them in the `framefields` SDK, and expose their strongly-typed classes, factories, and props for agents and composers.
diff --git a/examples/24_audio_capabilities/README.md b/examples/24_audio_capabilities/README.md
new file mode 100644
index 00000000..c9838628
--- /dev/null
+++ b/examples/24_audio_capabilities/README.md
@@ -0,0 +1,55 @@
+# Framefields Audio Capabilities Example (`24_audio_capabilities`)
+
+Demonstrates code-first WebGPU audio DSP and soundtrack composition in Framefields:
+1. **Step 1: Baseline / Initial Audio** — Unprocessed score soundtrack loaded with explicit timing (`durationFrames`, `volume`).
+2. **Step 2: Faded Audio** — WebGPU compute `AudioFade` DSP shader performing smooth envelope gain modulation (2.0s linear fade-in and 2.0s scurve fade-out).
+3. **Step 3: Faded + Reverb Audio** — Multi-stage WebGPU audio DSP pipeline chaining `AudioFade` directly into `AudioReverb` (room size 0.85, wet mix 0.6, stereo damping 0.2).
+
+Each stage is exported both as uncompressed **16-bit PCM WAV** audio and as high-quality **MP4 video** with synchronized audio.
+
+---
+
+## Quick Start
+
+```bash
+# Render all 3 audio steps (.wav) and encoded videos (.mp4)
+pnpm --filter @framefields/example-24-audio-capabilities render
+
+# Render only WAV audio files
+pnpm --filter @framefields/example-24-audio-capabilities render wav
+
+# Run automated tests
+pnpm --filter @framefields/example-24-audio-capabilities test
+
+# Typecheck
+pnpm --filter @framefields/example-24-audio-capabilities typecheck
+```
+
+---
+
+## Output Files
+
+When running `pnpm render`, files are written to `examples/24_audio_capabilities/output/`:
+- `output/step1_initial_audio.wav` & `output/step1_initial.mp4`
+- `output/step2_faded_audio.wav` & `output/step2_faded.mp4`
+- `output/step3_faded_reverb_audio.wav` & `output/step3_faded_reverb.mp4`
+
+---
+
+## Code Example
+
+```ts
+import { Composition, Layer, Effect } from "framefields";
+
+const comp = new Composition({ width: 1280, height: 720, fps: 30, duration: 6 });
+
+// Add audio soundtrack with chained DSP effects
+comp.addAudio(
+ Layer.audio("assets/score.mp3", { durationFrames: 180, volume: 1.0 })
+ .apply(Effect.audioFade({ fadeInDuration: 2.0, fadeOutDuration: 2.0 }))
+ .apply(Effect.audioReverb({ roomSize: 0.85, damping: 0.2, wet: 0.6, dry: 0.7 }))
+);
+
+// Render video with audio
+await comp.renderVideo("output/video.mp4");
+```
diff --git a/examples/24_audio_capabilities/package.json b/examples/24_audio_capabilities/package.json
new file mode 100644
index 00000000..b6b78a6e
--- /dev/null
+++ b/examples/24_audio_capabilities/package.json
@@ -0,0 +1,21 @@
+{
+ "name": "@framefields/example-24-audio-capabilities",
+ "version": "2.0.5",
+ "private": true,
+ "type": "module",
+ "scripts": {
+ "render": "tsx src/render.ts",
+ "test": "vitest run",
+ "typecheck": "tsc --noEmit -p ."
+ },
+ "dependencies": {
+ "framefields": "workspace:*"
+ },
+ "devDependencies": {
+ "@framefields/tsconfig": "workspace:*",
+ "@types/node": "^24.1.0",
+ "tsx": "^4.20.3",
+ "typescript": "^5.8.3",
+ "vitest": "^4.1.5"
+ }
+}
diff --git a/examples/24_audio_capabilities/src/audio-pipeline.ts b/examples/24_audio_capabilities/src/audio-pipeline.ts
new file mode 100644
index 00000000..15bd4921
--- /dev/null
+++ b/examples/24_audio_capabilities/src/audio-pipeline.ts
@@ -0,0 +1,171 @@
+import path from "node:path";
+import { Composition, Effect, Layer } from "framefields";
+
+export const FPS = 30;
+export const DURATION_SEC = 6;
+export const DURATION_FRAMES = DURATION_SEC * FPS; // 180 frames
+export const DURATION_MS = DURATION_SEC * 1000; // 6000 ms
+export const SAMPLE_RATE = 48000;
+export const W = 1280;
+export const H = 720;
+
+export const ASSETS_DIR = path.resolve(import.meta.dirname, "../assets");
+export const SCORE_PATH = path.join(ASSETS_DIR, "score.mp3");
+
+function createCard(title: string, subtitle: string, badge: string) {
+ return Layer.flex({
+ width: W,
+ height: H,
+ background: "#0d0f12",
+ dir: "column",
+ justify: "center",
+ align: "center",
+ padding: 60,
+ gap: 20,
+ children: [
+ Layer.box({
+ padding: 16,
+ background: "#1e232d",
+ borderRadius: 20,
+ children: [
+ Layer.text(badge, {
+ fontSize: 18,
+ fontWeight: 600,
+ fill: "#38bdf8",
+ letterSpacing: 2,
+ }),
+ ],
+ }),
+ Layer.text(title, {
+ fontSize: 56,
+ fontWeight: 700,
+ fill: "#f8fafc",
+ }),
+ Layer.text(subtitle, {
+ fontSize: 24,
+ fontWeight: 400,
+ fill: "#94a3b8",
+ }),
+ ],
+ });
+}
+
+/**
+ * Step 1: Baseline / Initial Audio.
+ * Pure unprocessed soundtrack loaded from asset file with explicit frame duration.
+ */
+export function buildStep1InitialAudio(): Composition {
+ const comp = new Composition({
+ width: W,
+ height: H,
+ fps: FPS,
+ durationMs: DURATION_MS,
+ backgroundColor: "#0d0f12",
+ });
+
+ comp.add(
+ createCard(
+ "Step 1: Initial Audio",
+ "Raw soundtrack at baseline gain without DSP modification",
+ "PASS-THROUGH",
+ ),
+ );
+
+ comp.addAudio(
+ Layer.audio(SCORE_PATH, {
+ id: "audio-step1-initial",
+ durationFrames: DURATION_FRAMES,
+ volume: 1.0,
+ }),
+ );
+
+ return comp;
+}
+
+/**
+ * Step 2: Faded Audio.
+ * Applies WebGPU AudioFade for a smooth 2.0s fade-in from silence and 2.0s fade-out.
+ */
+export function buildStep2FadedAudio(): Composition {
+ const comp = new Composition({
+ width: W,
+ height: H,
+ fps: FPS,
+ durationMs: DURATION_MS,
+ backgroundColor: "#0d0f12",
+ });
+
+ comp.add(
+ createCard(
+ "Step 2: Faded Audio",
+ "WebGPU AudioFade: 2.0s linear fade-in and 2.0s scurve fade-out",
+ "AUDIO FADE DSP",
+ ),
+ );
+
+ comp.addAudio(
+ Layer.audio(SCORE_PATH, {
+ id: "audio-step2-faded",
+ durationFrames: DURATION_FRAMES,
+ volume: 1.0,
+ }).apply(
+ Effect.audioFade({
+ fadeInDuration: 2.0,
+ fadeOutDuration: 2.0,
+ fadeInCurve: "linear",
+ fadeOutCurve: "scurve",
+ }),
+ ),
+ );
+
+ return comp;
+}
+
+/**
+ * Step 3: Faded Audio + Reverb.
+ * Chains AudioFade and AudioReverb onto the soundtrack on native WebGPU compute.
+ */
+export function buildStep3FadedReverbAudio(): Composition {
+ const comp = new Composition({
+ width: W,
+ height: H,
+ fps: FPS,
+ durationMs: DURATION_MS,
+ backgroundColor: "#0d0f12",
+ });
+
+ comp.add(
+ createCard(
+ "Step 3: Faded + Reverb",
+ "Chained DSP: AudioFade (2.0s ramps) → AudioReverb (room 0.85, wet 0.6)",
+ "MULTI-STAGE DSP",
+ ),
+ );
+
+ comp.addAudio(
+ Layer.audio(SCORE_PATH, {
+ id: "audio-step3-reverb",
+ durationFrames: DURATION_FRAMES,
+ volume: 1.0,
+ })
+ .apply(
+ Effect.audioFade({
+ fadeInDuration: 2.0,
+ fadeOutDuration: 2.0,
+ fadeInCurve: "linear",
+ fadeOutCurve: "scurve",
+ }),
+ )
+ .apply(
+ Effect.audioReverb({
+ roomSize: 0.85,
+ damping: 0.2,
+ wet: 0.6,
+ dry: 0.7,
+ width: 1.0,
+ }),
+ ),
+ );
+
+ return comp;
+}
diff --git a/examples/24_audio_capabilities/src/audio.test.ts b/examples/24_audio_capabilities/src/audio.test.ts
new file mode 100644
index 00000000..6d9011d2
--- /dev/null
+++ b/examples/24_audio_capabilities/src/audio.test.ts
@@ -0,0 +1,92 @@
+import { HeadlessMediaRenderer } from "framefields";
+import { describe, expect, it } from "vitest";
+import {
+ buildStep1InitialAudio,
+ buildStep2FadedAudio,
+ buildStep3FadedReverbAudio,
+ DURATION_FRAMES,
+ DURATION_MS,
+ FPS,
+ SAMPLE_RATE,
+} from "./audio-pipeline.js";
+import { pcmToWav } from "./wav.js";
+
+describe("Example 24: Audio Capabilities", () => {
+ it("compositions compile and export valid specs", () => {
+ const comp1 = buildStep1InitialAudio();
+ const comp2 = buildStep2FadedAudio();
+ const comp3 = buildStep3FadedReverbAudio();
+
+ expect(comp1.durationMs).toBe(DURATION_MS);
+ expect(comp2.durationMs).toBe(DURATION_MS);
+ expect(comp3.durationMs).toBe(DURATION_MS);
+
+ const spec1 = comp1.toSpec();
+ const spec2 = comp2.toSpec();
+ const spec3 = comp3.toSpec();
+
+ expect(spec1.layout.some((n) => n.kind === "media")).toBe(true);
+ expect(spec2.layout.some((n) => n.kind === "media")).toBe(true);
+ expect(spec3.layout.some((n) => n.kind === "media")).toBe(true);
+ });
+
+ it("renders audio PCM channels across all 3 steps", async () => {
+ const renderer = new HeadlessMediaRenderer();
+
+ const pcm1 = await renderer.renderAudio(
+ buildStep1InitialAudio().toVirtualMedia({ durationMs: DURATION_MS }),
+ { fps: FPS, sampleRate: SAMPLE_RATE },
+ );
+ const pcm2 = await renderer.renderAudio(
+ buildStep2FadedAudio().toVirtualMedia({ durationMs: DURATION_MS }),
+ { fps: FPS, sampleRate: SAMPLE_RATE },
+ );
+ const pcm3 = await renderer.renderAudio(
+ buildStep3FadedReverbAudio().toVirtualMedia({ durationMs: DURATION_MS }),
+ { fps: FPS, sampleRate: SAMPLE_RATE },
+ );
+
+ const expectedSamples = Math.ceil((DURATION_FRAMES / FPS) * SAMPLE_RATE);
+ expect(pcm1.channels.length).toBe(2);
+ expect(pcm2.channels.length).toBe(2);
+ expect(pcm3.channels.length).toBe(2);
+ expect(pcm1.channels[0].length).toBe(expectedSamples);
+ expect(pcm2.channels[0].length).toBe(expectedSamples);
+ expect(pcm3.channels[0].length).toBe(expectedSamples);
+
+ // Encode WAV and verify RIFF structure
+ const wav = pcmToWav(pcm1.channels, SAMPLE_RATE);
+ expect(wav.subarray(0, 4).toString("ascii")).toBe("RIFF");
+ expect(wav.subarray(8, 12).toString("ascii")).toBe("WAVE");
+ expect(wav.subarray(12, 16).toString("ascii")).toBe("fmt ");
+ expect(wav.subarray(36, 40).toString("ascii")).toBe("data");
+
+ // Calculate RMS in early fade-in window (0.0s to 1.5s)
+ const earlyCount = Math.round(1.5 * SAMPLE_RATE);
+ let sum1 = 0;
+ let sum2 = 0;
+ for (let i = 0; i < earlyCount; i++) {
+ sum1 += (pcm1.channels[0][i] ?? 0) ** 2;
+ sum2 += (pcm2.channels[0][i] ?? 0) ** 2;
+ }
+ const rms1 = Math.sqrt(sum1 / earlyCount);
+ const rms2 = Math.sqrt(sum2 / earlyCount);
+
+ // Fade-in should attenuate the early window
+ expect(rms2).toBeLessThan(rms1);
+
+ // Step 3 (Reverb) should differ from Step 2 in the sustain/tail region
+ let diffCount = 0;
+ const midStart = Math.round(2.0 * SAMPLE_RATE);
+ const midEnd = Math.round(4.0 * SAMPLE_RATE);
+ for (let i = midStart; i < midEnd; i++) {
+ if (
+ Math.abs((pcm3.channels[0][i] ?? 0) - (pcm2.channels[0][i] ?? 0)) >
+ 0.001
+ ) {
+ diffCount++;
+ }
+ }
+ expect(diffCount).toBeGreaterThan(0);
+ });
+});
diff --git a/examples/24_audio_capabilities/src/render.ts b/examples/24_audio_capabilities/src/render.ts
new file mode 100644
index 00000000..794e0c8c
--- /dev/null
+++ b/examples/24_audio_capabilities/src/render.ts
@@ -0,0 +1,147 @@
+/**
+ * Step-by-step audio capability export script:
+ *
+ * 1. Step 1: Baseline / Initial Audio (score.mp3 without effects)
+ * 2. Step 2: Faded Audio (with WebGPU AudioFade effect)
+ * 3. Step 3: Faded + Reverb Audio (AudioFade + AudioReverb DSP chain)
+ *
+ * Exports both uncompressed 16-bit WAV PCM files and encoded MP4 videos.
+ *
+ * Usage:
+ * pnpm render # Renders all 3 audio steps (.wav) and videos (.mp4)
+ * pnpm render wav # Renders only WAV audio files
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { HeadlessMediaRenderer } from "framefields";
+import {
+ buildStep1InitialAudio,
+ buildStep2FadedAudio,
+ buildStep3FadedReverbAudio,
+ DURATION_FRAMES,
+ DURATION_MS,
+ DURATION_SEC,
+ FPS,
+ SAMPLE_RATE,
+} from "./audio-pipeline.js";
+import { pcmToWav } from "./wav.js";
+
+const OUTPUT_DIR = path.resolve(import.meta.dirname, "../output");
+const mode = process.argv[2] ?? "all";
+
+function calculateRms(
+ channel: Float32Array,
+ startSample: number,
+ endSample: number,
+): number {
+ let sum = 0;
+ const count = Math.max(1, endSample - startSample);
+ for (let i = startSample; i < endSample; i++) {
+ const val = channel[i] ?? 0;
+ sum += val * val;
+ }
+ return Math.sqrt(sum / count);
+}
+
+async function main() {
+ await fs.mkdir(OUTPUT_DIR, { recursive: true });
+ const renderer = new HeadlessMediaRenderer();
+
+ const steps = [
+ {
+ name: "Step 1: Initial Audio",
+ slug: "step1_initial",
+ builder: buildStep1InitialAudio,
+ description: "Clean baseline soundtrack without DSP modification",
+ },
+ {
+ name: "Step 2: Faded Audio",
+ slug: "step2_faded",
+ builder: buildStep2FadedAudio,
+ description: "WebGPU AudioFade (2.0s fade-in, 2.0s fade-out)",
+ },
+ {
+ name: "Step 3: Faded + Reverb Audio",
+ slug: "step3_faded_reverb",
+ builder: buildStep3FadedReverbAudio,
+ description:
+ "Multi-stage chain: AudioFade → AudioReverb (room 0.85, wet 0.6)",
+ },
+ ];
+
+ console.log("=========================================================");
+ console.log(" Framefields Audio Capabilities Step-by-Step Renderer");
+ console.log(
+ ` Duration: ${DURATION_SEC}s (${DURATION_FRAMES} frames @ ${FPS} fps)`,
+ );
+ console.log(` Sample rate: ${SAMPLE_RATE} Hz`);
+ console.log("=========================================================\n");
+
+ for (const step of steps) {
+ console.log(`[Processing] ${step.name}`);
+ console.log(` Description: ${step.description}`);
+ const comp = step.builder();
+
+ // 1. Render Audio PCM via Headless Media Renderer
+ const pcmStart = Date.now();
+ const pcm = await renderer.renderAudio(
+ comp.toVirtualMedia({ durationMs: DURATION_MS }),
+ { fps: FPS, sampleRate: SAMPLE_RATE },
+ );
+ const pcmDuration = ((Date.now() - pcmStart) / 1000).toFixed(2);
+
+ // 2. Export 16-bit WAV
+ const wavBuffer = pcmToWav(pcm.channels, SAMPLE_RATE);
+ const wavPath = path.join(OUTPUT_DIR, `${step.slug}_audio.wav`);
+ await fs.writeFile(wavPath, wavBuffer);
+
+ // Compute RMS metrics across key timeline windows
+ const ch0 = pcm.channels[0] ?? new Float32Array(0);
+ const fadeInRms = calculateRms(ch0, 0, Math.round(1.5 * SAMPLE_RATE));
+ const sustainRms = calculateRms(
+ ch0,
+ Math.round(2.5 * SAMPLE_RATE),
+ Math.round(3.5 * SAMPLE_RATE),
+ );
+ const fadeOutRms = calculateRms(
+ ch0,
+ Math.round(4.5 * SAMPLE_RATE),
+ Math.round(6.0 * SAMPLE_RATE),
+ );
+
+ console.log(
+ ` ✓ WAV exported: ${path.relative(process.cwd(), wavPath)} (${wavBuffer.length} bytes in ${pcmDuration}s)`,
+ );
+ console.log(
+ ` • Fade-in window (0.0s - 1.5s) RMS: ${fadeInRms.toFixed(5)}`,
+ );
+ console.log(
+ ` • Sustain window (2.5s - 3.5s) RMS: ${sustainRms.toFixed(5)}`,
+ );
+ console.log(
+ ` • Fade-out window (4.5s - 6.0s) RMS: ${fadeOutRms.toFixed(5)}`,
+ );
+
+ // 3. Export accompanying MP4 video with audio muxed
+ if (mode !== "wav") {
+ const mp4Path = path.join(OUTPUT_DIR, `${step.slug}.mp4`);
+ const videoStart = Date.now();
+ await comp.renderVideo(mp4Path);
+ const videoDuration = ((Date.now() - videoStart) / 1000).toFixed(2);
+ const stat = await fs.stat(mp4Path);
+ console.log(
+ ` ✓ MP4 exported: ${path.relative(process.cwd(), mp4Path)} (${stat.size} bytes in ${videoDuration}s)`,
+ );
+ }
+
+ console.log();
+ }
+
+ console.log("All audio steps successfully exported to output/ directory.");
+ process.exit(0);
+}
+
+main().catch((err) => {
+ console.error("[render] Fatal error:", err);
+ process.exit(1);
+});
diff --git a/examples/24_audio_capabilities/src/wav.ts b/examples/24_audio_capabilities/src/wav.ts
new file mode 100644
index 00000000..011c5db1
--- /dev/null
+++ b/examples/24_audio_capabilities/src/wav.ts
@@ -0,0 +1,49 @@
+/**
+ * Encodes stereo/mono Float32Array PCM channel buffers to a 16-bit PCM RIFF WAV buffer.
+ */
+export function pcmToWav(
+ channels: readonly Float32Array[],
+ sampleRate = 48000,
+): Buffer {
+ const numChannels = channels.length;
+ if (numChannels === 0) {
+ throw new Error("Cannot encode WAV: channels array is empty");
+ }
+ const numSamples = channels[0]?.length ?? 0;
+ const byteRate = sampleRate * numChannels * 2;
+ const blockAlign = numChannels * 2;
+ const dataSize = numSamples * numChannels * 2;
+ const buffer = Buffer.alloc(44 + dataSize);
+
+ // RIFF chunk header
+ buffer.write("RIFF", 0);
+ buffer.writeUInt32LE(36 + dataSize, 4);
+ buffer.write("WAVE", 8);
+
+ // "fmt " subchunk
+ buffer.write("fmt ", 12);
+ buffer.writeUInt32LE(16, 16); // Subchunk1Size for PCM
+ buffer.writeUInt16LE(1, 20); // AudioFormat: 1 (PCM)
+ buffer.writeUInt16LE(numChannels, 22);
+ buffer.writeUInt32LE(sampleRate, 24);
+ buffer.writeUInt32LE(byteRate, 28);
+ buffer.writeUInt16LE(blockAlign, 32);
+ buffer.writeUInt16LE(16, 34); // BitsPerSample: 16
+
+ // "data" subchunk
+ buffer.write("data", 36);
+ buffer.writeUInt32LE(dataSize, 40);
+
+ let offset = 44;
+ for (let i = 0; i < numSamples; i++) {
+ for (let c = 0; c < numChannels; c++) {
+ const channelData = channels[c];
+ const sample = Math.max(-1, Math.min(1, channelData?.[i] ?? 0));
+ const intSample = sample < 0 ? sample * 0x8000 : sample * 0x7fff;
+ buffer.writeInt16LE(Math.round(intSample), offset);
+ offset += 2;
+ }
+ }
+
+ return buffer;
+}
diff --git a/examples/24_audio_capabilities/tsconfig.json b/examples/24_audio_capabilities/tsconfig.json
new file mode 100644
index 00000000..999801f9
--- /dev/null
+++ b/examples/24_audio_capabilities/tsconfig.json
@@ -0,0 +1,10 @@
+{
+ "extends": "@framefields/tsconfig/base.json",
+ "compilerOptions": {
+ "module": "NodeNext",
+ "moduleResolution": "NodeNext",
+ "target": "ES2022",
+ "noEmit": true
+ },
+ "include": ["src/**/*"]
+}
diff --git a/nodes/node-audio-compressor/package.json b/nodes/node-audio-compressor/package.json
index eddc151f..8415b481 100644
--- a/nodes/node-audio-compressor/package.json
+++ b/nodes/node-audio-compressor/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "AudioCompressor",
- "kind": "audio"
+ "kind": "audio",
+ "schema": "CompressorNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-audio-compressor/src/index.ts b/nodes/node-audio-compressor/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-audio-compressor/src/index.ts
+++ b/nodes/node-audio-compressor/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-audio-compressor/src/renderers/audio-processor.ts b/nodes/node-audio-compressor/src/renderers/audio-processor.ts
index 691d6b3d..cf5cf38b 100644
--- a/nodes/node-audio-compressor/src/renderers/audio-processor.ts
+++ b/nodes/node-audio-compressor/src/renderers/audio-processor.ts
@@ -1,4 +1,4 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import { type AudioProcessor, resolveNumber } from "@framefields/node-sdk";
import { WebGPUAudioProcessor } from "@framefields/webgpu-renderers";
const PARAM_ORDER = [
@@ -211,14 +211,18 @@ export const compressorAudioProcessor: AudioProcessor = async (
}
const op = (virtualMedia.operation as Record<string, unknown>) || {};
- const inputs = (op.inputs as Record<string, any>) || {};
-
- const threshold = typeof op.threshold === "number" ? op.threshold : -24;
- const ratio = typeof op.ratio === "number" ? op.ratio : 4;
- const attack = typeof op.attack === "number" ? op.attack : 0.003;
- const release = typeof op.release === "number" ? op.release : 0.25;
- const knee = typeof op.knee === "number" ? op.knee : 6;
- const makeupGain = typeof op.makeupGain === "number" ? op.makeupGain : 0;
+ const inputs =
+ (op.inputs as Record<
+ string,
+ { connectionValid?: boolean; outputItem?: { type?: string } }
+ >) || {};
+
+ const threshold = resolveNumber(op.threshold, -24);
+ const ratio = resolveNumber(op.ratio, 4);
+ const attack = resolveNumber(op.attack, 0.003);
+ const release = resolveNumber(op.release, 0.25);
+ const knee = resolveNumber(op.knee, 6);
+ const makeupGain = resolveNumber(op.makeupGain, 0);
const isHandleConnected = (handleIdKey: string): boolean => {
const handleId = op[handleIdKey];
diff --git a/nodes/node-audio-delay/package.json b/nodes/node-audio-delay/package.json
index 81337f8e..df98d94b 100644
--- a/nodes/node-audio-delay/package.json
+++ b/nodes/node-audio-delay/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "AudioDelay",
- "kind": "audio"
+ "kind": "audio",
+ "schema": "DelayNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-audio-delay/src/index.ts b/nodes/node-audio-delay/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-audio-delay/src/index.ts
+++ b/nodes/node-audio-delay/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-audio-delay/src/renderers/audio-processor.ts b/nodes/node-audio-delay/src/renderers/audio-processor.ts
index fb271de9..8342e935 100644
--- a/nodes/node-audio-delay/src/renderers/audio-processor.ts
+++ b/nodes/node-audio-delay/src/renderers/audio-processor.ts
@@ -1,4 +1,8 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import {
+ type AudioProcessor,
+ resolveBoolean,
+ resolveNumber,
+} from "@framefields/node-sdk";
import { WebGPUAudioProcessor } from "@framefields/webgpu-renderers";
const PARAM_ORDER = ["delayTime", "feedback", "wet", "dry"];
@@ -179,7 +183,11 @@ export const delayAudioProcessor: AudioProcessor = async (
}
const op = (virtualMedia.operation as Record<string, unknown>) || {};
- const inputs = (op.inputs as Record<string, any>) || {};
+ const inputs =
+ (op.inputs as Record<
+ string,
+ { connectionValid?: boolean; outputItem?: { type?: string } }
+ >) || {};
const numChannels = channels.length;
if (numChannels === 0) return;
@@ -189,22 +197,15 @@ export const delayAudioProcessor: AudioProcessor = async (
// Clamp and extract parameters
const delaySec = Math.max(
0.001,
- Math.min(typeof op.delayTime === "number" ? op.delayTime : 0.25, 5.0),
+ Math.min(resolveNumber(op.delayTime, 0.25), 5.0),
);
const feedbackInternal = Math.max(
0.0,
- Math.min(typeof op.feedback === "number" ? op.feedback : 0.4, 0.95),
+ Math.min(resolveNumber(op.feedback, 0.4), 0.95),
);
- const wetInternal = Math.max(
- 0.0,
- Math.min(typeof op.wet === "number" ? op.wet : 0.3, 1.0),
- );
- const dryInternal = Math.max(
- 0.0,
- Math.min(typeof op.dry === "number" ? op.dry : 1.0, 1.0),
- );
- const pingPongInternal =
- typeof op.pingPong === "boolean" ? op.pingPong : false;
+ const wetInternal = Math.max(0.0, Math.min(resolveNumber(op.wet, 0.3), 1.0));
+ const dryInternal = Math.max(0.0, Math.min(resolveNumber(op.dry, 1.0), 1.0));
+ const pingPongInternal = resolveBoolean(op.pingPong, false);
const isHandleConnected = (handleIdKey: string): boolean => {
const handleId = op[handleIdKey];
diff --git a/nodes/node-audio-fade/package.json b/nodes/node-audio-fade/package.json
index 0a1a80ca..8e4f7b93 100644
--- a/nodes/node-audio-fade/package.json
+++ b/nodes/node-audio-fade/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "AudioFade",
- "kind": "audio"
+ "kind": "audio",
+ "schema": "FadeNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-audio-fade/src/index.ts b/nodes/node-audio-fade/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-audio-fade/src/index.ts
+++ b/nodes/node-audio-fade/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-audio-fade/src/renderers/audio-processor.ts b/nodes/node-audio-fade/src/renderers/audio-processor.ts
index 92695675..542c7bd5 100644
--- a/nodes/node-audio-fade/src/renderers/audio-processor.ts
+++ b/nodes/node-audio-fade/src/renderers/audio-processor.ts
@@ -1,4 +1,8 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import {
+ type AudioProcessor,
+ resolveNumber,
+ resolveString,
+} from "@framefields/node-sdk";
import { WebGPUAudioProcessor } from "@framefields/webgpu-renderers";
const PARAM_ORDER = ["fadeInDuration", "fadeOutDuration"];
@@ -133,7 +137,11 @@ export const fadeAudioProcessor: AudioProcessor = async (
}
const op = (virtualMedia.operation as Record<string, unknown>) || {};
- const inputs = (op.inputs as Record<string, any>) || {};
+ const inputs =
+ (op.inputs as Record<
+ string,
+ { connectionValid?: boolean; outputItem?: { type?: string } }
+ >) || {};
const numChannels = channels.length;
if (numChannels === 0) return;
@@ -141,18 +149,10 @@ export const fadeAudioProcessor: AudioProcessor = async (
if (numSamples === 0) return;
// Extract parameters
- const fadeInDuration = Math.max(
- 0.0,
- typeof op.fadeInDuration === "number" ? op.fadeInDuration : 0.0,
- );
- const fadeOutDuration = Math.max(
- 0.0,
- typeof op.fadeOutDuration === "number" ? op.fadeOutDuration : 0.0,
- );
- const fadeInCurve =
- typeof op.fadeInCurve === "string" ? op.fadeInCurve : "linear";
- const fadeOutCurve =
- typeof op.fadeOutCurve === "string" ? op.fadeOutCurve : "linear";
+ const fadeInDuration = Math.max(0.0, resolveNumber(op.fadeInDuration, 0.0));
+ const fadeOutDuration = Math.max(0.0, resolveNumber(op.fadeOutDuration, 0.0));
+ const fadeInCurve = resolveString(op.fadeInCurve, "linear");
+ const fadeOutCurve = resolveString(op.fadeOutCurve, "linear");
// Get duration
const durationMs = virtualMedia.metadata?.durationMs ?? 0;
diff --git a/nodes/node-audio-noise-gate/package.json b/nodes/node-audio-noise-gate/package.json
index 44701224..8b1f9e95 100644
--- a/nodes/node-audio-noise-gate/package.json
+++ b/nodes/node-audio-noise-gate/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "AudioNoiseGate",
- "kind": "audio"
+ "kind": "audio",
+ "schema": "NoiseGateNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-audio-noise-gate/src/index.ts b/nodes/node-audio-noise-gate/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-audio-noise-gate/src/index.ts
+++ b/nodes/node-audio-noise-gate/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-audio-noise-gate/src/renderers/audio-processor.ts b/nodes/node-audio-noise-gate/src/renderers/audio-processor.ts
index 47f5f64a..2c872380 100644
--- a/nodes/node-audio-noise-gate/src/renderers/audio-processor.ts
+++ b/nodes/node-audio-noise-gate/src/renderers/audio-processor.ts
@@ -1,4 +1,4 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import { type AudioProcessor, resolveNumber } from "@framefields/node-sdk";
import { WebGPUAudioProcessor } from "@framefields/webgpu-renderers";
const PARAM_ORDER = ["threshold", "attack", "hold", "release", "range"];
@@ -238,13 +238,17 @@ export const noiseGateAudioProcessor: AudioProcessor = async (
}
const op = (virtualMedia.operation as Record<string, unknown>) || {};
- const inputs = (op.inputs as Record<string, any>) || {};
-
- const threshold = typeof op.threshold === "number" ? op.threshold : -40;
- const attack = typeof op.attack === "number" ? op.attack : 0.005;
- const hold = typeof op.hold === "number" ? op.hold : 0.05;
- const release = typeof op.release === "number" ? op.release : 0.1;
- const range = typeof op.range === "number" ? op.range : -80;
+ const inputs =
+ (op.inputs as Record<
+ string,
+ { connectionValid?: boolean; outputItem?: { type?: string } }
+ >) || {};
+
+ const threshold = resolveNumber(op.threshold, -40);
+ const attack = resolveNumber(op.attack, 0.005);
+ const hold = resolveNumber(op.hold, 0.05);
+ const release = resolveNumber(op.release, 0.1);
+ const range = resolveNumber(op.range, -80);
const closedGain = range <= -96 ? 0 : 10 ** (range / 20);
diff --git a/nodes/node-audio-parametric-eq/package.json b/nodes/node-audio-parametric-eq/package.json
index a25af008..3b0b3c7c 100644
--- a/nodes/node-audio-parametric-eq/package.json
+++ b/nodes/node-audio-parametric-eq/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "AudioParametricEq",
- "kind": "audio"
+ "kind": "audio",
+ "schema": "ParametricEqNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-audio-parametric-eq/src/index.ts b/nodes/node-audio-parametric-eq/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-audio-parametric-eq/src/index.ts
+++ b/nodes/node-audio-parametric-eq/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-audio-parametric-eq/src/renderers/audio-processor.ts b/nodes/node-audio-parametric-eq/src/renderers/audio-processor.ts
index f295d994..cf67ca08 100644
--- a/nodes/node-audio-parametric-eq/src/renderers/audio-processor.ts
+++ b/nodes/node-audio-parametric-eq/src/renderers/audio-processor.ts
@@ -1,4 +1,8 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import {
+ type AudioProcessor,
+ resolveNumber,
+ resolveString,
+} from "@framefields/node-sdk";
import { WebGPUAudioProcessor } from "@framefields/webgpu-renderers";
import type { ParametricEqNodeConfig } from "../shared";
@@ -217,21 +221,30 @@ export const parametricEqAudioProcessor: AudioProcessor = async (
}
const op = (virtualMedia.operation as Record<string, unknown>) || {};
- const inputs = (op.inputs as Record<string, any>) || {};
+ const inputs =
+ (op.inputs as Record<
+ string,
+ { connectionValid?: boolean; outputItem?: { type?: string } }
+ >) || {};
+ const rawType = resolveString(op.type, "peak");
const config: ParametricEqNodeConfig = {
- type: (typeof op.type === "string" &&
- ["lowShelf", "highShelf", "peak", "lowPass", "highPass", "notch"].includes(
- op.type,
- )
- ? op.type
+ type: ([
+ "lowShelf",
+ "highShelf",
+ "peak",
+ "lowPass",
+ "highPass",
+ "notch",
+ ].includes(rawType)
+ ? rawType
: "peak") as ParametricEqNodeConfig["type"],
- frequency: typeof op.frequency === "number" ? op.frequency : 1000,
+ frequency: resolveNumber(op.frequency, 1000),
frequencyHandleId:
typeof op.frequencyHandleId === "string" ? op.frequencyHandleId : null,
- gain: typeof op.gain === "number" ? op.gain : 0,
+ gain: resolveNumber(op.gain, 0),
gainHandleId: typeof op.gainHandleId === "string" ? op.gainHandleId : null,
- q: typeof op.q === "number" ? op.q : 1.0,
+ q: resolveNumber(op.q, 1.0),
qHandleId: typeof op.qHandleId === "string" ? op.qHandleId : null,
};
diff --git a/nodes/node-audio-reverb/package.json b/nodes/node-audio-reverb/package.json
index 414f99c0..dd1b18a1 100644
--- a/nodes/node-audio-reverb/package.json
+++ b/nodes/node-audio-reverb/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "AudioReverb",
- "kind": "audio"
+ "kind": "audio",
+ "schema": "ReverbNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-audio-reverb/src/index.ts b/nodes/node-audio-reverb/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-audio-reverb/src/index.ts
+++ b/nodes/node-audio-reverb/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-audio-reverb/src/renderers/audio-processor.ts b/nodes/node-audio-reverb/src/renderers/audio-processor.ts
index b7e2a1be..c417fd50 100644
--- a/nodes/node-audio-reverb/src/renderers/audio-processor.ts
+++ b/nodes/node-audio-reverb/src/renderers/audio-processor.ts
@@ -1,4 +1,4 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import { type AudioProcessor, resolveNumber } from "@framefields/node-sdk";
import { WebGPUAudioProcessor } from "@framefields/webgpu-renderers";
const PARAM_ORDER = ["roomSize", "damping", "wet", "dry", "width"];
@@ -289,7 +289,11 @@ export const reverbAudioProcessor: AudioProcessor = async (
}
const op = (virtualMedia.operation as Record<string, unknown>) || {};
- const inputs = (op.inputs as Record<string, any>) || {};
+ const inputs =
+ (op.inputs as Record<
+ string,
+ { connectionValid?: boolean; outputItem?: { type?: string } }
+ >) || {};
const numChannels = channels.length;
if (numChannels === 0) return;
@@ -299,23 +303,17 @@ export const reverbAudioProcessor: AudioProcessor = async (
// Scale parameters based on Freeverb tuning specs
const roomSizeInternal = Math.max(
0,
- Math.min(typeof op.roomSize === "number" ? op.roomSize : 0.5, 0.98),
+ Math.min(resolveNumber(op.roomSize, 0.5), 0.98),
);
const dampingInternal = Math.max(
0,
- Math.min(typeof op.damping === "number" ? op.damping : 0.5, 1.0),
- );
- const wetInternal = Math.max(
- 0,
- Math.min(typeof op.wet === "number" ? op.wet : 0.3, 1.0),
- );
- const dryInternal = Math.max(
- 0,
- Math.min(typeof op.dry === "number" ? op.dry : 1.0, 1.0),
+ Math.min(resolveNumber(op.damping, 0.5), 1.0),
);
+ const wetInternal = Math.max(0, Math.min(resolveNumber(op.wet, 0.3), 1.0));
+ const dryInternal = Math.max(0, Math.min(resolveNumber(op.dry, 1.0), 1.0));
const widthInternal = Math.max(
0,
- Math.min(typeof op.width === "number" ? op.width : 1.0, 1.0),
+ Math.min(resolveNumber(op.width, 1.0), 1.0),
);
const isHandleConnected = (handleIdKey: string): boolean => {
diff --git a/nodes/node-audio-signal-extractor/src/index.ts b/nodes/node-audio-signal-extractor/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-audio-signal-extractor/src/index.ts
+++ b/nodes/node-audio-signal-extractor/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-audio-signal-extractor/src/renderers/audio-processor.ts b/nodes/node-audio-signal-extractor/src/renderers/audio-processor.ts
index afd001c2..62bccff5 100644
--- a/nodes/node-audio-signal-extractor/src/renderers/audio-processor.ts
+++ b/nodes/node-audio-signal-extractor/src/renderers/audio-processor.ts
@@ -1,4 +1,8 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import {
+ type AudioProcessor,
+ resolveNumber,
+ resolveString,
+} from "@framefields/node-sdk";
import {
type AudioSignalComputeConfig,
AudioSignalComputePipeline,
@@ -20,33 +24,20 @@ export const audioSignalExtractorAudioProcessor: AudioProcessor = async (
(op.nodeId as string) || (op.id as string) || "audio-signal-extractor";
const fps = ctx.fps ?? 24;
+ const mode = resolveString(op.extractionMode, "");
+ const curveStr = resolveString(op.curve, "");
const config: AudioSignalComputeConfig = {
- extractionMode: op.extractionMode as
- | "rms_envelope"
- | "transient_beat"
- | "sub_bass"
- | "bass"
- | "mid"
- | "high"
- | "spectral_flux"
- | undefined,
- attackMs: typeof op.attackMs === "number" ? op.attackMs : 10,
- releaseMs: typeof op.releaseMs === "number" ? op.releaseMs : 120,
- sensitivity: typeof op.sensitivity === "number" ? op.sensitivity : 1.0,
- noiseFloorDb: typeof op.noiseFloorDb === "number" ? op.noiseFloorDb : -45,
- dynamicRangeDb:
- typeof op.dynamicRangeDb === "number" ? op.dynamicRangeDb : 36,
- smoothing: typeof op.smoothing === "number" ? op.smoothing : 0.15,
- curve: op.curve as
- | "linear"
- | "exponential"
- | "logarithmic"
- | "square"
- | "smoothstep"
- | undefined,
- beatThreshold:
- typeof op.beatThreshold === "number" ? op.beatThreshold : 0.55,
- beatDecayMs: typeof op.beatDecayMs === "number" ? op.beatDecayMs : 80,
+ extractionMode: (mode ||
+ undefined) as AudioSignalComputeConfig["extractionMode"],
+ attackMs: resolveNumber(op.attackMs, 10),
+ releaseMs: resolveNumber(op.releaseMs, 120),
+ sensitivity: resolveNumber(op.sensitivity, 1.0),
+ noiseFloorDb: resolveNumber(op.noiseFloorDb, -45),
+ dynamicRangeDb: resolveNumber(op.dynamicRangeDb, 36),
+ smoothing: resolveNumber(op.smoothing, 0.15),
+ curve: (curveStr || undefined) as AudioSignalComputeConfig["curve"],
+ beatThreshold: resolveNumber(op.beatThreshold, 0.55),
+ beatDecayMs: resolveNumber(op.beatDecayMs, 80),
};
// 1. WebGPU feature extraction on the audio channels produced by the pipeline
diff --git a/nodes/node-camera-parallax-3d/package.json b/nodes/node-camera-parallax-3d/package.json
index 4c763d02..4b0ce93c 100644
--- a/nodes/node-camera-parallax-3d/package.json
+++ b/nodes/node-camera-parallax-3d/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "CameraParallax3D",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "CameraParallax3DNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-channel-merger/package.json b/nodes/node-channel-merger/package.json
index 2baa1b96..33f0229c 100644
--- a/nodes/node-channel-merger/package.json
+++ b/nodes/node-channel-merger/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "ChannelMerger",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "ChannelMergerNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-channel-splitter/package.json b/nodes/node-channel-splitter/package.json
index 6e93e72b..4dd251ab 100644
--- a/nodes/node-channel-splitter/package.json
+++ b/nodes/node-channel-splitter/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "ChannelSplitter",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "ChannelSplitterNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-compositor/src/index.ts b/nodes/node-compositor/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-compositor/src/index.ts
+++ b/nodes/node-compositor/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-compositor/src/renderers/audio-processor.ts b/nodes/node-compositor/src/renderers/audio-processor.ts
index 010b93ca..dbe039a1 100644
--- a/nodes/node-compositor/src/renderers/audio-processor.ts
+++ b/nodes/node-compositor/src/renderers/audio-processor.ts
@@ -1,7 +1,11 @@
import type { LayerAnimation } from "@framefields/compositions/program";
import type { VirtualMediaData } from "@framefields/core";
-import type { AudioProcessor } from "@framefields/node-sdk";
-import { audioRegistry } from "@framefields/node-sdk";
+import {
+ type AudioProcessor,
+ audioRegistry,
+ resolveBoolean,
+ resolveNumber,
+} from "@framefields/node-sdk";
import { compileLayerTimeline } from "../shared/compiler.js";
interface CompositorOperation {
@@ -33,7 +37,7 @@ export const compositorLayerAudioProcessor: AudioProcessor = async (
// once by the program-level `volume` — the per-layer path below handles
// each CompositorLayer op's own volume/mute animation.
if (op.op === "Compositor") {
- const master = typeof op.volume === "number" ? op.volume : 1;
+ const master = resolveNumber(op.volume, 1);
if (master === 1) return;
for (let c = 0; c < numChannels; c++) {
const ch = channels[c];
@@ -42,8 +46,8 @@ export const compositorLayerAudioProcessor: AudioProcessor = async (
return;
}
- const volume = typeof op.volume === "number" ? op.volume : 1;
- const muted = !!op.muted;
+ const volume = resolveNumber(op.volume, 1);
+ const muted = resolveBoolean(op.muted, false);
const animation = op.animation;
const fps = ctx?.fps ?? 24;
diff --git a/nodes/node-compositor/src/renderers/transform3d.test.ts b/nodes/node-compositor/src/renderers/transform3d.test.ts
index 1d73b00f..27c400f8 100644
--- a/nodes/node-compositor/src/renderers/transform3d.test.ts
+++ b/nodes/node-compositor/src/renderers/transform3d.test.ts
@@ -1,7 +1,7 @@
import { describe, expect, it } from "vitest";
import {
- compileTimeline,
type CompilerVirtualMedia,
+ compileTimeline,
} from "../shared/compiler.js";
import {
has3DTransform,
diff --git a/nodes/node-compositor/src/shared/audio-reactive.test.ts b/nodes/node-compositor/src/shared/audio-reactive.test.ts
index 0759fb69..32346cd6 100644
--- a/nodes/node-compositor/src/shared/audio-reactive.test.ts
+++ b/nodes/node-compositor/src/shared/audio-reactive.test.ts
@@ -166,11 +166,10 @@ describe("Audio-Reactive Motion Graphics Engine Pipeline", () => {
expect(signals.audio_beat_handle).toBe(beatSamples);
// 2. Compile into timeline
- const { tl, targetsById } = compileTimeline(
- "audio-reactive-session",
- vm,
- { fps: 24, durationSec: 2 },
- );
+ const { tl, targetsById } = compileTimeline("audio-reactive-session", vm, {
+ fps: 24,
+ durationSec: 2,
+ });
const logoStub = targetsById["bouncing-logo-star"];
expect(logoStub).toBeDefined();
diff --git a/nodes/node-compositor/src/shared/bezier-solver.ts b/nodes/node-compositor/src/shared/bezier-solver.ts
index aae9c780..feeb0d25 100644
--- a/nodes/node-compositor/src/shared/bezier-solver.ts
+++ b/nodes/node-compositor/src/shared/bezier-solver.ts
@@ -51,15 +51,12 @@ export function solveCubicBezier(
const oneMinusU2 = oneMinusU * oneMinusU;
const u2 = u * u;
- const currentX =
- 3 * oneMinusU2 * u * x1 + 3 * oneMinusU * u2 * x2 + u2 * u;
+ const currentX = 3 * oneMinusU2 * u * x1 + 3 * oneMinusU * u2 * x2 + u2 * u;
const diff = currentX - t;
if (Math.abs(diff) < 1e-6) break;
const dx =
- 3 * oneMinusU2 * x1 +
- 6 * oneMinusU * u * (x2 - x1) +
- 3 * u2 * (1 - x2);
+ 3 * oneMinusU2 * x1 + 6 * oneMinusU * u * (x2 - x1) + 3 * u2 * (1 - x2);
if (Math.abs(dx) < 1e-6) break;
u -= diff / dx;
@@ -69,9 +66,7 @@ export function solveCubicBezier(
// Bisection fallback if Newton didn't converge within bounds
const oneMinusU = 1 - u;
const checkX =
- 3 * oneMinusU * oneMinusU * u * x1 +
- 3 * oneMinusU * u * u * x2 +
- u * u * u;
+ 3 * oneMinusU * oneMinusU * u * x1 + 3 * oneMinusU * u * u * x2 + u * u * u;
if (Math.abs(checkX - t) > 1e-3) {
let low = 0;
@@ -96,11 +91,7 @@ export function solveCubicBezier(
// Evaluate y(u)
const oU = 1 - u;
- return (
- 3 * oU * oU * u * y1 +
- 3 * oU * u * u * y2 +
- u * u * u
- );
+ return 3 * oU * oU * u * y1 + 3 * oU * u * u * y2 + u * u * u;
}
/**
@@ -241,16 +232,8 @@ export function sampleCubicBezierSegment(
const u2 = u * u;
const u3 = u2 * u;
- const x =
- oU3 * p0.x +
- 3 * oU2 * u * c1.x +
- 3 * oU * u2 * c2.x +
- u3 * p1.x;
- const y =
- oU3 * p0.y +
- 3 * oU2 * u * c1.y +
- 3 * oU * u2 * c2.y +
- u3 * p1.y;
+ const x = oU3 * p0.x + 3 * oU2 * u * c1.x + 3 * oU * u2 * c2.x + u3 * p1.x;
+ const y = oU3 * p0.y + 3 * oU2 * u * c1.y + 3 * oU * u2 * c2.y + u3 * p1.y;
pts.push({ x, y });
}
return pts;
diff --git a/nodes/node-compositor/src/shared/compiler.test.ts b/nodes/node-compositor/src/shared/compiler.test.ts
index d2c34e8f..6ef9b508 100644
--- a/nodes/node-compositor/src/shared/compiler.test.ts
+++ b/nodes/node-compositor/src/shared/compiler.test.ts
@@ -1306,4 +1306,3 @@ describe("Compositor timeline cache lifecycle", () => {
expect(count() - before).toBeLessThanOrEqual(50);
});
});
-
diff --git a/nodes/node-compositor/src/shared/presets.test.ts b/nodes/node-compositor/src/shared/presets.test.ts
index 649e25ba..021e2733 100644
--- a/nodes/node-compositor/src/shared/presets.test.ts
+++ b/nodes/node-compositor/src/shared/presets.test.ts
@@ -214,4 +214,3 @@ describe("Compositor Presets", () => {
expect(swTracks[0].keyframes[1].value).toBe(100);
});
});
-
diff --git a/nodes/node-corner-pin/package.json b/nodes/node-corner-pin/package.json
index c670cd9d..4bf4069c 100644
--- a/nodes/node-corner-pin/package.json
+++ b/nodes/node-corner-pin/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "CornerPin",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "CornerPinNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-displacement-map/package.json b/nodes/node-displacement-map/package.json
index ef4e7858..0148dbf5 100644
--- a/nodes/node-displacement-map/package.json
+++ b/nodes/node-displacement-map/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "DisplacementMap",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "DisplacementMapNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-extract-lut/package.json b/nodes/node-extract-lut/package.json
index afd8398d..0c33815c 100644
--- a/nodes/node-extract-lut/package.json
+++ b/nodes/node-extract-lut/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "ExtractLUT",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "ExtractLutNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-flip/package.json b/nodes/node-flip/package.json
index 689795c8..c345b73a 100644
--- a/nodes/node-flip/package.json
+++ b/nodes/node-flip/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "Flip",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "FlipNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-kenburns/package.json b/nodes/node-kenburns/package.json
index cfd07e66..8e2ef0a0 100644
--- a/nodes/node-kenburns/package.json
+++ b/nodes/node-kenburns/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "KenBurns",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "KenBurnsConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-layer-style/package.json b/nodes/node-layer-style/package.json
index 115f8afc..f406e96f 100644
--- a/nodes/node-layer-style/package.json
+++ b/nodes/node-layer-style/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "LayerStyle",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "LayerStyleNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-liquify/package.json b/nodes/node-liquify/package.json
index 02a467c6..fc519a73 100644
--- a/nodes/node-liquify/package.json
+++ b/nodes/node-liquify/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "Liquify",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "LiquifyNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-mask-math/package.json b/nodes/node-mask-math/package.json
index 6f37d557..89d516ac 100644
--- a/nodes/node-mask-math/package.json
+++ b/nodes/node-mask-math/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "MaskMath",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "MaskMathNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-mesh-warp/package.json b/nodes/node-mesh-warp/package.json
index 67717eaa..9718e6ad 100644
--- a/nodes/node-mesh-warp/package.json
+++ b/nodes/node-mesh-warp/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "MeshWarp",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "MeshWarpNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-noise-generator/package.json b/nodes/node-noise-generator/package.json
index 1994c84a..13b66839 100644
--- a/nodes/node-noise-generator/package.json
+++ b/nodes/node-noise-generator/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "NoiseGenerator",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "NoiseGeneratorNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-paint/package.json b/nodes/node-paint/package.json
index 412e5fd8..a55104a8 100644
--- a/nodes/node-paint/package.json
+++ b/nodes/node-paint/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "Paint",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "PaintNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-paint/src/shared/config.ts b/nodes/node-paint/src/shared/config.ts
index a3fa4a33..a08c1962 100644
--- a/nodes/node-paint/src/shared/config.ts
+++ b/nodes/node-paint/src/shared/config.ts
@@ -8,10 +8,7 @@ import { z } from "zod";
// ─── Stroke schemas ────────────────────────────────────────────────────────────
export const BrushStrokeSchema = z.object({
- id: z
- .string()
- .min(1)
- .default(() => Math.random().toString(36).substring(7)),
+ id: z.string().min(1).default("brush"),
tool: z.literal("brush"),
path: z.string(),
color: z
@@ -25,20 +22,14 @@ export const BrushStrokeSchema = z.object({
});
export const EraserStrokeSchema = z.object({
- id: z
- .string()
- .min(1)
- .default(() => Math.random().toString(36).substring(7)),
+ id: z.string().min(1).default("eraser"),
tool: z.literal("eraser"),
path: z.string(),
size: z.number().positive(),
});
export const FillStrokeSchema = z.object({
- id: z
- .string()
- .min(1)
- .default(() => Math.random().toString(36).substring(7)),
+ id: z.string().min(1).default("fill"),
tool: z.literal("fill"),
imageData: z.string().min(1),
width: z.number().int().positive().max(16384),
diff --git a/nodes/node-patch-heal/package.json b/nodes/node-patch-heal/package.json
index f99985ab..e93dfeb3 100644
--- a/nodes/node-patch-heal/package.json
+++ b/nodes/node-patch-heal/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "PatchHeal",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "PatchHealNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-patch-heal/src/shared/config.ts b/nodes/node-patch-heal/src/shared/config.ts
index fc9a6d92..a2835750 100644
--- a/nodes/node-patch-heal/src/shared/config.ts
+++ b/nodes/node-patch-heal/src/shared/config.ts
@@ -10,7 +10,7 @@ export const MAX_FEATHER = 100;
export const MAX_OFFSET = 4096;
export const PatchItemSchema = z.object({
- id: z.string().default(() => Math.random().toString(36).substring(7)),
+ id: z.string().default("patch"),
centerX: z.number().min(0).max(1).default(0.5),
centerY: z.number().min(0).max(1).default(0.5),
offsetX: z.number().min(-MAX_OFFSET).max(MAX_OFFSET).default(50),
diff --git a/nodes/node-procedural-vfx/package.json b/nodes/node-procedural-vfx/package.json
index d8585306..935c2673 100644
--- a/nodes/node-procedural-vfx/package.json
+++ b/nodes/node-procedural-vfx/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "ProceduralVFX",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "ProceduralVFXNodeConfigSchema"
},
"gatewai": {
"enabled": false
diff --git a/nodes/node-refine-edge/package.json b/nodes/node-refine-edge/package.json
index 2a0dcab2..e97b84e1 100644
--- a/nodes/node-refine-edge/package.json
+++ b/nodes/node-refine-edge/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "RefineEdge",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "RefineEdgeNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-refraction-caustics/package.json b/nodes/node-refraction-caustics/package.json
index 29291cb4..5ec72cca 100644
--- a/nodes/node-refraction-caustics/package.json
+++ b/nodes/node-refraction-caustics/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "RefractionCaustics3D",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "RefractionCaustics3DNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-resizer-scaler/package.json b/nodes/node-resizer-scaler/package.json
index 9ad2df2b..cbdb0262 100644
--- a/nodes/node-resizer-scaler/package.json
+++ b/nodes/node-resizer-scaler/package.json
@@ -4,7 +4,8 @@
"private": false,
"framefields": {
"type": "ResizerScaler",
- "kind": "effect"
+ "kind": "effect",
+ "schema": "ResizerScalerNodeConfigSchema"
},
"type": "module",
"license": "Apache-2.0",
diff --git a/nodes/node-stereo-panning/package.json b/nodes/node-stereo-panning/package.json
index 27cd2f19..394fa573 100644
--- a/nodes/node-stereo-panning/package.json
+++ b/nodes/node-stereo-panning/package.json
@@ -5,7 +5,8 @@
"private": false,
"framefields": {
"type": "StereoPanning",
- "kind": "audio"
+ "kind": "audio",
+ "schema": "StereoPanningNodeConfigSchema"
},
"type": "module",
"module": "./dist/index.mjs",
diff --git a/nodes/node-stereo-panning/src/index.ts b/nodes/node-stereo-panning/src/index.ts
index 34f8d698..944d702e 100644
--- a/nodes/node-stereo-panning/src/index.ts
+++ b/nodes/node-stereo-panning/src/index.ts
@@ -1,2 +1,2 @@
-export * from "./shared/index.js";
export * from "./renderers/index.js";
+export * from "./shared/index.js";
diff --git a/nodes/node-stereo-panning/src/renderers/audio-processor.ts b/nodes/node-stereo-panning/src/renderers/audio-processor.ts
index f39dd89f..5e3bf2de 100644
--- a/nodes/node-stereo-panning/src/renderers/audio-processor.ts
+++ b/nodes/node-stereo-panning/src/renderers/audio-processor.ts
@@ -1,4 +1,4 @@
-import type { AudioProcessor } from "@framefields/node-sdk";
+import { type AudioProcessor, resolveNumber } from "@framefields/node-sdk";
import { WebGPUAudioProcessor } from "@framefields/webgpu-renderers";
const PANNING_SHADER_TEMPLATE = () => `
@@ -59,7 +59,10 @@ export const stereoPanningAudioProcessor: AudioProcessor = async (
throw new Error("GPUDevice is required for WebGPU Stereo Panning.");
}
- const pan = (node.operation as any)?.pan ?? 0;
+ const pan = resolveNumber(
+ (node.operation as Record<string, unknown> | undefined)?.pan,
+ 0,
+ );
const clampedPan = Math.max(-1, Math.min(1, pan));
if (channels.length === 0) return;
@@ -74,8 +77,9 @@ export const stereoPanningAudioProcessor: AudioProcessor = async (
const numChannels = channels.length;
- // 100% WebGPU Compute Path
- const nodeId = (node.operation as any)?.id || "stereo-panning";
+ const nodeId =
+ ((node.operation as Record<string, unknown> | undefined)?.id as string) ||
+ "stereo-panning";
const frame = ctx.frame ?? 0;
const fps = ctx.fps ?? 24;
diff --git a/packages/compositions/src/program/to-virtual-media.ts b/packages/compositions/src/program/to-virtual-media.ts
index 033c2eaa..e90271bc 100644
--- a/packages/compositions/src/program/to-virtual-media.ts
+++ b/packages/compositions/src/program/to-virtual-media.ts
@@ -234,11 +234,23 @@ function nodeToVirtualMedia(
const durationMs = (dur / fps) * 1000;
if (node.kind === "media" && media) {
- if (!media.metadata?.durationMs || media.metadata.durationMs <= 0) {
- if (!media.metadata)
- (media as unknown as { metadata: Record<string, unknown> }).metadata =
- {};
- media.metadata.durationMs = durationMs;
+ let curr: VirtualMediaData | undefined = media;
+ while (curr) {
+ if (!curr.metadata?.durationMs || curr.metadata.durationMs <= 0) {
+ if (!curr.metadata) {
+ (curr as unknown as { metadata: Record<string, unknown> }).metadata =
+ {};
+ }
+ curr.metadata.durationMs = durationMs;
+ }
+ if (
+ curr.operation?.sourceMeta &&
+ !(curr.operation.sourceMeta as Record<string, unknown>).durationMs
+ ) {
+ (curr.operation.sourceMeta as Record<string, unknown>).durationMs =
+ durationMs;
+ }
+ curr = curr.children?.[0];
}
}
diff --git a/packages/core/src/signals/index.ts b/packages/core/src/signals/index.ts
index efdf80be..4b394012 100644
--- a/packages/core/src/signals/index.ts
+++ b/packages/core/src/signals/index.ts
@@ -580,3 +580,5 @@ export const Signal = {
sine: sineSignal,
cosine: cosineSignal,
};
+
+export * from "./resolve.js";
diff --git a/packages/core/src/signals/resolve.test.ts b/packages/core/src/signals/resolve.test.ts
new file mode 100644
index 00000000..c028b675
--- /dev/null
+++ b/packages/core/src/signals/resolve.test.ts
@@ -0,0 +1,70 @@
+import { describe, expect, it } from "vitest";
+import { Signal } from "./index.js";
+import {
+ resolveBoolean,
+ resolveNumber,
+ resolveParam,
+ resolveString,
+} from "./resolve.js";
+
+describe("Signal and Parameter Resolvers", () => {
+ it("resolves numbers with fallback", () => {
+ expect(resolveNumber(42, 0)).toBe(42);
+ expect(resolveNumber(0, 10)).toBe(0);
+ expect(resolveNumber(-15.5, 0)).toBe(-15.5);
+ expect(resolveNumber(NaN, 5)).toBe(5);
+ expect(resolveNumber(undefined, 5)).toBe(5);
+ expect(resolveNumber(null, 5)).toBe(5);
+ expect(resolveNumber("42", 5)).toBe(5);
+
+ // With StateSignal
+ const sig = Signal.state(123);
+ expect(resolveNumber(sig, 0)).toBe(123);
+
+ // With wrapper object containing .value
+ expect(resolveNumber({ value: 99 }, 0)).toBe(99);
+ expect(resolveNumber({ value: NaN }, 10)).toBe(10);
+
+ // With object containing .peek()
+ expect(resolveNumber({ peek: () => 77 }, 0)).toBe(77);
+ });
+
+ it("resolves strings with fallback", () => {
+ expect(resolveString("hello", "default")).toBe("hello");
+ expect(resolveString("", "default")).toBe("");
+ expect(resolveString(undefined, "default")).toBe("default");
+ expect(resolveString(null, "default")).toBe("default");
+ expect(resolveString(123, "default")).toBe("default");
+
+ // With StateSignal
+ const sig = Signal.state("active");
+ expect(resolveString(sig, "idle")).toBe("active");
+
+ // With wrapper object
+ expect(resolveString({ value: "custom" }, "default")).toBe("custom");
+ });
+
+ it("resolves booleans with fallback", () => {
+ expect(resolveBoolean(true, false)).toBe(true);
+ expect(resolveBoolean(false, true)).toBe(false);
+ expect(resolveBoolean(undefined, true)).toBe(true);
+ expect(resolveBoolean(null, true)).toBe(true);
+ expect(resolveBoolean(1, false)).toBe(false);
+
+ // With StateSignal
+ const sig = Signal.state(true);
+ expect(resolveBoolean(sig, false)).toBe(true);
+
+ // With wrapper object
+ expect(resolveBoolean({ value: false }, true)).toBe(false);
+ });
+
+ it("resolves generic params via resolveParam", () => {
+ expect(resolveParam(10, 0)).toBe(10);
+ expect(resolveParam(Signal.state(20), 0)).toBe(20);
+ expect(resolveParam("abc", "xyz")).toBe("abc");
+ expect(resolveParam(Signal.state("abc"), "xyz")).toBe("abc");
+ expect(resolveParam(false, true)).toBe(false);
+ expect(resolveParam(Signal.state(false), true)).toBe(false);
+ });
+});
diff --git a/packages/core/src/signals/resolve.ts b/packages/core/src/signals/resolve.ts
new file mode 100644
index 00000000..688f89ad
--- /dev/null
+++ b/packages/core/src/signals/resolve.ts
@@ -0,0 +1,69 @@
+import { isSignal } from "./index.js";
+
+/**
+ * Unwraps a potential Signal, Signal-like object with `.peek()`,
+ * or object with `.value`. Returns the raw value or the original object.
+ */
+function unwrapValue(val: unknown): unknown {
+ if (val === null || typeof val !== "object") {
+ return val;
+ }
+ if (isSignal(val)) {
+ return val.peek();
+ }
+ if ("peek" in val && typeof (val as { peek: unknown }).peek === "function") {
+ return (val as { peek: () => unknown }).peek();
+ }
+ if ("value" in val) {
+ return (val as { value: unknown }).value;
+ }
+ return val;
+}
+
+/**
+ * Extracts a numeric value from a primitive, Signal, or wrapper object.
+ * Returns the fallback if undefined, null, NaN, or non-numeric.
+ */
+export function resolveNumber(val: unknown, fallback: number): number {
+ const unwrapped = unwrapValue(val);
+ return typeof unwrapped === "number" && !Number.isNaN(unwrapped)
+ ? unwrapped
+ : fallback;
+}
+
+/**
+ * Extracts a string value from a primitive, Signal, or wrapper object.
+ * Returns the fallback if undefined, null, or non-string.
+ */
+export function resolveString(val: unknown, fallback: string): string {
+ const unwrapped = unwrapValue(val);
+ return typeof unwrapped === "string" ? unwrapped : fallback;
+}
+
+/**
+ * Extracts a boolean value from a primitive, Signal, or wrapper object.
+ * Returns the fallback if undefined, null, or non-boolean.
+ */
+export function resolveBoolean(val: unknown, fallback: boolean): boolean {
+ const unwrapped = unwrapValue(val);
+ return typeof unwrapped === "boolean" ? unwrapped : fallback;
+}
+
+/**
+ * Generic parameter resolver matching the fallback value's type.
+ */
+export function resolveParam<T>(val: unknown, fallback: T): T {
+ if (typeof fallback === "number") {
+ return resolveNumber(val, fallback) as T;
+ }
+ if (typeof fallback === "string") {
+ return resolveString(val, fallback) as T;
+ }
+ if (typeof fallback === "boolean") {
+ return resolveBoolean(val, fallback) as T;
+ }
+ const unwrapped = unwrapValue(val);
+ return unwrapped !== undefined && unwrapped !== null
+ ? (unwrapped as T)
+ : fallback;
+}
diff --git a/packages/framefields/src/effects/generated.test.ts b/packages/framefields/src/effects/generated.test.ts
index 70984ebc..64a817c9 100644
--- a/packages/framefields/src/effects/generated.test.ts
+++ b/packages/framefields/src/effects/generated.test.ts
@@ -28,45 +28,19 @@ const migrated = authoringNodes.filter((m) => m.schema);
*/
const NOT_YET_MIGRATED = [
"node-apply-lut",
- "node-audio-compressor",
- "node-audio-delay",
- "node-audio-fade",
- "node-audio-noise-gate",
- "node-audio-parametric-eq",
- "node-audio-reverb",
"node-audio-signal-extractor",
- "node-camera-parallax-3d",
- "node-channel-merger",
- "node-channel-splitter",
- "node-corner-pin",
"node-crop",
"node-curves",
"node-deflicker",
- "node-displacement-map",
- "node-extract-lut",
"node-film-grain",
- "node-flip",
"node-gradient-map",
"node-halftone-screen",
"node-high-pass",
- "node-kenburns",
- "node-layer-style",
"node-levels",
- "node-liquify",
- "node-mask-math",
- "node-mesh-warp",
"node-modulate",
- "node-noise-generator",
- "node-paint",
- "node-patch-heal",
- "node-procedural-vfx",
- "node-refine-edge",
- "node-refraction-caustics",
"node-relight-3d",
- "node-resizer-scaler",
"node-selective-color",
"node-shadows-highlights",
- "node-stereo-panning",
"node-tile-offset",
"node-unsharp-mask",
"node-vision",
diff --git a/packages/framefields/src/effects/generated/catalog.json b/packages/framefields/src/effects/generated/catalog.json
index 1e425ad9..7505134b 100644
--- a/packages/framefields/src/effects/generated/catalog.json
+++ b/packages/framefields/src/effects/generated/catalog.json
@@ -1,6 +1,335 @@
{
"$comment": "Generated by scripts/generate-effects.mts. Machine-readable description of every generated effect class.",
"effects": [
+ {
+ "name": "AudioCompressor",
+ "op": "AudioCompressor",
+ "kind": "audio",
+ "factory": "audioCompressor",
+ "node": "node-audio-compressor",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "threshold",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": -24,
+ "min": -60,
+ "max": 0,
+ "description": "Level (dBFS) above which gain reduction begins (-60 to 0 dB). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "ratio",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 4,
+ "min": 1,
+ "max": 100,
+ "description": "Input-to-output ratio above threshold (1 to 100). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "attack",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.003,
+ "min": 0.0001,
+ "max": 1,
+ "description": "Seconds to reach full gain reduction (0.0001 to 1.0s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "release",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.25,
+ "min": 0.01,
+ "max": 5,
+ "description": "Seconds to recover gain after signal drops (0.01 to 5.0s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "knee",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 6,
+ "min": 0,
+ "max": 24,
+ "description": "dB range for soft-knee transition around threshold (0 to 24 dB). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "makeupGain",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 24,
+ "description": "dBFS of gain applied after compression (0 to 24 dB). Can be modulated by a static number or dynamic signal."
+ }
+ ]
+ },
+ {
+ "name": "AudioDelay",
+ "op": "AudioDelay",
+ "kind": "audio",
+ "factory": "audioDelay",
+ "node": "node-audio-delay",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "delayTime",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.25,
+ "min": 0.001,
+ "max": 5,
+ "description": "Delay time in seconds (0.001 to 5.0s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "feedback",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.4,
+ "min": 0,
+ "max": 0.95,
+ "description": "Amount of delayed signal fed back into delay line (0.0 to 0.95). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "wet",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.3,
+ "min": 0,
+ "max": 1,
+ "description": "Mix level of the wet delayed signal (0.0 to 1.0). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "dry",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 1,
+ "description": "Mix level of the original dry signal (0.0 to 1.0). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "pingPong",
+ "type": "boolean",
+ "signal": false,
+ "default": false,
+ "description": "Alternates echo reflections between left and right channels"
+ }
+ ]
+ },
+ {
+ "name": "AudioFade",
+ "op": "AudioFade",
+ "kind": "audio",
+ "factory": "audioFade",
+ "node": "node-audio-fade",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "fadeInDuration",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 60,
+ "description": "Duration in seconds of fade in from silence (0 to 60s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "fadeOutDuration",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 60,
+ "description": "Duration in seconds of fade out to silence (0 to 60s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "fadeInCurve",
+ "type": "\"linear\" | \"exponential\" | \"scurve\"",
+ "signal": false,
+ "default": "linear",
+ "enum": ["linear", "exponential", "scurve"],
+ "description": "Envelope shape for fade in"
+ },
+ {
+ "name": "fadeOutCurve",
+ "type": "\"linear\" | \"exponential\" | \"scurve\"",
+ "signal": false,
+ "default": "linear",
+ "enum": ["linear", "exponential", "scurve"],
+ "description": "Envelope shape for fade out"
+ }
+ ]
+ },
+ {
+ "name": "AudioNoiseGate",
+ "op": "AudioNoiseGate",
+ "kind": "audio",
+ "factory": "audioNoiseGate",
+ "node": "node-audio-noise-gate",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "threshold",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": -40,
+ "min": -120,
+ "max": 0,
+ "description": "dBFS level below which the gate closes (-120 to 0 dB). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "attack",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.005,
+ "min": 0.0001,
+ "max": 1,
+ "description": "Seconds to open (fade in) when signal exceeds threshold (0.0001 to 1.0s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "hold",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.05,
+ "min": 0.001,
+ "max": 5,
+ "description": "Seconds to stay open after signal drops below threshold (0.001 to 5.0s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "release",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.1,
+ "min": 0.01,
+ "max": 5,
+ "description": "Seconds to close (fade out) after hold expires (0.01 to 5.0s). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "range",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": -80,
+ "min": -120,
+ "max": 0,
+ "description": "dBFS floor when gate is closed (-120 to 0 dB). Can be modulated by a static number or dynamic signal."
+ }
+ ]
+ },
+ {
+ "name": "AudioParametricEq",
+ "op": "AudioParametricEq",
+ "kind": "audio",
+ "factory": "audioParametricEq",
+ "node": "node-audio-parametric-eq",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "type",
+ "type": "\"lowShelf\" | \"highShelf\" | \"peak\" | \"lowPass\" | \"highPass\" | \"notch\"",
+ "signal": false,
+ "default": "peak",
+ "enum": [
+ "lowShelf",
+ "highShelf",
+ "peak",
+ "lowPass",
+ "highPass",
+ "notch"
+ ],
+ "description": "Type of biquad filter"
+ },
+ {
+ "name": "frequency",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1000,
+ "min": 20,
+ "max": 20000,
+ "description": "Cutoff or center frequency in Hz (20 to 20000 Hz). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "gain",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": -24,
+ "max": 24,
+ "description": "Gain boost or cut in dB (-24 to 24 dB). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "q",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0.01,
+ "max": 10,
+ "description": "Filter bandwidth / Q factor (0.01 to 10.0). Can be modulated by a static number or dynamic signal."
+ }
+ ]
+ },
+ {
+ "name": "AudioReverb",
+ "op": "AudioReverb",
+ "kind": "audio",
+ "factory": "audioReverb",
+ "node": "node-audio-reverb",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "roomSize",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 0.98,
+ "description": "Room decay, size of simulated space (0 to 0.98). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "damping",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 1,
+ "description": "High-frequency absorption (0 to 1.0). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "wet",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.3,
+ "min": 0,
+ "max": 1,
+ "description": "Mix level of the wet reverberated signal (0 to 1.0). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "dry",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 1,
+ "description": "Mix level of the original dry signal (0 to 1.0). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "width",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 1,
+ "description": "Stereo spread of the reverb tail (0 to 1.0). Can be modulated by a static number or dynamic signal."
+ }
+ ]
+ },
{
"name": "Blur",
"op": "Blur",
@@ -108,82 +437,234 @@
]
},
{
- "name": "ColorBalance",
- "op": "ColorBalance",
+ "name": "CameraParallax3D",
+ "op": "CameraParallax3D",
"kind": "effect",
- "factory": "colorBalance",
- "node": "node-color-balance",
+ "factory": "cameraParallax3D",
+ "node": "node-camera-parallax-3d",
"aliases": [],
"custom": null,
"props": [
{
- "name": "shadows",
- "type": "Partial<TonalShift>",
- "signal": false,
- "default": {
- "cyanRed": 0,
- "magentaGreen": 0,
- "yellowBlue": 0
- }
- },
- {
- "name": "midtones",
- "type": "Partial<TonalShift>",
- "signal": false,
- "default": {
- "cyanRed": 0,
- "magentaGreen": 0,
- "yellowBlue": 0
- }
- },
- {
- "name": "highlights",
- "type": "Partial<TonalShift>",
+ "name": "motionPreset",
+ "type": "\"Custom\" | \"DollyZoom\" | \"Orbit\" | \"FlyThrough\" | \"HandheldShake\" | \"RackFocus\"",
"signal": false,
- "default": {
- "cyanRed": 0,
- "magentaGreen": 0,
- "yellowBlue": 0
- }
+ "default": "DollyZoom",
+ "enum": [
+ "Custom",
+ "DollyZoom",
+ "Orbit",
+ "FlyThrough",
+ "HandheldShake",
+ "RackFocus"
+ ],
+ "description": "Motion Preset"
},
{
- "name": "preserveLuminosity",
- "type": "boolean",
- "signal": false,
- "default": true
- }
- ]
- },
- {
- "name": "ColorKey",
- "op": "ColorKey",
- "kind": "effect",
- "factory": "colorKey",
- "node": "node-colorkey",
- "aliases": [],
- "custom": null,
- "props": [
- {
- "name": "keyColor",
- "type": "string",
- "signal": false,
- "default": "#00ff00",
- "description": "Key Color"
+ "name": "panX",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": -1,
+ "max": 1,
+ "description": "Horizontal camera pan angle / position offset (-1.0 to 1.0). Can be modulated by a static number or dynamic signal."
},
{
- "name": "similarity",
+ "name": "panY",
"type": "EffectProp<number>",
"signal": true,
- "default": 0.4,
- "min": 0,
+ "default": 0,
+ "min": -1,
"max": 1,
- "description": "How close the color must be to the Key Color to be removed."
+ "description": "Vertical camera tilt angle / position offset (-1.0 to 1.0). Can be modulated by a static number or dynamic signal."
},
{
- "name": "smoothness",
+ "name": "dollyZ",
"type": "EffectProp<number>",
"signal": true,
- "default": 0.1,
+ "default": 0,
+ "min": -1,
+ "max": 1,
+ "description": "Camera forward/backward zoom position (-1.0 to 1.0). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "fov",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 50,
+ "min": 15,
+ "max": 120,
+ "description": "Camera Field of View in degrees (15° to 120°). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "parallaxAmount",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.6,
+ "min": 0,
+ "max": 2,
+ "description": "Strength of 3D spatial displacement depth relief. Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "dofAperture",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.3,
+ "min": 0,
+ "max": 1,
+ "description": "Lens aperture size / Circle of Confusion bokeh blur radius. Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "focusPlane",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.4,
+ "min": 0,
+ "max": 1,
+ "description": "Focal plane depth in scene (0.0=foreground, 1.0=background). Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "edgeDilation",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 1,
+ "description": "Inpainting border bleed to eliminate border occlusion tearing."
+ },
+ {
+ "name": "depthInvert",
+ "type": "boolean",
+ "signal": false,
+ "default": false,
+ "description": "Invert depth polarity (white = near vs black = near)."
+ }
+ ]
+ },
+ {
+ "name": "ChannelMerger",
+ "op": "ChannelMerger",
+ "kind": "effect",
+ "factory": "channelMerger",
+ "node": "node-channel-merger",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "colorSpace",
+ "type": "\"RGBA\" | \"HSLA\" | \"CMYK\" | \"LAB\"",
+ "signal": false,
+ "default": "RGBA",
+ "enum": ["RGBA", "HSLA", "CMYK", "LAB"],
+ "description": "Color space used for channel recombination (RGBA, HSLA, CMYK, or LAB)."
+ },
+ {
+ "name": "defaultChannel4",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 1,
+ "description": "Fallback value used when Channel 4 is unconnected (Alpha=1.0, Black=0.0 in CMYK)."
+ }
+ ]
+ },
+ {
+ "name": "ChannelSplitter",
+ "op": "ChannelSplitter",
+ "kind": "effect",
+ "factory": "channelSplitter",
+ "node": "node-channel-splitter",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "colorSpace",
+ "type": "\"RGBA\" | \"HSLA\" | \"CMYK\" | \"LAB\"",
+ "signal": false,
+ "default": "RGBA",
+ "enum": ["RGBA", "HSLA", "CMYK", "LAB"],
+ "description": "Color space used for channel decomposition (RGBA, HSLA, CMYK, or LAB)."
+ }
+ ]
+ },
+ {
+ "name": "ColorBalance",
+ "op": "ColorBalance",
+ "kind": "effect",
+ "factory": "colorBalance",
+ "node": "node-color-balance",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "shadows",
+ "type": "Partial<TonalShift>",
+ "signal": false,
+ "default": {
+ "cyanRed": 0,
+ "magentaGreen": 0,
+ "yellowBlue": 0
+ }
+ },
+ {
+ "name": "midtones",
+ "type": "Partial<TonalShift>",
+ "signal": false,
+ "default": {
+ "cyanRed": 0,
+ "magentaGreen": 0,
+ "yellowBlue": 0
+ }
+ },
+ {
+ "name": "highlights",
+ "type": "Partial<TonalShift>",
+ "signal": false,
+ "default": {
+ "cyanRed": 0,
+ "magentaGreen": 0,
+ "yellowBlue": 0
+ }
+ },
+ {
+ "name": "preserveLuminosity",
+ "type": "boolean",
+ "signal": false,
+ "default": true
+ }
+ ]
+ },
+ {
+ "name": "ColorKey",
+ "op": "ColorKey",
+ "kind": "effect",
+ "factory": "colorKey",
+ "node": "node-colorkey",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "keyColor",
+ "type": "string",
+ "signal": false,
+ "default": "#00ff00",
+ "description": "Key Color"
+ },
+ {
+ "name": "similarity",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.4,
+ "min": 0,
+ "max": 1,
+ "description": "How close the color must be to the Key Color to be removed."
+ },
+ {
+ "name": "smoothness",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.1,
"min": 0,
"max": 1,
"description": "The softness of the transparency edge."
@@ -215,6 +696,1372 @@
}
]
},
+ {
+ "name": "CornerPin",
+ "op": "CornerPin",
+ "kind": "effect",
+ "factory": "cornerPin",
+ "node": "node-corner-pin",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "points",
+ "type": "CornerPinPointsItem[]",
+ "signal": false
+ }
+ ]
+ },
+ {
+ "name": "DisplacementMap",
+ "op": "DisplacementMap",
+ "kind": "effect",
+ "factory": "displacementMap",
+ "node": "node-displacement-map",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "strengthX",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 50,
+ "min": 0,
+ "max": 500,
+ "description": "Horizontal displacement strength in pixels. Can be modulated by a static number or a dynamic signal."
+ },
+ {
+ "name": "strengthY",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 50,
+ "min": 0,
+ "max": 500,
+ "description": "Vertical displacement strength in pixels. Can be modulated by a static number or a dynamic signal."
+ },
+ {
+ "name": "xChannel",
+ "type": "\"Red\" | \"Green\" | \"Blue\" | \"Alpha\" | \"Luminance\"",
+ "signal": false,
+ "default": "Red",
+ "enum": ["Red", "Green", "Blue", "Alpha", "Luminance"],
+ "description": "X Channel"
+ },
+ {
+ "name": "yChannel",
+ "type": "\"Red\" | \"Green\" | \"Blue\" | \"Alpha\" | \"Luminance\"",
+ "signal": false,
+ "default": "Green",
+ "enum": ["Red", "Green", "Blue", "Alpha", "Luminance"],
+ "description": "Y Channel"
+ },
+ {
+ "name": "wrapMode",
+ "type": "\"Clamp\" | \"Repeat\" | \"Mirror\"",
+ "signal": false,
+ "default": "Clamp",
+ "enum": ["Clamp", "Repeat", "Mirror"],
+ "description": "Wrap Mode"
+ }
+ ]
+ },
+ {
+ "name": "ExtractLUT",
+ "op": "ExtractLUT",
+ "kind": "effect",
+ "factory": "extractLUT",
+ "node": "node-extract-lut",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "strategy",
+ "type": "\"deterministic\" | \"statistical\"",
+ "signal": false,
+ "default": "deterministic",
+ "enum": ["deterministic", "statistical"],
+ "description": "Extraction Strategy"
+ },
+ {
+ "name": "samplePoints",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 150,
+ "min": 10,
+ "max": 500,
+ "description": "Sample Points"
+ }
+ ]
+ },
+ {
+ "name": "Flip",
+ "op": "Flip",
+ "kind": "effect",
+ "factory": "flip",
+ "node": "node-flip",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "horizontal",
+ "type": "boolean",
+ "signal": false,
+ "default": true,
+ "description": "Mirror horizontally along the vertical center axis."
+ },
+ {
+ "name": "vertical",
+ "type": "boolean",
+ "signal": false,
+ "default": false,
+ "description": "Mirror vertically along the horizontal center axis."
+ },
+ {
+ "name": "diagonal",
+ "type": "boolean",
+ "signal": false,
+ "default": false,
+ "description": "Swap horizontal and vertical axes (diagonal transposition)."
+ },
+ {
+ "name": "mode",
+ "type": "\"horizontal\" | \"vertical\" | \"both\" | \"diagonal\" | \"antiDiagonal\" | \"custom\"",
+ "signal": false,
+ "default": "horizontal",
+ "enum": [
+ "horizontal",
+ "vertical",
+ "both",
+ "diagonal",
+ "antiDiagonal",
+ "custom"
+ ],
+ "description": "Quick preset mode for flipping or transposition."
+ },
+ {
+ "name": "symmetry",
+ "type": "\"none\" | \"leftToRight\" | \"rightToLeft\" | \"topToBottom\" | \"bottomToTop\" | \"quadrant\"",
+ "signal": false,
+ "default": "none",
+ "enum": [
+ "none",
+ "leftToRight",
+ "rightToLeft",
+ "topToBottom",
+ "bottomToTop",
+ "quadrant"
+ ],
+ "description": "Split-mirror reflection and symmetry effects."
+ }
+ ]
+ },
+ {
+ "name": "KenBurns",
+ "op": "KenBurns",
+ "kind": "effect",
+ "factory": "kenBurns",
+ "node": "node-kenburns",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "keyframes",
+ "type": "KenBurnsKeyframesItem[]",
+ "signal": false,
+ "default": []
+ },
+ {
+ "name": "motionBlurSize",
+ "type": "number",
+ "signal": false,
+ "default": 1.5,
+ "min": 0,
+ "max": 10
+ },
+ {
+ "name": "movementStyle",
+ "type": "\"spline\" | \"direct\"",
+ "signal": false,
+ "default": "spline",
+ "enum": ["spline", "direct"]
+ },
+ {
+ "name": "aspectRatio",
+ "type": "\"input\" | \"16:9\" | \"9:16\" | \"21:9\" | \"9:21\" | \"1:1\" | \"4:3\" | \"3:2\" | \"2:3\" | \"4:5\" | \"5:4\"",
+ "signal": false,
+ "default": "input",
+ "enum": [
+ "input",
+ "16:9",
+ "9:16",
+ "21:9",
+ "9:21",
+ "1:1",
+ "4:3",
+ "3:2",
+ "2:3",
+ "4:5",
+ "5:4"
+ ]
+ }
+ ]
+ },
+ {
+ "name": "LayerStyle",
+ "op": "LayerStyle",
+ "kind": "effect",
+ "factory": "layerStyle",
+ "node": "node-layer-style",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "dropShadow",
+ "type": "Partial<LayerStyleDropShadow>",
+ "signal": false,
+ "default": {
+ "enabled": false,
+ "color": "#000000",
+ "opacity": 0.75,
+ "angle": 120,
+ "distance": 10,
+ "spread": 0,
+ "size": 10,
+ "blendMode": "multiply"
+ }
+ },
+ {
+ "name": "innerShadow",
+ "type": "Partial<LayerStyleInnerShadow>",
+ "signal": false,
+ "default": {
+ "enabled": false,
+ "color": "#000000",
+ "opacity": 0.75,
+ "angle": 120,
+ "distance": 5,
+ "choke": 0,
+ "size": 5,
+ "blendMode": "multiply"
+ }
+ },
+ {
+ "name": "outerGlow",
+ "type": "Partial<LayerStyleOuterGlow>",
+ "signal": false,
+ "default": {
+ "enabled": false,
+ "color": "#ffffff",
+ "opacity": 0.75,
+ "size": 15,
+ "spread": 0,
+ "blendMode": "screen"
+ }
+ },
+ {
+ "name": "innerGlow",
+ "type": "Partial<LayerStyleInnerGlow>",
+ "signal": false,
+ "default": {
+ "enabled": false,
+ "color": "#ffffff",
+ "opacity": 0.75,
+ "size": 15,
+ "spread": 0,
+ "blendMode": "screen"
+ }
+ },
+ {
+ "name": "stroke",
+ "type": "Partial<LayerStyleStroke>",
+ "signal": false,
+ "default": {
+ "enabled": false,
+ "size": 2,
+ "position": "outside",
+ "color": "#ffffff",
+ "opacity": 1,
+ "blendMode": "normal"
+ }
+ },
+ {
+ "name": "bevelEmboss",
+ "type": "Partial<LayerStyleBevelEmboss>",
+ "signal": false,
+ "default": {
+ "enabled": false,
+ "style": "InnerBevel",
+ "technique": "Smooth",
+ "depth": 100,
+ "direction": "Up",
+ "size": 5,
+ "soften": 0,
+ "angle": 120,
+ "altitude": 30,
+ "highlightColor": "#ffffff",
+ "highlightOpacity": 0.75,
+ "shadowColor": "#000000",
+ "shadowOpacity": 0.75
+ }
+ },
+ {
+ "name": "colorOverlay",
+ "type": "Partial<LayerStyleColorOverlay>",
+ "signal": false,
+ "default": {
+ "enabled": false,
+ "color": "#ff0000",
+ "opacity": 1,
+ "blendMode": "normal"
+ }
+ },
+ {
+ "name": "dropShadowAngleHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "dropShadowDistanceHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "dropShadowSpreadHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "dropShadowSizeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "dropShadowOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerShadowAngleHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerShadowDistanceHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerShadowChokeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerShadowSizeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerShadowOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "outerGlowSizeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "outerGlowSpreadHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "outerGlowOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerGlowSizeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerGlowSpreadHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "innerGlowOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "strokeSizeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "strokeOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "bevelEmbossDepthHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "bevelEmbossSizeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "bevelEmbossSoftenHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "bevelEmbossAngleHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "bevelEmbossAltitudeHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "bevelEmbossHighlightOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "bevelEmbossShadowOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ },
+ {
+ "name": "colorOverlayOpacityHandleId",
+ "type": "string | null",
+ "signal": false
+ }
+ ]
+ },
+ {
+ "name": "Liquify",
+ "op": "Liquify",
+ "kind": "effect",
+ "factory": "liquify",
+ "node": "node-liquify",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "operations",
+ "type": "LiquifyOperationsItem[]",
+ "signal": false,
+ "default": [],
+ "description": "List of localized liquify deformation operations."
+ }
+ ]
+ },
+ {
+ "name": "MaskMath",
+ "op": "MaskMath",
+ "kind": "effect",
+ "factory": "maskMath",
+ "node": "node-mask-math",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "operation",
+ "type": "\"Union\" | \"Intersect\" | \"Subtract\" | \"Difference\" | \"Invert\" | \"Dilate\" | \"Erode\" | \"Choke\" | \"Feather\"",
+ "signal": false,
+ "default": "Union",
+ "enum": [
+ "Union",
+ "Intersect",
+ "Subtract",
+ "Difference",
+ "Invert",
+ "Dilate",
+ "Erode",
+ "Choke",
+ "Feather"
+ ],
+ "description": "Morphological or Boolean set operation applied to input alpha masks."
+ },
+ {
+ "name": "radius",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 200,
+ "description": "Kernel radius in pixels for Dilate, Erode, Choke, or Feather operations."
+ },
+ {
+ "name": "threshold",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 1,
+ "description": "Cutoff threshold level (0.0–1.0) for binarization step or non-linear choke."
+ },
+ {
+ "name": "clampMin",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 1,
+ "description": "Minimum alpha matte cutoff limit (0.0–1.0)."
+ },
+ {
+ "name": "clampMax",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 1,
+ "description": "Maximum alpha matte cutoff limit (0.0–1.0)."
+ },
+ {
+ "name": "channelA",
+ "type": "\"Alpha\" | \"Luminance\" | \"Red\" | \"Green\" | \"Blue\"",
+ "signal": false,
+ "default": "Alpha",
+ "enum": ["Alpha", "Luminance", "Red", "Green", "Blue"],
+ "description": "Source channel to extract mask from Mask A (Alpha, Luminance, Red, Green, Blue)."
+ },
+ {
+ "name": "channelB",
+ "type": "\"Alpha\" | \"Luminance\" | \"Red\" | \"Green\" | \"Blue\"",
+ "signal": false,
+ "default": "Alpha",
+ "enum": ["Alpha", "Luminance", "Red", "Green", "Blue"],
+ "description": "Source channel to extract mask from Mask B (Alpha, Luminance, Red, Green, Blue)."
+ },
+ {
+ "name": "binarize",
+ "type": "boolean",
+ "signal": false,
+ "default": false,
+ "description": "When enabled, outputs crisp 1-bit binary matte based on threshold."
+ },
+ {
+ "name": "invertResult",
+ "type": "boolean",
+ "signal": false,
+ "default": false,
+ "description": "Inverts final matte output."
+ },
+ {
+ "name": "outputFormat",
+ "type": "\"WhiteWithAlpha\" | \"GrayscaleRGB\" | \"AlphaOnly\" | \"PassthroughRGB\"",
+ "signal": false,
+ "default": "WhiteWithAlpha",
+ "enum": [
+ "WhiteWithAlpha",
+ "GrayscaleRGB",
+ "AlphaOnly",
+ "PassthroughRGB"
+ ],
+ "description": "WhiteWithAlpha (rgba(1,1,1,a)), GrayscaleRGB (rgba(a,a,a,1)), AlphaOnly (rgba(0,0,0,a)), PassthroughRGB (Mask A RGB with new alpha)."
+ }
+ ]
+ },
+ {
+ "name": "MeshWarp",
+ "op": "MeshWarp",
+ "kind": "effect",
+ "factory": "meshWarp",
+ "node": "node-mesh-warp",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "cols",
+ "type": "number",
+ "signal": false,
+ "default": 3,
+ "min": 2,
+ "max": 12
+ },
+ {
+ "name": "rows",
+ "type": "number",
+ "signal": false,
+ "default": 3,
+ "min": 2,
+ "max": 12
+ },
+ {
+ "name": "points",
+ "type": "MeshWarpPointsItem[]",
+ "signal": false
+ }
+ ]
+ },
+ {
+ "name": "NoiseGenerator",
+ "op": "NoiseGenerator",
+ "kind": "effect",
+ "factory": "noiseGenerator",
+ "node": "node-noise-generator",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "noiseType",
+ "type": "\"Perlin\" | \"Simplex\" | \"Voronoi\"",
+ "signal": false,
+ "default": "Perlin",
+ "enum": ["Perlin", "Simplex", "Voronoi"],
+ "description": "Noise Type"
+ },
+ {
+ "name": "outputType",
+ "type": "\"Image\" | \"Video\"",
+ "signal": false,
+ "default": "Image",
+ "enum": ["Image", "Video"],
+ "description": "Output Type"
+ },
+ {
+ "name": "width",
+ "type": "number",
+ "signal": false,
+ "default": 512,
+ "min": 16,
+ "max": 4096,
+ "description": "Width"
+ },
+ {
+ "name": "height",
+ "type": "number",
+ "signal": false,
+ "default": 512,
+ "min": 16,
+ "max": 4096,
+ "description": "Height"
+ },
+ {
+ "name": "scale",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 10,
+ "min": 0.1,
+ "max": 100,
+ "description": "Scale of the noise pattern. Can be modulated by a static number or a dynamic signal."
+ },
+ {
+ "name": "octaves",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 4,
+ "min": 1,
+ "max": 8,
+ "description": "Fractal detail depth of the noise."
+ },
+ {
+ "name": "persistence",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 1,
+ "description": "Roughness multiplier for each fractal octave."
+ },
+ {
+ "name": "lacunarity",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 2,
+ "min": 1,
+ "max": 4,
+ "description": "Frequency spacing multiplier for each fractal octave."
+ },
+ {
+ "name": "speed",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 10,
+ "description": "Speed of time-based noise animation in Video mode."
+ },
+ {
+ "name": "colorStart",
+ "type": "string",
+ "signal": false,
+ "default": "#000000",
+ "description": "Color Start"
+ },
+ {
+ "name": "colorEnd",
+ "type": "string",
+ "signal": false,
+ "default": "#ffffff",
+ "description": "Color End"
+ },
+ {
+ "name": "durationMs",
+ "type": "number",
+ "signal": false,
+ "default": 5000,
+ "min": 1,
+ "max": 60000,
+ "description": "Duration (ms)"
+ },
+ {
+ "name": "fps",
+ "type": "number",
+ "signal": false,
+ "default": 30,
+ "min": 1,
+ "max": 120,
+ "description": "FPS"
+ }
+ ]
+ },
+ {
+ "name": "Paint",
+ "op": "Paint",
+ "kind": "effect",
+ "factory": "paint",
+ "node": "node-paint",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "width",
+ "type": "number",
+ "signal": false,
+ "default": 1080,
+ "min": 1,
+ "max": 16384
+ },
+ {
+ "name": "height",
+ "type": "number",
+ "signal": false,
+ "default": 1080,
+ "min": 1,
+ "max": 16384
+ },
+ {
+ "name": "maintainAspect",
+ "type": "boolean",
+ "signal": false,
+ "default": true
+ },
+ {
+ "name": "aspectRatio",
+ "type": "number",
+ "signal": false
+ },
+ {
+ "name": "backgroundColor",
+ "type": "string",
+ "signal": false,
+ "default": "#ffffff"
+ },
+ {
+ "name": "strokes",
+ "type": "(PaintStrokesItemOption1 | PaintStrokesItemOption2 | PaintStrokesItemOption3)[]",
+ "signal": false
+ }
+ ]
+ },
+ {
+ "name": "PatchHeal",
+ "op": "PatchHeal",
+ "kind": "effect",
+ "factory": "patchHeal",
+ "node": "node-patch-heal",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "patches",
+ "type": "PatchHealPatchesItem[]",
+ "signal": false,
+ "description": "List of patch healing operations applied sequentially."
+ },
+ {
+ "name": "centerX",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 1,
+ "description": "Horizontal normalized position of destination patch (0.0 to 1.0)."
+ },
+ {
+ "name": "centerY",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 1,
+ "description": "Vertical normalized position of destination patch (0.0 to 1.0)."
+ },
+ {
+ "name": "offsetX",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 50,
+ "min": -4096,
+ "max": 4096,
+ "description": "Horizontal pixel distance from destination to sample source patch."
+ },
+ {
+ "name": "offsetY",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": -4096,
+ "max": 4096,
+ "description": "Vertical pixel distance from destination to sample source patch."
+ },
+ {
+ "name": "radius",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 25,
+ "min": 1,
+ "max": 500,
+ "description": "Radius of the destination circular patch in pixels (used when no explicit Mask input is connected)."
+ },
+ {
+ "name": "sourceRadius",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 25,
+ "min": 1,
+ "max": 500,
+ "description": "Radius of the source sample circular patch in pixels."
+ },
+ {
+ "name": "feather",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 50,
+ "min": 0,
+ "max": 100,
+ "description": "Softness edge falloff percentage (0–100%)."
+ },
+ {
+ "name": "opacity",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 1,
+ "description": "Blending opacity of the healed patch (0.0–1.0)."
+ },
+ {
+ "name": "mode",
+ "type": "\"Clone\" | \"SeamlessHeal\" | \"TextureTransfer\"",
+ "signal": false,
+ "default": "SeamlessHeal",
+ "enum": ["Clone", "SeamlessHeal", "TextureTransfer"],
+ "description": "Healing algorithm: Clone (direct stamp), SeamlessHeal (Poisson color/lighting blend), TextureTransfer (luminance structure matching)."
+ }
+ ]
+ },
+ {
+ "name": "ProceduralVFX",
+ "op": "ProceduralVFX",
+ "kind": "effect",
+ "factory": "proceduralVFX",
+ "node": "node-procedural-vfx",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "effectType",
+ "type": "\"Smoke\" | \"Fire\" | \"Rain\" | \"Sparks\" | \"Snow\" | \"Dust\" | \"Lightning\" | \"Magic\" | \"LensFlare\" | \"Embers\" | \"EnergyBeam\"",
+ "signal": false,
+ "default": "Smoke",
+ "enum": [
+ "Smoke",
+ "Fire",
+ "Rain",
+ "Sparks",
+ "Snow",
+ "Dust",
+ "Lightning",
+ "Magic",
+ "LensFlare",
+ "Embers",
+ "EnergyBeam"
+ ],
+ "description": "Which procedural particle / light effect to synthesize."
+ },
+ {
+ "name": "outputType",
+ "type": "\"Image\" | \"Video\"",
+ "signal": false,
+ "default": "Video",
+ "enum": ["Image", "Video"],
+ "description": "Image renders a static frame; Video animates over time."
+ },
+ {
+ "name": "width",
+ "type": "number",
+ "signal": false,
+ "default": 1080,
+ "min": 16,
+ "max": 4096,
+ "description": "Width"
+ },
+ {
+ "name": "height",
+ "type": "number",
+ "signal": false,
+ "default": 1080,
+ "min": 16,
+ "max": 4096,
+ "description": "Height"
+ },
+ {
+ "name": "density",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.6,
+ "min": 0,
+ "max": 1,
+ "description": "Amount of particles / coverage of the effect. Can be modulated by a static number or dynamic signal."
+ },
+ {
+ "name": "scale",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.01,
+ "min": 0.001,
+ "max": 10,
+ "description": "Spatial frequency / particle size of the effect. Can be modulated by a signal."
+ },
+ {
+ "name": "speed",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 10,
+ "description": "Animation speed in Video mode. Can be modulated by a signal."
+ },
+ {
+ "name": "intensity",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.8,
+ "min": 0,
+ "max": 1,
+ "description": "Brightness / alpha gain of the effect. Can be modulated by a signal."
+ },
+ {
+ "name": "seed",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1234,
+ "min": 0,
+ "max": 1000000,
+ "description": "Deterministic shuffle of the random pattern. Can be modulated by a signal."
+ },
+ {
+ "name": "colorStart",
+ "type": "string",
+ "signal": false,
+ "default": "#ffffff",
+ "description": "Color Start"
+ },
+ {
+ "name": "colorEnd",
+ "type": "string",
+ "signal": false,
+ "default": "#ff5500",
+ "description": "Color End"
+ },
+ {
+ "name": "durationMs",
+ "type": "number",
+ "signal": false,
+ "default": 5000,
+ "min": 100,
+ "max": 100000,
+ "description": "Duration (ms)"
+ },
+ {
+ "name": "fps",
+ "type": "number",
+ "signal": false,
+ "default": 30,
+ "min": 1,
+ "max": 120,
+ "description": "FPS"
+ }
+ ]
+ },
+ {
+ "name": "RefineEdge",
+ "op": "RefineEdge",
+ "kind": "effect",
+ "factory": "refineEdge",
+ "node": "node-refine-edge",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "decontaminateAmount",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.7,
+ "min": 0,
+ "max": 1,
+ "description": "Amount of edge color spill decontamination/defringing (0.0–1.0)."
+ },
+ {
+ "name": "radius",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 2,
+ "min": 0.5,
+ "max": 50,
+ "description": "Radius in pixels around alpha transitions to refine and decontaminate."
+ },
+ {
+ "name": "smooth",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 5,
+ "min": 0,
+ "max": 100,
+ "description": "Matte edge smoothing curve intensity (0–100)."
+ },
+ {
+ "name": "feather",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 50,
+ "description": "Sub-pixel gaussian softness along the matte boundary."
+ },
+ {
+ "name": "shiftEdge",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": -100,
+ "max": 100,
+ "description": "Contract (<0) or expand (>0) the edge boundary (-100% to +100%)."
+ },
+ {
+ "name": "matteChannel",
+ "type": "\"Alpha\" | \"Luminance\" | \"Red\" | \"Green\" | \"Blue\"",
+ "signal": false,
+ "default": "Alpha",
+ "enum": ["Alpha", "Luminance", "Red", "Green", "Blue"],
+ "description": "Channel to extract matte from (Alpha, Luminance, Red, Green, Blue)."
+ },
+ {
+ "name": "outputMode",
+ "type": "\"Composite\" | \"MatteOnly\" | \"DecontaminatedRGB\"",
+ "signal": false,
+ "default": "Composite",
+ "enum": ["Composite", "MatteOnly", "DecontaminatedRGB"],
+ "description": "Composite (decontaminated RGB + refined alpha), MatteOnly (grayscale mask), DecontaminatedRGB (clean RGB with full alpha)."
+ }
+ ]
+ },
+ {
+ "name": "RefractionCaustics3D",
+ "op": "RefractionCaustics3D",
+ "kind": "effect",
+ "factory": "refractionCaustics3D",
+ "node": "node-refraction-caustics",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "ior",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1.52,
+ "min": 1,
+ "max": 2.5,
+ "description": "Index of Refraction (1.0=Air, 1.33=Water, 1.52=Crown Glass, 2.42=Diamond). Controls ray bending according to Snell's Law."
+ },
+ {
+ "name": "dispersion",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.04,
+ "min": 0,
+ "max": 0.2,
+ "description": "Chromatic dispersion (RGB wavelength splitting) creating prismatic rainbow fringing."
+ },
+ {
+ "name": "refractionScale",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 2,
+ "description": "Depth displacement scale and effective glass thickness factor."
+ },
+ {
+ "name": "causticBrightness",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.6,
+ "min": 0,
+ "max": 2,
+ "description": "Brightness multiplier for photometric caustic light rays focusing through curved glass."
+ },
+ {
+ "name": "causticScale",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0.1,
+ "max": 5,
+ "description": "Spatial frequency scale of photometric caustic patterns."
+ },
+ {
+ "name": "fluidRipples",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 1,
+ "description": "Dynamic liquid wave perturbation strength across the refractive surface."
+ },
+ {
+ "name": "rippleSpeed",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0,
+ "max": 5,
+ "description": "Speed of dynamic fluid wave animation."
+ },
+ {
+ "name": "roughness",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 1,
+ "description": "Microfacet frosted glass roughness and optical diffusion blur."
+ },
+ {
+ "name": "specularIntensity",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.8,
+ "min": 0,
+ "max": 2,
+ "description": "Fresnel specular reflection gleam intensity."
+ },
+ {
+ "name": "lightPosX",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.5,
+ "min": 0,
+ "max": 1,
+ "description": "Horizontal normalized coordinate (0.0 to 1.0) of incident light source."
+ },
+ {
+ "name": "lightPosY",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0.2,
+ "min": 0,
+ "max": 1,
+ "description": "Vertical normalized coordinate (0.0 to 1.0) of incident light source."
+ },
+ {
+ "name": "tintColor",
+ "type": "string",
+ "signal": false,
+ "default": "#ffffff",
+ "description": "Internal glass color tint and absorption."
+ },
+ {
+ "name": "tintStrength",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 0,
+ "min": 0,
+ "max": 1,
+ "description": "Strength of internal glass color tint absorption."
+ },
+ {
+ "name": "depthInvert",
+ "type": "boolean",
+ "signal": false,
+ "default": false,
+ "description": "Invert depth polarity (white = near vs black = near)."
+ },
+ {
+ "name": "depthScale",
+ "type": "EffectProp<number>",
+ "signal": true,
+ "default": 1,
+ "min": 0.1,
+ "max": 5,
+ "description": "Height-field surface normal extrusion exaggeration."
+ }
+ ]
+ },
+ {
+ "name": "ResizerScaler",
+ "op": "ResizerScaler",
+ "kind": "effect",
+ "factory": "resizerScaler",
+ "node": "node-resizer-scaler",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "aspectRatioPreset",
+ "type": "\"9:16\" | \"16:9\" | \"1:1\" | \"4:5\" | \"21:9\" | \"custom\"",
+ "signal": false,
+ "default": "16:9",
+ "enum": ["9:16", "16:9", "1:1", "4:5", "21:9", "custom"]
+ },
+ {
+ "name": "resolutionPreset",
+ "type": "\"4k\" | \"1080p\" | \"720p\" | \"480p\" | \"custom\"",
+ "signal": false,
+ "default": "1080p",
+ "enum": ["4k", "1080p", "720p", "480p", "custom"]
+ },
+ {
+ "name": "targetWidth",
+ "type": "number",
+ "signal": false,
+ "default": 1920,
+ "min": 1,
+ "max": 8192
+ },
+ {
+ "name": "targetHeight",
+ "type": "number",
+ "signal": false,
+ "default": 1080,
+ "min": 1,
+ "max": 8192
+ },
+ {
+ "name": "fitMode",
+ "type": "\"cover\" | \"contain\" | \"stretch\" | \"manual\"",
+ "signal": false,
+ "default": "contain",
+ "enum": ["cover", "contain", "stretch", "manual"]
+ },
+ {
+ "name": "zoom",
+ "type": "number",
+ "signal": false,
+ "default": 100,
+ "min": 1,
+ "max": 1000
+ },
+ {
+ "name": "offsetX",
+ "type": "number",
+ "signal": false,
+ "default": 0,
+ "min": -8192,
+ "max": 8192
+ },
+ {
+ "name": "offsetY",
+ "type": "number",
+ "signal": false,
+ "default": 0,
+ "min": -8192,
+ "max": 8192
+ },
+ {
+ "name": "backgroundMode",
+ "type": "\"solid\" | \"blurred\" | \"gradient\" | \"transparent\"",
+ "signal": false,
+ "default": "solid",
+ "enum": ["solid", "blurred", "gradient", "transparent"]
+ },
+ {
+ "name": "backgroundColor",
+ "type": "string",
+ "signal": false,
+ "default": "#000000FF"
+ },
+ {
+ "name": "backgroundColor2",
+ "type": "string",
+ "signal": false,
+ "default": "#000000FF"
+ },
+ {
+ "name": "blurRadius",
+ "type": "number",
+ "signal": false,
+ "default": 40,
+ "min": 0,
+ "max": 100
+ },
+ {
+ "name": "backgroundBrightness",
+ "type": "number",
+ "signal": false,
+ "default": 0.6,
+ "min": 0,
+ "max": 1
+ },
+ {
+ "name": "anchorX",
+ "type": "\"left\" | \"center\" | \"right\"",
+ "signal": false,
+ "default": "center",
+ "enum": ["left", "center", "right"]
+ },
+ {
+ "name": "anchorY",
+ "type": "\"top\" | \"center\" | \"bottom\"",
+ "signal": false,
+ "default": "center",
+ "enum": ["top", "center", "bottom"]
+ }
+ ]
+ },
+ {
+ "name": "StereoPanning",
+ "op": "StereoPanning",
+ "kind": "audio",
+ "factory": "stereoPanning",
+ "node": "node-stereo-panning",
+ "aliases": [],
+ "custom": null,
+ "props": [
+ {
+ "name": "pan",
+ "type": "number",
+ "signal": false,
+ "default": 0,
+ "min": -1,
+ "max": 1,
+ "description": "Stereo panning value: -1 (full left) to 1 (full right), 0 is center"
+ }
+ ]
+ },
{
"name": "Vignette",
"op": "Vignette",
diff --git a/packages/framefields/src/effects/generated/classes.ts b/packages/framefields/src/effects/generated/classes.ts
index f6aa54d4..a55717db 100644
--- a/packages/framefields/src/effects/generated/classes.ts
+++ b/packages/framefields/src/effects/generated/classes.ts
@@ -7,238 +7,2584 @@ import type { EffectProp } from "../types.js";
import { withDefaults } from "../with-defaults.js";
import { effectMeta } from "./meta.js";
+export interface CornerPinPointsItem {
+ /** Range 0 to 100. */
+ x: number;
+ /** Range 0 to 100. */
+ y: number;
+}
+
+export interface KenBurnsKeyframesItem {
+ id?: string;
+ /** Range 0 to 20000. */
+ durationMs: number;
+ /**
+ * Range 0 to 20000.
+ * @default 1000
+ */
+ holdMs: number;
+ /** Range 1 to 20. */
+ scale: number;
+ /** Range 0 to 100. */
+ x: number;
+ /** Range 0 to 100. */
+ y: number;
+ /**
+ * @default "ease-in-out"
+ */
+ easing: "linear" | "ease-in" | "ease-out" | "ease-in-out" | "spring";
+}
+
+export interface LayerStyleBevelEmboss {
+ /**
+ * @default false
+ */
+ enabled: boolean;
+ /**
+ * @default "InnerBevel"
+ */
+ style: "InnerBevel" | "OuterBevel" | "Emboss" | "PillowEmboss";
+ /**
+ * @default "Smooth"
+ */
+ technique: "Smooth" | "ChiselHard" | "ChiselSoft";
+ /**
+ * Range 1 to 1000.
+ * @default 100
+ */
+ depth: number;
+ /**
+ * @default "Up"
+ */
+ direction: "Up" | "Down";
+ /**
+ * Range 0 to 250.
+ * @default 5
+ */
+ size: number;
+ /**
+ * Range 0 to 50.
+ * @default 0
+ */
+ soften: number;
+ /**
+ * Range 0 to 360.
+ * @default 120
+ */
+ angle: number;
+ /**
+ * Range 0 to 90.
+ * @default 30
+ */
+ altitude: number;
+ /**
+ * @default "#ffffff"
+ */
+ highlightColor: string;
+ /**
+ * Range 0 to 1.
+ * @default 0.75
+ */
+ highlightOpacity: number;
+ /**
+ * @default "#000000"
+ */
+ shadowColor: string;
+ /**
+ * Range 0 to 1.
+ * @default 0.75
+ */
+ shadowOpacity: number;
+}
+
+export interface LayerStyleColorOverlay {
+ /**
+ * @default false
+ */
+ enabled: boolean;
+ /**
+ * @default "#ff0000"
+ */
+ color: string;
+ /**
+ * Range 0 to 1.
+ * @default 1
+ */
+ opacity: number;
+ /**
+ * @default "normal"
+ */
+ blendMode: string;
+}
+
+export interface LayerStyleDropShadow {
+ /**
+ * @default false
+ */
+ enabled: boolean;
+ /**
+ * @default "#000000"
+ */
+ color: string;
+ /**
+ * Range 0 to 1.
+ * @default 0.75
+ */
+ opacity: number;
+ /**
+ * Range 0 to 360.
+ * @default 120
+ */
+ angle: number;
+ /**
+ * Range 0 to 500.
+ * @default 10
+ */
+ distance: number;
+ /**
+ * Range 0 to 100.
+ * @default 0
+ */
+ spread: number;
+ /**
+ * Range 0 to 250.
+ * @default 10
+ */
+ size: number;
+ /**
+ * @default "multiply"
+ */
+ blendMode: string;
+}
+
+export interface LayerStyleInnerGlow {
+ /**
+ * @default false
+ */
+ enabled: boolean;
+ /**
+ * @default "#ffffff"
+ */
+ color: string;
+ /**
+ * Range 0 to 1.
+ * @default 0.75
+ */
+ opacity: number;
+ /**
+ * Range 0 to 250.
+ * @default 15
+ */
+ size: number;
+ /**
+ * Range 0 to 100.
+ * @default 0
+ */
+ spread: number;
+ /**
+ * @default "screen"
+ */
+ blendMode: string;
+}
+
+export interface LayerStyleInnerShadow {
+ /**
+ * @default false
+ */
+ enabled: boolean;
+ /**
+ * @default "#000000"
+ */
+ color: string;
+ /**
+ * Range 0 to 1.
+ * @default 0.75
+ */
+ opacity: number;
+ /**
+ * Range 0 to 360.
+ * @default 120
+ */
+ angle: number;
+ /**
+ * Range 0 to 500.
+ * @default 5
+ */
+ distance: number;
+ /**
+ * Range 0 to 100.
+ * @default 0
+ */
+ choke: number;
+ /**
+ * Range 0 to 250.
+ * @default 5
+ */
+ size: number;
+ /**
+ * @default "multiply"
+ */
+ blendMode: string;
+}
+
+export interface LayerStyleOuterGlow {
+ /**
+ * @default false
+ */
+ enabled: boolean;
+ /**
+ * @default "#ffffff"
+ */
+ color: string;
+ /**
+ * Range 0 to 1.
+ * @default 0.75
+ */
+ opacity: number;
+ /**
+ * Range 0 to 250.
+ * @default 15
+ */
+ size: number;
+ /**
+ * Range 0 to 100.
+ * @default 0
+ */
+ spread: number;
+ /**
+ * @default "screen"
+ */
+ blendMode: string;
+}
+
+export interface LayerStyleStroke {
+ /**
+ * @default false
+ */
+ enabled: boolean;
+ /**
+ * Range 0 to 100.
+ * @default 2
+ */
+ size: number;
+ /**
+ * @default "outside"
+ */
+ position: "inside" | "center" | "outside";
+ /**
+ * @default "#ffffff"
+ */
+ color: string;
+ /**
+ * Range 0 to 1.
+ * @default 1
+ */
+ opacity: number;
+ /**
+ * @default "normal"
+ */
+ blendMode: string;
+}
+
+export interface LiquifyOperationsItem {
+ /**
+ * @default "Bloat"
+ */
+ type: "Push" | "Pull" | "Bloat" | "Pucker" | "TwirlCW" | "TwirlCCW";
+ /** Range 0 to 1. */
+ x: number;
+ /** Range 0 to 1. */
+ y: number;
+ /**
+ * Range 0.01 to 1.
+ * @default 0.15
+ */
+ radius: number;
+ /**
+ * Range 0 to 1.
+ * @default 0.5
+ */
+ strength: number;
+ /**
+ * Range -1 to 1.
+ * @default 0
+ */
+ dx: number;
+ /**
+ * Range -1 to 1.
+ * @default 0
+ */
+ dy: number;
+}
+
+export interface MeshWarpPointsItem {
+ /** Range 0 to 100. */
+ x: number;
+ /** Range 0 to 100. */
+ y: number;
+}
+
+export interface PaintStrokesItemOption1 {
+ /**
+ * @default "brush"
+ */
+ id: string;
+ tool: "brush";
+ path: string;
+ color: string;
+ size: number;
+ /**
+ * Range 0 to 1.
+ * @default 1
+ */
+ opacity: number;
+}
+
+export interface PaintStrokesItemOption2 {
+ /**
+ * @default "eraser"
+ */
+ id: string;
+ tool: "eraser";
+ path: string;
+ size: number;
+}
+
+export interface PaintStrokesItemOption3 {
+ /**
+ * @default "fill"
+ */
+ id: string;
+ tool: "fill";
+ imageData: string;
+ /** Maximum 16384. */
+ width: number;
+ /** Maximum 16384. */
+ height: number;
+}
+
+export interface PatchHealPatchesItem {
+ /**
+ * @default "patch"
+ */
+ id: string;
+ /**
+ * Range 0 to 1.
+ * @default 0.5
+ */
+ centerX: number;
+ /**
+ * Range 0 to 1.
+ * @default 0.5
+ */
+ centerY: number;
+ /**
+ * Range -4096 to 4096.
+ * @default 50
+ */
+ offsetX: number;
+ /**
+ * Range -4096 to 4096.
+ * @default 0
+ */
+ offsetY: number;
+ /**
+ * Range 1 to 500.
+ * @default 25
+ */
+ radius: number;
+ /**
+ * Range 1 to 500.
+ * @default 25
+ */
+ sourceRadius: number;
+ /**
+ * Range 0 to 100.
+ * @default 50
+ */
+ feather: number;
+ /**
+ * Range 0 to 1.
+ * @default 1
+ */
+ opacity: number;
+ /**
+ * @default "SeamlessHeal"
+ */
+ mode: "Clone" | "SeamlessHeal" | "TextureTransfer";
+}
+
export interface TonalShift {
/**
- * Range -100 to 100.
- * @default 0
+ * Range -100 to 100.
+ * @default 0
+ */
+ cyanRed: number;
+ /**
+ * Range -100 to 100.
+ * @default 0
+ */
+ magentaGreen: number;
+ /**
+ * Range -100 to 100.
+ * @default 0
+ */
+ yellowBlue: number;
+}
+
+export interface AudioCompressorProps {
+ /**
+ * Level (dBFS) above which gain reduction begins (-60 to 0 dB). Can be modulated by a static number or dynamic signal.
+ * Range -60 to 0. Accepts a signal.
+ * @default -24
+ */
+ threshold?: EffectProp<number>;
+ /**
+ * Input-to-output ratio above threshold (1 to 100). Can be modulated by a static number or dynamic signal.
+ * Range 1 to 100. Accepts a signal.
+ * @default 4
+ */
+ ratio?: EffectProp<number>;
+ /**
+ * Seconds to reach full gain reduction (0.0001 to 1.0s). Can be modulated by a static number or dynamic signal.
+ * Range 0.0001 to 1. Accepts a signal.
+ * @default 0.003
+ */
+ attack?: EffectProp<number>;
+ /**
+ * Seconds to recover gain after signal drops (0.01 to 5.0s). Can be modulated by a static number or dynamic signal.
+ * Range 0.01 to 5. Accepts a signal.
+ * @default 0.25
+ */
+ release?: EffectProp<number>;
+ /**
+ * dB range for soft-knee transition around threshold (0 to 24 dB). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 24. Accepts a signal.
+ * @default 6
+ */
+ knee?: EffectProp<number>;
+ /**
+ * dBFS of gain applied after compression (0 to 24 dB). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 24. Accepts a signal.
+ * @default 0
+ */
+ makeupGain?: EffectProp<number>;
+}
+
+const audioCompressorDefaults: AudioCompressorProps = {
+ threshold: -24,
+ ratio: 4,
+ attack: 0.003,
+ release: 0.25,
+ knee: 6,
+ makeupGain: 0,
+};
+
+export class AudioCompressor extends Effect<AudioCompressorProps> {
+ public readonly op = "AudioCompressor";
+
+ public declare threshold: number;
+ public declare ratio: number;
+ public declare attack: number;
+ public declare release: number;
+ public declare knee: number;
+ public declare makeupGain: number;
+
+ constructor(config: AudioCompressorProps = {}) {
+ super(
+ withDefaults(
+ "AudioCompressor",
+ audioCompressorDefaults,
+ config,
+ effectMeta.AudioCompressor,
+ ),
+ );
+ }
+}
+
+export interface AudioDelayProps {
+ /**
+ * Delay time in seconds (0.001 to 5.0s). Can be modulated by a static number or dynamic signal.
+ * Range 0.001 to 5. Accepts a signal.
+ * @default 0.25
+ */
+ delayTime?: EffectProp<number>;
+ /**
+ * Amount of delayed signal fed back into delay line (0.0 to 0.95). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 0.95. Accepts a signal.
+ * @default 0.4
+ */
+ feedback?: EffectProp<number>;
+ /**
+ * Mix level of the wet delayed signal (0.0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.3
+ */
+ wet?: EffectProp<number>;
+ /**
+ * Mix level of the original dry signal (0.0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 1
+ */
+ dry?: EffectProp<number>;
+ /**
+ * Alternates echo reflections between left and right channels
+ * @default false
+ */
+ pingPong?: boolean;
+}
+
+const audioDelayDefaults: AudioDelayProps = {
+ delayTime: 0.25,
+ feedback: 0.4,
+ wet: 0.3,
+ dry: 1,
+ pingPong: false,
+};
+
+export class AudioDelay extends Effect<AudioDelayProps> {
+ public readonly op = "AudioDelay";
+
+ public declare delayTime: number;
+ public declare feedback: number;
+ public declare wet: number;
+ public declare dry: number;
+ public declare pingPong: boolean;
+
+ constructor(config: AudioDelayProps = {}) {
+ super(
+ withDefaults(
+ "AudioDelay",
+ audioDelayDefaults,
+ config,
+ effectMeta.AudioDelay,
+ ),
+ );
+ }
+}
+
+export interface AudioFadeProps {
+ /**
+ * Duration in seconds of fade in from silence (0 to 60s). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 60. Accepts a signal.
+ * @default 0
+ */
+ fadeInDuration?: EffectProp<number>;
+ /**
+ * Duration in seconds of fade out to silence (0 to 60s). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 60. Accepts a signal.
+ * @default 0
+ */
+ fadeOutDuration?: EffectProp<number>;
+ /**
+ * Envelope shape for fade in
+ * @default "linear"
+ */
+ fadeInCurve?: "linear" | "exponential" | "scurve";
+ /**
+ * Envelope shape for fade out
+ * @default "linear"
+ */
+ fadeOutCurve?: "linear" | "exponential" | "scurve";
+}
+
+const audioFadeDefaults: AudioFadeProps = {
+ fadeInDuration: 0,
+ fadeOutDuration: 0,
+ fadeInCurve: "linear",
+ fadeOutCurve: "linear",
+};
+
+export class AudioFade extends Effect<AudioFadeProps> {
+ public readonly op = "AudioFade";
+
+ public declare fadeInDuration: number;
+ public declare fadeOutDuration: number;
+ public declare fadeInCurve: "linear" | "exponential" | "scurve";
+ public declare fadeOutCurve: "linear" | "exponential" | "scurve";
+
+ constructor(config: AudioFadeProps = {}) {
+ super(
+ withDefaults(
+ "AudioFade",
+ audioFadeDefaults,
+ config,
+ effectMeta.AudioFade,
+ ),
+ );
+ }
+}
+
+export interface AudioNoiseGateProps {
+ /**
+ * dBFS level below which the gate closes (-120 to 0 dB). Can be modulated by a static number or dynamic signal.
+ * Range -120 to 0. Accepts a signal.
+ * @default -40
+ */
+ threshold?: EffectProp<number>;
+ /**
+ * Seconds to open (fade in) when signal exceeds threshold (0.0001 to 1.0s). Can be modulated by a static number or dynamic signal.
+ * Range 0.0001 to 1. Accepts a signal.
+ * @default 0.005
+ */
+ attack?: EffectProp<number>;
+ /**
+ * Seconds to stay open after signal drops below threshold (0.001 to 5.0s). Can be modulated by a static number or dynamic signal.
+ * Range 0.001 to 5. Accepts a signal.
+ * @default 0.05
+ */
+ hold?: EffectProp<number>;
+ /**
+ * Seconds to close (fade out) after hold expires (0.01 to 5.0s). Can be modulated by a static number or dynamic signal.
+ * Range 0.01 to 5. Accepts a signal.
+ * @default 0.1
+ */
+ release?: EffectProp<number>;
+ /**
+ * dBFS floor when gate is closed (-120 to 0 dB). Can be modulated by a static number or dynamic signal.
+ * Range -120 to 0. Accepts a signal.
+ * @default -80
+ */
+ range?: EffectProp<number>;
+}
+
+const audioNoiseGateDefaults: AudioNoiseGateProps = {
+ threshold: -40,
+ attack: 0.005,
+ hold: 0.05,
+ release: 0.1,
+ range: -80,
+};
+
+export class AudioNoiseGate extends Effect<AudioNoiseGateProps> {
+ public readonly op = "AudioNoiseGate";
+
+ public declare threshold: number;
+ public declare attack: number;
+ public declare hold: number;
+ public declare release: number;
+ public declare range: number;
+
+ constructor(config: AudioNoiseGateProps = {}) {
+ super(
+ withDefaults(
+ "AudioNoiseGate",
+ audioNoiseGateDefaults,
+ config,
+ effectMeta.AudioNoiseGate,
+ ),
+ );
+ }
+}
+
+export interface AudioParametricEqProps {
+ /**
+ * Type of biquad filter
+ * @default "peak"
+ */
+ type?: "lowShelf" | "highShelf" | "peak" | "lowPass" | "highPass" | "notch";
+ /**
+ * Cutoff or center frequency in Hz (20 to 20000 Hz). Can be modulated by a static number or dynamic signal.
+ * Range 20 to 20000. Accepts a signal.
+ * @default 1000
+ */
+ frequency?: EffectProp<number>;
+ /**
+ * Gain boost or cut in dB (-24 to 24 dB). Can be modulated by a static number or dynamic signal.
+ * Range -24 to 24. Accepts a signal.
+ * @default 0
+ */
+ gain?: EffectProp<number>;
+ /**
+ * Filter bandwidth / Q factor (0.01 to 10.0). Can be modulated by a static number or dynamic signal.
+ * Range 0.01 to 10. Accepts a signal.
+ * @default 1
+ */
+ q?: EffectProp<number>;
+}
+
+const audioParametricEqDefaults: AudioParametricEqProps = {
+ type: "peak",
+ frequency: 1000,
+ gain: 0,
+ q: 1,
+};
+
+export class AudioParametricEq extends Effect<AudioParametricEqProps> {
+ public readonly op = "AudioParametricEq";
+
+ public declare type:
+ | "lowShelf"
+ | "highShelf"
+ | "peak"
+ | "lowPass"
+ | "highPass"
+ | "notch";
+ public declare frequency: number;
+ public declare gain: number;
+ public declare q: number;
+
+ constructor(config: AudioParametricEqProps = {}) {
+ super(
+ withDefaults(
+ "AudioParametricEq",
+ audioParametricEqDefaults,
+ config,
+ effectMeta.AudioParametricEq,
+ ),
+ );
+ }
+}
+
+export interface AudioReverbProps {
+ /**
+ * Room decay, size of simulated space (0 to 0.98). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 0.98. Accepts a signal.
+ * @default 0.5
+ */
+ roomSize?: EffectProp<number>;
+ /**
+ * High-frequency absorption (0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ damping?: EffectProp<number>;
+ /**
+ * Mix level of the wet reverberated signal (0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.3
+ */
+ wet?: EffectProp<number>;
+ /**
+ * Mix level of the original dry signal (0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 1
+ */
+ dry?: EffectProp<number>;
+ /**
+ * Stereo spread of the reverb tail (0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 1
+ */
+ width?: EffectProp<number>;
+}
+
+const audioReverbDefaults: AudioReverbProps = {
+ roomSize: 0.5,
+ damping: 0.5,
+ wet: 0.3,
+ dry: 1,
+ width: 1,
+};
+
+export class AudioReverb extends Effect<AudioReverbProps> {
+ public readonly op = "AudioReverb";
+
+ public declare roomSize: number;
+ public declare damping: number;
+ public declare wet: number;
+ public declare dry: number;
+ public declare width: number;
+
+ constructor(config: AudioReverbProps = {}) {
+ super(
+ withDefaults(
+ "AudioReverb",
+ audioReverbDefaults,
+ config,
+ effectMeta.AudioReverb,
+ ),
+ );
+ }
+}
+
+export interface BlurBaseProps {
+ /**
+ * Blur Type
+ * @default "Gaussian"
+ */
+ blurType?:
+ | "Gaussian"
+ | "Box"
+ | "Median"
+ | "Motion"
+ | "Bilateral"
+ | "Edge-preserving"
+ | "Radial"
+ | "Zoom";
+ /**
+ * The intensity of the blur. 0 = no blur. Can be modulated by a static number or a dynamic signal.
+ * Range 0 to 100. Accepts a signal.
+ * @default 5
+ */
+ strength?: EffectProp<number>;
+ /**
+ * Direction of a Motion blur, in degrees.
+ * Range 0 to 360. Accepts a signal.
+ * @default 0
+ */
+ angle?: EffectProp<number>;
+ /**
+ * Sigma value for color space in Bilateral / Edge-preserving blurs. Can be modulated by a static number or a dynamic signal.
+ * Range 0.01 to 1. Accepts a signal.
+ * @default 0.1
+ */
+ sigmaColor?: EffectProp<number>;
+ /**
+ * The X coordinate of the blur center (0.0 to 1.0). Can be modulated by a static number or a dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ centerX?: EffectProp<number>;
+ /**
+ * The Y coordinate of the blur center (0.0 to 1.0). Can be modulated by a static number or a dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ centerY?: EffectProp<number>;
+ /**
+ * Blurs only a specific circular area around center point.
+ * Accepts a signal.
+ * @default false
+ */
+ partialBlur?: EffectProp<boolean>;
+ /**
+ * Radius of the partial blur region (0.01 to 1.0). Can be modulated by a static number or a dynamic signal.
+ * Range 0.01 to 1. Accepts a signal.
+ * @default 0.3
+ */
+ radius?: EffectProp<number>;
+ /**
+ * Vertical radius of the partial blur region (0 to 1.0). 0 reuses the horizontal radius.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0
+ */
+ radiusY?: EffectProp<number>;
+ /**
+ * Shape of the partial blur region.
+ * @default "circle"
+ */
+ shape?: "ellipse" | "circle" | "rect";
+}
+
+const blurDefaults: BlurBaseProps = {
+ blurType: "Gaussian",
+ strength: 5,
+ angle: 0,
+ sigmaColor: 0.1,
+ centerX: 0.5,
+ centerY: 0.5,
+ partialBlur: false,
+ radius: 0.3,
+ radiusY: 0,
+ shape: "circle",
+};
+
+/** @internal Extended by `effects/custom/blur.ts`, which exports `Blur`. */
+export class BlurBase extends Effect<BlurBaseProps> {
+ public readonly op = "Blur";
+
+ public declare blurType:
+ | "Gaussian"
+ | "Box"
+ | "Median"
+ | "Motion"
+ | "Bilateral"
+ | "Edge-preserving"
+ | "Radial"
+ | "Zoom";
+ public declare strength: number;
+ public declare angle: number;
+ public declare sigmaColor: number;
+ public declare centerX: number;
+ public declare centerY: number;
+ public declare partialBlur: boolean;
+ public declare radius: number;
+ public declare radiusY: number;
+ public declare shape: "ellipse" | "circle" | "rect";
+
+ constructor(config: BlurBaseProps = {}) {
+ super(withDefaults("Blur", blurDefaults, config, effectMeta.Blur));
+ }
+}
+
+export interface CameraParallax3DProps {
+ /**
+ * Motion Preset
+ * @default "DollyZoom"
+ */
+ motionPreset?:
+ | "Custom"
+ | "DollyZoom"
+ | "Orbit"
+ | "FlyThrough"
+ | "HandheldShake"
+ | "RackFocus";
+ /**
+ * Horizontal camera pan angle / position offset (-1.0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range -1 to 1. Accepts a signal.
+ * @default 0
+ */
+ panX?: EffectProp<number>;
+ /**
+ * Vertical camera tilt angle / position offset (-1.0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range -1 to 1. Accepts a signal.
+ * @default 0
+ */
+ panY?: EffectProp<number>;
+ /**
+ * Camera forward/backward zoom position (-1.0 to 1.0). Can be modulated by a static number or dynamic signal.
+ * Range -1 to 1. Accepts a signal.
+ * @default 0
+ */
+ dollyZ?: EffectProp<number>;
+ /**
+ * Camera Field of View in degrees (15° to 120°). Can be modulated by a static number or dynamic signal.
+ * Range 15 to 120. Accepts a signal.
+ * @default 50
+ */
+ fov?: EffectProp<number>;
+ /**
+ * Strength of 3D spatial displacement depth relief. Can be modulated by a static number or dynamic signal.
+ * Range 0 to 2. Accepts a signal.
+ * @default 0.6
+ */
+ parallaxAmount?: EffectProp<number>;
+ /**
+ * Lens aperture size / Circle of Confusion bokeh blur radius. Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.3
+ */
+ dofAperture?: EffectProp<number>;
+ /**
+ * Focal plane depth in scene (0.0=foreground, 1.0=background). Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.4
+ */
+ focusPlane?: EffectProp<number>;
+ /**
+ * Inpainting border bleed to eliminate border occlusion tearing.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ edgeDilation?: EffectProp<number>;
+ /**
+ * Invert depth polarity (white = near vs black = near).
+ * @default false
+ */
+ depthInvert?: boolean;
+}
+
+const cameraParallax3DDefaults: CameraParallax3DProps = {
+ motionPreset: "DollyZoom",
+ panX: 0,
+ panY: 0,
+ dollyZ: 0,
+ fov: 50,
+ parallaxAmount: 0.6,
+ dofAperture: 0.3,
+ focusPlane: 0.4,
+ edgeDilation: 0.5,
+ depthInvert: false,
+};
+
+export class CameraParallax3D extends Effect<CameraParallax3DProps> {
+ public readonly op = "CameraParallax3D";
+
+ public declare motionPreset:
+ | "Custom"
+ | "DollyZoom"
+ | "Orbit"
+ | "FlyThrough"
+ | "HandheldShake"
+ | "RackFocus";
+ public declare panX: number;
+ public declare panY: number;
+ public declare dollyZ: number;
+ public declare fov: number;
+ public declare parallaxAmount: number;
+ public declare dofAperture: number;
+ public declare focusPlane: number;
+ public declare edgeDilation: number;
+ public declare depthInvert: boolean;
+
+ constructor(config: CameraParallax3DProps = {}) {
+ super(
+ withDefaults(
+ "CameraParallax3D",
+ cameraParallax3DDefaults,
+ config,
+ effectMeta.CameraParallax3D,
+ ),
+ );
+ }
+}
+
+export interface ChannelMergerProps {
+ /**
+ * Color space used for channel recombination (RGBA, HSLA, CMYK, or LAB).
+ * @default "RGBA"
+ */
+ colorSpace?: "RGBA" | "HSLA" | "CMYK" | "LAB";
+ /**
+ * Fallback value used when Channel 4 is unconnected (Alpha=1.0, Black=0.0 in CMYK).
+ * Range 0 to 1. Accepts a signal.
+ * @default 1
+ */
+ defaultChannel4?: EffectProp<number>;
+}
+
+const channelMergerDefaults: ChannelMergerProps = {
+ colorSpace: "RGBA",
+ defaultChannel4: 1,
+};
+
+export class ChannelMerger extends Effect<ChannelMergerProps> {
+ public readonly op = "ChannelMerger";
+
+ public declare colorSpace: "RGBA" | "HSLA" | "CMYK" | "LAB";
+ public declare defaultChannel4: number;
+
+ constructor(config: ChannelMergerProps = {}) {
+ super(
+ withDefaults(
+ "ChannelMerger",
+ channelMergerDefaults,
+ config,
+ effectMeta.ChannelMerger,
+ ),
+ );
+ }
+}
+
+export interface ChannelSplitterProps {
+ /**
+ * Color space used for channel decomposition (RGBA, HSLA, CMYK, or LAB).
+ * @default "RGBA"
+ */
+ colorSpace?: "RGBA" | "HSLA" | "CMYK" | "LAB";
+}
+
+const channelSplitterDefaults: ChannelSplitterProps = {
+ colorSpace: "RGBA",
+};
+
+export class ChannelSplitter extends Effect<ChannelSplitterProps> {
+ public readonly op = "ChannelSplitter";
+
+ public declare colorSpace: "RGBA" | "HSLA" | "CMYK" | "LAB";
+
+ constructor(config: ChannelSplitterProps = {}) {
+ super(
+ withDefaults(
+ "ChannelSplitter",
+ channelSplitterDefaults,
+ config,
+ effectMeta.ChannelSplitter,
+ ),
+ );
+ }
+}
+
+export interface ColorBalanceProps {
+ /**
+ * @default {"cyanRed":0,"magentaGreen":0,"yellowBlue":0}
+ */
+ shadows?: Partial<TonalShift>;
+ /**
+ * @default {"cyanRed":0,"magentaGreen":0,"yellowBlue":0}
+ */
+ midtones?: Partial<TonalShift>;
+ /**
+ * @default {"cyanRed":0,"magentaGreen":0,"yellowBlue":0}
+ */
+ highlights?: Partial<TonalShift>;
+ /**
+ * @default true
+ */
+ preserveLuminosity?: boolean;
+}
+
+const colorBalanceDefaults: ColorBalanceProps = {
+ shadows: { cyanRed: 0, magentaGreen: 0, yellowBlue: 0 },
+ midtones: { cyanRed: 0, magentaGreen: 0, yellowBlue: 0 },
+ highlights: { cyanRed: 0, magentaGreen: 0, yellowBlue: 0 },
+ preserveLuminosity: true,
+};
+
+export class ColorBalance extends Effect<ColorBalanceProps> {
+ public readonly op = "ColorBalance";
+
+ public declare shadows: Partial<TonalShift>;
+ public declare midtones: Partial<TonalShift>;
+ public declare highlights: Partial<TonalShift>;
+ public declare preserveLuminosity: boolean;
+
+ constructor(config: ColorBalanceProps = {}) {
+ super(
+ withDefaults(
+ "ColorBalance",
+ colorBalanceDefaults,
+ config,
+ effectMeta.ColorBalance,
+ ),
+ );
+ }
+}
+
+export interface ColorKeyProps {
+ /**
+ * Key Color
+ * @default "#00ff00"
+ */
+ keyColor?: string;
+ /**
+ * How close the color must be to the Key Color to be removed.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.4
+ */
+ similarity?: EffectProp<number>;
+ /**
+ * The softness of the transparency edge.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.1
+ */
+ smoothness?: EffectProp<number>;
+ /**
+ * Amount of key color spill to remove from foreground edges.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.2
+ */
+ spillSuppression?: EffectProp<number>;
+ /**
+ * Color space used to calculate similarity distance.
+ * @default "YUV"
+ */
+ colorSpace?: "YUV" | "RGB";
+ /**
+ * How key color spill is suppressed on foreground edges.
+ * @default "Desaturate"
+ */
+ spillSuppressionType?: "Desaturate" | "Neutralize" | "None";
+}
+
+const colorKeyDefaults: ColorKeyProps = {
+ keyColor: "#00ff00",
+ similarity: 0.4,
+ smoothness: 0.1,
+ spillSuppression: 0.2,
+ colorSpace: "YUV",
+ spillSuppressionType: "Desaturate",
+};
+
+export class ColorKey extends Effect<ColorKeyProps> {
+ public readonly op = "ColorKey";
+
+ public declare keyColor: string;
+ public declare similarity: number;
+ public declare smoothness: number;
+ public declare spillSuppression: number;
+ public declare colorSpace: "YUV" | "RGB";
+ public declare spillSuppressionType: "Desaturate" | "Neutralize" | "None";
+
+ constructor(config: ColorKeyProps = {}) {
+ super(
+ withDefaults("ColorKey", colorKeyDefaults, config, effectMeta.ColorKey),
+ );
+ }
+}
+
+export interface CornerPinProps {
+ points?: CornerPinPointsItem[];
+}
+
+const cornerPinDefaults: CornerPinProps = {};
+
+export class CornerPin extends Effect<CornerPinProps> {
+ public readonly op = "CornerPin";
+
+ public declare points: CornerPinPointsItem[] | undefined;
+
+ constructor(config: CornerPinProps = {}) {
+ super(
+ withDefaults(
+ "CornerPin",
+ cornerPinDefaults,
+ config,
+ effectMeta.CornerPin,
+ ),
+ );
+ }
+}
+
+export interface DisplacementMapProps {
+ /**
+ * Horizontal displacement strength in pixels. Can be modulated by a static number or a dynamic signal.
+ * Range 0 to 500. Accepts a signal.
+ * @default 50
+ */
+ strengthX?: EffectProp<number>;
+ /**
+ * Vertical displacement strength in pixels. Can be modulated by a static number or a dynamic signal.
+ * Range 0 to 500. Accepts a signal.
+ * @default 50
+ */
+ strengthY?: EffectProp<number>;
+ /**
+ * X Channel
+ * @default "Red"
+ */
+ xChannel?: "Red" | "Green" | "Blue" | "Alpha" | "Luminance";
+ /**
+ * Y Channel
+ * @default "Green"
+ */
+ yChannel?: "Red" | "Green" | "Blue" | "Alpha" | "Luminance";
+ /**
+ * Wrap Mode
+ * @default "Clamp"
+ */
+ wrapMode?: "Clamp" | "Repeat" | "Mirror";
+}
+
+const displacementMapDefaults: DisplacementMapProps = {
+ strengthX: 50,
+ strengthY: 50,
+ xChannel: "Red",
+ yChannel: "Green",
+ wrapMode: "Clamp",
+};
+
+export class DisplacementMap extends Effect<DisplacementMapProps> {
+ public readonly op = "DisplacementMap";
+
+ public declare strengthX: number;
+ public declare strengthY: number;
+ public declare xChannel: "Red" | "Green" | "Blue" | "Alpha" | "Luminance";
+ public declare yChannel: "Red" | "Green" | "Blue" | "Alpha" | "Luminance";
+ public declare wrapMode: "Clamp" | "Repeat" | "Mirror";
+
+ constructor(config: DisplacementMapProps = {}) {
+ super(
+ withDefaults(
+ "DisplacementMap",
+ displacementMapDefaults,
+ config,
+ effectMeta.DisplacementMap,
+ ),
+ );
+ }
+}
+
+export interface ExtractLUTProps {
+ /**
+ * Extraction Strategy
+ * @default "deterministic"
+ */
+ strategy?: "deterministic" | "statistical";
+ /**
+ * Sample Points
+ * Range 10 to 500. Accepts a signal.
+ * @default 150
+ */
+ samplePoints?: EffectProp<number>;
+}
+
+const extractLUTDefaults: ExtractLUTProps = {
+ strategy: "deterministic",
+ samplePoints: 150,
+};
+
+export class ExtractLUT extends Effect<ExtractLUTProps> {
+ public readonly op = "ExtractLUT";
+
+ public declare strategy: "deterministic" | "statistical";
+ public declare samplePoints: number;
+
+ constructor(config: ExtractLUTProps = {}) {
+ super(
+ withDefaults(
+ "ExtractLUT",
+ extractLUTDefaults,
+ config,
+ effectMeta.ExtractLUT,
+ ),
+ );
+ }
+}
+
+export interface FlipProps {
+ /**
+ * Mirror horizontally along the vertical center axis.
+ * @default true
+ */
+ horizontal?: boolean;
+ /**
+ * Mirror vertically along the horizontal center axis.
+ * @default false
+ */
+ vertical?: boolean;
+ /**
+ * Swap horizontal and vertical axes (diagonal transposition).
+ * @default false
+ */
+ diagonal?: boolean;
+ /**
+ * Quick preset mode for flipping or transposition.
+ * @default "horizontal"
+ */
+ mode?:
+ | "horizontal"
+ | "vertical"
+ | "both"
+ | "diagonal"
+ | "antiDiagonal"
+ | "custom";
+ /**
+ * Split-mirror reflection and symmetry effects.
+ * @default "none"
+ */
+ symmetry?:
+ | "none"
+ | "leftToRight"
+ | "rightToLeft"
+ | "topToBottom"
+ | "bottomToTop"
+ | "quadrant";
+}
+
+const flipDefaults: FlipProps = {
+ horizontal: true,
+ vertical: false,
+ diagonal: false,
+ mode: "horizontal",
+ symmetry: "none",
+};
+
+export class Flip extends Effect<FlipProps> {
+ public readonly op = "Flip";
+
+ public declare horizontal: boolean;
+ public declare vertical: boolean;
+ public declare diagonal: boolean;
+ public declare mode:
+ | "horizontal"
+ | "vertical"
+ | "both"
+ | "diagonal"
+ | "antiDiagonal"
+ | "custom";
+ public declare symmetry:
+ | "none"
+ | "leftToRight"
+ | "rightToLeft"
+ | "topToBottom"
+ | "bottomToTop"
+ | "quadrant";
+
+ constructor(config: FlipProps = {}) {
+ super(withDefaults("Flip", flipDefaults, config, effectMeta.Flip));
+ }
+}
+
+export interface KenBurnsProps {
+ /**
+ * @default []
+ */
+ keyframes?: KenBurnsKeyframesItem[];
+ /**
+ * Range 0 to 10.
+ * @default 1.5
+ */
+ motionBlurSize?: number;
+ /**
+ * @default "spline"
+ */
+ movementStyle?: "spline" | "direct";
+ /**
+ * @default "input"
+ */
+ aspectRatio?:
+ | "input"
+ | "16:9"
+ | "9:16"
+ | "21:9"
+ | "9:21"
+ | "1:1"
+ | "4:3"
+ | "3:2"
+ | "2:3"
+ | "4:5"
+ | "5:4";
+}
+
+const kenBurnsDefaults: KenBurnsProps = {
+ keyframes: [],
+ motionBlurSize: 1.5,
+ movementStyle: "spline",
+ aspectRatio: "input",
+};
+
+export class KenBurns extends Effect<KenBurnsProps> {
+ public readonly op = "KenBurns";
+
+ public declare keyframes: KenBurnsKeyframesItem[];
+ public declare motionBlurSize: number;
+ public declare movementStyle: "spline" | "direct";
+ public declare aspectRatio:
+ | "input"
+ | "16:9"
+ | "9:16"
+ | "21:9"
+ | "9:21"
+ | "1:1"
+ | "4:3"
+ | "3:2"
+ | "2:3"
+ | "4:5"
+ | "5:4";
+
+ constructor(config: KenBurnsProps = {}) {
+ super(
+ withDefaults("KenBurns", kenBurnsDefaults, config, effectMeta.KenBurns),
+ );
+ }
+}
+
+export interface LayerStyleProps {
+ /**
+ * @default {"enabled":false,"color":"#000000","opacity":0.75,"angle":120,"distance":10,"spread":0,"size":10,"blendMode":"multiply"}
+ */
+ dropShadow?: Partial<LayerStyleDropShadow>;
+ /**
+ * @default {"enabled":false,"color":"#000000","opacity":0.75,"angle":120,"distance":5,"choke":0,"size":5,"blendMode":"multiply"}
+ */
+ innerShadow?: Partial<LayerStyleInnerShadow>;
+ /**
+ * @default {"enabled":false,"color":"#ffffff","opacity":0.75,"size":15,"spread":0,"blendMode":"screen"}
+ */
+ outerGlow?: Partial<LayerStyleOuterGlow>;
+ /**
+ * @default {"enabled":false,"color":"#ffffff","opacity":0.75,"size":15,"spread":0,"blendMode":"screen"}
+ */
+ innerGlow?: Partial<LayerStyleInnerGlow>;
+ /**
+ * @default {"enabled":false,"size":2,"position":"outside","color":"#ffffff","opacity":1,"blendMode":"normal"}
+ */
+ stroke?: Partial<LayerStyleStroke>;
+ /**
+ * @default {"enabled":false,"style":"InnerBevel","technique":"Smooth","depth":100,"direction":"Up","size":5,"soften":0,"angle":120,"altitude":30,"highlightColor":"#ffffff","highlightOpacity":0.75,"shadowColor":"#000000","shadowOpacity":0.75}
+ */
+ bevelEmboss?: Partial<LayerStyleBevelEmboss>;
+ /**
+ * @default {"enabled":false,"color":"#ff0000","opacity":1,"blendMode":"normal"}
+ */
+ colorOverlay?: Partial<LayerStyleColorOverlay>;
+ dropShadowAngleHandleId?: string | null;
+ dropShadowDistanceHandleId?: string | null;
+ dropShadowSpreadHandleId?: string | null;
+ dropShadowSizeHandleId?: string | null;
+ dropShadowOpacityHandleId?: string | null;
+ innerShadowAngleHandleId?: string | null;
+ innerShadowDistanceHandleId?: string | null;
+ innerShadowChokeHandleId?: string | null;
+ innerShadowSizeHandleId?: string | null;
+ innerShadowOpacityHandleId?: string | null;
+ outerGlowSizeHandleId?: string | null;
+ outerGlowSpreadHandleId?: string | null;
+ outerGlowOpacityHandleId?: string | null;
+ innerGlowSizeHandleId?: string | null;
+ innerGlowSpreadHandleId?: string | null;
+ innerGlowOpacityHandleId?: string | null;
+ strokeSizeHandleId?: string | null;
+ strokeOpacityHandleId?: string | null;
+ bevelEmbossDepthHandleId?: string | null;
+ bevelEmbossSizeHandleId?: string | null;
+ bevelEmbossSoftenHandleId?: string | null;
+ bevelEmbossAngleHandleId?: string | null;
+ bevelEmbossAltitudeHandleId?: string | null;
+ bevelEmbossHighlightOpacityHandleId?: string | null;
+ bevelEmbossShadowOpacityHandleId?: string | null;
+ colorOverlayOpacityHandleId?: string | null;
+}
+
+const layerStyleDefaults: LayerStyleProps = {
+ dropShadow: {
+ enabled: false,
+ color: "#000000",
+ opacity: 0.75,
+ angle: 120,
+ distance: 10,
+ spread: 0,
+ size: 10,
+ blendMode: "multiply",
+ },
+ innerShadow: {
+ enabled: false,
+ color: "#000000",
+ opacity: 0.75,
+ angle: 120,
+ distance: 5,
+ choke: 0,
+ size: 5,
+ blendMode: "multiply",
+ },
+ outerGlow: {
+ enabled: false,
+ color: "#ffffff",
+ opacity: 0.75,
+ size: 15,
+ spread: 0,
+ blendMode: "screen",
+ },
+ innerGlow: {
+ enabled: false,
+ color: "#ffffff",
+ opacity: 0.75,
+ size: 15,
+ spread: 0,
+ blendMode: "screen",
+ },
+ stroke: {
+ enabled: false,
+ size: 2,
+ position: "outside",
+ color: "#ffffff",
+ opacity: 1,
+ blendMode: "normal",
+ },
+ bevelEmboss: {
+ enabled: false,
+ style: "InnerBevel",
+ technique: "Smooth",
+ depth: 100,
+ direction: "Up",
+ size: 5,
+ soften: 0,
+ angle: 120,
+ altitude: 30,
+ highlightColor: "#ffffff",
+ highlightOpacity: 0.75,
+ shadowColor: "#000000",
+ shadowOpacity: 0.75,
+ },
+ colorOverlay: {
+ enabled: false,
+ color: "#ff0000",
+ opacity: 1,
+ blendMode: "normal",
+ },
+};
+
+export class LayerStyle extends Effect<LayerStyleProps> {
+ public readonly op = "LayerStyle";
+
+ public declare dropShadow: Partial<LayerStyleDropShadow>;
+ public declare innerShadow: Partial<LayerStyleInnerShadow>;
+ public declare outerGlow: Partial<LayerStyleOuterGlow>;
+ public declare innerGlow: Partial<LayerStyleInnerGlow>;
+ public declare stroke: Partial<LayerStyleStroke>;
+ public declare bevelEmboss: Partial<LayerStyleBevelEmboss>;
+ public declare colorOverlay: Partial<LayerStyleColorOverlay>;
+ public declare dropShadowAngleHandleId: string | null | undefined;
+ public declare dropShadowDistanceHandleId: string | null | undefined;
+ public declare dropShadowSpreadHandleId: string | null | undefined;
+ public declare dropShadowSizeHandleId: string | null | undefined;
+ public declare dropShadowOpacityHandleId: string | null | undefined;
+ public declare innerShadowAngleHandleId: string | null | undefined;
+ public declare innerShadowDistanceHandleId: string | null | undefined;
+ public declare innerShadowChokeHandleId: string | null | undefined;
+ public declare innerShadowSizeHandleId: string | null | undefined;
+ public declare innerShadowOpacityHandleId: string | null | undefined;
+ public declare outerGlowSizeHandleId: string | null | undefined;
+ public declare outerGlowSpreadHandleId: string | null | undefined;
+ public declare outerGlowOpacityHandleId: string | null | undefined;
+ public declare innerGlowSizeHandleId: string | null | undefined;
+ public declare innerGlowSpreadHandleId: string | null | undefined;
+ public declare innerGlowOpacityHandleId: string | null | undefined;
+ public declare strokeSizeHandleId: string | null | undefined;
+ public declare strokeOpacityHandleId: string | null | undefined;
+ public declare bevelEmbossDepthHandleId: string | null | undefined;
+ public declare bevelEmbossSizeHandleId: string | null | undefined;
+ public declare bevelEmbossSoftenHandleId: string | null | undefined;
+ public declare bevelEmbossAngleHandleId: string | null | undefined;
+ public declare bevelEmbossAltitudeHandleId: string | null | undefined;
+ public declare bevelEmbossHighlightOpacityHandleId: string | null | undefined;
+ public declare bevelEmbossShadowOpacityHandleId: string | null | undefined;
+ public declare colorOverlayOpacityHandleId: string | null | undefined;
+
+ constructor(config: LayerStyleProps = {}) {
+ super(
+ withDefaults(
+ "LayerStyle",
+ layerStyleDefaults,
+ config,
+ effectMeta.LayerStyle,
+ ),
+ );
+ }
+}
+
+export interface LiquifyProps {
+ /**
+ * List of localized liquify deformation operations.
+ * @default []
+ */
+ operations?: LiquifyOperationsItem[];
+}
+
+const liquifyDefaults: LiquifyProps = {
+ operations: [],
+};
+
+export class Liquify extends Effect<LiquifyProps> {
+ public readonly op = "Liquify";
+
+ public declare operations: LiquifyOperationsItem[];
+
+ constructor(config: LiquifyProps = {}) {
+ super(withDefaults("Liquify", liquifyDefaults, config, effectMeta.Liquify));
+ }
+}
+
+export interface MaskMathProps {
+ /**
+ * Morphological or Boolean set operation applied to input alpha masks.
+ * @default "Union"
+ */
+ operation?:
+ | "Union"
+ | "Intersect"
+ | "Subtract"
+ | "Difference"
+ | "Invert"
+ | "Dilate"
+ | "Erode"
+ | "Choke"
+ | "Feather";
+ /**
+ * Kernel radius in pixels for Dilate, Erode, Choke, or Feather operations.
+ * Range 0 to 200. Accepts a signal.
+ * @default 0
+ */
+ radius?: EffectProp<number>;
+ /**
+ * Cutoff threshold level (0.0–1.0) for binarization step or non-linear choke.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ threshold?: EffectProp<number>;
+ /**
+ * Minimum alpha matte cutoff limit (0.0–1.0).
+ * Range 0 to 1. Accepts a signal.
+ * @default 0
+ */
+ clampMin?: EffectProp<number>;
+ /**
+ * Maximum alpha matte cutoff limit (0.0–1.0).
+ * Range 0 to 1. Accepts a signal.
+ * @default 1
+ */
+ clampMax?: EffectProp<number>;
+ /**
+ * Source channel to extract mask from Mask A (Alpha, Luminance, Red, Green, Blue).
+ * @default "Alpha"
+ */
+ channelA?: "Alpha" | "Luminance" | "Red" | "Green" | "Blue";
+ /**
+ * Source channel to extract mask from Mask B (Alpha, Luminance, Red, Green, Blue).
+ * @default "Alpha"
+ */
+ channelB?: "Alpha" | "Luminance" | "Red" | "Green" | "Blue";
+ /**
+ * When enabled, outputs crisp 1-bit binary matte based on threshold.
+ * @default false
+ */
+ binarize?: boolean;
+ /**
+ * Inverts final matte output.
+ * @default false
+ */
+ invertResult?: boolean;
+ /**
+ * WhiteWithAlpha (rgba(1,1,1,a)), GrayscaleRGB (rgba(a,a,a,1)), AlphaOnly (rgba(0,0,0,a)), PassthroughRGB (Mask A RGB with new alpha).
+ * @default "WhiteWithAlpha"
+ */
+ outputFormat?:
+ | "WhiteWithAlpha"
+ | "GrayscaleRGB"
+ | "AlphaOnly"
+ | "PassthroughRGB";
+}
+
+const maskMathDefaults: MaskMathProps = {
+ operation: "Union",
+ radius: 0,
+ threshold: 0.5,
+ clampMin: 0,
+ clampMax: 1,
+ channelA: "Alpha",
+ channelB: "Alpha",
+ binarize: false,
+ invertResult: false,
+ outputFormat: "WhiteWithAlpha",
+};
+
+export class MaskMath extends Effect<MaskMathProps> {
+ public readonly op = "MaskMath";
+
+ public declare operation:
+ | "Union"
+ | "Intersect"
+ | "Subtract"
+ | "Difference"
+ | "Invert"
+ | "Dilate"
+ | "Erode"
+ | "Choke"
+ | "Feather";
+ public declare radius: number;
+ public declare threshold: number;
+ public declare clampMin: number;
+ public declare clampMax: number;
+ public declare channelA: "Alpha" | "Luminance" | "Red" | "Green" | "Blue";
+ public declare channelB: "Alpha" | "Luminance" | "Red" | "Green" | "Blue";
+ public declare binarize: boolean;
+ public declare invertResult: boolean;
+ public declare outputFormat:
+ | "WhiteWithAlpha"
+ | "GrayscaleRGB"
+ | "AlphaOnly"
+ | "PassthroughRGB";
+
+ constructor(config: MaskMathProps = {}) {
+ super(
+ withDefaults("MaskMath", maskMathDefaults, config, effectMeta.MaskMath),
+ );
+ }
+}
+
+export interface MeshWarpProps {
+ /**
+ * Range 2 to 12.
+ * @default 3
+ */
+ cols?: number;
+ /**
+ * Range 2 to 12.
+ * @default 3
+ */
+ rows?: number;
+ points?: MeshWarpPointsItem[];
+}
+
+const meshWarpDefaults: MeshWarpProps = {
+ cols: 3,
+ rows: 3,
+};
+
+export class MeshWarp extends Effect<MeshWarpProps> {
+ public readonly op = "MeshWarp";
+
+ public declare cols: number;
+ public declare rows: number;
+ public declare points: MeshWarpPointsItem[] | undefined;
+
+ constructor(config: MeshWarpProps = {}) {
+ super(
+ withDefaults("MeshWarp", meshWarpDefaults, config, effectMeta.MeshWarp),
+ );
+ }
+}
+
+export interface NoiseGeneratorProps {
+ /**
+ * Noise Type
+ * @default "Perlin"
+ */
+ noiseType?: "Perlin" | "Simplex" | "Voronoi";
+ /**
+ * Output Type
+ * @default "Image"
+ */
+ outputType?: "Image" | "Video";
+ /**
+ * Width
+ * Range 16 to 4096.
+ * @default 512
+ */
+ width?: number;
+ /**
+ * Height
+ * Range 16 to 4096.
+ * @default 512
+ */
+ height?: number;
+ /**
+ * Scale of the noise pattern. Can be modulated by a static number or a dynamic signal.
+ * Range 0.1 to 100. Accepts a signal.
+ * @default 10
+ */
+ scale?: EffectProp<number>;
+ /**
+ * Fractal detail depth of the noise.
+ * Range 1 to 8. Accepts a signal.
+ * @default 4
+ */
+ octaves?: EffectProp<number>;
+ /**
+ * Roughness multiplier for each fractal octave.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ persistence?: EffectProp<number>;
+ /**
+ * Frequency spacing multiplier for each fractal octave.
+ * Range 1 to 4. Accepts a signal.
+ * @default 2
+ */
+ lacunarity?: EffectProp<number>;
+ /**
+ * Speed of time-based noise animation in Video mode.
+ * Range 0 to 10. Accepts a signal.
+ * @default 1
+ */
+ speed?: EffectProp<number>;
+ /**
+ * Color Start
+ * @default "#000000"
+ */
+ colorStart?: string;
+ /**
+ * Color End
+ * @default "#ffffff"
+ */
+ colorEnd?: string;
+ /**
+ * Duration (ms)
+ * Range 1 to 60000.
+ * @default 5000
+ */
+ durationMs?: number;
+ /**
+ * FPS
+ * Range 1 to 120.
+ * @default 30
+ */
+ fps?: number;
+}
+
+const noiseGeneratorDefaults: NoiseGeneratorProps = {
+ noiseType: "Perlin",
+ outputType: "Image",
+ width: 512,
+ height: 512,
+ scale: 10,
+ octaves: 4,
+ persistence: 0.5,
+ lacunarity: 2,
+ speed: 1,
+ colorStart: "#000000",
+ colorEnd: "#ffffff",
+ durationMs: 5000,
+ fps: 30,
+};
+
+export class NoiseGenerator extends Effect<NoiseGeneratorProps> {
+ public readonly op = "NoiseGenerator";
+
+ public declare noiseType: "Perlin" | "Simplex" | "Voronoi";
+ public declare outputType: "Image" | "Video";
+ public declare width: number;
+ public declare height: number;
+ public declare scale: number;
+ public declare octaves: number;
+ public declare persistence: number;
+ public declare lacunarity: number;
+ public declare speed: number;
+ public declare colorStart: string;
+ public declare colorEnd: string;
+ public declare durationMs: number;
+ public declare fps: number;
+
+ constructor(config: NoiseGeneratorProps = {}) {
+ super(
+ withDefaults(
+ "NoiseGenerator",
+ noiseGeneratorDefaults,
+ config,
+ effectMeta.NoiseGenerator,
+ ),
+ );
+ }
+}
+
+export interface PaintProps {
+ /**
+ * Range 1 to 16384.
+ * @default 1080
+ */
+ width?: number;
+ /**
+ * Range 1 to 16384.
+ * @default 1080
+ */
+ height?: number;
+ /**
+ * @default true
+ */
+ maintainAspect?: boolean;
+ aspectRatio?: number;
+ /**
+ * @default "#ffffff"
+ */
+ backgroundColor?: string;
+ strokes?: (
+ | PaintStrokesItemOption1
+ | PaintStrokesItemOption2
+ | PaintStrokesItemOption3
+ )[];
+}
+
+const paintDefaults: PaintProps = {
+ width: 1080,
+ height: 1080,
+ maintainAspect: true,
+ backgroundColor: "#ffffff",
+};
+
+export class Paint extends Effect<PaintProps> {
+ public readonly op = "Paint";
+
+ public declare width: number;
+ public declare height: number;
+ public declare maintainAspect: boolean;
+ public declare aspectRatio: number | undefined;
+ public declare backgroundColor: string;
+ public declare strokes:
+ | (
+ | PaintStrokesItemOption1
+ | PaintStrokesItemOption2
+ | PaintStrokesItemOption3
+ )[]
+ | undefined;
+
+ constructor(config: PaintProps = {}) {
+ super(withDefaults("Paint", paintDefaults, config, effectMeta.Paint));
+ }
+}
+
+export interface PatchHealProps {
+ /** List of patch healing operations applied sequentially. */
+ patches?: PatchHealPatchesItem[];
+ /**
+ * Horizontal normalized position of destination patch (0.0 to 1.0).
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ centerX?: EffectProp<number>;
+ /**
+ * Vertical normalized position of destination patch (0.0 to 1.0).
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ centerY?: EffectProp<number>;
+ /**
+ * Horizontal pixel distance from destination to sample source patch.
+ * Range -4096 to 4096. Accepts a signal.
+ * @default 50
+ */
+ offsetX?: EffectProp<number>;
+ /**
+ * Vertical pixel distance from destination to sample source patch.
+ * Range -4096 to 4096. Accepts a signal.
+ * @default 0
+ */
+ offsetY?: EffectProp<number>;
+ /**
+ * Radius of the destination circular patch in pixels (used when no explicit Mask input is connected).
+ * Range 1 to 500. Accepts a signal.
+ * @default 25
+ */
+ radius?: EffectProp<number>;
+ /**
+ * Radius of the source sample circular patch in pixels.
+ * Range 1 to 500. Accepts a signal.
+ * @default 25
+ */
+ sourceRadius?: EffectProp<number>;
+ /**
+ * Softness edge falloff percentage (0–100%).
+ * Range 0 to 100. Accepts a signal.
+ * @default 50
+ */
+ feather?: EffectProp<number>;
+ /**
+ * Blending opacity of the healed patch (0.0–1.0).
+ * Range 0 to 1. Accepts a signal.
+ * @default 1
+ */
+ opacity?: EffectProp<number>;
+ /**
+ * Healing algorithm: Clone (direct stamp), SeamlessHeal (Poisson color/lighting blend), TextureTransfer (luminance structure matching).
+ * @default "SeamlessHeal"
+ */
+ mode?: "Clone" | "SeamlessHeal" | "TextureTransfer";
+}
+
+const patchHealDefaults: PatchHealProps = {
+ centerX: 0.5,
+ centerY: 0.5,
+ offsetX: 50,
+ offsetY: 0,
+ radius: 25,
+ sourceRadius: 25,
+ feather: 50,
+ opacity: 1,
+ mode: "SeamlessHeal",
+};
+
+export class PatchHeal extends Effect<PatchHealProps> {
+ public readonly op = "PatchHeal";
+
+ public declare patches: PatchHealPatchesItem[] | undefined;
+ public declare centerX: number;
+ public declare centerY: number;
+ public declare offsetX: number;
+ public declare offsetY: number;
+ public declare radius: number;
+ public declare sourceRadius: number;
+ public declare feather: number;
+ public declare opacity: number;
+ public declare mode: "Clone" | "SeamlessHeal" | "TextureTransfer";
+
+ constructor(config: PatchHealProps = {}) {
+ super(
+ withDefaults(
+ "PatchHeal",
+ patchHealDefaults,
+ config,
+ effectMeta.PatchHeal,
+ ),
+ );
+ }
+}
+
+export interface ProceduralVFXProps {
+ /**
+ * Which procedural particle / light effect to synthesize.
+ * @default "Smoke"
+ */
+ effectType?:
+ | "Smoke"
+ | "Fire"
+ | "Rain"
+ | "Sparks"
+ | "Snow"
+ | "Dust"
+ | "Lightning"
+ | "Magic"
+ | "LensFlare"
+ | "Embers"
+ | "EnergyBeam";
+ /**
+ * Image renders a static frame; Video animates over time.
+ * @default "Video"
+ */
+ outputType?: "Image" | "Video";
+ /**
+ * Width
+ * Range 16 to 4096.
+ * @default 1080
+ */
+ width?: number;
+ /**
+ * Height
+ * Range 16 to 4096.
+ * @default 1080
+ */
+ height?: number;
+ /**
+ * Amount of particles / coverage of the effect. Can be modulated by a static number or dynamic signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.6
+ */
+ density?: EffectProp<number>;
+ /**
+ * Spatial frequency / particle size of the effect. Can be modulated by a signal.
+ * Range 0.001 to 10. Accepts a signal.
+ * @default 0.01
+ */
+ scale?: EffectProp<number>;
+ /**
+ * Animation speed in Video mode. Can be modulated by a signal.
+ * Range 0 to 10. Accepts a signal.
+ * @default 1
*/
- cyanRed: number;
+ speed?: EffectProp<number>;
/**
- * Range -100 to 100.
- * @default 0
+ * Brightness / alpha gain of the effect. Can be modulated by a signal.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.8
*/
- magentaGreen: number;
+ intensity?: EffectProp<number>;
/**
- * Range -100 to 100.
- * @default 0
+ * Deterministic shuffle of the random pattern. Can be modulated by a signal.
+ * Range 0 to 1000000. Accepts a signal.
+ * @default 1234
*/
- yellowBlue: number;
-}
-
-export interface BlurBaseProps {
+ seed?: EffectProp<number>;
/**
- * Blur Type
- * @default "Gaussian"
+ * Color Start
+ * @default "#ffffff"
*/
- blurType?:
- | "Gaussian"
- | "Box"
- | "Median"
- | "Motion"
- | "Bilateral"
- | "Edge-preserving"
- | "Radial"
- | "Zoom";
+ colorStart?: string;
/**
- * The intensity of the blur. 0 = no blur. Can be modulated by a static number or a dynamic signal.
- * Range 0 to 100. Accepts a signal.
- * @default 5
+ * Color End
+ * @default "#ff5500"
*/
- strength?: EffectProp<number>;
+ colorEnd?: string;
/**
- * Direction of a Motion blur, in degrees.
- * Range 0 to 360. Accepts a signal.
- * @default 0
+ * Duration (ms)
+ * Range 100 to 100000.
+ * @default 5000
*/
- angle?: EffectProp<number>;
+ durationMs?: number;
/**
- * Sigma value for color space in Bilateral / Edge-preserving blurs. Can be modulated by a static number or a dynamic signal.
- * Range 0.01 to 1. Accepts a signal.
- * @default 0.1
+ * FPS
+ * Range 1 to 120.
+ * @default 30
*/
- sigmaColor?: EffectProp<number>;
+ fps?: number;
+}
+
+const proceduralVFXDefaults: ProceduralVFXProps = {
+ effectType: "Smoke",
+ outputType: "Video",
+ width: 1080,
+ height: 1080,
+ density: 0.6,
+ scale: 0.01,
+ speed: 1,
+ intensity: 0.8,
+ seed: 1234,
+ colorStart: "#ffffff",
+ colorEnd: "#ff5500",
+ durationMs: 5000,
+ fps: 30,
+};
+
+export class ProceduralVFX extends Effect<ProceduralVFXProps> {
+ public readonly op = "ProceduralVFX";
+
+ public declare effectType:
+ | "Smoke"
+ | "Fire"
+ | "Rain"
+ | "Sparks"
+ | "Snow"
+ | "Dust"
+ | "Lightning"
+ | "Magic"
+ | "LensFlare"
+ | "Embers"
+ | "EnergyBeam";
+ public declare outputType: "Image" | "Video";
+ public declare width: number;
+ public declare height: number;
+ public declare density: number;
+ public declare scale: number;
+ public declare speed: number;
+ public declare intensity: number;
+ public declare seed: number;
+ public declare colorStart: string;
+ public declare colorEnd: string;
+ public declare durationMs: number;
+ public declare fps: number;
+
+ constructor(config: ProceduralVFXProps = {}) {
+ super(
+ withDefaults(
+ "ProceduralVFX",
+ proceduralVFXDefaults,
+ config,
+ effectMeta.ProceduralVFX,
+ ),
+ );
+ }
+}
+
+export interface RefineEdgeProps {
/**
- * The X coordinate of the blur center (0.0 to 1.0). Can be modulated by a static number or a dynamic signal.
+ * Amount of edge color spill decontamination/defringing (0.0–1.0).
* Range 0 to 1. Accepts a signal.
- * @default 0.5
+ * @default 0.7
*/
- centerX?: EffectProp<number>;
+ decontaminateAmount?: EffectProp<number>;
/**
- * The Y coordinate of the blur center (0.0 to 1.0). Can be modulated by a static number or a dynamic signal.
- * Range 0 to 1. Accepts a signal.
- * @default 0.5
+ * Radius in pixels around alpha transitions to refine and decontaminate.
+ * Range 0.5 to 50. Accepts a signal.
+ * @default 2
*/
- centerY?: EffectProp<number>;
+ radius?: EffectProp<number>;
/**
- * Blurs only a specific circular area around center point.
- * Accepts a signal.
- * @default false
+ * Matte edge smoothing curve intensity (0–100).
+ * Range 0 to 100. Accepts a signal.
+ * @default 5
*/
- partialBlur?: EffectProp<boolean>;
+ smooth?: EffectProp<number>;
/**
- * Radius of the partial blur region (0.01 to 1.0). Can be modulated by a static number or a dynamic signal.
- * Range 0.01 to 1. Accepts a signal.
- * @default 0.3
+ * Sub-pixel gaussian softness along the matte boundary.
+ * Range 0 to 50. Accepts a signal.
+ * @default 0.5
*/
- radius?: EffectProp<number>;
+ feather?: EffectProp<number>;
/**
- * Vertical radius of the partial blur region (0 to 1.0). 0 reuses the horizontal radius.
- * Range 0 to 1. Accepts a signal.
+ * Contract (<0) or expand (>0) the edge boundary (-100% to +100%).
+ * Range -100 to 100. Accepts a signal.
* @default 0
*/
- radiusY?: EffectProp<number>;
+ shiftEdge?: EffectProp<number>;
/**
- * Shape of the partial blur region.
- * @default "circle"
+ * Channel to extract matte from (Alpha, Luminance, Red, Green, Blue).
+ * @default "Alpha"
*/
- shape?: "ellipse" | "circle" | "rect";
+ matteChannel?: "Alpha" | "Luminance" | "Red" | "Green" | "Blue";
+ /**
+ * Composite (decontaminated RGB + refined alpha), MatteOnly (grayscale mask), DecontaminatedRGB (clean RGB with full alpha).
+ * @default "Composite"
+ */
+ outputMode?: "Composite" | "MatteOnly" | "DecontaminatedRGB";
}
-const blurDefaults: BlurBaseProps = {
- blurType: "Gaussian",
- strength: 5,
- angle: 0,
- sigmaColor: 0.1,
- centerX: 0.5,
- centerY: 0.5,
- partialBlur: false,
- radius: 0.3,
- radiusY: 0,
- shape: "circle",
+const refineEdgeDefaults: RefineEdgeProps = {
+ decontaminateAmount: 0.7,
+ radius: 2,
+ smooth: 5,
+ feather: 0.5,
+ shiftEdge: 0,
+ matteChannel: "Alpha",
+ outputMode: "Composite",
};
-/** @internal Extended by `effects/custom/blur.ts`, which exports `Blur`. */
-export class BlurBase extends Effect<BlurBaseProps> {
- public readonly op = "Blur";
+export class RefineEdge extends Effect<RefineEdgeProps> {
+ public readonly op = "RefineEdge";
- public declare blurType:
- | "Gaussian"
- | "Box"
- | "Median"
- | "Motion"
- | "Bilateral"
- | "Edge-preserving"
- | "Radial"
- | "Zoom";
- public declare strength: number;
- public declare angle: number;
- public declare sigmaColor: number;
- public declare centerX: number;
- public declare centerY: number;
- public declare partialBlur: boolean;
+ public declare decontaminateAmount: number;
public declare radius: number;
- public declare radiusY: number;
- public declare shape: "ellipse" | "circle" | "rect";
+ public declare smooth: number;
+ public declare feather: number;
+ public declare shiftEdge: number;
+ public declare matteChannel: "Alpha" | "Luminance" | "Red" | "Green" | "Blue";
+ public declare outputMode: "Composite" | "MatteOnly" | "DecontaminatedRGB";
- constructor(config: BlurBaseProps = {}) {
- super(withDefaults("Blur", blurDefaults, config, effectMeta.Blur));
+ constructor(config: RefineEdgeProps = {}) {
+ super(
+ withDefaults(
+ "RefineEdge",
+ refineEdgeDefaults,
+ config,
+ effectMeta.RefineEdge,
+ ),
+ );
}
}
-export interface ColorBalanceProps {
+export interface RefractionCaustics3DProps {
/**
- * @default {"cyanRed":0,"magentaGreen":0,"yellowBlue":0}
+ * Index of Refraction (1.0=Air, 1.33=Water, 1.52=Crown Glass, 2.42=Diamond). Controls ray bending according to Snell's Law.
+ * Range 1 to 2.5. Accepts a signal.
+ * @default 1.52
*/
- shadows?: Partial<TonalShift>;
+ ior?: EffectProp<number>;
/**
- * @default {"cyanRed":0,"magentaGreen":0,"yellowBlue":0}
+ * Chromatic dispersion (RGB wavelength splitting) creating prismatic rainbow fringing.
+ * Range 0 to 0.2. Accepts a signal.
+ * @default 0.04
*/
- midtones?: Partial<TonalShift>;
+ dispersion?: EffectProp<number>;
/**
- * @default {"cyanRed":0,"magentaGreen":0,"yellowBlue":0}
+ * Depth displacement scale and effective glass thickness factor.
+ * Range 0 to 2. Accepts a signal.
+ * @default 0.5
*/
- highlights?: Partial<TonalShift>;
+ refractionScale?: EffectProp<number>;
/**
- * @default true
+ * Brightness multiplier for photometric caustic light rays focusing through curved glass.
+ * Range 0 to 2. Accepts a signal.
+ * @default 0.6
*/
- preserveLuminosity?: boolean;
+ causticBrightness?: EffectProp<number>;
+ /**
+ * Spatial frequency scale of photometric caustic patterns.
+ * Range 0.1 to 5. Accepts a signal.
+ * @default 1
+ */
+ causticScale?: EffectProp<number>;
+ /**
+ * Dynamic liquid wave perturbation strength across the refractive surface.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0
+ */
+ fluidRipples?: EffectProp<number>;
+ /**
+ * Speed of dynamic fluid wave animation.
+ * Range 0 to 5. Accepts a signal.
+ * @default 1
+ */
+ rippleSpeed?: EffectProp<number>;
+ /**
+ * Microfacet frosted glass roughness and optical diffusion blur.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0
+ */
+ roughness?: EffectProp<number>;
+ /**
+ * Fresnel specular reflection gleam intensity.
+ * Range 0 to 2. Accepts a signal.
+ * @default 0.8
+ */
+ specularIntensity?: EffectProp<number>;
+ /**
+ * Horizontal normalized coordinate (0.0 to 1.0) of incident light source.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.5
+ */
+ lightPosX?: EffectProp<number>;
+ /**
+ * Vertical normalized coordinate (0.0 to 1.0) of incident light source.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0.2
+ */
+ lightPosY?: EffectProp<number>;
+ /**
+ * Internal glass color tint and absorption.
+ * @default "#ffffff"
+ */
+ tintColor?: string;
+ /**
+ * Strength of internal glass color tint absorption.
+ * Range 0 to 1. Accepts a signal.
+ * @default 0
+ */
+ tintStrength?: EffectProp<number>;
+ /**
+ * Invert depth polarity (white = near vs black = near).
+ * @default false
+ */
+ depthInvert?: boolean;
+ /**
+ * Height-field surface normal extrusion exaggeration.
+ * Range 0.1 to 5. Accepts a signal.
+ * @default 1
+ */
+ depthScale?: EffectProp<number>;
}
-const colorBalanceDefaults: ColorBalanceProps = {
- shadows: { cyanRed: 0, magentaGreen: 0, yellowBlue: 0 },
- midtones: { cyanRed: 0, magentaGreen: 0, yellowBlue: 0 },
- highlights: { cyanRed: 0, magentaGreen: 0, yellowBlue: 0 },
- preserveLuminosity: true,
+const refractionCaustics3DDefaults: RefractionCaustics3DProps = {
+ ior: 1.52,
+ dispersion: 0.04,
+ refractionScale: 0.5,
+ causticBrightness: 0.6,
+ causticScale: 1,
+ fluidRipples: 0,
+ rippleSpeed: 1,
+ roughness: 0,
+ specularIntensity: 0.8,
+ lightPosX: 0.5,
+ lightPosY: 0.2,
+ tintColor: "#ffffff",
+ tintStrength: 0,
+ depthInvert: false,
+ depthScale: 1,
};
-export class ColorBalance extends Effect<ColorBalanceProps> {
- public readonly op = "ColorBalance";
+export class RefractionCaustics3D extends Effect<RefractionCaustics3DProps> {
+ public readonly op = "RefractionCaustics3D";
- public declare shadows: Partial<TonalShift>;
- public declare midtones: Partial<TonalShift>;
- public declare highlights: Partial<TonalShift>;
- public declare preserveLuminosity: boolean;
+ public declare ior: number;
+ public declare dispersion: number;
+ public declare refractionScale: number;
+ public declare causticBrightness: number;
+ public declare causticScale: number;
+ public declare fluidRipples: number;
+ public declare rippleSpeed: number;
+ public declare roughness: number;
+ public declare specularIntensity: number;
+ public declare lightPosX: number;
+ public declare lightPosY: number;
+ public declare tintColor: string;
+ public declare tintStrength: number;
+ public declare depthInvert: boolean;
+ public declare depthScale: number;
- constructor(config: ColorBalanceProps = {}) {
+ constructor(config: RefractionCaustics3DProps = {}) {
super(
withDefaults(
- "ColorBalance",
- colorBalanceDefaults,
+ "RefractionCaustics3D",
+ refractionCaustics3DDefaults,
config,
- effectMeta.ColorBalance,
+ effectMeta.RefractionCaustics3D,
),
);
}
}
-export interface ColorKeyProps {
+export interface ResizerScalerProps {
/**
- * Key Color
- * @default "#00ff00"
+ * @default "16:9"
*/
- keyColor?: string;
+ aspectRatioPreset?: "9:16" | "16:9" | "1:1" | "4:5" | "21:9" | "custom";
/**
- * How close the color must be to the Key Color to be removed.
- * Range 0 to 1. Accepts a signal.
- * @default 0.4
+ * @default "1080p"
*/
- similarity?: EffectProp<number>;
+ resolutionPreset?: "4k" | "1080p" | "720p" | "480p" | "custom";
/**
- * The softness of the transparency edge.
- * Range 0 to 1. Accepts a signal.
- * @default 0.1
+ * Range 1 to 8192.
+ * @default 1920
*/
- smoothness?: EffectProp<number>;
+ targetWidth?: number;
/**
- * Amount of key color spill to remove from foreground edges.
- * Range 0 to 1. Accepts a signal.
- * @default 0.2
+ * Range 1 to 8192.
+ * @default 1080
*/
- spillSuppression?: EffectProp<number>;
+ targetHeight?: number;
/**
- * Color space used to calculate similarity distance.
- * @default "YUV"
+ * @default "contain"
*/
- colorSpace?: "YUV" | "RGB";
+ fitMode?: "cover" | "contain" | "stretch" | "manual";
/**
- * How key color spill is suppressed on foreground edges.
- * @default "Desaturate"
+ * Range 1 to 1000.
+ * @default 100
*/
- spillSuppressionType?: "Desaturate" | "Neutralize" | "None";
+ zoom?: number;
+ /**
+ * Range -8192 to 8192.
+ * @default 0
+ */
+ offsetX?: number;
+ /**
+ * Range -8192 to 8192.
+ * @default 0
+ */
+ offsetY?: number;
+ /**
+ * @default "solid"
+ */
+ backgroundMode?: "solid" | "blurred" | "gradient" | "transparent";
+ /**
+ * @default "#000000FF"
+ */
+ backgroundColor?: string;
+ /**
+ * @default "#000000FF"
+ */
+ backgroundColor2?: string;
+ /**
+ * Range 0 to 100.
+ * @default 40
+ */
+ blurRadius?: number;
+ /**
+ * Range 0 to 1.
+ * @default 0.6
+ */
+ backgroundBrightness?: number;
+ /**
+ * @default "center"
+ */
+ anchorX?: "left" | "center" | "right";
+ /**
+ * @default "center"
+ */
+ anchorY?: "top" | "center" | "bottom";
}
-const colorKeyDefaults: ColorKeyProps = {
- keyColor: "#00ff00",
- similarity: 0.4,
- smoothness: 0.1,
- spillSuppression: 0.2,
- colorSpace: "YUV",
- spillSuppressionType: "Desaturate",
+const resizerScalerDefaults: ResizerScalerProps = {
+ aspectRatioPreset: "16:9",
+ resolutionPreset: "1080p",
+ targetWidth: 1920,
+ targetHeight: 1080,
+ fitMode: "contain",
+ zoom: 100,
+ offsetX: 0,
+ offsetY: 0,
+ backgroundMode: "solid",
+ backgroundColor: "#000000FF",
+ backgroundColor2: "#000000FF",
+ blurRadius: 40,
+ backgroundBrightness: 0.6,
+ anchorX: "center",
+ anchorY: "center",
};
-export class ColorKey extends Effect<ColorKeyProps> {
- public readonly op = "ColorKey";
+export class ResizerScaler extends Effect<ResizerScalerProps> {
+ public readonly op = "ResizerScaler";
- public declare keyColor: string;
- public declare similarity: number;
- public declare smoothness: number;
- public declare spillSuppression: number;
- public declare colorSpace: "YUV" | "RGB";
- public declare spillSuppressionType: "Desaturate" | "Neutralize" | "None";
+ public declare aspectRatioPreset:
+ | "9:16"
+ | "16:9"
+ | "1:1"
+ | "4:5"
+ | "21:9"
+ | "custom";
+ public declare resolutionPreset: "4k" | "1080p" | "720p" | "480p" | "custom";
+ public declare targetWidth: number;
+ public declare targetHeight: number;
+ public declare fitMode: "cover" | "contain" | "stretch" | "manual";
+ public declare zoom: number;
+ public declare offsetX: number;
+ public declare offsetY: number;
+ public declare backgroundMode:
+ | "solid"
+ | "blurred"
+ | "gradient"
+ | "transparent";
+ public declare backgroundColor: string;
+ public declare backgroundColor2: string;
+ public declare blurRadius: number;
+ public declare backgroundBrightness: number;
+ public declare anchorX: "left" | "center" | "right";
+ public declare anchorY: "top" | "center" | "bottom";
- constructor(config: ColorKeyProps = {}) {
+ constructor(config: ResizerScalerProps = {}) {
super(
- withDefaults("ColorKey", colorKeyDefaults, config, effectMeta.ColorKey),
+ withDefaults(
+ "ResizerScaler",
+ resizerScalerDefaults,
+ config,
+ effectMeta.ResizerScaler,
+ ),
+ );
+ }
+}
+
+export interface StereoPanningProps {
+ /**
+ * Stereo panning value: -1 (full left) to 1 (full right), 0 is center
+ * Range -1 to 1.
+ * @default 0
+ */
+ pan?: number;
+}
+
+const stereoPanningDefaults: StereoPanningProps = {
+ pan: 0,
+};
+
+export class StereoPanning extends Effect<StereoPanningProps> {
+ public readonly op = "StereoPanning";
+
+ public declare pan: number;
+
+ constructor(config: StereoPanningProps = {}) {
+ super(
+ withDefaults(
+ "StereoPanning",
+ stereoPanningDefaults,
+ config,
+ effectMeta.StereoPanning,
+ ),
);
}
}
diff --git a/packages/framefields/src/effects/generated/index.ts b/packages/framefields/src/effects/generated/index.ts
index 0eaec666..e95570de 100644
--- a/packages/framefields/src/effects/generated/index.ts
+++ b/packages/framefields/src/effects/generated/index.ts
@@ -4,10 +4,77 @@
export { Blur, type BlurProps } from "../custom/blur.js";
export {
+ AudioCompressor,
+ type AudioCompressorProps,
+ AudioDelay,
+ type AudioDelayProps,
+ AudioFade,
+ type AudioFadeProps,
+ AudioNoiseGate,
+ type AudioNoiseGateProps,
+ AudioParametricEq,
+ type AudioParametricEqProps,
+ AudioReverb,
+ type AudioReverbProps,
+ CameraParallax3D,
+ type CameraParallax3DProps,
+ ChannelMerger,
+ type ChannelMergerProps,
+ ChannelSplitter,
+ type ChannelSplitterProps,
ColorBalance,
type ColorBalanceProps,
ColorKey,
type ColorKeyProps,
+ CornerPin,
+ type CornerPinPointsItem,
+ type CornerPinProps,
+ DisplacementMap,
+ type DisplacementMapProps,
+ ExtractLUT,
+ type ExtractLUTProps,
+ Flip,
+ type FlipProps,
+ KenBurns,
+ type KenBurnsKeyframesItem,
+ type KenBurnsProps,
+ LayerStyle,
+ type LayerStyleBevelEmboss,
+ type LayerStyleColorOverlay,
+ type LayerStyleDropShadow,
+ type LayerStyleInnerGlow,
+ type LayerStyleInnerShadow,
+ type LayerStyleOuterGlow,
+ type LayerStyleProps,
+ type LayerStyleStroke,
+ Liquify,
+ type LiquifyOperationsItem,
+ type LiquifyProps,
+ MaskMath,
+ type MaskMathProps,
+ MeshWarp,
+ type MeshWarpPointsItem,
+ type MeshWarpProps,
+ NoiseGenerator,
+ type NoiseGeneratorProps,
+ Paint,
+ type PaintProps,
+ type PaintStrokesItemOption1,
+ type PaintStrokesItemOption2,
+ type PaintStrokesItemOption3,
+ PatchHeal,
+ type PatchHealPatchesItem,
+ type PatchHealProps,
+ ProceduralVFX,
+ type ProceduralVFXProps,
+ RefineEdge,
+ type RefineEdgeProps,
+ RefractionCaustics3D,
+ type RefractionCaustics3DProps,
+ ResizerScaler,
+ type ResizerScalerProps,
+ StereoPanning,
+ type StereoPanningProps,
type TonalShift,
Vignette,
type VignetteProps,
diff --git a/packages/framefields/src/effects/generated/meta.ts b/packages/framefields/src/effects/generated/meta.ts
index 323fff1b..b22c190f 100644
--- a/packages/framefields/src/effects/generated/meta.ts
+++ b/packages/framefields/src/effects/generated/meta.ts
@@ -6,6 +6,128 @@ import type { EffectMeta } from "../with-defaults.js";
/** Ranges and allowed values per effect prop, used by `withDefaults()` checks. */
export const effectMeta = {
+ AudioCompressor: {
+ threshold: {
+ min: -60,
+ max: 0,
+ },
+ ratio: {
+ min: 1,
+ max: 100,
+ },
+ attack: {
+ min: 0.0001,
+ max: 1,
+ },
+ release: {
+ min: 0.01,
+ max: 5,
+ },
+ knee: {
+ min: 0,
+ max: 24,
+ },
+ makeupGain: {
+ min: 0,
+ max: 24,
+ },
+ },
+ AudioDelay: {
+ delayTime: {
+ min: 0.001,
+ max: 5,
+ },
+ feedback: {
+ min: 0,
+ max: 0.95,
+ },
+ wet: {
+ min: 0,
+ max: 1,
+ },
+ dry: {
+ min: 0,
+ max: 1,
+ },
+ pingPong: {},
+ },
+ AudioFade: {
+ fadeInDuration: {
+ min: 0,
+ max: 60,
+ },
+ fadeOutDuration: {
+ min: 0,
+ max: 60,
+ },
+ fadeInCurve: {
+ enum: ["linear", "exponential", "scurve"],
+ },
+ fadeOutCurve: {
+ enum: ["linear", "exponential", "scurve"],
+ },
+ },
+ AudioNoiseGate: {
+ threshold: {
+ min: -120,
+ max: 0,
+ },
+ attack: {
+ min: 0.0001,
+ max: 1,
+ },
+ hold: {
+ min: 0.001,
+ max: 5,
+ },
+ release: {
+ min: 0.01,
+ max: 5,
+ },
+ range: {
+ min: -120,
+ max: 0,
+ },
+ },
+ AudioParametricEq: {
+ type: {
+ enum: ["lowShelf", "highShelf", "peak", "lowPass", "highPass", "notch"],
+ },
+ frequency: {
+ min: 20,
+ max: 20000,
+ },
+ gain: {
+ min: -24,
+ max: 24,
+ },
+ q: {
+ min: 0.01,
+ max: 10,
+ },
+ },
+ AudioReverb: {
+ roomSize: {
+ min: 0,
+ max: 0.98,
+ },
+ damping: {
+ min: 0,
+ max: 1,
+ },
+ wet: {
+ min: 0,
+ max: 1,
+ },
+ dry: {
+ min: 0,
+ max: 1,
+ },
+ width: {
+ min: 0,
+ max: 1,
+ },
+ },
Blur: {
blurType: {
enum: [
@@ -52,6 +174,65 @@ export const effectMeta = {
enum: ["ellipse", "circle", "rect"],
},
},
+ CameraParallax3D: {
+ motionPreset: {
+ enum: [
+ "Custom",
+ "DollyZoom",
+ "Orbit",
+ "FlyThrough",
+ "HandheldShake",
+ "RackFocus",
+ ],
+ },
+ panX: {
+ min: -1,
+ max: 1,
+ },
+ panY: {
+ min: -1,
+ max: 1,
+ },
+ dollyZ: {
+ min: -1,
+ max: 1,
+ },
+ fov: {
+ min: 15,
+ max: 120,
+ },
+ parallaxAmount: {
+ min: 0,
+ max: 2,
+ },
+ dofAperture: {
+ min: 0,
+ max: 1,
+ },
+ focusPlane: {
+ min: 0,
+ max: 1,
+ },
+ edgeDilation: {
+ min: 0,
+ max: 1,
+ },
+ depthInvert: {},
+ },
+ ChannelMerger: {
+ colorSpace: {
+ enum: ["RGBA", "HSLA", "CMYK", "LAB"],
+ },
+ defaultChannel4: {
+ min: 0,
+ max: 1,
+ },
+ },
+ ChannelSplitter: {
+ colorSpace: {
+ enum: ["RGBA", "HSLA", "CMYK", "LAB"],
+ },
+ },
ColorBalance: {
shadows: {
props: {
@@ -124,6 +305,632 @@ export const effectMeta = {
enum: ["Desaturate", "Neutralize", "None"],
},
},
+ CornerPin: {
+ points: {},
+ },
+ DisplacementMap: {
+ strengthX: {
+ min: 0,
+ max: 500,
+ },
+ strengthY: {
+ min: 0,
+ max: 500,
+ },
+ xChannel: {
+ enum: ["Red", "Green", "Blue", "Alpha", "Luminance"],
+ },
+ yChannel: {
+ enum: ["Red", "Green", "Blue", "Alpha", "Luminance"],
+ },
+ wrapMode: {
+ enum: ["Clamp", "Repeat", "Mirror"],
+ },
+ },
+ ExtractLUT: {
+ strategy: {
+ enum: ["deterministic", "statistical"],
+ },
+ samplePoints: {
+ min: 10,
+ max: 500,
+ },
+ },
+ Flip: {
+ horizontal: {},
+ vertical: {},
+ diagonal: {},
+ mode: {
+ enum: [
+ "horizontal",
+ "vertical",
+ "both",
+ "diagonal",
+ "antiDiagonal",
+ "custom",
+ ],
+ },
+ symmetry: {
+ enum: [
+ "none",
+ "leftToRight",
+ "rightToLeft",
+ "topToBottom",
+ "bottomToTop",
+ "quadrant",
+ ],
+ },
+ },
+ KenBurns: {
+ keyframes: {},
+ motionBlurSize: {
+ min: 0,
+ max: 10,
+ },
+ movementStyle: {
+ enum: ["spline", "direct"],
+ },
+ aspectRatio: {
+ enum: [
+ "input",
+ "16:9",
+ "9:16",
+ "21:9",
+ "9:21",
+ "1:1",
+ "4:3",
+ "3:2",
+ "2:3",
+ "4:5",
+ "5:4",
+ ],
+ },
+ },
+ LayerStyle: {
+ dropShadow: {
+ props: {
+ enabled: {},
+ color: {},
+ opacity: {
+ min: 0,
+ max: 1,
+ },
+ angle: {
+ min: 0,
+ max: 360,
+ },
+ distance: {
+ min: 0,
+ max: 500,
+ },
+ spread: {
+ min: 0,
+ max: 100,
+ },
+ size: {
+ min: 0,
+ max: 250,
+ },
+ blendMode: {},
+ },
+ },
+ innerShadow: {
+ props: {
+ enabled: {},
+ color: {},
+ opacity: {
+ min: 0,
+ max: 1,
+ },
+ angle: {
+ min: 0,
+ max: 360,
+ },
+ distance: {
+ min: 0,
+ max: 500,
+ },
+ choke: {
+ min: 0,
+ max: 100,
+ },
+ size: {
+ min: 0,
+ max: 250,
+ },
+ blendMode: {},
+ },
+ },
+ outerGlow: {
+ props: {
+ enabled: {},
+ color: {},
+ opacity: {
+ min: 0,
+ max: 1,
+ },
+ size: {
+ min: 0,
+ max: 250,
+ },
+ spread: {
+ min: 0,
+ max: 100,
+ },
+ blendMode: {},
+ },
+ },
+ innerGlow: {
+ props: {
+ enabled: {},
+ color: {},
+ opacity: {
+ min: 0,
+ max: 1,
+ },
+ size: {
+ min: 0,
+ max: 250,
+ },
+ spread: {
+ min: 0,
+ max: 100,
+ },
+ blendMode: {},
+ },
+ },
+ stroke: {
+ props: {
+ enabled: {},
+ size: {
+ min: 0,
+ max: 100,
+ },
+ position: {
+ enum: ["inside", "center", "outside"],
+ },
+ color: {},
+ opacity: {
+ min: 0,
+ max: 1,
+ },
+ blendMode: {},
+ },
+ },
+ bevelEmboss: {
+ props: {
+ enabled: {},
+ style: {
+ enum: ["InnerBevel", "OuterBevel", "Emboss", "PillowEmboss"],
+ },
+ technique: {
+ enum: ["Smooth", "ChiselHard", "ChiselSoft"],
+ },
+ depth: {
+ min: 1,
+ max: 1000,
+ },
+ direction: {
+ enum: ["Up", "Down"],
+ },
+ size: {
+ min: 0,
+ max: 250,
+ },
+ soften: {
+ min: 0,
+ max: 50,
+ },
+ angle: {
+ min: 0,
+ max: 360,
+ },
+ altitude: {
+ min: 0,
+ max: 90,
+ },
+ highlightColor: {},
+ highlightOpacity: {
+ min: 0,
+ max: 1,
+ },
+ shadowColor: {},
+ shadowOpacity: {
+ min: 0,
+ max: 1,
+ },
+ },
+ },
+ colorOverlay: {
+ props: {
+ enabled: {},
+ color: {},
+ opacity: {
+ min: 0,
+ max: 1,
+ },
+ blendMode: {},
+ },
+ },
+ dropShadowAngleHandleId: {},
+ dropShadowDistanceHandleId: {},
+ dropShadowSpreadHandleId: {},
+ dropShadowSizeHandleId: {},
+ dropShadowOpacityHandleId: {},
+ innerShadowAngleHandleId: {},
+ innerShadowDistanceHandleId: {},
+ innerShadowChokeHandleId: {},
+ innerShadowSizeHandleId: {},
+ innerShadowOpacityHandleId: {},
+ outerGlowSizeHandleId: {},
+ outerGlowSpreadHandleId: {},
+ outerGlowOpacityHandleId: {},
+ innerGlowSizeHandleId: {},
+ innerGlowSpreadHandleId: {},
+ innerGlowOpacityHandleId: {},
+ strokeSizeHandleId: {},
+ strokeOpacityHandleId: {},
+ bevelEmbossDepthHandleId: {},
+ bevelEmbossSizeHandleId: {},
+ bevelEmbossSoftenHandleId: {},
+ bevelEmbossAngleHandleId: {},
+ bevelEmbossAltitudeHandleId: {},
+ bevelEmbossHighlightOpacityHandleId: {},
+ bevelEmbossShadowOpacityHandleId: {},
+ colorOverlayOpacityHandleId: {},
+ },
+ Liquify: {
+ operations: {},
+ },
+ MaskMath: {
+ operation: {
+ enum: [
+ "Union",
+ "Intersect",
+ "Subtract",
+ "Difference",
+ "Invert",
+ "Dilate",
+ "Erode",
+ "Choke",
+ "Feather",
+ ],
+ },
+ radius: {
+ min: 0,
+ max: 200,
+ },
+ threshold: {
+ min: 0,
+ max: 1,
+ },
+ clampMin: {
+ min: 0,
+ max: 1,
+ },
+ clampMax: {
+ min: 0,
+ max: 1,
+ },
+ channelA: {
+ enum: ["Alpha", "Luminance", "Red", "Green", "Blue"],
+ },
+ channelB: {
+ enum: ["Alpha", "Luminance", "Red", "Green", "Blue"],
+ },
+ binarize: {},
+ invertResult: {},
+ outputFormat: {
+ enum: ["WhiteWithAlpha", "GrayscaleRGB", "AlphaOnly", "PassthroughRGB"],
+ },
+ },
+ MeshWarp: {
+ cols: {
+ min: 2,
+ max: 12,
+ },
+ rows: {
+ min: 2,
+ max: 12,
+ },
+ points: {},
+ },
+ NoiseGenerator: {
+ noiseType: {
+ enum: ["Perlin", "Simplex", "Voronoi"],
+ },
+ outputType: {
+ enum: ["Image", "Video"],
+ },
+ width: {
+ min: 16,
+ max: 4096,
+ },
+ height: {
+ min: 16,
+ max: 4096,
+ },
+ scale: {
+ min: 0.1,
+ max: 100,
+ },
+ octaves: {
+ min: 1,
+ max: 8,
+ },
+ persistence: {
+ min: 0,
+ max: 1,
+ },
+ lacunarity: {
+ min: 1,
+ max: 4,
+ },
+ speed: {
+ min: 0,
+ max: 10,
+ },
+ colorStart: {},
+ colorEnd: {},
+ durationMs: {
+ min: 1,
+ max: 60000,
+ },
+ fps: {
+ min: 1,
+ max: 120,
+ },
+ },
+ Paint: {
+ width: {
+ min: 1,
+ max: 16384,
+ },
+ height: {
+ min: 1,
+ max: 16384,
+ },
+ maintainAspect: {},
+ aspectRatio: {},
+ backgroundColor: {},
+ strokes: {},
+ },
+ PatchHeal: {
+ patches: {},
+ centerX: {
+ min: 0,
+ max: 1,
+ },
+ centerY: {
+ min: 0,
+ max: 1,
+ },
+ offsetX: {
+ min: -4096,
+ max: 4096,
+ },
+ offsetY: {
+ min: -4096,
+ max: 4096,
+ },
+ radius: {
+ min: 1,
+ max: 500,
+ },
+ sourceRadius: {
+ min: 1,
+ max: 500,
+ },
+ feather: {
+ min: 0,
+ max: 100,
+ },
+ opacity: {
+ min: 0,
+ max: 1,
+ },
+ mode: {
+ enum: ["Clone", "SeamlessHeal", "TextureTransfer"],
+ },
+ },
+ ProceduralVFX: {
+ effectType: {
+ enum: [
+ "Smoke",
+ "Fire",
+ "Rain",
+ "Sparks",
+ "Snow",
+ "Dust",
+ "Lightning",
+ "Magic",
+ "LensFlare",
+ "Embers",
+ "EnergyBeam",
+ ],
+ },
+ outputType: {
+ enum: ["Image", "Video"],
+ },
+ width: {
+ min: 16,
+ max: 4096,
+ },
+ height: {
+ min: 16,
+ max: 4096,
+ },
+ density: {
+ min: 0,
+ max: 1,
+ },
+ scale: {
+ min: 0.001,
+ max: 10,
+ },
+ speed: {
+ min: 0,
+ max: 10,
+ },
+ intensity: {
+ min: 0,
+ max: 1,
+ },
+ seed: {
+ min: 0,
+ max: 1000000,
+ },
+ colorStart: {},
+ colorEnd: {},
+ durationMs: {
+ min: 100,
+ max: 100000,
+ },
+ fps: {
+ min: 1,
+ max: 120,
+ },
+ },
+ RefineEdge: {
+ decontaminateAmount: {
+ min: 0,
+ max: 1,
+ },
+ radius: {
+ min: 0.5,
+ max: 50,
+ },
+ smooth: {
+ min: 0,
+ max: 100,
+ },
+ feather: {
+ min: 0,
+ max: 50,
+ },
+ shiftEdge: {
+ min: -100,
+ max: 100,
+ },
+ matteChannel: {
+ enum: ["Alpha", "Luminance", "Red", "Green", "Blue"],
+ },
+ outputMode: {
+ enum: ["Composite", "MatteOnly", "DecontaminatedRGB"],
+ },
+ },
+ RefractionCaustics3D: {
+ ior: {
+ min: 1,
+ max: 2.5,
+ },
+ dispersion: {
+ min: 0,
+ max: 0.2,
+ },
+ refractionScale: {
+ min: 0,
+ max: 2,
+ },
+ causticBrightness: {
+ min: 0,
+ max: 2,
+ },
+ causticScale: {
+ min: 0.1,
+ max: 5,
+ },
+ fluidRipples: {
+ min: 0,
+ max: 1,
+ },
+ rippleSpeed: {
+ min: 0,
+ max: 5,
+ },
+ roughness: {
+ min: 0,
+ max: 1,
+ },
+ specularIntensity: {
+ min: 0,
+ max: 2,
+ },
+ lightPosX: {
+ min: 0,
+ max: 1,
+ },
+ lightPosY: {
+ min: 0,
+ max: 1,
+ },
+ tintColor: {},
+ tintStrength: {
+ min: 0,
+ max: 1,
+ },
+ depthInvert: {},
+ depthScale: {
+ min: 0.1,
+ max: 5,
+ },
+ },
+ ResizerScaler: {
+ aspectRatioPreset: {
+ enum: ["9:16", "16:9", "1:1", "4:5", "21:9", "custom"],
+ },
+ resolutionPreset: {
+ enum: ["4k", "1080p", "720p", "480p", "custom"],
+ },
+ targetWidth: {
+ min: 1,
+ max: 8192,
+ },
+ targetHeight: {
+ min: 1,
+ max: 8192,
+ },
+ fitMode: {
+ enum: ["cover", "contain", "stretch", "manual"],
+ },
+ zoom: {
+ min: 1,
+ max: 1000,
+ },
+ offsetX: {
+ min: -8192,
+ max: 8192,
+ },
+ offsetY: {
+ min: -8192,
+ max: 8192,
+ },
+ backgroundMode: {
+ enum: ["solid", "blurred", "gradient", "transparent"],
+ },
+ backgroundColor: {},
+ backgroundColor2: {},
+ blurRadius: {
+ min: 0,
+ max: 100,
+ },
+ backgroundBrightness: {
+ min: 0,
+ max: 1,
+ },
+ anchorX: {
+ enum: ["left", "center", "right"],
+ },
+ anchorY: {
+ enum: ["top", "center", "bottom"],
+ },
+ },
+ StereoPanning: {
+ pan: {
+ min: -1,
+ max: 1,
+ },
+ },
Vignette: {
strength: {
min: 0,
diff --git a/packages/framefields/src/effects/generated/registry.ts b/packages/framefields/src/effects/generated/registry.ts
index 820e7fd1..5b48e5e0 100644
--- a/packages/framefields/src/effects/generated/registry.ts
+++ b/packages/framefields/src/effects/generated/registry.ts
@@ -4,18 +4,102 @@
import { Blur, type BlurProps } from "../custom/blur.js";
import {
+ AudioCompressor,
+ type AudioCompressorProps,
+ AudioDelay,
+ type AudioDelayProps,
+ AudioFade,
+ type AudioFadeProps,
+ AudioNoiseGate,
+ type AudioNoiseGateProps,
+ AudioParametricEq,
+ type AudioParametricEqProps,
+ AudioReverb,
+ type AudioReverbProps,
+ CameraParallax3D,
+ type CameraParallax3DProps,
+ ChannelMerger,
+ type ChannelMergerProps,
+ ChannelSplitter,
+ type ChannelSplitterProps,
ColorBalance,
type ColorBalanceProps,
ColorKey,
type ColorKeyProps,
+ CornerPin,
+ type CornerPinProps,
+ DisplacementMap,
+ type DisplacementMapProps,
+ ExtractLUT,
+ type ExtractLUTProps,
+ Flip,
+ type FlipProps,
+ KenBurns,
+ type KenBurnsProps,
+ LayerStyle,
+ type LayerStyleProps,
+ Liquify,
+ type LiquifyProps,
+ MaskMath,
+ type MaskMathProps,
+ MeshWarp,
+ type MeshWarpProps,
+ NoiseGenerator,
+ type NoiseGeneratorProps,
+ Paint,
+ type PaintProps,
+ PatchHeal,
+ type PatchHealProps,
+ ProceduralVFX,
+ type ProceduralVFXProps,
+ RefineEdge,
+ type RefineEdgeProps,
+ RefractionCaustics3D,
+ type RefractionCaustics3DProps,
+ ResizerScaler,
+ type ResizerScalerProps,
+ StereoPanning,
+ type StereoPanningProps,
Vignette,
type VignetteProps,
} from "./classes.js";
/** `Effect.<factory>(config)` helpers, one per generated effect class. */
export const effectFactories = {
+ audioCompressor: (config?: AudioCompressorProps) =>
+ new AudioCompressor(config),
+ audioDelay: (config?: AudioDelayProps) => new AudioDelay(config),
+ audioFade: (config?: AudioFadeProps) => new AudioFade(config),
+ audioNoiseGate: (config?: AudioNoiseGateProps) => new AudioNoiseGate(config),
+ audioParametricEq: (config?: AudioParametricEqProps) =>
+ new AudioParametricEq(config),
+ audioReverb: (config?: AudioReverbProps) => new AudioReverb(config),
blur: (config?: BlurProps) => new Blur(config),
+ cameraParallax3D: (config?: CameraParallax3DProps) =>
+ new CameraParallax3D(config),
+ channelMerger: (config?: ChannelMergerProps) => new ChannelMerger(config),
+ channelSplitter: (config?: ChannelSplitterProps) =>
+ new ChannelSplitter(config),
colorBalance: (config?: ColorBalanceProps) => new ColorBalance(config),
colorKey: (config?: ColorKeyProps) => new ColorKey(config),
+ cornerPin: (config?: CornerPinProps) => new CornerPin(config),
+ displacementMap: (config?: DisplacementMapProps) =>
+ new DisplacementMap(config),
+ extractLUT: (config?: ExtractLUTProps) => new ExtractLUT(config),
+ flip: (config?: FlipProps) => new Flip(config),
+ kenBurns: (config?: KenBurnsProps) => new KenBurns(config),
+ layerStyle: (config?: LayerStyleProps) => new LayerStyle(config),
+ liquify: (config?: LiquifyProps) => new Liquify(config),
+ maskMath: (config?: MaskMathProps) => new MaskMath(config),
+ meshWarp: (config?: MeshWarpProps) => new MeshWarp(config),
+ noiseGenerator: (config?: NoiseGeneratorProps) => new NoiseGenerator(config),
+ paint: (config?: PaintProps) => new Paint(config),
+ patchHeal: (config?: PatchHealProps) => new PatchHeal(config),
+ proceduralVFX: (config?: ProceduralVFXProps) => new ProceduralVFX(config),
+ refineEdge: (config?: RefineEdgeProps) => new RefineEdge(config),
+ refractionCaustics3D: (config?: RefractionCaustics3DProps) =>
+ new RefractionCaustics3D(config),
+ resizerScaler: (config?: ResizerScalerProps) => new ResizerScaler(config),
+ stereoPanning: (config?: StereoPanningProps) => new StereoPanning(config),
vignette: (config?: VignetteProps) => new Vignette(config),
} as const;
diff --git a/packages/framefields/src/index.ts b/packages/framefields/src/index.ts
index 678e00f5..2ad3db30 100644
--- a/packages/framefields/src/index.ts
+++ b/packages/framefields/src/index.ts
@@ -190,6 +190,7 @@ import {
type DeflickerProps,
DepthOfField,
type DepthOfFieldProps,
+ effectFactories,
FilmGrain,
type FilmGrainProps,
GradientMap,
@@ -631,14 +632,34 @@ export {
export {
ApplyLUT,
type ApplyLUTProps,
+ AudioCompressor,
+ type AudioCompressorProps,
+ AudioDelay,
+ type AudioDelayProps,
+ AudioFade,
+ type AudioFadeProps,
+ AudioNoiseGate,
+ type AudioNoiseGateProps,
+ AudioParametricEq,
+ type AudioParametricEqProps,
+ AudioReverb,
+ type AudioReverbProps,
AudioSignalExtractor,
type AudioSignalExtractorProps,
Blur,
type BlurProps,
+ CameraParallax3D,
+ type CameraParallax3DProps,
+ ChannelMerger,
+ type ChannelMergerProps,
+ ChannelSplitter,
+ type ChannelSplitterProps,
ColorBalance,
type ColorBalanceProps,
ColorKey,
type ColorKeyProps,
+ CornerPin,
+ type CornerPinProps,
Crop,
type CropProps,
Curves,
@@ -648,8 +669,16 @@ export {
type DeflickerProps,
DepthOfField,
type DepthOfFieldProps,
+ DisplacementMap,
+ type DisplacementMapProps,
+ ExtractLUT,
+ type ExtractLUTProps,
+ effectFactories,
+ effectMeta,
FilmGrain,
type FilmGrainProps,
+ Flip,
+ type FlipProps,
GradientMap,
type GradientMapProps,
type GradientMapStop,
@@ -659,17 +688,41 @@ export {
type HalftoneScreenProps,
HighPass,
type HighPassProps,
+ KenBurns,
+ type KenBurnsProps,
+ LayerStyle,
+ type LayerStyleProps,
type LevelChannel,
Levels,
type LevelsProps,
+ Liquify,
+ type LiquifyProps,
+ MaskMath,
+ type MaskMathProps,
+ MeshWarp,
+ type MeshWarpProps,
Modulate,
type ModulateProps,
MotionBlur,
type MotionBlurProps,
+ NoiseGenerator,
+ type NoiseGeneratorProps,
+ Paint,
+ type PaintProps,
+ PatchHeal,
+ type PatchHealProps,
PBRGlass,
type PBRGlassProps,
+ ProceduralVFX,
+ type ProceduralVFXProps,
+ RefineEdge,
+ type RefineEdgeProps,
+ RefractionCaustics3D,
+ type RefractionCaustics3DProps,
Relight3D,
type Relight3DProps,
+ ResizerScaler,
+ type ResizerScalerProps,
SelectiveColor,
type SelectiveColorAdjustment,
type SelectiveColorProps,
@@ -677,6 +730,8 @@ export {
type ShadowsHighlightsProps,
SSAO,
type SSAOProps,
+ StereoPanning,
+ type StereoPanningProps,
TemporalDeflicker,
TileOffset,
type TileOffsetEdgeMode,
@@ -1366,7 +1421,10 @@ export class Composition {
volume: options.muted ? 0 : (options.volume ?? 1),
});
- (container.children ??= []).push(videoPlate);
+ if (!container.children) {
+ container.children = [];
+ }
+ container.children.push(videoPlate);
this.add(container);
return this;
}
@@ -1419,7 +1477,10 @@ export class Composition {
mode: "mask",
enableSegmentation: true,
});
- (outlineLayer.children ??= []).push(maskVideo);
+ if (!outlineLayer.children) {
+ outlineLayer.children = [];
+ }
+ outlineLayer.children.push(maskVideo);
}
outlineLayer.apply(
@@ -2712,7 +2773,7 @@ export function editTrackedRegion(
return Layer.section(source, target, options);
}
-export const Effect = Object.assign(CoreEffect, {
+export const Effect = Object.assign(CoreEffect, effectFactories, {
blur: (config?: BlurProps) => new Blur(config),
vignette: (config?: VignetteProps) => new Vignette(config),
colorBalance: (config?: ColorBalanceProps) => new ColorBalance(config),
diff --git a/packages/node-sdk/renderer/index.ts b/packages/node-sdk/renderer/index.ts
index ba2c3ce5..57194659 100644
--- a/packages/node-sdk/renderer/index.ts
+++ b/packages/node-sdk/renderer/index.ts
@@ -73,6 +73,13 @@ export type AudioProcessor = (
ctx?: AudioProcessorContext,
) => void | Promise<void>;
+export {
+ resolveBoolean,
+ resolveNumber,
+ resolveParam,
+ resolveString,
+} from "@framefields/core";
+
export interface NodeRendererPlugin {
WebGPURenderer?: WebGPUNodeRenderer;
audioProcessor?: AudioProcessor;
diff --git a/plugins/framefields/skills/framefields-effects/references/effects-catalog.md b/plugins/framefields/skills/framefields-effects/references/effects-catalog.md
index 9aa0223b..b162465a 100644
--- a/plugins/framefields/skills/framefields-effects/references/effects-catalog.md
+++ b/plugins/framefields/skills/framefields-effects/references/effects-catalog.md
@@ -3,7 +3,7 @@
> Generated by `pnpm run sync:effects-catalog` from the node schemas (via `pnpm run generate:effects`) and `packages/framefields/src/effects/classes.ts`.
> Do not edit by hand — a stale catalog fails `pnpm run check:plugins`.
-25 effect classes are available from the package root and the `/effects` subpath:
+51 effect classes are available from the package root and the `/effects` subpath:
```ts
import { Blur, Curves, FilmGrain } from "framefields";
@@ -21,9 +21,35 @@ Set `FRAMEFIELDS_STRICT_PROPS=1` to make an unknown prop or an out-of-range valu
| Effect | `op` | Props |
| --- | --- | --- |
+| `AudioCompressor` | `AudioCompressor` | `threshold`, `ratio`, `attack`, `release`, `knee`, `makeupGain` |
+| `AudioDelay` | `AudioDelay` | `delayTime`, `feedback`, `wet`, `dry`, `pingPong` |
+| `AudioFade` | `AudioFade` | `fadeInDuration`, `fadeOutDuration`, `fadeInCurve`, `fadeOutCurve` |
+| `AudioNoiseGate` | `AudioNoiseGate` | `threshold`, `attack`, `hold`, `release`, `range` |
+| `AudioParametricEq` | `AudioParametricEq` | `type`, `frequency`, `gain`, `q` |
+| `AudioReverb` | `AudioReverb` | `roomSize`, `damping`, `wet`, `dry`, `width` |
| `Blur` | `Blur` | `blurType`, `strength`, `angle`, `sigmaColor`, `centerX`, `centerY`, `partialBlur`, `radius`, `radiusY`, `shape`, `track` |
+| `CameraParallax3D` | `CameraParallax3D` | `motionPreset`, `panX`, `panY`, `dollyZ`, `fov`, `parallaxAmount`, `dofAperture`, `focusPlane`, `edgeDilation`, `depthInvert` |
+| `ChannelMerger` | `ChannelMerger` | `colorSpace`, `defaultChannel4` |
+| `ChannelSplitter` | `ChannelSplitter` | `colorSpace` |
| `ColorBalance` | `ColorBalance` | `shadows`, `midtones`, `highlights`, `preserveLuminosity` |
| `ColorKey` | `ColorKey` | `keyColor`, `similarity`, `smoothness`, `spillSuppression`, `colorSpace`, `spillSuppressionType` |
+| `CornerPin` | `CornerPin` | `points` |
+| `DisplacementMap` | `DisplacementMap` | `strengthX`, `strengthY`, `xChannel`, `yChannel`, `wrapMode` |
+| `ExtractLUT` | `ExtractLUT` | `strategy`, `samplePoints` |
+| `Flip` | `Flip` | `horizontal`, `vertical`, `diagonal`, `mode`, `symmetry` |
+| `KenBurns` | `KenBurns` | `keyframes`, `motionBlurSize`, `movementStyle`, `aspectRatio` |
+| `LayerStyle` | `LayerStyle` | `dropShadow`, `innerShadow`, `outerGlow`, `innerGlow`, `stroke`, `bevelEmboss`, `colorOverlay`, `dropShadowAngleHandleId`, `dropShadowDistanceHandleId`, `dropShadowSpreadHandleId`, `dropShadowSizeHandleId`, `dropShadowOpacityHandleId`, `innerShadowAngleHandleId`, `innerShadowDistanceHandleId`, `innerShadowChokeHandleId`, `innerShadowSizeHandleId`, `innerShadowOpacityHandleId`, `outerGlowSizeHandleId`, `outerGlowSpreadHandleId`, `outerGlowOpacityHandleId`, `innerGlowSizeHandleId`, `innerGlowSpreadHandleId`, `innerGlowOpacityHandleId`, `strokeSizeHandleId`, `strokeOpacityHandleId`, `bevelEmbossDepthHandleId`, `bevelEmbossSizeHandleId`, `bevelEmbossSoftenHandleId`, `bevelEmbossAngleHandleId`, `bevelEmbossAltitudeHandleId`, `bevelEmbossHighlightOpacityHandleId`, `bevelEmbossShadowOpacityHandleId`, `colorOverlayOpacityHandleId` |
+| `Liquify` | `Liquify` | `operations` |
+| `MaskMath` | `MaskMath` | `operation`, `radius`, `threshold`, `clampMin`, `clampMax`, `channelA`, `channelB`, `binarize`, `invertResult`, `outputFormat` |
+| `MeshWarp` | `MeshWarp` | `cols`, `rows`, `points` |
+| `NoiseGenerator` | `NoiseGenerator` | `noiseType`, `outputType`, `width`, `height`, `scale`, `octaves`, `persistence`, `lacunarity`, `speed`, `colorStart`, `colorEnd`, `durationMs`, `fps` |
+| `Paint` | `Paint` | `width`, `height`, `maintainAspect`, `aspectRatio`, `backgroundColor`, `strokes` |
+| `PatchHeal` | `PatchHeal` | `patches`, `centerX`, `centerY`, `offsetX`, `offsetY`, `radius`, `sourceRadius`, `feather`, `opacity`, `mode` |
+| `ProceduralVFX` | `ProceduralVFX` | `effectType`, `outputType`, `width`, `height`, `density`, `scale`, `speed`, `intensity`, `seed`, `colorStart`, `colorEnd`, `durationMs`, `fps` |
+| `RefineEdge` | `RefineEdge` | `decontaminateAmount`, `radius`, `smooth`, `feather`, `shiftEdge`, `matteChannel`, `outputMode` |
+| `RefractionCaustics3D` | `RefractionCaustics3D` | `ior`, `dispersion`, `refractionScale`, `causticBrightness`, `causticScale`, `fluidRipples`, `rippleSpeed`, `roughness`, `specularIntensity`, `lightPosX`, `lightPosY`, `tintColor`, `tintStrength`, `depthInvert`, `depthScale` |
+| `ResizerScaler` | `ResizerScaler` | `aspectRatioPreset`, `resolutionPreset`, `targetWidth`, `targetHeight`, `fitMode`, `zoom`, `offsetX`, `offsetY`, `backgroundMode`, `backgroundColor`, `backgroundColor2`, `blurRadius`, `backgroundBrightness`, `anchorX`, `anchorY` |
+| `StereoPanning` | `StereoPanning` | `pan` |
| `Vignette` | `Vignette` | `strength`, `radius`, `softness`, `roundness`, `centerX`, `centerY` |
| `Levels` | `Levels` | `master`, `red`, `green`, `blue` |
| `FilmGrain` | `FilmGrain` | `strength`, `size`, `monochrome`, `animated`, `speed`, `shadows`, `midtones`, `highlights` |
@@ -49,6 +75,101 @@ Set `FRAMEFIELDS_STRICT_PROPS=1` to make an unknown prop or an out-of-range valu
## Prop defaults
+### AudioCompressor
+
+```ts
+import { AudioCompressor } from "framefields/effects";
+
+new AudioCompressor({ threshold: -24, ratio: 4, attack: 0.003 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `threshold` | `EffectProp<number>` | `-24` | Range -60 to 0. Level (dBFS) above which gain reduction begins (-60 to 0 dB). Can be modulated by a static number or dynamic signal. |
+| `ratio` | `EffectProp<number>` | `4` | Range 1 to 100. Input-to-output ratio above threshold (1 to 100). Can be modulated by a static number or dynamic signal. |
+| `attack` | `EffectProp<number>` | `0.003` | Range 0.0001 to 1. Seconds to reach full gain reduction (0.0001 to 1.0s). Can be modulated by a static number or dynamic signal. |
+| `release` | `EffectProp<number>` | `0.25` | Range 0.01 to 5. Seconds to recover gain after signal drops (0.01 to 5.0s). Can be modulated by a static number or dynamic signal. |
+| `knee` | `EffectProp<number>` | `6` | Range 0 to 24. dB range for soft-knee transition around threshold (0 to 24 dB). Can be modulated by a static number or dynamic signal. |
+| `makeupGain` | `EffectProp<number>` | `0` | Range 0 to 24. dBFS of gain applied after compression (0 to 24 dB). Can be modulated by a static number or dynamic signal. |
+
+### AudioDelay
+
+```ts
+import { AudioDelay } from "framefields/effects";
+
+new AudioDelay({ delayTime: 0.25, feedback: 0.4, wet: 0.3 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `delayTime` | `EffectProp<number>` | `0.25` | Range 0.001 to 5. Delay time in seconds (0.001 to 5.0s). Can be modulated by a static number or dynamic signal. |
+| `feedback` | `EffectProp<number>` | `0.4` | Range 0 to 0.95. Amount of delayed signal fed back into delay line (0.0 to 0.95). Can be modulated by a static number or dynamic signal. |
+| `wet` | `EffectProp<number>` | `0.3` | Range 0 to 1. Mix level of the wet delayed signal (0.0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `dry` | `EffectProp<number>` | `1` | Range 0 to 1. Mix level of the original dry signal (0.0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `pingPong` | `boolean` | `false` | Alternates echo reflections between left and right channels |
+
+### AudioFade
+
+```ts
+import { AudioFade } from "framefields/effects";
+
+new AudioFade({ fadeInDuration: 0, fadeOutDuration: 0, fadeInCurve: "linear" });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `fadeInDuration` | `EffectProp<number>` | `0` | Range 0 to 60. Duration in seconds of fade in from silence (0 to 60s). Can be modulated by a static number or dynamic signal. |
+| `fadeOutDuration` | `EffectProp<number>` | `0` | Range 0 to 60. Duration in seconds of fade out to silence (0 to 60s). Can be modulated by a static number or dynamic signal. |
+| `fadeInCurve` | `"linear" \| "exponential" \| "scurve"` | `"linear"` | Envelope shape for fade in |
+| `fadeOutCurve` | `"linear" \| "exponential" \| "scurve"` | `"linear"` | Envelope shape for fade out |
+
+### AudioNoiseGate
+
+```ts
+import { AudioNoiseGate } from "framefields/effects";
+
+new AudioNoiseGate({ threshold: -40, attack: 0.005, hold: 0.05 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `threshold` | `EffectProp<number>` | `-40` | Range -120 to 0. dBFS level below which the gate closes (-120 to 0 dB). Can be modulated by a static number or dynamic signal. |
+| `attack` | `EffectProp<number>` | `0.005` | Range 0.0001 to 1. Seconds to open (fade in) when signal exceeds threshold (0.0001 to 1.0s). Can be modulated by a static number or dynamic signal. |
+| `hold` | `EffectProp<number>` | `0.05` | Range 0.001 to 5. Seconds to stay open after signal drops below threshold (0.001 to 5.0s). Can be modulated by a static number or dynamic signal. |
+| `release` | `EffectProp<number>` | `0.1` | Range 0.01 to 5. Seconds to close (fade out) after hold expires (0.01 to 5.0s). Can be modulated by a static number or dynamic signal. |
+| `range` | `EffectProp<number>` | `-80` | Range -120 to 0. dBFS floor when gate is closed (-120 to 0 dB). Can be modulated by a static number or dynamic signal. |
+
+### AudioParametricEq
+
+```ts
+import { AudioParametricEq } from "framefields/effects";
+
+new AudioParametricEq({ type: "peak", frequency: 1000, gain: 0 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `type` | `"lowShelf" \| "highShelf" \| "peak" \| "lowPass" \| "highPass" \| "notch"` | `"peak"` | Type of biquad filter |
+| `frequency` | `EffectProp<number>` | `1000` | Range 20 to 20000. Cutoff or center frequency in Hz (20 to 20000 Hz). Can be modulated by a static number or dynamic signal. |
+| `gain` | `EffectProp<number>` | `0` | Range -24 to 24. Gain boost or cut in dB (-24 to 24 dB). Can be modulated by a static number or dynamic signal. |
+| `q` | `EffectProp<number>` | `1` | Range 0.01 to 10. Filter bandwidth / Q factor (0.01 to 10.0). Can be modulated by a static number or dynamic signal. |
+
+### AudioReverb
+
+```ts
+import { AudioReverb } from "framefields/effects";
+
+new AudioReverb({ roomSize: 0.5, damping: 0.5, wet: 0.3 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `roomSize` | `EffectProp<number>` | `0.5` | Range 0 to 0.98. Room decay, size of simulated space (0 to 0.98). Can be modulated by a static number or dynamic signal. |
+| `damping` | `EffectProp<number>` | `0.5` | Range 0 to 1. High-frequency absorption (0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `wet` | `EffectProp<number>` | `0.3` | Range 0 to 1. Mix level of the wet reverberated signal (0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `dry` | `EffectProp<number>` | `1` | Range 0 to 1. Mix level of the original dry signal (0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `width` | `EffectProp<number>` | `1` | Range 0 to 1. Stereo spread of the reverb tail (0 to 1.0). Can be modulated by a static number or dynamic signal. |
+
### Blur
```ts
@@ -71,6 +192,52 @@ new Blur({ blurType: "Gaussian", strength: 5, angle: 0 });
| `shape` | `"ellipse" \| "circle" \| "rect"` | `"circle"` | Shape of the partial blur region. |
| `track` | `ObjectTrackSignals` | — | Added by `custom/blur.ts`. |
+### CameraParallax3D
+
+```ts
+import { CameraParallax3D } from "framefields/effects";
+
+new CameraParallax3D({ motionPreset: "DollyZoom", panX: 0, panY: 0 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `motionPreset` | `"Custom" \| "DollyZoom" \| "Orbit" \| "FlyThrough" \| "HandheldShake" \| "RackFocus"` | `"DollyZoom"` | Motion Preset |
+| `panX` | `EffectProp<number>` | `0` | Range -1 to 1. Horizontal camera pan angle / position offset (-1.0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `panY` | `EffectProp<number>` | `0` | Range -1 to 1. Vertical camera tilt angle / position offset (-1.0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `dollyZ` | `EffectProp<number>` | `0` | Range -1 to 1. Camera forward/backward zoom position (-1.0 to 1.0). Can be modulated by a static number or dynamic signal. |
+| `fov` | `EffectProp<number>` | `50` | Range 15 to 120. Camera Field of View in degrees (15° to 120°). Can be modulated by a static number or dynamic signal. |
+| `parallaxAmount` | `EffectProp<number>` | `0.6` | Range 0 to 2. Strength of 3D spatial displacement depth relief. Can be modulated by a static number or dynamic signal. |
+| `dofAperture` | `EffectProp<number>` | `0.3` | Range 0 to 1. Lens aperture size / Circle of Confusion bokeh blur radius. Can be modulated by a static number or dynamic signal. |
+| `focusPlane` | `EffectProp<number>` | `0.4` | Range 0 to 1. Focal plane depth in scene (0.0=foreground, 1.0=background). Can be modulated by a static number or dynamic signal. |
+| `edgeDilation` | `EffectProp<number>` | `0.5` | Range 0 to 1. Inpainting border bleed to eliminate border occlusion tearing. |
+| `depthInvert` | `boolean` | `false` | Invert depth polarity (white = near vs black = near). |
+
+### ChannelMerger
+
+```ts
+import { ChannelMerger } from "framefields/effects";
+
+new ChannelMerger({ colorSpace: "RGBA", defaultChannel4: 1 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `colorSpace` | `"RGBA" \| "HSLA" \| "CMYK" \| "LAB"` | `"RGBA"` | Color space used for channel recombination (RGBA, HSLA, CMYK, or LAB). |
+| `defaultChannel4` | `EffectProp<number>` | `1` | Range 0 to 1. Fallback value used when Channel 4 is unconnected (Alpha=1.0, Black=0.0 in CMYK). |
+
+### ChannelSplitter
+
+```ts
+import { ChannelSplitter } from "framefields/effects";
+
+new ChannelSplitter({ colorSpace: "RGBA" });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `colorSpace` | `"RGBA" \| "HSLA" \| "CMYK" \| "LAB"` | `"RGBA"` | Color space used for channel decomposition (RGBA, HSLA, CMYK, or LAB). |
+
### ColorBalance
```ts
@@ -103,6 +270,337 @@ new ColorKey({ keyColor: "#00ff00", similarity: 0.4, smoothness: 0.1 });
| `colorSpace` | `"YUV" \| "RGB"` | `"YUV"` | Color space used to calculate similarity distance. |
| `spillSuppressionType` | `"Desaturate" \| "Neutralize" \| "None"` | `"Desaturate"` | How key color spill is suppressed on foreground edges. |
+### CornerPin
+
+```ts
+import { CornerPin } from "framefields/effects";
+
+new CornerPin({ /* props */ });
+```
+
+| Prop | Type | Default |
+| --- | --- | --- |
+| `points` | `CornerPinPointsItem[]` | — |
+
+### DisplacementMap
+
+```ts
+import { DisplacementMap } from "framefields/effects";
+
+new DisplacementMap({ strengthX: 50, strengthY: 50, xChannel: "Red" });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `strengthX` | `EffectProp<number>` | `50` | Range 0 to 500. Horizontal displacement strength in pixels. Can be modulated by a static number or a dynamic signal. |
+| `strengthY` | `EffectProp<number>` | `50` | Range 0 to 500. Vertical displacement strength in pixels. Can be modulated by a static number or a dynamic signal. |
+| `xChannel` | `"Red" \| "Green" \| "Blue" \| "Alpha" \| "Luminance"` | `"Red"` | X Channel |
+| `yChannel` | `"Red" \| "Green" \| "Blue" \| "Alpha" \| "Luminance"` | `"Green"` | Y Channel |
+| `wrapMode` | `"Clamp" \| "Repeat" \| "Mirror"` | `"Clamp"` | Wrap Mode |
+
+### ExtractLUT
+
+```ts
+import { ExtractLUT } from "framefields/effects";
+
+new ExtractLUT({ strategy: "deterministic", samplePoints: 150 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `strategy` | `"deterministic" \| "statistical"` | `"deterministic"` | Extraction Strategy |
+| `samplePoints` | `EffectProp<number>` | `150` | Range 10 to 500. Sample Points |
+
+### Flip
+
+```ts
+import { Flip } from "framefields/effects";
+
+new Flip({ horizontal: true, vertical: false, diagonal: false });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `horizontal` | `boolean` | `true` | Mirror horizontally along the vertical center axis. |
+| `vertical` | `boolean` | `false` | Mirror vertically along the horizontal center axis. |
+| `diagonal` | `boolean` | `false` | Swap horizontal and vertical axes (diagonal transposition). |
+| `mode` | `"horizontal" \| "vertical" \| "both" \| "diagonal" \| "antiDiagonal" \| "custom"` | `"horizontal"` | Quick preset mode for flipping or transposition. |
+| `symmetry` | `"none" \| "leftToRight" \| "rightToLeft" \| "topToBottom" \| "bottomToTop" \| "quadrant"` | `"none"` | Split-mirror reflection and symmetry effects. |
+
+### KenBurns
+
+```ts
+import { KenBurns } from "framefields/effects";
+
+new KenBurns({ motionBlurSize: 1.5, movementStyle: "spline", aspectRatio: "input" });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `keyframes` | `KenBurnsKeyframesItem[]` | `[]` | |
+| `motionBlurSize` | `number` | `1.5` | Range 0 to 10. |
+| `movementStyle` | `"spline" \| "direct"` | `"spline"` | |
+| `aspectRatio` | `"input" \| "16:9" \| "9:16" \| "21:9" \| "9:21" \| "1:1" \| "4:3" \| "3:2" \| "2:3" \| "4:5" \| "5:4"` | `"input"` | |
+
+### LayerStyle
+
+```ts
+import { LayerStyle } from "framefields/effects";
+
+new LayerStyle({ /* props */ });
+```
+
+| Prop | Type | Default |
+| --- | --- | --- |
+| `dropShadow` | `Partial<LayerStyleDropShadow>` | `{"enabled":false,"color":"#000000","opacity":0.75,"angle":120,"distance":10,"spread":0,"size":10,"blendMode":"multiply"}` |
+| `innerShadow` | `Partial<LayerStyleInnerShadow>` | `{"enabled":false,"color":"#000000","opacity":0.75,"angle":120,"distance":5,"choke":0,"size":5,"blendMode":"multiply"}` |
+| `outerGlow` | `Partial<LayerStyleOuterGlow>` | `{"enabled":false,"color":"#ffffff","opacity":0.75,"size":15,"spread":0,"blendMode":"screen"}` |
+| `innerGlow` | `Partial<LayerStyleInnerGlow>` | `{"enabled":false,"color":"#ffffff","opacity":0.75,"size":15,"spread":0,"blendMode":"screen"}` |
+| `stroke` | `Partial<LayerStyleStroke>` | `{"enabled":false,"size":2,"position":"outside","color":"#ffffff","opacity":1,"blendMode":"normal"}` |
+| `bevelEmboss` | `Partial<LayerStyleBevelEmboss>` | `{"enabled":false,"style":"InnerBevel","technique":"Smooth","depth":100,"direction":"Up","size":5,"soften":0,"angle":120,"altitude":30,"highlightColor":"#ffffff","highlightOpacity":0.75,"shadowColor":"#000000","shadowOpacity":0.75}` |
+| `colorOverlay` | `Partial<LayerStyleColorOverlay>` | `{"enabled":false,"color":"#ff0000","opacity":1,"blendMode":"normal"}` |
+| `dropShadowAngleHandleId` | `string \| null` | — |
+| `dropShadowDistanceHandleId` | `string \| null` | — |
+| `dropShadowSpreadHandleId` | `string \| null` | — |
+| `dropShadowSizeHandleId` | `string \| null` | — |
+| `dropShadowOpacityHandleId` | `string \| null` | — |
+| `innerShadowAngleHandleId` | `string \| null` | — |
+| `innerShadowDistanceHandleId` | `string \| null` | — |
+| `innerShadowChokeHandleId` | `string \| null` | — |
+| `innerShadowSizeHandleId` | `string \| null` | — |
+| `innerShadowOpacityHandleId` | `string \| null` | — |
+| `outerGlowSizeHandleId` | `string \| null` | — |
+| `outerGlowSpreadHandleId` | `string \| null` | — |
+| `outerGlowOpacityHandleId` | `string \| null` | — |
+| `innerGlowSizeHandleId` | `string \| null` | — |
+| `innerGlowSpreadHandleId` | `string \| null` | — |
+| `innerGlowOpacityHandleId` | `string \| null` | — |
+| `strokeSizeHandleId` | `string \| null` | — |
+| `strokeOpacityHandleId` | `string \| null` | — |
+| `bevelEmbossDepthHandleId` | `string \| null` | — |
+| `bevelEmbossSizeHandleId` | `string \| null` | — |
+| `bevelEmbossSoftenHandleId` | `string \| null` | — |
+| `bevelEmbossAngleHandleId` | `string \| null` | — |
+| `bevelEmbossAltitudeHandleId` | `string \| null` | — |
+| `bevelEmbossHighlightOpacityHandleId` | `string \| null` | — |
+| `bevelEmbossShadowOpacityHandleId` | `string \| null` | — |
+| `colorOverlayOpacityHandleId` | `string \| null` | — |
+
+### Liquify
+
+```ts
+import { Liquify } from "framefields/effects";
+
+new Liquify({ /* props */ });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `operations` | `LiquifyOperationsItem[]` | `[]` | List of localized liquify deformation operations. |
+
+### MaskMath
+
+```ts
+import { MaskMath } from "framefields/effects";
+
+new MaskMath({ operation: "Union", radius: 0, threshold: 0.5 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `operation` | `"Union" \| "Intersect" \| "Subtract" \| "Difference" \| "Invert" \| "Dilate" \| "Erode" \| "Choke" \| "Feather"` | `"Union"` | Morphological or Boolean set operation applied to input alpha masks. |
+| `radius` | `EffectProp<number>` | `0` | Range 0 to 200. Kernel radius in pixels for Dilate, Erode, Choke, or Feather operations. |
+| `threshold` | `EffectProp<number>` | `0.5` | Range 0 to 1. Cutoff threshold level (0.0–1.0) for binarization step or non-linear choke. |
+| `clampMin` | `EffectProp<number>` | `0` | Range 0 to 1. Minimum alpha matte cutoff limit (0.0–1.0). |
+| `clampMax` | `EffectProp<number>` | `1` | Range 0 to 1. Maximum alpha matte cutoff limit (0.0–1.0). |
+| `channelA` | `"Alpha" \| "Luminance" \| "Red" \| "Green" \| "Blue"` | `"Alpha"` | Source channel to extract mask from Mask A (Alpha, Luminance, Red, Green, Blue). |
+| `channelB` | `"Alpha" \| "Luminance" \| "Red" \| "Green" \| "Blue"` | `"Alpha"` | Source channel to extract mask from Mask B (Alpha, Luminance, Red, Green, Blue). |
+| `binarize` | `boolean` | `false` | When enabled, outputs crisp 1-bit binary matte based on threshold. |
+| `invertResult` | `boolean` | `false` | Inverts final matte output. |
+| `outputFormat` | `"WhiteWithAlpha" \| "GrayscaleRGB" \| "AlphaOnly" \| "PassthroughRGB"` | `"WhiteWithAlpha"` | WhiteWithAlpha (rgba(1,1,1,a)), GrayscaleRGB (rgba(a,a,a,1)), AlphaOnly (rgba(0,0,0,a)), PassthroughRGB (Mask A RGB with new alpha). |
+
+### MeshWarp
+
+```ts
+import { MeshWarp } from "framefields/effects";
+
+new MeshWarp({ cols: 3, rows: 3 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `cols` | `number` | `3` | Range 2 to 12. |
+| `rows` | `number` | `3` | Range 2 to 12. |
+| `points` | `MeshWarpPointsItem[]` | — | |
+
+### NoiseGenerator
+
+```ts
+import { NoiseGenerator } from "framefields/effects";
+
+new NoiseGenerator({ noiseType: "Perlin", outputType: "Image", width: 512 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `noiseType` | `"Perlin" \| "Simplex" \| "Voronoi"` | `"Perlin"` | Noise Type |
+| `outputType` | `"Image" \| "Video"` | `"Image"` | Output Type |
+| `width` | `number` | `512` | Range 16 to 4096. Width |
+| `height` | `number` | `512` | Range 16 to 4096. Height |
+| `scale` | `EffectProp<number>` | `10` | Range 0.1 to 100. Scale of the noise pattern. Can be modulated by a static number or a dynamic signal. |
+| `octaves` | `EffectProp<number>` | `4` | Range 1 to 8. Fractal detail depth of the noise. |
+| `persistence` | `EffectProp<number>` | `0.5` | Range 0 to 1. Roughness multiplier for each fractal octave. |
+| `lacunarity` | `EffectProp<number>` | `2` | Range 1 to 4. Frequency spacing multiplier for each fractal octave. |
+| `speed` | `EffectProp<number>` | `1` | Range 0 to 10. Speed of time-based noise animation in Video mode. |
+| `colorStart` | `string` | `"#000000"` | Color Start |
+| `colorEnd` | `string` | `"#ffffff"` | Color End |
+| `durationMs` | `number` | `5000` | Range 1 to 60000. Duration (ms) |
+| `fps` | `number` | `30` | Range 1 to 120. FPS |
+
+### Paint
+
+```ts
+import { Paint } from "framefields/effects";
+
+new Paint({ width: 1080, height: 1080, maintainAspect: true });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `width` | `number` | `1080` | Range 1 to 16384. |
+| `height` | `number` | `1080` | Range 1 to 16384. |
+| `maintainAspect` | `boolean` | `true` | |
+| `aspectRatio` | `number` | — | |
+| `backgroundColor` | `string` | `"#ffffff"` | |
+| `strokes` | `(PaintStrokesItemOption1 \| PaintStrokesItemOption2 \| PaintStrokesItemOption3)[]` | — | |
+
+### PatchHeal
+
+```ts
+import { PatchHeal } from "framefields/effects";
+
+new PatchHeal({ centerX: 0.5, centerY: 0.5, offsetX: 50 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `patches` | `PatchHealPatchesItem[]` | — | List of patch healing operations applied sequentially. |
+| `centerX` | `EffectProp<number>` | `0.5` | Range 0 to 1. Horizontal normalized position of destination patch (0.0 to 1.0). |
+| `centerY` | `EffectProp<number>` | `0.5` | Range 0 to 1. Vertical normalized position of destination patch (0.0 to 1.0). |
+| `offsetX` | `EffectProp<number>` | `50` | Range -4096 to 4096. Horizontal pixel distance from destination to sample source patch. |
+| `offsetY` | `EffectProp<number>` | `0` | Range -4096 to 4096. Vertical pixel distance from destination to sample source patch. |
+| `radius` | `EffectProp<number>` | `25` | Range 1 to 500. Radius of the destination circular patch in pixels (used when no explicit Mask input is connected). |
+| `sourceRadius` | `EffectProp<number>` | `25` | Range 1 to 500. Radius of the source sample circular patch in pixels. |
+| `feather` | `EffectProp<number>` | `50` | Range 0 to 100. Softness edge falloff percentage (0–100%). |
+| `opacity` | `EffectProp<number>` | `1` | Range 0 to 1. Blending opacity of the healed patch (0.0–1.0). |
+| `mode` | `"Clone" \| "SeamlessHeal" \| "TextureTransfer"` | `"SeamlessHeal"` | Healing algorithm: Clone (direct stamp), SeamlessHeal (Poisson color/lighting blend), TextureTransfer (luminance structure matching). |
+
+### ProceduralVFX
+
+```ts
+import { ProceduralVFX } from "framefields/effects";
+
+new ProceduralVFX({ effectType: "Smoke", outputType: "Video", width: 1080 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `effectType` | `"Smoke" \| "Fire" \| "Rain" \| "Sparks" \| "Snow" \| "Dust" \| "Lightning" \| "Magic" \| "LensFlare" \| "Embers" \| "EnergyBeam"` | `"Smoke"` | Which procedural particle / light effect to synthesize. |
+| `outputType` | `"Image" \| "Video"` | `"Video"` | Image renders a static frame; Video animates over time. |
+| `width` | `number` | `1080` | Range 16 to 4096. Width |
+| `height` | `number` | `1080` | Range 16 to 4096. Height |
+| `density` | `EffectProp<number>` | `0.6` | Range 0 to 1. Amount of particles / coverage of the effect. Can be modulated by a static number or dynamic signal. |
+| `scale` | `EffectProp<number>` | `0.01` | Range 0.001 to 10. Spatial frequency / particle size of the effect. Can be modulated by a signal. |
+| `speed` | `EffectProp<number>` | `1` | Range 0 to 10. Animation speed in Video mode. Can be modulated by a signal. |
+| `intensity` | `EffectProp<number>` | `0.8` | Range 0 to 1. Brightness / alpha gain of the effect. Can be modulated by a signal. |
+| `seed` | `EffectProp<number>` | `1234` | Range 0 to 1000000. Deterministic shuffle of the random pattern. Can be modulated by a signal. |
+| `colorStart` | `string` | `"#ffffff"` | Color Start |
+| `colorEnd` | `string` | `"#ff5500"` | Color End |
+| `durationMs` | `number` | `5000` | Range 100 to 100000. Duration (ms) |
+| `fps` | `number` | `30` | Range 1 to 120. FPS |
+
+### RefineEdge
+
+```ts
+import { RefineEdge } from "framefields/effects";
+
+new RefineEdge({ decontaminateAmount: 0.7, radius: 2, smooth: 5 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `decontaminateAmount` | `EffectProp<number>` | `0.7` | Range 0 to 1. Amount of edge color spill decontamination/defringing (0.0–1.0). |
+| `radius` | `EffectProp<number>` | `2` | Range 0.5 to 50. Radius in pixels around alpha transitions to refine and decontaminate. |
+| `smooth` | `EffectProp<number>` | `5` | Range 0 to 100. Matte edge smoothing curve intensity (0–100). |
+| `feather` | `EffectProp<number>` | `0.5` | Range 0 to 50. Sub-pixel gaussian softness along the matte boundary. |
+| `shiftEdge` | `EffectProp<number>` | `0` | Range -100 to 100. Contract (<0) or expand (>0) the edge boundary (-100% to +100%). |
+| `matteChannel` | `"Alpha" \| "Luminance" \| "Red" \| "Green" \| "Blue"` | `"Alpha"` | Channel to extract matte from (Alpha, Luminance, Red, Green, Blue). |
+| `outputMode` | `"Composite" \| "MatteOnly" \| "DecontaminatedRGB"` | `"Composite"` | Composite (decontaminated RGB + refined alpha), MatteOnly (grayscale mask), DecontaminatedRGB (clean RGB with full alpha). |
+
+### RefractionCaustics3D
+
+```ts
+import { RefractionCaustics3D } from "framefields/effects";
+
+new RefractionCaustics3D({ ior: 1.52, dispersion: 0.04, refractionScale: 0.5 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `ior` | `EffectProp<number>` | `1.52` | Range 1 to 2.5. Index of Refraction (1.0=Air, 1.33=Water, 1.52=Crown Glass, 2.42=Diamond). Controls ray bending according to Snell's Law. |
+| `dispersion` | `EffectProp<number>` | `0.04` | Range 0 to 0.2. Chromatic dispersion (RGB wavelength splitting) creating prismatic rainbow fringing. |
+| `refractionScale` | `EffectProp<number>` | `0.5` | Range 0 to 2. Depth displacement scale and effective glass thickness factor. |
+| `causticBrightness` | `EffectProp<number>` | `0.6` | Range 0 to 2. Brightness multiplier for photometric caustic light rays focusing through curved glass. |
+| `causticScale` | `EffectProp<number>` | `1` | Range 0.1 to 5. Spatial frequency scale of photometric caustic patterns. |
+| `fluidRipples` | `EffectProp<number>` | `0` | Range 0 to 1. Dynamic liquid wave perturbation strength across the refractive surface. |
+| `rippleSpeed` | `EffectProp<number>` | `1` | Range 0 to 5. Speed of dynamic fluid wave animation. |
+| `roughness` | `EffectProp<number>` | `0` | Range 0 to 1. Microfacet frosted glass roughness and optical diffusion blur. |
+| `specularIntensity` | `EffectProp<number>` | `0.8` | Range 0 to 2. Fresnel specular reflection gleam intensity. |
+| `lightPosX` | `EffectProp<number>` | `0.5` | Range 0 to 1. Horizontal normalized coordinate (0.0 to 1.0) of incident light source. |
+| `lightPosY` | `EffectProp<number>` | `0.2` | Range 0 to 1. Vertical normalized coordinate (0.0 to 1.0) of incident light source. |
+| `tintColor` | `string` | `"#ffffff"` | Internal glass color tint and absorption. |
+| `tintStrength` | `EffectProp<number>` | `0` | Range 0 to 1. Strength of internal glass color tint absorption. |
+| `depthInvert` | `boolean` | `false` | Invert depth polarity (white = near vs black = near). |
+| `depthScale` | `EffectProp<number>` | `1` | Range 0.1 to 5. Height-field surface normal extrusion exaggeration. |
+
+### ResizerScaler
+
+```ts
+import { ResizerScaler } from "framefields/effects";
+
+new ResizerScaler({ aspectRatioPreset: "16:9", resolutionPreset: "1080p", targetWidth: 1920 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `aspectRatioPreset` | `"9:16" \| "16:9" \| "1:1" \| "4:5" \| "21:9" \| "custom"` | `"16:9"` | |
+| `resolutionPreset` | `"4k" \| "1080p" \| "720p" \| "480p" \| "custom"` | `"1080p"` | |
+| `targetWidth` | `number` | `1920` | Range 1 to 8192. |
+| `targetHeight` | `number` | `1080` | Range 1 to 8192. |
+| `fitMode` | `"cover" \| "contain" \| "stretch" \| "manual"` | `"contain"` | |
+| `zoom` | `number` | `100` | Range 1 to 1000. |
+| `offsetX` | `number` | `0` | Range -8192 to 8192. |
+| `offsetY` | `number` | `0` | Range -8192 to 8192. |
+| `backgroundMode` | `"solid" \| "blurred" \| "gradient" \| "transparent"` | `"solid"` | |
+| `backgroundColor` | `string` | `"#000000FF"` | |
+| `backgroundColor2` | `string` | `"#000000FF"` | |
+| `blurRadius` | `number` | `40` | Range 0 to 100. |
+| `backgroundBrightness` | `number` | `0.6` | Range 0 to 1. |
+| `anchorX` | `"left" \| "center" \| "right"` | `"center"` | |
+| `anchorY` | `"top" \| "center" \| "bottom"` | `"center"` | |
+
+### StereoPanning
+
+```ts
+import { StereoPanning } from "framefields/effects";
+
+new StereoPanning({ pan: 0 });
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `pan` | `number` | `0` | Range -1 to 1. Stereo panning value: -1 (full left) to 1 (full right), 0 is center |
+
### Vignette
```ts
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index ff00fb39..eb06dbca 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -328,6 +328,28 @@ importers:
specifier: ^4.1.11
+ examples/24_audio_capabilities:
+ dependencies:
+ framefields:
+ specifier: workspace:*
+ version: link:../../packages/framefields
+ devDependencies:
+ '@framefields/tsconfig':
+ specifier: workspace:*
+ version: link:../../packages/tsconfig
+ '@types/node':
+ specifier: ^24.1.0
+ version: 24.10.14
+ tsx:
+ specifier: ^4.20.3
+ version: 4.21.0
+ typescript:
+ specifier: ^5.8.3
+ version: 5.9.3
+ vitest:
+ specifier: ^4.1.11
+
nodes/node-apply-lut:
dependencies:
'@framefields/core':