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

package/dist/lutMath.js

@@ -1,39 +0,0 @@
-// LUT (lookup-table) recipe math for LookupTableGradeEffect. Substrate-agnostic helpers for
-// sampling 3D color LUTs stored as 2D strip-encoded textures. All functions are alias-safe.
-// Computes the UV coordinate in the 2D strip-encoded LUT texture that corresponds to an RGB color.
-// A 3D LUT of size N is encoded as a horizontal strip of N² tiles each of size N×1:
-//   U encodes the B channel (tile index + R-within-tile).
-//   V encodes the G channel (row within the strip, normalized to [0,1]).
-// Writes [u, v] into `out`. Caller applies bilinear filtering.
-// Alias-safe.
-export function computeLookupTableCoord(r, // normalized R channel [0..1].
-g, // normalized G channel [0..1].
-b, // normalized B channel [0..1].
-lutSize, // cube size of the LUT (e.g. 16, 32, 64).
-out) {
-    const n = Math.max(1, lutSize);
-    const halfTexel = 0.5 / n;
-    // Clamp inputs to avoid bleeding at the LUT boundary.
-    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));
-    // B determines which horizontal tile (0..n-1).
-    const bSlice = bc * (n - 1);
-    const bIndex = Math.floor(bSlice);
-    // U: tile offset + R within the tile.
-    const u = (bIndex + rc * (1 - 1 / n) + halfTexel) / n;
-    // V: G channel (one row per G step, stored bottom-to-top; some encoders are inverted — callers
-    // can flip V if needed for their texture's storage convention).
-    const v = gc * (1 - 1 / n) + halfTexel;
-    out[0] = u;
-    out[1] = v;
-}
-// Returns the [width, height] in pixels of the 2D strip texture required to store a 3D LUT of
-// the given cube size. Width = size², height = size (one row of G steps).
-// Writes [width, height] into `out`.
-export function getLookupTableTileLayout(lutSize, out) {
-    const n = Math.max(1, lutSize);
-    out[0] = n * n; // width: n tiles × n pixels each.
-    out[1] = n; // height: one row per G step.
-}
-//# sourceMappingURL=lutMath.js.map

package/dist/lutMath.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lutMath.js","sourceRoot":"","sources":["../src/lutMath.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAE5F,mGAAmG;AACnG,oFAAoF;AACpF,0DAA0D;AAC1D,yEAAyE;AACzE,+DAA+D;AAC/D,cAAc;AACd,MAAM,UAAU,uBAAuB,CACrC,CAAS,EAAE,+BAA+B;AAC1C,CAAS,EAAE,+BAA+B;AAC1C,CAAS,EAAE,+BAA+B;AAC1C,OAAe,EAAE,0CAA0C;AAC3D,GAAqB;IAErB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC;IAC1B,sDAAsD;IACtD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,+CAA+C;IAC/C,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,sCAAsC;IACtC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACtD,+FAA+F;IAC/F,gEAAgE;IAChE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;IACvC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACb,CAAC;AAED,8FAA8F;AAC9F,0EAA0E;AAC1E,qCAAqC;AACrC,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,GAAqB;IAC7E,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,kCAAkC;IAClD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,8BAA8B;AAC5C,CAAC"}

package/dist/sepiaEffect.d.ts

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

package/dist/sepiaEffect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sepiaEffect.d.ts","sourceRoot":"","sources":["../src/sepiaEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAM,GAAG,WAAW,CAEhG"}

package/dist/sepiaEffect.js

@@ -1,4 +0,0 @@
-export function createSepiaEffect(options = {}) {
-    return { kind: 'SepiaEffect', ...options };
-}
-//# sourceMappingURL=sepiaEffect.js.map

package/dist/sepiaEffect.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sepiaEffect.js","sourceRoot":"","sources":["../src/sepiaEffect.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,UAA+C,EAAE;IACjF,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/src/brightnessContrastEffect.test.ts

