@flighthq/effects 0.2.0 → 0.2.1-next.410.a23f189

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/effects",
-  "version": "0.2.0",
+  "version": "0.2.1-next.410.a23f189",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -32,7 +32,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.2.0"
+    "@flighthq/types": "0.2.1-next.410.a23f189"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/bevelEffect.test.ts

@@ -6,6 +6,9 @@ describe('createBevelEffect', () => {
   });
 
   it('carries options', () => {
-    expect(createBevelEffect({ strength: 2 })).toMatchObject({ strength: 2 });
+    expect(createBevelEffect({ sourceMode: 'knockout', strength: 2 })).toMatchObject({
+      sourceMode: 'knockout',
+      strength: 2,
+    });
   });
 });

package/src/blendEffect.test.ts

@@ -0,0 +1,23 @@
+import { AdvancedBlendMode } from '@flighthq/types';
+
+import { createBlendEffect } from './blendEffect';
+
+describe('createBlendEffect', () => {
+  it('builds a BlendEffect carrying the requested mode', () => {
+    const effect = createBlendEffect(AdvancedBlendMode.Overlay);
+    expect(effect.kind).toBe('BlendEffect');
+    expect(effect.mode).toBe('Overlay');
+  });
+
+  it('spreads backdropKey and opacity options', () => {
+    const effect = createBlendEffect(AdvancedBlendMode.SoftLight, { backdropKey: 'scene.backdrop', opacity: 0.5 });
+    expect(effect.backdropKey).toBe('scene.backdrop');
+    expect(effect.opacity).toBe(0.5);
+  });
+
+  it('leaves backdropKey and opacity undefined when omitted', () => {
+    const effect = createBlendEffect(AdvancedBlendMode.Hue);
+    expect(effect.backdropKey).toBeUndefined();
+    expect(effect.opacity).toBeUndefined();
+  });
+});

package/src/blendModeMath.test.ts

