@photivra/engine 0.6.0 → 1.0.1

package/dist/sensor/constant-rate-temporal-integration.js

@@ -0,0 +1,382 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary. Rate times duration
+ * is allowed only by explicit stationarity bound to the exact site and local shutter interval. EQE
+ * integrates to expected photons/electrons; A/W integrates current magnitude to coulombs without an
+ * implicit carrier mapping. Counts remain fractional expectations before stochastic sampling.
+ * Integrates one explicitly stationary response-rate result over its exact bound local exposure
+ * window. This function is intentionally limited to the constant-rate approximation. It does not
+ * sample or integrate a time-varying signal.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { approximationResult, calculatedResult } from "../core/calculation-result.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+function requireRecord(value, path) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an object.");
+    }
+    return value;
+}
+function requireNonEmptyString(value, path) {
+    if (typeof value !== "string" ||
+        value.trim().length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty string.");
+    }
+    return value;
+}
+function requireNonNegativeSafeInteger(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < 0) {
+        throw new InvalidConfigurationError(path +
+            " must be a non-negative safe integer.");
+    }
+    return value;
+}
+function requireFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value)) {
+        throw new InvalidConfigurationError(path + " must be finite.");
+    }
+    return value;
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Rate times duration is allowed only by explicit stationarity bound to the exact site and local
+ * shutter interval. EQE integrates to expected photons/electrons; A/W integrates current magnitude to
+ * coulombs without an implicit carrier mapping. Counts remain fractional expectations before
+ * stochastic sampling.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SensorRateTemporalStationarityProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export function parseSensorRateTemporalStationarityProfile(value) {
+    const record = requireRecord(value, "sensorRateTemporalStationarity");
+    if (record.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('sensorRateTemporalStationarity.schemaVersion must be "0.1.0".');
+    }
+    if (record.rateDomain !==
+        "eqe-electron-rate" &&
+        record.rateDomain !==
+            "responsivity-photocurrent") {
+        throw new InvalidConfigurationError("sensorRateTemporalStationarity.rateDomain is invalid.");
+    }
+    const site = requireRecord(record.site, "sensorRateTemporalStationarity.site");
+    const localExposureWindow = requireRecord(record.localExposureWindow, "sensorRateTemporalStationarity.localExposureWindow");
+    if (localExposureWindow.timeReference !==
+        "first-opening-boundary-phase") {
+        throw new InvalidConfigurationError('sensorRateTemporalStationarity.localExposureWindow.timeReference must be "first-opening-boundary-phase".');
+    }
+    if (record.stationarityMeaning !==
+        "reported-rate-constant-through-bound-local-exposure") {
+        throw new InvalidConfigurationError("sensorRateTemporalStationarity.stationarityMeaning is invalid.");
+    }
+    if (record.status !== "established" &&
+        record.status !== "approximation") {
+        throw new InvalidConfigurationError("sensorRateTemporalStationarity.status is invalid.");
+    }
+    const limitation = record.limitation === undefined
+        ? undefined
+        : requireNonEmptyString(record.limitation, "sensorRateTemporalStationarity.limitation");
+    if (record.status === "approximation" &&
+        limitation === undefined) {
+        throw new InvalidConfigurationError("sensorRateTemporalStationarity.limitation is required for an approximation.");
+    }
+    const start = requireFinite(localExposureWindow
+        .startOffsetSecondsFromOpeningReference, "sensorRateTemporalStationarity.localExposureWindow.startOffsetSecondsFromOpeningReference");
+    const end = requireFinite(localExposureWindow
+        .endOffsetSecondsFromOpeningReference, "sensorRateTemporalStationarity.localExposureWindow.endOffsetSecondsFromOpeningReference");
+    if (!(end > start)) {
+        throw new InvalidConfigurationError("sensorRateTemporalStationarity.localExposureWindow end must be greater than start.");
+    }
+    return {
+        schemaVersion: "0.1.0",
+        profileId: requireNonEmptyString(record.profileId, "sensorRateTemporalStationarity.profileId"),
+        rateDomain: record.rateDomain,
+        colorSamplingProfileId: requireNonEmptyString(record.colorSamplingProfileId, "sensorRateTemporalStationarity.colorSamplingProfileId"),
+        channelId: requireNonEmptyString(record.channelId, "sensorRateTemporalStationarity.channelId"),
+        site: {
+            x: requireNonNegativeSafeInteger(site.x, "sensorRateTemporalStationarity.site.x"),
+            y: requireNonNegativeSafeInteger(site.y, "sensorRateTemporalStationarity.site.y")
+        },
+        bindingId: requireNonEmptyString(record.bindingId, "sensorRateTemporalStationarity.bindingId"),
+        localExposureWindow: {
+            timeReference: "first-opening-boundary-phase",
+            startOffsetSecondsFromOpeningReference: start,
+            endOffsetSecondsFromOpeningReference: end
+        },
+        stationarityMeaning: "reported-rate-constant-through-bound-local-exposure",
+        status: record.status,
+        evidence: parseEvidenceList(record.evidence, "sensorRateTemporalStationarity.evidence"),
+        ...(limitation === undefined
+            ? {}
+            : { limitation })
+    };
+}
+function sameSite(a, b) {
+    return a.x === b.x && a.y === b.y;
+}
+function requireRateSite(rate) {
+    if (rate.site === undefined ||
+        !Number.isSafeInteger(rate.site.x) ||
+        rate.site.x < 0 ||
+        !Number.isSafeInteger(rate.site.y) ||
+        rate.site.y < 0) {
+        throw new InvalidScientificInputError("rate.site is required for temporal integration.");
+    }
+    return {
+        x: rate.site.x,
+        y: rate.site.y
+    };
+}
+function validateBinding(rate, binding) {
+    const site = requireRateSite(rate);
+    if (!sameSite(site, binding.site) ||
+        binding.colorSamplingProfileId !==
+            rate.colorSamplingProfileId ||
+        binding.channelId !==
+            rate.channelId) {
+        throw new InvalidScientificInputError("rate and exposureBinding must reference the same color site/channel.");
+    }
+    const rateDomain = rate.sourceResponseKind ===
+        "effective-spectral-responsivity"
+        ? "responsivity-photocurrent"
+        : "eqe-electron-rate";
+    if (binding.rateDomain !==
+        rateDomain ||
+        binding
+            .nativeImageRasterBindingEstablished !==
+            true ||
+        binding.channelAtSiteValidated !==
+            true ||
+        binding
+            .constantRateTemporalIntegrationAuthorized !==
+            false ||
+        binding.timeStationarityEstablished !==
+            false ||
+        binding.temporalIntegrationApplied !==
+            false ||
+        binding
+            .multiFrameSequenceBindingEstablished !==
+            false) {
+        throw new InvalidScientificInputError("exposureBinding must remain an unintegrated local timing binding for the same rate domain.");
+    }
+    if (binding.rateIdentity
+        .responseProfileId !==
+        rate.responseProfileId ||
+        binding.rateIdentity
+            .responseApplicationProfileId !==
+            rate.responseApplicationProfileId ||
+        binding.rateIdentity
+            .operatingRangeProfileId !==
+            rate.operatingRangeProfileId) {
+        throw new InvalidScientificInputError("exposureBinding response-rate identity must match the rate.");
+    }
+    if (rateDomain ===
+        "responsivity-photocurrent") {
+        const current = rate;
+        if (binding.rateIdentity
+            .electricalApplicabilityProfileId !==
+            current
+                .electricalApplicabilityProfileId) {
+            throw new InvalidScientificInputError("exposureBinding electrical applicability identity must match the A/W rate.");
+        }
+    }
+    else if (binding.rateIdentity
+        .electricalApplicabilityProfileId !==
+        undefined) {
+        throw new InvalidScientificInputError("EQE exposureBinding must not carry an A/W electrical applicability identity.");
+    }
+    const window = binding.localExposureWindow;
+    const duration = window
+        .endOffsetSecondsFromOpeningReference -
+        window
+            .startOffsetSecondsFromOpeningReference;
+    if (!Number.isFinite(duration) ||
+        duration <= 0 ||
+        !Number.isFinite(binding.localExposureDurationSeconds) ||
+        binding.localExposureDurationSeconds !==
+            duration) {
+        throw new InvalidScientificInputError("exposureBinding local duration must exactly equal end minus start and remain positive.");
+    }
+    return {
+        rateDomain,
+        site,
+        duration
+    };
+}
+function validateStationarity(stationarity, binding, rateDomain, site) {
+    if (stationarity.rateDomain !==
+        rateDomain ||
+        stationarity
+            .colorSamplingProfileId !==
+            binding.colorSamplingProfileId ||
+        stationarity.channelId !==
+            binding.channelId ||
+        !sameSite(stationarity.site, site) ||
+        stationarity.bindingId !==
+            binding.bindingId ||
+        stationarity
+            .localExposureWindow
+            .timeReference !==
+            binding.timeReference ||
+        stationarity
+            .localExposureWindow
+            .startOffsetSecondsFromOpeningReference !==
+            binding.localExposureWindow
+                .startOffsetSecondsFromOpeningReference ||
+        stationarity
+            .localExposureWindow
+            .endOffsetSecondsFromOpeningReference !==
+            binding.localExposureWindow
+                .endOffsetSecondsFromOpeningReference) {
+        throw new InvalidScientificInputError("stationarityProfile must apply to the exact bound rate domain, site, binding, and local exposure window.");
+    }
+}
+function requireNonNegativeFiniteRate(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;
+}
+/**
+ * Integrates one explicitly stationary response-rate result over its exact
+ * bound local exposure window.
+ *
+ * This function is intentionally limited to the constant-rate approximation.
+ * It does not sample or integrate a time-varying signal.
+ */
+export function integrateStationarySensorRateOverLocalExposure(input) {
+    const binding = validateBinding(input.rate, input.exposureBinding);
+    const stationarity = parseSensorRateTemporalStationarityProfile(input.stationarityProfile);
+    validateStationarity(stationarity, input.exposureBinding, binding.rateDomain, binding.site);
+    const common = {
+        colorSamplingProfileId: input.rate
+            .colorSamplingProfileId,
+        channelId: input.rate.channelId,
+        site: binding.site,
+        bindingId: input.exposureBinding.bindingId,
+        stationarityProfileId: stationarity.profileId,
+        stationarityStatus: stationarity.status,
+        timeReference: input.exposureBinding
+            .timeReference,
+        startOffsetSecondsFromOpeningReference: input.exposureBinding
+            .localExposureWindow
+            .startOffsetSecondsFromOpeningReference,
+        endOffsetSecondsFromOpeningReference: input.exposureBinding
+            .localExposureWindow
+            .endOffsetSecondsFromOpeningReference,
+        localExposureDurationSeconds: binding.duration,
+        integrationMethod: "constant-rate-times-local-exposure-duration",
+        timeStationarityEstablished: true,
+        temporalIntegrationApplied: true,
+        exposureDurationApplied: true,
+        timeVaryingSignalIntegrated: false,
+        multiFrameSequenceIntegrated: false,
+        darkChargeIncluded: false,
+        otherChargeIncluded: false,
+        accumulatedSignalCompleteness: "photo-signal-only",
+        physicalFullWellAssessmentAuthorized: false,
+        cameraSaturationAssessmentAuthorized: false,
+        saturationAssessed: false,
+        shotNoiseApplied: false,
+        readNoiseApplied: false,
+        adcQuantizationApplied: false,
+        rawCodeValueProduced: false,
+        componentEvidence: {
+            stationarity: stationarity.evidence,
+            exposureBinding: input.exposureBinding
+                .componentEvidence
+        }
+    };
+    const assumptions = [
+        "The reported instantaneous rate is explicitly declared constant through this exact bound local exposure window.",
+        "The integration is therefore rate × local duration; no temporal quadrature or time-varying signal samples are generated.",
+        "Motion, flicker, flash, time-varying illumination/vignetting, shutter modulation and other temporal scene/optical effects are excluded unless already proven irrelevant by the stationarity evidence.",
+        "A/W stationarity additionally treats the quasi-static detector-terminal photocurrent result as valid throughout the window; detector bandwidth/transient response remains unmodeled.",
+        "This result contains photo-signal accumulation only. Dark current, defects, leakage, charge injection and other charge contributors are not included.",
+        "Physical full-well and camera/digital saturation must not be assessed from this incomplete photo-signal accumulation alone.",
+        "Shot/read noise, conversion gain, ADC/RAW conversion and reconstruction remain downstream."
+    ];
+    if (binding.rateDomain ===
+        "eqe-electron-rate") {
+        const rate = input.rate;
+        const photonRate = requireNonNegativeFiniteRate(rate.incidentPhotonRatePerSecond, "rate.incidentPhotonRatePerSecond");
+        const electronRate = requireNonNegativeFiniteRate(rate
+            .expectedGeneratedElectronRatePerSecond, "rate.expectedGeneratedElectronRatePerSecond");
+        const photonCount = photonRate *
+            binding.duration;
+        const electronCount = electronRate *
+            binding.duration;
+        if (!Number.isFinite(photonCount) ||
+            !Number.isFinite(electronCount)) {
+            throw new InvalidScientificInputError("EQE constant-rate temporal integration must remain finite.");
+        }
+        const result = {
+            ...common,
+            kind: "eqe-expected-counts",
+            incidentPhotonRatePerSecond: photonRate,
+            expectedGeneratedElectronRatePerSecond: electronRate,
+            expectedIncidentPhotonCount: photonCount,
+            expectedGeneratedElectronCount: electronCount,
+            countsAreExpectationValues: true,
+            integerPhotonCountSampled: false,
+            integerElectronCountSampled: false,
+            chargeCalculated: false,
+            currentCalculated: false
+        };
+        return stationarity.status ===
+            "established"
+            ? calculatedResult(result, "sensor-stationary-eqe-exposure-integration", "1.0.0", assumptions)
+            : approximationResult(result, "sensor-stationary-eqe-exposure-integration", "1.0.0", [
+                ...assumptions,
+                stationarity.limitation
+            ]);
+    }
+    const rate = input.rate;
+    const current = requireNonNegativeFiniteRate(rate.photocurrentMagnitudeAmperes, "rate.photocurrentMagnitudeAmperes");
+    if (rate.temporalResponseModel !==
+        "quasi-static-steady-state-only" ||
+        rate.detectorBandwidthModeled !==
+            false ||
+        rate.chargeCalculated !== false) {
+        throw new InvalidScientificInputError("A/W input must remain a quasi-static current result with no prior charge integration.");
+    }
+    const charge = current * binding.duration;
+    if (!Number.isFinite(charge)) {
+        throw new InvalidScientificInputError("A/W constant-current temporal integration must remain finite.");
+    }
+    const result = {
+        ...common,
+        kind: "responsivity-photocurrent-charge",
+        photocurrentMagnitudeAmperes: current,
+        photochargeMagnitudeCoulombs: charge,
+        currentSignConvention: rate.currentSignConvention,
+        chargeSignConvention: "magnitude-only-no-carrier-or-circuit-polarity",
+        carrierCountInferred: false,
+        electronCountCalculated: false,
+        photonCountCalculated: false,
+        detectorBandwidthModeled: false
+    };
+    return stationarity.status ===
+        "established"
+        ? calculatedResult(result, "sensor-stationary-responsivity-exposure-integration", "1.0.0", assumptions)
+        : approximationResult(result, "sensor-stationary-responsivity-exposure-integration", "1.0.0", [
+            ...assumptions,
+            stationarity.limitation
+        ]);
+}
+//# sourceMappingURL=constant-rate-temporal-integration.js.map

