@flighthq/effects-gl 0.1.0 → 0.2.1-next.410.a23f189

package/dist/glBevelEffect.d.ts

@@ -0,0 +1,4 @@
+import type { BevelEffect, GlRenderEffectRunner, GlRenderState, GlRenderTarget, GlRenderTargetPool } from '@flighthq/types';
+export declare function applyBevelEffectToGl(state: GlRenderState, source: Readonly<GlRenderTarget>, dest: Readonly<GlRenderTarget>, pool: GlRenderTargetPool, effect: Readonly<BevelEffect>): void;
+export declare const defaultGlBevelEffectRunner: GlRenderEffectRunner;
+//# sourceMappingURL=glBevelEffect.d.ts.map

package/dist/glBevelEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glBevelEffect.d.ts","sourceRoot":"","sources":["../src/glBevelEffect.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EAEX,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAqBzB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAsDN;AAED,eAAO,MAAM,0BAA0B,EAAE,oBAExC,CAAC"}

package/dist/glBevelEffect.js

@@ -0,0 +1,134 @@
+import { acquireGlRenderTarget, clearGlRenderTarget, compileGlFullscreenProgram, drawGlFullscreenPass, releaseGlRenderTarget, } from '@flighthq/render-gl';
+import { applyGlEffectBlitPass, applyGlEffectErasePass } from './glEffectBlitShader';
+import { applyGlEffectBoxBlur } from './glEffectBoxBlur';
+import { applyGlEffectTintPass } from './glEffectTintShader';
+// Bevel composite effect: the directional gradient of the blurred silhouette drives a highlight/shadow edge band, clipped by bevelType and composited over the source.
+// Full-frame realization: acquires the recipe's three scratch targets from the effect pool, runs the
+// inlined multi-pass recipe, then releases them.
+//
+// The bevel is the directional gradient of the source's blurred alpha:
+// `gradient = m(p − L) − m(p + L)` where `m` is the blurred alpha and
+// `L = (cos angle, sin angle) · distance`. A positive gradient (the edge facing
+// the light) draws the highlight color; a negative gradient draws the shadow
+// color; `|gradient| · strength` is the band's alpha. The resulting tinted mask
+// is composited over the source — matching `bevelSurface` (the CPU reference).
+//
+// `bevelType` clips the mask:
+//   - `'inner'` (default): keep the band inside the shape (× source alpha)
+//   - `'outer'`: keep it outside the shape (× 1 − source alpha)
+//   - `'full'`: no clip
+export function applyBevelEffectToGl(state, source, dest, pool, effect) {
+    const descriptor = { width: source.width, height: source.height, format: source.format };
+    const s0 = acquireGlRenderTarget(state, pool, descriptor);
+    const s1 = acquireGlRenderTarget(state, pool, descriptor);
+    const s2 = acquireGlRenderTarget(state, pool, descriptor);
+    const src = source;
+    const dst = dest;
+    const angle = ((effect.angle ?? 45) * Math.PI) / 180;
+    const distance = effect.distance ?? 4;
+    // Match the surface reference, which snaps the light offset to whole pixels.
+    const offsetX = Math.round(Math.cos(angle) * distance);
+    const offsetY = Math.round(Math.sin(angle) * distance);
+    const shadowColor = effect.shadowColor ?? 0x000000;
+    const shadowAlpha = effect.shadowAlpha ?? 1;
+    const highlightColor = effect.highlightColor ?? 0xffffff;
+    const highlightAlpha = effect.highlightAlpha ?? 1;
+    const strength = effect.strength ?? 1;
+    const quality = Math.max(1, Math.round(effect.quality ?? 1));
+    const sourceMode = effect.sourceMode ?? 'draw';
+    const bevelType = effect.bevelType ?? 'inner';
+    const [tinted, blurred, blurTemp] = [s0, s1, s2];
+    // Blurred alpha field (neutral white tint, strength 1 — strength is the gradient
+    // intensity applied per-pixel in the composite, not baked into the field).
+    applyGlEffectTintPass(state, src, tinted, 0xffffff, 1, 1);
+    applyGlEffectBoxBlur(state, tinted, blurred, blurTemp, {
+        blurX: effect.blurX ?? 4,
+        blurY: effect.blurY ?? 4,
+        passes: quality,
+    });
+    clearGlRenderTarget(state, dst);
+    if (sourceMode === 'draw')
+        applyGlEffectBlitPass(state, src, dst);
+    applyGlBevelCompositePass(state, blurred, src, dst, {
+        offsetX: offsetX / src.width,
+        // Negate Y to match the screen-space-Y-down offset convention used by applyGlEffectBlitOffsetPass.
+        offsetY: -offsetY / src.height,
+        highlightColor,
+        highlightAlpha,
+        shadowColor,
+        shadowAlpha,
+        intensity: strength,
+        clipMode: bevelType === 'inner' ? 1 : bevelType === 'outer' ? 2 : 0,
+    });
+    if (sourceMode === 'knockout')
+        applyGlEffectErasePass(state, src, dst);
+    releaseGlRenderTarget(pool, s0);
+    releaseGlRenderTarget(pool, s1);
+    releaseGlRenderTarget(pool, s2);
+}
+export const defaultGlBevelEffectRunner = (ctx, effect) => {
+    applyBevelEffectToGl(ctx.state, ctx.source, ctx.dest, ctx.pool, effect);
+};
+// Reads the blurred alpha field (unit 0) and source (unit 1); writes the tinted, clipped bevel mask,
+// premultiplied, blended over `dest` (which already holds the source when sourceMode is 'draw').
+const BEVEL_COMPOSITE_FRAGMENT_SRC = `#version 300 es
+precision mediump float;
+in vec2 v_texCoord;
+uniform sampler2D u_texture0;
+uniform sampler2D u_texture1;
+uniform vec4 u_highlight;
+uniform vec4 u_shadow;
+uniform vec2 u_offset;
+uniform float u_intensity;
+uniform float u_clipMode;
+out vec4 fragColor;
+
+float sampleField(vec2 uv) {
+  if (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0) return 0.0;
+  return texture(u_texture0, uv).a;
+}
+
+void main() {
+  float lit = sampleField(v_texCoord - u_offset);
+  float shade = sampleField(v_texCoord + u_offset);
+  float gradient = lit - shade;
+  float srcA = texture(u_texture1, v_texCoord).a;
+  bool isHighlight = gradient >= 0.0;
+  vec3 color = isHighlight ? u_highlight.rgb : u_shadow.rgb;
+  float colorAlpha = isHighlight ? u_highlight.a : u_shadow.a;
+  float clip = 1.0;
+  if (u_clipMode == 1.0) { clip = srcA; }
+  else if (u_clipMode == 2.0) { clip = 1.0 - srcA; }
+  float edge = min(1.0, abs(gradient) * u_intensity);
+  float a = edge * colorAlpha * clip;
+  fragColor = vec4(color * a, a);
+}`;
+const bevelCompositeShaders = new WeakMap();
+function applyGlBevelCompositePass(state, field, source, dest, params) {
+    const loc = getGlBevelCompositeShader(state);
+    drawGlFullscreenPass(state, loc, [field.texture, source.texture], dest, (gl) => {
+        gl.uniform4f(loc.locHighlight, ((params.highlightColor >> 16) & 0xff) / 255, ((params.highlightColor >> 8) & 0xff) / 255, (params.highlightColor & 0xff) / 255, params.highlightAlpha);
+        gl.uniform4f(loc.locShadow, ((params.shadowColor >> 16) & 0xff) / 255, ((params.shadowColor >> 8) & 0xff) / 255, (params.shadowColor & 0xff) / 255, params.shadowAlpha);
+        gl.uniform2f(loc.locOffset, params.offsetX, params.offsetY);
+        gl.uniform1f(loc.locIntensity, params.intensity);
+        gl.uniform1f(loc.locClipMode, params.clipMode);
+    });
+}
+function getGlBevelCompositeShader(state) {
+    let loc = bevelCompositeShaders.get(state);
+    if (loc === undefined) {
+        const gl = state.gl;
+        const base = compileGlFullscreenProgram(gl, BEVEL_COMPOSITE_FRAGMENT_SRC);
+        loc = {
+            ...base,
+            locHighlight: gl.getUniformLocation(base.program, 'u_highlight'),
+            locShadow: gl.getUniformLocation(base.program, 'u_shadow'),
+            locOffset: gl.getUniformLocation(base.program, 'u_offset'),
+            locIntensity: gl.getUniformLocation(base.program, 'u_intensity'),
+            locClipMode: gl.getUniformLocation(base.program, 'u_clipMode'),
+        };
+        bevelCompositeShaders.set(state, loc);
+    }
+    return loc;
+}
+//# sourceMappingURL=glBevelEffect.js.map

