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

package/dist/customShaderMaterial.d.ts

@@ -0,0 +1,3 @@
+import type { CustomShaderMaterial } from '@flighthq/types';
+export declare function createCustomShaderMaterial(opts?: Readonly<Partial<CustomShaderMaterial>>): CustomShaderMaterial;
+//# sourceMappingURL=customShaderMaterial.d.ts.map

package/dist/customShaderMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customShaderMaterial.d.ts","sourceRoot":"","sources":["../src/customShaderMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAU5D,wBAAgB,0BAA0B,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,GAAG,oBAAoB,CAM/G"}

package/dist/customShaderMaterial.js

@@ -0,0 +1,15 @@
+import { CustomShaderMaterialKind } from '@flighthq/types';
+import { createSurfaceMaterial } from './surfaceMaterial';
+// User-authored shader material. `shaderKey` references a vertex+fragment pair registered on
+// the render state (registerGlCustomMaterialShader); `uniforms` carries flat scalar/vector
+// values; `textures` carries named texture bindings. All default to their sentinel (empty key,
+// null bags) so a bare createCustomShaderMaterial() is structurally valid for tests and
+// serialization even before a shader key is assigned.
+export function createCustomShaderMaterial(opts) {
+    const material = createSurfaceMaterial(CustomShaderMaterialKind);
+    material.shaderKey = opts?.shaderKey ?? '';
+    material.textures = opts?.textures ?? null;
+    material.uniforms = opts?.uniforms ?? null;
+    return material;
+}
+//# sourceMappingURL=customShaderMaterial.js.map

package/dist/customShaderMaterial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customShaderMaterial.js","sourceRoot":"","sources":["../src/customShaderMaterial.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,6FAA6F;AAC7F,2FAA2F;AAC3F,+FAA+F;AAC/F,wFAAwF;AACxF,sDAAsD;AACtD,MAAM,UAAU,0BAA0B,CAAC,IAA8C;IACvF,MAAM,QAAQ,GAAG,qBAAqB,CAAC,wBAAwB,CAAyB,CAAC;IACzF,QAAQ,CAAC,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC3C,QAAQ,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 export * from './classicMaterials';
-export * from './color';
 export * from './colorTransform';
+export * from './customShaderMaterial';
 export * from './material';
 export * from './materialPresets';
 export * from './materialValidation';
 export * from './pbrExtensionMaterials';
 export * from './pbrMaterials';
+export * from './phongToPbr';
 export * from './surfaceMaterial';
 export * from './unlitMaterials';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,11 +1,12 @@
 export * from './classicMaterials';
-export * from './color';
 export * from './colorTransform';
+export * from './customShaderMaterial';
 export * from './material';
 export * from './materialPresets';
 export * from './materialValidation';
 export * from './pbrExtensionMaterials';
 export * from './pbrMaterials';
+export * from './phongToPbr';
 export * from './surfaceMaterial';
 export * from './unlitMaterials';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/material.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../src/material.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAItD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAIlE;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAG5E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAEnD;AAKD,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAUpF"}
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../src/material.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAItD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAIlE;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAG5E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAInD;AAKD,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAUpF"}

package/dist/material.js

@@ -14,7 +14,9 @@ export function copyMaterial(out, source) {
     copyMaterialFields(out, source, source.kind);
 }
 export function createMaterial(kind) {
-    return createEntity({ kind });
+    const material = createEntity({ kind });
+    material.name = null;
+    return material;
 }
 // Structural equality for dedup, pooling, and serialization round-trips — NOT the batch
 // flush path (batching keys on material by reference). Compares own enumerable data fields

package/dist/material.js.map

