@flighthq/adjustments 0.1.0

package/dist/grayscaleAdjustment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grayscaleAdjustment.d.ts","sourceRoot":"","sources":["../src/grayscaleAdjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3D,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,aAAa,CAAC,CAAM,GACxE,mBAAmB,CAerB"}

package/dist/grayscaleAdjustment.js

@@ -0,0 +1,20 @@
+// Luma desaturation as a matrix-tier adjustment. `mix(rgb, vec3(luma), intensity)` with ITU-R BT.709
+// weights is a full affine 3×3 (no offset); alpha is unchanged. At intensity 1 every channel becomes
+// the luma. BT.709 (0.2126/0.7152/0.0722) matches the prior full-frame grayscale pass.
+export function createGrayscaleAdjustment(options = {}) {
+    const intensity = options.intensity ?? 1;
+    const k = intensity;
+    const j = 1 - intensity;
+    const lr = 0.2126 * k;
+    const lg = 0.7152 * k;
+    const lb = 0.0722 * k;
+    // prettier-ignore
+    const colorMatrix = [
+        j + lr, lg, lb, 0, 0,
+        lr, j + lg, lb, 0, 0,
+        lr, lg, j + lb, 0, 0,
+        0, 0, 0, 1, 0,
+    ];
+    return { kind: 'GrayscaleAdjustment', ...options, colorMatrix };
+}
+//# sourceMappingURL=grayscaleAdjustment.js.map

package/dist/grayscaleAdjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grayscaleAdjustment.js","sourceRoot":"","sources":["../src/grayscaleAdjustment.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,qGAAqG;AACrG,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CACvC,UAAuE,EAAE;IAEzE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,SAAS,CAAC;IACpB,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC;IACtB,kBAAkB;IAClB,MAAM,WAAW,GAAG;QAClB,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACpB,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACpB,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;QACpB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACd,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC;AAClE,CAAC"}

package/dist/hueSaturationAdjustment.d.ts

@@ -0,0 +1,3 @@
+import type { HueSaturationAdjustment } from '@flighthq/types';
+export declare function createHueSaturationAdjustment(options?: Readonly<Omit<HueSaturationAdjustment, 'kind' | 'transform'>>): HueSaturationAdjustment;
+//# sourceMappingURL=hueSaturationAdjustment.d.ts.map

package/dist/hueSaturationAdjustment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hueSaturationAdjustment.d.ts","sourceRoot":"","sources":["../src/hueSaturationAdjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAKvF,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,WAAW,CAAC,CAAM,GAC1E,uBAAuB,CAkCzB"}

package/dist/hueSaturationAdjustment.js

