@photivra/engine 0.5.1 → 1.0.0

package/dist/output/geometric-transforms.js

@@ -0,0 +1,225 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses strict transform data, rejecting unknown semantics and noninvertible profiles.
+ * Prepares deterministic still/frame geometry; time changes require another preparation.
+ * @see docs/DIGITAL_OPTICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and
+ * support limits.
+ */
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { calculateRadialDistortionMapping, calculateInverseRadialDistortionMapping, validateRadialDistortionProfile } from "../optics/radial-distortion.js";
+import { choice, finite, list, positive, record, textValue } from "../optics/profile-contract.js";
+function point(value) {
+    const p = record(value, ["x", "y"]);
+    return { x: finite(p.x, "x"), y: finite(p.y, "y") };
+}
+function multiply(a, b) {
+    return [a[0] * b[0] + a[1] * b[2], a[0] * b[1] + a[1] * b[3],
+        a[2] * b[0] + a[3] * b[2], a[2] * b[1] + a[3] * b[3]];
+}
+function determinant(m) { return m[0] * m[3] - m[1] * m[2]; }
+function inverse(m) {
+    const d = determinant(m);
+    if (!Number.isFinite(d) || Math.abs(d) < 1e-12)
+        throw new InvalidScientificInputError("Singular or ill-conditioned affine map.");
+    return [m[3] / d, -m[1] / d, -m[2] / d, m[0] / d];
+}
+function affine(p, m, o) {
+    return { x: m[0] * p.x + m[1] * p.y + o.x, y: m[2] * p.x + m[3] * p.y + o.y };
+}
+/** Parses strict transform data, rejecting unknown semantics and noninvertible profiles. */
+export function parseDigitalGeometricTransform(value) {
+    const r = record(value, ["id", "version", "domain", "purpose", "kind", "matrix", "offsetMm", "profile"]);
+    const identity = {
+        id: textValue(r.id), version: textValue(r.version),
+        domain: choice(r.domain, ["raw-channel", "reconstructed-linear", "processed-output"]),
+        purpose: choice(r.purpose, ["distortion", "breathing", "digital-stabilization", "orientation-crop", "lateral-ca"])
+    };
+    const kind = choice(r.kind, ["affine", "radial"]);
+    if (kind === "affine") {
+        if (r.profile !== undefined)
+            throw new InvalidScientificInputError("Affine map cannot contain radial profile.");
+        const entries = list(r.matrix, 4).map((v) => finite(v, "matrix"));
+        if (entries.length !== 4)
+            throw new InvalidScientificInputError("Matrix must have four entries.");
+        const matrix = entries;
+        inverse(matrix);
+        return { ...identity, kind, matrix, offsetMm: point(r.offsetMm) };
+    }
+    if (r.matrix !== undefined || r.offsetMm !== undefined)
+        throw new InvalidScientificInputError("Radial map cannot contain affine fields.");
+    const p = record(r.profile, ["normalizationRadiusMm", "maximumNormalizedRadius", "coefficients"]);
+    const c = record(p.coefficients, ["k1", "k2", "k3"]);
+    const profile = { normalizationRadiusMm: positive(p.normalizationRadiusMm, "normalizationRadiusMm"),
+        maximumNormalizedRadius: positive(p.maximumNormalizedRadius, "maximumNormalizedRadius"),
+        coefficients: { k1: finite(c.k1, "k1"), k2: finite(c.k2, "k2"), k3: finite(c.k3, "k3") } };
+    validateRadialDistortionProfile(profile);
+    return { ...identity, kind, profile };
+}
+/** Prepares deterministic still/frame geometry; time changes require another preparation. */
+export function prepareGeometricMapping(input) {
+    const time = finite(input.frameTimeSeconds, "frameTimeSeconds");
+    if (time < 0)
+        throw new InvalidScientificInputError("Time is seconds from exposure start.");
+    const transforms = list(input.transforms, 32).map(parseDigitalGeometricTransform);
+    if (new Set(transforms.map((t) => t.id)).size !== transforms.length)
+        throw new InvalidScientificInputError("Duplicate transform IDs.");
+    const groups = [];
+    for (const t of transforms) {
+        const last = groups.at(-1);
+        if (last?.domain === t.domain)
+            last.componentIds.push(t.id);
+        else
+            groups.push({ domain: t.domain, componentIds: [t.id] });
+    }
+    return approximationResult({ schemaVersion: "0.1.0", frameTimeSeconds: time, transforms,
+        semanticKey: JSON.stringify({ frameTimeSeconds: time, transforms }), groups }, "composed-digital-geometry", "0.1.0", ["Explicit inverse maps; incompatible domains require separate image stages", "No physical PSF, photon or noise-history recalculation"]);
+}
+/** Authoritative display-to-capture map and full local directional derivatives. */
+export function calculateComposedGeometricMapping(input) {
+    const mapping = prepareGeometricMapping(input.mapping).value;
+    return calculatePreparedGeometricMappingPoint(mapping, input.destinationPointMm);
+}
+/** Call-local parsed/copy-owned mapping only; never accepts external prepared state. */
+function calculatePreparedGeometricMappingPoint(mapping, destinationPointMm) {
+    let p = point(destinationPointMm);
+    let j = [1, 0, 0, 1];
+    const components = [];
+    for (const t of mapping.transforms) {
+        let local;
+        if (t.kind === "affine") {
+            // Preserve independent result arrays when one mapping serves many points.
+            local = [...t.matrix];
+            p = affine(p, local, t.offsetMm);
+        }
+        else {
+            const { k1, k2, k3 } = t.profile.coefficients;
+            const r2 = (p.x * p.x + p.y * p.y) / t.profile.normalizationRadiusMm ** 2;
+            const s = 1 + k1 * r2 + k2 * r2 * r2 + k3 * r2 * r2 * r2;
+            const d = 2 * (k1 + 2 * k2 * r2 + 3 * k3 * r2 * r2) / t.profile.normalizationRadiusMm ** 2;
+            local = [s + d * p.x * p.x, d * p.x * p.y, d * p.x * p.y, s + d * p.y * p.y];
+            p = calculateRadialDistortionMapping({ imagePointMm: p, profile: t.profile }).value.mappedImagePointMm;
+        }
+        j = multiply(local, j);
+        components.push({ id: t.id, sourcePointMm: { ...p }, jacobian: local });
+    }
+    // Singular values via the symmetric J^T J eigenproblem. det/smax avoids cancellation at smin.
+    const a = j[0] * j[0] + j[2] * j[2], b = j[0] * j[1] + j[2] * j[3], c = j[1] * j[1] + j[3] * j[3];
+    const maximum = Math.sqrt((a + c + Math.hypot(a - c, 2 * b)) / 2);
+    const det = determinant(j), minimum = Math.abs(det) / maximum;
+    return approximationResult({ sourcePointMm: p, jacobian: j, determinant: det,
+        principalStretches: [maximum, minimum], anisotropy: maximum / minimum, components }, "composed-digital-geometry-point", "0.1.0", ["Jacobian warps already-formed blur and noise; it creates no captured detail"]);
+}
+/** Capture-to-display bridge for focus, metering and overlays; reverses the same maps. */
+export function calculateForwardGeometricMapping(input) {
+    let p = point(input.sourcePointMm);
+    const mapping = prepareGeometricMapping(input.mapping).value;
+    for (const t of [...mapping.transforms].reverse()) {
+        p = t.kind === "affine"
+            ? affine({ x: p.x - t.offsetMm.x, y: p.y - t.offsetMm.y }, inverse(t.matrix), { x: 0, y: 0 })
+            : calculateInverseRadialDistortionMapping({ distortedImagePointMm: p, profile: t.profile }).value.sourceImagePointMm;
+    }
+    return approximationResult(p, "forward-digital-geometry-bridge", "0.1.0", ["Inverse of the authoritative destination-to-source geometry"]);
+}
+/** @internal Shared lattice validation for downstream correction consumers. */
+export function parseGeometricRaster(value) {
+    const r = record(value, ["width", "height", "centerMm", "pitchMm"]);
+    const width = positive(r.width, "width"), height = positive(r.height, "height");
+    if (!Number.isSafeInteger(width) || !Number.isSafeInteger(height) || width * height > 65536) {
+        throw new InvalidScientificInputError("Raster must have at most 65536 integral samples.");
+    }
+    return { width, height, centerMm: point(r.centerMm), pitchMm: positive(r.pitchMm, "pitchMm") };
+}
+function pixelPoint(r, x, y) {
+    return { x: r.centerMm.x + (x + .5 - r.width / 2) * r.pitchMm, y: r.centerMm.y - (y + .5 - r.height / 2) * r.pitchMm };
+}
+function pixelCoordinate(r, p) {
+    return { x: (p.x - r.centerMm.x) / r.pitchMm + r.width / 2 - .5, y: (r.centerMm.y - p.y) / r.pitchMm + r.height / 2 - .5 };
+}
+function supported(r, p, filter) {
+    const q = pixelCoordinate(r, p);
+    return filter === "nearest"
+        ? Math.round(q.x) >= 0 && Math.round(q.x) < r.width && Math.round(q.y) >= 0 && Math.round(q.y) < r.height
+        : q.x >= 0 && q.x <= r.width - 1 && q.y >= 0 && q.y <= r.height - 1;
+}
+/** @internal Shared deterministic crop for a validated pixel mask. */
+export function calculateValidSourceCrop(mask, width, height) {
+    const heights = Array(width).fill(0);
+    let best = null, area = 0;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++)
+            heights[x] = mask[y * width + x] ? heights[x] + 1 : 0;
+        const stack = [];
+        for (let x = 0; x <= width; x++) {
+            const h = x === width ? 0 : heights[x];
+            while (stack.length && heights[stack.at(-1)] > h) {
+                const index = stack.pop(), rectangleHeight = heights[index];
+                const left = stack.length ? stack.at(-1) + 1 : 0, rectangleWidth = x - left;
+                if (rectangleHeight * rectangleWidth > area) {
+                    area = rectangleHeight * rectangleWidth;
+                    best = { x: left, y: y - rectangleHeight + 1, width: rectangleWidth, height: rectangleHeight };
+                }
+            }
+            stack.push(x);
+        }
+    }
+    return best;
+}
+/** Resolves one joint validity/crop/AA plan after composing compatible inverse maps. */
+export function calculateGeometricSamplingPlan(input) {
+    const mapping = prepareGeometricMapping(input.mapping).value;
+    if (mapping.groups.length > 1)
+        throw new InvalidScientificInputError("Separate incompatible-domain groups before resampling.");
+    const source = parseGeometricRaster(input.sourceRaster), destination = parseGeometricRaster(input.destinationRaster);
+    const r = record(input.resampler, ["id", "version", "filter", "antialias"]);
+    const resampler = { id: textValue(r.id), version: textValue(r.version),
+        filter: choice(r.filter, ["nearest", "bilinear"]), antialias: choice(r.antialias, ["none", "source-prefiltered"]) };
+    const projection = positive(input.physicalProjectionDistanceMm, "physicalProjectionDistanceMm");
+    const points = [], mask = [];
+    for (let y = 0; y < destination.height; y++)
+        for (let x = 0; x < destination.width; x++) {
+            const mapped = calculatePreparedGeometricMappingPoint(mapping, pixelPoint(destination, x, y)).value;
+            points.push(mapped);
+            mask.push(supported(source, mapped.sourcePointMm, resampler.filter));
+        }
+    const requiresPrefilter = points.some((p) => p.principalStretches[0] * destination.pitchMm / source.pitchMm > 1 + 1e-12);
+    const crop = calculateValidSourceCrop(mask, destination.width, destination.height);
+    const angle = (mm) => Math.atan(mm / projection) * 180 / Math.PI;
+    const retained = points.filter((_, i) => crop !== null && i % destination.width >= crop.x &&
+        i % destination.width < crop.x + crop.width && Math.floor(i / destination.width) >= crop.y &&
+        Math.floor(i / destination.width) < crop.y + crop.height).map((p) => p.sourcePointMm);
+    const envelope = retained.length ? { minX: Math.min(...retained.map((p) => angle(p.x))),
+        maxX: Math.max(...retained.map((p) => angle(p.x))), minY: Math.min(...retained.map((p) => angle(p.y))),
+        maxY: Math.max(...retained.map((p) => angle(p.y))) } : null;
+    return approximationResult({ mapping, sourceRaster: source, destinationRaster: destination, resampler, points,
+        validSourceMask: mask, jointCrop: crop, requiresPrefilter,
+        canResample: !requiresPrefilter || resampler.antialias === "source-prefiltered",
+        physicalCapturedFovDegrees: {
+            horizontal: angle(source.centerMm.x + source.width * source.pitchMm / 2) - angle(source.centerMm.x - source.width * source.pitchMm / 2),
+            vertical: angle(source.centerMm.y + source.height * source.pitchMm / 2) - angle(source.centerMm.y - source.height * source.pitchMm / 2)
+        }, retainedSampleRayEnvelopeDegrees: envelope }, "joint-geometric-sampling-plan", "0.1.0", ["Mask and crop are exact for this pixel-center lattice/filter, not continuous between-pixel support", "Compression requires explicitly source-prefiltered data; this API does not implement that prefilter", "No temporal trajectory crop guarantee"]);
+}
+/** Samples an already-formed scalar image once; null output marks missing source support. */
+export function calculateGeometricResampling(input) {
+    const plan = calculateGeometricSamplingPlan({ ...input.plan, physicalProjectionDistanceMm: 1 }).value;
+    if (!plan.canResample)
+        throw new InvalidScientificInputError("Compression requires source-prefiltered data.");
+    const source = list(input.sourceSamples, 65536).map((v) => finite(v, "source sample"));
+    if (source.length !== plan.sourceRaster.width * plan.sourceRaster.height)
+        throw new InvalidScientificInputError("Source sample count mismatch.");
+    const samples = plan.points.map((p, index) => {
+        if (!plan.validSourceMask[index])
+            return null;
+        const q = pixelCoordinate(plan.sourceRaster, p.sourcePointMm), width = plan.sourceRaster.width;
+        if (plan.resampler.filter === "nearest")
+            return source[Math.round(q.y) * width + Math.round(q.x)];
+        const x = Math.floor(q.x), y = Math.floor(q.y), dx = q.x - x, dy = q.y - y;
+        // Exact boundary centers need no nonexistent neighbor; no border extension occurs.
+        const x1 = dx === 0 ? x : x + 1, y1 = dy === 0 ? y : y + 1;
+        return (1 - dy) * ((1 - dx) * source[y * width + x] + dx * source[y * width + x1]) +
+            dy * ((1 - dx) * source[y1 * width + x] + dx * source[y1 * width + x1]);
+    });
+    return approximationResult({ samples, resamplePasses: 1, resampler: plan.resampler }, "single-pass-geometric-resampling", "0.1.0", ["Warps captured blur/noise; does not recalculate the optical PSF"]);
+}
+//# sourceMappingURL=geometric-transforms.js.map