@@ -1 +1 @@
-{"version":3,"file":"material.js","sourceRoot":"","sources":["../src/material.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wFAAwF;AACxF,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAa,CAAC;IAC9D,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wFAAwF;AACxF,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,GAAa,EAAE,MAA0B;IACpE,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO;IAC3B,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,wFAAwF;AACxF,2FAA2F;AAC3F,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,CAAqB,EAAE,CAAqB;IACzE,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,OAAO,GAAG,CAAuC,CAAC;IACxD,MAAM,OAAO,GAAG,CAAuC,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,GAAG,KAAK,MAAM;YAAE,SAAS;QAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,4FAA4F;AAC5F,wDAAwD;AACxD,SAAS,kBAAkB,CAAC,GAAa,EAAE,GAAuB,EAAE,IAAU;IAC5E,MAAM,SAAS,GAAG,GAAyC,CAAC;IAC5D,MAAM,SAAS,GAAG,GAAyC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,GAAG,KAAK,MAAM;YAAE,SAAS;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,UAAU,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrE,uFAAuF;YACvF,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,GAAI,KAAgB,EAAE,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,iFAAiF;IACjF,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"material.js","sourceRoot":"","sources":["../src/material.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,wFAAwF;AACxF,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAa,CAAC;IAC9D,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wFAAwF;AACxF,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,GAAa,EAAE,MAA0B;IACpE,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO;IAC3B,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,CAAa,CAAC;IACpD,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,wFAAwF;AACxF,2FAA2F;AAC3F,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,CAAqB,EAAE,CAAqB;IACzE,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,OAAO,GAAG,CAAuC,CAAC;IACxD,MAAM,OAAO,GAAG,CAAuC,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,GAAG,KAAK,MAAM;YAAE,SAAS;QAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,4FAA4F;AAC5F,wDAAwD;AACxD,SAAS,kBAAkB,CAAC,GAAa,EAAE,GAAuB,EAAE,IAAU;IAC5E,MAAM,SAAS,GAAG,GAAyC,CAAC;IAC5D,MAAM,SAAS,GAAG,GAAyC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,GAAG,KAAK,MAAM;YAAE,SAAS;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,UAAU,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrE,uFAAuF;YACvF,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,GAAI,KAAgB,EAAE,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,iFAAiF;IACjF,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAC3B,CAAC"}

package/dist/pbrMaterials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pbrMaterials.d.ts","sourceRoot":"","sources":["../src/pbrMaterials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AAkBzB,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,6BAA6B,EAClC,MAAM,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAC9C,IAAI,CAmDN;AAKD,wBAAgB,mCAAmC,CACjD,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GACtD,6BAA6B,CAe/B;AAKD,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,mBAAmB,CAI5G;AAKD,wBAAgB,mCAAmC,CACjD,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GACtD,6BAA6B,CAI/B"}
+{"version":3,"file":"pbrMaterials.d.ts","sourceRoot":"","sources":["../src/pbrMaterials.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,6BAA6B,EAC7B,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AAiBzB,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,6BAA6B,EAClC,MAAM,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAC9C,IAAI,CAmDN;AAKD,wBAAgB,mCAAmC,CACjD,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GACtD,6BAA6B,CAe/B;AAKD,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,mBAAmB,CAI5G;AAKD,wBAAgB,mCAAmC,CACjD,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GACtD,6BAA6B,CAI/B"}

package/dist/pbrMaterials.js

@@ -1,5 +1,5 @@
+import { unpackColorToLinear } from '@flighthq/color';
 import { SpecularGlossinessPbrMaterialKind, StandardPbrMaterialKind } from '@flighthq/types';
-import { unpackColorToLinear } from './color';
 import { createSurfaceMaterial } from './surfaceMaterial';
 // Converts a legacy specular-glossiness material to a metallic-roughness property block.
 // Writes `out` with the computed base-color, metallic, and roughness values. The conversion

package/dist/pbrMaterials.js.map

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

package/dist/phongToPbr.d.ts

@@ -0,0 +1,6 @@
+import type { PhongMaterial, StandardPbrMaterial, StandardPbrMaterialProperties } from '@flighthq/types';
+export declare function convertPhongToStandardPbrMaterial(phong: Readonly<PhongMaterial>, opts?: Readonly<Partial<StandardPbrMaterialProperties>>): StandardPbrMaterial;
+export declare function getPbrMetallicFromPhongSpecular(specular: number, diffuse: number): number;
+export declare function getPbrRoughnessFromPhongShininess(shininess: number): number;
+export declare function getPhongToPbrLightExposure(): number;
+//# sourceMappingURL=phongToPbr.d.ts.map

package/dist/phongToPbr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phongToPbr.d.ts","sourceRoot":"","sources":["../src/phongToPbr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAezG,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC9B,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GACtD,mBAAmB,CAUrB;AAMD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzF;AAKD,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AAcD,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD"}

package/dist/phongToPbr.js

@@ -0,0 +1,53 @@
+import { getColorLuminance } from '@flighthq/color';
+import { createStandardPbrMaterial } from './pbrMaterials';
+// Migrates a classic `PhongMaterial` to a metallic-roughness `StandardPbrMaterial` whose surface
+// reads equivalently. A reference (not exact) mapping: the Phong reflection-vector lobe and the
+// GGX microfacet lobe cannot match at every angle, so this preserves overall appearance —
+// base color, gloss, and brightness — rather than per-highlight shape. `opts` overrides any mapped
+// field (e.g. to force `metallic`). Diffuse and baseColor share the packed sRgb-albedo encoding,
+// so the color transfers unchanged; the renderer decodes both identically.
+//
+// IMPORTANT — brightness: the metallic-roughness diffuse term divides albedo by π that classic
+// Phong does not (see `getPhongToPbrLightExposure`). The material alone cannot compensate a
+// per-light normalization, so scale the scene's light intensity by that exposure or a migrated
+// scene renders ~π× (≈3.2×) too dark.
+export function convertPhongToStandardPbrMaterial(phong, opts) {
+    return createStandardPbrMaterial({
+        baseColor: phong.diffuse,
+        baseColorMap: phong.diffuseMap,
+        metallic: getPbrMetallicFromPhongSpecular(phong.specular, phong.diffuse),
+        normalMap: phong.normalMap,
+        normalScale: phong.normalScale,
+        roughness: getPbrRoughnessFromPhongShininess(phong.shininess),
+        ...opts,
+    });
+}
+// Reference metallic guess from a Phong specular/diffuse pair. Phong does not encode metalness, so
+// this is conservative: dielectric (0) unless a strong specular sits over a near-black diffuse — the
+// only Phong configuration that reads unambiguously metallic. Callers that know the material is
+// metal should pass `metallic` through `convertPhongToStandardPbrMaterial`'s `opts` instead.
+export function getPbrMetallicFromPhongSpecular(specular, diffuse) {
+    return getColorLuminance(specular) > 0.5 && getColorLuminance(diffuse) < 0.04 ? 1 : 0;
+}
+// Maps a Blinn-Phong specular exponent to a GGX roughness via `sqrt(2 / (shininess + 2))`, clamped
+// to [0, 1]. Monotonic: higher shininess (sharper highlight) → lower roughness (smoother surface).
+// The Phong default shininess of 32 maps to roughness ≈ 0.243.
+export function getPbrRoughnessFromPhongShininess(shininess) {
+    return Math.min(1, Math.max(0, Math.sqrt(2 / (Math.max(0, shininess) + 2))));
+}
+// The exposure (in EV) to apply to a scene's lights when migrating classic-Phong materials to
+// metallic-roughness PBR, so brightness is preserved under the same lights. The PBR diffuse BRDF
+// divides albedo by π for energy conservation while classic Phong does not, so PBR diffuse is ~1/π
+// as bright for equal light radiance. This returns `log2(π)` (≈ 1.651 EV) — i.e. a ×π scale —
+// applied via `applyLightExposure(intensity, getPhongToPbrLightExposure())` from `@flighthq/lighting`.
+// Skipping it is the classic "ported scene is far too dark" failure.
+//
+// Assumed input, so it is applied exactly ONCE: light intensities already in Flight's LINEAR-radiance
+// Phong convention. This is the single Phong→PBR energy step; it is NOT a general "engine porting"
+// scale. Porting from a foreign engine whose lights are in a different space (e.g. a gamma-space LDR
+// source) is a separate, earlier conversion into Flight's linear Phong convention that belongs in the
+// importer, not here — do not fold that engine's own boost into this π, and do not apply this twice.
+export function getPhongToPbrLightExposure() {
+    return Math.log2(Math.PI);
+}
+//# sourceMappingURL=phongToPbr.js.map

package/dist/phongToPbr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phongToPbr.js","sourceRoot":"","sources":["../src/phongToPbr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,iGAAiG;AACjG,gGAAgG;AAChG,0FAA0F;AAC1F,mGAAmG;AACnG,iGAAiG;AACjG,2EAA2E;AAC3E,EAAE;AACF,+FAA+F;AAC/F,4FAA4F;AAC5F,+FAA+F;AAC/F,sCAAsC;AACtC,MAAM,UAAU,iCAAiC,CAC/C,KAA8B,EAC9B,IAAuD;IAEvD,OAAO,yBAAyB,CAAC;QAC/B,SAAS,EAAE,KAAK,CAAC,OAAO;QACxB,YAAY,EAAE,KAAK,CAAC,UAAU;QAC9B,QAAQ,EAAE,+BAA+B,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;QACxE,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,iCAAiC,CAAC,KAAK,CAAC,SAAS,CAAC;QAC7D,GAAG,IAAI;KACR,CAAC,CAAC;AACL,CAAC;AAED,mGAAmG;AACnG,qGAAqG;AACrG,gGAAgG;AAChG,6FAA6F;AAC7F,MAAM,UAAU,+BAA+B,CAAC,QAAgB,EAAE,OAAe;IAC/E,OAAO,iBAAiB,CAAC,QAAQ,CAAC,GAAG,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,mGAAmG;AACnG,mGAAmG;AACnG,+DAA+D;AAC/D,MAAM,UAAU,iCAAiC,CAAC,SAAiB;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,8FAA8F;AAC9F,iGAAiG;AACjG,mGAAmG;AACnG,8FAA8F;AAC9F,uGAAuG;AACvG,qEAAqE;AACrE,EAAE;AACF,sGAAsG;AACtG,mGAAmG;AACnG,qGAAqG;AACrG,sGAAsG;AACtG,qGAAqG;AACrG,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC"}

package/dist/unlitMaterials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unlitMaterials.d.ts","sourceRoot":"","sources":["../src/unlitMaterials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAgBzB,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,CAK1F;AAID,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,gBAAgB,CAMnG;AAID,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAK7F;AAGD,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAK7F;AAID,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,YAAY,CAOvF;AAID,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,CAK1F;AAGD,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,mBAAmB,CAI5G;AAGD,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,iBAAiB,CAKtG"}
+{"version":3,"file":"unlitMaterials.d.ts","sourceRoot":"","sources":["../src/unlitMaterials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAgBzB,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,CAK1F;AAID,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,gBAAgB,CAMnG;AAID,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAK7F;AAGD,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAK7F;AAID,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,YAAY,CAOvF;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,CAM1F;AAGD,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,mBAAmB,CAI5G;AAGD,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,iBAAiB,CAKtG"}

package/dist/unlitMaterials.js

@@ -42,12 +42,14 @@ export function createToonMaterial(opts) {
     material.steps = opts?.steps ?? 3;
     return material;
 }
-// Lighting-independent flat-color material. `baseColor` defaults to white, `baseColorMap` to
-// null. Full fidelity on every backend including Canvas2D.
+// Lighting-independent flat-color material. `baseColor` defaults to white, `baseColorMap` and
+// `baseColorVideoMap` to null. Full fidelity on every backend including Canvas2D; a bound
+// `baseColorVideoMap` (live video stream) is sampled only on the GL backend today.
 export function createUnlitMaterial(opts) {
     const material = createSurfaceMaterial(UnlitMaterialKind);
     material.baseColor = opts?.baseColor ?? 0xffffffff;
     material.baseColorMap = opts?.baseColorMap ?? null;
+    material.baseColorVideoMap = opts?.baseColorVideoMap ?? null;
     return material;
 }
 // Uses the mesh's `color0` vertex attribute as unlit surface color. `tint` defaults to white.

package/dist/unlitMaterials.js.map

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

package/package.json

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

package/src/colorTransform.test.ts

@@ -67,15 +67,72 @@ describe('concatColorTransform', () => {
     expect(out.redOffset).toBe(2 * 5 + 10);
   });
 
-  it('can write result into one of the inputs', () => {
-    const a = createColorTransform({ redMultiplier: 2, redOffset: 10 });
-    const b = createColorTransform({ redMultiplier: 3, redOffset: 5 });
-    const out = createColorTransform();
-    concatColorTransform(out, a, b);
-    const expectedMultiplier = 6;
-    const expectedOffset = 2 * 5 + 10;
-    expect(out.redMultiplier).toBe(expectedMultiplier);
-    expect(out.redOffset).toBe(expectedOffset);
+  it('produces correct result when out aliases source', () => {
+    const a = createColorTransform({
+      redMultiplier: 2,
+      greenMultiplier: 0.5,
+      blueMultiplier: 3,
+      alphaMultiplier: 0.25,
+      redOffset: 10,
+      greenOffset: 20,
+      blueOffset: 30,
+      alphaOffset: 40,
+    });
+    const b = createColorTransform({
+      redMultiplier: 3,
+      greenMultiplier: 4,
+      blueMultiplier: 0.5,
+      alphaMultiplier: 2,
+      redOffset: 5,
+      greenOffset: 15,
+      blueOffset: 25,
+      alphaOffset: 35,
+    });
+    const ref = createColorTransform();
+    concatColorTransform(ref, a, b);
+    concatColorTransform(a, a, b);
+    expect(a.redMultiplier).toBe(ref.redMultiplier);
+    expect(a.greenMultiplier).toBe(ref.greenMultiplier);
+    expect(a.blueMultiplier).toBe(ref.blueMultiplier);
+    expect(a.alphaMultiplier).toBe(ref.alphaMultiplier);
+    expect(a.redOffset).toBe(ref.redOffset);
+    expect(a.greenOffset).toBe(ref.greenOffset);
+    expect(a.blueOffset).toBe(ref.blueOffset);
+    expect(a.alphaOffset).toBe(ref.alphaOffset);
+  });
+
+  it('produces correct result when out aliases other', () => {
+    const a = createColorTransform({
+      redMultiplier: 2,
+      greenMultiplier: 0.5,
+      blueMultiplier: 3,
+      alphaMultiplier: 0.25,
+      redOffset: 10,
+      greenOffset: 20,
+      blueOffset: 30,
+      alphaOffset: 40,
+    });
+    const b = createColorTransform({
+      redMultiplier: 3,
+      greenMultiplier: 4,
+      blueMultiplier: 0.5,
+      alphaMultiplier: 2,
+      redOffset: 5,
+      greenOffset: 15,
+      blueOffset: 25,
+      alphaOffset: 35,
+    });
+    const ref = createColorTransform();
+    concatColorTransform(ref, a, b);
+    concatColorTransform(b, a, b);
+    expect(b.redMultiplier).toBe(ref.redMultiplier);
+    expect(b.greenMultiplier).toBe(ref.greenMultiplier);
+    expect(b.blueMultiplier).toBe(ref.blueMultiplier);
+    expect(b.alphaMultiplier).toBe(ref.alphaMultiplier);
+    expect(b.redOffset).toBe(ref.redOffset);
+    expect(b.greenOffset).toBe(ref.greenOffset);
+    expect(b.blueOffset).toBe(ref.blueOffset);
+    expect(b.alphaOffset).toBe(ref.alphaOffset);
   });
 });
 

package/src/customShaderMaterial.test.ts

@@ -0,0 +1,20 @@
+import { CustomShaderMaterialKind } from '@flighthq/types';
+
+import { createCustomShaderMaterial } from './customShaderMaterial';
+
+describe('createCustomShaderMaterial', () => {
+  it('creates a custom shader material with default sentinel values', () => {
+    const material = createCustomShaderMaterial();
+    expect(material.kind).toBe(CustomShaderMaterialKind);
+    expect(material.shaderKey).toBe('');
+    expect(material.uniforms).toBeNull();
+    expect(material.textures).toBeNull();
+  });
+
+  it('applies overrides', () => {
+    const uniforms = { u_time: 1.5, u_scale: [2, 3] };
+    const material = createCustomShaderMaterial({ shaderKey: 'myShader', uniforms });
+    expect(material.shaderKey).toBe('myShader');
+    expect(material.uniforms).toBe(uniforms);
+  });
+});

package/src/material.test.ts

@@ -27,6 +27,11 @@ describe('cloneMaterial', () => {
     const clone = cloneMaterial(original);
     expect(equalsMaterial(original, clone)).toBe(true);
   });
+  it('carries the authored name onto the clone', () => {
+    const original = createMaterial(TestMaterialKind);
+    original.name = 'canopy';
+    expect(cloneMaterial(original).name).toBe('canopy');
+  });
 });
 
 describe('copyMaterial', () => {
@@ -50,6 +55,10 @@ describe('createMaterial', () => {
     const material = createMaterial(TestMaterialKind);
     expect(material.kind).toBe(TestMaterialKind);
   });
+
+  it('defaults the authored name to null', () => {
+    expect(createMaterial(TestMaterialKind).name).toBeNull();
+  });
 });
 
 describe('equalsMaterial', () => {

package/src/phongToPbr.test.ts

@@ -0,0 +1,67 @@
+import { StandardPbrMaterialKind } from '@flighthq/types';
+
+import { createPhongMaterial } from './classicMaterials';
+import {
+  convertPhongToStandardPbrMaterial,
+  getPbrMetallicFromPhongSpecular,
+  getPbrRoughnessFromPhongShininess,
+  getPhongToPbrLightExposure,
+} from './phongToPbr';
+
+describe('convertPhongToStandardPbrMaterial', () => {
+  it('maps a neutral Phong material to a plausible PBR material', () => {
+    const phong = createPhongMaterial();
+    const pbr = convertPhongToStandardPbrMaterial(phong);
+    expect(pbr.kind).toBe(StandardPbrMaterialKind);
+    // Diffuse and baseColor share the packed sRgb-albedo encoding — color transfers unchanged.
+    expect(pbr.baseColor).toBe(phong.diffuse);
+    expect(pbr.roughness).toBeGreaterThan(0);
+    expect(pbr.roughness).toBeLessThan(1);
+    // A white specular over a white diffuse is a dielectric, not a metal.
+    expect(pbr.metallic).toBe(0);
+  });
+  it('preserves the normal map and scale', () => {
+    const phong = createPhongMaterial({ normalScale: 0.5 });
+    const pbr = convertPhongToStandardPbrMaterial(phong);
+    expect(pbr.normalScale).toBe(0.5);
+    expect(pbr.normalMap).toBe(phong.normalMap);
+  });
+  it('lets opts override a mapped field', () => {
+    const phong = createPhongMaterial();
+    const pbr = convertPhongToStandardPbrMaterial(phong, { metallic: 1, roughness: 0.2 });
+    expect(pbr.metallic).toBe(1);
+    expect(pbr.roughness).toBe(0.2);
+  });
+});
+
+describe('getPbrMetallicFromPhongSpecular', () => {
+  it('reads a bright specular over a near-black diffuse as metallic', () => {
+    expect(getPbrMetallicFromPhongSpecular(0xffffffff, 0x000000ff)).toBe(1);
+  });
+  it('reads a white specular over a lit diffuse as dielectric', () => {
+    expect(getPbrMetallicFromPhongSpecular(0xffffffff, 0xffffffff)).toBe(0);
+    expect(getPbrMetallicFromPhongSpecular(0x808080ff, 0x333333ff)).toBe(0);
+  });
+});
+
+describe('getPbrRoughnessFromPhongShininess', () => {
+  it('maps the Phong default shininess of 32 to roughness ≈ 0.243', () => {
+    expect(getPbrRoughnessFromPhongShininess(32)).toBeCloseTo(0.2425, 3);
+  });
+  it('is monotonic decreasing in shininess', () => {
+    expect(getPbrRoughnessFromPhongShininess(2)).toBeGreaterThan(getPbrRoughnessFromPhongShininess(200));
+  });
+  it('clamps to [0, 1] and handles the degenerate shininess of 0', () => {
+    const r = getPbrRoughnessFromPhongShininess(0);
+    expect(r).toBeLessThanOrEqual(1);
+    expect(r).toBeGreaterThanOrEqual(0);
+  });
+});
+
+describe('getPhongToPbrLightExposure', () => {
+  it('returns log2(π) — a ×π light scale that offsets the Lambert 1/π diffuse normalization', () => {
+    expect(getPhongToPbrLightExposure()).toBeCloseTo(Math.log2(Math.PI), 10);
+    // Applying the exposure multiplies intensity by ≈π (≈3.14) — the anti-too-dark factor.
+    expect(2 ** getPhongToPbrLightExposure()).toBeCloseTo(Math.PI, 10);
+  });
+});

package/dist/color.d.ts

@@ -1,24 +0,0 @@
-import type { LinearColor } from '@flighthq/types';
-export type { LinearColor };
-export type HslColor = [number, number, number];
-export type HsvColor = [number, number, number];
-export declare function computeRgbHexString(color: number): string;
-export declare function createHslColor(): HslColor;
-export declare function createHsvColor(): HsvColor;
-export declare function createLinearColor(): LinearColor;
-export declare function getColorContrastRatio(a: number, b: number): number;
-export declare function getColorLuminance(color: number): number;
-export declare function hslToRgb(out: [number, number, number, number], h: number, s: number, l: number): void;
-export declare function hsvToRgb(out: [number, number, number, number], h: number, s: number, v: number): void;
-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;
-export declare function linearChannelToSrgb(value: 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 premultiplyColorAlpha(color: number): number;
-export declare function rgbToHsl(out: HslColor, color: number): HslColor;
-export declare function rgbToHsv(out: HsvColor, color: number): HsvColor;
-export declare function unpackColorRgba(out: [number, number, number, number], color: number): void;
-export declare function unpackColorToLinear(out: LinearColor, color: number): LinearColor;
-export declare function unpremultiplyColorAlpha(color: number): number;
-//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,YAAY,EAAE,WAAW,EAAE,CAAC;AAI5B,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAIhD,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAKhD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAGD,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAGD,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAGD,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAKD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlE;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAMD,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,CAcrG;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;AAMD,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;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;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;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3D;AAMD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CA2B/D;AAKD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAuB/D;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;AAKD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7D"}

package/dist/color.js

@@ -1,291 +0,0 @@
-// 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 `HslColor` for use as an `rgbToHsl` out parameter.
-export function createHslColor() {
-    return [0, 0, 0];
-}
-// Allocates a fresh zeroed `HsvColor` for use as an `rgbToHsv` out parameter.
-export function createHsvColor() {
-    return [0, 0, 0];
-}
-// Allocates a fresh zeroed `LinearColor` for use as an `unpackColorToLinear` out parameter.
-export function createLinearColor() {
-    return [0, 0, 0, 0];
-}
-// 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;
-}
-// Converts a packed sRGB `0xRRGGBBAA` color to HSL. Writes `out[0]` = hue [0, 360),
-// `out[1]` = saturation [0, 1], `out[2]` = lightness [0, 1]. Alpha is ignored.
-// The conversion operates in sRGB (non-linear) space, matching artist-facing color pickers.
-// Returns `out`.
-export function hslToRgb(out, h, s, l) {
-    // h in [0, 360), s and l in [0, 1]. Writes sRGB [0,1] R/G/B to out[0..2]; leaves out[3].
-    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 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;
-    }
-}
-// 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;
-}
-// The IEC 61966-2-1 linear-to-sRGB inverse OETF for a single channel in [0, 1].
-// Exported for callers that need per-channel conversion; the packed form is `packLinearToColor`.
-export function linearChannelToSrgb(value) {
-    return value <= 0.0031308 ? value * 12.92 : 1.055 * value ** (1 / 2.4) - 0.055;
-}
-// 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;
-}
-// 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;
-}
-// 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;
-}
-// 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;
-}
-// 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;
-}
-// 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;
-}
-// 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;
-}
-// The IEC 61966-2-1 sRgb electro-optical transfer function for a single channel in [0, 1].
-function srgbChannelToLinear(value) {
-    return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
-}
-//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/src/color.test.ts