package/dist/sensor/constant-rate-temporal-integration.js.map

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

package/dist/sensor/dark-current.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Module boundary and integration notes.
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary. Dark current is an
+ * independently declared pre-compensation thermal electron rate. Exact-temperature or sampled linear
+ * interpolation is supported only within declared applicability; no universal doubling-temperature law
+ * is inferred. Population means remain approximations and do not model hot-pixel/DCNU structure.
+ * Evaluate the declared temperature-dependent dark electron rate and integrate over the exact
+ * photo-signal local exposure event. Dark current is an independently declared pre-compensation
+ * thermal electron rate. Exact-temperature or sampled linear interpolation is supported only within
+ * declared applicability; no universal doubling-temperature law is inferred. Population means remain
+ * approximations and do not model hot-pixel/DCNU structure.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { SensorEqeExposureIntegration } from "./constant-rate-temporal-integration.js";
+import type { SensorEqePhotoExposure, SensorEqeTemporalPhotoSignal } from "./temporal-photo-signal.js";
+import type { SensorSpectralResponseScientificStatus, SensorSpectralResponseUncertainty } from "./spectral-response.js";
+export type SensorDarkCurrentSiteApplicability = {
+    kind: "exact-site";
+    site: {
+        x: number;
+        y: number;
+    };
+} | {
+    kind: "uniform-site-mean-approximation";
+    limitation: string;
+    evidence: readonly EvidenceProvenance[];
+};
+export type SensorDarkCurrentTemperatureModel = {
+    kind: "fixed-reference-temperature";
+    referenceTemperatureC: number;
+    darkCurrentElectronsPerSecond: number;
+} | {
+    kind: "piecewise-linear-temperature-table";
+    interpolation: "piecewise-linear";
+    outsideRangeBehavior: "fail-closed";
+    samples: readonly {
+        temperatureC: number;
+        darkCurrentElectronsPerSecond: number;
+    }[];
+};
+export interface SensorDarkCurrentProfile {
+    schemaVersion: "0.1.0";
+    profileId: string;
+    colorSamplingProfileId: string;
+    channelId: string;
+    scientificStatus: SensorSpectralResponseScientificStatus;
+    uncertainty: SensorSpectralResponseUncertainty;
+    evidence: readonly EvidenceProvenance[];
+    chargeMeaning: "pre-compensation-thermally-generated-electrons";
+    siteApplicability: SensorDarkCurrentSiteApplicability;
+    temperatureModel: SensorDarkCurrentTemperatureModel;
+    darkCurrentCompensationIncluded: false;
+    spatialDarkCurrentNonuniformityModeled: boolean;
+}
+export interface CalculateSensorDarkCurrentChargeInput<Exposure extends SensorEqePhotoExposure = SensorEqeExposureIntegration> {
+    exposure: Exposure;
+    darkCurrentProfile: SensorDarkCurrentProfile;
+    operatingTemperatureC: number;
+}
+export interface SensorDarkCurrentCharge {
+    darkCurrentProfileId: string;
+    colorSamplingProfileId: string;
+    channelId: string;
+    site: {
+        x: number;
+        y: number;
+    };
+    bindingId: string;
+    stationarityProfileId: string;
+    temporalIntegrationId?: never;
+    timeReference: "first-opening-boundary-phase";
+    startOffsetSecondsFromOpeningReference: number;
+    endOffsetSecondsFromOpeningReference: number;
+    operatingTemperatureC: number;
+    temperatureModel: SensorDarkCurrentTemperatureModel["kind"];
+    temperatureInterpolationUsed: boolean;
+    darkCurrentElectronsPerSecond: number;
+    localExposureDurationSeconds: number;
+    expectedDarkElectronCount: number;
+    countMeaning: "expected-thermally-generated-electrons";
+    expectationValueOnly: true;
+    integerDarkElectronCountSampled: false;
+    darkShotNoiseApplied: false;
+    darkCurrentCompensationApplied: false;
+    spatialDarkCurrentNonuniformityModeled: boolean;
+    photoSignalIncluded: false;
+    otherChargeIncluded: false;
+    physicalFullWellAssessmentAuthorized: false;
+    saturationAssessed: false;
+    componentEvidence: {
+        darkCurrent: readonly EvidenceProvenance[];
+        siteApproximation: readonly EvidenceProvenance[];
+        exposure: SensorEqeExposureIntegration["componentEvidence"];
+    };
+}
+/** Dark charge shares the exact temporal photo event, without a stationarity ID. */
+export type SensorTemporalDarkCurrentCharge = Omit<SensorDarkCurrentCharge, "stationarityProfileId" | "temporalIntegrationId" | "componentEvidence"> & {
+    stationarityProfileId?: never;
+    temporalIntegrationId: string;
+    componentEvidence: Omit<SensorDarkCurrentCharge["componentEvidence"], "exposure"> & {
+        exposure: SensorEqeTemporalPhotoSignal["componentEvidence"];
+    };
+};
+export type SensorPhotoDarkCurrentCharge = SensorDarkCurrentCharge | SensorTemporalDarkCurrentCharge;
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Dark current is an independently declared pre-compensation thermal electron rate. Exact-temperature
+ * or sampled linear interpolation is supported only within declared applicability; no universal
+ * doubling-temperature law is inferred. Population means remain approximations and do not model
+ * hot-pixel/DCNU structure.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SensorDarkCurrentProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function parseSensorDarkCurrentProfile(value: unknown): SensorDarkCurrentProfile;
+/**
+ * Evaluate the declared temperature-dependent dark electron rate and integrate over the exact
+ * photo-signal local exposure event.
+ *
+ * Dark current is an independently declared pre-compensation thermal electron rate. Exact-temperature
+ * or sampled linear interpolation is supported only within declared applicability; no universal
+ * doubling-temperature law is inferred. Population means remain approximations and do not model
+ * hot-pixel/DCNU structure.
+ * @param input - Omit<CalculateSensorDarkCurrentChargeInput, "exposure"> & { exposure: SensorEqeExposureIntegration }. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<SensorDarkCurrentCharge>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function calculateSensorDarkCurrentCharge(input: Omit<CalculateSensorDarkCurrentChargeInput, "exposure"> & {
+    exposure: SensorEqeExposureIntegration;
+}): CalculationResult<SensorDarkCurrentCharge>;
+/**
+ * Evaluate the declared temperature-dependent dark electron rate and integrate over the exact
+ * photo-signal local exposure event.
+ *
+ * Dark current is an independently declared pre-compensation thermal electron rate. Exact-temperature
+ * or sampled linear interpolation is supported only within declared applicability; no universal
+ * doubling-temperature law is inferred. Population means remain approximations and do not model
+ * hot-pixel/DCNU structure.
+ * @param input - Omit<CalculateSensorDarkCurrentChargeInput, "exposure"> & { exposure: SensorEqeTemporalPhotoSignal }. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<SensorTemporalDarkCurrentCharge>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function calculateSensorDarkCurrentCharge(input: Omit<CalculateSensorDarkCurrentChargeInput, "exposure"> & {
+    exposure: SensorEqeTemporalPhotoSignal;
+}): CalculationResult<SensorTemporalDarkCurrentCharge>;
+/**
+ * Evaluate the declared temperature-dependent dark electron rate and integrate over the exact
+ * photo-signal local exposure event.
+ *
+ * Dark current is an independently declared pre-compensation thermal electron rate. Exact-temperature
+ * or sampled linear interpolation is supported only within declared applicability; no universal
+ * doubling-temperature law is inferred. Population means remain approximations and do not model
+ * hot-pixel/DCNU structure.
+ * @param input - CalculateSensorDarkCurrentChargeInput<SensorEqePhotoExposure>. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<SensorPhotoDarkCurrentCharge>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function calculateSensorDarkCurrentCharge(input: CalculateSensorDarkCurrentChargeInput<SensorEqePhotoExposure>): CalculationResult<SensorPhotoDarkCurrentCharge>;
+//# sourceMappingURL=dark-current.d.ts.map

package/dist/sensor/dark-current.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark-current.d.ts","sourceRoot":"","sources":["../../src/sensor/dark-current.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAG5F,OAAO,KAAK,EACV,sBAAsB,EAAE,4BAA4B,EACrD,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,sCAAsC,EACtC,iCAAiC,EAClC,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,kCAAkC,GAC1C;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE;QACJ,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;CACH,GACD;IACE,IAAI,EACF,iCAAiC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EACN,SAAS,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAEN,MAAM,MAAM,iCAAiC,GACzC;IACE,IAAI,EACF,6BAA6B,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6BAA6B,EAC3B,MAAM,CAAC;CACV,GACD;IACE,IAAI,EACF,oCAAoC,CAAC;IACvC,aAAa,EAAE,kBAAkB,CAAC;IAClC,oBAAoB,EAClB,aAAa,CAAC;IAChB,OAAO,EAAE,SAAS;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,6BAA6B,EAC3B,MAAM,CAAC;KACV,EAAE,CAAC;CACL,CAAC;AAEN,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EACd,sCAAsC,CAAC;IACzC,WAAW,EACT,iCAAiC,CAAC;IACpC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,aAAa,EACX,gDAAgD,CAAC;IACnD,iBAAiB,EACf,kCAAkC,CAAC;IACrC,gBAAgB,EACd,iCAAiC,CAAC;IACpC,+BAA+B,EAAE,KAAK,CAAC;IACvC,sCAAsC,EACpC,OAAO,CAAC;CACX;AAED,MAAM,WAAW,qCAAqC,CAAC,QAAQ,SAAS,sBAAsB,GAAG,4BAA4B;IAC3H,QAAQ,EACN,QAAQ,CAAC;IACX,kBAAkB,EAChB,wBAAwB,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,KAAK,CAAC;IAC9B,aAAa,EACX,8BAA8B,CAAC;IACjC,sCAAsC,EACpC,MAAM,CAAC;IACT,oCAAoC,EAClC,MAAM,CAAC;IACT,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EACd,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC5C,4BAA4B,EAC1B,OAAO,CAAC;IACV,6BAA6B,EAC3B,MAAM,CAAC;IACT,4BAA4B,EAC1B,MAAM,CAAC;IACT,yBAAyB,EACvB,MAAM,CAAC;IACT,YAAY,EACV,wCAAwC,CAAC;IAC3C,oBAAoB,EAAE,IAAI,CAAC;IAC3B,+BAA+B,EAC7B,KAAK,CAAC;IACR,oBAAoB,EAAE,KAAK,CAAC;IAC5B,8BAA8B,EAC5B,KAAK,CAAC;IACR,sCAAsC,EACpC,OAAO,CAAC;IACV,mBAAmB,EAAE,KAAK,CAAC;IAC3B,mBAAmB,EAAE,KAAK,CAAC;IAC3B,oCAAoC,EAClC,KAAK,CAAC;IACR,kBAAkB,EAAE,KAAK,CAAC;IAC1B,iBAAiB,EAAE;QACjB,WAAW,EACT,SAAS,kBAAkB,EAAE,CAAC;QAChC,iBAAiB,EACf,SAAS,kBAAkB,EAAE,CAAC;QAChC,QAAQ,EACN,4BAA4B,CAAC,mBAAmB,CAAC,CAAC;KACrD,CAAC;CACH;AAED,oFAAoF;AACpF,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAAC,uBAAuB,EAAE,uBAAuB,GAAG,uBAAuB,GAAG,mBAAmB,CAAC,GAAG;IACrJ,qBAAqB,CAAC,EAAE,KAAK,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,IAAI,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,GAAG;QAAE,QAAQ,EAAE,4BAA4B,CAAC,mBAAmB,CAAC,CAAA;KAAE,CAAC;CACrJ,CAAC;AACF,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,GAAG,+BAA+B,CAAC;AAmSrG;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,wBAAwB,CAgI1B;AAyJD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,IAAI,CAAC,qCAAqC,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,EAAE,4BAA4B,CAAA;CAAE,GAC1G,iBAAiB,CAAC,uBAAuB,CAAC,CAAC;AAC9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,IAAI,CAAC,qCAAqC,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,EAAE,4BAA4B,CAAA;CAAE,GAC1G,iBAAiB,CAAC,+BAA+B,CAAC,CAAC;AACtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,CAAC,sBAAsB,CAAC,GACnE,iBAAiB,CAAC,4BAA4B,CAAC,CAAC"}