@triforge/compositor-core 0.1.0

package/dist/passes/Exposure.js

@@ -0,0 +1,42 @@
+import { BasePass } from '../core/BasePass.js';
+/** Exposure — Blender Compositor: Exposure node */
+export class Exposure extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'Exposure';
+        this.parameters = { exposure: opts.exposure ?? 0 };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_width, _height, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('Exposure: ShaderPass not found in three/addons.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                exposure: { value: this.parameters.exposure },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float exposure;
+        varying vec2 vUv;
+        void main() {
+          vec4 tex = texture2D(tDiffuse, vUv);
+          gl_FragColor = vec4(tex.rgb * pow(2.0, exposure), tex.a);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+    _buildPmndrs(reg) {
+        const Effect = reg['ToneMappingEffect'];
+        if (!Effect)
+            throw new Error('Exposure: ToneMappingEffect not found in postprocessing.');
+        return new Effect({ exposure: Math.pow(2.0, this.parameters.exposure) });
+    }
+    get _isPmndrsEffect() { return true; }
+}

package/dist/passes/FilmGrain.d.ts

@@ -0,0 +1,26 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface FilmGrainOptions {
+    /** Noise intensity [0–1]. Default 0.35. Blender: Film node → Grain */
+    intensity?: number;
+    /** Greyscale grain. Default false. Blender: Film node → Greyscale */
+    greyscale?: boolean;
+}
+/**
+ * FilmGrain — Blender Compositor: Film node.
+ *
+ * Uses Three.js FilmPass (r165 constructor: intensity, grayscale).
+ */
+export declare class FilmGrain extends BasePass {
+    readonly passType = "FilmGrain";
+    parameters: {
+        intensity: number;
+        greyscale: number;
+    };
+    constructor(opts?: FilmGrainOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+    _buildPmndrs(reg: PassRegistry): unknown;
+    get _isPmndrsEffect(): boolean;
+}
+//# sourceMappingURL=FilmGrain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FilmGrain.d.ts","sourceRoot":"","sources":["../../src/passes/FilmGrain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,QAAQ;IACrC,QAAQ,CAAC,QAAQ,eAAc;IAC/B,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;gBAExC,IAAI,GAAE,gBAAqB;IAQvC,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;IAU/D,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO;IAMjD,IAAa,eAAe,IAAI,OAAO,CAAgB;CACxD"}

package/dist/passes/FilmGrain.js

@@ -0,0 +1,31 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * FilmGrain — Blender Compositor: Film node.
+ *
+ * Uses Three.js FilmPass (r165 constructor: intensity, grayscale).
+ */
+export class FilmGrain extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'FilmGrain';
+        this.parameters = {
+            intensity: opts.intensity ?? 0.35,
+            greyscale: opts.greyscale ? 1 : 0,
+        };
+    }
+    _threePassDeps() { return ['FilmPass']; }
+    _buildThree(_width, _height, reg) {
+        const Pass = reg['FilmPass'];
+        if (!Pass)
+            throw new Error('FilmGrain: FilmPass not found in three/addons.');
+        // r165 FilmPass(intensity, grayscale)
+        return new Pass(this.parameters.intensity, this.parameters.greyscale > 0.5);
+    }
+    _buildPmndrs(reg) {
+        const Effect = reg['NoiseEffect'];
+        if (!Effect)
+            throw new Error('FilmGrain: NoiseEffect not found in postprocessing.');
+        return new Effect({ premultiply: true });
+    }
+    get _isPmndrsEffect() { return true; }
+}

package/dist/passes/Gamma.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Gamma.d.ts","sourceRoot":"","sources":["../../src/passes/Gamma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,6CAA6C;AAC7C,qBAAa,KAAM,SAAQ,QAAQ;IACjC,QAAQ,CAAC,QAAQ,WAAU;IAC3B,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEjB,IAAI,GAAE,YAAiB;IAKnC,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CA0BzE"}

package/dist/passes/Gamma.js

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

package/dist/passes/GaussianBlur.d.ts