@@ -1,14 +0,0 @@
-import { createBrightnessContrastEffect } from './brightnessContrastEffect';
-
-describe('createBrightnessContrastEffect', () => {
-  it('tags the intent type', () => {
-    expect(createBrightnessContrastEffect().kind).toBe('BrightnessContrastEffect');
-  });
-
-  it('carries options', () => {
-    expect(createBrightnessContrastEffect({ brightness: 0.2, contrast: 1.5 })).toMatchObject({
-      brightness: 0.2,
-      contrast: 1.5,
-    });
-  });
-});

package/src/channelMixerEffect.test.ts

@@ -1,12 +0,0 @@
-import { createChannelMixerEffect } from './channelMixerEffect';
-
-describe('createChannelMixerEffect', () => {
-  it('tags the intent type', () => {
-    expect(createChannelMixerEffect({ matrix: [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0] }).kind).toBe('ChannelMixerEffect');
-  });
-
-  it('carries the matrix', () => {
-    const matrix = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0];
-    expect(createChannelMixerEffect({ matrix }).matrix).toBe(matrix);
-  });
-});

package/src/colorBlindSimulationEffect.test.ts

@@ -1,13 +0,0 @@
-import { createColorBlindSimulationEffect } from './colorBlindSimulationEffect';
-
-describe('createColorBlindSimulationEffect', () => {
-  it('carries options', () => {
-    expect(createColorBlindSimulationEffect({ type: 'protanopia' })).toMatchObject({
-      type: 'protanopia',
-    });
-  });
-
-  it('tags the intent type', () => {
-    expect(createColorBlindSimulationEffect().kind).toBe('ColorBlindSimulationEffect');
-  });
-});

package/src/colorGradeEffect.test.ts

@@ -1,11 +0,0 @@
-import { createColorGradeEffect } from './colorGradeEffect';
-
-describe('createColorGradeEffect', () => {
-  it('tags the intent type', () => {
-    expect(createColorGradeEffect().kind).toBe('ColorGradeEffect');
-  });
-
-  it('carries options', () => {
-    expect(createColorGradeEffect({ exposure: 1, saturation: 1.2 })).toMatchObject({ exposure: 1, saturation: 1.2 });
-  });
-});

package/src/colorScienceMath.test.ts