@@ -0,0 +1,160 @@
+import { AdvancedBlendMode } from '@flighthq/types';
+
+import {
+  blendNonSeparableRgb,
+  getAdvancedBlendRgb,
+  getSeparableBlendChannel,
+  isNonSeparableBlendMode,
+} from './blendModeMath';
+
+const LUM = (r: number, g: number, b: number): number => 0.3 * r + 0.59 * g + 0.11 * b;
+const SAT = (r: number, g: number, b: number): number => Math.max(r, g, b) - Math.min(r, g, b);
+
+describe('blendNonSeparableRgb', () => {
+  it('Luminosity replaces backdrop luma with source luma, preserving backdrop hue/sat', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    const cb: [number, number, number] = [0.8, 0.2, 0.4];
+    const cs: [number, number, number] = [0.5, 0.5, 0.5];
+    blendNonSeparableRgb(AdvancedBlendMode.Luminosity, cb[0], cb[1], cb[2], cs[0], cs[1], cs[2], out);
+    // Result luma equals the source's luma.
+    expect(LUM(out[0], out[1], out[2])).toBeCloseTo(LUM(cs[0], cs[1], cs[2]), 5);
+    // Backdrop saturation is preserved (chroma range unchanged) since no channel clipped.
+    expect(SAT(out[0], out[1], out[2])).toBeCloseTo(SAT(cb[0], cb[1], cb[2]), 5);
+  });
+
+  it('Color takes source hue+sat with backdrop luma', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    const cb: [number, number, number] = [0.2, 0.2, 0.2]; // gray backdrop, luma 0.2
+    const cs: [number, number, number] = [0.9, 0.1, 0.1];
+    blendNonSeparableRgb(AdvancedBlendMode.Color, cb[0], cb[1], cb[2], cs[0], cs[1], cs[2], out);
+    expect(LUM(out[0], out[1], out[2])).toBeCloseTo(LUM(cb[0], cb[1], cb[2]), 5);
+  });
+
+  it('Hue takes source hue, backdrop sat and luma', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    const cb: [number, number, number] = [0.4, 0.5, 0.6];
+    const cs: [number, number, number] = [0.9, 0.2, 0.2];
+    blendNonSeparableRgb(AdvancedBlendMode.Hue, cb[0], cb[1], cb[2], cs[0], cs[1], cs[2], out);
+    expect(LUM(out[0], out[1], out[2])).toBeCloseTo(LUM(cb[0], cb[1], cb[2]), 5);
+    expect(SAT(out[0], out[1], out[2])).toBeCloseTo(SAT(cb[0], cb[1], cb[2]), 5);
+  });
+
+  it('Saturation takes source sat, backdrop hue and luma', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    const cb: [number, number, number] = [0.4, 0.5, 0.6];
+    const cs: [number, number, number] = [0.9, 0.2, 0.2]; // sat 0.7
+    blendNonSeparableRgb(AdvancedBlendMode.Saturation, cb[0], cb[1], cb[2], cs[0], cs[1], cs[2], out);
+    expect(SAT(out[0], out[1], out[2])).toBeCloseTo(SAT(cs[0], cs[1], cs[2]), 5);
+    expect(LUM(out[0], out[1], out[2])).toBeCloseTo(LUM(cb[0], cb[1], cb[2]), 5);
+  });
+
+  it('keeps every channel in 0..1 after gamut clipping', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    blendNonSeparableRgb(AdvancedBlendMode.Color, 0.95, 0.95, 0.95, 1, 0, 0, out);
+    for (const c of out) {
+      expect(c).toBeGreaterThanOrEqual(0);
+      expect(c).toBeLessThanOrEqual(1);
+    }
+  });
+
+  it('falls through to the source triple for an unknown mode', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    blendNonSeparableRgb('acme.Nope', 0.1, 0.2, 0.3, 0.7, 0.8, 0.9, out);
+    expect(out).toEqual([0.7, 0.8, 0.9]);
+  });
+});
+
+describe('getAdvancedBlendRgb', () => {
+  it('falls through to the source triple for a non-advanced mode', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    // A fixed-function mode name is not an AdvancedBlendMode, so it takes the separable Normal path.
+    getAdvancedBlendRgb('Multiply', 0.5, 0.5, 0.5, 0.2, 0.3, 0.4, out);
+    expect(out).toEqual([0.2, 0.3, 0.4]);
+  });
+
+  it('computes Difference per channel', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    getAdvancedBlendRgb(AdvancedBlendMode.Difference, 0.8, 0.5, 0.2, 0.3, 0.5, 0.9, out);
+    expect(out[0]).toBeCloseTo(0.5, 5);
+    expect(out[1]).toBeCloseTo(0, 5);
+    expect(out[2]).toBeCloseTo(0.7, 5);
+  });
+
+  it('routes HSL modes through the non-separable path', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    getAdvancedBlendRgb(AdvancedBlendMode.Luminosity, 0.8, 0.2, 0.4, 0.5, 0.5, 0.5, out);
+    expect(LUM(out[0], out[1], out[2])).toBeCloseTo(0.5, 5);
+  });
+});
+
+describe('getSeparableBlendChannel', () => {
+  it('Overlay equals HardLight with operands swapped', () => {
+    const cb = 0.6;
+    const cs = 0.3;
+    expect(getSeparableBlendChannel(AdvancedBlendMode.Overlay, cb, cs)).toBeCloseTo(
+      getSeparableBlendChannel(AdvancedBlendMode.HardLight, cs, cb),
+      6,
+    );
+  });
+
+  it('Difference is the absolute channel distance', () => {
+    expect(getSeparableBlendChannel(AdvancedBlendMode.Difference, 0.8, 0.3)).toBeCloseTo(0.5, 6);
+  });
+
+  it('Exclusion(x, 0.5) collapses to 0.5 regardless of backdrop', () => {
+    expect(getSeparableBlendChannel(AdvancedBlendMode.Exclusion, 0.2, 0.5)).toBeCloseTo(0.5, 6);
+    expect(getSeparableBlendChannel(AdvancedBlendMode.Exclusion, 0.9, 0.5)).toBeCloseTo(0.5, 6);
+  });
+
+  it('ColorDodge clamps to white when source is 1 and stays 0 for a black backdrop', () => {
+    expect(getSeparableBlendChannel(AdvancedBlendMode.ColorDodge, 0.4, 1)).toBe(1);
+    expect(getSeparableBlendChannel(AdvancedBlendMode.ColorDodge, 0, 0.5)).toBe(0);
+    expect(getSeparableBlendChannel(AdvancedBlendMode.ColorDodge, 0.25, 0.5)).toBeCloseTo(0.5, 6);
+  });
+
+  it('ColorBurn clamps to black when source is 0 and stays 1 for a white backdrop', () => {
+    expect(getSeparableBlendChannel(AdvancedBlendMode.ColorBurn, 0.6, 0)).toBe(0);
+    expect(getSeparableBlendChannel(AdvancedBlendMode.ColorBurn, 1, 0.5)).toBe(1);
+    expect(getSeparableBlendChannel(AdvancedBlendMode.ColorBurn, 0.75, 0.5)).toBeCloseTo(0.5, 6);
+  });
+
+  it('SoftLight leaves the backdrop unchanged for a mid-gray source', () => {
+    expect(getSeparableBlendChannel(AdvancedBlendMode.SoftLight, 0.6, 0.5)).toBeCloseTo(0.6, 6);
+  });
+
+  it('HardLight over a 0.5 source is a straight overlay of the backdrop', () => {
+    // cs = 0.5 sits on the branch boundary; both branches agree there.
+    expect(getSeparableBlendChannel(AdvancedBlendMode.HardLight, 0.4, 0.5)).toBeCloseTo(0.4, 6);
+  });
+
+  it('returns the source channel (Normal) for an unknown mode', () => {
+    expect(getSeparableBlendChannel('acme.Nope', 0.2, 0.7)).toBe(0.7);
+  });
+});
+
+describe('isNonSeparableBlendMode', () => {
+  it('is true only for the four HSL modes', () => {
+    for (const mode of [
+      AdvancedBlendMode.Hue,
+      AdvancedBlendMode.Saturation,
+      AdvancedBlendMode.Color,
+      AdvancedBlendMode.Luminosity,
+    ]) {
+      expect(isNonSeparableBlendMode(mode)).toBe(true);
+    }
+  });
+
+  it('is false for the separable modes', () => {
+    for (const mode of [
+      AdvancedBlendMode.Overlay,
+      AdvancedBlendMode.HardLight,
+      AdvancedBlendMode.SoftLight,
+      AdvancedBlendMode.Difference,
+      AdvancedBlendMode.Exclusion,
+      AdvancedBlendMode.ColorDodge,
+      AdvancedBlendMode.ColorBurn,
+    ]) {
+      expect(isNonSeparableBlendMode(mode)).toBe(false);
+    }
+  });
+});

