@photivra/engine 0.6.0 → 1.0.0

package/dist/sensor/eqe-electron-rate.js

@@ -0,0 +1,561 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Converts pre-response geometric-aperture spectral radiant power into incident-photon rate and
+ * expected generated-electron rate. This function applies response per wavelength node. It never
+ * applies one broadband-average QE to total radiant power. Temporal exposure integration remains
+ * downstream, so all outputs are rates (per second), not photon/electron counts.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { calculatePhotonEnergyFromWavelength } from "./photon-energy.js";
+import { parseSensorColorSamplingProfile } from "./color-sampling.js";
+import { createSensorSpectralResponseChannelBinding, parseSensorSpectralResponseProfile, resolveParsedSensorSpectralResponseAtWavelength } from "./spectral-response.js";
+const REDUCTION_TOLERANCE = 1e-10;
+function addCompensated(state, value) {
+    const adjusted = value - state.correction;
+    const next = state.sum + adjusted;
+    state.correction =
+        (next - state.sum) - adjusted;
+    state.sum = next;
+}
+function requireNonNegativeFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be finite and greater than or equal to zero.");
+    }
+    return value;
+}
+function requirePositiveFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value <= 0) {
+        throw new InvalidScientificInputError(path +
+            " must be finite and greater than zero.");
+    }
+    return value;
+}
+function requireSafeNonNegativeInteger(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be a non-negative safe integer.");
+    }
+    return value;
+}
+function approximatelyEqual(actual, expected) {
+    const scale = Math.max(1, Math.abs(actual), Math.abs(expected));
+    return (Math.abs(actual - expected) <=
+        REDUCTION_TOLERANCE * scale);
+}
+function canonicalJson(value) {
+    return JSON.stringify(value);
+}
+function requireEquivalent(actual, expected, message) {
+    if (canonicalJson(actual) !==
+        canonicalJson(expected)) {
+        throw new InvalidScientificInputError(message);
+    }
+}
+function validateAuthorizationChain(reduction, compatibility, operatingRange) {
+    if (reduction.outputMeaning !==
+        "pre-response-spatio-spectral-radiometric-reduction" ||
+        reduction
+            .spectralResponseApplicationPerformed !==
+            false ||
+        reduction.quantumEfficiencyApplied !==
+            false ||
+        reduction.temporalIntegrationApplied !==
+            false) {
+        throw new InvalidScientificInputError("reduction must remain pre-response and pre-temporal before EQE rate conversion.");
+    }
+    if (!compatibility
+        .structuralCompatibilityEstablished ||
+        compatibility.compatibilityStatus ===
+            "blocked" ||
+        compatibility.blockers.length !== 0 ||
+        !compatibility.sourcePlaneMatched ||
+        compatibility.requiredSignalPath !==
+            "photon-rate-to-electrons") {
+        throw new InvalidScientificInputError("compatibility must establish a non-blocked photon-rate-to-electrons response path.");
+    }
+    if (compatibility.spectralResponseProfileId !==
+        reduction.responseProfileId ||
+        compatibility.colorSamplingProfileId !==
+            reduction.colorSamplingProfileId ||
+        compatibility.channelId !==
+            reduction.channelId ||
+        compatibility.responseScope !==
+            reduction.responseScope) {
+        throw new InvalidScientificInputError("compatibility identities must exactly match the reduction.");
+    }
+    if (!operatingRange
+        .operatingRangeCompatibilityAssessed ||
+        !operatingRange
+            .instantaneousResponseRangeCompatible ||
+        !operatingRange
+            .responseRateConversionAuthorized ||
+        operatingRange.status === "blocked" ||
+        operatingRange.blockers.length !== 0 ||
+        operatingRange.requiredSignalPath !==
+            "photon-rate-to-electrons" ||
+        operatingRange
+            .responseApplicationPerformed !==
+            false ||
+        operatingRange
+            .photonConversionPerformed !== false ||
+        operatingRange
+            .electronConversionPerformed !== false ||
+        operatingRange
+            .temporalIntegrationAuthorized !== false) {
+        throw new InvalidScientificInputError("operatingRange must authorize a clean photon-rate-to-electrons conversion path.");
+    }
+    if (!operatingRange
+        .spectralNodeRangeCompatibilityAssessed ||
+        operatingRange
+            .spectralInputModel.kind !==
+            "per-spectral-bin") {
+        throw new InvalidScientificInputError("operatingRange must establish per-spectral-bin input-range applicability before wavelength-dependent EQE conversion.");
+    }
+    if (operatingRange
+        .spatialLinearityModel.kind !==
+        "linear-superposition-over-geometric-aperture") {
+        throw new InvalidScientificInputError("operatingRange must establish linear superposition over the geometric aperture.");
+    }
+    if (operatingRange.spectralResponseProfileId !==
+        reduction.responseProfileId ||
+        operatingRange.colorSamplingProfileId !==
+            reduction.colorSamplingProfileId ||
+        operatingRange.channelId !==
+            reduction.channelId ||
+        operatingRange.responseApplicationProfileId !==
+            compatibility.applicationProfileId) {
+        throw new InvalidScientificInputError("operatingRange identities must exactly match the reduction and compatibility assessment.");
+    }
+}
+function validateReductionSpectralNodes(reduction) {
+    if (!Array.isArray(reduction.perWavelength) ||
+        !Number.isSafeInteger(reduction.spectralNodeCount) ||
+        reduction.spectralNodeCount <= 0 ||
+        reduction.perWavelength.length !==
+            reduction.spectralNodeCount) {
+        throw new InvalidScientificInputError("reduction.perWavelength must contain exactly spectralNodeCount entries.");
+    }
+    let previousWavelength = Number.NEGATIVE_INFINITY;
+    let normalizedWeightSum = 0;
+    const integratedPower = {
+        sum: 0,
+        correction: 0
+    };
+    reduction.perWavelength.forEach((entry, arrayIndex) => {
+        const sampleIndex = requireSafeNonNegativeInteger(entry.spectralSampleIndex, "reduction.perWavelength[" +
+            arrayIndex +
+            "].spectralSampleIndex");
+        if (sampleIndex !== arrayIndex) {
+            throw new InvalidScientificInputError("reduction spectralSampleIndex values must form the exact contiguous range 0..spectralNodeCount-1.");
+        }
+        const wavelength = requirePositiveFinite(entry.wavelengthNanometers, "reduction.perWavelength[" +
+            arrayIndex +
+            "].wavelengthNanometers");
+        if (wavelength <=
+            previousWavelength) {
+            throw new InvalidScientificInputError("reduction per-wavelength samples must be strictly increasing in wavelength.");
+        }
+        previousWavelength =
+            wavelength;
+        const measure = requirePositiveFinite(entry.wavelengthMeasureNanometers, "reduction.perWavelength[" +
+            arrayIndex +
+            "].wavelengthMeasureNanometers");
+        const normalizedWeight = requirePositiveFinite(entry.normalizedWavelengthWeight, "reduction.perWavelength[" +
+            arrayIndex +
+            "].normalizedWavelengthWeight");
+        const fluxDensity = requireNonNegativeFinite(entry
+            .geometricApertureIncidentSpectralFluxWattsPerNanometer, "reduction.perWavelength[" +
+            arrayIndex +
+            "].geometricApertureIncidentSpectralFluxWattsPerNanometer");
+        const contribution = requireNonNegativeFinite(entry
+            .wavelengthIntegratedGeometricApertureIncidentFluxContributionWatts, "reduction.perWavelength[" +
+            arrayIndex +
+            "].wavelengthIntegratedGeometricApertureIncidentFluxContributionWatts");
+        const expectedContribution = fluxDensity * measure;
+        if (!Number.isFinite(expectedContribution) ||
+            !approximatelyEqual(contribution, expectedContribution)) {
+            throw new InvalidScientificInputError("reduction per-wavelength radiant-power contribution must equal spectral flux density × d-lambda.");
+        }
+        normalizedWeightSum +=
+            normalizedWeight;
+        if (!Number.isFinite(normalizedWeightSum)) {
+            throw new InvalidScientificInputError("reduction normalized wavelength weights must remain finite.");
+        }
+        addCompensated(integratedPower, contribution);
+    });
+    if (!approximatelyEqual(normalizedWeightSum, 1)) {
+        throw new InvalidScientificInputError("reduction normalized wavelength weights must sum to 1.");
+    }
+    const totalPower = requireNonNegativeFinite(reduction
+        .wavelengthIntegratedGeometricApertureIncidentFluxWatts, "reduction.wavelengthIntegratedGeometricApertureIncidentFluxWatts");
+    if (!approximatelyEqual(integratedPower.sum, totalPower)) {
+        throw new InvalidScientificInputError("reduction total geometric-aperture radiant power must match the sum of per-wavelength contributions.");
+    }
+    return reduction.perWavelength;
+}
+function validateOperatingRangeNodeBinding(reduction, nodes, operatingRange) {
+    const evaluated = operatingRange
+        .evaluatedSpectralNodeInputs;
+    if (evaluated === undefined ||
+        evaluated.length !== nodes.length) {
+        throw new InvalidScientificInputError("operatingRange must carry one evaluated spectral-node input for every reduction wavelength node.");
+    }
+    if (operatingRange
+        .evaluatedWavelengthRangeNanometers
+        .minimum !==
+        reduction.wavelengthRangeNanometers
+            .minimum ||
+        operatingRange
+            .evaluatedWavelengthRangeNanometers
+            .maximum !==
+            reduction.wavelengthRangeNanometers
+                .maximum) {
+        throw new InvalidScientificInputError("operatingRange wavelength range must exactly match the reduction.");
+    }
+    evaluated.forEach((entry, index) => {
+        const node = nodes[index];
+        if (entry.spectralSampleIndex !==
+            node.spectralSampleIndex ||
+            entry.wavelengthNanometers !==
+                node.wavelengthNanometers ||
+            entry.wavelengthMeasureNanometers !==
+                node.wavelengthMeasureNanometers) {
+            throw new InvalidScientificInputError("operatingRange spectral-node identities must exactly match the reduction.");
+        }
+        const expected = operatingRange.inputRange.kind ===
+            "wavelength-integrated-geometric-aperture-radiant-power"
+            ? node
+                .wavelengthIntegratedGeometricApertureIncidentFluxContributionWatts
+            : node
+                .wavelengthIntegratedSpatialAverageContributionWattsPerSquareMeter;
+        if (entry.kind !==
+            operatingRange.inputRange.kind ||
+            entry.unit !==
+                operatingRange.inputRange.unit ||
+            !approximatelyEqual(entry.value, expected)) {
+            throw new InvalidScientificInputError("operatingRange spectral-node values must match the reduction values in the calibrated input domain.");
+        }
+    });
+}
+function parseAirContext(reduction, nodes, context) {
+    if (reduction.wavelengthBasis ===
+        "vacuum") {
+        if (context !== undefined) {
+            throw new InvalidScientificInputError("airPhotonEnergyContext must be omitted for vacuum-basis EQE conversion.");
+        }
+        return new Map();
+    }
+    if (reduction.wavelengthBasis !== "air") {
+        throw new InvalidScientificInputError("EQE electron-rate conversion requires a resolved air or vacuum wavelength basis.");
+    }
+    if (context === undefined ||
+        !Array.isArray(context.samples) ||
+        context.samples.length !==
+            nodes.length) {
+        throw new InvalidScientificInputError("Air-basis EQE conversion requires exactly one refractive-index sample for every spectral node.");
+    }
+    const byIndex = new Map();
+    context.samples.forEach((entry, arrayIndex) => {
+        if (typeof entry !== "object" ||
+            entry === null) {
+            throw new InvalidScientificInputError("airPhotonEnergyContext.samples[" +
+                arrayIndex +
+                "] must be an object.");
+        }
+        const spectralSampleIndex = requireSafeNonNegativeInteger(entry.spectralSampleIndex, "airPhotonEnergyContext.samples[" +
+            arrayIndex +
+            "].spectralSampleIndex");
+        if (spectralSampleIndex >=
+            nodes.length ||
+            byIndex.has(spectralSampleIndex)) {
+            throw new InvalidScientificInputError("airPhotonEnergyContext must contain unique in-range spectral sample identities.");
+        }
+        byIndex.set(spectralSampleIndex, entry.refractiveIndex);
+    });
+    return byIndex;
+}
+function responseEvidenceMatches(actual, expected) {
+    return (canonicalJson(actual) ===
+        canonicalJson(expected));
+}
+function validateResponseBinding(resolved, reduction) {
+    if (resolved.profileId !==
+        reduction.responseProfileId ||
+        resolved.colorSamplingProfileId !==
+            reduction.colorSamplingProfileId ||
+        resolved.channelId !==
+            reduction.channelId ||
+        resolved.sourceResponseKind !==
+            reduction.sourceResponseKind ||
+        resolved.responseScope !==
+            reduction.responseScope ||
+        resolved.scientificStatus !==
+            reduction.responseScientificStatus) {
+        throw new InvalidScientificInputError("Resolved spectral response metadata must exactly match the response used to construct the reduction.");
+    }
+    requireEquivalent(resolved.uncertainty, reduction.responseUncertainty, "Resolved spectral response uncertainty must match the reduction.");
+    const expectedEvidence = reduction.componentEvidence.spectral;
+    if (!responseEvidenceMatches(resolved.componentEvidence.profile, expectedEvidence.profile) ||
+        !responseEvidenceMatches(resolved.componentEvidence.channel, expectedEvidence.channel) ||
+        canonicalJson(resolved.componentEvidence.curves) !==
+            canonicalJson(expectedEvidence.curves)) {
+        throw new InvalidScientificInputError("Resolved spectral response evidence must match the calibration evidence carried by the reduction.");
+    }
+}
+function validateExactResponseDataBinding(responseProfile, reduction) {
+    const response = responseProfile.channels.find((entry) => entry.channelId ===
+        reduction.channelId);
+    if (response === undefined ||
+        reduction.responseChannelBinding ===
+            undefined ||
+        canonicalJson(createSensorSpectralResponseChannelBinding(response)) !==
+            canonicalJson(reduction.responseChannelBinding)) {
+        throw new InvalidScientificInputError("Supplied spectral response channel data must exactly match the response-channel binding carried by the reduction.");
+    }
+}
+function requireEqeResponse(response) {
+    if (response.kind !==
+        "effective-external-quantum-efficiency") {
+        throw new InvalidScientificInputError("EQE electron-rate conversion cannot consume A/W spectral responsivity.");
+    }
+    return response;
+}
+/**
+ * Converts pre-response geometric-aperture spectral radiant power into
+ * incident-photon rate and expected generated-electron rate.
+ *
+ * This function applies response per wavelength node. It never applies one
+ * broadband-average QE to total radiant power.
+ *
+ * Temporal exposure integration remains downstream, so all outputs are rates
+ * (per second), not photon/electron counts.
+ */
+export function calculateSensorEqeElectronRate(input) {
+    validateAuthorizationChain(input.reduction, input.compatibility, input.operatingRange);
+    if (input.reduction
+        .sourceResponseKind ===
+        "effective-spectral-responsivity") {
+        throw new InvalidScientificInputError("EQE electron-rate conversion requires an EQE or filter×detector-EQE response, not A/W responsivity.");
+    }
+    const colorProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
+    const responseProfile = parseSensorSpectralResponseProfile(input.spectralResponseProfile);
+    if (colorProfile.profileId !==
+        input.reduction
+            .colorSamplingProfileId ||
+        responseProfile.profileId !==
+            input.reduction
+                .responseProfileId ||
+        responseProfile
+            .colorSamplingProfileId !==
+            colorProfile.profileId) {
+        throw new InvalidScientificInputError("Supplied color/spectral response profiles must exactly match the reduction identities.");
+    }
+    validateExactResponseDataBinding(responseProfile, input.reduction);
+    const nodes = validateReductionSpectralNodes(input.reduction);
+    validateOperatingRangeNodeBinding(input.reduction, nodes, input.operatingRange);
+    const airIndices = parseAirContext(input.reduction, nodes, input.airPhotonEnergyContext);
+    const photonRateSum = {
+        sum: 0,
+        correction: 0
+    };
+    const electronRateSum = {
+        sum: 0,
+        correction: 0
+    };
+    const perWavelength = [];
+    let responseBindingValidated = false;
+    let channelFilterTransmissionApplied = false;
+    for (const node of nodes) {
+        const resolved = resolveParsedSensorSpectralResponseAtWavelength({
+            colorSamplingProfile: colorProfile,
+            spectralResponseProfile: responseProfile,
+            channelId: input.reduction.channelId,
+            wavelengthNanometers: node.wavelengthNanometers,
+            wavelengthBasis: input.reduction
+                .wavelengthBasis
+        });
+        if (!responseBindingValidated) {
+            validateResponseBinding(resolved.value, input.reduction);
+            responseBindingValidated =
+                true;
+        }
+        const eqe = requireEqeResponse(resolved.value.response);
+        const airIndex = airIndices.get(node.spectralSampleIndex);
+        const photonEnergy = calculatePhotonEnergyFromWavelength({
+            wavelengthNanometers: node.wavelengthNanometers,
+            wavelengthBasis: input.reduction
+                .wavelengthBasis,
+            ...(input.reduction
+                .wavelengthBasis === "air"
+                ? {
+                    airPhaseRefractiveIndex: airIndex,
+                    ...(input.airPhotonEnergyContext
+                        .operatingConditions ===
+                        undefined
+                        ? {}
+                        : {
+                            airOperatingConditions: input
+                                .airPhotonEnergyContext
+                                .operatingConditions
+                        }),
+                    airConditionPolicy: input.airPhotonEnergyContext
+                        .conditionPolicy
+                }
+                : {})
+        }).value;
+        const radiantPowerContributionWatts = node
+            .geometricApertureIncidentSpectralFluxWattsPerNanometer *
+            node.wavelengthMeasureNanometers;
+        const incidentPhotonRatePerSecond = radiantPowerContributionWatts /
+            photonEnergy.photonEnergyJoules;
+        const expectedGeneratedElectronRatePerSecond = incidentPhotonRatePerSecond *
+            eqe.externalQuantumEfficiency;
+        if (!Number.isFinite(radiantPowerContributionWatts) ||
+            !Number.isFinite(incidentPhotonRatePerSecond) ||
+            !Number.isFinite(expectedGeneratedElectronRatePerSecond)) {
+            throw new InvalidScientificInputError("EQE wavelength-node rate calculation must remain finite.");
+        }
+        addCompensated(photonRateSum, incidentPhotonRatePerSecond);
+        addCompensated(electronRateSum, expectedGeneratedElectronRatePerSecond);
+        if (eqe.composition ===
+            "channel-filter-transmittance-times-detector-eqe") {
+            channelFilterTransmissionApplied =
+                true;
+        }
+        perWavelength.push({
+            spectralSampleIndex: node.spectralSampleIndex,
+            wavelengthNanometers: node.wavelengthNanometers,
+            wavelengthMeasureNanometers: node.wavelengthMeasureNanometers,
+            geometricApertureIncidentSpectralFluxWattsPerNanometer: node
+                .geometricApertureIncidentSpectralFluxWattsPerNanometer,
+            radiantPowerContributionWatts,
+            vacuumWavelengthNanometers: photonEnergy
+                .vacuumWavelengthNanometers,
+            photonEnergyJoules: photonEnergy
+                .photonEnergyJoules,
+            wavelengthConversion: photonEnergy
+                .wavelengthConversion,
+            ...(photonEnergy
+                .phaseRefractiveIndexUsed ===
+                undefined
+                ? {}
+                : {
+                    phaseRefractiveIndexUsed: photonEnergy
+                        .phaseRefractiveIndexUsed
+                }),
+            ...(photonEnergy
+                .airConditionCompatibility ===
+                undefined
+                ? {}
+                : {
+                    airConditionCompatibility: photonEnergy
+                        .airConditionCompatibility
+                }),
+            ...(photonEnergy
+                .airRefractiveIndexEvidence ===
+                undefined
+                ? {}
+                : {
+                    airRefractiveIndexEvidence: photonEnergy
+                        .airRefractiveIndexEvidence
+                }),
+            incidentPhotonRatePerSecond,
+            effectiveExternalQuantumEfficiency: eqe.externalQuantumEfficiency,
+            responseComposition: eqe.composition,
+            ...(eqe.channelFilterTransmittance ===
+                undefined
+                ? {}
+                : {
+                    channelFilterTransmittance: eqe.channelFilterTransmittance
+                }),
+            ...(eqe
+                .detectorExternalQuantumEfficiency ===
+                undefined
+                ? {}
+                : {
+                    detectorExternalQuantumEfficiency: eqe
+                        .detectorExternalQuantumEfficiency
+                }),
+            responseInterpolationUsed: resolved.value
+                .interpolationUsed,
+            expectedGeneratedElectronRatePerSecond
+        });
+    }
+    if (!Number.isFinite(photonRateSum.sum) ||
+        !Number.isFinite(electronRateSum.sum)) {
+        throw new InvalidScientificInputError("Total EQE photon/electron rates must remain finite.");
+    }
+    return approximationResult({
+        colorSamplingProfileId: input.reduction
+            .colorSamplingProfileId,
+        responseProfileId: input.reduction
+            .responseProfileId,
+        responseApplicationProfileId: input.compatibility
+            .applicationProfileId,
+        operatingRangeProfileId: input.operatingRange
+            .operatingRangeProfileId,
+        site: {
+            ...input.reduction.site
+        },
+        channelId: input.reduction.channelId,
+        sourceResponseKind: input.reduction
+            .sourceResponseKind,
+        responseScope: input.reduction.responseScope,
+        responseReferencePlane: input.compatibility
+            .requiredSourcePlane,
+        wavelengthBasis: input.reduction
+            .wavelengthBasis,
+        wavelengthRangeNanometers: {
+            ...input.reduction
+                .wavelengthRangeNanometers
+        },
+        spectralNodeCount: nodes.length,
+        perWavelength,
+        incidentPhotonRatePerSecond: photonRateSum.sum,
+        expectedGeneratedElectronRatePerSecond: electronRateSum.sum,
+        summationMethod: "kahan-compensated",
+        responseApplicationPerformed: true,
+        quantumEfficiencyApplied: true,
+        spectralResponsivityApplied: false,
+        channelFilterTransmissionApplied,
+        photonRateCalculated: true,
+        electronRateCalculated: true,
+        photonCountCalculated: false,
+        electronCountCalculated: false,
+        currentCalculated: false,
+        temporalIntegrationApplied: false,
+        exposureDurationApplied: false,
+        saturationAssessed: false,
+        shotNoiseApplied: false,
+        readNoiseApplied: false,
+        adcQuantizationApplied: false,
+        rawCodeValueProduced: false,
+        responseUncertaintyPropagated: false,
+        photonEnergyUncertaintyPropagated: false,
+        quadratureConvergenceErrorEstimated: false
+    }, "sensor-eqe-electron-rate", "1.0.0", [
+        "Response is evaluated independently at every wavelength quadrature node; broadband radiant power is never multiplied by an average QE.",
+        "Each node converts radiant power to photon rate using photon energy hν, then applies effective external QE to obtain expected generated-electron rate.",
+        "Direct effective EQE is preserved as direct response; explicitly separable channel-filter transmittance × detector EQE is multiplied only through the existing spectral-response resolver.",
+        "The response calibration metadata/evidence must match the spectral evidence carried by the pre-response reduction; matching profile IDs alone is insufficient.",
+        "The structural compatibility and operating-range assessments must both be non-blocked and authorize the photon-rate→electron path.",
+        "Operating-range authorization must be per spectral bin, with spectral-node identities and calibrated-domain values bound back to the exact reduction used for conversion.",
+        "Operating-range authorization must establish linear superposition over the geometric aperture so spatial reduction may precede response application without hiding sub-aperture nonlinear behavior.",
+        "Air-basis spectral nodes require one exact-wavelength sourced phase refractive index per spectral sample plus the photon-energy atmosphere compatibility policy.",
+        "Kahan compensated summation is used across wavelength nodes to reduce loss of small contributions when rates span large dynamic ranges.",
+        "Outputs are instantaneous expected rates only. Exposure duration, photon/electron counts, full-well saturation, shot/read noise, ADC/RAW conversion and reconstruction remain downstream.",
+        "Response/refractive-index uncertainties and quadrature convergence error are not propagated into a combined output uncertainty by this version."
+    ]);
+}
+//# sourceMappingURL=eqe-electron-rate.js.map

