@photivra/engine 1.4.0 → 2.0.0

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

@@ -3,7 +3,7 @@ import { type ResolvedWhiteBalanceState, type WhiteBalanceChannelGains } from ".
 import { type FocusPlane } from "../optics/focus-state.js";
 import { type ResolveCaptureGeometryInput, type ResolvedCaptureGeometry } from "../output/capture-geometry.js";
 export declare const SIMULATED_CAPTURE_SCHEMA_VERSION: "0.2.0";
-/** Distinct linear domains, not one interchangeable 'linear' flag. */
+/** Which kind of linear data a plane holds. These are different domains, not one interchangeable "linear" flag. */
 export type CaptureLinearImageState = "scene-referred-xyz" | "virtual-sensor-channels" | "color-transformed-linear-rgb";
 export interface CapturePublicProfileReference {
     id: string;
@@ -15,7 +15,7 @@ export interface CaptureWhiteXyz {
     y: 1;
     z: number;
 }
-/** A resolved #108 choice, sanitized for public metadata. No estimator is rerun. */
+/** A resolved white-balance state (ResolvedWhiteBalanceState), cleaned for public metadata. No WB estimator is rerun. */
 export interface CaptureWhiteBalanceIntent {
     stateId: string;
     source: ResolvedWhiteBalanceState["source"];
@@ -23,7 +23,7 @@ export interface CaptureWhiteBalanceIntent {
     channelGains: WhiteBalanceChannelGains;
     sourceProfile: CapturePublicProfileReference | null;
 }
-/** External bytes are caller-owned; the engine never reads a path or URL. */
+/** External bytes belong to the caller. The engine never reads a path or URL. */
 export type CaptureFloatStorage = {
     kind: "inline-float64";
     samples: readonly number[];
@@ -34,7 +34,7 @@ export type CaptureFloatStorage = {
     sha256: string;
     sampleCount: number;
 };
-/** Linear float plane; all channels are co-sited and interleaved in row-major order. */
+/** Linear float plane. All channels are sampled at the same positions and interleaved in row-major order. */
 export interface CaptureLinearPlane {
     id: string;
     imageStateId: string;
@@ -44,9 +44,9 @@ export interface CaptureLinearPlane {
     pixelHeight: number;
     channelIds: readonly string[];
     colorProfile: CapturePublicProfileReference | null;
-    /** Defined for colorimetric/RGB encodings; null for unresolved sensor channels. */
+    /** Set for colorimetric (RGB) encodings; null for raw sensor channels with no colour meaning yet. */
     encodingReferenceWhiteXyz: CaptureWhiteXyz | null;
-    /** Value normalization, independent of capture saturation or eventual integer white. */
+    /** How values are normalized. Independent of capture saturation and of any later integer white level. */
     referenceWhiteValue: number;
     whiteBalanceApplication: "intent-only" | "applied-rgb-gains" | "applied-chromatic-adaptation" | "not-applicable";
     captureSaturation: {
@@ -62,7 +62,7 @@ export interface CaptureLinearPlane {
     }[];
     storage: CaptureFloatStorage;
 }
-/** Format-neutral input from an upstream master/capture provider, not a preview image. */
+/** Input from an upstream master or capture provider, independent of file format. Not a preview image. */
 export interface SimulatedCaptureInput {
     captureId: string;
     sceneStateId: string;
@@ -88,7 +88,7 @@ export interface SimulatedCaptureInput {
         dynamicRangeHistory: "unknown" | "no-loss-declared" | "upstream-clipped";
     };
     whiteBalanceIntent: CaptureWhiteBalanceIntent | null;
-    /** Adopted/WB white is a camera choice, not automatically the encoding white. */
+    /** The adopted (WB) white is a camera choice. It is not automatically the encoding white. */
     adoptedWhiteXyz: CaptureWhiteXyz | null;
     models: readonly {
         profile: CapturePublicProfileReference;
@@ -97,37 +97,36 @@ export interface SimulatedCaptureInput {
     }[];
     planes: readonly CaptureLinearPlane[];
 }
-/** Immutable committed value. Geometry/focal equivalence are derived, never caller overrides. */
+/** The immutable committed capture. Geometry and equivalent focal length are computed, never taken from the caller. */
 export interface SimulatedCapture extends SimulatedCaptureInput {
     schemaVersion: typeof SIMULATED_CAPTURE_SCHEMA_VERSION;
     engineApiVersion: string;
     resolvedGeometry: ResolvedCaptureGeometry;
     equivalentFocalLength35Mm: number;
 }
-/** Converts validated shooting WB into a public metadata allowlist, discarding private extras. */
+/** Converts the validated shooting WB to the allowed public metadata fields, dropping private extras. */
 export declare function createCaptureWhiteBalanceIntent(input: {
     state: ResolvedWhiteBalanceState;
 }): CaptureWhiteBalanceIntent;
-/** A procedural/physical source identity without a manufactured linear-master plane. */
+/** Identifies a procedural or physical source, without making up a linear master plane. */
 export type CaptureExposureSource = SimulatedCaptureInput["source"] | (Omit<SimulatedCaptureInput["source"], "kind"> & {
     kind: "scene-radiance-source";
 });
-/** Internal shared exposure metadata parser. It does not commit or invent float planes. */
+/** Internal: shared parser for exposure metadata. It does not commit or make up float planes. */
 export declare function normalizeCaptureExposureMetadata(value: unknown, apiVersion: string, allowRadianceSource?: boolean): Omit<SimulatedCapture, "schemaVersion" | "planes" | "source"> & {
     source: CaptureExposureSource;
 };
-/** Commits a format-neutral float master manifest; no radiance generation, clamp, WB or export encoding. */
+/** Commits a capture with a manifest of float master planes. No radiance generation, clipping, WB or file encoding. */
 export declare function createSimulatedCapture(input: SimulatedCaptureInput): CalculationResult<SimulatedCapture>;
 /** Parses an archived capture, recomputing and checking all derived geometry/focal metadata. */
 export declare function parseSimulatedCapture(value: unknown): SimulatedCapture;
-/** Canonical allowlisted JSON, including semantic samples/IDs, not private caches or file layout. */
+/** Canonical JSON of the allowed fields, including sample values and IDs. Excludes private caches and file layout. */
 export declare function serializeSimulatedCapture(input: {
     capture: SimulatedCapture;
 }): string;
-/** Requires an exact plane image state; callers may not substitute another kind of 'linear'. */
+/** Requires the exact image state of the plane. Callers cannot substitute another kind of "linear". */
 export declare function resolveSimulatedCapturePlane(input: {
     capture: SimulatedCapture;
     planeId: string;
     requiredImageState: CaptureLinearImageState;
 }): CaptureLinearPlane;
-//# sourceMappingURL=simulated-capture.d.ts.map

package/dist/capture/simulated-capture.js

@@ -1,15 +1,16 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Converts validated shooting WB into a public metadata allowlist, discarding private extras.
- * Commits a format-neutral float master manifest; no radiance generation, clamp, WB or export
- * encoding.
+ * Simulated captures: the committed record of one exposure, with its settings, geometry, white-balance
+ * (WB) choice and a manifest of linear float image planes, independent of any file format.
+ *
+ * Committing a capture does not generate radiance, clip, apply WB or encode a file.
  * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
-import { requireAllowlistedRecord, requirePublicOpaqueId } from "../core/record-validation.js";
+import { requireAllowlistedRecord, requirePublicOpaqueId, requireInputKeys } from "../core/record-validation.js";
 import { stringifyCanonicalJson } from "../core/canonical-json.js";
 import { freezeOwnedData } from "../core/owned-data.js";
+import { equalWithinUlps } from "../core/portable-math.js";
 import { calculatedResult } from "../core/calculation-result.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { ENGINE_API_VERSION } from "../core/version.js";
@@ -70,12 +71,13 @@ function wb(value) {
     const g = object(r.channelGains, ["red", "green", "blue"]);
     if (typeof r.locked !== "boolean")
         throw new InvalidConfigurationError("WB lock must be boolean.");
-    return { stateId: id(r.stateId), source: enumValue(r.source, ["preset", "manual-gains", "custom-measurement", "auto-white-balance"]),
+    return { stateId: id(r.stateId), source: enumValue(r.source, ["preset", "manual-gains", "custom-measurement", "auto-white-balance", "color-temperature"]),
         locked: r.locked, channelGains: { red: number(g.red, true), green: number(g.green, true), blue: number(g.blue, true) },
         sourceProfile: r.sourceProfile === null ? null : profile(r.sourceProfile) };
 }
-/** Converts validated shooting WB into a public metadata allowlist, discarding private extras. */
+/** Converts the validated shooting WB to the allowed public metadata fields, dropping private extras. */
 export function createCaptureWhiteBalanceIntent(input) {
+    requireInputKeys(input, "createCaptureWhiteBalanceIntent", ["state"]);
     const state = parseResolvedWhiteBalanceState(input.state);
     return wb({ stateId: state.stateId, source: state.source, locked: state.locked, channelGains: state.channelGains,
         sourceProfile: state.sourceProfile ? { id: state.sourceProfile.profileId, version: state.sourceProfile.profileVersion } : null });
@@ -164,7 +166,7 @@ function plane(value, resolved, intent) {
         channelIds: channels, colorProfile, encodingReferenceWhiteXyz: referenceWhite, referenceWhiteValue: number(r.referenceWhiteValue, true),
         whiteBalanceApplication: application, captureSaturation, appliedTransforms: transforms, storage };
 }
-/** Internal shared exposure metadata parser. It does not commit or invent float planes. */
+/** Internal: shared parser for exposure metadata. It does not commit or make up float planes. */
 export function normalizeCaptureExposureMetadata(value, apiVersion, allowRadianceSource = false) {
     const r = object(value, ["captureId", "sceneStateId", "sceneTimeSeconds", "geometry", "exposure", "focus", "noise", "source",
         "whiteBalanceIntent", "adoptedWhiteXyz", "models"]);
@@ -214,10 +216,12 @@ function normalize(value, apiVersion) {
     }
     return freezeOwnedData({ ...metadata, source: metadata.source, schemaVersion: SIMULATED_CAPTURE_SCHEMA_VERSION, planes });
 }
-/** Commits a format-neutral float master manifest; no radiance generation, clamp, WB or export encoding. */
+/** Commits a capture with a manifest of float master planes. No radiance generation, clipping, WB or file encoding. */
 export function createSimulatedCapture(input) {
     return calculatedResult(normalize(input, ENGINE_API_VERSION), "authoritative-linear-capture-container", "0.1.0", ["Structural commitment only; upstream scientific statuses remain independent", "Master/source declarations do not prove source fidelity", "No tone mapping, recovered headroom, physical sensor calibration or serializer inferred"]);
 }
+/** Tolerance, in ULPs (units in the last place), when re-checking an archived 35 mm-equivalent focal length (see NUMERICAL_CORRECTNESS.md). */
+const DERIVED_FOCAL_LENGTH_ULPS = 8;
 /** Parses an archived capture, recomputing and checking all derived geometry/focal metadata. */
 export function parseSimulatedCapture(value) {
     const r = object(value, ["schemaVersion", "engineApiVersion", "captureId", "sceneStateId", "sceneTimeSeconds", "geometry", "resolvedGeometry",
@@ -229,7 +233,11 @@ export function parseSimulatedCapture(value) {
     }
     const { schemaVersion: _schemaVersion, engineApiVersion, resolvedGeometry, equivalentFocalLength35Mm, ...input } = r;
     const result = normalize(input, id(engineApiVersion));
-    if (canonical(resolvedGeometry) !== canonical(result.resolvedGeometry) || equivalentFocalLength35Mm !== result.equivalentFocalLength35Mm) {
+    // The equivalent focal length is recomputed. An archived value within a few ULPs is accepted, so records
+    // written by another JavaScript engine or by releases before 2.0.0 (which used Math.hypot) still parse.
+    if (canonical(resolvedGeometry) !== canonical(result.resolvedGeometry) ||
+        typeof equivalentFocalLength35Mm !== "number" ||
+        !equalWithinUlps(equivalentFocalLength35Mm, result.equivalentFocalLength35Mm, DERIVED_FOCAL_LENGTH_ULPS)) {
         throw new InvalidConfigurationError("Archived derived capture metadata is inconsistent.");
     }
     // _schemaVersion is already checked, not copied as an unchecked discriminator.
@@ -243,12 +251,14 @@ function canonical(value) {
         unsupportedValueMessage: "Derived capture metadata must be finite JSON."
     });
 }
-/** Canonical allowlisted JSON, including semantic samples/IDs, not private caches or file layout. */
+/** Canonical JSON of the allowed fields, including sample values and IDs. Excludes private caches and file layout. */
 export function serializeSimulatedCapture(input) {
+    requireInputKeys(input, "serializeSimulatedCapture", ["capture"]);
     return JSON.stringify(parseSimulatedCapture(input.capture));
 }
-/** Requires an exact plane image state; callers may not substitute another kind of 'linear'. */
+/** Requires the exact image state of the plane. Callers cannot substitute another kind of "linear". */
 export function resolveSimulatedCapturePlane(input) {
+    requireInputKeys(input, "resolveSimulatedCapturePlane", ["capture", "planeId", "requiredImageState"]);
     const capture = parseSimulatedCapture(input.capture);
     const state = enumValue(input.requiredImageState, ["scene-referred-xyz", "virtual-sensor-channels", "color-transformed-linear-rgb"]);
     const result = capture.planes.find((p) => p.id === id(input.planeId));

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

@@ -1 +1 @@
-{"version":3,"file":"simulated-capture.js","sourceRoot":"","sources":["../../src/capture/simulated-capture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"simulated-capture.js","sourceRoot":"","sources":["../../src/capture/simulated-capture.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Simulated captures: the committed record of one exposure, with its settings, geometry, white-balance\n * (WB) choice and a manifest of linear float image planes, independent of any file format.\n *\n * Committing a capture does not generate radiance, clip, apply WB or encode a file.\n * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { requireAllowlistedRecord, requirePublicOpaqueId, requireInputKeys } from \"../core/record-validation.js\";\nimport { stringifyCanonicalJson } from \"../core/canonical-json.js\";\nimport { freezeOwnedData } from \"../core/owned-data.js\";\nimport { equalWithinUlps } from \"../core/portable-math.js\";\nimport { calculatedResult, type CalculationResult, type ProvenanceKind } from \"../core/calculation-result.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { ENGINE_API_VERSION } from \"../core/version.js\";\nimport { parseResolvedWhiteBalanceState, type ResolvedWhiteBalanceState, type WhiteBalanceChannelGains } from \"../color/white-balance.js\";\nimport { calculateEquivalentFocalLength35Mm } from \"../camera/equivalent-focal-length.js\";\nimport { parseFocusPlane, type FocusPlane } from \"../optics/focus-state.js\";\nimport { resolveCaptureGeometry, type ResolveCaptureGeometryInput, type ResolvedCaptureGeometry } from \"../output/capture-geometry.js\";\n\nexport const SIMULATED_CAPTURE_SCHEMA_VERSION = \"0.2.0\" as const;\n/** Which kind of linear data a plane holds. These are different domains, not one interchangeable \"linear\" flag. */\nexport type CaptureLinearImageState = \"scene-referred-xyz\" | \"virtual-sensor-channels\" | \"color-transformed-linear-rgb\";\nexport interface CapturePublicProfileReference { id: string; version: string }\n/** Normalized tristimulus white; Y=1. This is not a spectrum or Kelvin value. */\nexport interface CaptureWhiteXyz { x: number; y: 1; z: number }\n/** A resolved white-balance state (ResolvedWhiteBalanceState), cleaned for public metadata. No WB estimator is rerun. */\nexport interface CaptureWhiteBalanceIntent {\n  stateId: string;\n  source: ResolvedWhiteBalanceState[\"source\"];\n  locked: boolean;\n  channelGains: WhiteBalanceChannelGains;\n  sourceProfile: CapturePublicProfileReference | null;\n}\n/** External bytes belong to the caller. The engine never reads a path or URL. */\nexport type CaptureFloatStorage =\n  | { kind: \"inline-float64\"; samples: readonly number[] }\n  | { kind: \"external-float32\" | \"external-float64\"; byteOrder: \"little-endian\"; artifactId: string; sha256: string; sampleCount: number };\n/** Linear float plane. All channels are sampled at the same positions and interleaved in row-major order. */\nexport interface CaptureLinearPlane {\n  id: string;\n  imageStateId: string;\n  imageState: CaptureLinearImageState;\n  rasterBinding: \"oriented-active-capture\" | \"output\";\n  pixelWidth: number;\n  pixelHeight: number;\n  channelIds: readonly string[];\n  colorProfile: CapturePublicProfileReference | null;\n  /** Set for colorimetric (RGB) encodings; null for raw sensor channels with no colour meaning yet. */\n  encodingReferenceWhiteXyz: CaptureWhiteXyz | null;\n  /** How values are normalized. Independent of capture saturation and of any later integer white level. */\n  referenceWhiteValue: number;\n  whiteBalanceApplication: \"intent-only\" | \"applied-rgb-gains\" | \"applied-chromatic-adaptation\" | \"not-applicable\";\n  captureSaturation:\n    | { kind: \"not-modeled\" }\n    | { kind: \"declared-virtual-white\"; whiteLevel: number; upstreamClippedSampleCount: number };\n  appliedTransforms: readonly { profile: CapturePublicProfileReference; kind: \"linear-color\" | \"chromatic-adaptation\" | \"digital-lens-correction\" }[];\n  storage: CaptureFloatStorage;\n}\n/** Input from an upstream master or capture provider, independent of file format. Not a preview image. */\nexport interface SimulatedCaptureInput {\n  captureId: string;\n  sceneStateId: string;\n  /** Seconds on the declared scene clock, not an embedded wall-clock timestamp. */\n  sceneTimeSeconds: number;\n  geometry: ResolveCaptureGeometryInput;\n  exposure: { focalLengthMm: number; aperture: number; shutterSeconds: number; iso: number };\n  focus: FocusPlane;\n  noise: { seedUint32: number; realizationId: string; model: CapturePublicProfileReference };\n  source: {\n    kind: \"scene-linear-master\" | \"sensor-derived-linear\" | \"color-transformed-linear-master\";\n    artifactId: string;\n    sha256: string;\n    dynamicRangeHistory: \"unknown\" | \"no-loss-declared\" | \"upstream-clipped\";\n  };\n  whiteBalanceIntent: CaptureWhiteBalanceIntent | null;\n  /** The adopted (WB) white is a camera choice. It is not automatically the encoding white. */\n  adoptedWhiteXyz: CaptureWhiteXyz | null;\n  models: readonly { profile: CapturePublicProfileReference; scientificStatus: ProvenanceKind; publicEvidenceIds: readonly string[] }[];\n  planes: readonly CaptureLinearPlane[];\n}\n/** The immutable committed capture. Geometry and equivalent focal length are computed, never taken from the caller. */\nexport interface SimulatedCapture extends SimulatedCaptureInput {\n  schemaVersion: typeof SIMULATED_CAPTURE_SCHEMA_VERSION;\n  engineApiVersion: string;\n  resolvedGeometry: ResolvedCaptureGeometry;\n  equivalentFocalLength35Mm: number;\n}\n\nfunction object(value: unknown, keys: readonly string[]): Record<string, unknown> {\n  return requireAllowlistedRecord(value, keys, \"Invalid or non-allowlisted capture metadata.\");\n}\nfunction enumValue<T extends string>(value: unknown, values: readonly T[]): T {\n  if (!values.includes(value as T)) throw new InvalidConfigurationError(\"Unknown capture state.\");\n  return value as T;\n}\nfunction number(value: unknown, positive = false): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || (positive && value <= 0)) throw new InvalidConfigurationError(\"Capture number must be finite with valid sign.\");\n  return Object.is(value, -0) ? 0 : value;\n}\nfunction integer(value: unknown, minimum = 1): number {\n  const n = number(value);\n  if (!Number.isSafeInteger(n) || n < minimum) throw new InvalidConfigurationError(\"Invalid capture integer.\");\n  return n;\n}\nfunction array(value: unknown, maximum: number): unknown[] {\n  if (!Array.isArray(value) || value.length > maximum ||\n      Array.from({ length: value.length }, (_, i) => i in value).includes(false)) throw new InvalidConfigurationError(\"Expected a bounded dense capture array.\");\n  return value;\n}\nfunction id(value: unknown): string {\n  return requirePublicOpaqueId(value, \"Expected a public opaque ID, not a path or URL.\");\n}\nfunction digest(value: unknown): string {\n  if (typeof value !== \"string\" || !/^[a-f0-9]{64}$/.test(value)) throw new InvalidConfigurationError(\"Expected a lowercase SHA-256 digest.\");\n  return value;\n}\nfunction profile(value: unknown): CapturePublicProfileReference {\n  const r = object(value, [\"id\", \"version\"]); return { id: id(r.id), version: id(r.version) };\n}\nfunction white(value: unknown): CaptureWhiteXyz | null {\n  if (value === null) return null;\n  const r = object(value, [\"x\", \"y\", \"z\"]);\n  if (r.y !== 1) throw new InvalidConfigurationError(\"White XYZ requires Y=1.\");\n  return { x: number(r.x, true), y: 1, z: number(r.z, true) };\n}\nfunction wb(value: unknown): CaptureWhiteBalanceIntent | null {\n  if (value === null) return null;\n  const r = object(value, [\"stateId\", \"source\", \"locked\", \"channelGains\", \"sourceProfile\"]);\n  const g = object(r.channelGains, [\"red\", \"green\", \"blue\"]);\n  if (typeof r.locked !== \"boolean\") throw new InvalidConfigurationError(\"WB lock must be boolean.\");\n  return { stateId: id(r.stateId), source: enumValue(r.source, [\"preset\", \"manual-gains\", \"custom-measurement\", \"auto-white-balance\", \"color-temperature\"]),\n    locked: r.locked, channelGains: { red: number(g.red, true), green: number(g.green, true), blue: number(g.blue, true) },\n    sourceProfile: r.sourceProfile === null ? null : profile(r.sourceProfile) };\n}\n/** Converts the validated shooting WB to the allowed public metadata fields, dropping private extras. */\nexport function createCaptureWhiteBalanceIntent(input: { state: ResolvedWhiteBalanceState }): CaptureWhiteBalanceIntent {\n  requireInputKeys(input, \"createCaptureWhiteBalanceIntent\", [\"state\"]);\n  const state = parseResolvedWhiteBalanceState(input.state);\n  return wb({ stateId: state.stateId, source: state.source, locked: state.locked, channelGains: state.channelGains,\n    sourceProfile: state.sourceProfile ? { id: state.sourceProfile.profileId, version: state.sourceProfile.profileVersion } : null })!;\n}\nfunction geometry(value: unknown): ResolveCaptureGeometryInput {\n  const r = object(value, [\"imagingArea\", \"nativeRaster\", \"orientation\", \"activeCaptureRect\", \"outputCropRect\", \"outputRaster\"]);\n  const area = object(r.imagingArea, [\"widthMm\", \"heightMm\"]), native = object(r.nativeRaster, [\"pixelWidth\", \"pixelHeight\"]);\n  const rect = (value: unknown): { x: number; y: number; width: number; height: number } => {\n    const p = object(value, [\"x\", \"y\", \"width\", \"height\"]);\n    return { x: integer(p.x, 0), y: integer(p.y, 0), width: integer(p.width), height: integer(p.height) };\n  };\n  const output = r.outputRaster === undefined ? undefined : object(r.outputRaster, [\"pixelWidth\", \"pixelHeight\"]);\n  return { imagingArea: { widthMm: number(area.widthMm, true), heightMm: number(area.heightMm, true) },\n    nativeRaster: { pixelWidth: integer(native.pixelWidth), pixelHeight: integer(native.pixelHeight) },\n    orientation: enumValue(r.orientation, [\"landscape\", \"portrait-clockwise\", \"landscape-inverted\", \"portrait-counter-clockwise\"]),\n    ...(r.activeCaptureRect === undefined ? {} : { activeCaptureRect: rect(r.activeCaptureRect) }),\n    ...(r.outputCropRect === undefined ? {} : { outputCropRect: rect(r.outputCropRect) }),\n    ...(output === undefined ? {} : { outputRaster: { pixelWidth: integer(output.pixelWidth), pixelHeight: integer(output.pixelHeight) } }) };\n}\nfunction plane(value: unknown, resolved: ResolvedCaptureGeometry, intent: CaptureWhiteBalanceIntent | null): CaptureLinearPlane {\n  const r = object(value, [\"id\", \"imageStateId\", \"imageState\", \"rasterBinding\", \"pixelWidth\", \"pixelHeight\", \"channelIds\", \"colorProfile\",\n    \"encodingReferenceWhiteXyz\", \"referenceWhiteValue\", \"whiteBalanceApplication\", \"captureSaturation\", \"appliedTransforms\", \"storage\"]);\n  const state = enumValue(r.imageState, [\"scene-referred-xyz\", \"virtual-sensor-channels\", \"color-transformed-linear-rgb\"]);\n  const binding = enumValue(r.rasterBinding, [\"oriented-active-capture\", \"output\"]);\n  const dimensions = binding === \"output\" ? resolved.output.raster : resolved.orientedCapture.raster;\n  const width = integer(r.pixelWidth), height = integer(r.pixelHeight), channels = array(r.channelIds, 32).map(id);\n  const count = width*height*channels.length;\n  if (width !== dimensions.pixelWidth || height !== dimensions.pixelHeight || !channels.length ||\n      new Set(channels).size !== channels.length || !Number.isSafeInteger(count)) throw new InvalidConfigurationError(\"Plane raster/channel identity mismatch.\");\n  const requiredChannels = state === \"scene-referred-xyz\" ? [\"X\", \"Y\", \"Z\"] : state === \"color-transformed-linear-rgb\" ? [\"red\", \"green\", \"blue\"] : null;\n  if (requiredChannels && JSON.stringify(channels) !== JSON.stringify(requiredChannels)) throw new InvalidConfigurationError(\"Channels do not match image state.\");\n  const colorProfile = r.colorProfile === null ? null : profile(r.colorProfile), referenceWhite = white(r.encodingReferenceWhiteXyz);\n  if (state === \"virtual-sensor-channels\" ? referenceWhite !== null || colorProfile === null : referenceWhite === null || colorProfile === null) {\n    throw new InvalidConfigurationError(\"Color metadata does not match image state.\");\n  }\n  if (state === \"scene-referred-xyz\" && (colorProfile!.id !== \"cie-1931-2-degree-xyz\" || colorProfile!.version !== \"1.0.0\")) {\n    throw new InvalidConfigurationError(\"XYZ planes require the explicit CIE 1931 2-degree identity.\");\n  }\n  const application = enumValue(r.whiteBalanceApplication, [\"intent-only\", \"applied-rgb-gains\", \"applied-chromatic-adaptation\", \"not-applicable\"]);\n  if (((application === \"intent-only\" || application === \"applied-rgb-gains\") && intent === null) ||\n      (application === \"applied-rgb-gains\" && JSON.stringify(channels) !== JSON.stringify([\"red\", \"green\", \"blue\"]))) {\n    throw new InvalidConfigurationError(\"WB application must refer to a resolved compatible RGB intent.\");\n  }\n  const s = object(r.storage, [\"kind\", \"samples\", \"artifactId\", \"sha256\", \"sampleCount\", \"byteOrder\"]);\n  const kind = enumValue(s.kind, [\"inline-float64\", \"external-float32\", \"external-float64\"]);\n  let storage: CaptureFloatStorage;\n  if (kind === \"inline-float64\") {\n    if (s.artifactId !== undefined || s.sha256 !== undefined || s.sampleCount !== undefined || s.byteOrder !== undefined) throw new InvalidConfigurationError(\"Inline plane cannot contain external storage fields.\");\n    const samples = array(s.samples, 1_000_000).map((v) => number(v));\n    if (samples.length !== count) throw new InvalidConfigurationError(\"Plane sample count mismatch.\");\n    storage = { kind, samples };\n  } else {\n    if (s.samples !== undefined || integer(s.sampleCount) !== count) throw new InvalidConfigurationError(\"External plane sample count/fields mismatch.\");\n    storage = { kind, byteOrder: enumValue(s.byteOrder, [\"little-endian\"]), artifactId: id(s.artifactId), sha256: digest(s.sha256), sampleCount: count };\n  }\n  const saturation = object(r.captureSaturation, [\"kind\", \"whiteLevel\", \"upstreamClippedSampleCount\"]);\n  const saturationKind = enumValue(saturation.kind, [\"not-modeled\", \"declared-virtual-white\"]);\n  let captureSaturation: CaptureLinearPlane[\"captureSaturation\"];\n  if (saturationKind === \"not-modeled\") {\n    if (saturation.whiteLevel !== undefined || saturation.upstreamClippedSampleCount !== undefined) throw new InvalidConfigurationError(\"Unmodeled saturation cannot assert a white level.\");\n    captureSaturation = { kind: saturationKind };\n  } else {\n    const clipped = integer(saturation.upstreamClippedSampleCount, 0);\n    if (clipped > count) throw new InvalidConfigurationError(\"Invalid clipped sample count.\");\n    captureSaturation = { kind: saturationKind, whiteLevel: number(saturation.whiteLevel, true), upstreamClippedSampleCount: clipped };\n  }\n  const transforms = array(r.appliedTransforms, 64).map((value): CaptureLinearPlane[\"appliedTransforms\"][number] => {\n    const t = object(value, [\"profile\", \"kind\"]);\n    return { profile: profile(t.profile), kind: enumValue(t.kind, [\"linear-color\", \"chromatic-adaptation\", \"digital-lens-correction\"]) };\n  });\n  if (state === \"color-transformed-linear-rgb\" && !transforms.some((t) => t.kind === \"linear-color\")) throw new InvalidConfigurationError(\"Transformed RGB requires explicit color-transform history.\");\n  if (application === \"applied-chromatic-adaptation\" && (state !== \"color-transformed-linear-rgb\" ||\n      !transforms.some((t) => t.kind === \"chromatic-adaptation\"))) throw new InvalidConfigurationError(\"Applied adaptation requires transformed RGB and adaptation history.\");\n  return { id: id(r.id), imageStateId: id(r.imageStateId), imageState: state, rasterBinding: binding, pixelWidth: width, pixelHeight: height,\n    channelIds: channels, colorProfile, encodingReferenceWhiteXyz: referenceWhite, referenceWhiteValue: number(r.referenceWhiteValue, true),\n    whiteBalanceApplication: application, captureSaturation, appliedTransforms: transforms, storage };\n}\n/** Identifies a procedural or physical source, without making up a linear master plane. */\nexport type CaptureExposureSource = SimulatedCaptureInput[\"source\"] | (Omit<SimulatedCaptureInput[\"source\"], \"kind\"> & {kind:\"scene-radiance-source\"});\n/** Internal: shared parser for exposure metadata. It does not commit or make up float planes. */\nexport function normalizeCaptureExposureMetadata(value: unknown, apiVersion: string, allowRadianceSource=false): Omit<SimulatedCapture, \"schemaVersion\" | \"planes\" | \"source\"> & {source:CaptureExposureSource} {\n  const r = object(value, [\"captureId\", \"sceneStateId\", \"sceneTimeSeconds\", \"geometry\", \"exposure\", \"focus\", \"noise\", \"source\",\n    \"whiteBalanceIntent\", \"adoptedWhiteXyz\", \"models\"]);\n  const g = geometry(r.geometry), resolved = resolveCaptureGeometry(g).value;\n  const e = object(r.exposure, [\"focalLengthMm\", \"aperture\", \"shutterSeconds\", \"iso\"]);\n  const exposure = { focalLengthMm: number(e.focalLengthMm, true), aperture: number(e.aperture, true),\n    shutterSeconds: number(e.shutterSeconds, true), iso: number(e.iso, true) };\n  const f = object(r.focus, [\"kind\", \"distanceM\"]), focus = parseFocusPlane(f);\n  const noise = object(r.noise, [\"seedUint32\", \"realizationId\", \"model\"]), seed = integer(noise.seedUint32, 0);\n  if (seed > 0xffffffff) throw new InvalidConfigurationError(\"Noise seed must be uint32.\");\n  const source = object(r.source, [\"kind\", \"artifactId\", \"sha256\", \"dynamicRangeHistory\"]);\n  const time = number(r.sceneTimeSeconds), intent = wb(r.whiteBalanceIntent);\n  if (time < 0) throw new InvalidConfigurationError(\"Scene time must be nonnegative.\");\n  const models = array(r.models, 128).map((value): SimulatedCapture[\"models\"][number] => {\n    const m = object(value, [\"profile\", \"scientificStatus\", \"publicEvidenceIds\"]), evidence = array(m.publicEvidenceIds, 128).map(id);\n    if (!evidence.length || new Set(evidence).size !== evidence.length) throw new InvalidConfigurationError(\"Public evidence IDs must be nonempty/unique.\");\n    return { profile: profile(m.profile), scientificStatus: enumValue(m.scientificStatus, [\"calculated\", \"calibrated\", \"estimated\", \"approximation\"]), publicEvidenceIds: evidence };\n  });\n  const adoptedWhite = white(r.adoptedWhiteXyz);\n  if (!models.length || new Set(models.map((m) => m.profile.id)).size !== models.length) {\n    throw new InvalidConfigurationError(\"Capture needs unique nonempty models.\");\n  }\n  return freezeOwnedData({ engineApiVersion: id(apiVersion),\n    captureId: id(r.captureId), sceneStateId: id(r.sceneStateId), sceneTimeSeconds: time, geometry: g, resolvedGeometry: resolved,\n    exposure, equivalentFocalLength35Mm: calculateEquivalentFocalLength35Mm({ focalLengthMm: exposure.focalLengthMm, activeImagingArea: resolved.activeCapture.imagingArea }).value.equivalentFocalLength35Mm,\n    focus, noise: { seedUint32: seed, realizationId: id(noise.realizationId), model: profile(noise.model) },\n    source: { kind: enumValue(source.kind, allowRadianceSource ? [\"scene-linear-master\", \"sensor-derived-linear\", \"color-transformed-linear-master\", \"scene-radiance-source\"] : [\"scene-linear-master\", \"sensor-derived-linear\", \"color-transformed-linear-master\"]),\n      artifactId: id(source.artifactId), sha256: digest(source.sha256), dynamicRangeHistory: enumValue(source.dynamicRangeHistory, [\"unknown\", \"no-loss-declared\", \"upstream-clipped\"]) },\n    whiteBalanceIntent: intent, adoptedWhiteXyz: adoptedWhite, models });\n}\nfunction normalize(value: unknown, apiVersion: string): SimulatedCapture {\n  const r = object(value, [\"captureId\", \"sceneStateId\", \"sceneTimeSeconds\", \"geometry\", \"exposure\", \"focus\", \"noise\", \"source\",\n    \"whiteBalanceIntent\", \"adoptedWhiteXyz\", \"models\", \"planes\"]);\n  const { planes: rawPlanes, ...metadataInput } = r;\n  const metadata = normalizeCaptureExposureMetadata(metadataInput, apiVersion);\n  const planes = array(rawPlanes, 32).map(p => plane(p, metadata.resolvedGeometry, metadata.whiteBalanceIntent));\n  if (planes.some(p => p.whiteBalanceApplication === \"applied-chromatic-adaptation\") && metadata.adoptedWhiteXyz === null) {\n    throw new InvalidConfigurationError(\"Applied adaptation requires an adopted white.\");\n  }\n  if (!planes.length || new Set(planes.map(p => p.id)).size !== planes.length ||\n      new Set(planes.map(p => p.imageStateId)).size !== planes.length ||\n      planes.reduce((n,p) => n+(p.storage.kind === \"inline-float64\" ? p.storage.samples.length : 0),0) > 1_000_000) {\n    throw new InvalidConfigurationError(\"Capture needs unique models/planes/states and a bounded inline sample budget.\");\n  }\n  return freezeOwnedData({ ...metadata, source:metadata.source as SimulatedCapture[\"source\"], schemaVersion: SIMULATED_CAPTURE_SCHEMA_VERSION, planes });\n}\n/** Commits a capture with a manifest of float master planes. No radiance generation, clipping, WB or file encoding. */\nexport function createSimulatedCapture(input: SimulatedCaptureInput): CalculationResult<SimulatedCapture> {\n  return calculatedResult(normalize(input, ENGINE_API_VERSION), \"authoritative-linear-capture-container\", \"0.1.0\",\n    [\"Structural commitment only; upstream scientific statuses remain independent\", \"Master/source declarations do not prove source fidelity\", \"No tone mapping, recovered headroom, physical sensor calibration or serializer inferred\"]);\n}\n/** Tolerance, in ULPs (units in the last place), when re-checking an archived 35 mm-equivalent focal length (see NUMERICAL_CORRECTNESS.md). */\nconst DERIVED_FOCAL_LENGTH_ULPS = 8;\n/** Parses an archived capture, recomputing and checking all derived geometry/focal metadata. */\nexport function parseSimulatedCapture(value: unknown): SimulatedCapture {\n  const r = object(value, [\"schemaVersion\", \"engineApiVersion\", \"captureId\", \"sceneStateId\", \"sceneTimeSeconds\", \"geometry\", \"resolvedGeometry\",\n    \"equivalentFocalLength35Mm\", \"exposure\", \"focus\", \"noise\", \"source\", \"whiteBalanceIntent\", \"adoptedWhiteXyz\", \"models\", \"planes\"]);\n  if (r.schemaVersion !== SIMULATED_CAPTURE_SCHEMA_VERSION && r.schemaVersion !== \"0.1.0\") throw new InvalidConfigurationError(\"Unsupported capture schema.\");\n  if (r.schemaVersion === \"0.1.0\" && Array.isArray(r.planes) && r.planes.some((p: CaptureLinearPlane) => p?.whiteBalanceApplication === \"applied-chromatic-adaptation\")) {\n    throw new InvalidConfigurationError(\"Legacy capture schema cannot declare the new adaptation state.\");\n  }\n  const { schemaVersion: _schemaVersion, engineApiVersion, resolvedGeometry, equivalentFocalLength35Mm, ...input } = r;\n  const result = normalize(input, id(engineApiVersion));\n  // The equivalent focal length is recomputed. An archived value within a few ULPs is accepted, so records\n  // written by another JavaScript engine or by releases before 2.0.0 (which used Math.hypot) still parse.\n  if (canonical(resolvedGeometry) !== canonical(result.resolvedGeometry) ||\n      typeof equivalentFocalLength35Mm !== \"number\" ||\n      !equalWithinUlps(equivalentFocalLength35Mm, result.equivalentFocalLength35Mm, DERIVED_FOCAL_LENGTH_ULPS)) {\n    throw new InvalidConfigurationError(\"Archived derived capture metadata is inconsistent.\");\n  }\n  // _schemaVersion is already checked, not copied as an unchecked discriminator.\n  void _schemaVersion;\n  return result;\n}\nfunction canonical(value: unknown): string {\n  return stringifyCanonicalJson(value, {\n    undefinedObjectProperties: \"reject\",\n    nonFiniteNumberMessage: \"Capture number must be finite with valid sign.\",\n    unsupportedValueMessage: \"Derived capture metadata must be finite JSON.\"\n  });\n}\n\n/** Canonical JSON of the allowed fields, including sample values and IDs. Excludes private caches and file layout. */\nexport function serializeSimulatedCapture(input: { capture: SimulatedCapture }): string {\n  requireInputKeys(input, \"serializeSimulatedCapture\", [\"capture\"]);\n  return JSON.stringify(parseSimulatedCapture(input.capture));\n}\n/** Requires the exact image state of the plane. Callers cannot substitute another kind of \"linear\". */\nexport function resolveSimulatedCapturePlane(input: {\n  capture: SimulatedCapture; planeId: string; requiredImageState: CaptureLinearImageState;\n}): CaptureLinearPlane {\n  requireInputKeys(input, \"resolveSimulatedCapturePlane\", [\"capture\", \"planeId\", \"requiredImageState\"]);\n  const capture = parseSimulatedCapture(input.capture);\n  const state = enumValue(input.requiredImageState, [\"scene-referred-xyz\", \"virtual-sensor-channels\", \"color-transformed-linear-rgb\"]);\n  const result = capture.planes.find((p) => p.id === id(input.planeId));\n  if (!result || result.imageState !== state) throw new InvalidConfigurationError(\"Capture plane missing or incompatible image state.\");\n  return result;\n}\n"]}

package/dist/color/camera-color-matrix.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Fits a 3×3 camera-RGB → CIE XYZ matrix from caller-supplied spectral data.
+ *
+ * For each training reflectance R_j under illuminant S:
+ *   camera ρ_j,c = k_c Σ S(λ) R_j(λ) s_c(λ) Δλ,   target X_j = k Σ S(λ) R_j(λ) x̄(λ) Δλ
+ * k is chosen so the perfect diffuser has Y = 1. k_c (the same for all channels) is chosen so
+ * the camera's response to the perfect diffuser has green = 1.
+ *
+ * Two fits are available:
+ * - Ordinary least squares: M minimizes Σ_j ‖M ρ_j − X_j‖², so M = X Pᵀ (P Pᵀ)⁻¹.
+ * - White-point-preserving least squares: the same, subject to M ρ_white = X_white exactly
+ *   (Finlayson & Drew 1997, "White-point preserving color correction", IS&T/SID CIC5). It is
+ *   solved in closed form with one Lagrange multiplier per row.
+ *
+ * Residual errors are reported per patch as CIEDE2000, with CIELAB relative to the illuminant
+ * white (no chromatic adaptation). A 3×3 matrix is exact only if the camera meets the
+ * Luther–Ives condition. Otherwise the result is an estimate, and its error depends on the
+ * training set. No camera, reflectance or ColorChecker data is bundled. Reflectance tables with an
+ * unclear licence must come from the caller.
+ * @see docs/COLORIMETRY.md for equations, coordinate/unit conventions and limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type ColorMatchingFunctionsSource, type ColorimetricQuadratureNode, type ColorimetricSpectrum } from "./color-matching-functions.js";
+import { type CieXyzTristimulus, type ColorMatrix3x3, type ColorVector3 } from "./colorimetry-math.js";
+export declare const MAX_CAMERA_MATRIX_TRAINING_PATCHES = 10000;
+export interface CameraSpectralSensitivities {
+    red: ColorimetricSpectrum;
+    green: ColorimetricSpectrum;
+    blue: ColorimetricSpectrum;
+}
+export interface CameraMatrixTrainingPatch {
+    patchId: string;
+    reflectance: ColorimetricSpectrum;
+}
+export type CameraMatrixFitConstraint = "least-squares" | "white-point-preserving-least-squares";
+export interface EstimateCameraColorMatrixInput {
+    quadratureNodes: readonly ColorimetricQuadratureNode[];
+    illuminant: ColorimetricSpectrum;
+    cameraSpectralSensitivities: CameraSpectralSensitivities;
+    patches: readonly CameraMatrixTrainingPatch[];
+    colorMatchingFunctions: ColorMatchingFunctionsSource;
+    constraint: CameraMatrixFitConstraint;
+}
+export interface CameraMatrixPatchReport {
+    patchId: string;
+    cameraRgb: ColorVector3;
+    targetXyz: CieXyzTristimulus;
+    predictedXyz: CieXyzTristimulus;
+    deltaE2000: number;
+}
+export interface CameraColorMatrixFit {
+    constraint: CameraMatrixFitConstraint;
+    /** Row-major camera RGB → XYZ (XYZ white Y = 1; camera white green = 1). */
+    cameraRgbToXyz: ColorMatrix3x3;
+    xyzToCameraRgb: ColorMatrix3x3;
+    illuminantWhiteXyz: CieXyzTristimulus;
+    /** Camera response to the perfect diffuser (green = 1); its reciprocal gives neutral WB gains. */
+    cameraWhiteRgb: ColorVector3;
+    patches: readonly CameraMatrixPatchReport[];
+    meanDeltaE2000: number;
+    maximumDeltaE2000: number;
+    /** Root-mean-square XYZ residual over all patches and components. */
+    rmsXyzResidual: number;
+}
+/**
+ * Fits a camera-RGB → XYZ matrix from spectral sensitivities, training reflectances,
+ * an illuminant and CMFs, and reports the per-patch CIEDE2000 residual.
+ */
+export declare function estimateCameraColorMatrix(input: EstimateCameraColorMatrixInput): CalculationResult<CameraColorMatrixFit>;

package/dist/color/camera-color-matrix.js

@@ -0,0 +1,132 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Fits a 3×3 camera-RGB → CIE XYZ matrix from caller-supplied spectral data.
+ *
+ * For each training reflectance R_j under illuminant S:
+ *   camera ρ_j,c = k_c Σ S(λ) R_j(λ) s_c(λ) Δλ,   target X_j = k Σ S(λ) R_j(λ) x̄(λ) Δλ
+ * k is chosen so the perfect diffuser has Y = 1. k_c (the same for all channels) is chosen so
+ * the camera's response to the perfect diffuser has green = 1.
+ *
+ * Two fits are available:
+ * - Ordinary least squares: M minimizes Σ_j ‖M ρ_j − X_j‖², so M = X Pᵀ (P Pᵀ)⁻¹.
+ * - White-point-preserving least squares: the same, subject to M ρ_white = X_white exactly
+ *   (Finlayson & Drew 1997, "White-point preserving color correction", IS&T/SID CIC5). It is
+ *   solved in closed form with one Lagrange multiplier per row.
+ *
+ * Residual errors are reported per patch as CIEDE2000, with CIELAB relative to the illuminant
+ * white (no chromatic adaptation). A 3×3 matrix is exact only if the camera meets the
+ * Luther–Ives condition. Otherwise the result is an estimate, and its error depends on the
+ * training set. No camera, reflectance or ColorChecker data is bundled. Reflectance tables with an
+ * unclear licence must come from the caller.
+ * @see docs/COLORIMETRY.md for equations, coordinate/unit conventions and limits.
+ */
+import { estimatedResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { COLORIMETRY_MODEL_VERSION, integrateSampledXyz, prepareColorMatchingFunctions, prepareColorimetricSpectrum, sampleColorimetricBasis, sampleFactor } from "./color-matching-functions.js";
+import { cielabOfXyz, deltaE2000 } from "./color-difference.js";
+import { invertMatrix3x3, multiplyMatrixVector, requireFiniteResult, vectorToXyz, xyzToVector } from "./colorimetry-math.js";
+import { requireInputKeys } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+export const MAX_CAMERA_MATRIX_TRAINING_PATCHES = 10_000;
+function solveRow(aInv, rhs, white, whiteTarget) {
+    // Unconstrained normal equations: m = A⁻¹ b with A = P Pᵀ, b = P xᵀ.
+    const m = multiplyMatrixVector(aInv, rhs);
+    if (white === undefined)
+        return m;
+    const aInvW = multiplyMatrixVector(aInv, white);
+    const wAw = white[0] * aInvW[0] + white[1] * aInvW[1] + white[2] * aInvW[2];
+    const residual = whiteTarget - (m[0] * white[0] + m[1] * white[1] + m[2] * white[2]);
+    return [m[0] + (aInvW[0] * residual) / wAw, m[1] + (aInvW[1] * residual) / wAw, m[2] + (aInvW[2] * residual) / wAw];
+}
+/**
+ * Fits a camera-RGB → XYZ matrix from spectral sensitivities, training reflectances,
+ * an illuminant and CMFs, and reports the per-patch CIEDE2000 residual.
+ */
+export function estimateCameraColorMatrix(input) {
+    requireInputKeys(input, "estimateCameraColorMatrix", ["quadratureNodes", "illuminant", "cameraSpectralSensitivities", "patches", "colorMatchingFunctions", "constraint"]);
+    if (input.constraint !== "least-squares" && input.constraint !== "white-point-preserving-least-squares") {
+        throw new InvalidConfigurationError("constraint is not supported.");
+    }
+    if (!Array.isArray(input.patches) || input.patches.length < 3 || input.patches.length > MAX_CAMERA_MATRIX_TRAINING_PATCHES) {
+        throw new InvalidScientificInputError("patches must contain between 3 and " + MAX_CAMERA_MATRIX_TRAINING_PATCHES + " entries.");
+    }
+    const cmf = prepareColorMatchingFunctions(input.colorMatchingFunctions);
+    const illuminant = prepareColorimetricSpectrum(input.illuminant, "illuminant");
+    const basis = sampleColorimetricBasis(input.quadratureNodes, illuminant, cmf);
+    const sens = input.cameraSpectralSensitivities;
+    if (typeof sens !== "object" || sens === null)
+        throw new InvalidConfigurationError("cameraSpectralSensitivities must be an object.");
+    const channel = ["red", "green", "blue"].map((c) => sampleFactor(basis, prepareColorimetricSpectrum(sens[c], "cameraSpectralSensitivities." + c)));
+    const ids = new Set();
+    const n = basis.nodes.length;
+    const cameraOf = (factor) => {
+        const out = [0, 0, 0];
+        for (let i = 0; i < n; i++) {
+            const w = basis.weights[i] * factor[i];
+            for (let c = 0; c < 3; c++)
+                out[c] += w * channel[c][i];
+        }
+        return out;
+    };
+    const ones = sampleFactor(basis, undefined);
+    const rawWhiteXyz = integrateSampledXyz(basis, ones);
+    const rawWhiteRgb = cameraOf(ones);
+    if (!(rawWhiteXyz.y > 0) || !(rawWhiteRgb[1] > 0))
+        throw new InvalidScientificInputError("The illuminant must give positive Y and positive camera green for the perfect diffuser.");
+    const kXyz = 1 / rawWhiteXyz.y, kRgb = 1 / rawWhiteRgb[1];
+    const scale = (v, k) => [v[0] * k, v[1] * k, v[2] * k];
+    const whiteXyz = scale(xyzToVector(rawWhiteXyz), kXyz);
+    const whiteRgb = scale(rawWhiteRgb, kRgb);
+    const rows = input.patches.map((patch, j) => {
+        if (typeof patch !== "object" || patch === null || typeof patch.patchId !== "string" || patch.patchId.trim().length === 0) {
+            throw new InvalidConfigurationError("patches[" + j + "].patchId must be a non-empty string.");
+        }
+        if (ids.has(patch.patchId))
+            throw new InvalidScientificInputError("patches must not repeat patchId.");
+        ids.add(patch.patchId);
+        const factor = sampleFactor(basis, prepareColorimetricSpectrum(patch.reflectance, "patches[" + j + "].reflectance"));
+        return { patchId: patch.patchId, rgb: scale(cameraOf(factor), kRgb), xyz: scale(xyzToVector(integrateSampledXyz(basis, factor)), kXyz) };
+    });
+    const a = [[0, 0, 0], [0, 0, 0], [0, 0, 0]];
+    const b = [[0, 0, 0], [0, 0, 0], [0, 0, 0]]; // b[outputRow][cameraChannel]
+    for (const r of rows) {
+        for (let p = 0; p < 3; p++) {
+            for (let q = 0; q < 3; q++)
+                a[p][q] += r.rgb[p] * r.rgb[q];
+            for (let o = 0; o < 3; o++)
+                b[o][p] += r.xyz[o] * r.rgb[p];
+        }
+    }
+    const aMatrix = a;
+    const aInv = invertMatrix3x3(aMatrix, "Camera training Gram matrix (patches must span three independent camera responses)");
+    const constrained = input.constraint === "white-point-preserving-least-squares";
+    const m = [0, 1, 2].map((o) => solveRow(aInv, b[o], constrained ? whiteRgb : undefined, whiteXyz[o]));
+    requireFiniteResult(m.flat(), "Camera matrix fit");
+    const whiteXyzRecord = vectorToXyz(whiteXyz);
+    let sumDe = 0, maxDe = 0, sumSq = 0;
+    const patches = rows.map((r) => {
+        const predicted = multiplyMatrixVector(m, r.rgb);
+        const de = deltaE2000(cielabOfXyz(vectorToXyz(r.xyz), whiteXyzRecord), cielabOfXyz(vectorToXyz(predicted), whiteXyzRecord));
+        sumDe += de;
+        maxDe = Math.max(maxDe, de);
+        for (let o = 0; o < 3; o++)
+            sumSq += (predicted[o] - r.xyz[o]) ** 2;
+        return { patchId: r.patchId, cameraRgb: r.rgb, targetXyz: vectorToXyz(r.xyz), predictedXyz: vectorToXyz(predicted), deltaE2000: de };
+    });
+    const value = {
+        constraint: input.constraint, cameraRgbToXyz: m, xyzToCameraRgb: invertMatrix3x3(m, "Fitted camera matrix"),
+        illuminantWhiteXyz: whiteXyzRecord, cameraWhiteRgb: whiteRgb, patches,
+        meanDeltaE2000: sumDe / rows.length, maximumDeltaE2000: maxDe, rmsXyzResidual: Math.sqrt(sumSq / (3 * rows.length))
+    };
+    requireFiniteResult([value.meanDeltaE2000, value.maximumDeltaE2000, value.rmsXyzResidual], "Camera matrix report");
+    return estimatedResult(value, "camera-color-matrix-least-squares", COLORIMETRY_MODEL_VERSION, [
+        "Linear 3×3 model fitted to caller training reflectances under one illuminant; exact only under the Luther–Ives condition",
+        "ΔE2000 uses CIELAB relative to the illuminant white without chromatic adaptation",
+        "CMF source: " + cmf.datasetId
+    ], {
+        notes: [
+            "Training-set residuals are reported per patch in value.patches (CIEDE2000) and value.rmsXyzResidual; they do not bound the error for spectra outside the training set."
+        ]
+    });
+}
+//# sourceMappingURL=camera-color-matrix.js.map

package/dist/color/camera-color-matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-color-matrix.js","sourceRoot":"","sources":["../../src/color/camera-color-matrix.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Fits a 3×3 camera-RGB → CIE XYZ matrix from caller-supplied spectral data.\n *\n * For each training reflectance R_j under illuminant S:\n *   camera ρ_j,c = k_c Σ S(λ) R_j(λ) s_c(λ) Δλ,   target X_j = k Σ S(λ) R_j(λ) x̄(λ) Δλ\n * k is chosen so the perfect diffuser has Y = 1. k_c (the same for all channels) is chosen so\n * the camera's response to the perfect diffuser has green = 1.\n *\n * Two fits are available:\n * - Ordinary least squares: M minimizes Σ_j ‖M ρ_j − X_j‖², so M = X Pᵀ (P Pᵀ)⁻¹.\n * - White-point-preserving least squares: the same, subject to M ρ_white = X_white exactly\n *   (Finlayson & Drew 1997, \"White-point preserving color correction\", IS&T/SID CIC5). It is\n *   solved in closed form with one Lagrange multiplier per row.\n *\n * Residual errors are reported per patch as CIEDE2000, with CIELAB relative to the illuminant\n * white (no chromatic adaptation). A 3×3 matrix is exact only if the camera meets the\n * Luther–Ives condition. Otherwise the result is an estimate, and its error depends on the\n * training set. No camera, reflectance or ColorChecker data is bundled. Reflectance tables with an\n * unclear licence must come from the caller.\n * @see docs/COLORIMETRY.md for equations, coordinate/unit conventions and limits.\n */\n\nimport { estimatedResult, type CalculationResult } from \"../core/calculation-result.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  COLORIMETRY_MODEL_VERSION,\n  integrateSampledXyz,\n  prepareColorMatchingFunctions,\n  prepareColorimetricSpectrum,\n  sampleColorimetricBasis,\n  sampleFactor,\n  type ColorMatchingFunctionsSource,\n  type ColorimetricQuadratureNode,\n  type ColorimetricSpectrum,\n  type SampledColorimetricBasis\n} from \"./color-matching-functions.js\";\nimport { cielabOfXyz, deltaE2000 } from \"./color-difference.js\";\nimport {\n  invertMatrix3x3,\n  multiplyMatrixVector,\n  requireFiniteResult,\n  vectorToXyz,\n  xyzToVector,\n  type CieXyzTristimulus,\n  type ColorMatrix3x3,\n  type ColorVector3\n} from \"./colorimetry-math.js\";\nimport { requireInputKeys } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nexport const MAX_CAMERA_MATRIX_TRAINING_PATCHES = 10_000;\n\nexport interface CameraSpectralSensitivities {\n  red: ColorimetricSpectrum;\n  green: ColorimetricSpectrum;\n  blue: ColorimetricSpectrum;\n}\n\nexport interface CameraMatrixTrainingPatch {\n  patchId: string;\n  reflectance: ColorimetricSpectrum;\n}\n\nexport type CameraMatrixFitConstraint = \"least-squares\" | \"white-point-preserving-least-squares\";\n\nexport interface EstimateCameraColorMatrixInput {\n  quadratureNodes: readonly ColorimetricQuadratureNode[];\n  illuminant: ColorimetricSpectrum;\n  cameraSpectralSensitivities: CameraSpectralSensitivities;\n  patches: readonly CameraMatrixTrainingPatch[];\n  colorMatchingFunctions: ColorMatchingFunctionsSource;\n  constraint: CameraMatrixFitConstraint;\n}\n\nexport interface CameraMatrixPatchReport {\n  patchId: string;\n  cameraRgb: ColorVector3;\n  targetXyz: CieXyzTristimulus;\n  predictedXyz: CieXyzTristimulus;\n  deltaE2000: number;\n}\n\nexport interface CameraColorMatrixFit {\n  constraint: CameraMatrixFitConstraint;\n  /** Row-major camera RGB → XYZ (XYZ white Y = 1; camera white green = 1). */\n  cameraRgbToXyz: ColorMatrix3x3;\n  xyzToCameraRgb: ColorMatrix3x3;\n  illuminantWhiteXyz: CieXyzTristimulus;\n  /** Camera response to the perfect diffuser (green = 1); its reciprocal gives neutral WB gains. */\n  cameraWhiteRgb: ColorVector3;\n  patches: readonly CameraMatrixPatchReport[];\n  meanDeltaE2000: number;\n  maximumDeltaE2000: number;\n  /** Root-mean-square XYZ residual over all patches and components. */\n  rmsXyzResidual: number;\n}\n\ntype Matrix = number[][];\n\nfunction solveRow(aInv: ColorMatrix3x3, rhs: ColorVector3, white: ColorVector3 | undefined, whiteTarget: number): ColorVector3 {\n  // Unconstrained normal equations: m = A⁻¹ b with A = P Pᵀ, b = P xᵀ.\n  const m = multiplyMatrixVector(aInv, rhs);\n  if (white === undefined) return m;\n  const aInvW = multiplyMatrixVector(aInv, white);\n  const wAw = white[0] * aInvW[0] + white[1] * aInvW[1] + white[2] * aInvW[2];\n  const residual = whiteTarget - (m[0] * white[0] + m[1] * white[1] + m[2] * white[2]);\n  return [m[0] + (aInvW[0] * residual) / wAw, m[1] + (aInvW[1] * residual) / wAw, m[2] + (aInvW[2] * residual) / wAw];\n}\n\n/**\n * Fits a camera-RGB → XYZ matrix from spectral sensitivities, training reflectances,\n * an illuminant and CMFs, and reports the per-patch CIEDE2000 residual.\n */\nexport function estimateCameraColorMatrix(input: EstimateCameraColorMatrixInput): CalculationResult<CameraColorMatrixFit> {\n  requireInputKeys(input, \"estimateCameraColorMatrix\", [\"quadratureNodes\", \"illuminant\", \"cameraSpectralSensitivities\", \"patches\", \"colorMatchingFunctions\", \"constraint\"]);\n  if (input.constraint !== \"least-squares\" && input.constraint !== \"white-point-preserving-least-squares\") {\n    throw new InvalidConfigurationError(\"constraint is not supported.\");\n  }\n  if (!Array.isArray(input.patches) || input.patches.length < 3 || input.patches.length > MAX_CAMERA_MATRIX_TRAINING_PATCHES) {\n    throw new InvalidScientificInputError(\"patches must contain between 3 and \" + MAX_CAMERA_MATRIX_TRAINING_PATCHES + \" entries.\");\n  }\n  const cmf = prepareColorMatchingFunctions(input.colorMatchingFunctions);\n  const illuminant = prepareColorimetricSpectrum(input.illuminant, \"illuminant\");\n  const basis: SampledColorimetricBasis = sampleColorimetricBasis(input.quadratureNodes, illuminant, cmf);\n  const sens = input.cameraSpectralSensitivities;\n  if (typeof sens !== \"object\" || sens === null) throw new InvalidConfigurationError(\"cameraSpectralSensitivities must be an object.\");\n  const channel = ([\"red\", \"green\", \"blue\"] as const).map((c) => sampleFactor(basis, prepareColorimetricSpectrum(sens[c], \"cameraSpectralSensitivities.\" + c)));\n  const ids = new Set<string>();\n  const n = basis.nodes.length;\n  const cameraOf = (factor: Float64Array): ColorVector3 => {\n    const out = [0, 0, 0];\n    for (let i = 0; i < n; i++) {\n      const w = basis.weights[i]! * factor[i]!;\n      for (let c = 0; c < 3; c++) out[c]! += w * channel[c]![i]!;\n    }\n    return out as unknown as ColorVector3;\n  };\n  const ones = sampleFactor(basis, undefined);\n  const rawWhiteXyz = integrateSampledXyz(basis, ones);\n  const rawWhiteRgb = cameraOf(ones);\n  if (!(rawWhiteXyz.y > 0) || !(rawWhiteRgb[1] > 0)) throw new InvalidScientificInputError(\"The illuminant must give positive Y and positive camera green for the perfect diffuser.\");\n  const kXyz = 1 / rawWhiteXyz.y, kRgb = 1 / rawWhiteRgb[1];\n  const scale = (v: ColorVector3, k: number): ColorVector3 => [v[0] * k, v[1] * k, v[2] * k];\n  const whiteXyz = scale(xyzToVector(rawWhiteXyz), kXyz);\n  const whiteRgb = scale(rawWhiteRgb, kRgb);\n\n  const rows = input.patches.map((patch, j) => {\n    if (typeof patch !== \"object\" || patch === null || typeof patch.patchId !== \"string\" || patch.patchId.trim().length === 0) {\n      throw new InvalidConfigurationError(\"patches[\" + j + \"].patchId must be a non-empty string.\");\n    }\n    if (ids.has(patch.patchId)) throw new InvalidScientificInputError(\"patches must not repeat patchId.\");\n    ids.add(patch.patchId);\n    const factor = sampleFactor(basis, prepareColorimetricSpectrum(patch.reflectance, \"patches[\" + j + \"].reflectance\"));\n    return { patchId: patch.patchId, rgb: scale(cameraOf(factor), kRgb), xyz: scale(xyzToVector(integrateSampledXyz(basis, factor)), kXyz) };\n  });\n\n  const a: Matrix = [[0, 0, 0], [0, 0, 0], [0, 0, 0]];\n  const b: Matrix = [[0, 0, 0], [0, 0, 0], [0, 0, 0]]; // b[outputRow][cameraChannel]\n  for (const r of rows) {\n    for (let p = 0; p < 3; p++) {\n      for (let q = 0; q < 3; q++) a[p]![q]! += r.rgb[p]! * r.rgb[q]!;\n      for (let o = 0; o < 3; o++) b[o]![p]! += r.xyz[o]! * r.rgb[p]!;\n    }\n  }\n  const aMatrix = a as unknown as ColorMatrix3x3;\n  const aInv = invertMatrix3x3(aMatrix, \"Camera training Gram matrix (patches must span three independent camera responses)\");\n  const constrained = input.constraint === \"white-point-preserving-least-squares\";\n  const m = [0, 1, 2].map((o) => solveRow(aInv, b[o] as unknown as ColorVector3, constrained ? whiteRgb : undefined, whiteXyz[o]!)) as unknown as ColorMatrix3x3;\n  requireFiniteResult(m.flat(), \"Camera matrix fit\");\n\n  const whiteXyzRecord = vectorToXyz(whiteXyz);\n  let sumDe = 0, maxDe = 0, sumSq = 0;\n  const patches: CameraMatrixPatchReport[] = rows.map((r) => {\n    const predicted = multiplyMatrixVector(m, r.rgb);\n    const de = deltaE2000(cielabOfXyz(vectorToXyz(r.xyz), whiteXyzRecord), cielabOfXyz(vectorToXyz(predicted), whiteXyzRecord));\n    sumDe += de; maxDe = Math.max(maxDe, de);\n    for (let o = 0; o < 3; o++) sumSq += (predicted[o]! - r.xyz[o]!) ** 2;\n    return { patchId: r.patchId, cameraRgb: r.rgb, targetXyz: vectorToXyz(r.xyz), predictedXyz: vectorToXyz(predicted), deltaE2000: de };\n  });\n  const value: CameraColorMatrixFit = {\n    constraint: input.constraint, cameraRgbToXyz: m, xyzToCameraRgb: invertMatrix3x3(m, \"Fitted camera matrix\"),\n    illuminantWhiteXyz: whiteXyzRecord, cameraWhiteRgb: whiteRgb, patches,\n    meanDeltaE2000: sumDe / rows.length, maximumDeltaE2000: maxDe, rmsXyzResidual: Math.sqrt(sumSq / (3 * rows.length))\n  };\n  requireFiniteResult([value.meanDeltaE2000, value.maximumDeltaE2000, value.rmsXyzResidual], \"Camera matrix report\");\n  return estimatedResult(value, \"camera-color-matrix-least-squares\", COLORIMETRY_MODEL_VERSION, [\n    \"Linear 3×3 model fitted to caller training reflectances under one illuminant; exact only under the Luther–Ives condition\",\n    \"ΔE2000 uses CIELAB relative to the illuminant white without chromatic adaptation\",\n    \"CMF source: \" + cmf.datasetId\n  ], {\n    notes: [\n      \"Training-set residuals are reported per patch in value.patches (CIEDE2000) and value.rmsXyzResidual; they do not bound the error for spectra outside the training set.\"\n    ]\n  });\n}\n"]}