@photivra/engine 0.6.0 → 1.0.1

package/dist/capture/simulated-capture.js

@@ -0,0 +1,248 @@
+// 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.
+ * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { requireAllowlistedRecord, requirePublicOpaqueId } from "../core/record-validation.js";
+import { stringifyCanonicalJson } from "../core/canonical-json.js";
+import { freezeOwnedData } from "../core/owned-data.js";
+import { calculatedResult } from "../core/calculation-result.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { ENGINE_API_VERSION } from "../core/version.js";
+import { parseResolvedWhiteBalanceState } from "../color/white-balance.js";
+import { calculateEquivalentFocalLength35Mm } from "../camera/equivalent-focal-length.js";
+import { parseFocusPlane } from "../optics/focus-state.js";
+import { resolveCaptureGeometry } from "../output/capture-geometry.js";
+export const SIMULATED_CAPTURE_SCHEMA_VERSION = "0.2.0";
+function object(value, keys) {
+    return requireAllowlistedRecord(value, keys, "Invalid or non-allowlisted capture metadata.");
+}
+function enumValue(value, values) {
+    if (!values.includes(value))
+        throw new InvalidConfigurationError("Unknown capture state.");
+    return value;
+}
+function number(value, positive = false) {
+    if (typeof value !== "number" || !Number.isFinite(value) || (positive && value <= 0))
+        throw new InvalidConfigurationError("Capture number must be finite with valid sign.");
+    return Object.is(value, -0) ? 0 : value;
+}
+function integer(value, minimum = 1) {
+    const n = number(value);
+    if (!Number.isSafeInteger(n) || n < minimum)
+        throw new InvalidConfigurationError("Invalid capture integer.");
+    return n;
+}
+function array(value, maximum) {
+    if (!Array.isArray(value) || value.length > maximum ||
+        Array.from({ length: value.length }, (_, i) => i in value).includes(false))
+        throw new InvalidConfigurationError("Expected a bounded dense capture array.");
+    return value;
+}
+function id(value) {
+    return requirePublicOpaqueId(value, "Expected a public opaque ID, not a path or URL.");
+}
+function digest(value) {
+    if (typeof value !== "string" || !/^[a-f0-9]{64}$/.test(value))
+        throw new InvalidConfigurationError("Expected a lowercase SHA-256 digest.");
+    return value;
+}
+function profile(value) {
+    const r = object(value, ["id", "version"]);
+    return { id: id(r.id), version: id(r.version) };
+}
+function white(value) {
+    if (value === null)
+        return null;
+    const r = object(value, ["x", "y", "z"]);
+    if (r.y !== 1)
+        throw new InvalidConfigurationError("White XYZ requires Y=1.");
+    return { x: number(r.x, true), y: 1, z: number(r.z, true) };
+}
+function wb(value) {
+    if (value === null)
+        return null;
+    const r = object(value, ["stateId", "source", "locked", "channelGains", "sourceProfile"]);
+    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"]),
+        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. */
+export function createCaptureWhiteBalanceIntent(input) {
+    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 });
+}
+function geometry(value) {
+    const r = object(value, ["imagingArea", "nativeRaster", "orientation", "activeCaptureRect", "outputCropRect", "outputRaster"]);
+    const area = object(r.imagingArea, ["widthMm", "heightMm"]), native = object(r.nativeRaster, ["pixelWidth", "pixelHeight"]);
+    const rect = (value) => {
+        const p = object(value, ["x", "y", "width", "height"]);
+        return { x: integer(p.x, 0), y: integer(p.y, 0), width: integer(p.width), height: integer(p.height) };
+    };
+    const output = r.outputRaster === undefined ? undefined : object(r.outputRaster, ["pixelWidth", "pixelHeight"]);
+    return { imagingArea: { widthMm: number(area.widthMm, true), heightMm: number(area.heightMm, true) },
+        nativeRaster: { pixelWidth: integer(native.pixelWidth), pixelHeight: integer(native.pixelHeight) },
+        orientation: enumValue(r.orientation, ["landscape", "portrait-clockwise", "landscape-inverted", "portrait-counter-clockwise"]),
+        ...(r.activeCaptureRect === undefined ? {} : { activeCaptureRect: rect(r.activeCaptureRect) }),
+        ...(r.outputCropRect === undefined ? {} : { outputCropRect: rect(r.outputCropRect) }),
+        ...(output === undefined ? {} : { outputRaster: { pixelWidth: integer(output.pixelWidth), pixelHeight: integer(output.pixelHeight) } }) };
+}
+function plane(value, resolved, intent) {
+    const r = object(value, ["id", "imageStateId", "imageState", "rasterBinding", "pixelWidth", "pixelHeight", "channelIds", "colorProfile",
+        "encodingReferenceWhiteXyz", "referenceWhiteValue", "whiteBalanceApplication", "captureSaturation", "appliedTransforms", "storage"]);
+    const state = enumValue(r.imageState, ["scene-referred-xyz", "virtual-sensor-channels", "color-transformed-linear-rgb"]);
+    const binding = enumValue(r.rasterBinding, ["oriented-active-capture", "output"]);
+    const dimensions = binding === "output" ? resolved.output.raster : resolved.orientedCapture.raster;
+    const width = integer(r.pixelWidth), height = integer(r.pixelHeight), channels = array(r.channelIds, 32).map(id);
+    const count = width * height * channels.length;
+    if (width !== dimensions.pixelWidth || height !== dimensions.pixelHeight || !channels.length ||
+        new Set(channels).size !== channels.length || !Number.isSafeInteger(count))
+        throw new InvalidConfigurationError("Plane raster/channel identity mismatch.");
+    const requiredChannels = state === "scene-referred-xyz" ? ["X", "Y", "Z"] : state === "color-transformed-linear-rgb" ? ["red", "green", "blue"] : null;
+    if (requiredChannels && JSON.stringify(channels) !== JSON.stringify(requiredChannels))
+        throw new InvalidConfigurationError("Channels do not match image state.");
+    const colorProfile = r.colorProfile === null ? null : profile(r.colorProfile), referenceWhite = white(r.encodingReferenceWhiteXyz);
+    if (state === "virtual-sensor-channels" ? referenceWhite !== null || colorProfile === null : referenceWhite === null || colorProfile === null) {
+        throw new InvalidConfigurationError("Color metadata does not match image state.");
+    }
+    if (state === "scene-referred-xyz" && (colorProfile.id !== "cie-1931-2-degree-xyz" || colorProfile.version !== "1.0.0")) {
+        throw new InvalidConfigurationError("XYZ planes require the explicit CIE 1931 2-degree identity.");
+    }
+    const application = enumValue(r.whiteBalanceApplication, ["intent-only", "applied-rgb-gains", "applied-chromatic-adaptation", "not-applicable"]);
+    if (((application === "intent-only" || application === "applied-rgb-gains") && intent === null) ||
+        (application === "applied-rgb-gains" && JSON.stringify(channels) !== JSON.stringify(["red", "green", "blue"]))) {
+        throw new InvalidConfigurationError("WB application must refer to a resolved compatible RGB intent.");
+    }
+    const s = object(r.storage, ["kind", "samples", "artifactId", "sha256", "sampleCount", "byteOrder"]);
+    const kind = enumValue(s.kind, ["inline-float64", "external-float32", "external-float64"]);
+    let storage;
+    if (kind === "inline-float64") {
+        if (s.artifactId !== undefined || s.sha256 !== undefined || s.sampleCount !== undefined || s.byteOrder !== undefined)
+            throw new InvalidConfigurationError("Inline plane cannot contain external storage fields.");
+        const samples = array(s.samples, 1_000_000).map((v) => number(v));
+        if (samples.length !== count)
+            throw new InvalidConfigurationError("Plane sample count mismatch.");
+        storage = { kind, samples };
+    }
+    else {
+        if (s.samples !== undefined || integer(s.sampleCount) !== count)
+            throw new InvalidConfigurationError("External plane sample count/fields mismatch.");
+        storage = { kind, byteOrder: enumValue(s.byteOrder, ["little-endian"]), artifactId: id(s.artifactId), sha256: digest(s.sha256), sampleCount: count };
+    }
+    const saturation = object(r.captureSaturation, ["kind", "whiteLevel", "upstreamClippedSampleCount"]);
+    const saturationKind = enumValue(saturation.kind, ["not-modeled", "declared-virtual-white"]);
+    let captureSaturation;
+    if (saturationKind === "not-modeled") {
+        if (saturation.whiteLevel !== undefined || saturation.upstreamClippedSampleCount !== undefined)
+            throw new InvalidConfigurationError("Unmodeled saturation cannot assert a white level.");
+        captureSaturation = { kind: saturationKind };
+    }
+    else {
+        const clipped = integer(saturation.upstreamClippedSampleCount, 0);
+        if (clipped > count)
+            throw new InvalidConfigurationError("Invalid clipped sample count.");
+        captureSaturation = { kind: saturationKind, whiteLevel: number(saturation.whiteLevel, true), upstreamClippedSampleCount: clipped };
+    }
+    const transforms = array(r.appliedTransforms, 64).map((value) => {
+        const t = object(value, ["profile", "kind"]);
+        return { profile: profile(t.profile), kind: enumValue(t.kind, ["linear-color", "chromatic-adaptation", "digital-lens-correction"]) };
+    });
+    if (state === "color-transformed-linear-rgb" && !transforms.some((t) => t.kind === "linear-color"))
+        throw new InvalidConfigurationError("Transformed RGB requires explicit color-transform history.");
+    if (application === "applied-chromatic-adaptation" && (state !== "color-transformed-linear-rgb" ||
+        !transforms.some((t) => t.kind === "chromatic-adaptation")))
+        throw new InvalidConfigurationError("Applied adaptation requires transformed RGB and adaptation history.");
+    return { id: id(r.id), imageStateId: id(r.imageStateId), imageState: state, rasterBinding: binding, pixelWidth: width, pixelHeight: height,
+        channelIds: channels, colorProfile, encodingReferenceWhiteXyz: referenceWhite, referenceWhiteValue: number(r.referenceWhiteValue, true),
+        whiteBalanceApplication: application, captureSaturation, appliedTransforms: transforms, storage };
+}
+function normalize(value, apiVersion) {
+    const r = object(value, ["captureId", "sceneStateId", "sceneTimeSeconds", "geometry", "exposure", "focus", "noise", "source",
+        "whiteBalanceIntent", "adoptedWhiteXyz", "models", "planes"]);
+    const g = geometry(r.geometry), resolved = resolveCaptureGeometry(g).value;
+    const e = object(r.exposure, ["focalLengthMm", "aperture", "shutterSeconds", "iso"]);
+    const exposure = { focalLengthMm: number(e.focalLengthMm, true), aperture: number(e.aperture, true),
+        shutterSeconds: number(e.shutterSeconds, true), iso: number(e.iso, true) };
+    const f = object(r.focus, ["kind", "distanceM"]), focus = parseFocusPlane(f);
+    const noise = object(r.noise, ["seedUint32", "realizationId", "model"]), seed = integer(noise.seedUint32, 0);
+    if (seed > 0xffffffff)
+        throw new InvalidConfigurationError("Noise seed must be uint32.");
+    const source = object(r.source, ["kind", "artifactId", "sha256", "dynamicRangeHistory"]);
+    const time = number(r.sceneTimeSeconds), intent = wb(r.whiteBalanceIntent);
+    if (time < 0)
+        throw new InvalidConfigurationError("Scene time must be nonnegative.");
+    const models = array(r.models, 128).map((value) => {
+        const m = object(value, ["profile", "scientificStatus", "publicEvidenceIds"]), evidence = array(m.publicEvidenceIds, 128).map(id);
+        if (!evidence.length || new Set(evidence).size !== evidence.length)
+            throw new InvalidConfigurationError("Public evidence IDs must be nonempty/unique.");
+        return { profile: profile(m.profile), scientificStatus: enumValue(m.scientificStatus, ["calculated", "calibrated", "estimated", "approximation"]), publicEvidenceIds: evidence };
+    });
+    const planes = array(r.planes, 32).map((p) => plane(p, resolved, intent));
+    const adoptedWhite = white(r.adoptedWhiteXyz);
+    if (planes.some((p) => p.whiteBalanceApplication === "applied-chromatic-adaptation") && adoptedWhite === null) {
+        throw new InvalidConfigurationError("Applied adaptation requires an adopted white.");
+    }
+    if (!models.length || !planes.length || new Set(models.map((m) => m.profile.id)).size !== models.length ||
+        new Set(planes.map((p) => p.id)).size !== planes.length || new Set(planes.map((p) => p.imageStateId)).size !== planes.length ||
+        planes.reduce((n, p) => n + (p.storage.kind === "inline-float64" ? p.storage.samples.length : 0), 0) > 1_000_000) {
+        throw new InvalidConfigurationError("Capture needs unique models/planes/states and a bounded inline sample budget.");
+    }
+    return freezeOwnedData({ schemaVersion: SIMULATED_CAPTURE_SCHEMA_VERSION, engineApiVersion: id(apiVersion),
+        captureId: id(r.captureId), sceneStateId: id(r.sceneStateId), sceneTimeSeconds: time, geometry: g, resolvedGeometry: resolved,
+        exposure, equivalentFocalLength35Mm: calculateEquivalentFocalLength35Mm({ focalLengthMm: exposure.focalLengthMm, activeImagingArea: resolved.activeCapture.imagingArea }).value.equivalentFocalLength35Mm,
+        focus, noise: { seedUint32: seed, realizationId: id(noise.realizationId), model: profile(noise.model) },
+        source: { kind: enumValue(source.kind, ["scene-linear-master", "sensor-derived-linear", "color-transformed-linear-master"]),
+            artifactId: id(source.artifactId), sha256: digest(source.sha256), dynamicRangeHistory: enumValue(source.dynamicRangeHistory, ["unknown", "no-loss-declared", "upstream-clipped"]) },
+        whiteBalanceIntent: intent, adoptedWhiteXyz: adoptedWhite, models, planes });
+}
+/** Commits a format-neutral float master manifest; no radiance generation, clamp, WB or export 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"]);
+}
+/** 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",
+        "equivalentFocalLength35Mm", "exposure", "focus", "noise", "source", "whiteBalanceIntent", "adoptedWhiteXyz", "models", "planes"]);
+    if (r.schemaVersion !== SIMULATED_CAPTURE_SCHEMA_VERSION && r.schemaVersion !== "0.1.0")
+        throw new InvalidConfigurationError("Unsupported capture schema.");
+    if (r.schemaVersion === "0.1.0" && Array.isArray(r.planes) && r.planes.some((p) => p?.whiteBalanceApplication === "applied-chromatic-adaptation")) {
+        throw new InvalidConfigurationError("Legacy capture schema cannot declare the new adaptation state.");
+    }
+    const { schemaVersion: _schemaVersion, engineApiVersion, resolvedGeometry, equivalentFocalLength35Mm, ...input } = r;
+    const result = normalize(input, id(engineApiVersion));
+    if (canonical(resolvedGeometry) !== canonical(result.resolvedGeometry) || equivalentFocalLength35Mm !== result.equivalentFocalLength35Mm) {
+        throw new InvalidConfigurationError("Archived derived capture metadata is inconsistent.");
+    }
+    // _schemaVersion is already checked, not copied as an unchecked discriminator.
+    void _schemaVersion;
+    return result;
+}
+function canonical(value) {
+    return stringifyCanonicalJson(value, {
+        undefinedObjectProperties: "reject",
+        nonFiniteNumberMessage: "Capture number must be finite with valid sign.",
+        unsupportedValueMessage: "Derived capture metadata must be finite JSON."
+    });
+}
+/** Canonical allowlisted JSON, including semantic samples/IDs, not private caches or file layout. */
+export function serializeSimulatedCapture(input) {
+    return JSON.stringify(parseSimulatedCapture(input.capture));
+}
+/** Requires an exact plane image state; callers may not substitute another kind of 'linear'. */
+export function resolveSimulatedCapturePlane(input) {
+    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));
+    if (!result || result.imageState !== state)
+        throw new InvalidConfigurationError("Capture plane missing or incompatible image state.");
+    return result;
+}
+//# sourceMappingURL=simulated-capture.js.map

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

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

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