package/dist/output/geometric-transforms.js.map

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

package/dist/output/lens-corrections.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Module boundary and integration notes.
+ * Strict parser for generic system corrections; no extrapolation or restoration claim.
+ * Resolves independent camera states, explicit dependencies, RAW intent and educational bypass.
+ * @see docs/DIGITAL_OPTICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and
+ * support limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type IlluminationVignettingProfile } from "../optics/illumination-vignetting.js";
+import { type GenericOpticalEvidence, type OpticalProfileState } from "../optics/profile-contract.js";
+import type { LensFieldPointMm } from "../optics/radial-distortion.js";
+import { type DigitalGeometricTransform, type GeometricImageDomain, type GeometricRaster, type GeometricResampler, type GeometricSamplingPlan } from "./geometric-transforms.js";
+export type LensCorrectionChannel = "red" | "green" | "blue";
+interface CorrectionComponentIdentity {
+    id: string;
+    version: string;
+    domain: GeometricImageDomain;
+    availability: "toggle" | "automatic" | "mandatory";
+    defaultEnabled: boolean;
+    dependencies: readonly string[];
+    requiredByStabilizationModes: readonly string[];
+    /** Declared residual/calibration limitations; not inferred from optical tier. */
+    residualNote: string;
+}
+/** A separately declared correction map may deliberately retain physical distortion. */
+export interface GeometricLensCorrection extends CorrectionComponentIdentity {
+    kind: "geometry";
+    transform: DigitalGeometricTransform;
+}
+/** Channel registration only, not longitudinal CA or color shading. */
+export interface LateralCaLensCorrection extends CorrectionComponentIdentity {
+    kind: "lateral-ca";
+    transforms: Readonly<Record<LensCorrectionChannel, DigitalGeometricTransform>>;
+}
+/** Post-capture scalar gain; strength 0..1 leaves explicit residual falloff. */
+export interface IlluminationLensCorrection extends CorrectionComponentIdentity {
+    kind: "peripheral-illumination";
+    profile: IlluminationVignettingProfile;
+    strength: number;
+}
+export type LensCorrectionComponent = GeometricLensCorrection | LateralCaLensCorrection | IlluminationLensCorrection;
+/** Exact generic system binding, with components in authoritative application order. */
+export interface GenericLensCorrectionProfile {
+    schemaVersion: "0.1.0";
+    id: string;
+    version: string;
+    state: OpticalProfileState;
+    evidence: GenericOpticalEvidence;
+    components: readonly LensCorrectionComponent[];
+}
+export interface ResolvedLensCorrectionPlan {
+    profile: GenericLensCorrectionProfile;
+    outputKind: "raw-like" | "processed";
+    selectionKind: "camera-selectable" | "reference-bypass";
+    components: readonly {
+        component: LensCorrectionComponent;
+        enabled: boolean;
+        reason: "selected" | "default" | "mandatory" | "stabilization-dependency" | "component-dependency" | "reference-bypass";
+    }[];
+    /** RAW-like intent remains metadata only in this first foundation. */
+    application: "metadata-only" | "bake-downstream";
+}
+/** Strict parser for generic system corrections; no extrapolation or restoration claim. */
+export declare function parseGenericLensCorrectionProfile(value: unknown): GenericLensCorrectionProfile;
+/** Resolves independent camera states, explicit dependencies, RAW intent and educational bypass. */
+export declare function resolveLensCorrectionPlan(input: {
+    profile: GenericLensCorrectionProfile;
+    state: OpticalProfileState;
+    selections: Readonly<Record<string, "on" | "off" | "auto">>;
+    outputKind: "raw-like" | "processed";
+    selectionKind: "camera-selectable" | "reference-bypass";
+}): CalculationResult<ResolvedLensCorrectionPlan>;
+/** Applies scalar post-capture gain and reports pre-clip variance; no photon/SNR history rewrite. */
+export declare function calculatePeripheralIlluminationCorrection(input: {
+    component: IlluminationLensCorrection;
+    imagePointMm: LensFieldPointMm;
+    signal: number;
+    noiseVariance: number;
+    clippingLevel: number;
+}): CalculationResult<{
+    gain: number;
+    signalBeforeClipping: number;
+    signal: number;
+    noiseVarianceBeforeClipping: number;
+    clipped: boolean;
+}>;
+/** Immutable capture identity accompanies downstream channels for meaningful On/Off comparisons. */
+export interface LensCorrectionCapture {
+    state: OpticalProfileState;
+    captureId: string;
+    noiseRealizationId: string;
+    timeSeconds: number;
+    raster: GeometricRaster;
+    channels: Readonly<Record<LensCorrectionChannel, readonly number[]>>;
+}
+/** Executes bounded reconstructed-linear corrections on already sampled RGB channels.
+ * Compatible common geometry plus channel CA is sampled once per channel.
+ * A gain between geometry components or incompatible domains requires an external staged consumer.
+ */
+export declare function calculateLensCorrectedCapture(input: {
+    plan: ResolvedLensCorrectionPlan;
+    capture: LensCorrectionCapture;
+    destinationRaster: GeometricRaster;
+    resampler: GeometricResampler;
+    physicalProjectionDistanceMm: number;
+    clippingLevel: number;
+}): CalculationResult<{
+    captureId: string;
+    noiseRealizationId: string;
+    timeSeconds: number;
+    application: ResolvedLensCorrectionPlan["application"];
+    channels: Readonly<Record<LensCorrectionChannel, readonly (number | null)[]>>;
+    samplingPlans: Partial<Record<LensCorrectionChannel, GeometricSamplingPlan>>;
+    /** Intersection across all channel footprints, before crop; no missing colors fabricated. */
+    validSourceMask: readonly boolean[];
+    jointCrop: GeometricSamplingPlan["jointCrop"];
+    /** Gain-stage clipping events before joint support/crop; repeated stages count separately. */
+    illuminationClippingEventCount: number;
+}>;
+export {};
+//# sourceMappingURL=lens-corrections.d.ts.map

