@photivra/engine 0.6.0 → 1.0.1

package/dist/sensor/response-application-compatibility.js

@@ -0,0 +1,408 @@
+// 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. Response application
+ * checks exact profile/channel, source plane, incident-area basis, spatial uniformity and reference
+ * conditions. Structural compatibility alone does not authorize signal conversion; per-bin
+ * operating-range validity and the typed EQE/A-W path are separate gates.
+ * Assess whether exact source-plane, area, profile/channel and reference-condition bindings permit the
+ * selected response application path. Response application checks exact profile/channel, source plane,
+ * incident-area basis, spatial uniformity and reference conditions. Structural compatibility alone
+ * does not authorize signal conversion; per-bin operating-range validity and the typed EQE/A-W path
+ * are separate gates.
+ * @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 AREA_TOLERANCE = 1e-10;
+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 requirePositiveFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value <= 0) {
+        throw new InvalidConfigurationError(path +
+            " must be finite and greater than zero.");
+    }
+    return value;
+}
+function parseIncidentAreaBasis(value, path) {
+    const record = requireRecord(value, path);
+    const areaSquareMicrometers = requirePositiveFinite(record.areaSquareMicrometers, path + ".areaSquareMicrometers");
+    if (record.kind !==
+        "geometric-sensitive-aperture" &&
+        record.kind !== "full-site-cell" &&
+        record.kind !==
+            "effective-collection-area") {
+        throw new InvalidConfigurationError(path + ".kind is invalid.");
+    }
+    return {
+        kind: record.kind,
+        areaSquareMicrometers
+    };
+}
+function parseSpatialResponseModel(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "not-established") {
+        return {
+            kind: "not-established",
+            limitation: requireNonEmptyString(record.limitation, path + ".limitation")
+        };
+    }
+    if (record.kind !==
+        "uniform-over-geometric-sensitive-aperture") {
+        throw new InvalidConfigurationError(path + ".kind is invalid.");
+    }
+    if (record.scientificStatus !==
+        "calibrated" &&
+        record.scientificStatus !==
+            "approximation") {
+        throw new InvalidConfigurationError(path +
+            ".scientificStatus is invalid.");
+    }
+    const limitation = record.limitation === undefined
+        ? undefined
+        : requireNonEmptyString(record.limitation, path + ".limitation");
+    if (record.scientificStatus ===
+        "approximation" &&
+        limitation === undefined) {
+        throw new InvalidConfigurationError(path +
+            ".limitation is required for an approximation.");
+    }
+    return {
+        kind: "uniform-over-geometric-sensitive-aperture",
+        scientificStatus: record.scientificStatus,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence"),
+        ...(limitation === undefined
+            ? {}
+            : { limitation })
+    };
+}
+function parseReferenceConditionPolicy(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind ===
+        "exact-match-required") {
+        return {
+            kind: "exact-match-required"
+        };
+    }
+    if (record.kind === "assume-compatible") {
+        return {
+            kind: "assume-compatible",
+            limitation: requireNonEmptyString(record.limitation, path + ".limitation"),
+            evidence: parseEvidenceList(record.evidence, path + ".evidence")
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Response application checks exact profile/channel, source plane, incident-area basis, spatial
+ * uniformity and reference conditions. Structural compatibility alone does not authorize signal
+ * conversion; per-bin operating-range validity and the typed EQE/A-W path are separate gates.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SensorResponseApplicationProfile. 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 parseSensorResponseApplicationProfile(value) {
+    const record = requireRecord(value, "sensorResponseApplication");
+    if (record.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('sensorResponseApplication.schemaVersion must be "0.1.0".');
+    }
+    return {
+        schemaVersion: "0.1.0",
+        profileId: requireNonEmptyString(record.profileId, "sensorResponseApplication.profileId"),
+        spectralResponseProfileId: requireNonEmptyString(record.spectralResponseProfileId, "sensorResponseApplication.spectralResponseProfileId"),
+        colorSamplingProfileId: requireNonEmptyString(record.colorSamplingProfileId, "sensorResponseApplication.colorSamplingProfileId"),
+        channelId: requireNonEmptyString(record.channelId, "sensorResponseApplication.channelId"),
+        samplingApertureProfileId: requireNonEmptyString(record.samplingApertureProfileId, "sensorResponseApplication.samplingApertureProfileId"),
+        opticalStackProfileId: requireNonEmptyString(record.opticalStackProfileId, "sensorResponseApplication.opticalStackProfileId"),
+        evidence: parseEvidenceList(record.evidence, "sensorResponseApplication.evidence"),
+        incidentAreaBasis: parseIncidentAreaBasis(record.incidentAreaBasis, "sensorResponseApplication.incidentAreaBasis"),
+        spatialResponseModel: parseSpatialResponseModel(record.spatialResponseModel, "sensorResponseApplication.spatialResponseModel"),
+        referenceConditionPolicy: parseReferenceConditionPolicy(record.referenceConditionPolicy, "sensorResponseApplication.referenceConditionPolicy")
+    };
+}
+function parseSourcePlane(value) {
+    const record = requireRecord(value, "sourcePlane");
+    if (record.value !==
+        "sensor-package-incident" &&
+        record.value !== "site-incident") {
+        throw new InvalidScientificInputError("sourcePlane.value is invalid.");
+    }
+    return {
+        value: record.value,
+        evidence: parseEvidenceList(record.evidence, "sourcePlane.evidence")
+    };
+}
+function requiredSourcePlane(scope) {
+    return scope ===
+        "sensor-package-incident-effective-channel-response"
+        ? "sensor-package-incident"
+        : "site-incident";
+}
+function approximatelyEqual(actual, expected) {
+    const scale = Math.max(1, Math.abs(actual), Math.abs(expected));
+    return (Math.abs(actual - expected) <=
+        AREA_TOLERANCE * scale);
+}
+function conditionsMatch(reference, operating) {
+    if (reference.temperatureC !==
+        undefined &&
+        operating.temperatureC !==
+            reference.temperatureC) {
+        return false;
+    }
+    if (reference
+        .incidenceAngleDegreesFromNormal !==
+        undefined &&
+        operating
+            .incidenceAngleDegreesFromNormal !==
+            reference
+                .incidenceAngleDegreesFromNormal) {
+        return false;
+    }
+    if (reference.polarization !==
+        undefined &&
+        operating.polarization !==
+            reference.polarization) {
+        return false;
+    }
+    return true;
+}
+function validateReductionBoundary(reduction) {
+    if (reduction.outputMeaning !==
+        "pre-response-spatio-spectral-radiometric-reduction" ||
+        reduction
+            .spectralResponseApplicationPerformed !==
+            false ||
+        reduction.quantumEfficiencyApplied !==
+            false ||
+        reduction.spectralResponsivityApplied !==
+            false ||
+        reduction.temporalIntegrationApplied !==
+            false) {
+        throw new InvalidScientificInputError("reduction must remain a pre-response, pre-temporal spatio-spectral result.");
+    }
+    if (typeof reduction
+        .geometricApertureAreaSquareMicrometers !==
+        "number" ||
+        !Number.isFinite(reduction
+            .geometricApertureAreaSquareMicrometers) ||
+        reduction
+            .geometricApertureAreaSquareMicrometers <=
+            0) {
+        throw new InvalidScientificInputError("reduction.geometricApertureAreaSquareMicrometers is required and must be positive.");
+    }
+    return reduction
+        .geometricApertureAreaSquareMicrometers;
+}
+/**
+ * Assess whether exact source-plane, area, profile/channel and reference-condition bindings permit the
+ * selected response application path.
+ *
+ * Response application checks exact profile/channel, source plane, incident-area basis, spatial
+ * uniformity and reference conditions. Structural compatibility alone does not authorize signal
+ * conversion; per-bin operating-range validity and the typed EQE/A-W path are separate gates.
+ * @param input - AssessSensorResponseApplicationCompatibilityInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<SensorResponseApplicationCompatibilityAssessment>. Read structured blockers before consuming an authorization.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export function assessSensorResponseApplicationCompatibility(input) {
+    const geometricArea = validateReductionBoundary(input.reduction);
+    const profile = parseSensorResponseApplicationProfile(input.applicationProfile);
+    const sourcePlane = parseSourcePlane(input.sourcePlane);
+    const blockers = [];
+    if (profile.spectralResponseProfileId !==
+        input.reduction.responseProfileId) {
+        blockers.push("spectral-response-profile-id-mismatch");
+    }
+    if (profile.colorSamplingProfileId !==
+        input.reduction
+            .colorSamplingProfileId) {
+        blockers.push("color-sampling-profile-id-mismatch");
+    }
+    if (profile.channelId !==
+        input.reduction.channelId) {
+        blockers.push("channel-id-mismatch");
+    }
+    const samplingApertureProfileId = input.reduction
+        .samplingApertureProfileId;
+    if (samplingApertureProfileId ===
+        undefined) {
+        blockers.push("sampling-aperture-profile-id-missing");
+    }
+    else if (samplingApertureProfileId !==
+        profile.samplingApertureProfileId) {
+        blockers.push("sampling-aperture-profile-id-mismatch");
+    }
+    const opticalStackProfileId = input.reduction
+        .opticalStackProfileId;
+    if (opticalStackProfileId === undefined) {
+        blockers.push("optical-stack-profile-id-missing");
+    }
+    else if (opticalStackProfileId !==
+        profile.opticalStackProfileId) {
+        blockers.push("optical-stack-profile-id-mismatch");
+    }
+    const requiredPlane = requiredSourcePlane(input.reduction.responseScope);
+    const sourcePlaneMatched = sourcePlane.value === requiredPlane;
+    if (!sourcePlaneMatched) {
+        blockers.push("source-plane-mismatch");
+    }
+    if (!input.reduction
+        .wavelengthBasisResolved) {
+        blockers.push("wavelength-basis-unresolved");
+    }
+    if (profile.incidentAreaBasis.kind !==
+        "geometric-sensitive-aperture") {
+        blockers.push("incident-area-basis-not-currently-integrated");
+    }
+    else if (!approximatelyEqual(profile.incidentAreaBasis
+        .areaSquareMicrometers, geometricArea)) {
+        blockers.push("incident-area-mismatch");
+    }
+    if (profile.spatialResponseModel.kind ===
+        "not-established") {
+        blockers.push("spatial-response-uniformity-not-established");
+    }
+    if (profile.referenceConditionPolicy.kind ===
+        "exact-match-required") {
+        const referenceConditions = input.reduction
+            .responseReferenceConditions;
+        if (referenceConditions === undefined) {
+            blockers.push("response-reference-conditions-not-declared");
+        }
+        else if (input.operatingConditions ===
+            undefined) {
+            blockers.push("operating-conditions-not-declared");
+        }
+        else if (!conditionsMatch(referenceConditions, input.operatingConditions)) {
+            blockers.push("operating-conditions-mismatch");
+        }
+    }
+    const structurallyCompatible = blockers.length === 0;
+    const approximation = input.reduction
+        .responseScientificStatus ===
+        "approximation" ||
+        (profile.spatialResponseModel.kind ===
+            "uniform-over-geometric-sensitive-aperture" &&
+            profile.spatialResponseModel
+                .scientificStatus ===
+                "approximation") ||
+        profile.referenceConditionPolicy.kind ===
+            "assume-compatible";
+    const compatibilityStatus = structurallyCompatible
+        ? approximation
+            ? "compatible-approximation"
+            : "compatible"
+        : "blocked";
+    const spatialEvidence = profile.spatialResponseModel.kind ===
+        "uniform-over-geometric-sensitive-aperture"
+        ? profile.spatialResponseModel.evidence
+        : [];
+    const referenceConditionEvidence = profile.referenceConditionPolicy.kind ===
+        "assume-compatible"
+        ? profile.referenceConditionPolicy
+            .evidence
+        : [];
+    return calculatedResult({
+        applicationProfileId: profile.profileId,
+        spectralResponseProfileId: input.reduction
+            .responseProfileId,
+        colorSamplingProfileId: input.reduction
+            .colorSamplingProfileId,
+        channelId: input.reduction.channelId,
+        responseScope: input.reduction.responseScope,
+        requiredSourcePlane: requiredPlane,
+        suppliedSourcePlane: sourcePlane.value,
+        sourcePlaneMatched,
+        responseIncidentAreaBasis: profile.incidentAreaBasis,
+        currentlyIntegratedAreaBasis: "geometric-sensitive-aperture",
+        geometricApertureAreaSquareMicrometers: geometricArea,
+        ...(input.reduction
+            .nominalSiteCellAreaSquareMicrometers ===
+            undefined
+            ? {}
+            : {
+                nominalSiteCellAreaSquareMicrometers: input.reduction
+                    .nominalSiteCellAreaSquareMicrometers
+            }),
+        spatialResponseModel: profile.spatialResponseModel,
+        referenceConditionPolicy: profile.referenceConditionPolicy,
+        ...(input.reduction
+            .responseReferenceConditions ===
+            undefined
+            ? {}
+            : {
+                responseReferenceConditions: input.reduction
+                    .responseReferenceConditions
+            }),
+        ...(input.operatingConditions ===
+            undefined
+            ? {}
+            : {
+                operatingConditions: input.operatingConditions
+            }),
+        structuralCompatibilityEstablished: structurallyCompatible,
+        compatibilityStatus,
+        blockers,
+        requiredSignalPath: input.reduction
+            .sourceResponseKind ===
+            "effective-spectral-responsivity"
+            ? "radiant-power-to-current"
+            : "photon-rate-to-electrons",
+        quantifiedResponseUncertaintyAvailable: input.reduction
+            .responseUncertainty.kind ===
+            "relative",
+        responseApplicationPerformed: false,
+        signalConversionAuthorized: false,
+        temporalIntegrationAuthorized: false,
+        photonConversionPerformed: false,
+        electronConversionPerformed: false,
+        currentConversionPerformed: false,
+        operatingRangeCompatibilityAssessed: false,
+        spatiallyVaryingResponseSupported: false,
+        componentEvidence: {
+            applicationProfile: profile.evidence,
+            sourcePlane: sourcePlane.evidence,
+            spatialResponse: spatialEvidence,
+            referenceConditionAssumption: referenceConditionEvidence,
+            response: input.reduction
+                .componentEvidence.spectral
+        }
+    }, "sensor-response-application-compatibility", "1.0.0", [
+        "This result is a structural compatibility gate only; it never authorizes or performs sensor-response signal conversion.",
+        "Response reference plane is derived from responseScope. Package-incident and site-incident inputs are not interchangeable.",
+        "The current spatio-spectral reducer integrates the geometric sensitive aperture only. Full-site-cell and effective-collection-area response normalizations remain blocked until matching radiometric integrations exist.",
+        "A scalar wavelength-only response may be applied after spatial reduction only when uniform/separable response over the integrated geometric aperture is explicitly established or declared as an approximation.",
+        "Exact reference-condition matching is required when that policy is selected because temperature, incidence-angle and polarization dependence are not modeled.",
+        "An unresolved wavelength basis is incompatible with physical response application.",
+        "Typical total-pixel QE definitions can include fill factor and microlens effects; they must not be applied to geometric-sensitive-aperture flux unless the response normalization explicitly matches that area basis.",
+        "Response linearity/dynamic-range validity is not assessed by this gate and remains required before a future conversion can claim calibrated applicability.",
+        "EQE/filter×EQE responses require a future photon-rate→electron path; A/W responsivity requires a separate radiant-power→current path.",
+        "Temporal integration, photons/electrons/current, noise, saturation, ADC/RAW conversion and reconstruction remain downstream."
+    ]);
+}
+//# sourceMappingURL=response-application-compatibility.js.map

package/dist/sensor/response-application-compatibility.js.map

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

package/dist/sensor/response-operating-range.d.ts

@@ -0,0 +1,173 @@
+/**
+ * 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. Operating-range
+ * assessment preserves incident power versus irradiance, wavelength support, reference conditions and
+ * declared nonlinearity criterion. Per-bin conversion requires spectral-bin applicability and spatial
+ * linear superposition. Valid mean input must not conceal an invalid bright local sub-aperture.
+ * Assess every declared spectral-bin input against operating applicability and superposition before
+ * authorizing instantaneous response conversion. Operating-range assessment preserves incident power
+ * versus irradiance, wavelength support, reference conditions and declared nonlinearity criterion.
+ * Per-bin conversion requires spectral-bin applicability and spatial linear superposition. Valid mean
+ * input must not conceal an invalid bright local sub-aperture.
+ * @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 { SensorResponseApplicationCompatibilityAssessment, SensorResponseReferenceConditionPolicy, SensorResponseSignalPath } from "./response-application-compatibility.js";
+import type { SensorSpectralReferenceConditions, SensorSpectralResponseScientificStatus, SensorSpectralResponseUncertainty, SpectralWavelengthBasis } from "./spectral-response.js";
+import type { SensorSpatioSpectralIrradianceReduction } from "./spatio-spectral-reduction.js";
+export type SensorResponseOperatingInputRange = {
+    kind: "wavelength-integrated-geometric-aperture-radiant-power";
+    unit: "W";
+    minimumInclusive: number;
+    maximumInclusive: number;
+} | {
+    kind: "wavelength-integrated-spatial-average-irradiance";
+    unit: "W/m^2";
+    minimumInclusive: number;
+    maximumInclusive: number;
+};
+export interface SensorResponseOperatingWavelengthApplicability {
+    wavelengthBasis: Exclude<SpectralWavelengthBasis, "unspecified">;
+    minimumNanometers: number;
+    maximumNanometers: number;
+    containment: "requested-range-must-be-contained";
+}
+export interface SensorResponseLinearityCriterion {
+    maximumAbsoluteRelativeDeviation: number;
+}
+export type SensorResponseOperatingSpectralInputModel = {
+    kind: "broadband-integrated-only";
+} | {
+    kind: "per-spectral-bin";
+    maximumBinWidthNanometers: number;
+    scientificStatus: SensorSpectralResponseScientificStatus;
+    evidence: readonly EvidenceProvenance[];
+    limitation?: string;
+};
+export type SensorResponseOperatingSpatialLinearityModel = {
+    kind: "linear-superposition-over-geometric-aperture";
+    scientificStatus: SensorSpectralResponseScientificStatus;
+    evidence: readonly EvidenceProvenance[];
+    limitation?: string;
+} | {
+    kind: "not-established";
+    limitation: string;
+};
+export interface SensorResponseOperatingRangeProfile {
+    schemaVersion: "0.1.0";
+    profileId: string;
+    responseApplicationProfileId: string;
+    spectralResponseProfileId: string;
+    colorSamplingProfileId: string;
+    channelId: string;
+    scientificStatus: SensorSpectralResponseScientificStatus;
+    uncertainty: SensorSpectralResponseUncertainty;
+    evidence: readonly EvidenceProvenance[];
+    inputRange: SensorResponseOperatingInputRange;
+    wavelengthApplicability: SensorResponseOperatingWavelengthApplicability;
+    linearityCriterion: SensorResponseLinearityCriterion;
+    /**
+     * Optional for backward compatibility. Omission parses as not-established
+     * and blocks new response-rate authorization.
+     */
+    spatialLinearityModel?: SensorResponseOperatingSpatialLinearityModel;
+    /**
+     * Optional for backward compatibility. Omission means the calibration only
+     * establishes a broadband-integrated operating range and cannot authorize
+     * wavelength-by-wavelength response conversion.
+     */
+    spectralInputModel?: SensorResponseOperatingSpectralInputModel;
+    referenceConditions?: SensorSpectralReferenceConditions;
+    referenceConditionPolicy: SensorResponseReferenceConditionPolicy;
+}
+export interface AssessSensorResponseOperatingRangeInput {
+    reduction: SensorSpatioSpectralIrradianceReduction;
+    compatibility: SensorResponseApplicationCompatibilityAssessment;
+    operatingRangeProfile: SensorResponseOperatingRangeProfile;
+}
+export type SensorResponseOperatingRangeBlocker = "structural-compatibility-not-established" | "response-application-profile-id-mismatch" | "spectral-response-profile-id-mismatch" | "color-sampling-profile-id-mismatch" | "channel-id-mismatch" | "wavelength-basis-unresolved" | "wavelength-basis-mismatch" | "wavelength-range-outside-linearity-applicability" | "input-below-linearity-range" | "input-above-linearity-range" | "spectral-bin-width-outside-linearity-applicability" | "spectral-bin-input-below-linearity-range" | "spectral-bin-input-above-linearity-range" | "spatial-linearity-superposition-not-established" | "operating-conditions-not-declared" | "linearity-operating-conditions-mismatch";
+export interface SensorResponseOperatingRangeAssessment {
+    operatingRangeProfileId: string;
+    responseApplicationProfileId: string;
+    spectralResponseProfileId: string;
+    colorSamplingProfileId: string;
+    channelId: string;
+    requiredSignalPath: SensorResponseSignalPath;
+    inputRange: SensorResponseOperatingInputRange;
+    evaluatedInput: {
+        kind: SensorResponseOperatingInputRange["kind"];
+        unit: SensorResponseOperatingInputRange["unit"];
+        value: number;
+    };
+    wavelengthApplicability: SensorResponseOperatingWavelengthApplicability;
+    evaluatedWavelengthRangeNanometers: {
+        minimum: number;
+        maximum: number;
+    };
+    linearityCriterion: SensorResponseLinearityCriterion;
+    spectralInputModel: SensorResponseOperatingSpectralInputModel;
+    evaluatedSpectralNodeInputs?: readonly {
+        spectralSampleIndex: number;
+        wavelengthNanometers: number;
+        wavelengthMeasureNanometers: number;
+        kind: SensorResponseOperatingInputRange["kind"];
+        unit: SensorResponseOperatingInputRange["unit"];
+        value: number;
+    }[];
+    spectralNodeRangeCompatibilityAssessed: boolean;
+    spatialLinearityModel: SensorResponseOperatingSpatialLinearityModel;
+    referenceConditionPolicy: SensorResponseReferenceConditionPolicy;
+    referenceConditions?: SensorSpectralReferenceConditions;
+    operatingConditions?: SensorSpectralReferenceConditions;
+    operatingRangeCompatibilityAssessed: true;
+    instantaneousResponseRangeCompatible: boolean;
+    status: "broadband-range-compatible" | "broadband-range-compatible-approximation" | "rate-conversion-authorized" | "rate-conversion-authorized-approximation" | "blocked";
+    blockers: readonly SensorResponseOperatingRangeBlocker[];
+    responseRateConversionAuthorized: boolean;
+    responseApplicationPerformed: false;
+    temporalIntegrationAuthorized: false;
+    exposureDomainLinearityAssessed: false;
+    accumulatedChargeLinearityAssessed: false;
+    saturationAssessed: false;
+    photonConversionPerformed: false;
+    electronConversionPerformed: false;
+    currentConversionPerformed: false;
+    componentEvidence: {
+        operatingRange: readonly EvidenceProvenance[];
+        referenceConditionAssumption: readonly EvidenceProvenance[];
+        spatialLinearity: readonly EvidenceProvenance[];
+        structuralCompatibility: SensorResponseApplicationCompatibilityAssessment["componentEvidence"];
+    };
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Operating-range assessment preserves incident power versus irradiance, wavelength support, reference
+ * conditions and declared nonlinearity criterion. Per-bin conversion requires spectral-bin
+ * applicability and spatial linear superposition. Valid mean input must not conceal an invalid bright
+ * local sub-aperture.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SensorResponseOperatingRangeProfile. 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 parseSensorResponseOperatingRangeProfile(value: unknown): SensorResponseOperatingRangeProfile;
+/**
+ * Assess every declared spectral-bin input against operating applicability and superposition before
+ * authorizing instantaneous response conversion.
+ *
+ * Operating-range assessment preserves incident power versus irradiance, wavelength support, reference
+ * conditions and declared nonlinearity criterion. Per-bin conversion requires spectral-bin
+ * applicability and spatial linear superposition. Valid mean input must not conceal an invalid bright
+ * local sub-aperture.
+ * @param input - AssessSensorResponseOperatingRangeInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<SensorResponseOperatingRangeAssessment>. Read structured blockers before consuming an authorization.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function assessSensorResponseOperatingRange(input: AssessSensorResponseOperatingRangeInput): CalculationResult<SensorResponseOperatingRangeAssessment>;
+//# sourceMappingURL=response-operating-range.d.ts.map

package/dist/sensor/response-operating-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-operating-range.d.ts","sourceRoot":"","sources":["../../src/sensor/response-operating-range.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,gDAAgD,EAChD,sCAAsC,EACtC,wBAAwB,EACzB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,iCAAiC,EACjC,sCAAsC,EACtC,iCAAiC,EACjC,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,uCAAuC,EACxC,MAAM,gCAAgC,CAAC;AAIxC,MAAM,MAAM,iCAAiC,GACzC;IACE,IAAI,EACF,wDAAwD,CAAC;IAC3D,IAAI,EAAE,GAAG,CAAC;IACV,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,IAAI,EACF,kDAAkD,CAAC;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,MAAM,WAAW,8CAA8C;IAC7D,eAAe,EACb,OAAO,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EACT,mCAAmC,CAAC;CACvC;AAED,MAAM,WAAW,gCAAgC;IAC/C,gCAAgC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,MAAM,yCAAyC,GACjD;IACE,IAAI,EAAE,2BAA2B,CAAC;CACnC,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,gBAAgB,EACd,sCAAsC,CAAC;IACzC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,4CAA4C,GACpD;IACE,IAAI,EACF,8CAA8C,CAAC;IACjD,gBAAgB,EACd,sCAAsC,CAAC;IACzC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,WAAW,mCAAmC;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B,EAAE,MAAM,CAAC;IACrC,yBAAyB,EAAE,MAAM,CAAC;IAClC,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,UAAU,EACR,iCAAiC,CAAC;IACpC,uBAAuB,EACrB,8CAA8C,CAAC;IACjD,kBAAkB,EAChB,gCAAgC,CAAC;IACnC;;;OAGG;IACH,qBAAqB,CAAC,EACpB,4CAA4C,CAAC;IAC/C;;;;OAIG;IACH,kBAAkB,CAAC,EACjB,yCAAyC,CAAC;IAC5C,mBAAmB,CAAC,EAClB,iCAAiC,CAAC;IACpC,wBAAwB,EACtB,sCAAsC,CAAC;CAC1C;AAED,MAAM,WAAW,uCAAuC;IACtD,SAAS,EACP,uCAAuC,CAAC;IAC1C,aAAa,EACX,gDAAgD,CAAC;IACnD,qBAAqB,EACnB,mCAAmC,CAAC;CACvC;AAED,MAAM,MAAM,mCAAmC,GAC3C,0CAA0C,GAC1C,0CAA0C,GAC1C,uCAAuC,GACvC,oCAAoC,GACpC,qBAAqB,GACrB,6BAA6B,GAC7B,2BAA2B,GAC3B,kDAAkD,GAClD,6BAA6B,GAC7B,6BAA6B,GAC7B,oDAAoD,GACpD,0CAA0C,GAC1C,0CAA0C,GAC1C,iDAAiD,GACjD,mCAAmC,GACnC,yCAAyC,CAAC;AAE9C,MAAM,WAAW,sCAAsC;IACrD,uBAAuB,EAAE,MAAM,CAAC;IAChC,4BAA4B,EAAE,MAAM,CAAC;IACrC,yBAAyB,EAAE,MAAM,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAChB,wBAAwB,CAAC;IAC3B,UAAU,EACR,iCAAiC,CAAC;IACpC,cAAc,EAAE;QACd,IAAI,EACF,iCAAiC,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,EACF,iCAAiC,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,uBAAuB,EACrB,8CAA8C,CAAC;IACjD,kCAAkC,EAAE;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,kBAAkB,EAChB,gCAAgC,CAAC;IACnC,kBAAkB,EAChB,yCAAyC,CAAC;IAC5C,2BAA2B,CAAC,EAC1B,SAAS;QACP,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,2BAA2B,EAAE,MAAM,CAAC;QACpC,IAAI,EACF,iCAAiC,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,EACF,iCAAiC,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACN,sCAAsC,EACpC,OAAO,CAAC;IACV,qBAAqB,EACnB,4CAA4C,CAAC;IAC/C,wBAAwB,EACtB,sCAAsC,CAAC;IACzC,mBAAmB,CAAC,EAClB,iCAAiC,CAAC;IACpC,mBAAmB,CAAC,EAClB,iCAAiC,CAAC;IACpC,mCAAmC,EAAE,IAAI,CAAC;IAC1C,oCAAoC,EAAE,OAAO,CAAC;IAC9C,MAAM,EACF,4BAA4B,GAC5B,0CAA0C,GAC1C,4BAA4B,GAC5B,0CAA0C,GAC1C,SAAS,CAAC;IACd,QAAQ,EACN,SAAS,mCAAmC,EAAE,CAAC;IACjD,gCAAgC,EAAE,OAAO,CAAC;IAC1C,4BAA4B,EAAE,KAAK,CAAC;IACpC,6BAA6B,EAAE,KAAK,CAAC;IACrC,+BAA+B,EAAE,KAAK,CAAC;IACvC,kCAAkC,EAAE,KAAK,CAAC;IAC1C,kBAAkB,EAAE,KAAK,CAAC;IAC1B,yBAAyB,EAAE,KAAK,CAAC;IACjC,2BAA2B,EAAE,KAAK,CAAC;IACnC,0BAA0B,EAAE,KAAK,CAAC;IAClC,iBAAiB,EAAE;QACjB,cAAc,EACZ,SAAS,kBAAkB,EAAE,CAAC;QAChC,4BAA4B,EAC1B,SAAS,kBAAkB,EAAE,CAAC;QAChC,gBAAgB,EACd,SAAS,kBAAkB,EAAE,CAAC;QAChC,uBAAuB,EACrB,gDAAgD,CAAC,mBAAmB,CAAC,CAAC;KACzE,CAAC;CACH;AAuiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,OAAO,GACb,mCAAmC,CAmIrC;AAgHD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EACH,uCAAuC,GACxC,iBAAiB,CAAC,sCAAsC,CAAC,CAgZ3D"}