@flighthq/color 0.2.1-next.410.a23f189

package/dist/colorFromKelvin.d.ts

@@ -0,0 +1,2 @@
+export declare function createColorFromKelvin(kelvin: number): number;
+//# sourceMappingURL=colorFromKelvin.d.ts.map

package/dist/colorFromKelvin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorFromKelvin.d.ts","sourceRoot":"","sources":["../src/colorFromKelvin.ts"],"names":[],"mappings":"AAOA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqC5D"}

package/dist/colorFromKelvin.js

@@ -0,0 +1,44 @@
+// Creates a packed sRgb-albedo RGBA color (0xrrggbbaa) from a color temperature in Kelvin.
+// Uses the Tanner Helland piecewise approximation (accurate to within ±1% for 1000 K–40000 K),
+// the same algorithm used in Blender, three.js, and Filament's color-temperature helper.
+// Returns opaque white (0xffffffff) for temperatures outside the 1000–40000 K range.
+//
+// Common temperatures: 1800 K = candlelight, 3000 K = warm bulb, 5500 K = noon sunlight,
+// 6500 K = D65 white, 10000 K = overcast sky.
+export function createColorFromKelvin(kelvin) {
+    // Clamp to the valid range.
+    const temp = Math.max(1000, Math.min(40000, kelvin)) / 100;
+    let r;
+    let g;
+    let b;
+    // Red channel.
+    if (temp <= 66) {
+        r = 255;
+    }
+    else {
+        r = 329.698727446 * Math.pow(temp - 60, -0.1332047592);
+    }
+    // Green channel.
+    if (temp <= 66) {
+        g = 99.4708025861 * Math.log(temp) - 161.1195681661;
+    }
+    else {
+        g = 288.1221695283 * Math.pow(temp - 60, -0.0755148492);
+    }
+    // Blue channel.
+    if (temp >= 66) {
+        b = 255;
+    }
+    else if (temp <= 19) {
+        b = 0;
+    }
+    else {
+        b = 138.5177312231 * Math.log(temp - 10) - 305.0447927307;
+    }
+    const ri = Math.max(0, Math.min(255, Math.round(r)));
+    const gi = Math.max(0, Math.min(255, Math.round(g)));
+    const bi = Math.max(0, Math.min(255, Math.round(b)));
+    // Pack as 0xrrggbbaa with fully opaque alpha.
+    return ((ri << 24) | (gi << 16) | (bi << 8) | 0xff) >>> 0;
+}
+//# sourceMappingURL=colorFromKelvin.js.map

package/dist/colorFromKelvin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorFromKelvin.js","sourceRoot":"","sources":["../src/colorFromKelvin.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,+FAA+F;AAC/F,yFAAyF;AACzF,qFAAqF;AACrF,EAAE;AACF,yFAAyF;AACzF,8CAA8C;AAC9C,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,4BAA4B;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC;IAE3D,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IAEd,eAAe;IACf,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACf,CAAC,GAAG,GAAG,CAAC;IACV,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAED,iBAAiB;IACjB,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACf,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED,gBAAgB;IAChB,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACf,CAAC,GAAG,GAAG,CAAC;IACV,CAAC;SAAM,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACtB,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC;IAC5D,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,8CAA8C;IAC9C,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/hslColor.d.ts

@@ -0,0 +1,5 @@
+export type HslColor = [number, number, number];
+export declare function createHslColor(): HslColor;
+export declare function hslToRgb(out: [number, number, number, number], h: number, s: number, l: number): void;
+export declare function rgbToHsl(out: HslColor, color: number): HslColor;
+//# sourceMappingURL=hslColor.d.ts.map

package/dist/hslColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hslColor.d.ts","sourceRoot":"","sources":["../src/hslColor.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAGhD,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAKD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAarG;AAMD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CA2B/D"}

package/dist/hslColor.js

@@ -0,0 +1,67 @@
+// Allocates a fresh zeroed `HslColor` for use as an `rgbToHsl` out parameter.
+export function createHslColor() {
+    return [0, 0, 0];
+}
+// Converts HSL to sRGB floats. Writes sRGB [0, 1] R/G/B to out[0..2] (h in [0, 360), s/l in
+// [0, 1]); leaves out[3] (alpha) unmodified. The conversion operates in sRGB (non-linear)
+// space, matching artist-facing color pickers.
+export function hslToRgb(out, h, s, l) {
+    if (s === 0) {
+        out[0] = l;
+        out[1] = l;
+        out[2] = l;
+        return;
+    }
+    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+    const p = 2 * l - q;
+    const hn = h / 360;
+    out[0] = hueToRgbChannel(p, q, hn + 1 / 3);
+    out[1] = hueToRgbChannel(p, q, hn);
+    out[2] = hueToRgbChannel(p, q, hn - 1 / 3);
+}
+// Converts a packed sRGB `0xRRGGBBAA` color to HSL and writes to `out`.
+// `out[0]` = hue in [0, 360), `out[1]` = saturation [0, 1], `out[2]` = lightness [0, 1].
+// Alpha is ignored. The conversion operates in sRGB (non-linear) space, consistent with
+// artist-facing HSL color pickers. Returns `out`.
+export function rgbToHsl(out, color) {
+    const r = ((color >>> 24) & 0xff) / 0xff;
+    const g = ((color >>> 16) & 0xff) / 0xff;
+    const b = ((color >>> 8) & 0xff) / 0xff;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    if (max === min) {
+        out[0] = 0;
+        out[1] = 0;
+        out[2] = l;
+        return out;
+    }
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let h;
+    if (max === r) {
+        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+    }
+    else if (max === g) {
+        h = ((b - r) / d + 2) / 6;
+    }
+    else {
+        h = ((r - g) / d + 4) / 6;
+    }
+    out[0] = h * 360;
+    out[1] = s;
+    out[2] = l;
+    return out;
+}
+// HSL helper: interpolates a single channel from hue position `t`.
+function hueToRgbChannel(p, q, t) {
+    const tn = ((t % 1) + 1) % 1;
+    if (tn < 1 / 6)
+        return p + (q - p) * 6 * tn;
+    if (tn < 1 / 2)
+        return q;
+    if (tn < 2 / 3)
+        return p + (q - p) * (2 / 3 - tn) * 6;
+    return p;
+}
+//# sourceMappingURL=hslColor.js.map

package/dist/hslColor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hslColor.js","sourceRoot":"","sources":["../src/hslColor.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,4FAA4F;AAC5F,0FAA0F;AAC1F,+CAA+C;AAC/C,MAAM,UAAU,QAAQ,CAAC,GAAqC,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;IAC7F,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,OAAO;IACT,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;IACnB,GAAG,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACnC,GAAG,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,wEAAwE;AACxE,yFAAyF;AACzF,wFAAwF;AACxF,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,GAAa,EAAE,KAAa;IACnD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;IACpB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC;IACN,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACd,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACrB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACjB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mEAAmE;AACnE,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACtD,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAC5C,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACzB,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACtD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/hsvColor.d.ts

