@photivra/engine 0.6.0 → 1.0.0

package/dist/sensor/local-exposure-binding.js

@@ -0,0 +1,214 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Binds one engine-produced sensor response-rate result to the local exposure window at the same
+ * color-sampling site. This first temporal binding supports only the explicit one-to-one
+ * native-effective-sample ↔ color-site relationship. A multi-site block binding proves contributor
+ * membership but does not prove each color site's sub-sample timing coordinate, so spatially varying
+ * shutter timing fails closed rather than inventing fractional positions. The result establishes
+ * timing only. It deliberately does not establish that the optical/electrical rate is stationary
+ * through the local exposure window, so rate×duration integration remains unauthorized.
+ * @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 { resolveNativeEffectiveRasterColorSamplingBinding } from "./capture-color-sampling-binding.js";
+import { resolveColorSamplingSite } from "./color-sampling.js";
+import { calculateCaptureExposureWindows } from "./exposure-window.js";
+function requireSite(rate) {
+    if (rate.site === undefined ||
+        typeof rate.site !== "object" ||
+        rate.site === null ||
+        !Number.isSafeInteger(rate.site.x) ||
+        rate.site.x < 0 ||
+        !Number.isSafeInteger(rate.site.y) ||
+        rate.site.y < 0) {
+        throw new InvalidScientificInputError("rate.site must be present as a non-negative safe-integer color-sampling-site index.");
+    }
+    return {
+        x: rate.site.x,
+        y: rate.site.y
+    };
+}
+function validateRateBoundary(rate) {
+    if (rate.sourceResponseKind ===
+        "effective-spectral-responsivity") {
+        const current = rate;
+        if (current.currentCalculated !==
+            true ||
+            current.chargeCalculated !==
+                false ||
+            current.temporalIntegrationApplied !==
+                false ||
+            current.exposureDurationApplied !==
+                false ||
+            current.detectorBandwidthModeled !==
+                false ||
+            current.temporalResponseModel !==
+                "quasi-static-steady-state-only") {
+            throw new InvalidScientificInputError("A/W rate must remain a quasi-static pre-temporal photocurrent result.");
+        }
+        return "responsivity-photocurrent";
+    }
+    const eqe = rate;
+    if (eqe.electronRateCalculated !== true ||
+        eqe.photonRateCalculated !== true ||
+        eqe.electronCountCalculated !==
+            false ||
+        eqe.photonCountCalculated !==
+            false ||
+        eqe.temporalIntegrationApplied !==
+            false ||
+        eqe.exposureDurationApplied !==
+            false) {
+        throw new InvalidScientificInputError("EQE rate must remain a pre-temporal photon/electron-rate result.");
+    }
+    return "eqe-electron-rate";
+}
+function boundaryEvidence(boundary) {
+    if (boundary.schedule.kind ===
+        "simultaneous") {
+        return [];
+    }
+    return [
+        ...boundary.schedule.directionNative
+            .evidence,
+        ...boundary.schedule
+            .traversalDurationSeconds.evidence
+    ];
+}
+/**
+ * Binds one engine-produced sensor response-rate result to the local exposure
+ * window at the same color-sampling site.
+ *
+ * This first temporal binding supports only the explicit one-to-one
+ * native-effective-sample ↔ color-site relationship. A multi-site block
+ * binding proves contributor membership but does not prove each color site's
+ * sub-sample timing coordinate, so spatially varying shutter timing fails
+ * closed rather than inventing fractional positions.
+ *
+ * The result establishes timing only. It deliberately does not establish that
+ * the optical/electrical rate is stationary through the local exposure window,
+ * so rate×duration integration remains unauthorized.
+ */
+export function bindSensorRateToLocalExposure(input) {
+    const rateDomain = validateRateBoundary(input.rate);
+    const site = requireSite(input.rate);
+    const binding = resolveNativeEffectiveRasterColorSamplingBinding({
+        nativeRaster: input.exposureWindowInput
+            .nativeRaster,
+        colorSamplingProfile: input.colorSamplingProfile,
+        bindingProfile: input.bindingProfile
+    });
+    if (binding.colorSamplingProfileId !==
+        input.rate
+            .colorSamplingProfileId) {
+        throw new InvalidScientificInputError("Color-sampling binding must reference the same colorSamplingProfileId as the rate result.");
+    }
+    if (binding.relationship
+        .sitesPerNativeSampleX !== 1 ||
+        binding.relationship
+            .sitesPerNativeSampleY !== 1) {
+        throw new InvalidScientificInputError("Local exposure timing currently requires a one-to-one color-site/native-effective-sample binding; multi-site blocks lack explicit sub-sample timing registration.");
+    }
+    if (site.x >=
+        binding.colorSamplingSiteGrid
+            .widthSites ||
+        site.y >=
+            binding.colorSamplingSiteGrid
+                .heightSites) {
+        throw new InvalidScientificInputError("rate.site is outside the color-sampling site grid established by the binding.");
+    }
+    const resolvedSite = resolveColorSamplingSite({
+        profile: input.colorSamplingProfile,
+        site
+    });
+    if (resolvedSite.mapping.channelId !==
+        input.rate.channelId) {
+        throw new InvalidScientificInputError("The rate channelId does not match the color-sampling channel assigned to rate.site.");
+    }
+    const nativeRasterPoint = {
+        x: site.x + 0.5,
+        y: site.y + 0.5
+    };
+    const windows = calculateCaptureExposureWindows({
+        ...input.exposureWindowInput,
+        samplePointsNative: [
+            nativeRasterPoint
+        ]
+    }).value;
+    const localExposureWindow = windows.samples[0];
+    if (localExposureWindow === undefined ||
+        localExposureWindow
+            .pointNative.x !==
+            nativeRasterPoint.x ||
+        localExposureWindow
+            .pointNative.y !==
+            nativeRasterPoint.y ||
+        !Number.isFinite(localExposureWindow
+            .localExposureDurationSeconds) ||
+        localExposureWindow
+            .localExposureDurationSeconds <= 0) {
+        throw new InvalidScientificInputError("Exposure-window resolution did not return a valid local sample for the bound sensor site.");
+    }
+    return approximationResult({
+        rateDomain,
+        rateIdentity: {
+            responseProfileId: input.rate.responseProfileId,
+            responseApplicationProfileId: input.rate
+                .responseApplicationProfileId,
+            operatingRangeProfileId: input.rate
+                .operatingRangeProfileId,
+            ...(rateDomain ===
+                "responsivity-photocurrent"
+                ? {
+                    electricalApplicabilityProfileId: input.rate
+                        .electricalApplicabilityProfileId
+                }
+                : {})
+        },
+        colorSamplingProfileId: input.rate
+            .colorSamplingProfileId,
+        channelId: input.rate.channelId,
+        site,
+        bindingId: binding.bindingId,
+        bindingRelationship: "one-native-effective-sample-to-one-color-site",
+        timingCoordinateRule: "one-to-one-color-site-center-equals-native-effective-sample-center",
+        nativeRasterPoint,
+        shutterMechanism: windows.shutterMechanism,
+        timeReference: windows.timeReference,
+        localExposureWindow,
+        localExposureDurationSeconds: localExposureWindow
+            .localExposureDurationSeconds,
+        exposureEventMeaning: "single-capture-local-exposure-window",
+        nativeImageRasterBindingEstablished: true,
+        channelAtSiteValidated: true,
+        physicalPhotodiodeTimingRegistrationEstablished: false,
+        multiFrameSequenceBindingEstablished: false,
+        timeStationarityEstablished: false,
+        constantRateTemporalIntegrationAuthorized: false,
+        temporalIntegrationApplied: false,
+        componentEvidence: {
+            binding: binding.componentEvidence
+                .binding,
+            colorSamplingProfile: binding.componentEvidence
+                .colorSamplingProfile,
+            nominalExposureDuration: windows
+                .nominalExposureDurationSeconds
+                .evidence,
+            openingBoundary: boundaryEvidence(windows.opening),
+            closingBoundary: boundaryEvidence(windows.closing)
+        }
+    }, "sensor-rate-local-exposure-binding", "1.0.0", [
+        "The rate's abstract color-sampling site is mapped to the center of the same-index native effective sample only because an explicit one-to-one shared-top-left binding is present.",
+        "Multi-site-per-native-sample relationships are blocked because contributor membership does not establish individual color-site timing coordinates.",
+        "The mapped timing coordinate is a native-effective-raster timing coordinate; it does not establish a physical photodiode timing registration.",
+        "The exposure schedule is recomputed from the evidence-backed opening/closing timing declarations at the bound point rather than accepting an arbitrary precomputed local duration.",
+        "The color-sampling channel at the exact site must match the response-rate channel.",
+        "The result represents one local exposure event only; multi-frame/pixel-shift sequence timing and combination remain outside this contract.",
+        "This binding does not establish that the optical/electron/current rate is constant through the exposure. Motion, flicker, flash, time-varying illumination/vignetting and detector transients require a time-dependent integrand.",
+        "Temporal integration, accumulated charge, saturation, noise, ADC/RAW conversion and reconstruction are not performed."
+    ]);
+}
+//# sourceMappingURL=local-exposure-binding.js.map