@@ -1,160 +0,0 @@
-import {
-  computeHslToRgb,
-  computeLinearToSrgb,
-  computeOklabToRgb,
-  computeRgbToHsl,
-  computeRgbToOklab,
-  computeSrgbToLinear,
-  getRec709LuminanceWeights,
-  getRec2020LuminanceWeights,
-} from './colorScienceMath';
-
-describe('computeHslToRgb', () => {
-  it('hue=0, full saturation, mid lightness → red', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    computeHslToRgb(0, 1, 0.5, out);
-    expect(out[0]).toBeCloseTo(1, 4);
-    expect(out[1]).toBeCloseTo(0, 4);
-    expect(out[2]).toBeCloseTo(0, 4);
-  });
-  it('round-trips with computeRgbToHsl', () => {
-    const r = 0.3;
-    const g = 0.7;
-    const b = 0.1;
-    const hsl: [number, number, number] = [0, 0, 0];
-    computeRgbToHsl(r, g, b, hsl);
-    const rgb: [number, number, number] = [0, 0, 0];
-    computeHslToRgb(hsl[0], hsl[1], hsl[2], rgb);
-    expect(rgb[0]).toBeCloseTo(r, 4);
-    expect(rgb[1]).toBeCloseTo(g, 4);
-    expect(rgb[2]).toBeCloseTo(b, 4);
-  });
-});
-
-describe('computeLinearToSrgb', () => {
-  it('0 maps to 0', () => {
-    expect(computeLinearToSrgb(0)).toBeCloseTo(0, 5);
-  });
-  it('1 maps to 1', () => {
-    expect(computeLinearToSrgb(1)).toBeCloseTo(1, 5);
-  });
-  it('round-trips with computeSrgbToLinear', () => {
-    const linear = 0.5;
-    expect(computeSrgbToLinear(computeLinearToSrgb(linear))).toBeCloseTo(linear, 4);
-  });
-  it('clamps negative values to 0', () => {
-    expect(computeLinearToSrgb(-1)).toBeCloseTo(0, 5);
-  });
-});
-
-describe('computeOklabToRgb', () => {
-  it('round-trips with computeRgbToOklab for a mid-gray', () => {
-    const r = 0.5;
-    const g = 0.5;
-    const b = 0.5;
-    const lab: [number, number, number] = [0, 0, 0];
-    computeRgbToOklab(r, g, b, lab);
-    const rgb: [number, number, number] = [0, 0, 0];
-    computeOklabToRgb(lab[0], lab[1], lab[2], rgb);
-    expect(rgb[0]).toBeCloseTo(r, 3);
-    expect(rgb[1]).toBeCloseTo(g, 3);
-    expect(rgb[2]).toBeCloseTo(b, 3);
-  });
-  it('round-trips with computeRgbToOklab for a saturated color', () => {
-    const r = 0.8;
-    const g = 0.2;
-    const b = 0.1;
-    const lab: [number, number, number] = [0, 0, 0];
-    computeRgbToOklab(r, g, b, lab);
-    const rgb: [number, number, number] = [0, 0, 0];
-    computeOklabToRgb(lab[0], lab[1], lab[2], rgb);
-    expect(rgb[0]).toBeCloseTo(r, 3);
-    expect(rgb[1]).toBeCloseTo(g, 3);
-    expect(rgb[2]).toBeCloseTo(b, 3);
-  });
-});
-
-describe('computeRgbToHsl', () => {
-  it('red (1,0,0) has hue 0°', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    computeRgbToHsl(1, 0, 0, out);
-    expect(out[0]).toBeCloseTo(0, 2);
-    expect(out[1]).toBeCloseTo(1, 2);
-    expect(out[2]).toBeCloseTo(0.5, 2);
-  });
-  it('green (0,1,0) has hue 120°', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    computeRgbToHsl(0, 1, 0, out);
-    expect(out[0]).toBeCloseTo(120, 2);
-  });
-  it('white (1,1,1) has lightness 1 and saturation 0', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    computeRgbToHsl(1, 1, 1, out);
-    expect(out[1]).toBeCloseTo(0, 4);
-    expect(out[2]).toBeCloseTo(1, 5);
-  });
-  it('black (0,0,0) has lightness 0 and saturation 0', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    computeRgbToHsl(0, 0, 0, out);
-    expect(out[1]).toBeCloseTo(0, 4);
-    expect(out[2]).toBeCloseTo(0, 5);
-  });
-});
-
-describe('computeRgbToOklab', () => {
-  it('black (0,0,0) maps to L=0', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    computeRgbToOklab(0, 0, 0, out);
-    expect(out[0]).toBeCloseTo(0, 4);
-  });
-  it('white (1,1,1) maps to L~1, a~0, b~0', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    computeRgbToOklab(1, 1, 1, out);
-    expect(out[0]).toBeCloseTo(1, 2);
-    expect(out[1]).toBeCloseTo(0, 3);
-    expect(out[2]).toBeCloseTo(0, 3);
-  });
-});
-
-describe('computeSrgbToLinear', () => {
-  it('0 maps to 0', () => {
-    expect(computeSrgbToLinear(0)).toBeCloseTo(0, 5);
-  });
-  it('1 maps to 1', () => {
-    expect(computeSrgbToLinear(1)).toBeCloseTo(1, 5);
-  });
-  it('round-trips with computeLinearToSrgb', () => {
-    const srgb = 0.5;
-    expect(computeLinearToSrgb(computeSrgbToLinear(srgb))).toBeCloseTo(srgb, 4);
-  });
-});
-
-describe('getRec2020LuminanceWeights', () => {
-  it('weights sum to 1', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    getRec2020LuminanceWeights(out);
-    expect(out[0] + out[1] + out[2]).toBeCloseTo(1, 5);
-  });
-  it('returns canonical Rec.2020 values', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    getRec2020LuminanceWeights(out);
-    expect(out[0]).toBeCloseTo(0.2627, 4);
-    expect(out[1]).toBeCloseTo(0.678, 4);
-    expect(out[2]).toBeCloseTo(0.0593, 4);
-  });
-});
-
-describe('getRec709LuminanceWeights', () => {
-  it('weights sum to 1', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    getRec709LuminanceWeights(out);
-    expect(out[0] + out[1] + out[2]).toBeCloseTo(1, 5);
-  });
-  it('returns canonical Rec.709 values', () => {
-    const out: [number, number, number] = [0, 0, 0];
-    getRec709LuminanceWeights(out);
-    expect(out[0]).toBeCloseTo(0.2126, 4);
-    expect(out[1]).toBeCloseTo(0.7152, 4);
-    expect(out[2]).toBeCloseTo(0.0722, 4);
-  });
-});