package/dist/glBevelEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glBevelEffect.js","sourceRoot":"","sources":["../src/glBevelEffect.ts"],"names":[],"mappings":"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"}

package/dist/glBlendEffect.d.ts

@@ -0,0 +1,8 @@
+import type { AdvancedBlendMode, BlendEffect, GlRenderEffectRunner, GlRenderState, GlRenderTarget } from '@flighthq/types';
+export declare function applyBlendEffectToGl(state: GlRenderState, source: Readonly<GlRenderTarget>, dest: Readonly<GlRenderTarget>, effect: Readonly<BlendEffect>): void;
+export declare const defaultGlBlendEffectRunner: GlRenderEffectRunner;
+export declare function getBlendEffectModeIndex(mode: AdvancedBlendMode): number;
+export declare function getGlBlendEffectBackdrop(state: GlRenderState, backdropKey: string | null): WebGLTexture | null;
+export declare function registerGlBlendEffectBackdrop(state: GlRenderState, backdropKey: string, texture: WebGLTexture): void;
+export declare function unregisterGlBlendEffectBackdrop(state: GlRenderState, backdropKey: string): boolean;
+//# sourceMappingURL=glBlendEffect.d.ts.map

package/dist/glBlendEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glBlendEffect.d.ts","sourceRoot":"","sources":["../src/glBlendEffect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AAezB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAkBN;AAED,eAAO,MAAM,0BAA0B,EAAE,oBAExC,CAAC;AAIF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAEvE;AAID,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAG9G;AAKD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAOpH;AAID,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAElG"}