@@ -0,0 +1,62 @@
+// Hue/saturation/lightness as a LUT-tier adjustment. The transform is the exact HSL round-trip the old
+// hueSaturationEffect shader did — convert to HSL, rotate hue, scale saturation, offset lightness,
+// convert back — ported faithfully so the look is unchanged while the op now fuses into a baked LUT.
+export function createHueSaturationAdjustment(options = {}) {
+    const hue = (options.hue ?? 0) / 360;
+    const saturation = options.saturation ?? 1;
+    const lightness = options.lightness ?? 0;
+    const transform = (out, r, g, b) => {
+        const mx = Math.max(r, g, b);
+        const mn = Math.min(r, g, b);
+        let h = 0;
+        let s = 0;
+        const l = (mx + mn) * 0.5;
+        const d = mx - mn;
+        if (d > 0.0001) {
+            s = l < 0.5 ? d / (mx + mn) : d / (2 - mx - mn);
+            if (mx === r)
+                h = (g - b) / d + (g < b ? 6 : 0);
+            else if (mx === g)
+                h = (b - r) / d + 2;
+            else
+                h = (r - g) / d + 4;
+            h /= 6;
+        }
+        h = fract(h + hue);
+        s = clamp01(s * saturation);
+        const ln = clamp01(l + lightness);
+        if (s <= 0) {
+            out[0] = ln;
+            out[1] = ln;
+            out[2] = ln;
+            return;
+        }
+        const q = ln < 0.5 ? ln * (1 + s) : ln + s - ln * s;
+        const p = 2 * ln - q;
+        out[0] = hue2rgb(p, q, h + 1 / 3);
+        out[1] = hue2rgb(p, q, h);
+        out[2] = hue2rgb(p, q, h - 1 / 3);
+    };
+    return { kind: 'HueSaturationAdjustment', ...options, transform };
+}
+function clamp01(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+function fract(v) {
+    return v - Math.floor(v);
+}
+function hue2rgb(p, q, tRaw) {
+    let t = tRaw;
+    if (t < 0)
+        t += 1;
+    if (t > 1)
+        t -= 1;
+    if (t < 1 / 6)
+        return p + (q - p) * 6 * t;
+    if (t < 1 / 2)
+        return q;
+    if (t < 2 / 3)
+        return p + (q - p) * (2 / 3 - t) * 6;
+    return p;
+}
+//# sourceMappingURL=hueSaturationAdjustment.js.map

package/dist/hueSaturationAdjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hueSaturationAdjustment.js","sourceRoot":"","sources":["../src/hueSaturationAdjustment.ts"],"names":[],"mappings":"AAEA,uGAAuG;AACvG,mGAAmG;AACnG,qGAAqG;AACrG,MAAM,UAAU,6BAA6B,CAC3C,UAAyE,EAAE;IAE3E,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;IACrC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GAA2B,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACzD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;QAC1B,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;YACf,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YAChD,IAAI,EAAE,KAAK,CAAC;gBAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC3C,IAAI,EAAE,KAAK,CAAC;gBAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;gBAClC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;QACD,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACnB,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;QAC5B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACZ,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACZ,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrB,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,OAAO,CAAC,CAAS,EAAE,CAAS,EAAE,IAAY;IACjD,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,IAAI,CAAC,GAAG,CAAC;QAAE,CAAC,IAAI,CAAC,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC;QAAE,CAAC,IAAI,CAAC,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export * from './brightnessContrastAdjustment';
+export * from './channelMixerAdjustment';
+export * from './colorAdjustmentResolution';
+export * from './colorBlindSimulationAdjustment';
+export * from './colorGradeAdjustment';
+export * from './colorLut';
+export * from './colorLutAdjustment';
+export * from './colorLutCache';
+export * from './colorMatrixAdjustment';
+export * from './colorMatrixMath';
+export * from './colorTransformAdjustment';
+export * from './exposureAdjustment';
+export * from './grayscaleAdjustment';
+export * from './hueSaturationAdjustment';
+export * from './invertAdjustment';
+export * from './liftGammaGainAdjustment';
+export * from './lookupTableGradeAdjustment';
+export * from './sepiaAdjustment';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export * from './brightnessContrastAdjustment';
+export * from './channelMixerAdjustment';
+export * from './colorAdjustmentResolution';
+export * from './colorBlindSimulationAdjustment';
+export * from './colorGradeAdjustment';
+export * from './colorLut';
+export * from './colorLutAdjustment';
+export * from './colorLutCache';
+export * from './colorMatrixAdjustment';
+export * from './colorMatrixMath';
+export * from './colorTransformAdjustment';
+export * from './exposureAdjustment';
+export * from './grayscaleAdjustment';
+export * from './hueSaturationAdjustment';
+export * from './invertAdjustment';
+export * from './liftGammaGainAdjustment';
+export * from './lookupTableGradeAdjustment';
+export * from './sepiaAdjustment';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC"}

package/dist/invertAdjustment.d.ts

@@ -0,0 +1,3 @@
+import type { InvertAdjustment } from '@flighthq/types';
+export declare function createInvertAdjustment(options?: Readonly<Omit<InvertAdjustment, 'kind' | 'colorMatrix'>>): InvertAdjustment;
+//# sourceMappingURL=invertAdjustment.d.ts.map

package/dist/invertAdjustment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invertAdjustment.d.ts","sourceRoot":"","sources":["../src/invertAdjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,aAAa,CAAC,CAAM,GACrE,gBAAgB,CAYlB"}

package/dist/invertAdjustment.js

@@ -0,0 +1,17 @@
+// Channel invert as a matrix-tier adjustment. `mix(rgb, 1 - rgb, intensity)` is affine per channel —
+// scale `1 - 2·intensity`, offset `intensity` (255·intensity in the 0–255 offset convention). Alpha is
+// unchanged. At intensity 1 this is the classic invert (scale −1, offset 255).
+export function createInvertAdjustment(options = {}) {
+    const intensity = options.intensity ?? 1;
+    const s = 1 - 2 * intensity;
+    const o = 255 * intensity;
+    // prettier-ignore
+    const colorMatrix = [
+        s, 0, 0, 0, o,
+        0, s, 0, 0, o,
+        0, 0, s, 0, o,
+        0, 0, 0, 1, 0,
+    ];
+    return { kind: 'InvertAdjustment', ...options, colorMatrix };
+}
+//# sourceMappingURL=invertAdjustment.js.map

package/dist/invertAdjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invertAdjustment.js","sourceRoot":"","sources":["../src/invertAdjustment.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,uGAAuG;AACvG,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CACpC,UAAoE,EAAE;IAEtE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,GAAG,GAAG,GAAG,SAAS,CAAC;IAC1B,kBAAkB;IAClB,MAAM,WAAW,GAAG;QAClB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACb,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACb,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACb,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACd,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC;AAC/D,CAAC"}

package/dist/liftGammaGainAdjustment.d.ts

@@ -0,0 +1,3 @@
+import type { LiftGammaGainAdjustment } from '@flighthq/types';
+export declare function createLiftGammaGainAdjustment(options?: Readonly<Omit<LiftGammaGainAdjustment, 'kind' | 'transform'>>): LiftGammaGainAdjustment;
+//# sourceMappingURL=liftGammaGainAdjustment.d.ts.map

package/dist/liftGammaGainAdjustment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liftGammaGainAdjustment.d.ts","sourceRoot":"","sources":["../src/liftGammaGainAdjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAKvF,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,WAAW,CAAC,CAAM,GAC1E,uBAAuB,CAgBzB"}

package/dist/liftGammaGainAdjustment.js

@@ -0,0 +1,29 @@
+// Lift/gamma/gain as a LUT-tier adjustment (gamma is the nonlinear part). Ported faithfully from the old
+// liftGammaGainEffect shader: gain multiplies, lift offsets toward the packed neutral, gamma applies a
+// per-channel power curve. Packed-RGBA neutrals: lift 0x000000ff, gamma 0x808080ff, gain 0xffffffff.
+export function createLiftGammaGainAdjustment(options = {}) {
+    const lift = unpackRgb(options.lift ?? 0x000000ff);
+    const gammaRaw = unpackRgb(options.gamma ?? 0x808080ff);
+    const gain = unpackRgb(options.gain ?? 0xffffffff);
+    // Map gamma's 0.5-neutral to a 1.0-neutral exponent so 0x808080 leaves the image unchanged.
+    const gammaExp = [
+        1 / Math.max(gammaRaw[0] * 2, 1e-3),
+        1 / Math.max(gammaRaw[1] * 2, 1e-3),
+        1 / Math.max(gammaRaw[2] * 2, 1e-3),
+    ];
+    const transform = (out, r, g, b) => {
+        out[0] = clamp01(Math.pow(Math.max(r * gain[0] + lift[0] * (1 - r), 0), gammaExp[0]));
+        out[1] = clamp01(Math.pow(Math.max(g * gain[1] + lift[1] * (1 - g), 0), gammaExp[1]));
+        out[2] = clamp01(Math.pow(Math.max(b * gain[2] + lift[2] * (1 - b), 0), gammaExp[2]));
+    };
+    return { kind: 'LiftGammaGainAdjustment', ...options, transform };
+}
+function clamp01(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+// Unpacks a packed RGBA integer (0xRRGGBBAA) into normalized [r, g, b]. Alpha is dropped — grade values
+// describe RGB channels only.
+function unpackRgb(c) {
+    return [((c >>> 24) & 255) / 255, ((c >>> 16) & 255) / 255, ((c >>> 8) & 255) / 255];
+}
+//# sourceMappingURL=liftGammaGainAdjustment.js.map

package/dist/liftGammaGainAdjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liftGammaGainAdjustment.js","sourceRoot":"","sources":["../src/liftGammaGainAdjustment.ts"],"names":[],"mappings":"AAEA,yGAAyG;AACzG,uGAAuG;AACvG,qGAAqG;AACrG,MAAM,UAAU,6BAA6B,CAC3C,UAAyE,EAAE;IAE3E,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;IACnD,4FAA4F;IAC5F,MAAM,QAAQ,GAA6B;QACzC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;QACnC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;QACnC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;KACpC,CAAC;IACF,MAAM,SAAS,GAA2B,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACzD,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,wGAAwG;AACxG,8BAA8B;AAC9B,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;AACvF,CAAC"}

package/dist/lookupTableGradeAdjustment.d.ts

@@ -0,0 +1,3 @@
+import type { LookupTableGradeAdjustment } from '@flighthq/types';
+export declare function createLookupTableGradeAdjustment(options?: Readonly<Omit<LookupTableGradeAdjustment, 'kind' | 'transform'>>): LookupTableGradeAdjustment;
+//# sourceMappingURL=lookupTableGradeAdjustment.d.ts.map

package/dist/lookupTableGradeAdjustment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookupTableGradeAdjustment.d.ts","sourceRoot":"","sources":["../src/lookupTableGradeAdjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAS1F,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,QAAQ,CAAC,IAAI,CAAC,0BAA0B,EAAE,MAAM,GAAG,WAAW,CAAC,CAAM,GAC7E,0BAA0B,CAgB5B"}

package/dist/lookupTableGradeAdjustment.js

@@ -0,0 +1,24 @@
+import { sampleColorLut } from './colorLut';
+// A supplied 3D color grade LUT applied at `strength`. Unlike the other LUT-tier ops it is ALREADY a LUT,
+// so it carries one directly; its transform trilinearly samples the carried `lut` and mixes toward it by
+// `strength` (0 = original, 1 = full grade). With no `lut` supplied it is identity (a neutral
+// passthrough), matching the old lookupTableGradeEffect. Because it exposes a `transform`, it fuses with
+// neighbouring adjustments — a run containing it (matrices included) bakes into one LUT.
+export function createLookupTableGradeAdjustment(options = {}) {
+    const lut = options.lut;
+    const strength = options.strength ?? 1;
+    const transform = (out, r, g, b) => {
+        if (lut === undefined || strength <= 0) {
+            out[0] = r;
+            out[1] = g;
+            out[2] = b;
+            return;
+        }
+        sampleColorLut(lut, out, r, g, b);
+        out[0] = r + (out[0] - r) * strength;
+        out[1] = g + (out[1] - g) * strength;
+        out[2] = b + (out[2] - b) * strength;
+    };
+    return { kind: 'LookupTableGradeAdjustment', ...options, transform };
+}
+//# sourceMappingURL=lookupTableGradeAdjustment.js.map

package/dist/lookupTableGradeAdjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookupTableGradeAdjustment.js","sourceRoot":"","sources":["../src/lookupTableGradeAdjustment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,0GAA0G;AAC1G,yGAAyG;AACzG,8FAA8F;AAC9F,yGAAyG;AACzG,yFAAyF;AACzF,MAAM,UAAU,gCAAgC,CAC9C,UAA4E,EAAE;IAE9E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACvC,MAAM,SAAS,GAA2B,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QACzD,IAAI,GAAG,KAAK,SAAS,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACX,OAAO;QACT,CAAC;QACD,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QACrC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QACrC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;IACvC,CAAC,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC;AACvE,CAAC"}

package/dist/sepiaAdjustment.d.ts

@@ -0,0 +1,3 @@
+import type { SepiaAdjustment } from '@flighthq/types';
+export declare function createSepiaAdjustment(options?: Readonly<Omit<SepiaAdjustment, 'kind' | 'colorMatrix'>>): SepiaAdjustment;
+//# sourceMappingURL=sepiaAdjustment.d.ts.map

package/dist/sepiaAdjustment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sepiaAdjustment.d.ts","sourceRoot":"","sources":["../src/sepiaAdjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,CAAC,CAAM,GACpE,eAAe,CAWjB"}

package/dist/sepiaAdjustment.js

@@ -0,0 +1,15 @@
+// Sepia tone as a matrix-tier adjustment. `mix(rgb, sepia·rgb, intensity)` is affine 3×3 (no offset);
+// alpha is unchanged. At intensity 1 this is the standard sepia matrix used across CSS/Flash.
+export function createSepiaAdjustment(options = {}) {
+    const k = options.intensity ?? 1;
+    const j = 1 - k;
+    // prettier-ignore
+    const colorMatrix = [
+        j + 0.393 * k, 0.769 * k, 0.189 * k, 0, 0,
+        0.349 * k, j + 0.686 * k, 0.168 * k, 0, 0,
+        0.272 * k, 0.534 * k, j + 0.131 * k, 0, 0,
+        0, 0, 0, 1, 0,
+    ];
+    return { kind: 'SepiaAdjustment', ...options, colorMatrix };
+}
+//# sourceMappingURL=sepiaAdjustment.js.map

package/dist/sepiaAdjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sepiaAdjustment.js","sourceRoot":"","sources":["../src/sepiaAdjustment.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CACnC,UAAmE,EAAE;IAErE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,kBAAkB;IAClB,MAAM,WAAW,GAAG;QAClB,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzC,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACd,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC;AAC9D,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@flighthq/adjustments",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Pointwise value-remap adjustment descriptors and color-matrix fuse math",
+  "sideEffects": false
+}

package/src/brightnessContrastAdjustment.test.ts

@@ -0,0 +1,23 @@
+import { createBrightnessContrastAdjustment } from './brightnessContrastAdjustment';
+import { applyColorMatrixToColor } from './colorMatrixMath';
+
+describe('createBrightnessContrastAdjustment', () => {
+  it('defaults to the identity (brightness 0, contrast 1)', () => {
+    const adjustment = createBrightnessContrastAdjustment();
+    expect(adjustment.kind).toBe('BrightnessContrastAdjustment');
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0x3366aaff)).toBe(0x3366aaff);
+  });
+
+  it('scales contrast about mid-grey 0.5, leaving mid-grey fixed', () => {
+    const adjustment = createBrightnessContrastAdjustment({ contrast: 0.5 });
+    // 128 is the pivot → unchanged; black lifts toward mid-grey (255·0.5·0.5 = 63.75 → 64).
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0x808080ff)).toBe(0x808080ff);
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0x000000ff)).toBe(0x404040ff);
+  });
+
+  it('reproduces the prior shader (rgb + brightness − 0.5)·contrast + 0.5', () => {
+    // Scene values: brightness 0.15, contrast 0.35. White → (1 + 0.15 − 0.5)·0.35 + 0.5 = 0.7275 → 186.
+    const adjustment = createBrightnessContrastAdjustment({ brightness: 0.15, contrast: 0.35 });
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0xffffffff)).toBe(0xbababaff);
+  });
+});

