@photivra/engine 0.5.1 → 1.0.0

package/dist/sensor/photon-energy.js

@@ -0,0 +1,390 @@
+// 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. 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 { 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";
+const PLANCK_CONSTANT_JOULE_SECONDS = 6.62607015e-34;
+const SPEED_OF_LIGHT_METERS_PER_SECOND = 299_792_458;
+const NANOMETERS_TO_METERS = 1e-9;
+function requireRecord(value, path) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an object.");
+    }
+    return value;
+}
+function requireFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value)) {
+        throw new InvalidConfigurationError(path + " must be finite.");
+    }
+    return value;
+}
+function requirePositiveFinite(value, path) {
+    const parsed = requireFinite(value, path);
+    if (parsed <= 0) {
+        throw new InvalidConfigurationError(path +
+            " must be greater than zero.");
+    }
+    return parsed;
+}
+function requireFraction(value, path) {
+    const parsed = requireFinite(value, path);
+    if (parsed < 0 || parsed > 1) {
+        throw new InvalidConfigurationError(path +
+            " must be a fraction from 0 through 1.");
+    }
+    return parsed;
+}
+function parseUncertainty(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "relative") {
+        const fraction = requireFinite(record.fraction, path + ".fraction");
+        if (fraction < 0) {
+            throw new InvalidConfigurationError(path +
+                ".fraction must be greater than or equal to zero.");
+        }
+        if (typeof record.basis !== "string" ||
+            record.basis.trim().length === 0) {
+            throw new InvalidConfigurationError(path +
+                ".basis must be a non-empty string.");
+        }
+        return {
+            kind: "relative",
+            fraction,
+            basis: record.basis
+        };
+    }
+    if (record.kind === "not-quantified") {
+        if (typeof record.limitation !==
+            "string" ||
+            record.limitation.trim().length ===
+                0) {
+            throw new InvalidConfigurationError(path +
+                ".limitation must be a non-empty string.");
+        }
+        return {
+            kind: "not-quantified",
+            limitation: record.limitation
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+function parseReferenceConditions(value, path) {
+    const record = requireRecord(value, path);
+    const temperatureC = requireFinite(record.temperatureC, path + ".temperatureC");
+    const pressurePascal = requirePositiveFinite(record.pressurePascal, path + ".pressurePascal");
+    const relativeHumidityFraction = record.relativeHumidityFraction ===
+        undefined
+        ? undefined
+        : requireFraction(record.relativeHumidityFraction, path +
+            ".relativeHumidityFraction");
+    const carbonDioxideMoleFraction = record.carbonDioxideMoleFraction ===
+        undefined
+        ? undefined
+        : requireFraction(record.carbonDioxideMoleFraction, path +
+            ".carbonDioxideMoleFraction");
+    return {
+        temperatureC,
+        pressurePascal,
+        ...(relativeHumidityFraction ===
+            undefined
+            ? {}
+            : {
+                relativeHumidityFraction
+            }),
+        ...(carbonDioxideMoleFraction ===
+            undefined
+            ? {}
+            : {
+                carbonDioxideMoleFraction
+            })
+    };
+}
+function parseConditionPolicy(value) {
+    const record = requireRecord(value, "airConditionPolicy");
+    if (record.kind === "exact-match-required") {
+        return {
+            kind: "exact-match-required"
+        };
+    }
+    if (record.kind === "assume-compatible") {
+        if (typeof record.limitation !==
+            "string" ||
+            record.limitation.trim().length ===
+                0) {
+            throw new InvalidConfigurationError("airConditionPolicy.limitation must be a non-empty string.");
+        }
+        return {
+            kind: "assume-compatible",
+            limitation: record.limitation,
+            evidence: parseEvidenceList(record.evidence, "airConditionPolicy.evidence")
+        };
+    }
+    throw new InvalidConfigurationError("airConditionPolicy.kind is invalid.");
+}
+function conditionsMatch(reference, operating) {
+    if (reference.temperatureC !==
+        operating.temperatureC ||
+        reference.pressurePascal !==
+            operating.pressurePascal) {
+        return false;
+    }
+    if (reference.relativeHumidityFraction !==
+        undefined &&
+        reference.relativeHumidityFraction !==
+            operating.relativeHumidityFraction) {
+        return false;
+    }
+    if (reference.carbonDioxideMoleFraction !==
+        undefined &&
+        reference.carbonDioxideMoleFraction !==
+            operating.carbonDioxideMoleFraction) {
+        return false;
+    }
+    return true;
+}
+/**
+ * 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 function parseSourcedAirPhaseRefractiveIndex(value) {
+    const record = requireRecord(value, "airPhaseRefractiveIndex");
+    if (record.wavelengthBasis !== "air") {
+        throw new InvalidConfigurationError('airPhaseRefractiveIndex.wavelengthBasis must be "air".');
+    }
+    if (record.definition !==
+        "vacuum-wavelength-divided-by-air-wavelength") {
+        throw new InvalidConfigurationError("airPhaseRefractiveIndex.definition is invalid.");
+    }
+    if (record.scientificStatus !==
+        "calibrated" &&
+        record.scientificStatus !==
+            "approximation") {
+        throw new InvalidConfigurationError("airPhaseRefractiveIndex.scientificStatus is invalid.");
+    }
+    const uncertainty = parseUncertainty(record.uncertainty, "airPhaseRefractiveIndex.uncertainty");
+    const referenceConditions = record.referenceConditions ===
+        undefined
+        ? undefined
+        : parseReferenceConditions(record.referenceConditions, "airPhaseRefractiveIndex.referenceConditions");
+    if (record.scientificStatus ===
+        "calibrated" &&
+        uncertainty.kind ===
+            "not-quantified") {
+        throw new InvalidConfigurationError("A calibrated air phase refractive index must declare quantified relative uncertainty.");
+    }
+    if (record.scientificStatus ===
+        "calibrated" &&
+        referenceConditions === undefined) {
+        throw new InvalidConfigurationError("A calibrated air phase refractive index must declare temperature and pressure reference conditions.");
+    }
+    return {
+        wavelengthNanometers: requirePositiveFinite(record.wavelengthNanometers, "airPhaseRefractiveIndex.wavelengthNanometers"),
+        wavelengthBasis: "air",
+        definition: "vacuum-wavelength-divided-by-air-wavelength",
+        phaseRefractiveIndex: requirePositiveFinite(record.phaseRefractiveIndex, "airPhaseRefractiveIndex.phaseRefractiveIndex"),
+        scientificStatus: record.scientificStatus,
+        uncertainty,
+        evidence: parseEvidenceList(record.evidence, "airPhaseRefractiveIndex.evidence"),
+        ...(referenceConditions ===
+            undefined
+            ? {}
+            : { referenceConditions })
+    };
+}
+/**
+ * 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 function calculatePhotonEnergyFromWavelength(input) {
+    const wavelengthNanometers = requirePositiveFinite(input.wavelengthNanometers, "wavelengthNanometers");
+    if (input.wavelengthBasis ===
+        "unspecified") {
+        throw new InvalidScientificInputError("wavelengthBasis must be resolved to air or vacuum before photon-energy calculation.");
+    }
+    if (input.wavelengthBasis !== "air" &&
+        input.wavelengthBasis !== "vacuum") {
+        throw new InvalidScientificInputError("wavelengthBasis is invalid.");
+    }
+    let vacuumWavelengthNanometers;
+    let wavelengthConversion;
+    let parsedAir;
+    let parsedConditionPolicy;
+    let parsedOperatingConditions;
+    let airConditionCompatibility;
+    if (input.wavelengthBasis ===
+        "vacuum") {
+        if (input.airPhaseRefractiveIndex !==
+            undefined ||
+            input.airOperatingConditions !==
+                undefined ||
+            input.airConditionPolicy !==
+                undefined) {
+            throw new InvalidScientificInputError("Air refractive-index inputs must be omitted for vacuum-basis wavelengths.");
+        }
+        vacuumWavelengthNanometers =
+            wavelengthNanometers;
+        wavelengthConversion =
+            "vacuum-identity";
+    }
+    else {
+        if (input.airPhaseRefractiveIndex ===
+            undefined) {
+            throw new InvalidScientificInputError("airPhaseRefractiveIndex is required for air-basis photon-energy calculation.");
+        }
+        parsedAir =
+            parseSourcedAirPhaseRefractiveIndex(input.airPhaseRefractiveIndex);
+        if (parsedAir.wavelengthNanometers !==
+            wavelengthNanometers) {
+            throw new InvalidScientificInputError("airPhaseRefractiveIndex wavelength must exactly match wavelengthNanometers.");
+        }
+        if (input.airConditionPolicy ===
+            undefined) {
+            throw new InvalidScientificInputError("airConditionPolicy is required for air-basis photon-energy calculation.");
+        }
+        parsedConditionPolicy =
+            parseConditionPolicy(input.airConditionPolicy);
+        if (parsedConditionPolicy.kind ===
+            "exact-match-required") {
+            if (parsedAir.referenceConditions ===
+                undefined) {
+                throw new InvalidScientificInputError("Exact air-condition matching requires refractive-index reference conditions.");
+            }
+            if (input.airOperatingConditions ===
+                undefined) {
+                throw new InvalidScientificInputError("airOperatingConditions is required when exact air-condition matching is selected.");
+            }
+            parsedOperatingConditions =
+                parseReferenceConditions(input.airOperatingConditions, "airOperatingConditions");
+            if (!conditionsMatch(parsedAir.referenceConditions, parsedOperatingConditions)) {
+                throw new InvalidScientificInputError("airOperatingConditions must match the refractive-index reference conditions.");
+            }
+            airConditionCompatibility =
+                "exact-match";
+        }
+        else {
+            parsedOperatingConditions =
+                input.airOperatingConditions ===
+                    undefined
+                    ? undefined
+                    : parseReferenceConditions(input.airOperatingConditions, "airOperatingConditions");
+            airConditionCompatibility =
+                "assumed-compatible";
+        }
+        vacuumWavelengthNanometers =
+            wavelengthNanometers *
+                parsedAir.phaseRefractiveIndex;
+        wavelengthConversion =
+            "air-to-vacuum-via-phase-refractive-index";
+    }
+    const vacuumWavelengthMeters = vacuumWavelengthNanometers *
+        NANOMETERS_TO_METERS;
+    const frequencyHertz = SPEED_OF_LIGHT_METERS_PER_SECOND /
+        vacuumWavelengthMeters;
+    const photonEnergyJoules = PLANCK_CONSTANT_JOULE_SECONDS *
+        frequencyHertz;
+    if (!Number.isFinite(vacuumWavelengthNanometers) ||
+        !Number.isFinite(frequencyHertz) ||
+        !Number.isFinite(photonEnergyJoules)) {
+        throw new InvalidScientificInputError("Photon-energy calculation must remain finite.");
+    }
+    return calculatedResult({
+        inputWavelengthNanometers: wavelengthNanometers,
+        inputWavelengthBasis: input.wavelengthBasis,
+        vacuumWavelengthNanometers,
+        frequencyHertz,
+        photonEnergyJoules,
+        wavelengthConversion,
+        exactSiConstants: {
+            planckConstantJouleSeconds: PLANCK_CONSTANT_JOULE_SECONDS,
+            speedOfLightMetersPerSecond: SPEED_OF_LIGHT_METERS_PER_SECOND
+        },
+        ...(parsedAir === undefined
+            ? {}
+            : {
+                phaseRefractiveIndexUsed: parsedAir
+                    .phaseRefractiveIndex,
+                airRefractiveIndexScientificStatus: parsedAir
+                    .scientificStatus,
+                airRefractiveIndexUncertainty: parsedAir.uncertainty,
+                ...(parsedAir
+                    .referenceConditions ===
+                    undefined
+                    ? {}
+                    : {
+                        airRefractiveIndexReferenceConditions: parsedAir
+                            .referenceConditions
+                    }),
+                airRefractiveIndexEvidence: parsedAir.evidence,
+                ...(parsedOperatingConditions ===
+                    undefined
+                    ? {}
+                    : {
+                        airOperatingConditions: parsedOperatingConditions
+                    }),
+                ...(parsedConditionPolicy ===
+                    undefined
+                    ? {}
+                    : {
+                        airConditionPolicy: parsedConditionPolicy
+                    }),
+                ...(airConditionCompatibility ===
+                    undefined
+                    ? {}
+                    : {
+                        airConditionCompatibility
+                    }),
+                ...(parsedConditionPolicy?.kind ===
+                    "assume-compatible"
+                    ? {
+                        airConditionAssumptionEvidence: parsedConditionPolicy
+                            .evidence
+                    }
+                    : {})
+            }),
+        inputUncertaintyPropagated: false
+    }, "photon-energy-from-spectral-wavelength", "1.0.0", [
+        "Planck constant h and vacuum speed of light c use their exact SI defining values.",
+        "Photon energy is h times optical frequency; frequency is derived from vacuum wavelength.",
+        "Vacuum-basis wavelength requires no refractive-index correction.",
+        "Air-basis wavelength is converted with the phase refractive index definition n = lambda_vacuum / lambda_air at the exact requested wavelength.",
+        "Air refractive index varies with wavelength and atmospheric conditions; this function never substitutes n = 1.",
+        "Air-basis conversion requires either exact matching to the refractive-index reference atmosphere or an explicit evidence-backed compatibility assumption.",
+        "Input refractive-index uncertainty is preserved as metadata but is not propagated into photon-energy uncertainty by this foundation.",
+        "This calculation does not apply QE, calculate photon rate, generate electrons, integrate exposure time, or model saturation/noise."
+    ]);
+}
+//# sourceMappingURL=photon-energy.js.map

package/dist/sensor/photon-energy.js.map

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

package/dist/sensor/physical-charge-capacity.d.ts

@@ -0,0 +1,130 @@
+/**
+ * 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. Physical storage
+ * capacity is a source-specific total stored-electron limit tied to site, operating state and
+ * temperature. The assessment compares complete expected charge; it does not clamp realizations or
+ * infer overflow/blooming. Camera saturation and ADC/readout thresholds remain distinct.
+ * Compare complete expected stored electrons to the explicitly applicable physical capacity and report
+ * expectation-domain headroom without nonlinear storage simulation. Physical storage capacity is a
+ * source-specific total stored-electron limit tied to site, operating state and temperature. The
+ * assessment compares complete expected charge; it does not clamp realizations or infer
+ * overflow/blooming. Camera saturation and ADC/readout thresholds remain distinct.
+ * @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 { SensorPhotoAccumulatedChargeComposition as SensorAccumulatedChargeComposition } from "./accumulated-charge.js";
+import type { SensorSpectralResponseScientificStatus, SensorSpectralResponseUncertainty } from "./spectral-response.js";
+export type SensorPhysicalChargeCapacitySiteApplicability = {
+    kind: "exact-site";
+    site: {
+        x: number;
+        y: number;
+    };
+} | {
+    kind: "uniform-site-capacity-approximation";
+    limitation: string;
+    evidence: readonly EvidenceProvenance[];
+};
+export type SensorPhysicalChargeCapacityTemperatureApplicability = {
+    kind: "exact-reference-temperature";
+    temperatureC: number;
+} | {
+    kind: "not-modeled";
+    limitation: string;
+    evidence: readonly EvidenceProvenance[];
+};
+export interface SensorPhysicalChargeCapacityProfile {
+    schemaVersion: "0.1.0";
+    profileId: string;
+    colorSamplingProfileId: string;
+    channelId: string;
+    capacityMeaning: "physical-charge-storage-capacity-electrons";
+    capacityElectrons: number;
+    scientificStatus: SensorSpectralResponseScientificStatus;
+    uncertainty: SensorSpectralResponseUncertainty;
+    evidence: readonly EvidenceProvenance[];
+    siteApplicability: SensorPhysicalChargeCapacitySiteApplicability;
+    operatingState: {
+        stateId: string;
+        evidence: readonly EvidenceProvenance[];
+    };
+    temperatureApplicability: SensorPhysicalChargeCapacityTemperatureApplicability;
+}
+export interface AssessSensorPhysicalChargeCapacityInput {
+    accumulatedCharge: SensorAccumulatedChargeComposition;
+    capacityProfile: SensorPhysicalChargeCapacityProfile;
+    operatingStateId: string;
+    operatingTemperatureC: number;
+}
+export interface SensorPhysicalChargeCapacityAssessment {
+    capacityProfileId: string;
+    completenessProfileId: string;
+    colorSamplingProfileId: string;
+    channelId: string;
+    site: {
+        x: number;
+        y: number;
+    };
+    bindingId: string;
+    operatingStateId: string;
+    operatingTemperatureC: number;
+    capacityMeaning: "physical-charge-storage-capacity-electrons";
+    physicalChargeCapacityElectrons: number;
+    totalExpectedStoredElectronCount: number;
+    expectedChargeToCapacityRatio: number;
+    expectedChargeHeadroomElectrons: number;
+    expectedChargeCapacityStatus: "below-capacity" | "at-capacity" | "above-capacity";
+    expectedChargeExceedsCapacity: boolean;
+    physicalChargeCapacityAssessmentPerformed: true;
+    assessmentMeaning: "expected-charge-vs-physical-storage-capacity";
+    actualStochasticSaturationStateKnown: false;
+    stochasticSaturationProbabilityAssessed: false;
+    storedChargeAfterPhysicalSaturationCalculated: false;
+    overflowChargeCalculated: false;
+    bloomingModeled: false;
+    clampApplied: false;
+    cameraSaturationAssessmentAuthorized: false;
+    adcQuantizationApplied: false;
+    rawCodeValueProduced: false;
+    capacityUncertaintyPropagated: false;
+    accumulatedChargeUncertaintyPropagated: false;
+    componentEvidence: {
+        capacity: readonly EvidenceProvenance[];
+        operatingState: readonly EvidenceProvenance[];
+        siteApproximation: readonly EvidenceProvenance[];
+        temperatureApproximation: readonly EvidenceProvenance[];
+        chargeCompleteness: SensorAccumulatedChargeComposition["componentEvidence"]["completeness"];
+    };
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Physical storage capacity is a source-specific total stored-electron limit tied to site, operating
+ * state and temperature. The assessment compares complete expected charge; it does not clamp
+ * realizations or infer overflow/blooming. Camera saturation and ADC/readout thresholds remain
+ * distinct.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SensorPhysicalChargeCapacityProfile. 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 parseSensorPhysicalChargeCapacityProfile(value: unknown): SensorPhysicalChargeCapacityProfile;
+/**
+ * Compare complete expected stored electrons to the explicitly applicable physical capacity and report
+ * expectation-domain headroom without nonlinear storage simulation.
+ *
+ * Physical storage capacity is a source-specific total stored-electron limit tied to site, operating
+ * state and temperature. The assessment compares complete expected charge; it does not clamp
+ * realizations or infer overflow/blooming. Camera saturation and ADC/readout thresholds remain
+ * distinct.
+ * @param input - AssessSensorPhysicalChargeCapacityInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<SensorPhysicalChargeCapacityAssessment>. Read structured blockers before consuming an authorization.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function assessSensorPhysicalChargeCapacity(input: AssessSensorPhysicalChargeCapacityInput): CalculationResult<SensorPhysicalChargeCapacityAssessment>;
+//# sourceMappingURL=physical-charge-capacity.d.ts.map

package/dist/sensor/physical-charge-capacity.d.ts.map

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