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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.jsonnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.jsonnew file mode 100644index 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.jsonindex 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.tsindex 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.tsindex 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.jsonindex 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.tsindex 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.tsindex 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 parametersconst 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.jsonindex 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.tsindex 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.tsindex 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 durationconst durationMs = virtualMedia.metadata?.durationMs ?? 0;diff --git a/nodes/node-audio-noise-gate/package.json b/nodes/node-audio-noise-gate/package.jsonindex 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.tsindex 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.tsindex 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.jsonindex 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.tsindex 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.tsindex 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.jsonindex 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.tsindex 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.tsindex 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 specsconst 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.tsindex 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.tsindex 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 pipelinediff --git a/nodes/node-camera-parallax-3d/package.json b/nodes/node-camera-parallax-3d/package.jsonindex 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.jsonindex 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.jsonindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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 boundsconst 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.tsindex 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.tsindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.tsindex 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.jsonindex 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.tsindex 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.jsonindex 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": falsediff --git a/nodes/node-refine-edge/package.json b/nodes/node-refine-edge/package.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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.jsonindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.mdindex 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:```tsimport { 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```tsdiff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex ff00fb39..eb06dbca 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -328,6 +328,28 @@ importers:specifier: ^4.1.11version: 4.1.11(@opentelemetry/[email protected])(@types/[email protected])(@vitest/[email protected])([email protected](@noble/[email protected])([email protected]))([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected])([email protected]))+ 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+ version: 4.1.11(@opentelemetry/[email protected])(@types/[email protected])(@vitest/[email protected])([email protected](@noble/[email protected])([email protected]))([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected])([email protected]))+nodes/node-apply-lut:dependencies:'@framefields/core':