package/src/channelMixerAdjustment.test.ts

@@ -0,0 +1,24 @@
+import { createChannelMixerAdjustment } from './channelMixerAdjustment';
+import { applyColorMatrixToColor } from './colorMatrixMath';
+
+describe('createChannelMixerAdjustment', () => {
+  it('rotates channels via a 3×4 row-major mix and carries the fusable kind', () => {
+    // R<-B, G<-R, B<-G — the same mix the functional scene uses.
+    const adjustment = createChannelMixerAdjustment({ matrix: [0, 0, 1, 0, 1, 0, 0, 0, 0, 1, 0, 0] });
+    expect(adjustment.kind).toBe('ChannelMixerAdjustment');
+    expect(adjustment.colorMatrix).toHaveLength(20);
+    // 0xAABBCC → R'=CC (from blue), G'=AA (from red), B'=BB (from green); alpha preserved.
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0xaabbccff)).toBe(0xccaabbff);
+  });
+
+  it('defaults to the identity mix', () => {
+    const adjustment = createChannelMixerAdjustment();
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0x123456ff)).toBe(0x123456ff);
+  });
+
+  it('applies the per-row offset in normalized 0–1, scaled to the 0–255 column', () => {
+    // Identity mix plus a full-white offset on every row → saturates to white.
+    const adjustment = createChannelMixerAdjustment({ matrix: [1, 0, 0, 1, 0, 1, 0, 1, 0, 0, 1, 1] });
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0x102030ff)).toBe(0xffffffff);
+  });
+});