@@ -0,0 +1,73 @@
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type SimulatedCapture, type CaptureLinearPlane, type CapturePublicProfileReference } from "../capture/simulated-capture.js";
+export declare const CAPTURE_COLOR_MODEL_VERSION: "0.1.0";
+/** Explicit ideal colorimetric camera, not measured spectral sensor channels. */
+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. */
+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. */
+export type CaptureColorWhiteBalance = {
+    kind: "preserve-intent";
+} | {
+    kind: "apply-resolved-rgb-gains";
+    channelBasis: CapturePublicProfileReference;
+} | {
+    kind: "adopted-white-xyz-scaling";
+};
+/** IDs identify a new derived plane; source capture stays immutable. */
+export interface CaptureColorTransformInput {
+    capture: SimulatedCapture;
+    sourcePlaneId: string;
+    outputPlaneId: string;
+    outputImageStateId: string;
+    whiteBalance: CaptureColorWhiteBalance;
+}
+/** Profile data exposes complete row-major matrices and domain conditions to consumers. */
+export interface CaptureColorModel {
+    version: typeof CAPTURE_COLOR_MODEL_VERSION;
+    cameraProfile: CapturePublicProfileReference;
+    outputProfile: CapturePublicProfileReference;
+    referenceIlluminant: "D65";
+    observer: "cie-1931-2-degree";
+    referenceWhiteXyz: {
+        x: number;
+        y: 1;
+        z: number;
+    };
+    cameraRgbToXyz: Matrix;
+    xyzToCameraRgb: Matrix;
+    scientificStatus: "calculated";
+    validConditions: readonly string[];
+    publicEvidenceIds: readonly string[];
+}
+/** 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. */
+export declare function parseCaptureColorTransformInput(value: unknown): CaptureColorTransformInput;
+export interface CaptureColorTransformResult {
+    plane: CaptureLinearPlane;
+    colorModel: CaptureColorModel;
+    sourcePlaneId: string;
+    sourceImageStateId: string;
+    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. */
+    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.
+ */
+export declare function calculateCaptureColorTransform(input: CaptureColorTransformInput): CalculationResult<CaptureColorTransformResult>;
+export {};
+//# sourceMappingURL=capture-color.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture-color.d.ts","sourceRoot":"","sources":["../../src/color/capture-color.ts"],"names":[],"mappings":"AAUA,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAG9G,OAAO,EAAyB,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAE5J,eAAO,MAAM,2BAA2B,EAAG,OAAgB,CAAC;AAC5D,iFAAiF;AACjF,eAAO,MAAM,4BAA4B;;;EAA+F,CAAC;AACzI,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B;;;EAAiF,CAAC;AAEzH,KAAK,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAChD,KAAK,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAmBhD,+FAA+F;AAC/F,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,YAAY,EAAE,6BAA6B,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAC1C,wEAAwE;AACxE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,wBAAwB,CAAC;CACxC;AACD,2FAA2F;AAC3F,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,2BAA2B,CAAC;IAC5C,aAAa,EAAE,6BAA6B,CAAC;IAC7C,aAAa,EAAE,6BAA6B,CAAC;IAC7C,mBAAmB,EAAE,KAAK,CAAC;IAC3B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,iBAAiB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,YAAY,CAAC;IAC/B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AACD,2FAA2F;AAC3F,wBAAgB,wBAAwB,IAAI,iBAAiB,CAS5D;AAOD,mGAAmG;AACnG,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAY1F;AACD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,wBAAwB,CAAC;IACvC,gFAAgF;IAChF,yBAAyB,EAAE,MAAM,CAAC;IAClC,qFAAqF;IACrF,sBAAsB,EAAE,KAAK,CAAC;CAC/B;AACD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,0BAA0B,GAAG,iBAAiB,CAAC,2BAA2B,CAAC,CAkEhI"}

package/dist/color/capture-color.js

@@ -0,0 +1,145 @@
+// 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.
+ */
+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 { 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. */
+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]];
+function multiply(m, v) {
+    return m.map((r) => r[0] * v[0] + r[1] * v[1] + r[2] * v[2]);
+}
+function inverse(m) {
+    const [[a, b, c], [d, e, f], [g, h, i]] = m;
+    const determinant = a * (e * i - f * h) - b * (d * i - f * g) + c * (d * h - e * g);
+    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.
+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);
+/** 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 },
+        outputProfile: { ...LINEAR_CAPTURE_RGB_PROFILE }, referenceIlluminant: "D65", observer: "cie-1931-2-degree",
+        referenceWhiteXyz: { ...D65 }, cameraRgbToXyz: RGB_TO_XYZ.map((r) => [...r]),
+        xyzToCameraRgb: XYZ_TO_RGB.map((r) => [...r]), scientificStatus: "calculated",
+        validConditions: ["Ideal colorimetric basis only; virtual RGB is an invertible encoding of CIE XYZ",
+            "Not spectral channels, electrons, commercial-camera RGB or a sensor calibration",
+            "Signed finite scene-linear values; co-sited RGB; no transfer curve, gamut mapping or clipping"],
+        publicEvidenceIds: ["w3c:css-color-4:srgb-primaries-d65"] };
+}
+function record(v, keys) {
+    return requireAllowlistedRecord(v, keys, "Invalid color-transform fields.");
+}
+function publicId(v) {
+    return requirePublicOpaqueId(v, "Invalid public color ID.");
+}
+/** Validates the entire capture and explicit transform policy across untrusted JSON boundaries. */
+export function parseCaptureColorTransformInput(value) {
+    const r = record(value, ["capture", "sourcePlaneId", "outputPlaneId", "outputImageStateId", "whiteBalance"]);
+    const w = record(r.whiteBalance, ["kind", "channelBasis"]);
+    let whiteBalance;
+    if (w.kind === "apply-resolved-rgb-gains") {
+        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) {
+        whiteBalance = { kind: w.kind };
+    }
+    else
+        throw new InvalidConfigurationError("Unsupported or contradictory color WB policy.");
+    return { capture: parseSimulatedCapture(r.capture), sourcePlaneId: publicId(r.sourcePlaneId),
+        outputPlaneId: publicId(r.outputPlaneId), outputImageStateId: publicId(r.outputImageStateId), whiteBalance };
+}
+/**
+ * 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.
+ */
+export function calculateCaptureColorTransform(input) {
+    const { capture, sourcePlaneId, outputPlaneId, outputImageStateId, whiteBalance } = parseCaptureColorTransformInput(input);
+    const source = capture.planes.find((p) => p.id === sourcePlaneId);
+    if (!source || source.storage.kind !== "inline-float64" || source.imageState === "color-transformed-linear-rgb" ||
+        source.whiteBalanceApplication === "applied-rgb-gains" || source.whiteBalanceApplication === "applied-chromatic-adaptation" ||
+        source.appliedTransforms.some((t) => t.kind !== "digital-lens-correction")) {
+        throw new InvalidConfigurationError("Color requires an untreated inline XYZ or supported virtual camera plane.");
+    }
+    if (capture.planes.some((p) => p.id === outputPlaneId || p.imageStateId === outputImageStateId)) {
+        throw new InvalidConfigurationError("Derived color plane/state IDs must be new.");
+    }
+    const virtual = source.imageState === "virtual-sensor-channels";
+    if (virtual && (source.colorProfile?.id !== VIRTUAL_COLOR_CAMERA_PROFILE.id || source.colorProfile.version !== CAPTURE_COLOR_MODEL_VERSION ||
+        JSON.stringify(source.channelIds) !== JSON.stringify(["red", "green", "blue"]))) {
+        throw new InvalidConfigurationError("Unresolved spectral/sensor RGB cannot use the ideal colorimetric transform.");
+    }
+    const adapt = whiteBalance.kind === "adopted-white-xyz-scaling";
+    const reference = source.encodingReferenceWhiteXyz;
+    if (!virtual && !adapt && (reference.x !== D65.x || reference.z !== D65.z)) {
+        throw new InvalidConfigurationError("A different XYZ reference white requires an explicit adaptation choice.");
+    }
+    const gains = whiteBalance.kind === "apply-resolved-rgb-gains";
+    if (gains && (!capture.whiteBalanceIntent || whiteBalance.channelBasis.id !== VIRTUAL_COLOR_CAMERA_PROFILE.id ||
+        whiteBalance.channelBasis.version !== CAPTURE_COLOR_MODEL_VERSION)) {
+        throw new InvalidConfigurationError("Resolved WB gains require an explicit matching camera channel-basis binding.");
+    }
+    let adaptation = IDENTITY;
+    if (adapt) {
+        const white = capture.adoptedWhiteXyz;
+        if (!white)
+            throw new InvalidConfigurationError("Adopted-white adaptation requires an explicit adopted XYZ white.");
+        const x = D65.x / white.x, z = D65.z / white.z;
+        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]];
+    }
+    const samples = [], values = source.storage.samples;
+    for (let i = 0; i < values.length; i += 3) {
+        const v = [values[i], values[i + 1], values[i + 2]];
+        let rgb = virtual && !adapt ? v : multiply(XYZ_TO_RGB, multiply(adaptation, virtual ? multiply(RGB_TO_XYZ, v) : v));
+        if (gains) {
+            const g = capture.whiteBalanceIntent.channelGains;
+            rgb = [rgb[0] * g.red, rgb[1] * g.green, rgb[2] * g.blue];
+        }
+        if (rgb.some((v) => !Number.isFinite(v)))
+            throw new InvalidScientificResultError("Color transform produced a non-finite sample.");
+        samples.push(...rgb.map((v) => Object.is(v, -0) ? 0 : v));
+    }
+    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: { ...LINEAR_CAPTURE_RGB_PROFILE }, kind: "linear-color" });
+    if (gains)
+        transforms.push({ profile: { id: capture.whiteBalanceIntent.stateId, version: CAPTURE_COLOR_MODEL_VERSION }, kind: "linear-color" });
+    const plane = { ...source, id: outputPlaneId, imageStateId: outputImageStateId,
+        imageState: "color-transformed-linear-rgb", channelIds: ["red", "green", "blue"], colorProfile: { ...LINEAR_CAPTURE_RGB_PROFILE },
+        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.
+    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"])
+        : calculatedResult(result, "capture-colorimetric-linear-rgb", CAPTURE_COLOR_MODEL_VERSION, assumptions);
+}
+//# sourceMappingURL=capture-color.js.map

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

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