package/src/exposureEffect.test.ts

@@ -1,7 +0,0 @@
-import { createExposureEffect } from './exposureEffect';
-
-describe('createExposureEffect', () => {
-  it('tags the intent type', () => {
-    expect(createExposureEffect({ exposure: 1 }).kind).toBe('ExposureEffect');
-  });
-});

package/src/grayscaleEffect.test.ts

@@ -1,11 +0,0 @@
-import { createGrayscaleEffect } from './grayscaleEffect';
-
-describe('createGrayscaleEffect', () => {
-  it('tags the intent type', () => {
-    expect(createGrayscaleEffect().kind).toBe('GrayscaleEffect');
-  });
-
-  it('carries options', () => {
-    expect(createGrayscaleEffect({ intensity: 0.5 })).toMatchObject({ intensity: 0.5 });
-  });
-});

package/src/hueSaturationEffect.test.ts

@@ -1,15 +0,0 @@
-import { createHueSaturationEffect } from './hueSaturationEffect';
-
-describe('createHueSaturationEffect', () => {
-  it('tags the intent type', () => {
-    expect(createHueSaturationEffect().kind).toBe('HueSaturationEffect');
-  });
-
-  it('carries options', () => {
-    expect(createHueSaturationEffect({ hue: 90, saturation: 1.4, lightness: 0.1 })).toMatchObject({
-      hue: 90,
-      saturation: 1.4,
-      lightness: 0.1,
-    });
-  });
-});

package/src/invertEffect.test.ts

@@ -1,11 +0,0 @@
-import { createInvertEffect } from './invertEffect';
-
-describe('createInvertEffect', () => {
-  it('tags the intent type', () => {
-    expect(createInvertEffect().kind).toBe('InvertEffect');
-  });
-
-  it('carries options', () => {
-    expect(createInvertEffect({ intensity: 0.75 })).toMatchObject({ intensity: 0.75 });
-  });
-});

package/src/liftGammaGainEffect.test.ts

@@ -1,15 +0,0 @@
-import { createLiftGammaGainEffect } from './liftGammaGainEffect';
-
-describe('createLiftGammaGainEffect', () => {
-  it('tags the intent type', () => {
-    expect(createLiftGammaGainEffect().kind).toBe('LiftGammaGainEffect');
-  });
-
-  it('carries options', () => {
-    expect(createLiftGammaGainEffect({ lift: 0x808080ff, gamma: 0x808080ff, gain: 0x808080ff })).toMatchObject({
-      lift: 0x808080ff,
-      gamma: 0x808080ff,
-      gain: 0x808080ff,
-    });
-  });
-});

package/src/lookupTableGradeEffect.test.ts

@@ -1,11 +0,0 @@
-import { createLookupTableGradeEffect } from './lookupTableGradeEffect';
-
-describe('createLookupTableGradeEffect', () => {
-  it('tags the intent type', () => {
-    expect(createLookupTableGradeEffect().kind).toBe('LookupTableGradeEffect');
-  });
-
-  it('carries options', () => {
-    expect(createLookupTableGradeEffect({ size: 32, strength: 0.8 })).toMatchObject({ size: 32, strength: 0.8 });
-  });
-});