package/src/colorAdjustmentResolution.test.ts

@@ -0,0 +1,77 @@
+import type { Adjustment, ColorTransform } from '@flighthq/types';
+
+import {
+  COLOR_ADJUSTMENT_AFFINE,
+  COLOR_ADJUSTMENT_CHANNEL_MIXING,
+  COLOR_ADJUSTMENT_NONE,
+  isAffineColorMatrix,
+  resolveColorAdjustmentsColorTransform,
+} from './colorAdjustmentResolution';
+import { createIdentityColorMatrix, createSaturationColorMatrix } from './colorMatrixMath';
+import { createColorTransformAdjustment } from './colorTransformAdjustment';
+
+function makeColorTransform(fields: Partial<ColorTransform> = {}): ColorTransform {
+  return {
+    redMultiplier: 1,
+    greenMultiplier: 1,
+    blueMultiplier: 1,
+    alphaMultiplier: 1,
+    redOffset: 0,
+    greenOffset: 0,
+    blueOffset: 0,
+    alphaOffset: 0,
+    ...fields,
+  } as ColorTransform;
+}
+
+describe('isAffineColorMatrix', () => {
+  it('is true for a diagonal identity matrix', () => {
+    expect(isAffineColorMatrix(createIdentityColorMatrix())).toBe(true);
+  });
+
+  it('is false when off-diagonal channel-mixing terms are present', () => {
+    expect(isAffineColorMatrix(createSaturationColorMatrix(0))).toBe(false);
+  });
+});
+
+describe('resolveColorAdjustmentsColorTransform', () => {
+  it('returns NONE for a null or empty stack', () => {
+    const out = makeColorTransform();
+    expect(resolveColorAdjustmentsColorTransform(null, out)).toBe(COLOR_ADJUSTMENT_NONE);
+    expect(resolveColorAdjustmentsColorTransform([], out)).toBe(COLOR_ADJUSTMENT_NONE);
+  });
+
+  it('resolves a single ColorTransformAdjustment exactly (affine)', () => {
+    const adjustment = createColorTransformAdjustment(
+      makeColorTransform({ redMultiplier: 0.5, greenMultiplier: 0, redOffset: 40 }),
+    );
+    const out = makeColorTransform();
+    expect(resolveColorAdjustmentsColorTransform([adjustment], out)).toBe(COLOR_ADJUSTMENT_AFFINE);
+    expect(out.redMultiplier).toBe(0.5);
+    expect(out.greenMultiplier).toBe(0);
+    expect(out.redOffset).toBe(40);
+    expect(out.alphaMultiplier).toBe(1);
+  });
+
+  it('fuses two affine adjustments (multipliers compose)', () => {
+    const a = createColorTransformAdjustment(makeColorTransform({ redMultiplier: 0.5 }));
+    const b = createColorTransformAdjustment(makeColorTransform({ redMultiplier: 0.5 }));
+    const out = makeColorTransform();
+    expect(resolveColorAdjustmentsColorTransform([a, b], out)).toBe(COLOR_ADJUSTMENT_AFFINE);
+    expect(out.redMultiplier).toBe(0.25);
+  });
+
+  it('reports channel-mixing and writes only the affine part for an off-diagonal stack', () => {
+    const saturation: Adjustment = { kind: 'Saturation', colorMatrix: createSaturationColorMatrix(0) } as Adjustment;
+    const out = makeColorTransform();
+    expect(resolveColorAdjustmentsColorTransform([saturation], out)).toBe(COLOR_ADJUSTMENT_CHANNEL_MIXING);
+    // Only the diagonal (grayscale luma weight for red) is written; off-diagonal mix is dropped.
+    expect(out.redMultiplier).toBeCloseTo(0.299);
+  });
+
+  it('reports channel-mixing when a non-matrix (LUT) op is present', () => {
+    const lut: Adjustment = { kind: 'acme.Lut' };
+    const out = makeColorTransform();
+    expect(resolveColorAdjustmentsColorTransform([lut], out)).toBe(COLOR_ADJUSTMENT_CHANNEL_MIXING);
+  });
+});