package/dist/color/sensor-color-development.d.ts

@@ -0,0 +1,23 @@
+type Matrix = readonly (readonly number[])[];
+/** Validated 3×3 matrices only; retains the declared determinant/inverse bounds. */
+export declare function invertSensorColorMatrix(m: Matrix): number[][];
+interface SensorColorDevelopment {
+    referenceWhiteXyz: {
+        x: number;
+        y: 1;
+        z: number;
+    };
+    develop(values: readonly number[]): number[];
+}
+/**
+ * Internal adapter for validated normalized sensor RGB and declared D65 profile.
+ * The caller owns profile evidence, CFA/basis binding and one-time WB authorization.
+ * This is distinct from the ideal virtual-camera transform: gains act in sensor
+ * channels before camera-to-XYZ, followed by XYZ-to-linear-sRGB. No clipping,
+ * adaptation, calibration inference, geometry or container metadata is performed.
+ */
+export declare function prepareSensorColorDevelopment(cameraChannelsToXyz: Matrix, gains: readonly number[]): SensorColorDevelopment;
+/** Camera coordinates of the declared D65 white; container policy remains caller-owned. */
+export declare function sensorColorReferenceWhite(xyzToCamera: Matrix): number[];
+export {};
+//# sourceMappingURL=sensor-color-development.d.ts.map

