@triforge/compositor-core 0.1.0

package/dist/passes/SSAO.js

@@ -0,0 +1,42 @@
+import { Vector2 } from 'three';
+import { BasePass } from '../core/BasePass.js';
+/**
+ * SSAO — Screen Space Ambient Occlusion.
+ * Blender Compositor: Ambient Occlusion pass.
+ *
+ * Wraps Three.js SSAOPass from three/addons.
+ * Requires scene and camera — injected automatically by CompositorOutput.
+ *
+ * Post-compile injection needed:
+ * ```typescript
+ * comp.compile(renderer, scene, camera)
+ * ```
+ */
+export class SSAO extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'SSAO';
+        this.parameters = {
+            radius: opts.radius ?? 0.5,
+            minDistance: opts.minDistance ?? 0.005,
+            maxDistance: opts.maxDistance ?? 0.1,
+        };
+    }
+    _threePassDeps() { return ['SSAOPass']; }
+    _buildThree(width, height, reg) {
+        const Pass = reg['SSAOPass'];
+        const scene = reg['_scene'];
+        const camera = reg['_camera'];
+        if (!Pass)
+            throw new Error('SSAO: SSAOPass not found in three/addons.');
+        if (!scene)
+            throw new Error('SSAO: scene not provided. Pass scene to CompositorOutput.compile().');
+        if (!camera)
+            throw new Error('SSAO: camera not provided. Pass camera to CompositorOutput.compile().');
+        const pass = new Pass(scene, camera, new Vector2(width, height));
+        pass['kernelRadius'] = this.parameters.radius;
+        pass['minDistance'] = this.parameters.minDistance;
+        pass['maxDistance'] = this.parameters.maxDistance;
+        return pass;
+    }
+}

package/dist/passes/SSR.d.ts

@@ -0,0 +1,32 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface SSROptions {
+    /** Maximum ray distance for reflections. Default 180. Blender: Screen Space Reflections → Max Roughness */
+    maxDistance?: number;
+    /** Opacity / blend strength of reflections [0–1]. Default 0.5. */
+    opacity?: number;
+    /** Roughness threshold above which SSR is skipped [0–1]. Default 0.8. */
+    maxRoughness?: number;
+}
+/**
+ * SSR — Screen Space Reflections.
+ * Blender Compositor / EEVEE: Screen Space Reflections.
+ *
+ * Wraps Three.js SSRPass from three/addons.
+ * Requires scene and camera — injected automatically by CompositorOutput.
+ *
+ * SSR works best with smooth, metallic or glossy surfaces.
+ * For very rough surfaces set a low `maxRoughness` to skip the effect.
+ */
+export declare class SSR extends BasePass {
+    readonly passType = "SSR";
+    parameters: {
+        maxDistance: number;
+        opacity: number;
+        maxRoughness: number;
+    };
+    constructor(opts?: SSROptions);
+    _threePassDeps(): string[];
+    _buildThree(width: number, height: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=SSR.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SSR.d.ts","sourceRoot":"","sources":["../../src/passes/SSR.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,UAAU;IACzB,2GAA2G;IAC3G,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;GASG;AACH,qBAAa,GAAI,SAAQ,QAAQ;IAC/B,QAAQ,CAAC,QAAQ,SAAQ;IACzB,UAAU,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;gBAE9D,IAAI,GAAE,UAAe;IASjC,cAAc;IAEd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAoBvE"}

package/dist/passes/SSR.js

@@ -0,0 +1,44 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * SSR — Screen Space Reflections.
+ * Blender Compositor / EEVEE: Screen Space Reflections.
+ *
+ * Wraps Three.js SSRPass from three/addons.
+ * Requires scene and camera — injected automatically by CompositorOutput.
+ *
+ * SSR works best with smooth, metallic or glossy surfaces.
+ * For very rough surfaces set a low `maxRoughness` to skip the effect.
+ */
+export class SSR extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'SSR';
+        this.parameters = {
+            maxDistance: opts.maxDistance ?? 180,
+            opacity: opts.opacity ?? 0.5,
+            maxRoughness: opts.maxRoughness ?? 0.8,
+        };
+    }
+    _threePassDeps() { return ['SSRPass']; }
+    _buildThree(width, height, reg) {
+        const Pass = reg['SSRPass'];
+        const scene = reg['_scene'];
+        const camera = reg['_camera'];
+        const renderer = reg['_renderer'];
+        if (!Pass)
+            throw new Error('SSR: SSRPass not found in three/addons.');
+        if (!scene)
+            throw new Error('SSR: scene not provided.');
+        if (!camera)
+            throw new Error('SSR: camera not provided.');
+        const pass = new Pass(renderer, scene, camera, {
+            width,
+            height,
+            isPerspectiveCamera: true,
+        });
+        pass['maxDistance'] = this.parameters.maxDistance;
+        pass['opacity'] = this.parameters.opacity;
+        pass['maxRoughness'] = this.parameters.maxRoughness;
+        return pass;
+    }
+}