package/src/colorBlindSimulationAdjustment.test.ts

@@ -0,0 +1,27 @@
+import { createColorBlindSimulationAdjustment } from './colorBlindSimulationAdjustment';
+import { applyColorMatrixToColor } from './colorMatrixMath';
+
+describe('createColorBlindSimulationAdjustment', () => {
+  it('defaults to deuteranopia and bakes its linear matrix, preserving alpha', () => {
+    const adjustment = createColorBlindSimulationAdjustment();
+    expect(adjustment.kind).toBe('ColorBlindSimulationAdjustment');
+    expect(adjustment.colorMatrix).toHaveLength(20);
+    // Pure red under deuteranopia: R'=0.625·255≈159, G'=0.7·255≈179, B'=0; alpha preserved.
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0xff0000ff)).toBe(0x9fb300ff);
+  });
+
+  it('achromatopsia collapses to equal-channel luma (monochrome)', () => {
+    const adjustment = createColorBlindSimulationAdjustment({ type: 'achromatopsia' });
+    // Pure red → 0.299·255≈76 across all channels.
+    expect(applyColorMatrixToColor(adjustment.colorMatrix as number[], 0xff0000ff)).toBe(0x4c4c4cff);
+  });
+
+  it('selects a distinct matrix per type', () => {
+    const protan = createColorBlindSimulationAdjustment({ type: 'protanopia' });
+    const tritan = createColorBlindSimulationAdjustment({ type: 'tritanopia' });
+    const green = 0x00ff00ff;
+    expect(applyColorMatrixToColor(protan.colorMatrix as number[], green)).not.toBe(
+      applyColorMatrixToColor(tritan.colorMatrix as number[], green),
+    );
+  });
+});