@@ -0,0 +1,5 @@
+export type HsvColor = [number, number, number];
+export declare function createHsvColor(): HsvColor;
+export declare function hsvToRgb(out: [number, number, number, number], h: number, s: number, v: number): void;
+export declare function rgbToHsv(out: HsvColor, color: number): HsvColor;
+//# sourceMappingURL=hsvColor.d.ts.map

package/dist/hsvColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsvColor.d.ts","sourceRoot":"","sources":["../src/hsvColor.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAGhD,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAID,wBAAgB,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CA6CrG;AAKD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAuB/D"}

package/dist/hsvColor.js

@@ -0,0 +1,83 @@
+// Allocates a fresh zeroed `HsvColor` for use as an `rgbToHsv` out parameter.
+export function createHsvColor() {
+    return [0, 0, 0];
+}
+// Converts HSV to RGB floats. Writes sRGB [0, 1] to out[0..2] (h in [0, 360), s/v in [0, 1]).
+// Alpha in out[3] is not modified.
+export function hsvToRgb(out, h, s, v) {
+    if (s === 0) {
+        out[0] = v;
+        out[1] = v;
+        out[2] = v;
+        return;
+    }
+    const hn = ((h % 360) + 360) % 360;
+    const i = Math.floor(hn / 60) % 6;
+    const f = hn / 60 - Math.floor(hn / 60);
+    const p = v * (1 - s);
+    const q = v * (1 - f * s);
+    const t = v * (1 - (1 - f) * s);
+    switch (i) {
+        case 0:
+            out[0] = v;
+            out[1] = t;
+            out[2] = p;
+            break;
+        case 1:
+            out[0] = q;
+            out[1] = v;
+            out[2] = p;
+            break;
+        case 2:
+            out[0] = p;
+            out[1] = v;
+            out[2] = t;
+            break;
+        case 3:
+            out[0] = p;
+            out[1] = q;
+            out[2] = v;
+            break;
+        case 4:
+            out[0] = t;
+            out[1] = p;
+            out[2] = v;
+            break;
+        default:
+            out[0] = v;
+            out[1] = p;
+            out[2] = q;
+            break;
+    }
+}
+// Converts a packed sRGB `0xRRGGBBAA` color to HSV and writes to `out`.
+// `out[0]` = hue in [0, 360), `out[1]` = saturation [0, 1], `out[2]` = value [0, 1].
+// Alpha is ignored. The conversion operates in sRGB (non-linear) space. Returns `out`.
+export function rgbToHsv(out, color) {
+    const r = ((color >>> 24) & 0xff) / 0xff;
+    const g = ((color >>> 16) & 0xff) / 0xff;
+    const b = ((color >>> 8) & 0xff) / 0xff;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const d = max - min;
+    const v = max;
+    const s = max === 0 ? 0 : d / max;
+    let h;
+    if (d === 0) {
+        h = 0;
+    }
+    else if (max === r) {
+        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+    }
+    else if (max === g) {
+        h = ((b - r) / d + 2) / 6;
+    }
+    else {
+        h = ((r - g) / d + 4) / 6;
+    }
+    out[0] = h * 360;
+    out[1] = s;
+    out[2] = v;
+    return out;
+}
+//# sourceMappingURL=hsvColor.js.map

package/dist/hsvColor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './colorFromKelvin';
+export * from './hslColor';
+export * from './hsvColor';
+export * from './lerpColor';
+export * from './luminance';
+export * from './oklab';
+export * from './packColor';
+export * from './premultiplyColorAlpha';
+export * from './srgbTransfer';
+//# 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,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './colorFromKelvin';
+export * from './hslColor';
+export * from './hsvColor';
+export * from './lerpColor';
+export * from './luminance';
+export * from './oklab';
+export * from './packColor';
+export * from './premultiplyColorAlpha';
+export * from './srgbTransfer';
+//# 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,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/dist/lerpColor.d.ts

@@ -0,0 +1,4 @@
+import type { LinearColor } from '@flighthq/types';
+export declare function lerpColor(start: number, end: number, t: number): number;
+export declare function lerpLinearColor(out: LinearColor, start: Readonly<LinearColor>, end: Readonly<LinearColor>, t: number): LinearColor;
+//# sourceMappingURL=lerpColor.d.ts.map

package/dist/lerpColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lerpColor.d.ts","sourceRoot":"","sources":["../src/lerpColor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AASnD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAevE;AAID,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC5B,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC1B,CAAC,EAAE,MAAM,GACR,WAAW,CAeb"}

package/dist/lerpColor.js

@@ -0,0 +1,41 @@
+import { packLinearToColor } from './packColor';
+import { srgbChannelToLinear } from './srgbTransfer';
+// Linearly interpolates between two packed sRGB colors `start` and `end` by `t` in [0, 1].
+// Interpolation is performed in linear space for perceptual correctness (gamma-correct mix),
+// then repacked to sRGB. Alpha is interpolated linearly (alpha is already linear coverage).
+// `t` is clamped to [0, 1].
+export function lerpColor(start, end, t) {
+    const tc = Math.min(1, Math.max(0, t));
+    const sr = srgbChannelToLinear(((start >>> 24) & 0xff) / 0xff);
+    const sg = srgbChannelToLinear(((start >>> 16) & 0xff) / 0xff);
+    const sb = srgbChannelToLinear(((start >>> 8) & 0xff) / 0xff);
+    const sa = (start & 0xff) / 0xff;
+    const er = srgbChannelToLinear(((end >>> 24) & 0xff) / 0xff);
+    const eg = srgbChannelToLinear(((end >>> 16) & 0xff) / 0xff);
+    const eb = srgbChannelToLinear(((end >>> 8) & 0xff) / 0xff);
+    const ea = (end & 0xff) / 0xff;
+    const r = sr + (er - sr) * tc;
+    const g = sg + (eg - sg) * tc;
+    const b = sb + (eb - sb) * tc;
+    const a = sa + (ea - sa) * tc;
+    return packLinearToColor([r, g, b, a]);
+}
+// Linearly interpolates between two LinearColors in linear space and writes the result to
+// `out`. `t` is clamped to [0, 1]. Alias-safe: reads all input values before writing `out`.
+export function lerpLinearColor(out, start, end, t) {
+    const tc = Math.min(1, Math.max(0, t));
+    const r0 = start[0];
+    const g0 = start[1];
+    const b0 = start[2];
+    const a0 = start[3];
+    const r1 = end[0];
+    const g1 = end[1];
+    const b1 = end[2];
+    const a1 = end[3];
+    out[0] = r0 + (r1 - r0) * tc;
+    out[1] = g0 + (g1 - g0) * tc;
+    out[2] = b0 + (b1 - b0) * tc;
+    out[3] = a0 + (a1 - a0) * tc;
+    return out;
+}
+//# sourceMappingURL=lerpColor.js.map