package/dist/sensor/local-exposure-binding.js.map

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

package/dist/sensor/optical-stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optical-stack.d.ts","sourceRoot":"","sources":["../../src/sensor/optical-stack.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAKxC,MAAM,MAAM,+BAA+B,GACvC,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,GACvB,YAAY,GACZ,sBAAsB,CAAC;AAE3B,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAClD,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC;;;OAGG;IACH,kBAAkB,EAAE,YAAY,CAAC;CAClC;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,iBAAiB,EAAE;QACjB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,0CAA0C,GAClD;IACE;;;;OAIG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,mCAAmC,CAAC;IAC1C,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,KAAK,EACH,uDAAuD,CAAC;IAC1D,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;CACxD,CAAC;AAEN,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC3D;;;;;;OAMG;IACH,oCAAoC,CAAC,EAAE,0CAA0C,CAAC;IAClF;;OAEG;IACH,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EACb,QAAQ,GACR,mCAAmC,CAAC;IACxC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,KAAK,CAAC;IAC1B,4BAA4B,EAAE,KAAK,CAAC;IACpC,uBAAuB,EAAE,KAAK,CAAC;IAC/B,4BAA4B,EAAE,KAAK,CAAC;IACpC,8BAA8B,EAAE,KAAK,CAAC;IACtC,yBAAyB,EAAE,KAAK,CAAC;IACjC,+BAA+B,EAAE,KAAK,CAAC;IACvC,+BAA+B,EAAE,KAAK,CAAC;IACvC,UAAU,EAAE;QACV,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACvC,oBAAoB,EAAE,SAAS,kBAAkB,EAAE,CAAC;KACrD,CAAC;CACH;AA0TD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,yBAAyB,CAuE3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,yBAAyB,GACtC,iCAAiC,CAyFnC"}
+{"version":3,"file":"optical-stack.d.ts","sourceRoot":"","sources":["../../src/sensor/optical-stack.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAKxC,MAAM,MAAM,+BAA+B,GACvC,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,GACvB,YAAY,GACZ,sBAAsB,CAAC;AAE3B,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAClD,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC;;;OAGG;IACH,kBAAkB,EAAE,YAAY,CAAC;CAClC;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,iBAAiB,EAAE;QACjB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,0CAA0C,GAClD;IACE;;;;OAIG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,mCAAmC,CAAC;IAC1C,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,KAAK,EACH,uDAAuD,CAAC;IAC1D,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;CACxD,CAAC;AAEN,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC3D;;;;;;OAMG;IACH,oCAAoC,CAAC,EAAE,0CAA0C,CAAC;IAClF;;OAEG;IACH,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EACb,QAAQ,GACR,mCAAmC,CAAC;IACxC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,KAAK,CAAC;IAC1B,4BAA4B,EAAE,KAAK,CAAC;IACpC,uBAAuB,EAAE,KAAK,CAAC;IAC/B,4BAA4B,EAAE,KAAK,CAAC;IACpC,8BAA8B,EAAE,KAAK,CAAC;IACtC,yBAAyB,EAAE,KAAK,CAAC;IACjC,+BAA+B,EAAE,KAAK,CAAC;IACvC,+BAA+B,EAAE,KAAK,CAAC;IACvC,UAAU,EAAE;QACV,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACvC,oBAAoB,EAAE,SAAS,kBAAkB,EAAE,CAAC;KACrD,CAAC;CACH;AA0TD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,yBAAyB,CAuE3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,yBAAyB,GACtC,iCAAiC,CAyFnC"}

package/dist/sensor/optical-stack.js

@@ -1,4 +1,21 @@
 // SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses descriptive sensor optical-stack metadata plus an optional explicitly declared effective
+ * anti-aliasing spatial response. Unknown facts are omitted instead of inferred. Physical component
+ * presence is intentionally separate from effective anti-aliasing response so the schema can represent
+ * cancellation/neutralization designs without claiming the physical assembly is absent.
+ * Cover/filter-stack and microlens presence do not create optical effects in schema 0.1.0. Thickness,
+ * refractive index, spectral transmission, angular acceptance, focus shift and microlens collection
+ * behavior require later explicit models/calibration.
+ * Resolves only the effective anti-aliasing spatial kernel. This is not a whole optical-stack PSF.
+ * Cover/filter transmission, refraction, microlens behavior, field/wavelength/polarization dependence,
+ * and total throughput remain excluded. A documented absent effective anti-aliasing response resolves
+ * to an identity component at zero offset. An unknown response (field omitted) or a
+ * present-but-unresolved response fails closed.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";

package/dist/sensor/optical-stack.js.map

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

package/dist/sensor/photon-energy.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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. Photon energy uses
+ * exact SI h and c with vacuum wavelength. Air wavelength requires an exact-wavelength sourced phase
+ * index and atmosphere compatibility; lambdaVacuum = n*lambdaAir. Retained refractive-index
+ * uncertainty is not an automatically propagated photon-energy uncertainty.
+ * Convert a valid vacuum wavelength, or explicitly atmosphere-bound air wavelength, into optical
+ * frequency and photon energy using exact SI constants. Photon energy uses exact SI h and c with
+ * vacuum wavelength. Air wavelength requires an exact-wavelength sourced phase index and atmosphere
+ * compatibility; lambdaVacuum = n*lambdaAir. Retained refractive-index uncertainty is not an
+ * automatically propagated photon-energy uncertainty.
+ * @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 { SensorSpectralResponseScientificStatus, SensorSpectralResponseUncertainty, SpectralWavelengthBasis } from "./spectral-response.js";
+export interface AirRefractiveIndexReferenceConditions {
+    temperatureC: number;
+    pressurePascal: number;
+    relativeHumidityFraction?: number;
+    carbonDioxideMoleFraction?: number;
+}
+export interface SourcedAirPhaseRefractiveIndex {
+    wavelengthNanometers: number;
+    wavelengthBasis: "air";
+    definition: "vacuum-wavelength-divided-by-air-wavelength";
+    phaseRefractiveIndex: number;
+    scientificStatus: SensorSpectralResponseScientificStatus;
+    uncertainty: SensorSpectralResponseUncertainty;
+    evidence: readonly EvidenceProvenance[];
+    referenceConditions?: AirRefractiveIndexReferenceConditions;
+}
+export type AirRefractiveIndexConditionPolicy = {
+    kind: "exact-match-required";
+} | {
+    kind: "assume-compatible";
+    limitation: string;
+    evidence: readonly EvidenceProvenance[];
+};
+export interface CalculatePhotonEnergyFromWavelengthInput {
+    wavelengthNanometers: number;
+    wavelengthBasis: SpectralWavelengthBasis;
+    airPhaseRefractiveIndex?: SourcedAirPhaseRefractiveIndex;
+    airOperatingConditions?: AirRefractiveIndexReferenceConditions;
+    airConditionPolicy?: AirRefractiveIndexConditionPolicy;
+}
+export interface PhotonEnergyFromWavelength {
+    inputWavelengthNanometers: number;
+    inputWavelengthBasis: Exclude<SpectralWavelengthBasis, "unspecified">;
+    vacuumWavelengthNanometers: number;
+    frequencyHertz: number;
+    photonEnergyJoules: number;
+    wavelengthConversion: "vacuum-identity" | "air-to-vacuum-via-phase-refractive-index";
+    exactSiConstants: {
+        planckConstantJouleSeconds: 6.62607015e-34;
+        speedOfLightMetersPerSecond: 299792458;
+    };
+    phaseRefractiveIndexUsed?: number;
+    airRefractiveIndexScientificStatus?: SensorSpectralResponseScientificStatus;
+    airRefractiveIndexUncertainty?: SensorSpectralResponseUncertainty;
+    airRefractiveIndexReferenceConditions?: AirRefractiveIndexReferenceConditions;
+    airRefractiveIndexEvidence?: readonly EvidenceProvenance[];
+    airOperatingConditions?: AirRefractiveIndexReferenceConditions;
+    airConditionPolicy?: AirRefractiveIndexConditionPolicy;
+    airConditionCompatibility?: "exact-match" | "assumed-compatible";
+    airConditionAssumptionEvidence?: readonly EvidenceProvenance[];
+    inputUncertaintyPropagated: false;
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Photon energy uses exact SI h and c with vacuum wavelength. Air wavelength requires an
+ * exact-wavelength sourced phase index and atmosphere compatibility; lambdaVacuum = n*lambdaAir.
+ * Retained refractive-index uncertainty is not an automatically propagated photon-energy uncertainty.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SourcedAirPhaseRefractiveIndex. 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 parseSourcedAirPhaseRefractiveIndex(value: unknown): SourcedAirPhaseRefractiveIndex;
+/**
+ * Convert a valid vacuum wavelength, or explicitly atmosphere-bound air wavelength, into optical
+ * frequency and photon energy using exact SI constants.
+ *
+ * Photon energy uses exact SI h and c with vacuum wavelength. Air wavelength requires an
+ * exact-wavelength sourced phase index and atmosphere compatibility; lambdaVacuum = n*lambdaAir.
+ * Retained refractive-index uncertainty is not an automatically propagated photon-energy uncertainty.
+ * @param input - CalculatePhotonEnergyFromWavelengthInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<PhotonEnergyFromWavelength>. 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 calculatePhotonEnergyFromWavelength(input: CalculatePhotonEnergyFromWavelengthInput): CalculationResult<PhotonEnergyFromWavelength>;
+//# sourceMappingURL=photon-energy.d.ts.map

package/dist/sensor/photon-energy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-energy.d.ts","sourceRoot":"","sources":["../../src/sensor/photon-energy.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,sCAAsC,EACtC,iCAAiC,EACjC,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAUhC,MAAM,WAAW,qCAAqC;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,KAAK,CAAC;IACvB,UAAU,EACR,6CAA6C,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EACd,sCAAsC,CAAC;IACzC,WAAW,EACT,iCAAiC,CAAC;IACpC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,mBAAmB,CAAC,EAClB,qCAAqC,CAAC;CACzC;AAED,MAAM,MAAM,iCAAiC,GACzC;IACE,IAAI,EAAE,sBAAsB,CAAC;CAC9B,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC,CAAC;AAEN,MAAM,WAAW,wCAAwC;IACvD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EACb,uBAAuB,CAAC;IAC1B,uBAAuB,CAAC,EACtB,8BAA8B,CAAC;IACjC,sBAAsB,CAAC,EACrB,qCAAqC,CAAC;IACxC,kBAAkB,CAAC,EACjB,iCAAiC,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IACzC,yBAAyB,EAAE,MAAM,CAAC;IAClC,oBAAoB,EAClB,OAAO,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;IAClD,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAChB,iBAAiB,GACjB,0CAA0C,CAAC;IAC/C,gBAAgB,EAAE;QAChB,0BAA0B,EACxB,cAAc,CAAC;QACjB,2BAA2B,EACzB,SAAS,CAAC;KACb,CAAC;IACF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kCAAkC,CAAC,EACjC,sCAAsC,CAAC;IACzC,6BAA6B,CAAC,EAC5B,iCAAiC,CAAC;IACpC,qCAAqC,CAAC,EACpC,qCAAqC,CAAC;IACxC,0BAA0B,CAAC,EACzB,SAAS,kBAAkB,EAAE,CAAC;IAChC,sBAAsB,CAAC,EACrB,qCAAqC,CAAC;IACxC,kBAAkB,CAAC,EACjB,iCAAiC,CAAC;IACpC,yBAAyB,CAAC,EACtB,aAAa,GACb,oBAAoB,CAAC;IACzB,8BAA8B,CAAC,EAC7B,SAAS,kBAAkB,EAAE,CAAC;IAChC,0BAA0B,EAAE,KAAK,CAAC;CACnC;AAkQD;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,GACb,8BAA8B,CA4FhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EACH,wCAAwC,GACzC,iBAAiB,CAAC,0BAA0B,CAAC,CAuQ/C"}