package/src/colorGradeAdjustment.test.ts

@@ -0,0 +1,36 @@
+import { createColorGradeAdjustment } from './colorGradeAdjustment';
+
+describe('createColorGradeAdjustment', () => {
+  it('defaults to approximately neutral (contrast 1, all stages near-neutral)', () => {
+    // The lift/gamma/gain stage's packed neutral 0x808080 gamma is 128/255 ≈ 0.502, so the default is
+    // near- (not exactly) neutral — faithful to the ported shader.
+    const adjustment = createColorGradeAdjustment();
+    expect(adjustment.kind).toBe('ColorGradeAdjustment');
+    const out: [number, number, number] = [0, 0, 0];
+    adjustment.transform(out, 0.3, 0.5, 0.7);
+    expect(out[0]).toBeCloseTo(0.3, 2);
+    expect(out[1]).toBeCloseTo(0.5, 2);
+    expect(out[2]).toBeCloseTo(0.7, 2);
+  });
+
+  it('scales contrast about mid-grey', () => {
+    const adjustment = createColorGradeAdjustment({ contrast: 2 });
+    const out: [number, number, number] = [0, 0, 0];
+    adjustment.transform(out, 0.5, 0.5, 0.5);
+    // Mid-grey is the pivot → unchanged (within the near-neutral default gamma).
+    expect(out[0]).toBeCloseTo(0.5, 2);
+    adjustment.transform(out, 0.75, 0.75, 0.75);
+    // (0.75 - 0.5)·2 + 0.5 = 1, and pow(1, gamma) = 1 exactly.
+    expect(out[0]).toBeCloseTo(1, 4);
+  });
+
+  it('desaturates toward luma at saturation 0', () => {
+    const adjustment = createColorGradeAdjustment({ saturation: 0 });
+    const out: [number, number, number] = [0, 0, 0];
+    adjustment.transform(out, 1, 0, 0);
+    // Rec.709 luma of pure red is 0.2126 on every channel (within the near-neutral default gamma).
+    expect(out[0]).toBeCloseTo(0.2126, 2);
+    expect(out[1]).toBeCloseTo(0.2126, 2);
+    expect(out[2]).toBeCloseTo(0.2126, 2);
+  });
+});