package/dist/lerpColor.js.map

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

package/dist/luminance.d.ts

@@ -0,0 +1,5 @@
+export declare function getColorContrastRatio(a: number, b: number): number;
+export declare function getColorLuminance(color: number): number;
+export declare function getRec2020LuminanceWeights(out: [number, number, number]): void;
+export declare function getRec709LuminanceWeights(out: [number, number, number]): void;
+//# sourceMappingURL=luminance.d.ts.map

package/dist/luminance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luminance.d.ts","sourceRoot":"","sources":["../src/luminance.ts"],"names":[],"mappings":"AAKA,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlE;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;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/luminance.js

@@ -0,0 +1,35 @@
+import { srgbChannelToLinear } from './srgbTransfer';
+// WCAG 2.x contrast ratio between two packed sRGB `0xRRGGBBAA` colors (alpha ignored).
+// Returns the ratio in [1, 21]; 1 = no contrast, 21 = black on white. The formula is
+// (L1 + 0.05) / (L2 + 0.05) where L1 ≥ L2 are the relative luminances.
+export function getColorContrastRatio(a, b) {
+    const la = getColorLuminance(a);
+    const lb = getColorLuminance(b);
+    const lighter = Math.max(la, lb);
+    const darker = Math.min(la, lb);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+// Rec. 709 relative luminance of a packed sRGB `0xRRGGBBAA` color (alpha ignored).
+// Gamma-decodes RGB to linear, then applies the Rec. 709 luminance weights. Returns a
+// value in [0, 1] where 0 is black and 1 is white.
+export function getColorLuminance(color) {
+    const r = srgbChannelToLinear(((color >>> 24) & 0xff) / 0xff);
+    const g = srgbChannelToLinear(((color >>> 16) & 0xff) / 0xff);
+    const b = srgbChannelToLinear(((color >>> 8) & 0xff) / 0xff);
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+// 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=luminance.js.map

package/dist/luminance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"luminance.js","sourceRoot":"","sources":["../src/luminance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,uFAAuF;AACvF,qFAAqF;AACrF,uEAAuE;AACvE,MAAM,UAAU,qBAAqB,CAAC,CAAS,EAAE,CAAS;IACxD,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,mFAAmF;AACnF,sFAAsF;AACtF,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,oFAAoF;AACpF,4CAA4C;AAC5C,MAAM,UAAU,0BAA0B,CAAC,GAA6B;IACtE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAChB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACf,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAClB,CAAC;AAED,yFAAyF;AACzF,4CAA4C;AAC5C,MAAM,UAAU,yBAAyB,CAAC,GAA6B;IACrE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAChB,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAChB,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAClB,CAAC"}

package/dist/oklab.d.ts

@@ -0,0 +1,3 @@
+export declare function linearRgbToOklab(out: [number, number, number], r: number, g: number, b: number): void;
+export declare function oklabToLinearRgb(out: [number, number, number], L: number, a: number, b: number): void;
+//# sourceMappingURL=oklab.d.ts.map

package/dist/oklab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklab.d.ts","sourceRoot":"","sources":["../src/oklab.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAarG;AAID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAarG"}

package/dist/oklab.js

@@ -0,0 +1,34 @@
+// Converts linear sRGB [0..1] to Oklab, writing [L, a, b] into `out` (L∈[0..1],
+// a/b∈~[-0.5..0.5]). Oklab is a perceptually uniform space; equal steps in L, a, b are
+// visually equal. Reference: Ottosson 2020. Alias-safe.
+export function linearRgbToOklab(out, r, g, b) {
+    // linear sRGB → 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;
+}
+// Converts Oklab [L, a, b] back to linear sRGB [0..1], writing [r, g, b] into `out`.
+// Alias-safe.
+export function oklabToLinearRgb(out, L, a, b) {
+    // 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);
+}
+//# sourceMappingURL=oklab.js.map

package/dist/oklab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklab.js","sourceRoot":"","sources":["../src/oklab.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uFAAuF;AACvF,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,GAA6B,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;IAC7F,sCAAsC;IACtC,MAAM,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC;IACjE,sBAAsB;IACtB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,eAAe;IACf,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE,GAAG,YAAY,GAAG,EAAE,CAAC;IAClE,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE,GAAG,YAAY,GAAG,EAAE,CAAC;IAClE,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,EAAE,GAAG,YAAY,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE,CAAC;AACpE,CAAC;AAED,qFAAqF;AACrF,cAAc;AACd,MAAM,UAAU,gBAAgB,CAAC,GAA6B,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;IAC7F,eAAe;IACf,MAAM,EAAE,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC;IAClD,QAAQ;IACR,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACvB,qBAAqB;IACrB,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC;IAC7E,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC;IAC9E,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,YAAY,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/packColor.d.ts

@@ -0,0 +1,13 @@
+import type { LinearColor } from '@flighthq/types';
+export type { LinearColor };
+export declare function computeRgbHexString(color: number): string;
+export declare function createLinearColor(): LinearColor;
+export declare function getColorAlpha(color: number): number;
+export declare function getColorRgb(color: number): number;
+export declare function packColor(r: number, g: number, b: number, a: number): number;
+export declare function packLinearToColor(color: Readonly<LinearColor>): number;
+export declare function packOpaqueColor(rgb: number): number;
+export declare function setColorAlpha(color: number, alpha: number): number;
+export declare function unpackColorRgba(out: [number, number, number, number], color: number): void;
+export declare function unpackColorToLinear(out: LinearColor, color: number): LinearColor;
+//# sourceMappingURL=packColor.d.ts.map

package/dist/packColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packColor.d.ts","sourceRoot":"","sources":["../src/packColor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,YAAY,EAAE,WAAW,EAAE,CAAC;AAK5B,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAGD,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAKD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAKD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5E;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAMtE;AAQD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAKD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlE;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK1F;AAQD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAMhF"}

package/dist/packColor.js

@@ -0,0 +1,81 @@
+import { linearChannelToSrgb, srgbChannelToLinear } from './srgbTransfer';
+// Takes a 24-bit RGB color (`0xRRGGBB`, e.g. a TextFormat color) and returns a
+// CSS `#RRGGBB` string. Any high-byte bits are masked off, so a 32-bit RGBA
+// value would keep `GGBBAA` — pass RGB, not RGBA.
+export function computeRgbHexString(color) {
+    return `#${(color & 0xffffff).toString(16).padStart(6, '0')}`;
+}
+// Allocates a fresh zeroed `LinearColor` for use as an `unpackColorToLinear` out parameter.
+export function createLinearColor() {
+    return [0, 0, 0, 0];
+}
+// Returns the alpha channel of a packed `0xRRGGBBAA` color as a float in [0, 1] — the inverse of
+// `setColorAlpha`. RGB is ignored. Alpha is linear coverage, so this is a plain byte read with no
+// gamma decode (unlike `unpackColorToLinear`, which decodes the RGB channels).
+export function getColorAlpha(color) {
+    return (color & 0xff) / 0xff;
+}
+// Returns the 24-bit RGB part (`0xRRGGBB`) of a packed `0xRRGGBBAA` color, dropping alpha — the
+// inverse of `packOpaqueColor`'s widening. Useful when handing a color to an API that wants the
+// alpha-less form (a CSS `#RRGGBB` via `computeRgbHexString`, a 24-bit format field).
+export function getColorRgb(color) {
+    return (color >>> 8) & 0xffffff;
+}
+// Packs four sRGB-space components (each in [0, 1]) to a `0xRRGGBBAA` integer.
+// Does NOT gamma-encode — use `packLinearToColor` when starting from linear floats.
+// Components are clamped to [0, 1] and rounded to 8-bit precision.
+export function packColor(r, g, b, a) {
+    const ri = Math.round(Math.min(1, Math.max(0, r)) * 0xff);
+    const gi = Math.round(Math.min(1, Math.max(0, g)) * 0xff);
+    const bi = Math.round(Math.min(1, Math.max(0, b)) * 0xff);
+    const ai = Math.round(Math.min(1, Math.max(0, a)) * 0xff);
+    return ((ri << 24) | (gi << 16) | (bi << 8) | ai) >>> 0;
+}
+// Packs a linear-space RGBA float color to a `0xRRGGBBAA` integer (the inverse of
+// `unpackColorToLinear`). RGB channels are gamma-encoded to sRGB; alpha passes through
+// unchanged (alpha is linear coverage, never gamma-encoded). Channels are clamped to [0, 1].
+export function packLinearToColor(color) {
+    const r = Math.round(Math.min(1, Math.max(0, linearChannelToSrgb(color[0]))) * 0xff);
+    const g = Math.round(Math.min(1, Math.max(0, linearChannelToSrgb(color[1]))) * 0xff);
+    const b = Math.round(Math.min(1, Math.max(0, linearChannelToSrgb(color[2]))) * 0xff);
+    const a = Math.round(Math.min(1, Math.max(0, color[3])) * 0xff);
+    return ((r << 24) | (g << 16) | (b << 8) | a) >>> 0;
+}
+// Widens a 24-bit RGB color (`0xRRGGBB` — a CSS hex literal, a Flash/AwayJS/TextFormat color, a
+// 24-bit format field) to a fully opaque packed `0xRRGGBBAA` integer, Flight's canonical color form.
+// Bits above 24 are masked off, so `packOpaqueColor(0xff8800)` is `0xff8800ff`. The complement of
+// `getColorRgb`; use `setColorAlpha` afterward for a non-opaque alpha. The value stays sRGB — Flight
+// packed colors are sRGB-encoded and decoded at render (`unpackColorToLinear`), so DO NOT pre-linearize
+// before packing: that double-decodes and loses 8-bit precision.
+export function packOpaqueColor(rgb) {
+    return (((rgb & 0xffffff) << 8) | 0xff) >>> 0;
+}
+// Replaces the alpha channel of a packed `0xRRGGBBAA` color with `alpha` (a float in [0, 1], clamped
+// and rounded to 8 bits), leaving RGB untouched — the inverse of `getColorAlpha`. Use to fade or set
+// the opacity of a fixed color without unpacking it.
+export function setColorAlpha(color, alpha) {
+    const a = Math.round(Math.min(1, Math.max(0, alpha)) * 0xff);
+    return ((color & 0xffffff00) | a) >>> 0;
+}
+// Converts a packed sRGB-space `0xRRGGBBAA` integer into four components in [0, 1] and
+// writes them to `out`. Does NOT gamma-decode — use `unpackColorToLinear` for linear space.
+export function unpackColorRgba(out, color) {
+    out[0] = ((color >>> 24) & 0xff) / 0xff;
+    out[1] = ((color >>> 16) & 0xff) / 0xff;
+    out[2] = ((color >>> 8) & 0xff) / 0xff;
+    out[3] = (color & 0xff) / 0xff;
+}
+// The single sRgb→linear decode seam for the whole SDK (§0.2): packed `0xRRGGBBAA` is
+// sRgb-albedo, so RGB is gamma-decoded to linear while alpha passes through unchanged
+// (alpha is already linear coverage, never gamma-encoded). Writes four floats in [0, 1]
+// into `out` and returns it. A packed 8-bit integer cannot carry HDR — light and emissive
+// radiance is `unpackColorToLinear(out, color) × intensity`, computed by the caller.
+// Backends must not re-decode packed colors; they consume this output.
+export function unpackColorToLinear(out, color) {
+    out[0] = srgbChannelToLinear(((color >>> 24) & 0xff) / 0xff);
+    out[1] = srgbChannelToLinear(((color >>> 16) & 0xff) / 0xff);
+    out[2] = srgbChannelToLinear(((color >>> 8) & 0xff) / 0xff);
+    out[3] = (color & 0xff) / 0xff;
+    return out;
+}
+//# sourceMappingURL=packColor.js.map

package/dist/packColor.js.map

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

package/dist/premultiplyColorAlpha.d.ts

@@ -0,0 +1,3 @@
+export declare function premultiplyColorAlpha(color: number): number;
+export declare function unpremultiplyColorAlpha(color: number): number;
+//# sourceMappingURL=premultiplyColorAlpha.d.ts.map

package/dist/premultiplyColorAlpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premultiplyColorAlpha.d.ts","sourceRoot":"","sources":["../src/premultiplyColorAlpha.ts"],"names":[],"mappings":"AAIA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3D;AAKD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7D"}

package/dist/premultiplyColorAlpha.js

@@ -0,0 +1,24 @@
+// Premultiplies the RGB channels of a packed sRGB `0xRRGGBBAA` color by its alpha channel
+// and returns a new packed color. Output RGB = round(RGB × alpha). The alpha channel
+// is preserved unchanged. Fully-transparent (alpha=0) results in black-with-alpha-0.
+// Used when a renderer requires premultiplied-alpha color values.
+export function premultiplyColorAlpha(color) {
+    const a = (color & 0xff) / 0xff;
+    const r = Math.round(((color >>> 24) & 0xff) * a);
+    const g = Math.round(((color >>> 16) & 0xff) * a);
+    const b = Math.round(((color >>> 8) & 0xff) * a);
+    return ((r << 24) | (g << 16) | (b << 8) | (color & 0xff)) >>> 0;
+}
+// Reverses premultiplied-alpha encoding for a packed sRGB `0xRRGGBBAA` color.
+// Output RGB = round(RGB / alpha), clamped to [0, 255]. Returns the input unchanged
+// when alpha is 0 (division-by-zero guard: fully-transparent stays black-with-alpha-0).
+export function unpremultiplyColorAlpha(color) {
+    const a = (color & 0xff) / 0xff;
+    if (a === 0)
+        return color;
+    const r = Math.min(255, Math.round(((color >>> 24) & 0xff) / a));
+    const g = Math.min(255, Math.round(((color >>> 16) & 0xff) / a));
+    const b = Math.min(255, Math.round(((color >>> 8) & 0xff) / a));
+    return ((r << 24) | (g << 16) | (b << 8) | (color & 0xff)) >>> 0;
+}
+//# sourceMappingURL=premultiplyColorAlpha.js.map

package/dist/premultiplyColorAlpha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"premultiplyColorAlpha.js","sourceRoot":"","sources":["../src/premultiplyColorAlpha.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,qFAAqF;AACrF,qFAAqF;AACrF,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,8EAA8E;AAC9E,oFAAoF;AACpF,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/srgbTransfer.d.ts

@@ -0,0 +1,3 @@
+export declare function linearChannelToSrgb(value: number): number;
+export declare function srgbChannelToLinear(value: number): number;
+//# sourceMappingURL=srgbTransfer.d.ts.map

package/dist/srgbTransfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"srgbTransfer.d.ts","sourceRoot":"","sources":["../src/srgbTransfer.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/srgbTransfer.js

@@ -0,0 +1,13 @@
+// The IEC 61966-2-1 linear-to-sRGB inverse OETF for a single channel in [0, 1].
+// The canonical linear→sRGB channel transfer for the whole SDK; the packed form is
+// `packLinearToColor`. Does not clamp — callers that need HDR clamping do so explicitly.
+export function linearChannelToSrgb(value) {
+    return value <= 0.0031308 ? value * 12.92 : 1.055 * value ** (1 / 2.4) - 0.055;
+}
+// The IEC 61966-2-1 sRGB electro-optical transfer function for a single channel in [0, 1].
+// The canonical sRGB→linear channel transfer for the whole SDK — the single decode seam
+// (§0.2) `unpackColorToLinear` and `getColorLuminance` build on. Does not clamp.
+export function srgbChannelToLinear(value) {
+    return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+}
+//# sourceMappingURL=srgbTransfer.js.map

package/dist/srgbTransfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"srgbTransfer.js","sourceRoot":"","sources":["../src/srgbTransfer.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AACnF,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;AACjF,CAAC;AAED,2FAA2F;AAC3F,wFAAwF;AACxF,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;AAC7E,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@flighthq/color",
+  "version": "0.2.1-next.410.a23f189",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/color"
+  },
+  "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.2.1-next.410.a23f189"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Bedrock color primitive — packed-RGBA pack/unpack, sRGB↔linear transfer, HSL/HSV, OkLab, luminance/contrast, premultiply, hex; pure value/space math over plain numbers and LinearColor",
+  "sideEffects": false
+}

package/src/colorFromKelvin.test.ts

@@ -0,0 +1,48 @@
+import { createColorFromKelvin } from './colorFromKelvin';
+
+describe('createColorFromKelvin', () => {
+  it('returns opaque alpha (0xff) for all temperatures', () => {
+    expect(createColorFromKelvin(3000) & 0xff).toBe(0xff);
+    expect(createColorFromKelvin(6500) & 0xff).toBe(0xff);
+    expect(createColorFromKelvin(10000) & 0xff).toBe(0xff);
+  });
+
+  it('returns white (0xffffffff) for D65 daylight (~6500 K)', () => {
+    const color = createColorFromKelvin(6500);
+    const r = (color >>> 24) & 0xff;
+    const g = (color >>> 16) & 0xff;
+    const b = (color >>> 8) & 0xff;
+    // D65 should be close to neutral white — all channels near 255.
+    expect(r).toBeGreaterThan(240);
+    expect(g).toBeGreaterThan(240);
+    expect(b).toBeGreaterThan(230);
+  });
+
+  it('produces warmer (more red, less blue) color for lower temperatures', () => {
+    const warm = createColorFromKelvin(2000);
+    const cool = createColorFromKelvin(10000);
+    const warmR = (warm >>> 24) & 0xff;
+    const warmB = (warm >>> 8) & 0xff;
+    const coolR = (cool >>> 24) & 0xff;
+    const coolB = (cool >>> 8) & 0xff;
+    // Warm candlelight should have more red and less blue than cool sky light.
+    expect(warmR).toBeGreaterThanOrEqual(coolR);
+    expect(warmB).toBeLessThanOrEqual(coolB);
+  });
+
+  it('clamps inputs below 1000 K to 1000 K', () => {
+    expect(createColorFromKelvin(500)).toBe(createColorFromKelvin(1000));
+  });
+
+  it('clamps inputs above 40000 K to 40000 K', () => {
+    expect(createColorFromKelvin(50000)).toBe(createColorFromKelvin(40000));
+  });
+
+  it('returns a valid packed RGBA integer (unsigned 32-bit)', () => {
+    const color = createColorFromKelvin(5500);
+    expect(color).toBeGreaterThanOrEqual(0);
+    expect(color).toBeLessThanOrEqual(0xffffffff);
+    // Must be an integer.
+    expect(color % 1).toBe(0);
+  });
+});

package/src/hslColor.test.ts

@@ -0,0 +1,67 @@
+import { createHslColor, hslToRgb, rgbToHsl } from './hslColor';
+
+describe('createHslColor', () => {
+  it('allocates a zeroed three-component HSL color', () => {
+    expect(createHslColor()).toEqual([0, 0, 0]);
+  });
+});
+
+describe('hslToRgb', () => {
+  it('produces achromatic RGB for saturation = 0', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 1];
+    hslToRgb(out, 0, 0, 0.5);
+    expect(out[0]).toBeCloseTo(0.5);
+    expect(out[1]).toBeCloseTo(0.5);
+    expect(out[2]).toBeCloseTo(0.5);
+  });
+  it('round-trips with rgbToHsl for a primary color', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 1];
+    hslToRgb(out, 0, 1, 0.5);
+    expect(out[0]).toBeCloseTo(1, 5);
+    expect(out[1]).toBeCloseTo(0, 5);
+    expect(out[2]).toBeCloseTo(0, 5);
+  });
+  it('does not modify out[3] (alpha)', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 0.75];
+    hslToRgb(out, 120, 1, 0.5);
+    expect(out[3]).toBe(0.75);
+  });
+});
+
+describe('rgbToHsl', () => {
+  it('converts pure red to hue=0, s=1, l=0.5', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    rgbToHsl(out, 0xff0000ff);
+    expect(out[0]).toBeCloseTo(0, 3);
+    expect(out[1]).toBeCloseTo(1, 5);
+    expect(out[2]).toBeCloseTo(0.5, 5);
+  });
+  it('converts white to hue=0, s=0, l=1', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    rgbToHsl(out, 0xffffffff);
+    expect(out[0]).toBe(0);
+    expect(out[1]).toBe(0);
+    expect(out[2]).toBeCloseTo(1, 5);
+  });
+  it('converts black to hue=0, s=0, l=0', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    rgbToHsl(out, 0x000000ff);
+    expect(out[0]).toBe(0);
+    expect(out[1]).toBe(0);
+    expect(out[2]).toBeCloseTo(0, 5);
+  });
+  it('returns the out instance', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    expect(rgbToHsl(out, 0xff0000ff)).toBe(out);
+  });
+  it('round-trips with hslToRgb within 1 LSB', () => {
+    const hsl: [number, number, number] = [0, 0, 0];
+    rgbToHsl(hsl, 0x3c8ab5ff);
+    const rgb: [number, number, number, number] = [0, 0, 0, 1];
+    hslToRgb(rgb, hsl[0], hsl[1], hsl[2]);
+    const repacked =
+      (Math.round(rgb[0] * 0xff) << 24) | (Math.round(rgb[1] * 0xff) << 16) | (Math.round(rgb[2] * 0xff) << 8) | 0xff;
+    const orig = 0x3c8ab5ff >>> 0;
+    expect(Math.abs(((repacked >>> 24) & 0xff) - ((orig >>> 24) & 0xff))).toBeLessThanOrEqual(1);
+  });
+});