package/src/compositeEffect.test.ts

@@ -0,0 +1,21 @@
+import { CompositeOperator } from '@flighthq/types';
+
+import { createCompositeEffect } from './compositeEffect';
+
+describe('createCompositeEffect', () => {
+  it('builds a CompositeEffect carrying the requested operator', () => {
+    const effect = createCompositeEffect(CompositeOperator.DestinationOut);
+    expect(effect.kind).toBe('CompositeEffect');
+    expect(effect.operator).toBe('DestinationOut');
+  });
+
+  it('spreads the backdropKey option', () => {
+    const effect = createCompositeEffect(CompositeOperator.DestinationIn, { backdropKey: 'scene.backdrop' });
+    expect(effect.backdropKey).toBe('scene.backdrop');
+  });
+
+  it('leaves backdropKey undefined when omitted', () => {
+    const effect = createCompositeEffect(CompositeOperator.Xor);
+    expect(effect.backdropKey).toBeUndefined();
+  });
+});

package/src/compositeOperatorMath.test.ts

@@ -0,0 +1,45 @@
+import { CompositeOperator } from '@flighthq/types';
+
+import { getCompositeOperatorFactors } from './compositeOperatorMath';
+
+function factors(operator: CompositeOperator, as: number, ab: number): [number, number] {
+  const out: [number, number] = [0, 0];
+  getCompositeOperatorFactors(operator, as, ab, out);
+  return out;
+}
+
+describe('getCompositeOperatorFactors', () => {
+  it('gives source-over its canonical [1, 1 - as]', () => {
+    expect(factors(CompositeOperator.SourceOver, 0.6, 0.4)).toEqual([1, 1 - 0.6]);
+  });
+
+  it('erases (DestinationOut) by keeping only the backdrop scaled by 1 - as', () => {
+    expect(factors(CompositeOperator.DestinationOut, 0.75, 1)).toEqual([0, 1 - 0.75]);
+  });
+
+  it('masks (DestinationIn) by keeping only the backdrop scaled by as', () => {
+    expect(factors(CompositeOperator.DestinationIn, 0.75, 1)).toEqual([0, 0.75]);
+  });
+
+  it('copies the source and drops the backdrop', () => {
+    expect(factors(CompositeOperator.Copy, 0.3, 0.9)).toEqual([1, 0]);
+  });
+
+  it('clears both contributions', () => {
+    expect(factors(CompositeOperator.Clear, 0.3, 0.9)).toEqual([0, 0]);
+  });
+
+  it('xors to the mutually-uncovered regions', () => {
+    expect(factors(CompositeOperator.Xor, 0.5, 0.25)).toEqual([1 - 0.25, 1 - 0.5]);
+  });
+
+  it('falls through to source-over for an unknown (vendor) operator', () => {
+    expect(factors('acme.custom', 0.6, 0.4)).toEqual([1, 1 - 0.6]);
+  });
+
+  it('is alias-safe writing into a supplied out array', () => {
+    const out: [number, number] = [9, 9];
+    getCompositeOperatorFactors(CompositeOperator.DestinationOver, 0.2, 0.8, out);
+    expect(out).toEqual([1 - 0.8, 1]);
+  });
+});

