@photivra/engine 1.5.0 → 2.1.0

package/dist/color/capture-color.d.ts

@@ -6,14 +6,19 @@ export declare const VIRTUAL_COLOR_CAMERA_PROFILE: Readonly<{
     id: "photivra-colorimetric-rgb-d65";
     version: "0.1.0";
 }>;
-/** Linear light, sRGB primaries/D65; no sRGB transfer curve is applied. */
+/** Linear light with sRGB primaries and a D65 white. No sRGB transfer curve is applied. */
 export declare const LINEAR_CAPTURE_RGB_PROFILE: Readonly<{
     id: "linear-srgb-d65";
     version: "0.1.0";
 }>;
 type Vector = readonly [number, number, number];
 type Matrix = readonly [Vector, Vector, Vector];
-/** One explicit color interpretation; gains and adaptation cannot silently double-apply WB. */
+/**
+ * Cone-space transform for adapting to the adopted white. If omitted, the original
+ * XYZ-diagonal scaling (model id `photivra-xyz-diagonal-adaptation`) is used unchanged.
+ */
+export type CaptureChromaticAdaptationTransform = "bradford" | "cat16";
+/** One explicit colour interpretation. Gains and adaptation cannot both apply white balance by accident. */
 export type CaptureColorWhiteBalance = {
     kind: "preserve-intent";
 } | {
@@ -21,8 +26,9 @@ export type CaptureColorWhiteBalance = {
     channelBasis: CapturePublicProfileReference;
 } | {
     kind: "adopted-white-xyz-scaling";
+    transform?: CaptureChromaticAdaptationTransform;
 };
-/** IDs identify a new derived plane; source capture stays immutable. */
+/** IDs name a new derived plane. The source capture is never changed. */
 export interface CaptureColorTransformInput {
     capture: SimulatedCapture;
     sourcePlaneId: string;
@@ -30,7 +36,7 @@ export interface CaptureColorTransformInput {
     outputImageStateId: string;
     whiteBalance: CaptureColorWhiteBalance;
 }
-/** Profile data exposes complete row-major matrices and domain conditions to consumers. */
+/** Profile data gives callers the complete row-major matrices and the conditions where they apply. */
 export interface CaptureColorModel {
     version: typeof CAPTURE_COLOR_MODEL_VERSION;
     cameraProfile: CapturePublicProfileReference;
@@ -50,7 +56,7 @@ export interface CaptureColorModel {
 }
 /** Returns the versioned ideal camera basis, independent of rendering/serializer state. */
 export declare function resolveCaptureColorModel(): CaptureColorModel;
-/** Validates the entire capture and explicit transform policy across untrusted JSON boundaries. */
+/** Validates the whole capture and its explicit transform policy, read from untrusted JSON. */
 export declare function parseCaptureColorTransformInput(value: unknown): CaptureColorTransformInput;
 export interface CaptureColorTransformResult {
     plane: CaptureLinearPlane;
@@ -60,14 +66,15 @@ export interface CaptureColorTransformResult {
     whiteBalance: CaptureColorWhiteBalance;
     /** Matrix on CIE XYZ, identity when no adaptation; row-major, dimensionless. */
     chromaticAdaptationMatrix: Matrix;
-    /** False: even adopted-white scaling is a camera choice under mixed illumination. */
+    /** False: under mixed lighting, even scaling to the adopted white is a choice the camera makes. */
     claimsUniqueSceneWhite: false;
 }
 /**
- * Converts a bounded inline XYZ/ideal-camera plane to unclamped linear sRGB.
- * Reuses resolved WB intent; never estimates illumination or changes exposure/noise.
- * XYZ diagonal adaptation is explicitly an approximation, distinct from RGB gains.
+ * Converts a bounded inline XYZ (ideal-camera) plane to unclamped linear sRGB.
+ * It reuses the resolved white-balance intent. It never estimates the lighting and never changes
+ * exposure or noise. Adapting to the adopted white (XYZ diagonal by default, or an explicit
+ * Bradford or CAT16 cone-space transform) is labelled an approximation, and
+ * is separate from RGB gains.
  */
 export declare function calculateCaptureColorTransform(input: CaptureColorTransformInput): CalculationResult<CaptureColorTransformResult>;
 export {};
-//# sourceMappingURL=capture-color.d.ts.map

package/dist/color/capture-color.js

@@ -1,19 +1,22 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Returns the versioned ideal camera basis, independent of rendering/serializer state.
- * Validates the entire capture and explicit transform policy across untrusted JSON boundaries.
- * @see docs/CAPTURE_COLOR.md for equations, coordinate/unit conventions, blockers and support limits.
+ * Colour for an ideal colorimetric capture: the versioned ideal camera basis, parsing of a capture
+ * and its colour transform policy from untrusted JSON, and conversion to linear sRGB.
+ *
+ * The basis does not depend on rendering or serializer state.
+ * @see docs/CAPTURE_COLOR.md for the equations, units, coordinate conventions, known blockers and
+ * support limits.
  */
 import { requireAllowlistedRecord, requirePublicOpaqueId } from "../core/record-validation.js";
 import { calculatedResult, approximationResult } from "../core/calculation-result.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { InvalidScientificResultError } from "../core/validation.js";
+import { chromaticAdaptationMatrix } from "./chromatic-adaptation.js";
 import { parseSimulatedCapture } from "../capture/simulated-capture.js";
 export const CAPTURE_COLOR_MODEL_VERSION = "0.1.0";
 /** Explicit ideal colorimetric camera, not measured spectral sensor channels. */
 export const VIRTUAL_COLOR_CAMERA_PROFILE = Object.freeze({ id: "photivra-colorimetric-rgb-d65", version: CAPTURE_COLOR_MODEL_VERSION });
-/** Linear light, sRGB primaries/D65; no sRGB transfer curve is applied. */
+/** Linear light with sRGB primaries and a D65 white. No sRGB transfer curve is applied. */
 export const LINEAR_CAPTURE_RGB_PROFILE = Object.freeze({ id: "linear-srgb-d65", version: CAPTURE_COLOR_MODEL_VERSION });
 const D65 = Object.freeze({ x: .3127 / .3290, y: 1, z: (1 - .3127 - .3290) / .3290 });
 const IDENTITY = [[1, 0, 0], [0, 1, 0], [0, 0, 1]];
@@ -26,13 +29,14 @@ function inverse(m) {
     return [[e * i - f * h, c * h - b * i, b * f - c * e], [f * g - d * i, a * i - c * g, c * d - a * f], [d * h - e * g, b * g - a * h, a * e - b * d]]
         .map((r) => r.map((v) => v / determinant));
 }
-// Independently derive the basis from public primary chromaticities, not a copied matrix.
+// Derive the basis independently from the published primary chromaticities, not from a copied matrix.
 const primaries = [[.64, .33], [.30, .60], [.15, .06]];
 const columns = primaries.map(([x, y]) => [x / y, 1, (1 - x - y) / y]);
 const basis = [0, 1, 2].map((i) => columns.map((c) => c[i]));
 const scales = multiply(inverse(basis), [D65.x, 1, D65.z]);
 const RGB_TO_XYZ = basis.map((row) => row.map((v, i) => v * scales[i]));
 const XYZ_TO_RGB = inverse(RGB_TO_XYZ);
+const CAPTURE_ADAPTATION_TRANSFORMS = ["bradford", "cat16"];
 /** Returns the versioned ideal camera basis, independent of rendering/serializer state. */
 export function resolveCaptureColorModel() {
     return { version: CAPTURE_COLOR_MODEL_VERSION, cameraProfile: { ...VIRTUAL_COLOR_CAMERA_PROFILE },
@@ -50,16 +54,22 @@ function record(v, keys) {
 function publicId(v) {
     return requirePublicOpaqueId(v, "Invalid public color ID.");
 }
-/** Validates the entire capture and explicit transform policy across untrusted JSON boundaries. */
+/** Validates the whole capture and its explicit transform policy, read from untrusted JSON. */
 export function parseCaptureColorTransformInput(value) {
     const r = record(value, ["capture", "sourcePlaneId", "outputPlaneId", "outputImageStateId", "whiteBalance"]);
-    const w = record(r.whiteBalance, ["kind", "channelBasis"]);
+    const w = record(r.whiteBalance, ["kind", "channelBasis", "transform"]);
     let whiteBalance;
-    if (w.kind === "apply-resolved-rgb-gains") {
+    if (w.kind === "apply-resolved-rgb-gains" && w.transform === undefined) {
         const p = record(w.channelBasis, ["id", "version"]);
         whiteBalance = { kind: w.kind, channelBasis: { id: publicId(p.id), version: publicId(p.version) } };
     }
-    else if ((w.kind === "preserve-intent" || w.kind === "adopted-white-xyz-scaling") && w.channelBasis === undefined) {
+    else if (w.kind === "adopted-white-xyz-scaling" && w.channelBasis === undefined && w.transform !== undefined) {
+        if (typeof w.transform !== "string" || !CAPTURE_ADAPTATION_TRANSFORMS.includes(w.transform)) {
+            throw new InvalidConfigurationError("Unsupported chromatic-adaptation transform.");
+        }
+        whiteBalance = { kind: w.kind, transform: w.transform };
+    }
+    else if ((w.kind === "preserve-intent" || w.kind === "adopted-white-xyz-scaling") && w.channelBasis === undefined && w.transform === undefined) {
         whiteBalance = { kind: w.kind };
     }
     else
@@ -67,10 +77,17 @@ export function parseCaptureColorTransformInput(value) {
     return { capture: parseSimulatedCapture(r.capture), sourcePlaneId: publicId(r.sourcePlaneId),
         outputPlaneId: publicId(r.outputPlaneId), outputImageStateId: publicId(r.outputImageStateId), whiteBalance };
 }
+function adaptationProfileId(whiteBalance) {
+    return whiteBalance.kind === "adopted-white-xyz-scaling" && whiteBalance.transform !== undefined
+        ? "photivra-" + whiteBalance.transform + "-adaptation"
+        : "photivra-xyz-diagonal-adaptation";
+}
 /**
- * Converts a bounded inline XYZ/ideal-camera plane to unclamped linear sRGB.
- * Reuses resolved WB intent; never estimates illumination or changes exposure/noise.
- * XYZ diagonal adaptation is explicitly an approximation, distinct from RGB gains.
+ * Converts a bounded inline XYZ (ideal-camera) plane to unclamped linear sRGB.
+ * It reuses the resolved white-balance intent. It never estimates the lighting and never changes
+ * exposure or noise. Adapting to the adopted white (XYZ diagonal by default, or an explicit
+ * Bradford or CAT16 cone-space transform) is labelled an approximation, and
+ * is separate from RGB gains.
  */
 export function calculateCaptureColorTransform(input) {
     const { capture, sourcePlaneId, outputPlaneId, outputImageStateId, whiteBalance } = parseCaptureColorTransformInput(input);
@@ -107,7 +124,20 @@ export function calculateCaptureColorTransform(input) {
         if (!Number.isFinite(x) || !Number.isFinite(z) || x < 1e-6 || x > 1e6 || z < 1e-6 || z > 1e6) {
             throw new InvalidConfigurationError("Adopted-white scaling is outside the declared numerical domain.");
         }
-        adaptation = [[x, 0, 0], [0, 1, 0], [0, 0, z]];
+        if (whiteBalance.transform === undefined)
+            adaptation = [[x, 0, 0], [0, 1, 0], [0, 0, z]];
+        else {
+            let m;
+            try {
+                m = chromaticAdaptationMatrix({ transform: whiteBalance.transform, sourceWhiteXyz: white, destinationWhiteXyz: D65 }).matrix;
+            }
+            catch {
+                throw new InvalidConfigurationError("Adopted-white adaptation is outside the transform's numerical domain.");
+            }
+            if (m.flat().some((v) => Math.abs(v) > 1e6))
+                throw new InvalidConfigurationError("Adopted-white adaptation is outside the declared numerical domain.");
+            adaptation = m;
+        }
     }
     const samples = [], values = source.storage.samples;
     for (let i = 0; i < values.length; i += 3) {
@@ -123,7 +153,7 @@ export function calculateCaptureColorTransform(input) {
     }
     const transforms = [...source.appliedTransforms];
     if (adapt)
-        transforms.push({ profile: { id: "photivra-xyz-diagonal-adaptation", version: CAPTURE_COLOR_MODEL_VERSION }, kind: "chromatic-adaptation" });
+        transforms.push({ profile: { id: adaptationProfileId(whiteBalance), version: CAPTURE_COLOR_MODEL_VERSION }, kind: "chromatic-adaptation" });
     transforms.push({ profile: { ...LINEAR_CAPTURE_RGB_PROFILE }, kind: "linear-color" });
     if (gains)
         transforms.push({ profile: { id: capture.whiteBalanceIntent.stateId, version: CAPTURE_COLOR_MODEL_VERSION }, kind: "linear-color" });
@@ -132,14 +162,17 @@ export function calculateCaptureColorTransform(input) {
         encodingReferenceWhiteXyz: { ...D65 }, appliedTransforms: transforms,
         whiteBalanceApplication: gains ? "applied-rgb-gains" : adapt ? "applied-chromatic-adaptation" : capture.whiteBalanceIntent ? "intent-only" : "not-applicable",
         storage: { kind: "inline-float64", samples } };
-    // Validation enforces capture-wide sample budget, identities and output finiteness.
+    // Validation enforces the capture-wide sample budget, the identities and finite output.
     const checked = parseSimulatedCapture({ ...capture, planes: [plane] }).planes[0];
     const result = { plane: checked, colorModel: resolveCaptureColorModel(), sourcePlaneId,
         sourceImageStateId: source.imageStateId, whiteBalance, chromaticAdaptationMatrix: adaptation.map((r) => [...r]),
         claimsUniqueSceneWhite: false };
     const assumptions = ["Ideal CIE colorimetric virtual camera only; no sensor calibration inferred", "Source exposure/noise/saturation history retained; float samples never clipped",
         "WB intent, applied RGB gains and adopted-white adaptation are independent choices; no scene-white oracle"];
-    return adapt ? approximationResult(result, "capture-color-xyz-diagonal-adaptation", CAPTURE_COLOR_MODEL_VERSION, [...assumptions, "XYZ diagonal scaling is a limited chromatic-adaptation approximation, not Bradford or a color-appearance model"])
+    const transform = whiteBalance.kind === "adopted-white-xyz-scaling" ? whiteBalance.transform : undefined;
+    return adapt ? transform === undefined
+        ? approximationResult(result, "capture-color-xyz-diagonal-adaptation", CAPTURE_COLOR_MODEL_VERSION, [...assumptions, "XYZ diagonal scaling is a limited chromatic-adaptation approximation, not Bradford or a color-appearance model"])
+        : approximationResult(result, "capture-color-" + transform + "-adaptation", CAPTURE_COLOR_MODEL_VERSION, [...assumptions, "Complete (D = 1) linear " + transform + " von Kries-type adaptation to D65; corresponding-colour prediction is approximate and no color-appearance model is applied"])
         : calculatedResult(result, "capture-colorimetric-linear-rgb", CAPTURE_COLOR_MODEL_VERSION, assumptions);
 }
 //# sourceMappingURL=capture-color.js.map

package/dist/color/capture-color.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture-color.js","sourceRoot":"","sources":["../../src/color/capture-color.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"capture-color.js","sourceRoot":"","sources":["../../src/color/capture-color.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Colour for an ideal colorimetric capture: the versioned ideal camera basis, parsing of a capture\n * and its colour transform policy from untrusted JSON, and conversion to linear sRGB.\n *\n * The basis does not depend on rendering or serializer state.\n * @see docs/CAPTURE_COLOR.md for the equations, units, coordinate conventions, known blockers and\n * support limits.\n */\n\nimport { requireAllowlistedRecord, requirePublicOpaqueId } from \"../core/record-validation.js\";\nimport { calculatedResult, approximationResult, type CalculationResult } from \"../core/calculation-result.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { InvalidScientificResultError } from \"../core/validation.js\";\nimport { chromaticAdaptationMatrix } from \"./chromatic-adaptation.js\";\nimport { parseSimulatedCapture, type SimulatedCapture, type CaptureLinearPlane, type CapturePublicProfileReference } from \"../capture/simulated-capture.js\";\n\nexport const CAPTURE_COLOR_MODEL_VERSION = \"0.1.0\" as const;\n/** Explicit ideal colorimetric camera, not measured spectral sensor channels. */\nexport const VIRTUAL_COLOR_CAMERA_PROFILE = Object.freeze({ id: \"photivra-colorimetric-rgb-d65\", version: CAPTURE_COLOR_MODEL_VERSION });\n/** Linear light with sRGB primaries and a D65 white. No sRGB transfer curve is applied. */\nexport const LINEAR_CAPTURE_RGB_PROFILE = Object.freeze({ id: \"linear-srgb-d65\", version: CAPTURE_COLOR_MODEL_VERSION });\nconst D65 = Object.freeze({ x: .3127/.3290, y: 1 as const, z: (1-.3127-.3290)/.3290 });\ntype Vector = readonly [number, number, number];\ntype Matrix = readonly [Vector, Vector, Vector];\nconst IDENTITY: Matrix = [[1, 0, 0], [0, 1, 0], [0, 0, 1]];\nfunction multiply(m: Matrix, v: Vector): Vector {\n  return m.map((r) => r[0]*v[0]+r[1]*v[1]+r[2]*v[2]) as unknown as Vector;\n}\nfunction inverse(m: Matrix): Matrix {\n  const [[a, b, c], [d, e, f], [g, h, i]] = m;\n  const determinant = a*(e*i-f*h)-b*(d*i-f*g)+c*(d*h-e*g);\n  return [[e*i-f*h, c*h-b*i, b*f-c*e], [f*g-d*i, a*i-c*g, c*d-a*f], [d*h-e*g, b*g-a*h, a*e-b*d]]\n    .map((r) => r.map((v) => v/determinant)) as unknown as Matrix;\n}\n// Derive the basis independently from the published primary chromaticities, not from a copied matrix.\nconst primaries: readonly (readonly [number, number])[] = [[.64, .33], [.30, .60], [.15, .06]];\nconst columns = primaries.map(([x, y]): Vector => [x/y, 1, (1-x-y)/y]);\nconst basis = [0, 1, 2].map((i) => columns.map((c) => c[i]!)) as unknown as Matrix;\nconst scales = multiply(inverse(basis), [D65.x, 1, D65.z]);\nconst RGB_TO_XYZ = basis.map((row) => row.map((v, i) => v*scales[i]!)) as unknown as Matrix;\nconst XYZ_TO_RGB = inverse(RGB_TO_XYZ);\n\n/**\n * Cone-space transform for adapting to the adopted white. If omitted, the original\n * XYZ-diagonal scaling (model id `photivra-xyz-diagonal-adaptation`) is used unchanged.\n */\nexport type CaptureChromaticAdaptationTransform = \"bradford\" | \"cat16\";\nconst CAPTURE_ADAPTATION_TRANSFORMS: readonly string[] = [\"bradford\", \"cat16\"];\n/** One explicit colour interpretation. Gains and adaptation cannot both apply white balance by accident. */\nexport type CaptureColorWhiteBalance =\n  | { kind: \"preserve-intent\" }\n  | { kind: \"apply-resolved-rgb-gains\"; channelBasis: CapturePublicProfileReference }\n  | { kind: \"adopted-white-xyz-scaling\"; transform?: CaptureChromaticAdaptationTransform };\n/** IDs name a new derived plane. The source capture is never changed. */\nexport interface CaptureColorTransformInput {\n  capture: SimulatedCapture;\n  sourcePlaneId: string;\n  outputPlaneId: string;\n  outputImageStateId: string;\n  whiteBalance: CaptureColorWhiteBalance;\n}\n/** Profile data gives callers the complete row-major matrices and the conditions where they apply. */\nexport interface CaptureColorModel {\n  version: typeof CAPTURE_COLOR_MODEL_VERSION;\n  cameraProfile: CapturePublicProfileReference;\n  outputProfile: CapturePublicProfileReference;\n  referenceIlluminant: \"D65\";\n  observer: \"cie-1931-2-degree\";\n  referenceWhiteXyz: { x: number; y: 1; z: number };\n  cameraRgbToXyz: Matrix;\n  xyzToCameraRgb: Matrix;\n  scientificStatus: \"calculated\";\n  validConditions: readonly string[];\n  publicEvidenceIds: readonly string[];\n}\n/** Returns the versioned ideal camera basis, independent of rendering/serializer state. */\nexport function resolveCaptureColorModel(): CaptureColorModel {\n  return { version: CAPTURE_COLOR_MODEL_VERSION, cameraProfile: { ...VIRTUAL_COLOR_CAMERA_PROFILE },\n    outputProfile: { ...LINEAR_CAPTURE_RGB_PROFILE }, referenceIlluminant: \"D65\", observer: \"cie-1931-2-degree\",\n    referenceWhiteXyz: { ...D65 }, cameraRgbToXyz: RGB_TO_XYZ.map((r) => [...r]) as unknown as Matrix,\n    xyzToCameraRgb: XYZ_TO_RGB.map((r) => [...r]) as unknown as Matrix, scientificStatus: \"calculated\",\n    validConditions: [\"Ideal colorimetric basis only; virtual RGB is an invertible encoding of CIE XYZ\",\n      \"Not spectral channels, electrons, commercial-camera RGB or a sensor calibration\",\n      \"Signed finite scene-linear values; co-sited RGB; no transfer curve, gamut mapping or clipping\"],\n    publicEvidenceIds: [\"w3c:css-color-4:srgb-primaries-d65\"] };\n}\nfunction record(v: unknown, keys: readonly string[]): Record<string, unknown> {\n  return requireAllowlistedRecord(v, keys, \"Invalid color-transform fields.\");\n}\nfunction publicId(v: unknown): string {\n  return requirePublicOpaqueId(v, \"Invalid public color ID.\");\n}\n/** Validates the whole capture and its explicit transform policy, read from untrusted JSON. */\nexport function parseCaptureColorTransformInput(value: unknown): CaptureColorTransformInput {\n  const r = record(value, [\"capture\", \"sourcePlaneId\", \"outputPlaneId\", \"outputImageStateId\", \"whiteBalance\"]);\n  const w = record(r.whiteBalance, [\"kind\", \"channelBasis\", \"transform\"]);\n  let whiteBalance: CaptureColorWhiteBalance;\n  if (w.kind === \"apply-resolved-rgb-gains\" && w.transform === undefined) {\n    const p = record(w.channelBasis, [\"id\", \"version\"]);\n    whiteBalance = { kind: w.kind, channelBasis: { id: publicId(p.id), version: publicId(p.version) } };\n  } else if (w.kind === \"adopted-white-xyz-scaling\" && w.channelBasis === undefined && w.transform !== undefined) {\n    if (typeof w.transform !== \"string\" || !CAPTURE_ADAPTATION_TRANSFORMS.includes(w.transform)) {\n      throw new InvalidConfigurationError(\"Unsupported chromatic-adaptation transform.\");\n    }\n    whiteBalance = { kind: w.kind, transform: w.transform as CaptureChromaticAdaptationTransform };\n  } else if ((w.kind === \"preserve-intent\" || w.kind === \"adopted-white-xyz-scaling\") && w.channelBasis === undefined && w.transform === undefined) {\n    whiteBalance = { kind: w.kind };\n  } else throw new InvalidConfigurationError(\"Unsupported or contradictory color WB policy.\");\n  return { capture: parseSimulatedCapture(r.capture), sourcePlaneId: publicId(r.sourcePlaneId),\n    outputPlaneId: publicId(r.outputPlaneId), outputImageStateId: publicId(r.outputImageStateId), whiteBalance };\n}\nexport interface CaptureColorTransformResult {\n  plane: CaptureLinearPlane;\n  colorModel: CaptureColorModel;\n  sourcePlaneId: string;\n  sourceImageStateId: string;\n  whiteBalance: CaptureColorWhiteBalance;\n  /** Matrix on CIE XYZ, identity when no adaptation; row-major, dimensionless. */\n  chromaticAdaptationMatrix: Matrix;\n  /** False: under mixed lighting, even scaling to the adopted white is a choice the camera makes. */\n  claimsUniqueSceneWhite: false;\n}\nfunction adaptationProfileId(whiteBalance: CaptureColorWhiteBalance): string {\n  return whiteBalance.kind === \"adopted-white-xyz-scaling\" && whiteBalance.transform !== undefined\n    ? \"photivra-\" + whiteBalance.transform + \"-adaptation\"\n    : \"photivra-xyz-diagonal-adaptation\";\n}\n/**\n * Converts a bounded inline XYZ (ideal-camera) plane to unclamped linear sRGB.\n * It reuses the resolved white-balance intent. It never estimates the lighting and never changes\n * exposure or noise. Adapting to the adopted white (XYZ diagonal by default, or an explicit\n * Bradford or CAT16 cone-space transform) is labelled an approximation, and\n * is separate from RGB gains.\n */\nexport function calculateCaptureColorTransform(input: CaptureColorTransformInput): CalculationResult<CaptureColorTransformResult> {\n  const { capture, sourcePlaneId, outputPlaneId, outputImageStateId, whiteBalance } = parseCaptureColorTransformInput(input);\n  const source = capture.planes.find((p) => p.id === sourcePlaneId);\n  if (!source || source.storage.kind !== \"inline-float64\" || source.imageState === \"color-transformed-linear-rgb\" ||\n      source.whiteBalanceApplication === \"applied-rgb-gains\" || source.whiteBalanceApplication === \"applied-chromatic-adaptation\" ||\n      source.appliedTransforms.some((t) => t.kind !== \"digital-lens-correction\")) {\n    throw new InvalidConfigurationError(\"Color requires an untreated inline XYZ or supported virtual camera plane.\");\n  }\n  if (capture.planes.some((p) => p.id === outputPlaneId || p.imageStateId === outputImageStateId)) {\n    throw new InvalidConfigurationError(\"Derived color plane/state IDs must be new.\");\n  }\n  const virtual = source.imageState === \"virtual-sensor-channels\";\n  if (virtual && (source.colorProfile?.id !== VIRTUAL_COLOR_CAMERA_PROFILE.id || source.colorProfile.version !== CAPTURE_COLOR_MODEL_VERSION ||\n      JSON.stringify(source.channelIds) !== JSON.stringify([\"red\", \"green\", \"blue\"]))) {\n    throw new InvalidConfigurationError(\"Unresolved spectral/sensor RGB cannot use the ideal colorimetric transform.\");\n  }\n  const adapt = whiteBalance.kind === \"adopted-white-xyz-scaling\";\n  const reference = source.encodingReferenceWhiteXyz;\n  if (!virtual && !adapt && (reference!.x !== D65.x || reference!.z !== D65.z)) {\n    throw new InvalidConfigurationError(\"A different XYZ reference white requires an explicit adaptation choice.\");\n  }\n  const gains = whiteBalance.kind === \"apply-resolved-rgb-gains\";\n  if (gains && (!capture.whiteBalanceIntent || whiteBalance.channelBasis.id !== VIRTUAL_COLOR_CAMERA_PROFILE.id ||\n      whiteBalance.channelBasis.version !== CAPTURE_COLOR_MODEL_VERSION)) {\n    throw new InvalidConfigurationError(\"Resolved WB gains require an explicit matching camera channel-basis binding.\");\n  }\n  let adaptation: Matrix = IDENTITY;\n  if (adapt) {\n    const white = capture.adoptedWhiteXyz;\n    if (!white) throw new InvalidConfigurationError(\"Adopted-white adaptation requires an explicit adopted XYZ white.\");\n    const x = D65.x/white.x, z = D65.z/white.z;\n    if (!Number.isFinite(x) || !Number.isFinite(z) || x < 1e-6 || x > 1e6 || z < 1e-6 || z > 1e6) {\n      throw new InvalidConfigurationError(\"Adopted-white scaling is outside the declared numerical domain.\");\n    }\n    if (whiteBalance.transform === undefined) adaptation = [[x, 0, 0], [0, 1, 0], [0, 0, z]];\n    else {\n      let m: Matrix;\n      try {\n        m = chromaticAdaptationMatrix({ transform: whiteBalance.transform, sourceWhiteXyz: white, destinationWhiteXyz: D65 }).matrix;\n      } catch {\n        throw new InvalidConfigurationError(\"Adopted-white adaptation is outside the transform's numerical domain.\");\n      }\n      if (m.flat().some((v) => Math.abs(v) > 1e6)) throw new InvalidConfigurationError(\"Adopted-white adaptation is outside the declared numerical domain.\");\n      adaptation = m;\n    }\n  }\n  const samples: number[] = [], values = source.storage.samples;\n  for (let i = 0; i < values.length; i += 3) {\n    const v: Vector = [values[i]!, values[i+1]!, values[i+2]!];\n    let rgb = virtual && !adapt ? v : multiply(XYZ_TO_RGB, multiply(adaptation, virtual ? multiply(RGB_TO_XYZ, v) : v));\n    if (gains) {\n      const g = capture.whiteBalanceIntent!.channelGains;\n      rgb = [rgb[0]*g.red, rgb[1]*g.green, rgb[2]*g.blue];\n    }\n    if (rgb.some((v) => !Number.isFinite(v))) throw new InvalidScientificResultError(\"Color transform produced a non-finite sample.\");\n    samples.push(...rgb.map((v) => Object.is(v, -0) ? 0 : v));\n  }\n  const transforms: CaptureLinearPlane[\"appliedTransforms\"][number][] = [...source.appliedTransforms];\n  if (adapt) transforms.push({ profile: { id: adaptationProfileId(whiteBalance), version: CAPTURE_COLOR_MODEL_VERSION }, kind: \"chromatic-adaptation\" });\n  transforms.push({ profile: { ...LINEAR_CAPTURE_RGB_PROFILE }, kind: \"linear-color\" });\n  if (gains) transforms.push({ profile: { id: capture.whiteBalanceIntent!.stateId, version: CAPTURE_COLOR_MODEL_VERSION }, kind: \"linear-color\" });\n  const plane: CaptureLinearPlane = { ...source, id: outputPlaneId, imageStateId: outputImageStateId,\n    imageState: \"color-transformed-linear-rgb\", channelIds: [\"red\", \"green\", \"blue\"], colorProfile: { ...LINEAR_CAPTURE_RGB_PROFILE },\n    encodingReferenceWhiteXyz: { ...D65 }, appliedTransforms: transforms,\n    whiteBalanceApplication: gains ? \"applied-rgb-gains\" : adapt ? \"applied-chromatic-adaptation\" : capture.whiteBalanceIntent ? \"intent-only\" : \"not-applicable\",\n    storage: { kind: \"inline-float64\", samples } };\n  // Validation enforces the capture-wide sample budget, the identities and finite output.\n  const checked = parseSimulatedCapture({ ...capture, planes: [plane] }).planes[0]!;\n  const result: CaptureColorTransformResult = { plane: checked, colorModel: resolveCaptureColorModel(), sourcePlaneId,\n    sourceImageStateId: source.imageStateId, whiteBalance, chromaticAdaptationMatrix: adaptation.map((r) => [...r]) as unknown as Matrix,\n    claimsUniqueSceneWhite: false };\n  const assumptions = [\"Ideal CIE colorimetric virtual camera only; no sensor calibration inferred\", \"Source exposure/noise/saturation history retained; float samples never clipped\",\n    \"WB intent, applied RGB gains and adopted-white adaptation are independent choices; no scene-white oracle\"];\n  const transform = whiteBalance.kind === \"adopted-white-xyz-scaling\" ? whiteBalance.transform : undefined;\n  return adapt ? transform === undefined\n    ? approximationResult(result, \"capture-color-xyz-diagonal-adaptation\", CAPTURE_COLOR_MODEL_VERSION,\n      [...assumptions, \"XYZ diagonal scaling is a limited chromatic-adaptation approximation, not Bradford or a color-appearance model\"])\n    : approximationResult(result, \"capture-color-\" + transform + \"-adaptation\", CAPTURE_COLOR_MODEL_VERSION,\n      [...assumptions, \"Complete (D = 1) linear \" + transform + \" von Kries-type adaptation to D65; corresponding-colour prediction is approximate and no color-appearance model is applied\"])\n    : calculatedResult(result, \"capture-colorimetric-linear-rgb\", CAPTURE_COLOR_MODEL_VERSION, assumptions);\n}\n"]}

package/dist/color/chromatic-adaptation.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Von Kries-type linear chromatic adaptation transforms (CATs) on CIE XYZ:
+ *   M = C⁻¹ · diag(Dᵢ) · C,  Dᵢ = D · (Y_s / Y_d) · (ρᵢ,d / ρᵢ,s) + 1 − D
+ * where C maps XYZ to a cone-like ("sharpened") space, ρ_s and ρ_d are the source and
+ * destination whites in that space, and D ∈ [0, 1] is the degree of adaptation. This is
+ * the one-step, two-illuminant form of Li et al. (2017) for CAT16; it is used for every
+ * transform here. With D = 1 and equal white luminance, the source white maps exactly to
+ * the destination white.
+ *
+ * Cone matrices (published factual constants):
+ * - Bradford (linearized): Lam (1985) thesis, University of Bradford; Luo & Rhodes
+ *   (1999); as used in ICC.1:2010 Annex E. The original blue-channel non-linearity is
+ *   omitted, as in common practice.
+ * - CAT16: Li, Li, Wang, Xu, Luo, Cui, Melgosa & Pointer (2016), "A Revision of CIECAM02
+ *   and its CAT and UCS", IS&T CIC24, pp. 208–212, Eq. (15) (M16),
+ *   doi:10.2352/ISSN.2169-2629.2017.32.208 (free from the IS&T library). Journal version:
+ *   Li et al. (2017), "Comprehensive color solutions: CAM16, CAT16, and CAM16-UCS",
+ *   Color Res. Appl. 42(6):703–718.
+ * - XYZ scaling: identity cone matrix (diagonal scaling in XYZ; the weakest model).
+ * The degree of adaptation D is supplied by the caller (default 1, complete adaptation).
+ * CAT02, the von Kries Hunt–Pointer–Estévez matrix and the CIECAM02 formula for D are not
+ * part of 2.0: no free source we could confirm prints them (owner decisions, 2026-10-17).
+ * @see docs/COLORIMETRY.md for equations, coordinate/unit conventions and limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type CieXyzTristimulus, type ColorMatrix3x3 } from "./colorimetry-math.js";
+/** Supported linear chromatic-adaptation transforms. */
+export type ChromaticAdaptationTransform = "bradford" | "cat16" | "xyz-scaling";
+export declare const CHROMATIC_ADAPTATION_TRANSFORMS: readonly ChromaticAdaptationTransform[];
+/** Returns a copy of the XYZ → cone-space matrix of a transform. */
+export declare function resolveChromaticAdaptationConeMatrix(transform: ChromaticAdaptationTransform): ColorMatrix3x3;
+export interface CalculateChromaticAdaptationMatrixInput {
+    transform: ChromaticAdaptationTransform;
+    /** White of the source viewing/illumination condition (relative XYZ, Y > 0). */
+    sourceWhiteXyz: CieXyzTristimulus;
+    /** White of the destination condition (relative XYZ, Y > 0). */
+    destinationWhiteXyz: CieXyzTristimulus;
+    /** Degree of adaptation D in [0, 1]; defaults to 1 (complete adaptation). */
+    degreeOfAdaptation?: number;
+}
+export interface ChromaticAdaptationMatrix {
+    transform: ChromaticAdaptationTransform;
+    degreeOfAdaptation: number;
+    /** Row-major XYZ_source → XYZ_destination matrix. */
+    matrix: ColorMatrix3x3;
+    /** The per-channel cone-space gains Dᵢ. */
+    coneGains: readonly [number, number, number];
+}
+/** Internal: builds the adaptation matrix without an envelope. */
+export declare function chromaticAdaptationMatrix(input: CalculateChromaticAdaptationMatrixInput): ChromaticAdaptationMatrix;
+/**
+ * Calculates a linear chromatic-adaptation matrix between two whites. Linear CATs are
+ * standard models, but they predict corresponding colours only approximately. The matrix
+ * itself is calculated exactly from the declared transform.
+ */
+export declare function calculateChromaticAdaptationMatrix(input: CalculateChromaticAdaptationMatrixInput): CalculationResult<ChromaticAdaptationMatrix>;
+/** Adapts one XYZ colour between whites with the selected transform. */
+export declare function calculateChromaticallyAdaptedXyz(input: CalculateChromaticAdaptationMatrixInput & {
+    xyz: CieXyzTristimulus;
+}): CalculationResult<{
+    xyz: CieXyzTristimulus;
+    matrix: ColorMatrix3x3;
+}>;

package/dist/color/chromatic-adaptation.js

@@ -0,0 +1,91 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Von Kries-type linear chromatic adaptation transforms (CATs) on CIE XYZ:
+ *   M = C⁻¹ · diag(Dᵢ) · C,  Dᵢ = D · (Y_s / Y_d) · (ρᵢ,d / ρᵢ,s) + 1 − D
+ * where C maps XYZ to a cone-like ("sharpened") space, ρ_s and ρ_d are the source and
+ * destination whites in that space, and D ∈ [0, 1] is the degree of adaptation. This is
+ * the one-step, two-illuminant form of Li et al. (2017) for CAT16; it is used for every
+ * transform here. With D = 1 and equal white luminance, the source white maps exactly to
+ * the destination white.
+ *
+ * Cone matrices (published factual constants):
+ * - Bradford (linearized): Lam (1985) thesis, University of Bradford; Luo & Rhodes
+ *   (1999); as used in ICC.1:2010 Annex E. The original blue-channel non-linearity is
+ *   omitted, as in common practice.
+ * - CAT16: Li, Li, Wang, Xu, Luo, Cui, Melgosa & Pointer (2016), "A Revision of CIECAM02
+ *   and its CAT and UCS", IS&T CIC24, pp. 208–212, Eq. (15) (M16),
+ *   doi:10.2352/ISSN.2169-2629.2017.32.208 (free from the IS&T library). Journal version:
+ *   Li et al. (2017), "Comprehensive color solutions: CAM16, CAT16, and CAM16-UCS",
+ *   Color Res. Appl. 42(6):703–718.
+ * - XYZ scaling: identity cone matrix (diagonal scaling in XYZ; the weakest model).
+ * The degree of adaptation D is supplied by the caller (default 1, complete adaptation).
+ * CAT02, the von Kries Hunt–Pointer–Estévez matrix and the CIECAM02 formula for D are not
+ * part of 2.0: no free source we could confirm prints them (owner decisions, 2026-10-17).
+ * @see docs/COLORIMETRY.md for equations, coordinate/unit conventions and limits.
+ */
+import { calculatedResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { COLORIMETRY_MODEL_VERSION } from "./color-matching-functions.js";
+import { copyMatrix, diagonalMatrix, invertMatrix3x3, multiplyMatrices, multiplyMatrixVector, parseWhiteXyz, parseXyz, requireFiniteResult, requireNonNegativeNumber, vectorToXyz, xyzToVector } from "./colorimetry-math.js";
+import { requireInputKeys } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+export const CHROMATIC_ADAPTATION_TRANSFORMS = Object.freeze(["bradford", "cat16", "xyz-scaling"]);
+const CONE_MATRICES = Object.freeze({
+    bradford: [[0.8951, 0.2664, -0.1614], [-0.7502, 1.7135, 0.0367], [0.0389, -0.0685, 1.0296]],
+    cat16: [[0.401288, 0.650173, -0.051461], [-0.250268, 1.204414, 0.045854], [-0.002079, 0.048952, 0.953127]],
+    "xyz-scaling": [[1, 0, 0], [0, 1, 0], [0, 0, 1]]
+});
+function requireTransform(value) {
+    if (typeof value !== "string" || !CHROMATIC_ADAPTATION_TRANSFORMS.includes(value)) {
+        throw new InvalidConfigurationError("transform must be one of: " + CHROMATIC_ADAPTATION_TRANSFORMS.join(", ") + ".");
+    }
+    return value;
+}
+/** Returns a copy of the XYZ → cone-space matrix of a transform. */
+export function resolveChromaticAdaptationConeMatrix(transform) {
+    return copyMatrix(CONE_MATRICES[requireTransform(transform)]);
+}
+/** Internal: builds the adaptation matrix without an envelope. */
+export function chromaticAdaptationMatrix(input) {
+    const transform = requireTransform(input.transform);
+    const source = parseWhiteXyz(input.sourceWhiteXyz, "sourceWhiteXyz");
+    const destination = parseWhiteXyz(input.destinationWhiteXyz, "destinationWhiteXyz");
+    const d = input.degreeOfAdaptation === undefined ? 1 : requireNonNegativeNumber(input.degreeOfAdaptation, "degreeOfAdaptation");
+    if (d > 1)
+        throw new InvalidScientificInputError("degreeOfAdaptation must lie in [0, 1].");
+    const cone = CONE_MATRICES[transform];
+    const rs = multiplyMatrixVector(cone, xyzToVector(source));
+    const rd = multiplyMatrixVector(cone, xyzToVector(destination));
+    if (rs.some((v) => !(v > 0)) || rd.some((v) => !(v > 0))) {
+        throw new InvalidScientificInputError("Both whites must have positive cone responses in the selected transform.");
+    }
+    const yRatio = source.y / destination.y;
+    const gains = [0, 1, 2].map((i) => d * yRatio * (rd[i] / rs[i]) + 1 - d);
+    const matrix = multiplyMatrices(multiplyMatrices(invertMatrix3x3(cone, "cone matrix"), diagonalMatrix(gains)), cone);
+    requireFiniteResult(matrix.flat(), "Chromatic adaptation");
+    return { transform, degreeOfAdaptation: d, matrix, coneGains: gains };
+}
+/**
+ * Calculates a linear chromatic-adaptation matrix between two whites. Linear CATs are
+ * standard models, but they predict corresponding colours only approximately. The matrix
+ * itself is calculated exactly from the declared transform.
+ */
+export function calculateChromaticAdaptationMatrix(input) {
+    requireInputKeys(input, "calculateChromaticAdaptationMatrix", ["transform", "sourceWhiteXyz", "destinationWhiteXyz", "degreeOfAdaptation"]);
+    const value = chromaticAdaptationMatrix(input);
+    return calculatedResult(value, "chromatic-adaptation-" + value.transform, COLORIMETRY_MODEL_VERSION, [
+        "Linear von Kries-type transform M = C⁻¹·diag(D·(Ys/Yd)·ρd/ρs + 1 − D)·C",
+        "A linear CAT predicts corresponding colours only approximately; no colour-appearance model is applied"
+    ]);
+}
+/** Adapts one XYZ colour between whites with the selected transform. */
+export function calculateChromaticallyAdaptedXyz(input) {
+    requireInputKeys(input, "calculateChromaticallyAdaptedXyz", ["transform", "sourceWhiteXyz", "destinationWhiteXyz", "degreeOfAdaptation", "xyz"]);
+    const adaptation = chromaticAdaptationMatrix(input);
+    const xyz = vectorToXyz(multiplyMatrixVector(adaptation.matrix, xyzToVector(parseXyz(input.xyz, "xyz"))));
+    requireFiniteResult([xyz.x, xyz.y, xyz.z], "Chromatic adaptation");
+    return calculatedResult({ xyz, matrix: adaptation.matrix }, "chromatic-adaptation-" + adaptation.transform, COLORIMETRY_MODEL_VERSION, [
+        "Linear von Kries-type transform; degree of adaptation " + adaptation.degreeOfAdaptation
+    ]);
+}
+//# sourceMappingURL=chromatic-adaptation.js.map

package/dist/color/chromatic-adaptation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromatic-adaptation.js","sourceRoot":"","sources":["../../src/color/chromatic-adaptation.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Von Kries-type linear chromatic adaptation transforms (CATs) on CIE XYZ:\n *   M = C⁻¹ · diag(Dᵢ) · C,  Dᵢ = D · (Y_s / Y_d) · (ρᵢ,d / ρᵢ,s) + 1 − D\n * where C maps XYZ to a cone-like (\"sharpened\") space, ρ_s and ρ_d are the source and\n * destination whites in that space, and D ∈ [0, 1] is the degree of adaptation. This is\n * the one-step, two-illuminant form of Li et al. (2017) for CAT16; it is used for every\n * transform here. With D = 1 and equal white luminance, the source white maps exactly to\n * the destination white.\n *\n * Cone matrices (published factual constants):\n * - Bradford (linearized): Lam (1985) thesis, University of Bradford; Luo & Rhodes\n *   (1999); as used in ICC.1:2010 Annex E. The original blue-channel non-linearity is\n *   omitted, as in common practice.\n * - CAT16: Li, Li, Wang, Xu, Luo, Cui, Melgosa & Pointer (2016), \"A Revision of CIECAM02\n *   and its CAT and UCS\", IS&T CIC24, pp. 208–212, Eq. (15) (M16),\n *   doi:10.2352/ISSN.2169-2629.2017.32.208 (free from the IS&T library). Journal version:\n *   Li et al. (2017), \"Comprehensive color solutions: CAM16, CAT16, and CAM16-UCS\",\n *   Color Res. Appl. 42(6):703–718.\n * - XYZ scaling: identity cone matrix (diagonal scaling in XYZ; the weakest model).\n * The degree of adaptation D is supplied by the caller (default 1, complete adaptation).\n * CAT02, the von Kries Hunt–Pointer–Estévez matrix and the CIECAM02 formula for D are not\n * part of 2.0: no free source we could confirm prints them (owner decisions, 2026-10-17).\n * @see docs/COLORIMETRY.md for equations, coordinate/unit conventions and limits.\n */\n\nimport { calculatedResult, type CalculationResult } from \"../core/calculation-result.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport { COLORIMETRY_MODEL_VERSION } from \"./color-matching-functions.js\";\nimport {\n  copyMatrix,\n  diagonalMatrix,\n  invertMatrix3x3,\n  multiplyMatrices,\n  multiplyMatrixVector,\n  parseWhiteXyz,\n  parseXyz,\n  requireFiniteResult,\n  requireNonNegativeNumber,\n  vectorToXyz,\n  xyzToVector,\n  type CieXyzTristimulus,\n  type ColorMatrix3x3\n} from \"./colorimetry-math.js\";\nimport { requireInputKeys } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\n/** Supported linear chromatic-adaptation transforms. */\nexport type ChromaticAdaptationTransform = \"bradford\" | \"cat16\" | \"xyz-scaling\";\n\nexport const CHROMATIC_ADAPTATION_TRANSFORMS: readonly ChromaticAdaptationTransform[] = Object.freeze([\"bradford\", \"cat16\", \"xyz-scaling\"]);\n\nconst CONE_MATRICES: Readonly<Record<ChromaticAdaptationTransform, ColorMatrix3x3>> = Object.freeze({\n  bradford: [[0.8951, 0.2664, -0.1614], [-0.7502, 1.7135, 0.0367], [0.0389, -0.0685, 1.0296]],\n  cat16: [[0.401288, 0.650173, -0.051461], [-0.250268, 1.204414, 0.045854], [-0.002079, 0.048952, 0.953127]],\n  \"xyz-scaling\": [[1, 0, 0], [0, 1, 0], [0, 0, 1]]\n});\n\nfunction requireTransform(value: unknown): ChromaticAdaptationTransform {\n  if (typeof value !== \"string\" || !(CHROMATIC_ADAPTATION_TRANSFORMS as readonly string[]).includes(value)) {\n    throw new InvalidConfigurationError(\"transform must be one of: \" + CHROMATIC_ADAPTATION_TRANSFORMS.join(\", \") + \".\");\n  }\n  return value as ChromaticAdaptationTransform;\n}\n\n/** Returns a copy of the XYZ → cone-space matrix of a transform. */\nexport function resolveChromaticAdaptationConeMatrix(transform: ChromaticAdaptationTransform): ColorMatrix3x3 {\n  return copyMatrix(CONE_MATRICES[requireTransform(transform)]);\n}\n\nexport interface CalculateChromaticAdaptationMatrixInput {\n  transform: ChromaticAdaptationTransform;\n  /** White of the source viewing/illumination condition (relative XYZ, Y > 0). */\n  sourceWhiteXyz: CieXyzTristimulus;\n  /** White of the destination condition (relative XYZ, Y > 0). */\n  destinationWhiteXyz: CieXyzTristimulus;\n  /** Degree of adaptation D in [0, 1]; defaults to 1 (complete adaptation). */\n  degreeOfAdaptation?: number;\n}\n\nexport interface ChromaticAdaptationMatrix {\n  transform: ChromaticAdaptationTransform;\n  degreeOfAdaptation: number;\n  /** Row-major XYZ_source → XYZ_destination matrix. */\n  matrix: ColorMatrix3x3;\n  /** The per-channel cone-space gains Dᵢ. */\n  coneGains: readonly [number, number, number];\n}\n\n/** Internal: builds the adaptation matrix without an envelope. */\nexport function chromaticAdaptationMatrix(input: CalculateChromaticAdaptationMatrixInput): ChromaticAdaptationMatrix {\n  const transform = requireTransform(input.transform);\n  const source = parseWhiteXyz(input.sourceWhiteXyz, \"sourceWhiteXyz\");\n  const destination = parseWhiteXyz(input.destinationWhiteXyz, \"destinationWhiteXyz\");\n  const d = input.degreeOfAdaptation === undefined ? 1 : requireNonNegativeNumber(input.degreeOfAdaptation, \"degreeOfAdaptation\");\n  if (d > 1) throw new InvalidScientificInputError(\"degreeOfAdaptation must lie in [0, 1].\");\n  const cone = CONE_MATRICES[transform];\n  const rs = multiplyMatrixVector(cone, xyzToVector(source));\n  const rd = multiplyMatrixVector(cone, xyzToVector(destination));\n  if (rs.some((v) => !(v > 0)) || rd.some((v) => !(v > 0))) {\n    throw new InvalidScientificInputError(\"Both whites must have positive cone responses in the selected transform.\");\n  }\n  const yRatio = source.y / destination.y;\n  const gains = [0, 1, 2].map((i) => d * yRatio * (rd[i]! / rs[i]!) + 1 - d) as unknown as readonly [number, number, number];\n  const matrix = multiplyMatrices(multiplyMatrices(invertMatrix3x3(cone, \"cone matrix\"), diagonalMatrix(gains)), cone);\n  requireFiniteResult(matrix.flat(), \"Chromatic adaptation\");\n  return { transform, degreeOfAdaptation: d, matrix, coneGains: gains };\n}\n\n/**\n * Calculates a linear chromatic-adaptation matrix between two whites. Linear CATs are\n * standard models, but they predict corresponding colours only approximately. The matrix\n * itself is calculated exactly from the declared transform.\n */\nexport function calculateChromaticAdaptationMatrix(input: CalculateChromaticAdaptationMatrixInput): CalculationResult<ChromaticAdaptationMatrix> {\n  requireInputKeys(input, \"calculateChromaticAdaptationMatrix\", [\"transform\", \"sourceWhiteXyz\", \"destinationWhiteXyz\", \"degreeOfAdaptation\"]);\n  const value = chromaticAdaptationMatrix(input);\n  return calculatedResult(value, \"chromatic-adaptation-\" + value.transform, COLORIMETRY_MODEL_VERSION, [\n    \"Linear von Kries-type transform M = C⁻¹·diag(D·(Ys/Yd)·ρd/ρs + 1 − D)·C\",\n    \"A linear CAT predicts corresponding colours only approximately; no colour-appearance model is applied\"\n  ]);\n}\n\n/** Adapts one XYZ colour between whites with the selected transform. */\nexport function calculateChromaticallyAdaptedXyz(input: CalculateChromaticAdaptationMatrixInput & { xyz: CieXyzTristimulus }): CalculationResult<{ xyz: CieXyzTristimulus; matrix: ColorMatrix3x3 }> {\n  requireInputKeys(input, \"calculateChromaticallyAdaptedXyz\", [\"transform\", \"sourceWhiteXyz\", \"destinationWhiteXyz\", \"degreeOfAdaptation\", \"xyz\"]);\n  const adaptation = chromaticAdaptationMatrix(input);\n  const xyz = vectorToXyz(multiplyMatrixVector(adaptation.matrix, xyzToVector(parseXyz(input.xyz, \"xyz\"))));\n  requireFiniteResult([xyz.x, xyz.y, xyz.z], \"Chromatic adaptation\");\n  return calculatedResult({ xyz, matrix: adaptation.matrix }, \"chromatic-adaptation-\" + adaptation.transform, COLORIMETRY_MODEL_VERSION, [\n    \"Linear von Kries-type transform; degree of adaptation \" + adaptation.degreeOfAdaptation\n  ]);\n}\n"]}

package/dist/color/color-difference.d.ts

@@ -0,0 +1,104 @@
+/**
+ * CIELAB / CIELCh(ab) conversions and colour-difference formulae.
+ *
+ * - CIELAB (W3C CSS Color 4 Lab; also CIE 15:2018 §8.2.1) with the exact rational constants ε = (6/29)³ and
+ *   κ = (29/3)³ in the linear segment.
+ * - ΔE*ab 1976: Euclidean CIELAB distance.
+ * - ΔE*94: asymmetric (first colour is the reference: S_L = 1, S_C = 1 + K₁C*₁, S_H = 1 + K₂C*₁). The
+ *   default is the formula's published reference conditions (k_L = k_C = k_H = 1, K₁ = 0.045,
+ *   K₂ = 0.015, often called "graphic arts"); callers may pass their own factors in `cie94Factors`.
+ *   The engine ships no other preset. The primary source, CIE 116-1995, is not free. The tests check
+ *   the closed forms for pure lightness, chroma and hue differences and the reference asymmetry.
+ * - CIEDE2000, implemented from the formula and implementation notes in Sharma, Wu & Dalal
+ *   (2005), Color Res. Appl. 30(1):21–30 (paper free at
+ *   https://hajim.rochester.edu/ece/sites/gsharma/ciede2000/; also CIE 142-2001, ISO/CIE 11664-6).
+ *   This includes the hue-angle averaging and the handling of the hue discontinuity. The tests check
+ *   its closed forms for pure lightness, chroma and hue differences (computed in the test), symmetry
+ *   and identity; the published test pairs are not used (their data file has no licence).
+ * @see docs/COLORIMETRY.md for equations, coordinate/unit conventions and limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type CieXyzTristimulus } from "./colorimetry-math.js";
+/** CIE 1976 L*a*b* coordinates. */
+export interface CielabColor {
+    lStar: number;
+    aStar: number;
+    bStar: number;
+}
+/** CIE 1976 L*C*h(ab) coordinates; hue in degrees [0, 360). */
+export interface CielchColor {
+    lStar: number;
+    chromaStar: number;
+    hueDegrees: number;
+}
+/** Internal: XYZ → CIELAB with a validated white (no envelope). */
+export declare function cielabOfXyz(xyz: CieXyzTristimulus, white: CieXyzTristimulus): CielabColor;
+/** Internal: CIELAB → XYZ. */
+export declare function xyzOfCielab(lab: CielabColor, white: CieXyzTristimulus): CieXyzTristimulus;
+/** CIE XYZ → CIELAB relative to a reference white (same XYZ scale). */
+export declare function calculateCielabFromXyz(input: {
+    xyz: CieXyzTristimulus;
+    referenceWhiteXyz: CieXyzTristimulus;
+}): CalculationResult<CielabColor>;
+/** CIELAB → CIE XYZ relative to a reference white. */
+export declare function calculateXyzFromCielab(input: {
+    lab: CielabColor;
+    referenceWhiteXyz: CieXyzTristimulus;
+}): CalculationResult<CieXyzTristimulus>;
+/** Internal: CIELAB → LCh(ab). */
+export declare function cielchOfCielab(lab: CielabColor): CielchColor;
+/** Internal: LCh(ab) → CIELAB. */
+export declare function cielabOfCielch(lch: CielchColor): CielabColor;
+/** CIELAB → CIE LCh(ab): C*ab = √(a*² + b*²), h_ab = atan2(b*, a*) in degrees. */
+export declare function calculateCielchFromCielab(input: {
+    lab: CielabColor;
+}): CalculationResult<CielchColor>;
+/** CIE LCh(ab) → CIELAB. */
+export declare function calculateCielabFromCielch(input: {
+    lch: CielchColor;
+}): CalculationResult<CielabColor>;
+/** Colour-difference formula. */
+export type ColorDifferenceFormula = "cie76" | "cie94" | "ciede2000";
+/** CIEDE2000 parametric factors (default 1, 1, 1 for reference conditions). */
+export interface Ciede2000ParametricFactors {
+    lightness: number;
+    chroma: number;
+    hue: number;
+}
+/**
+ * CIE94 parametric factors k_L, k_C, k_H and weighting constants K₁, K₂ (S_C = 1 + K₁C*₁,
+ * S_H = 1 + K₂C*₁). The default is the reference conditions: 1, 1, 1, 0.045, 0.015.
+ */
+export interface Cie94ParametricFactors {
+    /** k_L, greater than zero. */
+    lightness: number;
+    /** k_C, greater than zero. */
+    chroma: number;
+    /** k_H, greater than zero. */
+    hue: number;
+    /** K₁ in S_C = 1 + K₁C*₁; finite and not negative. */
+    k1: number;
+    /** K₂ in S_H = 1 + K₂C*₁; finite and not negative. */
+    k2: number;
+}
+/** Internal: ΔE*ab 1976. */
+export declare function deltaE76(a: CielabColor, b: CielabColor): number;
+/** Internal: ΔE*94 with reference colour `reference`. */
+export declare function deltaE94(reference: CielabColor, sample: CielabColor, factors?: Cie94ParametricFactors): number;
+/** Internal: CIEDE2000 (Sharma, Wu & Dalal 2005 implementation notes). */
+export declare function deltaE2000(lab1: CielabColor, lab2: CielabColor, k?: Ciede2000ParametricFactors): number;
+export interface CalculateColorDifferenceInput {
+    /** Reference (standard) colour; ΔE94 is asymmetric in it. */
+    reference: CielabColor;
+    sample: CielabColor;
+    formula: ColorDifferenceFormula;
+    /** CIEDE2000 only; defaults to 1, 1, 1. */
+    parametricFactors?: Ciede2000ParametricFactors;
+    /** CIE94 only; all five fields are required when given. Defaults to the reference conditions 1, 1, 1, 0.045, 0.015. */
+    cie94Factors?: Cie94ParametricFactors;
+}
+/** Colour difference between two CIELAB colours with an explicit formula. */
+export declare function calculateColorDifference(input: CalculateColorDifferenceInput): CalculationResult<{
+    deltaE: number;
+    formula: ColorDifferenceFormula;
+}>;