package/src/hsvColor.test.ts

@@ -0,0 +1,57 @@
+import { createHsvColor, hsvToRgb, rgbToHsv } from './hsvColor';
+
+describe('createHsvColor', () => {
+  it('allocates a zeroed three-component HSV color', () => {
+    expect(createHsvColor()).toEqual([0, 0, 0]);
+  });
+});
+
+describe('hsvToRgb', () => {
+  it('produces achromatic RGB for saturation = 0', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 1];
+    hsvToRgb(out, 0, 0, 0.6);
+    expect(out[0]).toBeCloseTo(0.6);
+    expect(out[1]).toBeCloseTo(0.6);
+    expect(out[2]).toBeCloseTo(0.6);
+  });
+  it('produces pure red for h=0, s=1, v=1', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 1];
+    hsvToRgb(out, 0, 1, 1);
+    expect(out[0]).toBeCloseTo(1, 5);
+    expect(out[1]).toBeCloseTo(0, 5);
+    expect(out[2]).toBeCloseTo(0, 5);
+  });
+  it('round-trips with rgbToHsv for a pure green', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 1];
+    hsvToRgb(out, 120, 1, 1);
+    expect(out[0]).toBeCloseTo(0, 5);
+    expect(out[1]).toBeCloseTo(1, 5);
+    expect(out[2]).toBeCloseTo(0, 5);
+  });
+});
+
+describe('rgbToHsv', () => {
+  it('converts pure red to hue=0, s=1, v=1', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    rgbToHsv(out, 0xff0000ff);
+    expect(out[0]).toBeCloseTo(0, 3);
+    expect(out[1]).toBeCloseTo(1, 5);
+    expect(out[2]).toBeCloseTo(1, 5);
+  });
+  it('converts black to s=0, v=0', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    rgbToHsv(out, 0x000000ff);
+    expect(out[1]).toBe(0);
+    expect(out[2]).toBeCloseTo(0, 5);
+  });
+  it('converts white to s=0, v=1', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    rgbToHsv(out, 0xffffffff);
+    expect(out[1]).toBe(0);
+    expect(out[2]).toBeCloseTo(1, 5);
+  });
+  it('returns the out instance', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    expect(rgbToHsv(out, 0xff0000ff)).toBe(out);
+  });
+});