package/src/dropShadowEffect.test.ts

@@ -6,6 +6,9 @@ describe('createDropShadowEffect', () => {
   });
 
   it('carries options', () => {
-    expect(createDropShadowEffect({ strength: 2 })).toMatchObject({ strength: 2 });
+    expect(createDropShadowEffect({ sourceMode: 'knockout', strength: 2 })).toMatchObject({
+      sourceMode: 'knockout',
+      strength: 2,
+    });
   });
 });

package/src/gradientBevelEffect.test.ts

@@ -9,7 +9,13 @@ describe('createGradientBevelEffect', () => {
 
   it('carries options', () => {
     expect(
-      createGradientBevelEffect({ colors: [0xff0000, 0x00ff00], alphas: [1, 1], ratios: [0, 255], strength: 2 }),
-    ).toMatchObject({ strength: 2 });
+      createGradientBevelEffect({
+        colors: [0xff0000, 0x00ff00],
+        alphas: [1, 1],
+        ratios: [0, 255],
+        sourceMode: 'hide',
+        strength: 2,
+      }),
+    ).toMatchObject({ sourceMode: 'hide', strength: 2 });
   });
 });

package/src/gradientGlowEffect.test.ts

@@ -9,7 +9,13 @@ describe('createGradientGlowEffect', () => {
 
   it('carries options', () => {
     expect(
-      createGradientGlowEffect({ colors: [0xff0000, 0x00ff00], alphas: [1, 1], ratios: [0, 255], strength: 2 }),
-    ).toMatchObject({ strength: 2 });
+      createGradientGlowEffect({
+        colors: [0xff0000, 0x00ff00],
+        alphas: [1, 1],
+        ratios: [0, 255],
+        sourceMode: 'knockout',
+        strength: 2,
+      }),
+    ).toMatchObject({ sourceMode: 'knockout', strength: 2 });
   });
 });

package/src/innerGlowEffect.test.ts

@@ -8,4 +8,8 @@ describe('createInnerGlowEffect', () => {
   it('carries options', () => {
     expect(createInnerGlowEffect({ strength: 2 })).toMatchObject({ strength: 2 });
   });
+
+  it('carries source mode', () => {
+    expect(createInnerGlowEffect({ sourceMode: 'hide' })).toMatchObject({ sourceMode: 'hide' });
+  });
 });

package/src/innerShadowEffect.test.ts

@@ -8,4 +8,8 @@ describe('createInnerShadowEffect', () => {
   it('carries options', () => {
     expect(createInnerShadowEffect({ strength: 2 })).toMatchObject({ strength: 2 });
   });
+
+  it('carries source mode', () => {
+    expect(createInnerShadowEffect({ sourceMode: 'hide' })).toMatchObject({ sourceMode: 'hide' });
+  });
 });

package/src/outerGlowEffect.test.ts

@@ -6,6 +6,9 @@ describe('createOuterGlowEffect', () => {
   });
 
   it('carries options', () => {
-    expect(createOuterGlowEffect({ strength: 2 })).toMatchObject({ strength: 2 });
+    expect(createOuterGlowEffect({ sourceMode: 'hide', strength: 2 })).toMatchObject({
+      sourceMode: 'hide',
+      strength: 2,
+    });
   });
 });