package/src/colorLut.test.ts

@@ -0,0 +1,62 @@
+import type { ColorTransformFunction } from '@flighthq/types';
+
+import { bakeColorLut, COLOR_LUT_DEFAULT_SIZE, sampleColorLut } from './colorLut';
+
+describe('bakeColorLut', () => {
+  it('bakes an empty stack into an identity LUT', () => {
+    const lut = bakeColorLut([], 8);
+    expect(lut.size).toBe(8);
+    expect(lut.samples).toHaveLength(8 * 8 * 8 * 3);
+    const out: [number, number, number] = [0, 0, 0];
+    sampleColorLut(lut, out, 0.25, 0.5, 0.75);
+    expect(out[0]).toBeCloseTo(0.25, 5);
+    expect(out[1]).toBeCloseTo(0.5, 5);
+    expect(out[2]).toBeCloseTo(0.75, 5);
+  });
+
+  it('composes transforms left-to-right and clamps to [0, 1]', () => {
+    const invert: ColorTransformFunction = (out, r, g, b) => {
+      out[0] = 1 - r;
+      out[1] = 1 - g;
+      out[2] = 1 - b;
+    };
+    const brighten: ColorTransformFunction = (out, r, g, b) => {
+      out[0] = r + 0.5;
+      out[1] = g + 0.5;
+      out[2] = b + 0.5;
+    };
+    const lut = bakeColorLut([invert, brighten], 16);
+    const out: [number, number, number] = [0, 0, 0];
+    // invert(0.2)=0.8, +0.5 = 1.3 → clamped to 1.
+    sampleColorLut(lut, out, 0.2, 0.2, 0.2);
+    expect(out[0]).toBeCloseTo(1, 5);
+  });
+
+  it('defaults to the standard resolution', () => {
+    const lut = bakeColorLut([]);
+    expect(lut.size).toBe(COLOR_LUT_DEFAULT_SIZE);
+  });
+});
+
+describe('sampleColorLut', () => {
+  it('interpolates between cells trilinearly', () => {
+    const ramp: ColorTransformFunction = (out, r) => {
+      out[0] = r;
+      out[1] = r;
+      out[2] = r;
+    };
+    const lut = bakeColorLut([ramp], 2);
+    const out: [number, number, number] = [0, 0, 0];
+    sampleColorLut(lut, out, 0.5, 0, 0);
+    expect(out[0]).toBeCloseTo(0.5, 5);
+  });
+
+  it('clamps out-of-range inputs to the cube', () => {
+    const lut = bakeColorLut([], 4);
+    const out: [number, number, number] = [0, 0, 0];
+    sampleColorLut(lut, out, 2, -1, 0.5);
+    expect(out[0]).toBeCloseTo(1, 5);
+    expect(out[1]).toBeCloseTo(0, 5);
+    expect(out[2]).toBeCloseTo(0.5, 5);
+  });
+});