package/src/lerpColor.test.ts

@@ -0,0 +1,53 @@
+import { lerpColor, lerpLinearColor } from './lerpColor';
+import { createLinearColor } from './packColor';
+
+describe('lerpColor', () => {
+  it('returns start at t=0', () => {
+    expect(lerpColor(0xff0000ff, 0x0000ffff, 0)).toBe(0xff0000ff);
+  });
+  it('returns end at t=1', () => {
+    expect(lerpColor(0xff0000ff, 0x0000ffff, 1)).toBe(0x0000ffff);
+  });
+  it('clamps t below 0 to 0', () => {
+    expect(lerpColor(0xff0000ff, 0x0000ffff, -1)).toBe(0xff0000ff);
+  });
+  it('clamps t above 1 to 1', () => {
+    expect(lerpColor(0xff0000ff, 0x0000ffff, 2)).toBe(0x0000ffff);
+  });
+  it('midpoint between black and white is approximately mid-gray', () => {
+    const mid = lerpColor(0x000000ff, 0xffffffff, 0.5);
+    const r = (mid >>> 24) & 0xff;
+    expect(r).toBeCloseTo(0xbc, -1);
+  });
+});
+
+describe('lerpLinearColor', () => {
+  it('returns start at t=0', () => {
+    const out = createLinearColor();
+    const start: [number, number, number, number] = [1, 0, 0, 1];
+    const end: [number, number, number, number] = [0, 0, 1, 1];
+    lerpLinearColor(out, start, end, 0);
+    expect(out).toEqual(start);
+  });
+  it('returns end at t=1', () => {
+    const out = createLinearColor();
+    const start: [number, number, number, number] = [1, 0, 0, 1];
+    const end: [number, number, number, number] = [0, 0, 1, 1];
+    lerpLinearColor(out, start, end, 1);
+    expect(out).toEqual(end);
+  });
+  it('is alias-safe when out is the same object as start', () => {
+    const start: [number, number, number, number] = [1, 0, 0, 1];
+    const end: [number, number, number, number] = [0, 0, 1, 1];
+    const out = start;
+    lerpLinearColor(out, out, end, 0.5);
+    expect(out[0]).toBeCloseTo(0.5, 8);
+    expect(out[2]).toBeCloseTo(0.5, 8);
+  });
+  it('returns the out instance', () => {
+    const out = createLinearColor();
+    const start: [number, number, number, number] = [0, 0, 0, 0];
+    const end: [number, number, number, number] = [1, 1, 1, 1];
+    expect(lerpLinearColor(out, start, end, 0.5)).toBe(out);
+  });
+});