package/src/renderEffectDefaults.test.ts

@@ -19,6 +19,15 @@ describe('getRenderEffectDefaults', () => {
     expect(d.operator).toBe('aces');
     expect(d.exposure).toBe(0);
   });
+  it('returns sourceMode draw for composite source-mode effects', () => {
+    expect(getRenderEffectDefaults('DropShadowEffect').sourceMode).toBe('draw');
+    expect(getRenderEffectDefaults('OuterGlowEffect').sourceMode).toBe('draw');
+    expect(getRenderEffectDefaults('InnerGlowEffect').sourceMode).toBe('draw');
+    expect(getRenderEffectDefaults('InnerShadowEffect').sourceMode).toBe('draw');
+    expect(getRenderEffectDefaults('BevelEffect').sourceMode).toBe('draw');
+    expect(getRenderEffectDefaults('GradientGlowEffect').sourceMode).toBe('draw');
+    expect(getRenderEffectDefaults('GradientBevelEffect').sourceMode).toBe('draw');
+  });
   it('returns a fresh copy each call (mutations do not persist)', () => {
     const d1 = getRenderEffectDefaults('BloomEffect');
     const d2 = getRenderEffectDefaults('BloomEffect');

package/dist/colorScienceMath.d.ts

@@ -1,9 +0,0 @@
-export declare function computeHslToRgb(h: number, s: number, l: number, out: [number, number, number]): void;
-export declare function computeLinearToSrgb(x: number): number;
-export declare function computeOklabToRgb(L: number, a: number, b: number, out: [number, number, number]): void;
-export declare function computeRgbToHsl(r: number, g: number, b: number, out: [number, number, number]): void;
-export declare function computeRgbToOklab(r: number, g: number, b: number, out: [number, number, number]): void;
-export declare function computeSrgbToLinear(x: number): number;
-export declare function getRec2020LuminanceWeights(out: [number, number, number]): void;
-export declare function getRec709LuminanceWeights(out: [number, number, number]): void;
-//# sourceMappingURL=colorScienceMath.d.ts.map

package/dist/colorScienceMath.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"colorScienceMath.d.ts","sourceRoot":"","sources":["../src/colorScienceMath.ts"],"names":[],"mappings":"AAMA,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAoCpG;AAID,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAGD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAatG;AAID,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAwBpG;AAKD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAatG;AAID,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAID,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAI9E;AAID,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAI7E"}

package/dist/colorScienceMath.js

@@ -1,135 +0,0 @@
-// Color-science recipe math. Complete working-space functions for HDR rendering, color grading,
-// and perceptual operations. All functions are alias-safe and zero-allocation (out-param pattern).
-// These are the substrate-agnostic primitives shared across all backends.
-// Converts HSL [h∈[0..360), s∈[0..1], l∈[0..1]] to sRGB [0..1]. Writes into `out`.
-// Alias-safe.
-export function computeHslToRgb(h, s, l, out) {
-    const c = (1 - Math.abs(2 * l - 1)) * s;
-    const hh = (((h % 360) + 360) % 360) / 60;
-    const x = c * (1 - Math.abs((hh % 2) - 1));
-    let r1;
-    let g1;
-    let b1;
-    if (hh < 1) {
-        r1 = c;
-        g1 = x;
-        b1 = 0;
-    }
-    else if (hh < 2) {
-        r1 = x;
-        g1 = c;
-        b1 = 0;
-    }
-    else if (hh < 3) {
-        r1 = 0;
-        g1 = c;
-        b1 = x;
-    }
-    else if (hh < 4) {
-        r1 = 0;
-        g1 = x;
-        b1 = c;
-    }
-    else if (hh < 5) {
-        r1 = x;
-        g1 = 0;
-        b1 = c;
-    }
-    else {
-        r1 = c;
-        g1 = 0;
-        b1 = x;
-    }
-    const m = l - c / 2;
-    out[0] = r1 + m;
-    out[1] = g1 + m;
-    out[2] = b1 + m;
-}
-// sRGB transfer function: converts a single linear-light channel value to gamma-encoded sRGB.
-// The piecewise IEC 61966-2-1 formula. Input in [0..∞], output in [0..1].
-export function computeLinearToSrgb(x) {
-    const v = Math.max(0, x);
-    return v <= 0.0031308 ? 12.92 * v : 1.055 * Math.pow(v, 1 / 2.4) - 0.055;
-}
-// Converts Oklab back to linear sRGB [0..1]. Alias-safe.
-export function computeOklabToRgb(L, a, b, out) {
-    // Oklab → LMS.
-    const lc = L + 0.3963377774 * a + 0.2158037573 * b;
-    const mc = L - 0.1055613458 * a - 0.0638541728 * b;
-    const sc = L - 0.0894841775 * a - 1.291485548 * b;
-    // Cube.
-    const l = lc * lc * lc;
-    const m = mc * mc * mc;
-    const s = sc * sc * sc;
-    // LMS → linear sRGB.
-    out[0] = Math.max(0, 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s);
-    out[1] = Math.max(0, -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s);
-    out[2] = Math.max(0, -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s);
-}
-// Converts sRGB [0..1] to HSL [h∈[0..360), s∈[0..1], l∈[0..1]]. Writes into `out`.
-// Alias-safe: reads all inputs before writing.
-export function computeRgbToHsl(r, g, b, out) {
-    const rc = Math.max(0, Math.min(1, r));
-    const gc = Math.max(0, Math.min(1, g));
-    const bc = Math.max(0, Math.min(1, b));
-    const max = Math.max(rc, gc, bc);
-    const min = Math.min(rc, gc, bc);
-    const d = max - min;
-    const l = (max + min) / 2;
-    let h = 0;
-    let s = 0;
-    if (d > 1e-10) {
-        s = d / (1 - Math.abs(2 * l - 1));
-        if (max === rc) {
-            h = ((gc - bc) / d + 6) % 6;
-        }
-        else if (max === gc) {
-            h = (bc - rc) / d + 2;
-        }
-        else {
-            h = (rc - gc) / d + 4;
-        }
-        h *= 60;
-    }
-    out[0] = h;
-    out[1] = s;
-    out[2] = l;
-}
-// Converts linear sRGB [0..1] to Oklab [L∈[0..1], a∈~[-0.5..0.5], b∈~[-0.5..0.5]].
-// Oklab is a perceptually uniform space; changes in L, a, b produce visually equal steps.
-// Reference: Ottosson 2020. Alias-safe.
-export function computeRgbToOklab(r, g, b, out) {
-    // sRGB (linear) → LMS via a 3×3 matrix.
-    const l = 0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b;
-    const m = 0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b;
-    const s = 0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b;
-    // Cube-root compress.
-    const lc = Math.cbrt(Math.max(0, l));
-    const mc = Math.cbrt(Math.max(0, m));
-    const sc = Math.cbrt(Math.max(0, s));
-    // LMS → Oklab.
-    out[0] = 0.2104542553 * lc + 0.793617785 * mc - 0.0040720468 * sc;
-    out[1] = 1.9779984951 * lc - 2.428592205 * mc + 0.4505937099 * sc;
-    out[2] = 0.0259040371 * lc + 0.7827717662 * mc - 0.808675766 * sc;
-}
-// sRGB transfer function: converts a gamma-encoded sRGB channel to linear light.
-// The piecewise IEC 61966-2-1 inverse. Input in [0..1], output in [0..∞).
-export function computeSrgbToLinear(x) {
-    const v = Math.max(0, x);
-    return v <= 0.04045 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
-}
-// Rec. 2020 luminance weights (ITU-R BT.2020). Writes [r, g, b] weights into `out`.
-// L = 0.2627 * R + 0.6780 * G + 0.0593 * B.
-export function getRec2020LuminanceWeights(out) {
-    out[0] = 0.2627;
-    out[1] = 0.678;
-    out[2] = 0.0593;
-}
-// Rec. 709 / sRGB luminance weights (ITU-R BT.709). Writes [r, g, b] weights into `out`.
-// L = 0.2126 * R + 0.7152 * G + 0.0722 * B.
-export function getRec709LuminanceWeights(out) {
-    out[0] = 0.2126;
-    out[1] = 0.7152;
-    out[2] = 0.0722;
-}
-//# sourceMappingURL=colorScienceMath.js.map

package/dist/colorScienceMath.js.map

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