@@ -1,383 +0,0 @@
-import {
-  computeRgbHexString,
-  createHslColor,
-  createHsvColor,
-  createLinearColor,
-  getColorContrastRatio,
-  getColorLuminance,
-  hslToRgb,
-  hsvToRgb,
-  lerpColor,
-  lerpLinearColor,
-  linearChannelToSrgb,
-  packColor,
-  packLinearToColor,
-  premultiplyColorAlpha,
-  rgbToHsl,
-  rgbToHsv,
-  unpackColorRgba,
-  unpackColorToLinear,
-  unpremultiplyColorAlpha,
-} from './color';
-
-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('createHslColor', () => {
-  it('allocates a zeroed three-component HSL color', () => {
-    expect(createHslColor()).toEqual([0, 0, 0]);
-  });
-});
-
-describe('createHsvColor', () => {
-  it('allocates a zeroed three-component HSV color', () => {
-    expect(createHsvColor()).toEqual([0, 0, 0]);
-  });
-});
-
-describe('createLinearColor', () => {
-  it('allocates a zeroed four-component color', () => {
-    expect(createLinearColor()).toEqual([0, 0, 0, 0]);
-  });
-});
-
-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', () => {
-    // sRGB 0x808080 → linear ≈ 0.21586; Rec.709: 0.2126*R + 0.7152*G + 0.0722*B = R (equal channels)
-    expect(getColorLuminance(0x808080ff)).toBeCloseTo(0.21586, 4);
-  });
-});
-
-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', () => {
-    // Red: hue=0, s=1, l=0.5 → RGB (1, 0, 0)
-    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('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('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', () => {
-    // Black (linear 0) and white (linear 1) — midpoint in linear is 0.5, which in sRGB ≈ 0xbc
-    const mid = lerpColor(0x000000ff, 0xffffffff, 0.5);
-    const r = (mid >>> 24) & 0xff;
-    // linear 0.5 → sRGB ≈ 0xbc (188)
-    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);
-  });
-});
-
-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', () => {
-    // A known linear value near the breakpoint.
-    const linear = 0.5;
-    const srgb = linearChannelToSrgb(linear);
-    // Re-encode: sRGB(linear(x)) should round-trip within floating-point tolerance.
-    const roundTrip = srgb <= 0.04045 ? srgb / 12.92 : ((srgb + 0.055) / 1.055) ** 2.4;
-    expect(roundTrip).toBeCloseTo(linear, 5);
-  });
-});
-
-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', () => {
-    // Alpha 0x80 / 0xff ≈ 0.502; should round-trip through linear-space alpha.
-    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('premultiplyColorAlpha', () => {
-  it('returns fully-opaque color unchanged (alpha=1)', () => {
-    expect(premultiplyColorAlpha(0xff0000ff)).toBe(0xff0000ff);
-  });
-  it('multiplies RGB by alpha and preserves the alpha channel', () => {
-    // Red at 50% alpha: R=255*0.502≈128, A unchanged=0x80
-    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('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);
-  });
-});
-
-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);
-  });
-});
-
-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);
-    // Without gamma decode, 0x80/0xff ≈ 0.502 — above the linear midpoint.
-    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);
-  });
-});
-
-describe('unpremultiplyColorAlpha', () => {
-  it('returns fully-opaque color unchanged', () => {
-    expect(unpremultiplyColorAlpha(0xff0000ff)).toBe(0xff0000ff);
-  });
-  it('divides RGB by alpha and preserves the alpha channel', () => {
-    // Premultiplied: R=128 (≈0x80), A=0x80 → straight: R ≈ 255
-    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);
-  });
-});