package/dist/glBlendEffect.js

@@ -0,0 +1,169 @@
+import { drawGlFullscreenPass } from '@flighthq/render-gl';
+import { AdvancedBlendMode as AdvancedBlendModeValues } from '@flighthq/types';
+import { getGlEffectProgram, getGlEffectUniformLocation } from './glEffectProgramCache';
+// Advanced-blend composite pass: sample the incoming layer (`u_texture0`, the effect's `source`) and a
+// registered backdrop (`u_texture1`), compute the destination-reading / non-separable blend named by the
+// effect's `mode`, composite the blended color over the backdrop (Porter-Duff source-over), and write to
+// `dest`. This is the GL realization of the `BlendEffect` composite recipe — the escape hatch for the
+// AdvancedBlendMode set the fixed-function BlendMode enum cannot express. The GLSL mirrors
+// @flighthq/effects blendModeMath exactly, so the pass is verified against those plain-number tests.
+//
+// The backdrop is looked up by the effect's `backdropKey` in the per-state backdrop registry populated by
+// registerGlBlendEffectBackdrop. An unregistered (or absent) key composites the layer over an implicit
+// transparent backdrop, which reduces to source-over passthrough rather than erroring.
+export function applyBlendEffectToGl(state, source, dest, effect) {
+    const backdrop = getGlBlendEffectBackdrop(state, effect.backdropKey ?? null);
+    const program = getGlEffectProgram(state, 'blend.advanced', BLEND_FRAGMENT_SRC);
+    const modeIndex = getBlendEffectModeIndex(effect.mode);
+    const opacity = effect.opacity ?? 1;
+    const hasBackdrop = backdrop !== null;
+    // Bind the layer to unit 0 and the backdrop (or the layer itself as a harmless stand-in) to unit 1;
+    // `u_hasBackdrop` gates whether unit 1 is used, so a missing backdrop is a source-over passthrough.
+    const inputs = [source.texture, hasBackdrop ? backdrop : source.texture];
+    drawGlFullscreenPass(state, program, inputs, dest, (gl, p) => {
+        const modeLoc = getGlEffectUniformLocation(state, p, 'u_mode');
+        const opacityLoc = getGlEffectUniformLocation(state, p, 'u_opacity');
+        const hasBackdropLoc = getGlEffectUniformLocation(state, p, 'u_hasBackdrop');
+        if (modeLoc !== null)
+            gl.uniform1i(modeLoc, modeIndex);
+        if (opacityLoc !== null)
+            gl.uniform1f(opacityLoc, opacity);
+        if (hasBackdropLoc !== null)
+            gl.uniform1i(hasBackdropLoc, hasBackdrop ? 1 : 0);
+    });
+}
+export const defaultGlBlendEffectRunner = (ctx, effect) => {
+    applyBlendEffectToGl(ctx.state, ctx.source, ctx.dest, effect);
+};
+// Maps an AdvancedBlendMode string to the integer the fragment shader switches on. Kept in lockstep with
+// the BLEND_FRAGMENT_SRC branch order; an unknown mode maps to -1 (Normal passthrough in the shader).
+export function getBlendEffectModeIndex(mode) {
+    return BLEND_MODE_INDEX[mode] ?? -1;
+}
+// Returns the backdrop texture registered under `backdropKey` for this state, or null when the key is
+// null/absent or nothing is registered. Doubles as the introspection query for the passthrough fallback.
+export function getGlBlendEffectBackdrop(state, backdropKey) {
+    if (backdropKey === null)
+        return null;
+    return _backdrops.get(state)?.get(backdropKey) ?? null;
+}
+// Registers a backdrop texture under `backdropKey` for this state, so a BlendEffect naming that key
+// blends its layer over the texture. Last write wins. Pass a texture produced by the caller (e.g. a
+// prior render target's `.texture`); the registry holds the handle only and never owns/frees it.
+export function registerGlBlendEffectBackdrop(state, backdropKey, texture) {
+    let registry = _backdrops.get(state);
+    if (registry === undefined) {
+        registry = new Map();
+        _backdrops.set(state, registry);
+    }
+    registry.set(backdropKey, texture);
+}
+// Removes the backdrop registered under `backdropKey` for this state, returning true if one was present.
+// The texture itself is the caller's to free; this only drops the registry reference.
+export function unregisterGlBlendEffectBackdrop(state, backdropKey) {
+    return _backdrops.get(state)?.delete(backdropKey) ?? false;
+}
+// AdvancedBlendMode → shader branch index. Alphabetical by value; kept in lockstep with the switch in
+// BLEND_FRAGMENT_SRC. The four HSL modes (Color/Hue/Luminosity/Saturation) take indices 7..10.
+const BLEND_MODE_INDEX = {
+    [AdvancedBlendModeValues.Overlay]: 0,
+    [AdvancedBlendModeValues.HardLight]: 1,
+    [AdvancedBlendModeValues.SoftLight]: 2,
+    [AdvancedBlendModeValues.Difference]: 3,
+    [AdvancedBlendModeValues.Exclusion]: 4,
+    [AdvancedBlendModeValues.ColorDodge]: 5,
+    [AdvancedBlendModeValues.ColorBurn]: 6,
+    [AdvancedBlendModeValues.Hue]: 7,
+    [AdvancedBlendModeValues.Saturation]: 8,
+    [AdvancedBlendModeValues.Color]: 9,
+    [AdvancedBlendModeValues.Luminosity]: 10,
+};
+// Per-state backdrop registry. Off the render-state runtime type, freed with the state. Holds texture
+// handles only — never owns or frees them.
+const _backdrops = new WeakMap();
+// The advanced-blend fragment shader. Layer = u_texture0 (premultiplied), backdrop = u_texture1. Both are
+// un-premultiplied to straight RGB for the blend math, blended via the mode's B(cb, cs), then the blended
+// color is composited over the backdrop with W3C mixing (cs' = (1 - ab)*cs + ab*B) and Porter-Duff
+// source-over, re-premultiplied on output. The separable/HSL formulas mirror effects/blendModeMath.ts.
+const BLEND_FRAGMENT_SRC = `#version 300 es
+precision highp float;
+in vec2 v_texCoord;
+uniform sampler2D u_texture0;
+uniform sampler2D u_texture1;
+uniform int u_mode;
+uniform float u_opacity;
+uniform int u_hasBackdrop;
+out vec4 o_color;
+
+float lum(vec3 c) { return 0.3 * c.r + 0.59 * c.g + 0.11 * c.b; }
+float sat(vec3 c) { return max(max(c.r, c.g), c.b) - min(min(c.r, c.g), c.b); }
+
+vec3 clipColor(vec3 c) {
+  float l = lum(c);
+  float mn = min(min(c.r, c.g), c.b);
+  float mx = max(max(c.r, c.g), c.b);
+  if (mn < 0.0) c = l + (c - l) * l / (l - mn);
+  if (mx > 1.0) c = l + (c - l) * (1.0 - l) / (mx - l);
+  return c;
+}
+vec3 setLum(vec3 c, float l) { return clipColor(c + (l - lum(c))); }
+
+vec3 setSat(vec3 c, float s) {
+  // Resolve min/mid/max channels, rescale mid+max to s, pin min to 0. Branchy but only three channels.
+  float mn = min(min(c.r, c.g), c.b);
+  float mx = max(max(c.r, c.g), c.b);
+  float md = (c.r + c.g + c.b) - mn - mx;
+  vec3 o;
+  float rmid = (mx > mn) ? (md - mn) * s / (mx - mn) : 0.0;
+  float rmax = (mx > mn) ? s : 0.0;
+  o.r = (c.r == mx) ? rmax : ((c.r == mn) ? 0.0 : rmid);
+  o.g = (c.g == mx) ? rmax : ((c.g == mn) ? 0.0 : rmid);
+  o.b = (c.b == mx) ? rmax : ((c.b == mn) ? 0.0 : rmid);
+  return o;
+}
+
+float sepChannel(int mode, float cb, float cs) {
+  if (mode == 0) return cb <= 0.5 ? 2.0 * cb * cs : 1.0 - 2.0 * (1.0 - cb) * (1.0 - cs);      // Overlay
+  if (mode == 1) return cs <= 0.5 ? 2.0 * cb * cs : 1.0 - 2.0 * (1.0 - cb) * (1.0 - cs);      // HardLight
+  if (mode == 2) {                                                                             // SoftLight
+    float d = cb <= 0.25 ? ((16.0 * cb - 12.0) * cb + 4.0) * cb : sqrt(cb);
+    return cs <= 0.5 ? cb - (1.0 - 2.0 * cs) * cb * (1.0 - cb) : cb + (2.0 * cs - 1.0) * (d - cb);
+  }
+  if (mode == 3) return abs(cb - cs);                                                          // Difference
+  if (mode == 4) return cb + cs - 2.0 * cb * cs;                                               // Exclusion
+  if (mode == 5) return cb <= 0.0 ? 0.0 : (cs >= 1.0 ? 1.0 : min(1.0, cb / (1.0 - cs)));       // ColorDodge
+  if (mode == 6) return cb >= 1.0 ? 1.0 : (cs <= 0.0 ? 0.0 : 1.0 - min(1.0, (1.0 - cb) / cs)); // ColorBurn
+  return cs;                                                                                   // Normal
+}
+
+vec3 blendRgb(int mode, vec3 cb, vec3 cs) {
+  if (mode == 7) return setLum(setSat(cs, sat(cb)), lum(cb));  // Hue
+  if (mode == 8) return setLum(setSat(cb, sat(cs)), lum(cb));  // Saturation
+  if (mode == 9) return setLum(cs, lum(cb));                   // Color
+  if (mode == 10) return setLum(cb, lum(cs));                  // Luminosity
+  return vec3(sepChannel(mode, cb.r, cs.r), sepChannel(mode, cb.g, cs.g), sepChannel(mode, cb.b, cs.b));
+}
+
+void main() {
+  vec4 layer = texture(u_texture0, v_texCoord);
+  // No backdrop registered: the blend has nothing to read, so pass the layer through unchanged.
+  if (u_hasBackdrop == 0) { o_color = layer; return; }
+  vec4 back = texture(u_texture1, v_texCoord);
+
+  // Un-premultiply to straight RGB for the blend math.
+  vec3 cs = layer.a > 0.0 ? layer.rgb / layer.a : vec3(0.0);
+  vec3 cb = back.a > 0.0 ? back.rgb / back.a : vec3(0.0);
+  float as = layer.a * u_opacity;
+  float ab = back.a;
+
+  // W3C blend mixing: the blended color contributes only where the backdrop is opaque; elsewhere the
+  // straight source shows through. cs' = (1 - ab) * cs + ab * B(cb, cs).
+  vec3 blended = blendRgb(u_mode, cb, cs);
+  vec3 mixed = (1.0 - ab) * cs + ab * blended;
+
+  // Porter-Duff source-over of the (mixed) layer onto the backdrop, output premultiplied.
+  float outA = as + ab * (1.0 - as);
+  vec3 outRgb = mixed * as + cb * ab * (1.0 - as);
+  o_color = vec4(outRgb, outA);
+}`;
+//# sourceMappingURL=glBlendEffect.js.map