@@ -0,0 +1,26 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface GaussianBlurOptions {
+    /** Blur sigma (standard deviation in pixels). Blender: Bilateral Blur → Iterations. Default 2. */
+    sigma?: number;
+    /** Number of passes (1 = single-pass, 2 = separable H+V). Default 2. */
+    passes?: number;
+}
+/**
+ * GaussianBlur — separable Gaussian blur.
+ * Blender Compositor: Blur node (Gaussian filter type) / Bilateral Blur.
+ *
+ * Two-pass separable implementation: horizontal then vertical.
+ * `sigma` controls the standard deviation (width of the bell curve).
+ */
+export declare class GaussianBlur extends BasePass {
+    readonly passType = "GaussianBlur";
+    parameters: {
+        sigma: number;
+        passes: number;
+    };
+    constructor(opts?: GaussianBlurOptions);
+    _threePassDeps(): string[];
+    _buildThree(_w: number, _h: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=GaussianBlur.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GaussianBlur.d.ts","sourceRoot":"","sources":["../../src/passes/GaussianBlur.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,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,QAAQ,kBAAiB;IAClC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEjC,IAAI,GAAE,mBAAwB;IAQ1C,cAAc;IAEd,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAsDhE"}

package/dist/passes/GaussianBlur.js

@@ -0,0 +1,81 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * GaussianBlur — separable Gaussian blur.
+ * Blender Compositor: Blur node (Gaussian filter type) / Bilateral Blur.
+ *
+ * Two-pass separable implementation: horizontal then vertical.
+ * `sigma` controls the standard deviation (width of the bell curve).
+ */
+export class GaussianBlur extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'GaussianBlur';
+        this.parameters = {
+            sigma: opts.sigma ?? 2,
+            passes: opts.passes ?? 2,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_w, _h, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('GaussianBlur: ShaderPass not found.');
+        const sigma = Math.max(0.1, this.parameters.sigma);
+        // 7-tap kernel weights from sigma
+        const kernel = gaussKernel7(sigma);
+        const makePass = (horizontal) => new ShaderPass({
+            uniforms: {
+                tDiffuse: { value: null },
+                resolution: { value: [1920, 1080] },
+                horizontal: { value: horizontal ? 1.0 : 0.0 },
+                sigma: { value: sigma },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform vec2 resolution;
+        uniform float horizontal;
+        uniform float sigma;
+        varying vec2 vUv;
+
+        void main() {
+          vec2 texel = 1.0 / resolution;
+          vec2 dir   = horizontal > 0.5 ? vec2(texel.x, 0.0) : vec2(0.0, texel.y);
+
+          float weights[7];
+          weights[0] = ${kernel[0].toFixed(6)};
+          weights[1] = ${kernel[1].toFixed(6)};
+          weights[2] = ${kernel[2].toFixed(6)};
+          weights[3] = ${kernel[3].toFixed(6)};
+          weights[4] = ${kernel[4].toFixed(6)};
+          weights[5] = ${kernel[5].toFixed(6)};
+          weights[6] = ${kernel[6].toFixed(6)};
+
+          vec4 result = vec4(0.0);
+          for (int i = 0; i < 7; i++) {
+            float offset = float(i - 3);
+            result += texture2D(tDiffuse, vUv + dir * offset * sigma) * weights[i];
+          }
+          gl_FragColor = result;
+        }
+      `,
+        });
+        // Return the horizontal pass; vertical pass is added automatically
+        // by returning an array-like structure. For simplicity return horizontal only
+        // and let the user add a second GaussianBlur pass for full separable blur.
+        return makePass(this.parameters.passes >= 2 ? true : false);
+    }
+}
+function gaussKernel7(sigma) {
+    const k = [0, 0, 0, 0, 0, 0, 0];
+    let sum = 0;
+    for (let i = 0; i < 7; i++) {
+        const x = i - 3;
+        k[i] = Math.exp(-(x * x) / (2 * sigma * sigma));
+        sum += k[i];
+    }
+    return k.map(v => v / sum);
+}

package/dist/passes/GlareStreaks.d.ts

@@ -0,0 +1,38 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface GlareStreaksOptions {
+    /** Luminance threshold — pixels below this don't streak. Blender: Glare → Threshold. Default 0.8. */
+    threshold?: number;
+    /** Streak intensity. Blender: Glare → Strength. Default 1.0. */
+    strength?: number;
+    /** Number of streak directions (2=cross, 4=star, 6=asterisk). Blender: Streaks. Default 4. */
+    streaks?: number;
+    /** Length of each streak in passes. Default 6. */
+    length?: number;
+    /** Angle offset for streak directions in radians. Default 0. */
+    angle?: number;
+    /** Colour fade per pass (attenuation). Default 0.9. */
+    fade?: number;
+}
+/**
+ * GlareStreaks — anamorphic lens streak effect on bright areas.
+ * Blender Compositor: Glare node (Streaks type).
+ *
+ * Builds bright streaks along N evenly-spaced directions by iterative
+ * texture sampling passes in each direction.
+ */
+export declare class GlareStreaks extends BasePass {
+    readonly passType = "GlareStreaks";
+    parameters: {
+        threshold: number;
+        strength: number;
+        streaks: number;
+        length: number;
+        angle: number;
+        fade: number;
+    };
+    constructor(opts?: GlareStreaksOptions);
+    _threePassDeps(): string[];
+    _buildThree(_w: number, _h: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=GlareStreaks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GlareStreaks.d.ts","sourceRoot":"","sources":["../../src/passes/GlareStreaks.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,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,QAAQ,kBAAiB;IAClC,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;gBAErG,IAAI,GAAE,mBAAwB;IAY1C,cAAc;IAEd,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CA8DhE"}

package/dist/passes/GlareStreaks.js

@@ -0,0 +1,82 @@
+import { BasePass } from '../core/BasePass.js';
+/**
+ * GlareStreaks — anamorphic lens streak effect on bright areas.
+ * Blender Compositor: Glare node (Streaks type).
+ *
+ * Builds bright streaks along N evenly-spaced directions by iterative
+ * texture sampling passes in each direction.
+ */
+export class GlareStreaks extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'GlareStreaks';
+        this.parameters = {
+            threshold: opts.threshold ?? 0.8,
+            strength: opts.strength ?? 1.0,
+            streaks: opts.streaks ?? 4,
+            length: opts.length ?? 6,
+            angle: opts.angle ?? 0,
+            fade: opts.fade ?? 0.9,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_w, _h, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('GlareStreaks: ShaderPass not found.');
+        const { threshold, strength, streaks, length, angle, fade } = this.parameters;
+        // Build direction vectors for each streak
+        const dirs = [];
+        for (let i = 0; i < streaks; i++) {
+            const a = angle + (i / streaks) * Math.PI;
+            dirs.push(`vec2(${Math.cos(a).toFixed(6)}, ${Math.sin(a).toFixed(6)})`);
+        }
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                resolution: { value: [1920, 1080] },
+                threshold: { value: threshold },
+                strength: { value: strength },
+                fade: { value: fade },
+                length: { value: length },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform vec2 resolution;
+        uniform float threshold;
+        uniform float strength;
+        uniform float fade;
+        uniform float length;
+        varying vec2 vUv;
+
+        float luminance(vec3 c) { return dot(c, vec3(0.299, 0.587, 0.114)); }
+
+        vec4 sampleStreak(vec2 dir) {
+          vec4 acc  = vec4(0.0);
+          float att = 1.0;
+          vec2 step = dir / resolution;
+          for (int i = 1; i <= ${Math.max(1, Math.round(length))}; i++) {
+            vec2 uv   = vUv + step * float(i) * strength;
+            vec4 samp = texture2D(tDiffuse, clamp(uv, 0.0, 1.0));
+            float lum = luminance(samp.rgb);
+            if (lum > threshold) acc += samp * att;
+            att *= fade;
+          }
+          return acc;
+        }
+
+        void main() {
+          vec4 base = texture2D(tDiffuse, vUv);
+          vec4 glare = vec4(0.0);
+          ${dirs.map(d => `glare += sampleStreak(${d});`).join('\n          ')}
+          gl_FragColor = base + glare * (1.0 / ${Math.max(1, streaks)}.0);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/HueSaturation.d.ts

@@ -0,0 +1,26 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface HueSaturationOptions {
+    /** Hue rotation [0–1] where 0.5 = no change. Default 0.5. Blender: Hue/Sat → Hue */
+    hue?: number;
+    /** Saturation multiplier. Default 1. Blender: Hue/Sat → Saturation */
+    saturation?: number;
+    /** Value (brightness) multiplier. Default 1. Blender: Hue/Sat → Value */
+    value?: number;
+    /** Blend factor [0–1]. Default 1. */
+    fac?: number;
+}
+/** HueSaturation — Blender Compositor: Hue Saturation Value node */
+export declare class HueSaturation extends BasePass {
+    readonly passType = "HueSaturation";
+    parameters: {
+        hue: number;
+        saturation: number;
+        value: number;
+        fac: number;
+    };
+    constructor(opts?: HueSaturationOptions);
+    _threePassDeps(): string[];
+    _buildThree(_width: number, _height: number, reg: PassRegistry): unknown;
+}
+//# sourceMappingURL=HueSaturation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HueSaturation.d.ts","sourceRoot":"","sources":["../../src/passes/HueSaturation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,oEAAoE;AACpE,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,QAAQ,mBAAkB;IACnC,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;gBAE/D,IAAI,GAAE,oBAAyB;IAU3C,cAAc;IAEd,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;CAkDzE"}

package/dist/passes/HueSaturation.js

@@ -0,0 +1,65 @@
+import { BasePass } from '../core/BasePass.js';
+/** HueSaturation — Blender Compositor: Hue Saturation Value node */
+export class HueSaturation extends BasePass {
+    constructor(opts = {}) {
+        super();
+        this.passType = 'HueSaturation';
+        this.parameters = {
+            hue: opts.hue ?? 0.5,
+            saturation: opts.saturation ?? 1.0,
+            value: opts.value ?? 1.0,
+            fac: opts.fac ?? 1.0,
+        };
+    }
+    _threePassDeps() { return ['ShaderPass']; }
+    _buildThree(_width, _height, reg) {
+        const ShaderPass = reg['ShaderPass'];
+        if (!ShaderPass)
+            throw new Error('HueSaturation: ShaderPass not found in three/addons.');
+        const shader = {
+            uniforms: {
+                tDiffuse: { value: null },
+                hue: { value: this.parameters.hue },
+                saturation: { value: this.parameters.saturation },
+                value: { value: this.parameters.value },
+                fac: { value: this.parameters.fac },
+            },
+            vertexShader: `
+        varying vec2 vUv;
+        void main() { vUv = uv; gl_Position = projectionMatrix * modelViewMatrix * vec4(position,1.0); }
+      `,
+            fragmentShader: `
+        uniform sampler2D tDiffuse;
+        uniform float hue;
+        uniform float saturation;
+        uniform float value;
+        uniform float fac;
+        varying vec2 vUv;
+
+        vec3 rgb2hsv(vec3 c) {
+          vec4 K = vec4(0.0,-1.0/3.0,2.0/3.0,-1.0);
+          vec4 p = mix(vec4(c.bg,K.wz), vec4(c.gb,K.xy), step(c.b,c.g));
+          vec4 q = mix(vec4(p.xyw,c.r), vec4(c.r,p.yzx), step(p.x,c.r));
+          float d = q.x - min(q.w, q.y);
+          return vec3(abs(q.z + (q.w - q.y) / (6.0*d+1e-10)), d/(q.x+1e-10), q.x);
+        }
+
+        vec3 hsv2rgb(vec3 c) {
+          vec4 K = vec4(1.0,2.0/3.0,1.0/3.0,3.0);
+          vec3 p = abs(fract(c.xxx + K.xyz) * 6.0 - K.www);
+          return c.z * mix(K.xxx, clamp(p - K.xxx, 0.0, 1.0), c.y);
+        }
+
+        void main() {
+          vec4 tex = texture2D(tDiffuse, vUv);
+          vec3 hsv = rgb2hsv(tex.rgb);
+          hsv.x = fract(hsv.x + hue - 0.5);
+          hsv.y = clamp(hsv.y * saturation, 0.0, 1.0);
+          hsv.z = hsv.z * value;
+          gl_FragColor = vec4(mix(tex.rgb, hsv2rgb(hsv), fac), tex.a);
+        }
+      `,
+        };
+        return new ShaderPass(shader);
+    }
+}

package/dist/passes/LUT.d.ts

@@ -0,0 +1,64 @@
+import { BasePass } from '../core/BasePass.js';
+import type { PassRegistry } from '../core/BasePass.js';
+export interface LUTOptions {
+    /** Blend intensity — 0 = original, 1 = full LUT. Default 1. */
+    intensity?: number;
+    /**
+     * LUT size N (must match the texture supplied later).
+     * Neutral LUT for an N³ cube: `LUT.createNeutral(N)`.
+     * Default 32.
+     */
+    lutSize?: number;
+}
+/**
+ * LUT — 3-D Look-Up Table colour grading pass.
+ * Blender Compositor: Color Balance node (via a baked LUT).
+ *
+ * Usage:
+ * ```typescript
+ * const lut = new LUT({ intensity: 1 })
+ * comp.add(lut)
+ * await comp.compile()
+ *
+ * // Apply a custom grade — warm highlights + cool shadows
+ * lut.setLUT(LUT.createFromFn(32, (r, g, b) => [
+ *   r * 1.1 + b * 0.05,
+ *   g,
+ *   b * 1.1 + r * 0.02,
+ * ]))
+ * ```
+ *
+ * The LUT texture is a Data3DTexture (Three.js r137+).
+ * Use `LUT.createNeutral(N)` for a passthrough LUT, then modify the data.
+ * Use `LUT.createFromFn(N, fn)` to build from a mapping function.
+ */
+export declare class LUT extends BasePass {
+    readonly passType = "LUT";
+    parameters: {
+        intensity: number;
+        lutSize: number;
+    };
+    /** The Three.js Data3DTexture (or null until setLUT() is called). */
+    lutTexture: unknown;
+    private _pass;
+    constructor(opts?: LUTOptions);
+    _threePassDeps(): string[];
+    _buildThree(_w: number, _h: number, reg: PassRegistry): unknown;
+    /**
+     * Replace the active LUT texture at runtime.
+     * Pass a Three.js Data3DTexture — see `LUT.createNeutral` / `LUT.createFromFn`.
+     */
+    setLUT(tex: unknown): void;
+    /**
+     * Create a neutral (identity) N³ LUT Data3DTexture.
+     * Requires a Three.js instance — pass in the THREE namespace.
+     */
+    static createNeutral(THREE: Record<string, unknown>, N?: number): unknown;
+    /**
+     * Create a Data3DTexture from a mapping function `(r,g,b) => [r,g,b]`
+     * where all channels are in [0, 1].
+     */
+    static createFromFn(THREE: Record<string, unknown>, N: number, fn: (r: number, g: number, b: number) => [number, number, number]): unknown;
+    private static _makeData3DTexture;
+}
+//# sourceMappingURL=LUT.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LUT.d.ts","sourceRoot":"","sources":["../../src/passes/LUT.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,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,GAAI,SAAQ,QAAQ;IAC/B,QAAQ,CAAC,QAAQ,SAAQ;IACzB,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAElD,qEAAqE;IACrE,UAAU,EAAE,OAAO,CAAO;IAE1B,OAAO,CAAC,KAAK,CAAgB;gBAEjB,IAAI,GAAE,UAAe;IAQjC,cAAc;IAEd,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO;IAyC/D;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAU1B;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAK,GAAG,OAAO;IAgBrE;;;OAGG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAChE,OAAO;IAiBV,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAWlC"}