package/dist/output/lens-corrections.d.ts.map

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

package/dist/output/lens-corrections.js

@@ -0,0 +1,210 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Strict parser for generic system corrections; no extrapolation or restoration claim.
+ * Resolves independent camera states, explicit dependencies, RAW intent and educational bypass.
+ * @see docs/DIGITAL_OPTICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and
+ * support limits.
+ */
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { calculateIlluminationVignetting } from "../optics/illumination-vignetting.js";
+import { choice, finite, list, parseEvidence, parseOpticalProfileState, positive, record, requireSameState, textValue } from "../optics/profile-contract.js";
+import { calculateGeometricResampling, calculateGeometricSamplingPlan, parseDigitalGeometricTransform, prepareGeometricMapping, parseGeometricRaster, calculateValidSourceCrop } from "./geometric-transforms.js";
+function illumination(value) {
+    const r = record(value, ["normalizationRadiusMm", "maximumNormalizedRadius", "coefficients"]);
+    const c = record(r.coefficients, ["r2", "r4", "r6"]);
+    const profile = { normalizationRadiusMm: positive(r.normalizationRadiusMm, "normalizationRadiusMm"),
+        maximumNormalizedRadius: positive(r.maximumNormalizedRadius, "maximumNormalizedRadius"),
+        coefficients: { r2: finite(c.r2, "r2"), r4: finite(c.r4, "r4"), r6: finite(c.r6, "r6") } };
+    calculateIlluminationVignetting({ imagePointMm: { x: 0, y: 0 }, profile });
+    return profile;
+}
+/** Strict parser for generic system corrections; no extrapolation or restoration claim. */
+export function parseGenericLensCorrectionProfile(value) {
+    const r = record(value, ["schemaVersion", "id", "version", "state", "evidence", "components"]);
+    const components = list(r.components, 16).map((value) => {
+        const c = record(value, ["id", "version", "domain", "availability", "defaultEnabled", "dependencies",
+            "requiredByStabilizationModes", "residualNote", "kind", "transform", "transforms", "profile", "strength"]);
+        if (typeof c.defaultEnabled !== "boolean")
+            throw new InvalidScientificInputError("defaultEnabled must be boolean.");
+        const identity = { id: textValue(c.id), version: textValue(c.version),
+            domain: choice(c.domain, ["raw-channel", "reconstructed-linear", "processed-output"]),
+            availability: choice(c.availability, ["toggle", "automatic", "mandatory"]), defaultEnabled: c.defaultEnabled,
+            dependencies: list(c.dependencies, 16).map(textValue),
+            requiredByStabilizationModes: list(c.requiredByStabilizationModes, 16).map(textValue), residualNote: textValue(c.residualNote) };
+        const kind = choice(c.kind, ["geometry", "lateral-ca", "peripheral-illumination"]);
+        if (kind === "geometry") {
+            if (c.transforms !== undefined || c.profile !== undefined || c.strength !== undefined)
+                throw new InvalidScientificInputError("Extraneous geometry parameters.");
+            const transform = parseDigitalGeometricTransform(c.transform);
+            if (transform.domain !== identity.domain || !["distortion", "breathing"].includes(transform.purpose))
+                throw new InvalidScientificInputError("Geometry domain/purpose mismatch.");
+            return { ...identity, kind, transform };
+        }
+        if (kind === "lateral-ca") {
+            if (c.transform !== undefined || c.profile !== undefined || c.strength !== undefined)
+                throw new InvalidScientificInputError("Extraneous CA parameters.");
+            const t = record(c.transforms, ["red", "green", "blue"]);
+            const transforms = { red: parseDigitalGeometricTransform(t.red), green: parseDigitalGeometricTransform(t.green), blue: parseDigitalGeometricTransform(t.blue) };
+            for (const transform of Object.values(transforms)) {
+                if (transform.domain !== identity.domain || transform.purpose !== "lateral-ca")
+                    throw new InvalidScientificInputError("CA domain/purpose mismatch.");
+            }
+            return { ...identity, kind, transforms };
+        }
+        if (c.transform !== undefined || c.transforms !== undefined)
+            throw new InvalidScientificInputError("Extraneous illumination geometry.");
+        const strength = finite(c.strength, "strength");
+        if (strength < 0 || strength > 1)
+            throw new InvalidScientificInputError("Strength must lie in [0,1].");
+        return { ...identity, kind, profile: illumination(c.profile), strength };
+    });
+    const preceding = new Set(), mappingIds = new Set();
+    for (const c of components) {
+        if (preceding.has(c.id) || c.dependencies.some((id) => !preceding.has(id)) ||
+            new Set(c.dependencies).size !== c.dependencies.length)
+            throw new InvalidScientificInputError("Component IDs/dependency order must be unique and acyclic.");
+        preceding.add(c.id);
+        // Common and per-channel transforms need stable distinct IDs when fused.
+        const maps = c.kind === "geometry" ? [c.transform] : c.kind === "lateral-ca" ? Object.values(c.transforms) : [];
+        for (const t of maps) {
+            if (mappingIds.has(t.id))
+                throw new InvalidScientificInputError("Duplicate correction transform ID.");
+            mappingIds.add(t.id);
+        }
+    }
+    return { schemaVersion: choice(r.schemaVersion, ["0.1.0"]), id: textValue(r.id), version: textValue(r.version),
+        state: parseOpticalProfileState(r.state), evidence: parseEvidence(r.evidence), components };
+}
+/** Resolves independent camera states, explicit dependencies, RAW intent and educational bypass. */
+export function resolveLensCorrectionPlan(input) {
+    const profile = parseGenericLensCorrectionProfile(input.profile);
+    requireSameState(profile.state, input.state);
+    const outputKind = choice(input.outputKind, ["raw-like", "processed"]);
+    const selectionKind = choice(input.selectionKind, ["camera-selectable", "reference-bypass"]);
+    const selections = record(input.selections, profile.components.map((c) => c.id));
+    const components = profile.components.map((c) => {
+        const selection = choice(selections[c.id] ?? "auto", ["on", "off", "auto"]);
+        if (selectionKind === "reference-bypass")
+            return { component: c, enabled: false, reason: "reference-bypass" };
+        const stabilization = c.requiredByStabilizationModes.includes(profile.state.stabilizationMode);
+        if (c.availability === "mandatory" && selection === "off")
+            throw new InvalidScientificInputError("Mandatory correction cannot be disabled as a camera setting; use reference-bypass.");
+        if (c.availability === "automatic" && selection !== "auto")
+            throw new InvalidScientificInputError("Automatic correction has no camera toggle.");
+        return { component: c, enabled: c.availability === "mandatory" || stabilization || (selection === "auto" ? c.defaultEnabled : selection === "on"),
+            reason: c.availability === "mandatory" ? "mandatory" : stabilization ? "stabilization-dependency" : selection === "auto" ? "default" : "selected" };
+    });
+    for (const entry of [...components].reverse())
+        if (entry.enabled)
+            for (const id of entry.component.dependencies) {
+                const dependency = components.find((c) => c.component.id === id);
+                dependency.enabled = true;
+                dependency.reason = "component-dependency";
+            }
+    return approximationResult({ profile, outputKind, selectionKind, components,
+        application: outputKind === "raw-like" ? "metadata-only" : "bake-downstream" }, "generic-camera-lens-correction-plan", "0.1.0", [profile.evidence.basis, profile.evidence.residualNote,
+        "Corrections occur after the same physical capture; tier is not a correction-strength input",
+        "Raw-like output preserves intent without baking corrections; color shading, axial CA and restoration remain unsupported"]);
+}
+/** Applies scalar post-capture gain and reports pre-clip variance; no photon/SNR history rewrite. */
+export function calculatePeripheralIlluminationCorrection(input) {
+    const component = input.component;
+    if (component.kind !== "peripheral-illumination" || component.strength < 0 || component.strength > 1 || !Number.isFinite(component.strength))
+        throw new InvalidScientificInputError("Invalid illumination component.");
+    const signal = finite(input.signal, "signal"), variance = finite(input.noiseVariance, "noiseVariance");
+    const level = positive(input.clippingLevel, "clippingLevel");
+    if (variance < 0)
+        throw new InvalidScientificInputError("Variance must be nonnegative.");
+    const throughput = calculateIlluminationVignetting({ imagePointMm: input.imagePointMm, profile: component.profile }).value.linearThroughputFactor;
+    const gain = throughput ** (-component.strength), before = signal * gain;
+    return approximationResult({ gain, signalBeforeClipping: before, signal: Math.min(level, before),
+        noiseVarianceBeforeClipping: variance * gain * gain, clipped: before > level }, "post-capture-peripheral-illumination-gain", "0.1.0", ["Variance describes pre-clip samples only", "Gain does not increase captured photons or restore sensor SNR"]);
+}
+/** Executes bounded reconstructed-linear corrections on already sampled RGB channels.
+ * Compatible common geometry plus channel CA is sampled once per channel.
+ * A gain between geometry components or incompatible domains requires an external staged consumer.
+ */
+export function calculateLensCorrectedCapture(input) {
+    // Re-resolve untrusted/mutated plans; callers cannot forge enabled/mandatory state.
+    const plan = resolveLensCorrectionPlan({ profile: input.plan.profile, state: input.plan.profile.state,
+        selections: Object.fromEntries(input.plan.components.filter((e) => e.component.availability === "toggle").map((e) => [e.component.id, e.enabled ? "on" : "off"])),
+        outputKind: input.plan.outputKind, selectionKind: input.plan.selectionKind }).value;
+    const capture = input.capture;
+    requireSameState(plan.profile.state, capture.state);
+    const sourceRaster = parseGeometricRaster(capture.raster);
+    const destination = parseGeometricRaster(input.destinationRaster);
+    if (destination.width !== plan.profile.state.outputWidth || destination.height !== plan.profile.state.outputHeight) {
+        throw new InvalidScientificInputError("Destination raster differs from correction output binding.");
+    }
+    textValue(capture.captureId);
+    textValue(capture.noiseRealizationId);
+    if (finite(capture.timeSeconds, "timeSeconds") < 0)
+        throw new InvalidScientificInputError("Invalid capture time.");
+    const count = capture.raster.width * capture.raster.height;
+    for (const channel of ["red", "green", "blue"]) {
+        const data = list(capture.channels[channel], 65536);
+        if (data.length !== count)
+            throw new InvalidScientificInputError("Capture channel sample count mismatch.");
+        data.forEach((s) => finite(s, "channel sample"));
+    }
+    const active = plan.components.filter((e) => e.enabled).map((e) => e.component);
+    const sameLattice = sourceRaster.width === destination.width && sourceRaster.height === destination.height &&
+        sourceRaster.pitchMm === destination.pitchMm && sourceRaster.centerMm.x === destination.centerMm.x &&
+        sourceRaster.centerMm.y === destination.centerMm.y;
+    // Disabling corrections does not disable an explicit output crop/resampling request.
+    if (plan.application === "metadata-only" || (!active.length && sameLattice)) {
+        return approximationResult({ captureId: capture.captureId, noiseRealizationId: capture.noiseRealizationId,
+            timeSeconds: capture.timeSeconds, application: plan.application, channels: capture.channels,
+            samplingPlans: {}, validSourceMask: Array(count).fill(true), illuminationClippingEventCount: 0,
+            jointCrop: { x: 0, y: 0, width: capture.raster.width, height: capture.raster.height } }, "generic-lens-correction-capture", "0.1.0", ["Original physical capture preserved"]);
+    }
+    if (active.some((c) => c.domain !== "reconstructed-linear"))
+        throw new InvalidScientificInputError("This executor requires reconstructed-linear components; other domains need separate consumers.");
+    let seenGain = false;
+    for (const c of active) {
+        if (c.kind === "peripheral-illumination")
+            seenGain = true;
+        else if (seenGain)
+            throw new InvalidScientificInputError("Cannot reorder geometry across a gain stage.");
+    }
+    const channels = {};
+    const samplingPlans = {};
+    let illuminationClippingEventCount = 0;
+    for (const channel of ["red", "green", "blue"]) {
+        // Application order source->destination reverses for inverse sampling.
+        const transforms = active.filter((c) => c.kind !== "peripheral-illumination").reverse().map((c) => c.kind === "geometry" ? c.transform : c.transforms[channel]);
+        const mapping = prepareGeometricMapping({ transforms, frameTimeSeconds: capture.timeSeconds }).value;
+        const sampling = calculateGeometricSamplingPlan({ mapping, sourceRaster: capture.raster,
+            destinationRaster: input.destinationRaster, resampler: input.resampler,
+            physicalProjectionDistanceMm: input.physicalProjectionDistanceMm }).value;
+        samplingPlans[channel] = sampling;
+        let data = calculateGeometricResampling({ plan: sampling, sourceSamples: capture.channels[channel] }).value.samples;
+        for (const c of active)
+            if (c.kind === "peripheral-illumination") {
+                data = data.map((signal, index) => {
+                    if (signal === null)
+                        return null;
+                    const raster = input.destinationRaster, x = index % raster.width, y = Math.floor(index / raster.width);
+                    const corrected = calculatePeripheralIlluminationCorrection({ component: c,
+                        imagePointMm: { x: raster.centerMm.x + (x + .5 - raster.width / 2) * raster.pitchMm,
+                            y: raster.centerMm.y - (y + .5 - raster.height / 2) * raster.pitchMm },
+                        signal, noiseVariance: 0, clippingLevel: input.clippingLevel }).value;
+                    if (corrected.clipped)
+                        illuminationClippingEventCount++;
+                    return corrected.signal;
+                });
+            }
+        channels[channel] = data;
+    }
+    const mask = channels.red.map((_, i) => channels.red[i] !== null && channels.green[i] !== null && channels.blue[i] !== null);
+    for (const channel of ["red", "green", "blue"])
+        channels[channel] = channels[channel].map((s, i) => mask[i] ? s : null);
+    return approximationResult({ captureId: capture.captureId, noiseRealizationId: capture.noiseRealizationId,
+        timeSeconds: capture.timeSeconds, application: plan.application, channels, samplingPlans, validSourceMask: mask,
+        illuminationClippingEventCount,
+        jointCrop: calculateValidSourceCrop(mask, destination.width, destination.height) }, "generic-lens-correction-capture", "0.1.0", ["Input capture/noise realization remains unchanged", "Channel support intersects before output; optical blur/noise is warped, not physically repaired",
+        "No production-plan composition is enabled by this standalone executor"]);
+}
+//# sourceMappingURL=lens-corrections.js.map