@triforge/compositor-core 0.1.0

package/dist/passes/Blur.d.ts

@@ -0,0 +1,23 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface BlurOptions {
+    /** Blur radius in pixels. Default 4. Blender: Blur node → Size */
+    radius?: number;
+    /** Horizontal blur amount multiplier [0–1]. Default 1. */
+    x?: number;
+    /** Vertical blur amount multiplier [0–1]. Default 1. */
+    y?: number;
+}
+/** Blur — Blender Compositor: Blur node */
+export declare class Blur extends BasePass {
+    readonly passType = "Blur";
+    parameters: {
+        radius: number;
+        x: number;
+        y: number;
+    };
+    constructor(opts?: BlurOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=Blur.d.ts.map

package/dist/passes/Blur.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Blur.d.ts","sourceRoot":"","sources":["../../src/passes/Blur.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,wDAAwD;IACxD,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAED,2CAA2C;AAC3C,qBAAa,IAAK,SAAQ,QAAQ;IAChC,QAAQ,CAAC,QAAQ,UAAS;IAC1B,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;gBAExC,IAAI,GAAE,WAAgB;IASlC,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAyCzE"}

package/dist/passes/Blur.js

@@ -0,0 +1,54 @@
+import { BasePass } from '../core/BasePass.js';
+/** Blur — Blender Compositor: Blur node */
+export class Blur extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'Blur';
+        this.parameters = {
+            radius: opts.radius ?? 4,
+            x: opts.x ?? 1,
+            y: opts.y ?? 1,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_width, _height, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('Blur: ShaderPass not found in three/addons.');
+        const r = this.parameters.radius;
+        const px = (1 / 1920) * r * this.parameters.x;
+        const py = (1 / 1080) * r * this.parameters.y;
+        const BlurShader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                resolution: { value: [1920, 1080] },
+                blurX: { value: px },
+                blurY: { value: py },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float blurX;
+        uniform float blurY;
+        varying vec2 vUv;
+        void main() {
+          vec4 sum = vec4(0.0);
+          sum += texture2D(tDiffuse, vec2(vUv.x - 4.0*blurX, vUv.y - 4.0*blurY)) * 0.051;
+          sum += texture2D(tDiffuse, vec2(vUv.x - 3.0*blurX, vUv.y - 3.0*blurY)) * 0.0918;
+          sum += texture2D(tDiffuse, vec2(vUv.x - 2.0*blurX, vUv.y - 2.0*blurY)) * 0.12245;
+          sum += texture2D(tDiffuse, vec2(vUv.x - 1.0*blurX, vUv.y - 1.0*blurY)) * 0.1531;
+          sum += texture2D(tDiffuse, vUv)                                          * 0.1633;
+          sum += texture2D(tDiffuse, vec2(vUv.x + 1.0*blurX, vUv.y + 1.0*blurY)) * 0.1531;
+          sum += texture2D(tDiffuse, vec2(vUv.x + 2.0*blurX, vUv.y + 2.0*blurY)) * 0.12245;
+          sum += texture2D(tDiffuse, vec2(vUv.x + 3.0*blurX, vUv.y + 3.0*blurY)) * 0.0918;
+          sum += texture2D(tDiffuse, vec2(vUv.x + 4.0*blurX, vUv.y + 4.0*blurY)) * 0.051;
+          gl_FragColor = sum;
+        }
+      `,
+        };
+        return new ShaderPass(BlurShader);
+    }
+}

package/dist/passes/BrightnessContrast.d.ts

@@ -0,0 +1,20 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface BrightnessContrastOptions {
+    /** Brightness offset [-1, 1]. Default 0. Blender: Bright/Contrast → Bright */
+    brightness?: number;
+    /** Contrast multiplier [-1, 1]. Default 0. Blender: Bright/Contrast → Contrast */
+    contrast?: number;
+}
+/** BrightnessContrast — Blender Compositor: Bright/Contrast node */
+export declare class BrightnessContrast extends BasePass {
+    readonly passType = "BrightnessContrast";
+    parameters: {
+        brightness: number;
+        contrast: number;
+    };
+    constructor(opts?: BrightnessContrastOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=BrightnessContrast.d.ts.map

package/dist/passes/BrightnessContrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrightnessContrast.d.ts","sourceRoot":"","sources":["../../src/passes/BrightnessContrast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,oEAAoE;AACpE,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,QAAQ,wBAAuB;IACxC,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;gBAExC,IAAI,GAAE,yBAA8B;IAQhD,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CA6BzE"}

package/dist/passes/BrightnessContrast.js

@@ -0,0 +1,42 @@
+import { BasePass } from '../core/BasePass.js';
+/** BrightnessContrast — Blender Compositor: Bright/Contrast node */
+export class BrightnessContrast extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'BrightnessContrast';
+        this.parameters = {
+            brightness: opts.brightness ?? 0,
+            contrast: opts.contrast ?? 0,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_width, _height, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('BrightnessContrast: ShaderPass not found in three/addons.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                brightness: { value: this.parameters.brightness },
+                contrast: { value: this.parameters.contrast },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float brightness;
+        uniform float contrast;
+        varying vec2 vUv;
+        void main() {
+          vec4 tex = texture2D(tDiffuse, vUv);
+          vec3 col = tex.rgb + brightness;
+          col = (col - 0.5) * (1.0 + contrast) + 0.5;
+          gl_FragColor = vec4(clamp(col, 0.0, 1.0), tex.a);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/ChromaticAberration.d.ts

@@ -0,0 +1,22 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface ChromaticAberrationOptions {
+    /** RGB channel offset amount. Default 0.005. Blender: Lens Distortion → Dispersion */
+    offset?: number;
+    /** Radial falloff — 0 = uniform, 1 = edge only. Default 0.5. */
+    radialModulation?: number;
+}
+/** ChromaticAberration — Blender Compositor: Lens Distortion node (Dispersion) */
+export declare class ChromaticAberration extends BasePass {
+    readonly passType = "ChromaticAberration";
+    parameters: {
+        offset: number;
+        radialModulation: number;
+    };
+    constructor(opts?: ChromaticAberrationOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+    _buildPmndrs(reg: PassRegistry): unknown;
+    get _isPmndrsEffect(): boolean;
+}
+//# sourceMappingURL=ChromaticAberration.d.ts.map

package/dist/passes/ChromaticAberration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromaticAberration.d.ts","sourceRoot":"","sources":["../../src/passes/ChromaticAberration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,0BAA0B;IACzC,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,kFAAkF;AAClF,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,QAAQ,CAAC,QAAQ,yBAAwB;IACzC,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAA;gBAE5C,IAAI,GAAE,0BAA+B;IAQjD,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;IAkC/D,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO;IAMjD,IAAa,eAAe,IAAI,OAAO,CAAgB;CACxD"}

package/dist/passes/ChromaticAberration.js

@@ -0,0 +1,53 @@
+import { BasePass } from '../core/BasePass.js';
+/** ChromaticAberration — Blender Compositor: Lens Distortion node (Dispersion) */
+export class ChromaticAberration extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'ChromaticAberration';
+        this.parameters = {
+            offset: opts.offset ?? 0.005,
+            radialModulation: opts.radialModulation ?? 0.5,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_width, _height, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('ChromaticAberration: ShaderPass not found in three/addons.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                offset: { value: this.parameters.offset },
+                radMod: { value: this.parameters.radialModulation },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float offset;
+        uniform float radMod;
+        varying vec2 vUv;
+        void main() {
+          vec2 dir = vUv - 0.5;
+          float dist = length(dir) * radMod + (1.0 - radMod);
+          vec2 o = normalize(dir) * offset * dist;
+          float r = texture2D(tDiffuse, vUv - o).r;
+          float g = texture2D(tDiffuse, vUv     ).g;
+          float b = texture2D(tDiffuse, vUv + o).b;
+          float a = texture2D(tDiffuse, vUv     ).a;
+          gl_FragColor = vec4(r, g, b, a);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+    _buildPmndrs(reg) {
+        const Effect = reg['ChromaticAberrationEffect'];
+        if (!Effect)
+            throw new Error('ChromaticAberration: ChromaticAberrationEffect not found in postprocessing.');
+        return new Effect({ offset: this.parameters.offset });
+    }
+    get _isPmndrsEffect() { return true; }
+}

package/dist/passes/ColorBalance.d.ts

@@ -0,0 +1,38 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface ColorBalanceOptions {
+    /** Lift (shadows) offset [-1, 1] per channel. Default 0. Blender: Color Balance → Lift */
+    liftR?: number;
+    liftG?: number;
+    liftB?: number;
+    /** Gamma (midtones) [0.01, 10]. Default 1. Blender: Color Balance → Gamma */
+    gammaR?: number;
+    gammaG?: number;
+    gammaB?: number;
+    /** Gain (highlights) [0, 4]. Default 1. Blender: Color Balance → Gain */
+    gainR?: number;
+    gainG?: number;
+    gainB?: number;
+    /** Blend factor [0–1]. Default 1. */
+    fac?: number;
+}
+/** ColorBalance — Blender Compositor: Color Balance node */
+export declare class ColorBalance extends BasePass {
+    readonly passType = "ColorBalance";
+    parameters: {
+        liftR: number;
+        liftG: number;
+        liftB: number;
+        gammaR: number;
+        gammaG: number;
+        gammaB: number;
+        gainR: number;
+        gainG: number;
+        gainB: number;
+        fac: number;
+    };
+    constructor(opts?: ColorBalanceOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=ColorBalance.d.ts.map

package/dist/passes/ColorBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorBalance.d.ts","sourceRoot":"","sources":["../../src/passes/ColorBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAC9C,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACjD,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAC9C,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,4DAA4D;AAC5D,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,QAAQ,kBAAiB;IAClC,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;QAC3C,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;QAC9C,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;QAC3C,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;gBAEW,IAAI,GAAE,mBAAwB;IAU1C,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAmCzE"}

package/dist/passes/ColorBalance.js

@@ -0,0 +1,50 @@
+import { BasePass } from '../core/BasePass.js';
+/** ColorBalance — Blender Compositor: Color Balance node */
+export class ColorBalance extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'ColorBalance';
+        this.parameters = {
+            liftR: opts.liftR ?? 0, liftG: opts.liftG ?? 0, liftB: opts.liftB ?? 0,
+            gammaR: opts.gammaR ?? 1, gammaG: opts.gammaG ?? 1, gammaB: opts.gammaB ?? 1,
+            gainR: opts.gainR ?? 1, gainG: opts.gainG ?? 1, gainB: opts.gainB ?? 1,
+            fac: opts.fac ?? 1,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_width, _height, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('ColorBalance: ShaderPass not found in three/addons.');
+        const p = this.parameters;
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                lift: { value: [p.liftR, p.liftG, p.liftB] },
+                gamma: { value: [p.gammaR, p.gammaG, p.gammaB] },
+                gain: { value: [p.gainR, p.gainG, p.gainB] },
+                fac: { value: p.fac },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform vec3 lift;
+        uniform vec3 gamma;
+        uniform vec3 gain;
+        uniform float fac;
+        varying vec2 vUv;
+        void main() {
+          vec4 tex = texture2D(tDiffuse, vUv);
+          // ASC CDL: out = pow(clamp(in * gain + lift, 0, 1), 1/gamma)
+          vec3 g = max(gamma, vec3(0.0001));
+          vec3 col = pow(clamp(tex.rgb * gain + lift, vec3(0.0), vec3(1.0)), vec3(1.0) / g);
+          gl_FragColor = vec4(mix(tex.rgb, col, fac), tex.a);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/CombineRGBA.d.ts

@@ -0,0 +1,35 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface CombineRGBAOptions {
+    /** Red channel gain [0–2]. Default 1.0. Blender: Combine RGBA → R */
+    r?: number;
+    /** Green channel gain [0–2]. Default 1.0. */
+    g?: number;
+    /** Blue channel gain [0–2]. Default 1.0. */
+    b?: number;
+    /** Output alpha value [0–1]. Default 1.0. Blender: Combine RGBA → A */
+    alpha?: number;
+}
+/**
+ * CombineRGBA — Blender Compositor: Combine RGBA node.
+ *
+ * Re-weights each colour channel individually and sets output alpha.
+ * Use after SeparateRGBA to remix channels or to tone a single channel.
+ *
+ * In a single-chain pipeline (where all passes share one framebuffer),
+ * this applies per-channel gains to the current render rather than
+ * accepting four separate greyscale inputs.
+ */
+export declare class CombineRGBA extends BasePass {
+    readonly passType = "CombineRGBA";
+    parameters: {
+        r: number;
+        g: number;
+        b: number;
+        alpha: number;
+    };
+    constructor(opts?: CombineRGBAOptions);
+    _threePassDeps(): string[];
+    _buildThree(_w: number, _h: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=CombineRGBA.d.ts.map

package/dist/passes/CombineRGBA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombineRGBA.d.ts","sourceRoot":"","sources":["../../src/passes/CombineRGBA.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,6CAA6C;IAC7C,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,4CAA4C;IAC5C,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,QAAQ,CAAC,QAAQ,iBAAgB;IACjC,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;gBAElD,IAAI,GAAE,kBAAuB;IAUzC,cAAc;IAEd,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAwBhE"}

package/dist/passes/CombineRGBA.js

@@ -0,0 +1,49 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * CombineRGBA — Blender Compositor: Combine RGBA node.
+ *
+ * Re-weights each colour channel individually and sets output alpha.
+ * Use after SeparateRGBA to remix channels or to tone a single channel.
+ *
+ * In a single-chain pipeline (where all passes share one framebuffer),
+ * this applies per-channel gains to the current render rather than
+ * accepting four separate greyscale inputs.
+ */
+export class CombineRGBA extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'CombineRGBA';
+        this.parameters = {
+            r: opts.r ?? 1.0,
+            g: opts.g ?? 1.0,
+            b: opts.b ?? 1.0,
+            alpha: opts.alpha ?? 1.0,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_w, _h, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('CombineRGBA: ShaderPass not found.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                rGain: { value: this.parameters.r },
+                gGain: { value: this.parameters.g },
+                bGain: { value: this.parameters.b },
+                alpha: { value: this.parameters.alpha },
+            },
+            vertexShader: `varying vec2 vUv; void main(){ vUv=uv; gl_Position=projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float rGain, gGain, bGain, alpha;
+        varying vec2 vUv;
+        void main(){
+          vec4 col = texture2D(tDiffuse, vUv);
+          gl_FragColor = vec4(col.r * rGain, col.g * gGain, col.b * bGain, alpha);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/DepthOfField.d.ts

@@ -0,0 +1,27 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface DepthOfFieldOptions {
+    /** World-space focus distance. Default 10. Blender: Defocus → Z */
+    focusDistance?: number;
+    /** Bokeh scale (aperture size). Default 3. Blender: Defocus → fStop */
+    bokehScale?: number;
+    /** Maximum blur radius in pixels. Default 5. */
+    maxBlur?: number;
+}
+/** DepthOfField — Blender Compositor: Defocus node */
+export declare class DepthOfField extends BasePass {
+    readonly passType = "DepthOfField";
+    parameters: {
+        focusDistance: number;
+        bokehScale: number;
+        maxBlur: number;
+    };
+    private _scene;
+    private _camera;
+    constructor(opts?: DepthOfFieldOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+    _buildPmndrs(reg: PassRegistry): unknown;
+    get _isPmndrsEffect(): boolean;
+}
+//# sourceMappingURL=DepthOfField.d.ts.map

package/dist/passes/DepthOfField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepthOfField.d.ts","sourceRoot":"","sources":["../../src/passes/DepthOfField.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,sDAAsD;AACtD,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,QAAQ,kBAAiB;IAClC,UAAU,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAI1E,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAsB;gBAEzB,IAAI,GAAE,mBAAwB;IAS1C,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;IAoB/D,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO;IAajD,IAAa,eAAe,IAAI,OAAO,CAAgB;CACxD"}

package/dist/passes/DepthOfField.js

@@ -0,0 +1,47 @@
+import { BasePass } from '../core/BasePass.js';
+/** DepthOfField — Blender Compositor: Defocus node */
+export class DepthOfField extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'DepthOfField';
+        // Scene and camera are injected by CompositorOutput via the registry
+        // (BokehPass requires both at construction time)
+        this._scene = null;
+        this._camera = null;
+        this.parameters = {
+            focusDistance: opts.focusDistance ?? 10,
+            bokehScale: opts.bokehScale ?? 3,
+            maxBlur: opts.maxBlur ?? 5,
+        };
+    }
+    _threePassDeps() { return ['BokehPass']; }
+    _buildThree(_width, _height, reg) {
+        const Pass = reg['BokehPass'];
+        const scene = reg['_scene'];
+        const camera = reg['_camera'];
+        if (!Pass)
+            throw new Error('DepthOfField: BokehPass not found in three/addons.');
+        if (!scene)
+            throw new Error('DepthOfField: scene not injected — use CompositorOutput to compile.');
+        if (!camera)
+            throw new Error('DepthOfField: camera not injected — use CompositorOutput to compile.');
+        return new Pass(scene, camera, {
+            focus: this.parameters.focusDistance,
+            aperture: this.parameters.bokehScale * 0.00001,
+            maxblur: this.parameters.maxBlur * 0.001,
+        });
+    }
+    _buildPmndrs(reg) {
+        const Effect = reg['DepthOfFieldEffect'];
+        const camera = reg['_camera'];
+        if (!Effect)
+            throw new Error('DepthOfField: DepthOfFieldEffect not found in postprocessing.');
+        if (!camera)
+            throw new Error('DepthOfField: camera not injected — use CompositorOutput to compile.');
+        return new Effect(camera, {
+            focusDistance: this.parameters.focusDistance,
+            bokehScale: this.parameters.bokehScale,
+        });
+    }
+    get _isPmndrsEffect() { return true; }
+}

package/dist/passes/EdgeDetect.d.ts

@@ -0,0 +1,31 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface EdgeDetectOptions {
+    /** Edge line thickness in pixels. Default 1. */
+    thickness?: number;
+    /** Edge intensity multiplier. Default 1. */
+    strength?: number;
+    /** Edge colour as hex string. Default '#000000'. */
+    color?: string;
+    /** Mix original image with detected edges [0=edges only, 1=original+edges]. Default 1. */
+    mix?: number;
+}
+/**
+ * EdgeDetect — Blender Compositor: Filter node (Sobel operator type).
+ * Extracts edges from luminance using a Sobel kernel.
+ */
+export declare class EdgeDetect extends BasePass {
+    readonly passType = "EdgeDetect";
+    parameters: {
+        thickness: number;
+        strength: number;
+        mix: number;
+        r: number;
+        g: number;
+        b: number;
+    };
+    constructor(opts?: EdgeDetectOptions);
+    _threePassDeps(): string[];
+    _buildThree(w: number, h: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=EdgeDetect.d.ts.map

package/dist/passes/EdgeDetect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeDetect.d.ts","sourceRoot":"","sources":["../../src/passes/EdgeDetect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0FAA0F;IAC1F,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,QAAQ,gBAAe;IAChC,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;gBAErF,IAAI,GAAE,iBAAsB;IAaxC,cAAc;IAEd,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAkD9D"}

package/dist/passes/EdgeDetect.js

@@ -0,0 +1,69 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * EdgeDetect — Blender Compositor: Filter node (Sobel operator type).
+ * Extracts edges from luminance using a Sobel kernel.
+ */
+export class EdgeDetect extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'EdgeDetect';
+        const hex = (opts.color ?? '#000000').replace('#', '');
+        this.parameters = {
+            thickness: opts.thickness ?? 1,
+            strength: opts.strength ?? 1,
+            mix: opts.mix ?? 1,
+            r: parseInt(hex.substring(0, 2), 16) / 255,
+            g: parseInt(hex.substring(2, 4), 16) / 255,
+            b: parseInt(hex.substring(4, 6), 16) / 255,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(w, h, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('EdgeDetect: ShaderPass not found.');
+        const { thickness, strength, mix, r, g, b } = this.parameters;
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                texelSize: { value: [thickness / w, thickness / h] },
+                strength: { value: strength },
+                edgeColor: { value: [r, g, b] },
+                mix: { value: mix },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform vec2  texelSize;
+        uniform float strength;
+        uniform vec3  edgeColor;
+        uniform float mix;
+        varying vec2 vUv;
+
+        float lum(vec2 uv) {
+          vec3 c = texture2D(tDiffuse, clamp(uv, 0.0, 1.0)).rgb;
+          return dot(c, vec3(0.299, 0.587, 0.114));
+        }
+
+        void main() {
+          vec2 t = texelSize;
+          // Sobel X and Y kernels
+          float gx = -lum(vUv + vec2(-t.x,  t.y)) + lum(vUv + vec2( t.x,  t.y))
+                   - 2.0 * lum(vUv + vec2(-t.x, 0.0)) + 2.0 * lum(vUv + vec2( t.x, 0.0))
+                   - lum(vUv + vec2(-t.x, -t.y)) + lum(vUv + vec2( t.x, -t.y));
+          float gy = -lum(vUv + vec2(-t.x,  t.y)) - 2.0 * lum(vUv + vec2(0.0,  t.y)) - lum(vUv + vec2( t.x,  t.y))
+                   +  lum(vUv + vec2(-t.x, -t.y)) + 2.0 * lum(vUv + vec2(0.0, -t.y)) + lum(vUv + vec2( t.x, -t.y));
+          float edge = clamp(sqrt(gx*gx + gy*gy) * strength, 0.0, 1.0);
+
+          vec4 base = texture2D(tDiffuse, vUv);
+          vec3 out_  = base.rgb * mix + edgeColor * edge * (1.0 - mix * (1.0 - edge));
+          gl_FragColor = vec4(out_, base.a);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/Exposure.d.ts

@@ -0,0 +1,19 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface ExposureOptions {
+    /** Exposure value in EV stops. Default 0 (no change). Blender: Exposure → Exposure */
+    exposure?: number;
+}
+/** Exposure — Blender Compositor: Exposure node */
+export declare class Exposure extends BasePass {
+    readonly passType = "Exposure";
+    parameters: {
+        exposure: number;
+    };
+    constructor(opts?: ExposureOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+    _buildPmndrs(reg: PassRegistry): unknown;
+    get _isPmndrsEffect(): boolean;
+}
+//# sourceMappingURL=Exposure.d.ts.map

package/dist/passes/Exposure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exposure.d.ts","sourceRoot":"","sources":["../../src/passes/Exposure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,mDAAmD;AACnD,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,QAAQ,cAAa;IAC9B,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEpB,IAAI,GAAE,eAAoB;IAKtC,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;IA0B/D,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO;IAMjD,IAAa,eAAe,IAAI,OAAO,CAAgB;CACxD"}