package/dist/glBlendEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glBlendEffect.js","sourceRoot":"","sources":["../src/glBlendEffect.ts"],"names":[],"mappings":"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"}

package/dist/glBloomEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glBloomEffect.d.ts","sourceRoot":"","sources":["../src/glBloomEffect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAOzB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAyBN;AAED,eAAO,MAAM,0BAA0B,EAAE,oBAExC,CAAC"}
+{"version":3,"file":"glBloomEffect.d.ts","sourceRoot":"","sources":["../src/glBloomEffect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAQzB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAyBN;AAED,eAAO,MAAM,0BAA0B,EAAE,oBAExC,CAAC"}

package/dist/glBloomEffect.js

@@ -1,10 +1,10 @@
 import { computeBloomBlurRadius, computeBloomIntensity, computeBloomThreshold } from '@flighthq/effects';
-import { applyGaussianBlurFilterToGl } from '@flighthq/filters-gl';
 import { acquireGlRenderTarget, drawGlFullscreenPass, releaseGlRenderTarget } from '@flighthq/render-gl';
+import { applyGaussianBlurToGl } from './glBlurEffect';
 import { getGlEffectProgram } from './glEffectProgramCache';
-// Bloom: bright-pass → blur the bright branch (reusing the Tier-1 gaussian blur filter) → additively
-// composite back. The multi-pass reference recipe — it acquires intermediate targets from the pool
-// and releases them, branches, and reuses a filter, which is what makes it an effect and not a filter.
+// Bloom: bright-pass → blur the bright branch (via the effects-owned separable gaussian blur) →
+// additively composite back. The multi-pass reference recipe — it acquires intermediate targets from
+// the pool and releases them, branches, and reuses the blur primitive, which is what makes it an effect.
 export function applyBloomEffectToGl(state, source, dest, pool, effect) {
     const threshold = computeBloomThreshold(effect);
     const intensity = computeBloomIntensity(effect);
@@ -17,7 +17,7 @@ export function applyBloomEffectToGl(state, source, dest, pool, effect) {
     drawGlFullscreenPass(state, brightProgram, [source.texture], bright, (gl, program) => {
         gl.uniform1f(gl.getUniformLocation(program.program, 'u_threshold'), threshold);
     });
-    applyGaussianBlurFilterToGl(state, bright, blurred, temp, { blurX: radius, blurY: radius });
+    applyGaussianBlurToGl(state, bright, blurred, temp, { blurX: radius, blurY: radius });
     const compositeProgram = getGlEffectProgram(state, 'bloom.composite', BLOOM_COMPOSITE_FRAGMENT_SRC);
     drawGlFullscreenPass(state, compositeProgram, [source.texture, blurred.texture], dest, (gl, program) => {
         gl.uniform1f(gl.getUniformLocation(program.program, 'u_intensity'), intensity);

package/dist/glBloomEffect.js.map

@@ -1 +1 @@
-{"version":3,"file":"glBloomEffect.js","sourceRoot":"","sources":["../src/glBloomEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AASzG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qGAAqG;AACrG,mGAAmG;AACnG,uGAAuG;AACvG,MAAM,UAAU,oBAAoB,CAClC,KAAoB,EACpB,MAAgC,EAChC,IAA8B,EAC9B,IAAwB,EACxB,MAA6B;IAE7B,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAEzF,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAE5D,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,yBAAyB,CAAC,CAAC;IAC3F,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE;QACnF,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,SAAS,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5F,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,4BAA4B,CAAC,CAAC;IACpG,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE;QACrG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,SAAS,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IAC9E,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAqB,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG;;;;;;;;;;;EAWhC,CAAC;AAEH,MAAM,4BAA4B,GAAG;;;;;;;;;;;EAWnC,CAAC"}
+{"version":3,"file":"glBloomEffect.js","sourceRoot":"","sources":["../src/glBloomEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AASzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,gGAAgG;AAChG,qGAAqG;AACrG,yGAAyG;AACzG,MAAM,UAAU,oBAAoB,CAClC,KAAoB,EACpB,MAAgC,EAChC,IAA8B,EAC9B,IAAwB,EACxB,MAA6B;IAE7B,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAEzF,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAE5D,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,yBAAyB,CAAC,CAAC;IAC3F,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE;QACnF,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,SAAS,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtF,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,4BAA4B,CAAC,CAAC;IACpG,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE;QACrG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,SAAS,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IAC9E,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAqB,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG;;;;;;;;;;;EAWhC,CAAC;AAEH,MAAM,4BAA4B,GAAG;;;;;;;;;;;EAWnC,CAAC"}

package/dist/glBlurEffect.d.ts

@@ -0,0 +1,8 @@
+import type { BlurEffect, GlRenderEffectRunner, GlRenderState, GlRenderTarget } from '@flighthq/types';
+export declare function applyBlurEffectToGl(state: GlRenderState, source: Readonly<GlRenderTarget>, dest: Readonly<GlRenderTarget>, temp: Readonly<GlRenderTarget>, effect: Readonly<BlurEffect>): void;
+export declare function applyGaussianBlurToGl(state: GlRenderState, source: Readonly<GlRenderTarget>, dest: Readonly<GlRenderTarget>, temp: Readonly<GlRenderTarget>, options: Readonly<{
+    blurX?: number;
+    blurY?: number;
+}>): void;
+export declare const defaultGlBlurEffectRunner: GlRenderEffectRunner;
+//# sourceMappingURL=glBlurEffect.d.ts.map

package/dist/glBlurEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glBlurEffect.d.ts","sourceRoot":"","sources":["../src/glBlurEffect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAYvG,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAC3B,IAAI,CAEN;AAMD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,OAAO,EAAE,QAAQ,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,IAAI,CAON;AAED,eAAO,MAAM,yBAAyB,EAAE,oBAKvC,CAAC"}

package/dist/glBlurEffect.js

@@ -0,0 +1,65 @@
+import { acquireGlRenderTarget, drawGlFullscreenPass, releaseGlRenderTarget } from '@flighthq/render-gl';
+import { getGlEffectProgram, getGlEffectUniformLocation } from './glEffectProgramCache';
+// Plain separable Gaussian blur: two axis passes (source → temp horizontally, temp → dest vertically),
+// each a single weighted fullscreen pass with radius ⌈3σ⌉. `blurX`/`blurY` are the Gaussian standard
+// deviations (CSS `blur(Xpx)` uses sigma = X), so this matches the CSS and surface Gaussian references.
+// The effects-owned blur primitive — the shared gaussian pass BloomEffect and the plain BlurEffect both
+// use, so the effects backend owns its blur outright rather than delegating to a filters backend.
+// Applies a `BlurEffect` descriptor to `source`, writing to `dest`. `temp` is a ping-pong scratch
+// target distinct from both `source` and `dest`.
+export function applyBlurEffectToGl(state, source, dest, temp, effect) {
+    applyGaussianBlurToGl(state, source, dest, temp, { blurX: effect.blurX, blurY: effect.blurY });
+}
+// Applies a faithful separable Gaussian blur to `source`, writing to `dest`. `blurX`/`blurY` are the
+// Gaussian standard deviations in pixels (default 4). Runs two unconditional separable passes,
+// source → temp (X) then temp → dest (Y); a zero-radius axis copies through unchanged, so the result
+// always lands in `dest` without a separate blit. `temp` is a ping-pong scratch distinct from both.
+export function applyGaussianBlurToGl(state, source, dest, temp, options) {
+    const sigmaX = options.blurX ?? 4;
+    const sigmaY = options.blurY ?? 4;
+    const radiusX = sigmaX > 0 ? Math.ceil(sigmaX * 3) : 0;
+    const radiusY = sigmaY > 0 ? Math.ceil(sigmaY * 3) : 0;
+    applyGlGaussianBlurPass(state, source, temp, sigmaX, radiusX, 1, 0);
+    applyGlGaussianBlurPass(state, temp, dest, sigmaY, radiusY, 0, 1);
+}
+export const defaultGlBlurEffectRunner = (ctx, effect) => {
+    const descriptor = { width: ctx.source.width, height: ctx.source.height, format: ctx.source.format };
+    const temp = acquireGlRenderTarget(ctx.state, ctx.pool, descriptor);
+    applyBlurEffectToGl(ctx.state, ctx.source, ctx.dest, temp, effect);
+    releaseGlRenderTarget(ctx.pool, temp);
+};
+function applyGlGaussianBlurPass(state, source, dest, sigma, radius, dirX, dirY) {
+    const program = getGlEffectProgram(state, 'blur.gaussian', GAUSSIAN_BLUR_FRAGMENT_SRC);
+    drawGlFullscreenPass(state, program, [source.texture], dest, (gl, p) => {
+        gl.uniform2f(getGlEffectUniformLocation(state, p, 'u_texelSize'), 1 / source.width, 1 / source.height);
+        gl.uniform1f(getGlEffectUniformLocation(state, p, 'u_sigma'), sigma);
+        gl.uniform1f(getGlEffectUniformLocation(state, p, 'u_radius'), radius);
+        gl.uniform2f(getGlEffectUniformLocation(state, p, 'u_direction'), dirX, dirY);
+    });
+}
+const GAUSSIAN_BLUR_FRAGMENT_SRC = `#version 300 es
+precision mediump float;
+in vec2 v_texCoord;
+uniform sampler2D u_texture0;
+uniform vec2 u_texelSize;
+uniform float u_sigma;
+uniform float u_radius;
+uniform vec2 u_direction;
+out vec4 o_color;
+void main() {
+  int r = max(0, int(u_radius));
+  if (r == 0) {
+    o_color = texture(u_texture0, v_texCoord);
+    return;
+  }
+  float twoSigmaSq = 2.0 * u_sigma * u_sigma;
+  vec4 sum = vec4(0.0);
+  float weightSum = 0.0;
+  for (int i = -r; i <= r; i++) {
+    float w = exp(-float(i * i) / twoSigmaSq);
+    sum += w * texture(u_texture0, v_texCoord + float(i) * u_texelSize * u_direction);
+    weightSum += w;
+  }
+  o_color = sum / weightSum;
+}`;
+//# sourceMappingURL=glBlurEffect.js.map

package/dist/glBlurEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glBlurEffect.js","sourceRoot":"","sources":["../src/glBlurEffect.ts"],"names":[],"mappings":"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"}

package/dist/glColorLutPass.d.ts

@@ -0,0 +1,3 @@
+import type { ColorLut, GlColorLutTextureCache, GlRenderState, GlRenderTarget } from '@flighthq/types';
+export declare function applyColorLutPassToGl(state: GlRenderState, source: Readonly<GlRenderTarget>, dest: Readonly<GlRenderTarget>, lut: Readonly<ColorLut>, cache: GlColorLutTextureCache): void;
+//# sourceMappingURL=glColorLutPass.d.ts.map

package/dist/glColorLutPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glColorLutPass.d.ts","sourceRoot":"","sources":["../src/glColorLutPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAavG,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,EACvB,KAAK,EAAE,sBAAsB,GAC5B,IAAI,CAYN"}

package/dist/glColorLutPass.js

@@ -0,0 +1,75 @@
+import { drawGlFullscreenPass } from '@flighthq/render-gl';
+import { getGlEffectProgram } from './glEffectProgramCache';
+// Generic pointwise color-LUT pass — the single fold-in realization for the whole LUT-tier Adjustment
+// family on WebGL 2. A run of consecutive pointwise adjustments containing any nonlinear (LUT-tier)
+// member bakes to ONE 3D `ColorLut` (matrices folded in) and runs through this one trilinear pass instead
+// of one pass per op. The LUT is uploaded as a `size³` RGBA8 3D texture; hardware LINEAR filtering does
+// the trilinear interpolation. Sampled color is treated as premultiplied and passed straight into the
+// LUT (matching the per-op color passes this replaces); alpha is preserved. `cache` owns the uploaded 3D
+// texture across frames; the LUT is re-uploaded only when it differs by identity from the last one baked
+// into `cache` (bakeColorLutForRun returns a stable reference for an unchanged run), so a static grade
+// uploads once. The caller owns `cache.texture` and destroys it on teardown.
+export function applyColorLutPassToGl(state, source, dest, lut, cache) {
+    const gl = state.gl;
+    const size = lut.size;
+    const texture = uploadLutTexture(gl, lut, cache);
+    const program = getGlEffectProgram(state, 'adjustment.colorLut', COLOR_LUT_FRAGMENT_SRC);
+    drawGlFullscreenPass(state, program, [source.texture], dest, (glc, p) => {
+        glc.uniform1f(glc.getUniformLocation(p.program, 'u_lutSize'), size);
+        glc.activeTexture(glc.TEXTURE1);
+        glc.bindTexture(glc.TEXTURE_3D, texture);
+        glc.uniform1i(glc.getUniformLocation(p.program, 'u_lut'), 1);
+        glc.activeTexture(glc.TEXTURE0);
+    });
+}
+// Uploads `lut` into the cache's reusable 3D texture (RGBA8, LINEAR, clamp-to-edge) and returns it. The
+// upload is skipped entirely when `lut` is the same reference already baked into the texture — the common
+// static-grade case — so an unchanged grade costs one texImage3D total, not one per frame.
+function uploadLutTexture(gl, lut, cache) {
+    if (cache.texture !== null && cache.lut === lut)
+        return cache.texture;
+    const n = lut.size;
+    const samples = lut.samples;
+    const data = new Uint8Array(n * n * n * 4);
+    for (let i = 0, j = 0, o = 0; i < n * n * n; i++) {
+        data[o++] = Math.round(clamp01(samples[j++]) * 255);
+        data[o++] = Math.round(clamp01(samples[j++]) * 255);
+        data[o++] = Math.round(clamp01(samples[j++]) * 255);
+        data[o++] = 255;
+    }
+    let texture = cache.texture;
+    if (texture === null) {
+        texture = gl.createTexture();
+        cache.texture = texture;
+    }
+    gl.bindTexture(gl.TEXTURE_3D, texture);
+    gl.texImage3D(gl.TEXTURE_3D, 0, gl.RGBA8, n, n, n, 0, gl.RGBA, gl.UNSIGNED_BYTE, data);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_3D, gl.TEXTURE_WRAP_R, gl.CLAMP_TO_EDGE);
+    gl.bindTexture(gl.TEXTURE_3D, null);
+    cache.lut = lut;
+    return texture;
+}
+function clamp01(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+// Half-texel scale/offset maps the [0,1] color to LUT cell centres, so v=0 hits cell 0 and v=1 the last.
+const COLOR_LUT_FRAGMENT_SRC = `#version 300 es
+precision highp float;
+precision highp sampler3D;
+in vec2 v_texCoord;
+uniform sampler2D u_texture0;
+uniform sampler3D u_lut;
+uniform float u_lutSize;
+out vec4 o_color;
+void main() {
+  vec4 c = texture(u_texture0, v_texCoord);
+  float scale = (u_lutSize - 1.0) / u_lutSize;
+  float offset = 0.5 / u_lutSize;
+  vec3 lc = clamp(c.rgb, 0.0, 1.0) * scale + offset;
+  o_color = vec4(texture(u_lut, lc).rgb, c.a);
+}`;
+//# sourceMappingURL=glColorLutPass.js.map

package/dist/glColorLutPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glColorLutPass.js","sourceRoot":"","sources":["../src/glColorLutPass.ts"],"names":[],"mappings":"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"}

package/dist/glColorMatrixPass.d.ts

@@ -0,0 +1,3 @@
+import type { GlRenderState, GlRenderTarget } from '@flighthq/types';
+export declare function applyColorMatrixPassToGl(state: GlRenderState, source: Readonly<GlRenderTarget>, dest: Readonly<GlRenderTarget>, matrix: ReadonlyArray<number>): void;
+//# sourceMappingURL=glColorMatrixPass.d.ts.map

package/dist/glColorMatrixPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glColorMatrixPass.d.ts","sourceRoot":"","sources":["../src/glColorMatrixPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AASrE,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,IAAI,CAON"}

package/dist/glColorMatrixPass.js

@@ -0,0 +1,33 @@
+import { drawGlFullscreenPass } from '@flighthq/render-gl';
+import { getGlEffectProgram } from './glEffectProgramCache';
+// Generic pointwise color-matrix pass — the single fold-in realization for the whole matrix-tier
+// Adjustment family. A run of consecutive matrix-tier adjustments fuses to ONE 4×5 matrix (in the
+// adjustments colorMatrixMath convention: linear RGBA coefficients + a 0–255 offset column) and runs
+// through this one pass instead of one pass per op. Sampled color is treated as premultiplied and the
+// RGB result is clamped, matching the per-op color passes this replaces.
+export function applyColorMatrixPassToGl(state, source, dest, matrix) {
+    const m = new Float32Array(20);
+    for (let i = 0; i < 20; i++)
+        m[i] = matrix[i] ?? 0;
+    const program = getGlEffectProgram(state, 'adjustment.colorMatrix', COLOR_MATRIX_FRAGMENT_SRC);
+    drawGlFullscreenPass(state, program, [source.texture], dest, (gl, p) => {
+        gl.uniform1fv(gl.getUniformLocation(p.program, 'u_colorMatrix'), m);
+    });
+}
+// The offset column (indices 4, 9, 14, 19) is 0–255; normalized color needs it divided by 255.
+const COLOR_MATRIX_FRAGMENT_SRC = `#version 300 es
+precision highp float;
+in vec2 v_texCoord;
+uniform sampler2D u_texture0;
+uniform float u_colorMatrix[20];
+out vec4 o_color;
+void main() {
+  vec4 c = texture(u_texture0, v_texCoord);
+  float r = c.r, g = c.g, b = c.b, a = c.a;
+  float nr = u_colorMatrix[0] * r + u_colorMatrix[1] * g + u_colorMatrix[2] * b + u_colorMatrix[3] * a + u_colorMatrix[4] / 255.0;
+  float ng = u_colorMatrix[5] * r + u_colorMatrix[6] * g + u_colorMatrix[7] * b + u_colorMatrix[8] * a + u_colorMatrix[9] / 255.0;
+  float nb = u_colorMatrix[10] * r + u_colorMatrix[11] * g + u_colorMatrix[12] * b + u_colorMatrix[13] * a + u_colorMatrix[14] / 255.0;
+  float na = u_colorMatrix[15] * r + u_colorMatrix[16] * g + u_colorMatrix[17] * b + u_colorMatrix[18] * a + u_colorMatrix[19] / 255.0;
+  o_color = vec4(clamp(vec3(nr, ng, nb), 0.0, 1.0), na);
+}`;
+//# sourceMappingURL=glColorMatrixPass.js.map

package/dist/glColorMatrixPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glColorMatrixPass.js","sourceRoot":"","sources":["../src/glColorMatrixPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,iGAAiG;AACjG,kGAAkG;AAClG,qGAAqG;AACrG,sGAAsG;AACtG,yEAAyE;AACzE,MAAM,UAAU,wBAAwB,CACtC,KAAoB,EACpB,MAAgC,EAChC,IAA8B,EAC9B,MAA6B;IAE7B,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,CAAC,CAAC;IAC/F,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QACrE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;EAchC,CAAC"}