package/dist/sensor/eqe-electron-rate.js.map

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

package/dist/sensor/eqe-local-exposure.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Module boundary and integration notes.
+ * Compose validated irradiance reduction, response applicability/range, EQE conversion and stationary
+ * local integration. The exposure value is suitable for accumulated-charge photoSignal;
+ * dark/completeness/capacity/readout remain explicit downstream inputs. Invalid or unsupported
+ * evidence fails closed.
+ * Internal shared instantaneous path; no stationarity or exposure accumulation.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { calculateSensorSpatialSamplingQuadrature, type CalculateSensorSpatialSamplingQuadratureInput } from "./spatial-sampling-quadrature.js";
+import { calculateSensorSpectralQuadrature, type CalculateSensorSpectralQuadratureInput } from "./spectral-quadrature.js";
+import { reduceSensorSpatioSpectralIrradiance, type ReduceSensorSpatioSpectralIrradianceInput } from "./spatio-spectral-reduction.js";
+import { assessSensorResponseApplicationCompatibility, type AssessSensorResponseApplicationCompatibilityInput } from "./response-application-compatibility.js";
+import { assessSensorResponseOperatingRange, type AssessSensorResponseOperatingRangeInput } from "./response-operating-range.js";
+import { calculateSensorEqeElectronRate, type CalculateSensorEqeElectronRateInput } from "./eqe-electron-rate.js";
+import { bindSensorRateToLocalExposure, type BindSensorRateToLocalExposureInput } from "./local-exposure-binding.js";
+import { type SensorEqeExposureIntegration, type SensorRateTemporalStationarityProfile } from "./constant-rate-temporal-integration.js";
+/** Explicit post-optics irradiance samples and evidence; no renderer or RGB conversion. */
+export interface CalculateSensorEqeLocalExposureInput {
+    /** Physical area, registered aperture/lattice, AA support and destination site. */
+    spatialSampling: Omit<CalculateSensorSpatialSamplingQuadratureInput, "colorSamplingProfile" | "colorSamplingBindingProfile" | "nativeRaster">;
+    /** Explicit wavelength basis/range, channel and midpoint subdivision budget. */
+    spectralSampling: Omit<CalculateSensorSpectralQuadratureInput, "colorSamplingProfile" | "spectralResponseProfile">;
+    /** One W/m²/nm value per identified pre-AA spatial/spectral node. */
+    irradianceSamples: ReduceSensorSpatioSpectralIrradianceInput["sampleValues"];
+    /** Source-plane, collection-area and reference-condition evidence. */
+    responseApplication: Omit<AssessSensorResponseApplicationCompatibilityInput, "reduction">;
+    /** Evidence-backed linear response domain; no extrapolation is authorized. */
+    operatingRangeProfile: AssessSensorResponseOperatingRangeInput["operatingRangeProfile"];
+    /** Destination CFA/channel identity shared by every composed step. */
+    colorSamplingProfile: CalculateSensorEqeElectronRateInput["colorSamplingProfile"];
+    /** Direct or separable EQE response; A/W responsivity is unsupported here. */
+    spectralResponseProfile: CalculateSensorEqeElectronRateInput["spectralResponseProfile"];
+    /** Required explicit photon-energy conversion context for air wavelengths. */
+    airPhotonEnergyContext?: CalculateSensorEqeElectronRateInput["airPhotonEnergyContext"];
+    /** Native one-to-one site binding and one opening/closing shutter event. */
+    localExposure: Omit<BindSensorRateToLocalExposureInput, "rate" | "colorSamplingProfile">;
+    /** Separate declaration authorizing a constant rate across this exact window. */
+    stationarityProfile: SensorRateTemporalStationarityProfile;
+}
+/** Child envelopes retain separate provenance, validity and unpropagated uncertainty. */
+export interface SensorEqeLocalExposure {
+    upstreamOrigin: "declared-spatio-spectral-irradiance-samples";
+    upstreamSceneAndOpticsVerified: false;
+    spatialQuadrature: ReturnType<typeof calculateSensorSpatialSamplingQuadrature>;
+    spectralQuadrature: ReturnType<typeof calculateSensorSpectralQuadrature>;
+    reduction: ReturnType<typeof reduceSensorSpatioSpectralIrradiance>;
+    compatibility: ReturnType<typeof assessSensorResponseApplicationCompatibility>;
+    operatingRange: ReturnType<typeof assessSensorResponseOperatingRange>;
+    electronRate: ReturnType<typeof calculateSensorEqeElectronRate>;
+    exposureBinding: ReturnType<typeof bindSensorRateToLocalExposure>;
+    exposure: CalculationResult<SensorEqeExposureIntegration>;
+}
+/**
+ * Compose validated irradiance reduction, response applicability/range, EQE
+ * conversion and stationary local integration. The exposure value is suitable
+ * for accumulated-charge photoSignal; dark/completeness/capacity/readout remain
+ * explicit downstream inputs. Invalid or unsupported evidence fails closed.
+ */
+export declare function calculateSensorEqeLocalExposure(input: CalculateSensorEqeLocalExposureInput): CalculationResult<SensorEqeLocalExposure>;
+/** Internal shared instantaneous path; no stationarity or exposure accumulation. */
+export declare function calculateSensorEqeLocalRate(input: Omit<CalculateSensorEqeLocalExposureInput, "stationarityProfile">): Omit<SensorEqeLocalExposure, "upstreamOrigin" | "upstreamSceneAndOpticsVerified" | "exposure">;
+//# sourceMappingURL=eqe-local-exposure.d.ts.map

package/dist/sensor/eqe-local-exposure.d.ts.map

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