package/dist/color/sensor-color-development.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensor-color-development.d.ts","sourceRoot":"","sources":["../../src/color/sensor-color-development.ts"],"names":[],"mappings":"AAiBA,KAAK,MAAM,GAAG,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;AAU7C,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAM7D;AAED,UAAU,sBAAsB;IAC9B,iBAAiB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,mBAAmB,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,sBAAsB,CAS3H;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAGvE"}

package/dist/color/sensor-color-development.js

@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Validated 3×3 matrices only; retains the declared determinant/inverse bounds.
+ * Internal adapter for validated normalized sensor RGB and declared D65 profile. The caller owns
+ * profile evidence, CFA/basis binding and one-time WB authorization. This is distinct from the ideal
+ * virtual-camera transform: gains act in sensor channels before camera-to-XYZ, followed by
+ * XYZ-to-linear-sRGB. No clipping, adaptation, calibration inference, geometry or container metadata
+ * is performed.
+ * @see docs/PHOTOGRAPHIC_EXPORT.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { resolveCaptureColorModel } from "./capture-color.js";
+/**
+ * Multiply the validated channel vector in its declared basis. Preserve operation
+ * order: sensor gains precede camera-to-XYZ, then XYZ-to-linear-sRGB. This internal
+ * path accepts neither arbitrary spectral channels nor the ideal virtual-camera
+ * basis by implication, and performs no clipping or chromatic adaptation.
+ */
+function multiply(m, values) {
+    return m.map((row) => row.reduce((sum, v, i) => sum + v * values[i], 0));
+}
+/** Validated 3×3 matrices only; retains the declared determinant/inverse bounds. */
+export function invertSensorColorMatrix(m) {
+    const [a, b, c, d, e, f, g, h, i] = m.flat(), det = a * (e * i - f * h) - b * (d * i - f * g) + c * (d * h - e * g);
+    if (!Number.isFinite(det) || Math.abs(det) < 1e-9)
+        throw new InvalidConfigurationError("Export color matrix is singular or outside supported conditioning.");
+    const result = [[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 / det));
+    if (result.flat().some((v) => !Number.isFinite(v) || Math.abs(v) > 100))
+        throw new InvalidConfigurationError("Export inverse color matrix exceeds supported range.");
+    return result;
+}
+/**
+ * Internal adapter for validated normalized sensor RGB and declared D65 profile.
+ * The caller owns profile evidence, CFA/basis binding and one-time WB authorization.
+ * This is distinct from the ideal virtual-camera transform: gains act in sensor
+ * channels before camera-to-XYZ, followed by XYZ-to-linear-sRGB. No clipping,
+ * adaptation, calibration inference, geometry or container metadata is performed.
+ */
+export function prepareSensorColorDevelopment(cameraChannelsToXyz, gains) {
+    const model = resolveCaptureColorModel();
+    return {
+        referenceWhiteXyz: model.referenceWhiteXyz,
+        develop(values) {
+            const balanced = values.map((n, i) => n * gains[i]);
+            return multiply(model.xyzToCameraRgb, multiply(cameraChannelsToXyz, balanced));
+        }
+    };
+}
+/** Camera coordinates of the declared D65 white; container policy remains caller-owned. */
+export function sensorColorReferenceWhite(xyzToCamera) {
+    const white = resolveCaptureColorModel().referenceWhiteXyz;
+    return multiply(xyzToCamera, [white.x, 1, white.z]);
+}
+//# sourceMappingURL=sensor-color-development.js.map