package/src/luminance.test.ts

@@ -0,0 +1,53 @@
+import {
+  getColorContrastRatio,
+  getColorLuminance,
+  getRec2020LuminanceWeights,
+  getRec709LuminanceWeights,
+} from './luminance';
+
+describe('getColorContrastRatio', () => {
+  it('returns 21 for black on white', () => {
+    expect(getColorContrastRatio(0xffffffff, 0x000000ff)).toBeCloseTo(21, 0);
+  });
+  it('returns 1 for identical colors', () => {
+    expect(getColorContrastRatio(0x808080ff, 0x808080ff)).toBeCloseTo(1, 3);
+  });
+  it('is symmetric — order of arguments does not matter', () => {
+    const ratio1 = getColorContrastRatio(0xffffffff, 0x808080ff);
+    const ratio2 = getColorContrastRatio(0x808080ff, 0xffffffff);
+    expect(ratio1).toBeCloseTo(ratio2, 8);
+  });
+});
+
+describe('getColorLuminance', () => {
+  it('returns 1 for white', () => {
+    expect(getColorLuminance(0xffffffff)).toBeCloseTo(1, 5);
+  });
+  it('returns 0 for black', () => {
+    expect(getColorLuminance(0x000000ff)).toBeCloseTo(0, 5);
+  });
+  it('ignores the alpha channel', () => {
+    expect(getColorLuminance(0xffffffff)).toBe(getColorLuminance(0xffffff00));
+  });
+  it('matches expected Rec. 709 value for mid-gray sRGB', () => {
+    expect(getColorLuminance(0x808080ff)).toBeCloseTo(0.21586, 4);
+  });
+});
+
+describe('getRec2020LuminanceWeights', () => {
+  it('writes the ITU-R BT.2020 weights that sum to 1', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    getRec2020LuminanceWeights(out);
+    expect(out).toEqual([0.2627, 0.678, 0.0593]);
+    expect(out[0] + out[1] + out[2]).toBeCloseTo(1, 8);
+  });
+});
+
+describe('getRec709LuminanceWeights', () => {
+  it('writes the ITU-R BT.709 weights that sum to 1', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    getRec709LuminanceWeights(out);
+    expect(out).toEqual([0.2126, 0.7152, 0.0722]);
+    expect(out[0] + out[1] + out[2]).toBeCloseTo(1, 8);
+  });
+});