package/dist/passes/SeparateRGBA.d.ts

@@ -0,0 +1,29 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export type RGBAChannel = 0 | 1 | 2 | 3;
+export interface SeparateRGBAOptions {
+    /**
+     * Which channel to extract and display as greyscale.
+     * 0 = R, 1 = G, 2 = B, 3 = A. Default 0. Blender: Separate RGBA → R/G/B/A socket.
+     */
+    channel?: RGBAChannel;
+}
+/**
+ * SeparateRGBA — Blender Compositor: Separate RGBA node.
+ *
+ * Extracts a single channel (R, G, B, or A) and displays it as
+ * a greyscale image. Use to inspect individual channels of the render.
+ *
+ * Changing `parameters.channel` at runtime swaps the extracted channel
+ * without recompiling — channel 0=R 1=G 2=B 3=A.
+ */
+export declare class SeparateRGBA extends BasePass {
+    readonly passType = "SeparateRGBA";
+    parameters: {
+        channel: number;
+    };
+    constructor(opts?: SeparateRGBAOptions);
+    _threePassDeps(): string[];
+    _buildThree(_w: number, _h: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=SeparateRGBA.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SeparateRGBA.d.ts","sourceRoot":"","sources":["../../src/passes/SeparateRGBA.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEvC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,QAAQ,kBAAiB;IAClC,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEnB,IAAI,GAAE,mBAAwB;IAK1C,cAAc;IAEd,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CA0BhE"}

package/dist/passes/SeparateRGBA.js

@@ -0,0 +1,45 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * SeparateRGBA — Blender Compositor: Separate RGBA node.
+ *
+ * Extracts a single channel (R, G, B, or A) and displays it as
+ * a greyscale image. Use to inspect individual channels of the render.
+ *
+ * Changing `parameters.channel` at runtime swaps the extracted channel
+ * without recompiling — channel 0=R 1=G 2=B 3=A.
+ */
+export class SeparateRGBA extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'SeparateRGBA';
+        this.parameters = { channel: opts.channel ?? 0 };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_w, _h, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('SeparateRGBA: ShaderPass not found.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                channel: { value: this.parameters.channel },
+            },
+            vertexShader: `varying vec2 vUv; void main(){ vUv=uv; gl_Position=projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float channel;
+        varying vec2 vUv;
+        void main(){
+          vec4 col = texture2D(tDiffuse, vUv);
+          float v;
+          if      (channel < 0.5) v = col.r;
+          else if (channel < 1.5) v = col.g;
+          else if (channel < 2.5) v = col.b;
+          else                    v = col.a;
+          gl_FragColor = vec4(v, v, v, 1.0);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/SetAlpha.d.ts

@@ -0,0 +1,21 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface SetAlphaOptions {
+    /** Alpha value to set [0–1]. Default 1.0. Blender: Set Alpha → Alpha */
+    alpha?: number;
+}
+/**
+ * SetAlpha — Blender Compositor: Set Alpha node.
+ * Sets the alpha channel of the render to a constant value.
+ * Useful for compositing transparent elements.
+ */
+export declare class SetAlpha extends BasePass {
+    readonly passType = "SetAlpha";
+    parameters: {
+        alpha: number;
+    };
+    constructor(opts?: SetAlphaOptions);
+    _threePassDeps(): string[];
+    _buildThree(_w: number, _h: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=SetAlpha.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SetAlpha.d.ts","sourceRoot":"","sources":["../../src/passes/SetAlpha.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,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,QAAQ,cAAa;IAC9B,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEjB,IAAI,GAAE,eAAoB;IAKtC,cAAc;IAEd,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAqBhE"}

package/dist/passes/SetAlpha.js

@@ -0,0 +1,36 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * SetAlpha — Blender Compositor: Set Alpha node.
+ * Sets the alpha channel of the render to a constant value.
+ * Useful for compositing transparent elements.
+ */
+export class SetAlpha extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'SetAlpha';
+        this.parameters = { alpha: opts.alpha ?? 1.0 };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_w, _h, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('SetAlpha: ShaderPass not found.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                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 alpha;
+        varying vec2 vUv;
+        void main(){
+          vec4 col = texture2D(tDiffuse, vUv);
+          gl_FragColor = vec4(col.rgb, alpha);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/Sharpen.d.ts

@@ -0,0 +1,17 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface SharpenOptions {
+    /** Sharpen intensity [0–1]. Default 0.5. Blender: Filter → Sharpen */
+    intensity?: number;
+}
+/** Sharpen — Blender Compositor: Filter node (Sharpen) */
+export declare class Sharpen extends BasePass {
+    readonly passType = "Sharpen";
+    parameters: {
+        intensity: number;
+    };
+    constructor(opts?: SharpenOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=Sharpen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Sharpen.d.ts","sourceRoot":"","sources":["../../src/passes/Sharpen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0DAA0D;AAC1D,qBAAa,OAAQ,SAAQ,QAAQ;IACnC,QAAQ,CAAC,QAAQ,aAAY;IAC7B,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;gBAErB,IAAI,GAAE,cAAmB;IAKrC,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAgCzE"}

package/dist/passes/Sharpen.js

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

package/dist/passes/Vignette.d.ts

@@ -0,0 +1,22 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface VignetteOptions {
+    /** Vignette darkness [0–1]. Default 0.5. Blender: Lens Distortion → Vignette */
+    darkness?: number;
+    /** Vignette offset — how far from centre the effect starts [0–1]. Default 1.0. */
+    offset?: number;
+}
+/** Vignette — Blender Compositor: Lens Distortion node (Vignette) */
+export declare class Vignette extends BasePass {
+    readonly passType = "Vignette";
+    parameters: {
+        darkness: number;
+        offset: number;
+    };
+    constructor(opts?: VignetteOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+    _buildPmndrs(reg: PassRegistry): unknown;
+    get _isPmndrsEffect(): boolean;
+}
+//# sourceMappingURL=Vignette.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Vignette.d.ts","sourceRoot":"","sources":["../../src/passes/Vignette.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,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qEAAqE;AACrE,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,QAAQ,cAAa;IAC9B,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEpC,IAAI,GAAE,eAAoB;IAQtC,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;IA8B/D,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO;IAMjD,IAAa,eAAe,IAAI,OAAO,CAAgB;CACxD"}

package/dist/passes/Vignette.js

@@ -0,0 +1,49 @@
+import { BasePass } from '../core/BasePass.js';
+/** Vignette — Blender Compositor: Lens Distortion node (Vignette) */
+export class Vignette extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'Vignette';
+        this.parameters = {
+            darkness: opts.darkness ?? 0.5,
+            offset: opts.offset ?? 1.0,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_width, _height, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('Vignette: ShaderPass not found in three/addons.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                darkness: { value: this.parameters.darkness },
+                offset: { value: this.parameters.offset },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float darkness;
+        uniform float offset;
+        varying vec2 vUv;
+        void main() {
+          vec4 color = texture2D(tDiffuse, vUv);
+          float dist  = distance(vUv, vec2(0.5));
+          color.rgb  *= smoothstep(0.8, offset * 0.799, dist * (darkness + offset));
+          gl_FragColor = color;
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+    _buildPmndrs(reg) {
+        const Effect = reg['VignetteEffect'];
+        if (!Effect)
+            throw new Error('Vignette: VignetteEffect not found in postprocessing.');
+        return new Effect({ darkness: this.parameters.darkness, offset: this.parameters.offset });
+    }
+    get _isPmndrsEffect() { return true; }
+}

package/dist/passes/ZCombine.d.ts

@@ -0,0 +1,34 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface ZCombineOptions {
+    /**
+     * Depth split point [0–1]. Pixels with luma below this are treated as far.
+     * Default 0.5. Blender: Z Combine → use luminance as depth proxy.
+     */
+    split?: number;
+    /** Blend softness around the split [0–1]. Default 0.1. */
+    softness?: number;
+}
+/**
+ * ZCombine — Blender Compositor: Z Combine node.
+ *
+ * In a linear render pipeline, a true Z combine (selecting pixels by
+ * depth buffer comparison) requires two separate render targets.
+ * This pass implements a luminance-keyed depth blend as a single-pass
+ * approximation: pixels darker than `split` are treated as "far" and
+ * receive a darken/fade effect; bright pixels are treated as "near".
+ *
+ * For a true two-target Z combine, render to two WebGLRenderTargets
+ * and composite them yourself before passing to the pipeline.
+ */
+export declare class ZCombine extends BasePass {
+    readonly passType = "ZCombine";
+    parameters: {
+        split: number;
+        softness: number;
+    };
+    constructor(opts?: ZCombineOptions);
+    _threePassDeps(): string[];
+    _buildThree(_w: number, _h: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=ZCombine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ZCombine.d.ts","sourceRoot":"","sources":["../../src/passes/ZCombine.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;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,QAAQ,cAAa;IAC9B,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEnC,IAAI,GAAE,eAAoB;IAQtC,cAAc;IAEd,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAyBhE"}

package/dist/passes/ZCombine.js

@@ -0,0 +1,50 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * ZCombine — Blender Compositor: Z Combine node.
+ *
+ * In a linear render pipeline, a true Z combine (selecting pixels by
+ * depth buffer comparison) requires two separate render targets.
+ * This pass implements a luminance-keyed depth blend as a single-pass
+ * approximation: pixels darker than `split` are treated as "far" and
+ * receive a darken/fade effect; bright pixels are treated as "near".
+ *
+ * For a true two-target Z combine, render to two WebGLRenderTargets
+ * and composite them yourself before passing to the pipeline.
+ */
+export class ZCombine extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'ZCombine';
+        this.parameters = {
+            split: opts.split ?? 0.5,
+            softness: opts.softness ?? 0.1,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_w, _h, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('ZCombine: ShaderPass not found.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                split: { value: this.parameters.split },
+                softness: { value: this.parameters.softness },
+            },
+            vertexShader: `varying vec2 vUv; void main(){ vUv=uv; gl_Position=projectionMatrix*modelViewMatrix*vec4(position,1.0); }`,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float split;
+        uniform float softness;
+        varying vec2 vUv;
+        void main(){
+          vec4 col    = texture2D(tDiffuse, vUv);
+          float luma  = dot(col.rgb, vec3(0.299, 0.587, 0.114));
+          float depth = 1.0 - smoothstep(split - softness, split + softness, luma);
+          gl_FragColor = vec4(col.rgb * (1.0 - depth * 0.5), col.a);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@triforge/compositor-core",
+  "version": "0.1.0",
+  "description": "Blender-matched compositor node graph for Three.js — backend-agnostic (three/addons or pmndrs/postprocessing)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node test/run-tests.js"
+  },
+  "keywords": [
+    "three.js",
+    "post-processing",
+    "compositor",
+    "blender",
+    "effects"
+  ],
+  "author": "Aftab Ibrahim Kazi",
+  "license": "MIT",
+  "peerDependencies": {
+    "three": ">=0.128.0"
+  },
+  "peerDependenciesMeta": {
+    "postprocessing": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/three": "^0.156.0",
+    "three": "^0.156.0",
+    "typescript": "^5.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AftabIbrahimKazi/triforge.git",
+    "directory": "st-compositor-core"
+  },
+  "homepage": "https://github.com/AftabIbrahimKazi/triforge#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}