package/src/lutMath.test.ts

@@ -1,67 +0,0 @@
-import { computeLookupTableCoord, getLookupTableTileLayout } from './lutMath';
-
-describe('computeLookupTableCoord', () => {
-  it('writes two values into out', () => {
-    const out: [number, number] = [0, 0];
-    computeLookupTableCoord(0.5, 0.5, 0.5, 16, out);
-    expect(typeof out[0]).toBe('number');
-    expect(typeof out[1]).toBe('number');
-  });
-  it('black (0,0,0) maps to near (0, 0)', () => {
-    const out: [number, number] = [0, 0];
-    computeLookupTableCoord(0, 0, 0, 16, out);
-    expect(out[0]).toBeGreaterThanOrEqual(0);
-    expect(out[1]).toBeGreaterThanOrEqual(0);
-  });
-  it('U and V are in [0, 1] range for valid input', () => {
-    const out: [number, number] = [0, 0];
-    computeLookupTableCoord(0.5, 0.5, 0.5, 16, out);
-    expect(out[0]).toBeGreaterThanOrEqual(0);
-    expect(out[0]).toBeLessThanOrEqual(1);
-    expect(out[1]).toBeGreaterThanOrEqual(0);
-    expect(out[1]).toBeLessThanOrEqual(1);
-  });
-  it('high G shifts V up', () => {
-    const outLow: [number, number] = [0, 0];
-    const outHigh: [number, number] = [0, 0];
-    computeLookupTableCoord(0.5, 0.1, 0.5, 16, outLow);
-    computeLookupTableCoord(0.5, 0.9, 0.5, 16, outHigh);
-    expect(outHigh[1]).toBeGreaterThan(outLow[1]);
-  });
-  it('high B shifts U right', () => {
-    const outLow: [number, number] = [0, 0];
-    const outHigh: [number, number] = [0, 0];
-    computeLookupTableCoord(0.5, 0.5, 0.1, 16, outLow);
-    computeLookupTableCoord(0.5, 0.5, 0.9, 16, outHigh);
-    expect(outHigh[0]).toBeGreaterThan(outLow[0]);
-  });
-  it('clamps out-of-range input', () => {
-    const out1: [number, number] = [0, 0];
-    const out2: [number, number] = [0, 0];
-    computeLookupTableCoord(0, 0, 0, 16, out1);
-    computeLookupTableCoord(-0.5, -0.5, -0.5, 16, out2);
-    expect(out1[0]).toBeCloseTo(out2[0], 5);
-    expect(out1[1]).toBeCloseTo(out2[1], 5);
-  });
-});
-
-describe('getLookupTableTileLayout', () => {
-  it('returns [size², size] for a given LUT size', () => {
-    const out: [number, number] = [0, 0];
-    getLookupTableTileLayout(16, out);
-    expect(out[0]).toBe(256); // 16 * 16
-    expect(out[1]).toBe(16);
-  });
-  it('works for size 32', () => {
-    const out: [number, number] = [0, 0];
-    getLookupTableTileLayout(32, out);
-    expect(out[0]).toBe(1024);
-    expect(out[1]).toBe(32);
-  });
-  it('handles size 1 without dividing by zero', () => {
-    const out: [number, number] = [0, 0];
-    getLookupTableTileLayout(1, out);
-    expect(out[0]).toBe(1);
-    expect(out[1]).toBe(1);
-  });
-});

package/src/sepiaEffect.test.ts

@@ -1,11 +0,0 @@
-import { createSepiaEffect } from './sepiaEffect';
-
-describe('createSepiaEffect', () => {
-  it('tags the intent type', () => {
-    expect(createSepiaEffect().kind).toBe('SepiaEffect');
-  });
-
-  it('carries options', () => {
-    expect(createSepiaEffect({ intensity: 0.6 })).toMatchObject({ intensity: 0.6 });
-  });
-});