package/src/oklab.test.ts

@@ -0,0 +1,35 @@
+import { linearRgbToOklab, oklabToLinearRgb } from './oklab';
+
+describe('linearRgbToOklab', () => {
+  it('maps linear white to L≈1, a≈0, b≈0', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    linearRgbToOklab(out, 1, 1, 1);
+    expect(out[0]).toBeCloseTo(1, 3);
+    expect(out[1]).toBeCloseTo(0, 4);
+    expect(out[2]).toBeCloseTo(0, 4);
+  });
+  it('maps black to the origin', () => {
+    const out: [number, number, number] = [0, 0, 0];
+    linearRgbToOklab(out, 0, 0, 0);
+    expect(out).toEqual([0, 0, 0]);
+  });
+});
+
+describe('oklabToLinearRgb', () => {
+  it('round-trips linear RGB through Oklab for a saturated color', () => {
+    const lab: [number, number, number] = [0, 0, 0];
+    linearRgbToOklab(lab, 0.5, 0.1, 0.8);
+    const rgb: [number, number, number] = [0, 0, 0];
+    oklabToLinearRgb(rgb, lab[0], lab[1], lab[2]);
+    expect(rgb[0]).toBeCloseTo(0.5, 5);
+    expect(rgb[1]).toBeCloseTo(0.1, 5);
+    expect(rgb[2]).toBeCloseTo(0.8, 5);
+  });
+  it('clamps negative linear channels to zero', () => {
+    const rgb: [number, number, number] = [0, 0, 0];
+    oklabToLinearRgb(rgb, 0, 1, 0);
+    expect(rgb[0]).toBeGreaterThanOrEqual(0);
+    expect(rgb[1]).toBeGreaterThanOrEqual(0);
+    expect(rgb[2]).toBeGreaterThanOrEqual(0);
+  });
+});

package/src/packColor.test.ts

@@ -0,0 +1,159 @@
+import {
+  computeRgbHexString,
+  createLinearColor,
+  getColorAlpha,
+  getColorRgb,
+  packColor,
+  packLinearToColor,
+  packOpaqueColor,
+  setColorAlpha,
+  unpackColorRgba,
+  unpackColorToLinear,
+} from './packColor';
+
+describe('computeRgbHexString', () => {
+  it('returns a 6-digit hex string of the lower 24 bits', () => {
+    expect(computeRgbHexString(0x00ff0000)).toBe('#ff0000');
+    expect(computeRgbHexString(0x0000ff00)).toBe('#00ff00');
+    expect(computeRgbHexString(0x000000ff)).toBe('#0000ff');
+    expect(computeRgbHexString(0x00000000)).toBe('#000000');
+    expect(computeRgbHexString(0x00ffffff)).toBe('#ffffff');
+  });
+});
+
+describe('createLinearColor', () => {
+  it('allocates a zeroed four-component color', () => {
+    expect(createLinearColor()).toEqual([0, 0, 0, 0]);
+  });
+});
+
+describe('getColorAlpha', () => {
+  it('returns the alpha byte as a float in [0, 1]', () => {
+    expect(getColorAlpha(0x11223344)).toBeCloseTo(0x44 / 0xff);
+    expect(getColorAlpha(0xffffffff)).toBe(1);
+    expect(getColorAlpha(0xabcdef00)).toBe(0);
+  });
+});
+
+describe('getColorRgb', () => {
+  it('drops the alpha byte, returning the 24-bit RGB', () => {
+    expect(getColorRgb(0xff8800ff)).toBe(0xff8800);
+    expect(getColorRgb(0x11223344)).toBe(0x112233);
+  });
+
+  it('round-trips with packOpaqueColor', () => {
+    expect(getColorRgb(packOpaqueColor(0x3366cc))).toBe(0x3366cc);
+  });
+});
+
+describe('packColor', () => {
+  it('packs white components to 0xffffffff', () => {
+    expect(packColor(1, 1, 1, 1)).toBe(0xffffffff);
+  });
+  it('packs black components to 0x000000ff', () => {
+    expect(packColor(0, 0, 0, 1)).toBe(0x000000ff);
+  });
+  it('clamps out-of-range values', () => {
+    expect(packColor(2, -1, 0.5, 1)).toBe(packColor(1, 0, 0.5, 1));
+  });
+});
+
+describe('packLinearToColor', () => {
+  it('is the inverse of unpackColorToLinear for white', () => {
+    const out = createLinearColor();
+    unpackColorToLinear(out, 0xffffffff);
+    expect(packLinearToColor(out)).toBe(0xffffffff);
+  });
+  it('is the inverse of unpackColorToLinear for black (opaque)', () => {
+    const out = createLinearColor();
+    unpackColorToLinear(out, 0x000000ff);
+    expect(packLinearToColor(out)).toBe(0x000000ff);
+  });
+  it('passes alpha through without gamma encoding', () => {
+    const color = 0x000000_80 >>> 0;
+    const out = createLinearColor();
+    unpackColorToLinear(out, color);
+    const repacked = packLinearToColor(out);
+    expect(repacked & 0xff).toBe(0x80);
+  });
+  it('round-trips a mid-gray color within 1 LSB', () => {
+    const color = 0x808080ff >>> 0;
+    const out = createLinearColor();
+    unpackColorToLinear(out, color);
+    const repacked = packLinearToColor(out);
+    const origR = (color >>> 24) & 0xff;
+    const repR = (repacked >>> 24) & 0xff;
+    expect(Math.abs(repR - origR)).toBeLessThanOrEqual(1);
+  });
+});
+
+describe('packOpaqueColor', () => {
+  it('widens 24-bit RGB to 32-bit RGBA with full opacity', () => {
+    expect(packOpaqueColor(0x336699)).toBe(0x336699ff);
+    expect(packOpaqueColor(0x000000)).toBe(0x000000ff);
+    expect(packOpaqueColor(0xffffff)).toBe(0xffffffff);
+  });
+
+  it('masks off bits above 24 (ignores any alpha in the input)', () => {
+    expect(packOpaqueColor(0xaa336699)).toBe(0x336699ff);
+  });
+
+  it('returns an unsigned 32-bit integer', () => {
+    expect(packOpaqueColor(0xffffff)).toBeGreaterThan(0);
+  });
+});
+
+describe('setColorAlpha', () => {
+  it('replaces the alpha byte from a float in [0, 1], leaving RGB intact', () => {
+    expect(setColorAlpha(0xff8800ff, 0)).toBe(0xff880000);
+    expect(setColorAlpha(0xff880000, 1)).toBe(0xff8800ff);
+  });
+
+  it('clamps and rounds to 8 bits', () => {
+    expect(setColorAlpha(0x112233ff, 2)).toBe(0x112233ff);
+    expect(getColorAlpha(setColorAlpha(0x112233ff, 0.5))).toBeCloseTo(0.5, 2);
+  });
+});
+
+describe('unpackColorRgba', () => {
+  it('extracts white as all-ones', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 0];
+    unpackColorRgba(out, 0xffffffff);
+    expect(out[0]).toBeCloseTo(1, 5);
+    expect(out[1]).toBeCloseTo(1, 5);
+    expect(out[2]).toBeCloseTo(1, 5);
+    expect(out[3]).toBeCloseTo(1, 5);
+  });
+  it('does NOT gamma-decode — mid sRGB stays above the linear midpoint', () => {
+    const out: [number, number, number, number] = [0, 0, 0, 0];
+    unpackColorRgba(out, 0x808080ff);
+    expect(out[0]).toBeCloseTo(0x80 / 0xff, 4);
+  });
+});
+
+describe('unpackColorToLinear', () => {
+  it('decodes white and black exactly at the endpoints', () => {
+    const out = createLinearColor();
+    expect(unpackColorToLinear(out, 0xffffffff)).toEqual([1, 1, 1, 1]);
+    expect(unpackColorToLinear(out, 0x000000ff)).toEqual([0, 0, 0, 1]);
+  });
+
+  it('passes alpha through linearly without gamma decode', () => {
+    const out = createLinearColor();
+    unpackColorToLinear(out, 0x00000080);
+    expect(out[3]).toBeCloseTo(0x80 / 0xff, 6);
+  });
+
+  it('gamma-decodes RGB so mid sRgb is below the linear midpoint', () => {
+    const out = createLinearColor();
+    unpackColorToLinear(out, 0x808080ff);
+    expect(out[0]).toBeCloseTo(0.21586, 4);
+    expect(out[0]).toBe(out[1]);
+    expect(out[1]).toBe(out[2]);
+  });
+
+  it('returns the same out instance it was given', () => {
+    const out = createLinearColor();
+    expect(unpackColorToLinear(out, 0xff0000ff)).toBe(out);
+  });
+});