package/src/colorLutAdjustment.test.ts

@@ -0,0 +1,37 @@
+import { getAdjustmentColorTransform, isColorLutAdjustment } from './colorLutAdjustment';
+import { createHueSaturationAdjustment } from './hueSaturationAdjustment';
+import { createInvertAdjustment } from './invertAdjustment';
+
+describe('getAdjustmentColorTransform', () => {
+  it('returns a LUT-tier adjustment its own transform', () => {
+    const op = createHueSaturationAdjustment({ hue: 45 });
+    expect(getAdjustmentColorTransform(op)).toBe(op.transform);
+  });
+
+  it('wraps a matrix-tier adjustment as an rgb→rgb transform at opaque alpha', () => {
+    const op = createInvertAdjustment();
+    const fn = getAdjustmentColorTransform(op);
+    expect(fn).not.toBeNull();
+    const out: [number, number, number] = [0, 0, 0];
+    fn!(out, 1, 0, 0);
+    // Full invert: red → cyan.
+    expect(out[0]).toBeCloseTo(0, 5);
+    expect(out[1]).toBeCloseTo(1, 5);
+    expect(out[2]).toBeCloseTo(1, 5);
+  });
+
+  it('returns null for a non-pointwise operation', () => {
+    expect(getAdjustmentColorTransform({ kind: 'BlurEffect' })).toBeNull();
+  });
+});
+
+describe('isColorLutAdjustment', () => {
+  it('is true for a LUT-tier adjustment', () => {
+    expect(isColorLutAdjustment(createHueSaturationAdjustment())).toBe(true);
+  });
+
+  it('is false for a matrix-tier adjustment and for a plain effect', () => {
+    expect(isColorLutAdjustment(createInvertAdjustment())).toBe(false);
+    expect(isColorLutAdjustment({ kind: 'BlurEffect' })).toBe(false);
+  });
+});