package/src/premultiplyColorAlpha.test.ts

@@ -0,0 +1,36 @@
+import { premultiplyColorAlpha, unpremultiplyColorAlpha } from './premultiplyColorAlpha';
+
+describe('premultiplyColorAlpha', () => {
+  it('returns fully-opaque color unchanged (alpha=1)', () => {
+    expect(premultiplyColorAlpha(0xff0000ff)).toBe(0xff0000ff);
+  });
+  it('multiplies RGB by alpha and preserves the alpha channel', () => {
+    const result = premultiplyColorAlpha(0xff00007f);
+    expect((result >>> 24) & 0xff).toBeCloseTo(0x7f, -1);
+    expect(result & 0xff).toBe(0x7f);
+  });
+  it('returns black-with-alpha-0 for fully transparent color', () => {
+    const result = premultiplyColorAlpha(0xff000000);
+    expect(result & 0xff).toBe(0);
+    expect((result >>> 24) & 0xff).toBe(0);
+  });
+  it('round-trips with unpremultiplyColorAlpha for fully-opaque', () => {
+    const color = 0xab3456ff;
+    expect(unpremultiplyColorAlpha(premultiplyColorAlpha(color))).toBe(color);
+  });
+});
+
+describe('unpremultiplyColorAlpha', () => {
+  it('returns fully-opaque color unchanged', () => {
+    expect(unpremultiplyColorAlpha(0xff0000ff)).toBe(0xff0000ff);
+  });
+  it('divides RGB by alpha and preserves the alpha channel', () => {
+    const premul = premultiplyColorAlpha((0xff0000ff & (0xffffff80 >>> 0)) | 0x80);
+    const result = unpremultiplyColorAlpha(premul);
+    expect(result & 0xff).toBe(0x80);
+  });
+  it('returns the input unchanged for alpha=0', () => {
+    const color = 0xff000000;
+    expect(unpremultiplyColorAlpha(color)).toBe(color);
+  });
+});

package/src/srgbTransfer.test.ts

@@ -0,0 +1,30 @@
+import { linearChannelToSrgb, srgbChannelToLinear } from './srgbTransfer';
+
+describe('linearChannelToSrgb', () => {
+  it('maps 0 → 0', () => {
+    expect(linearChannelToSrgb(0)).toBe(0);
+  });
+  it('maps 1 → 1', () => {
+    expect(linearChannelToSrgb(1)).toBeCloseTo(1, 8);
+  });
+  it('is the inverse of the sRGB decode for a round-trip', () => {
+    const linear = 0.5;
+    const srgb = linearChannelToSrgb(linear);
+    expect(srgbChannelToLinear(srgb)).toBeCloseTo(linear, 8);
+  });
+});
+
+describe('srgbChannelToLinear', () => {
+  it('maps 0 → 0 and 1 → 1', () => {
+    expect(srgbChannelToLinear(0)).toBe(0);
+    expect(srgbChannelToLinear(1)).toBeCloseTo(1, 8);
+  });
+  it('decodes mid sRGB below the linear midpoint', () => {
+    // 0x80/0xff ≈ 0.502 sRGB → linear ≈ 0.21586.
+    expect(srgbChannelToLinear(0x80 / 0xff)).toBeCloseTo(0.21586, 5);
+  });
+  it('round-trips with linearChannelToSrgb', () => {
+    const srgb = 0.25;
+    expect(linearChannelToSrgb(srgbChannelToLinear(srgb))).toBeCloseTo(srgb, 8);
+  });
+});