@photivra/engine 1.5.0 → 2.1.0

package/dist/sensor/dark-current.js

@@ -1,16 +1,13 @@
 // 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. 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.
+ * Dark current: electrons generated by heat in a sensor site even with no light, and the dark charge
+ * they add over one exposure.
+ *
+ * The dark-current rate (electrons per second, before any compensation) is declared separately as a
+ * function of temperature. It is given either at an exact temperature or as samples, interpolated
+ * log-linearly (or with the legacy linear rule) only within the declared range. No universal
+ * "doubles every N degrees" law is assumed. Rates are population means, an approximation; hot pixels
+ * and DCNU (dark-current non-uniformity) are not modelled.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -19,12 +16,15 @@ import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { parseSensorEqeTemporalPhotoSignal } from "./temporal-photo-signal.js";
 import { InvalidScientificInputError } from "../core/validation.js";
-function requireRecord(value, path) {
+import { requireInputObject, requireInputKeys, rejectUnknownFields, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS } from "../core/record-validation.js";
+function requireRecord(value, path, allowedKeys) {
     if (typeof value !== "object" ||
         value === null ||
         Array.isArray(value)) {
         throw new InvalidConfigurationError(path + " must be an object.");
     }
+    if (allowedKeys !== null)
+        rejectUnknownFields(value, allowedKeys, path);
     return value;
 }
 function requireNonEmptyString(value, path) {
@@ -59,7 +59,8 @@ function requireSiteIndex(value, path) {
     return value;
 }
 function parseUncertainty(value, path) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, null);
+    rejectUnknownVariantFields(record, "kind", UNCERTAINTY_VARIANT_FIELDS, path);
     if (record.kind === "relative") {
         const fraction = requireNonNegativeFinite(record.fraction, path + ".fraction");
         if (typeof record.basis !== "string" ||
@@ -82,9 +83,10 @@ function parseUncertainty(value, path) {
     throw new InvalidConfigurationError(path + ".kind is invalid.");
 }
 function parseSiteApplicability(value) {
-    const record = requireRecord(value, "sensorDarkCurrent.siteApplicability");
+    const record = requireRecord(value, "sensorDarkCurrent.siteApplicability", null);
+    rejectUnknownVariantFields(record, "kind", { "exact-site": ["kind", "site"], "uniform-site-mean-approximation": ["kind", "limitation", "evidence"] }, "sensorDarkCurrent.siteApplicability");
     if (record.kind === "exact-site") {
-        const site = requireRecord(record.site, "sensorDarkCurrent.siteApplicability.site");
+        const site = requireRecord(record.site, "sensorDarkCurrent.siteApplicability.site", ["x", "y"]);
         return {
             kind: "exact-site",
             site: {
@@ -104,7 +106,12 @@ function parseSiteApplicability(value) {
     throw new InvalidConfigurationError("sensorDarkCurrent.siteApplicability.kind is invalid.");
 }
 function parseTemperatureModel(value) {
-    const record = requireRecord(value, "sensorDarkCurrent.temperatureModel");
+    const record = requireRecord(value, "sensorDarkCurrent.temperatureModel", null);
+    rejectUnknownVariantFields(record, "kind", {
+        "fixed-reference-temperature": ["kind", "referenceTemperatureC", "darkCurrentElectronsPerSecond"],
+        "piecewise-linear-temperature-table": ["kind", "interpolation", "outsideRangeBehavior", "samples"],
+        "log-linear-temperature-table": ["kind", "interpolation", "outsideRangeBehavior", "samples"]
+    }, "sensorDarkCurrent.temperatureModel");
     if (record.kind ===
         "fixed-reference-temperature") {
         return {
@@ -113,13 +120,18 @@ function parseTemperatureModel(value) {
             darkCurrentElectronsPerSecond: requireNonNegativeFinite(record.darkCurrentElectronsPerSecond, "sensorDarkCurrent.temperatureModel.darkCurrentElectronsPerSecond")
         };
     }
+    const logLinear = record.kind ===
+        "log-linear-temperature-table";
     if (record.kind !==
-        "piecewise-linear-temperature-table") {
+        "piecewise-linear-temperature-table" &&
+        !logLinear) {
         throw new InvalidConfigurationError("sensorDarkCurrent.temperatureModel.kind is invalid.");
     }
     if (record.interpolation !==
-        "piecewise-linear") {
-        throw new InvalidConfigurationError('sensorDarkCurrent.temperatureModel.interpolation must be "piecewise-linear".');
+        (logLinear ? "log-linear" : "piecewise-linear")) {
+        throw new InvalidConfigurationError(logLinear
+            ? 'sensorDarkCurrent.temperatureModel.interpolation must be "log-linear".'
+            : 'sensorDarkCurrent.temperatureModel.interpolation must be "piecewise-linear".');
     }
     if (record.outsideRangeBehavior !==
         "fail-closed") {
@@ -133,7 +145,7 @@ function parseTemperatureModel(value) {
     const samples = record.samples.map((sample, index) => {
         const parsed = requireRecord(sample, "sensorDarkCurrent.temperatureModel.samples[" +
             index +
-            "]");
+            "]", ["temperatureC", "darkCurrentElectronsPerSecond"]);
         const temperatureC = requireFinite(parsed.temperatureC, "sensorDarkCurrent.temperatureModel.samples[" +
             index +
             "].temperatureC");
@@ -150,28 +162,40 @@ function parseTemperatureModel(value) {
                 "].darkCurrentElectronsPerSecond")
         };
     });
-    return {
-        kind: "piecewise-linear-temperature-table",
-        interpolation: "piecewise-linear",
-        outsideRangeBehavior: "fail-closed",
-        samples
-    };
+    if (logLinear &&
+        samples.some((sample) => sample
+            .darkCurrentElectronsPerSecond <=
+            0)) {
+        throw new InvalidConfigurationError("sensorDarkCurrent.temperatureModel log-linear samples require strictly positive rates.");
+    }
+    return logLinear
+        ? {
+            kind: "log-linear-temperature-table",
+            interpolation: "log-linear",
+            outsideRangeBehavior: "fail-closed",
+            samples
+        }
+        : {
+            kind: "piecewise-linear-temperature-table",
+            interpolation: "piecewise-linear",
+            outsideRangeBehavior: "fail-closed",
+            samples
+        };
 }
 /**
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary.
+ * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
  *
- * 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.
+ * The profile declares the dark-current rate (before compensation) against temperature, at an exact
+ * temperature or as samples. Interpolation (log-linear, or the legacy linear rule) is allowed only
+ * within the declared range. No universal doubling-temperature law is assumed.
+ * @param value - Untrusted data. TypeScript types alone are not validation.
+ * @returns The result. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function parseSensorDarkCurrentProfile(value) {
-    const record = requireRecord(value, "sensorDarkCurrent");
+    const record = requireRecord(value, "sensorDarkCurrent", ["schemaVersion", "chargeMeaning", "scientificStatus", "darkCurrentCompensationIncluded", "spatialDarkCurrentNonuniformityModeled", "uncertainty", "siteApplicability", "profileId", "colorSamplingProfileId", "channelId", "evidence", "temperatureModel"]);
     if (record.schemaVersion !== "0.1.0") {
         throw new InvalidConfigurationError('sensorDarkCurrent.schemaVersion must be "0.1.0".');
     }
@@ -275,6 +299,20 @@ function resolveDarkCurrentRate(model, operatingTemperatureC) {
         lower.temperatureC) /
         (upper.temperatureC -
             lower.temperatureC);
+    if (model.kind ===
+        "log-linear-temperature-table") {
+        // r = r0^(1-alpha) * r1^alpha, written as r0 * (r1/r0)^alpha.
+        return {
+            rate: lower
+                .darkCurrentElectronsPerSecond *
+                (upper
+                    .darkCurrentElectronsPerSecond /
+                    lower
+                        .darkCurrentElectronsPerSecond) **
+                    alpha,
+            interpolationUsed: true
+        };
+    }
     const rate = lower
         .darkCurrentElectronsPerSecond +
         alpha *
@@ -288,6 +326,7 @@ function resolveDarkCurrentRate(model, operatingTemperatureC) {
     };
 }
 function validateExposure(exposure) {
+    requireInputObject(exposure, "exposure input");
     if (exposure.kind === "eqe-temporal-photo-signal")
         parseSensorEqeTemporalPhotoSignal(exposure);
     if ((exposure.kind !== "eqe-expected-counts" && exposure.kind !== "eqe-temporal-photo-signal") ||
@@ -316,19 +355,18 @@ function validateExposure(exposure) {
     }
 }
 /**
- * Evaluate the declared temperature-dependent dark electron rate and integrate over the exact
- * photo-signal local exposure event.
+ * Evaluates the declared dark-current rate at the sensor temperature and integrates it over the exact
+ * local exposure of the photo signal.
  *
- * 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.
+ * The rate is a population mean, an approximation. Hot pixels and DCNU (dark-current non-uniformity)
+ * are not modelled. No universal doubling-temperature law is assumed.
+ * @param input - The input; see `CalculateSensorDarkCurrentChargeInput` for its fields, units and coordinates.
+ * @returns The result. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function calculateSensorDarkCurrentCharge(input) {
+    requireInputKeys(input, "calculateSensorDarkCurrentCharge", ["exposure", "darkCurrentProfile", "operatingTemperatureC"]);
     validateExposure(input.exposure);
     const profile = parseSensorDarkCurrentProfile(input.darkCurrentProfile);
     if (profile.colorSamplingProfileId !==
@@ -402,7 +440,10 @@ export function calculateSensorDarkCurrentCharge(input) {
     const assumptions = [
         "Dark current is modeled as pre-compensation thermally generated electron rate in electrons per second.",
         "Release 4.0 style temperature handling is data-driven: no universal exponential or doubling-temperature law is inferred.",
-        "Piecewise-linear interpolation is allowed only inside an explicitly sampled temperature table; extrapolation fails closed.",
+        profile.temperatureModel.kind ===
+            "log-linear-temperature-table"
+            ? "Log-linear (exponential-in-temperature) interpolation between adjacent declared samples is allowed only inside the sampled table; extrapolation fails closed."
+            : "Piecewise-linear interpolation is allowed only inside an explicitly sampled temperature table; extrapolation fails closed.",
         "Dark-current compensation, dark offset, hot-pixel/defect excess, leakage and charge injection remain separate from this thermal dark-current expectation.",
         "Expected dark-electron count is rate × the exact local exposure duration; no integer sampling or dark-current shot-noise realization is performed.",
         "This result is dark charge only. Photo-signal and other accumulated charge are not included, so physical full-well assessment remains unauthorized.",

package/dist/sensor/dark-current.js.map

@@ -1 +1 @@
-{"version":3,"file":"dark-current.js","sourceRoot":"","sources":["../../src/sensor/dark-current.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dark-current.js","sourceRoot":"","sources":["../../src/sensor/dark-current.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Dark current: electrons generated by heat in a sensor site even with no light, and the dark charge\n * they add over one exposure.\n *\n * The dark-current rate (electrons per second, before any compensation) is declared separately as a\n * function of temperature. It is given either at an exact temperature or as samples, interpolated\n * log-linearly (or with the legacy linear rule) only within the declared range. No universal\n * \"doubles every N degrees\" law is assumed. Rates are population means, an approximation; hot pixels\n * and DCNU (dark-current non-uniformity) are not modelled.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport {\n  approximationResult,\n  calculatedResult,\n  type CalculationResult\n} from \"../core/calculation-result.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceProvenance\n} from \"../core/evidence-provenance.js\";\nimport type { SensorEqeExposureIntegration } from \"./constant-rate-temporal-integration.js\";\nimport { parseSensorEqeTemporalPhotoSignal } from \"./temporal-photo-signal.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport type {\n  SensorEqePhotoExposure, SensorEqeTemporalPhotoSignal\n} from \"./temporal-photo-signal.js\";\nimport type {\n  SensorSpectralResponseScientificStatus,\n  SensorSpectralResponseUncertainty\n} from \"./spectral-response.js\";\nimport { requireInputObject, requireInputKeys, rejectUnknownFields, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS } from \"../core/record-validation.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport type SensorDarkCurrentSiteApplicability =\n  | {\n      kind: \"exact-site\";\n      site: {\n        x: number;\n        y: number;\n      };\n    }\n  | {\n      kind:\n        \"uniform-site-mean-approximation\";\n      limitation: string;\n      evidence:\n        readonly EvidenceProvenance[];\n    };\n\nexport type SensorDarkCurrentTemperatureModel =\n  | {\n      kind:\n        \"fixed-reference-temperature\";\n      referenceTemperatureC: number;\n      darkCurrentElectronsPerSecond:\n        number;\n    }\n  | {\n      /** Legacy interpolation, linear in rate. Between samples of an exponential curve it gives values that are too high. */\n      kind:\n        \"piecewise-linear-temperature-table\";\n      interpolation: \"piecewise-linear\";\n      outsideRangeBehavior:\n        \"fail-closed\";\n      samples: readonly {\n        temperatureC: number;\n        darkCurrentElectronsPerSecond:\n          number;\n      }[];\n    }\n  | {\n      /**\n       * Linear interpolation of ln(rate) between neighbouring samples. That makes the rate exponential\n       * in temperature within each interval, matching the roughly exponential (Arrhenius, or\n       * \"doubling temperature\") behaviour of thermally generated dark current. Rates must be strictly\n       * positive. No single doubling temperature is imposed; each interval follows its own two samples.\n       */\n      kind:\n        \"log-linear-temperature-table\";\n      interpolation: \"log-linear\";\n      outsideRangeBehavior:\n        \"fail-closed\";\n      samples: readonly {\n        temperatureC: number;\n        darkCurrentElectronsPerSecond:\n          number;\n      }[];\n    };\n\nexport interface SensorDarkCurrentProfile {\n  schemaVersion: \"0.1.0\";\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  scientificStatus:\n    SensorSpectralResponseScientificStatus;\n  uncertainty:\n    SensorSpectralResponseUncertainty;\n  evidence: readonly EvidenceProvenance[];\n  chargeMeaning:\n    \"pre-compensation-thermally-generated-electrons\";\n  siteApplicability:\n    SensorDarkCurrentSiteApplicability;\n  temperatureModel:\n    SensorDarkCurrentTemperatureModel;\n  darkCurrentCompensationIncluded: false;\n  spatialDarkCurrentNonuniformityModeled:\n    boolean;\n}\n\nexport interface CalculateSensorDarkCurrentChargeInput<Exposure extends SensorEqePhotoExposure = SensorEqeExposureIntegration> {\n  exposure:\n    Exposure;\n  darkCurrentProfile:\n    SensorDarkCurrentProfile;\n  operatingTemperatureC: number;\n}\n\nexport interface SensorDarkCurrentCharge {\n  darkCurrentProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  stationarityProfileId: string;\n  temporalIntegrationId?: never;\n  timeReference:\n    \"first-opening-boundary-phase\";\n  startOffsetSecondsFromOpeningReference:\n    number;\n  endOffsetSecondsFromOpeningReference:\n    number;\n  operatingTemperatureC: number;\n  temperatureModel:\n    SensorDarkCurrentTemperatureModel[\"kind\"];\n  temperatureInterpolationUsed:\n    boolean;\n  darkCurrentElectronsPerSecond:\n    number;\n  localExposureDurationSeconds:\n    number;\n  expectedDarkElectronCount:\n    number;\n  countMeaning:\n    \"expected-thermally-generated-electrons\";\n  expectationValueOnly: true;\n  integerDarkElectronCountSampled:\n    false;\n  darkShotNoiseApplied: false;\n  darkCurrentCompensationApplied:\n    false;\n  spatialDarkCurrentNonuniformityModeled:\n    boolean;\n  photoSignalIncluded: false;\n  otherChargeIncluded: false;\n  physicalFullWellAssessmentAuthorized:\n    false;\n  saturationAssessed: false;\n  componentEvidence: {\n    darkCurrent:\n      readonly EvidenceProvenance[];\n    siteApproximation:\n      readonly EvidenceProvenance[];\n    exposure:\n      SensorEqeExposureIntegration[\"componentEvidence\"];\n  };\n}\n\n/** Dark charge for the exact same time-resolved photo event. It has no stationarity ID. */\nexport type SensorTemporalDarkCurrentCharge = Omit<SensorDarkCurrentCharge, \"stationarityProfileId\" | \"temporalIntegrationId\" | \"componentEvidence\"> & {\n  stationarityProfileId?: never;\n  temporalIntegrationId: string;\n  componentEvidence: Omit<SensorDarkCurrentCharge[\"componentEvidence\"], \"exposure\"> & { exposure: SensorEqeTemporalPhotoSignal[\"componentEvidence\"] };\n};\nexport type SensorPhotoDarkCurrentCharge = SensorDarkCurrentCharge | SensorTemporalDarkCurrentCharge;\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be an object.\"\n    );\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonEmptyString(\n  value: unknown,\n  path: string\n): string {\n  if (\n    typeof value !== \"string\" ||\n    value.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a non-empty string.\"\n    );\n  }\n  return value;\n}\n\nfunction requireFinite(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be finite.\"\n    );\n  }\n  return value;\n}\n\nfunction requireNonNegativeFinite(\n  value: unknown,\n  path: string\n): number {\n  const parsed =\n    requireFinite(value, path);\n  if (parsed < 0) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be greater than or equal to zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction requireSiteIndex(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isSafeInteger(value) ||\n    value < 0\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be a non-negative safe integer.\"\n    );\n  }\n  return value;\n}\n\nfunction parseUncertainty(\n  value: unknown,\n  path: string\n): SensorSpectralResponseUncertainty {\n  const record =\n    requireRecord(value, path, null);\n  rejectUnknownVariantFields(record, \"kind\", UNCERTAINTY_VARIANT_FIELDS, path);\n\n  if (record.kind === \"relative\") {\n    const fraction =\n      requireNonNegativeFinite(\n        record.fraction,\n        path + \".fraction\"\n      );\n    if (\n      typeof record.basis !== \"string\" ||\n      record.basis.trim().length === 0\n    ) {\n      throw new InvalidConfigurationError(\n        path +\n          \".basis must be a non-empty string.\"\n      );\n    }\n    return {\n      kind: \"relative\",\n      fraction,\n      basis: record.basis\n    };\n  }\n\n  if (\n    record.kind === \"not-quantified\"\n  ) {\n    return {\n      kind: \"not-quantified\",\n      limitation:\n        requireNonEmptyString(\n          record.limitation,\n          path + \".limitation\"\n        )\n    };\n  }\n\n  throw new InvalidConfigurationError(\n    path + \".kind is invalid.\"\n  );\n}\n\nfunction parseSiteApplicability(\n  value: unknown\n): SensorDarkCurrentSiteApplicability {\n  const record = requireRecord(\n    value,\n    \"sensorDarkCurrent.siteApplicability\", null\n  );\n  rejectUnknownVariantFields(record, \"kind\", { \"exact-site\": [\"kind\", \"site\"], \"uniform-site-mean-approximation\": [\"kind\", \"limitation\", \"evidence\"] }, \"sensorDarkCurrent.siteApplicability\");\n\n  if (record.kind === \"exact-site\") {\n    const site = requireRecord(\n      record.site,\n      \"sensorDarkCurrent.siteApplicability.site\", [\"x\", \"y\"]\n    );\n    return {\n      kind: \"exact-site\",\n      site: {\n        x: requireSiteIndex(\n          site.x,\n          \"sensorDarkCurrent.siteApplicability.site.x\"\n        ),\n        y: requireSiteIndex(\n          site.y,\n          \"sensorDarkCurrent.siteApplicability.site.y\"\n        )\n      }\n    };\n  }\n\n  if (\n    record.kind ===\n    \"uniform-site-mean-approximation\"\n  ) {\n    return {\n      kind:\n        \"uniform-site-mean-approximation\",\n      limitation:\n        requireNonEmptyString(\n          record.limitation,\n          \"sensorDarkCurrent.siteApplicability.limitation\"\n        ),\n      evidence: parseEvidenceList(\n        record.evidence,\n        \"sensorDarkCurrent.siteApplicability.evidence\"\n      )\n    };\n  }\n\n  throw new InvalidConfigurationError(\n    \"sensorDarkCurrent.siteApplicability.kind is invalid.\"\n  );\n}\n\nfunction parseTemperatureModel(\n  value: unknown\n): SensorDarkCurrentTemperatureModel {\n  const record = requireRecord(\n    value,\n    \"sensorDarkCurrent.temperatureModel\", null\n  );\n  rejectUnknownVariantFields(record, \"kind\", {\n    \"fixed-reference-temperature\": [\"kind\", \"referenceTemperatureC\", \"darkCurrentElectronsPerSecond\"],\n    \"piecewise-linear-temperature-table\": [\"kind\", \"interpolation\", \"outsideRangeBehavior\", \"samples\"],\n    \"log-linear-temperature-table\": [\"kind\", \"interpolation\", \"outsideRangeBehavior\", \"samples\"]\n  }, \"sensorDarkCurrent.temperatureModel\");\n\n  if (\n    record.kind ===\n      \"fixed-reference-temperature\"\n  ) {\n    return {\n      kind:\n        \"fixed-reference-temperature\",\n      referenceTemperatureC:\n        requireFinite(\n          record.referenceTemperatureC,\n          \"sensorDarkCurrent.temperatureModel.referenceTemperatureC\"\n        ),\n      darkCurrentElectronsPerSecond:\n        requireNonNegativeFinite(\n          record.darkCurrentElectronsPerSecond,\n          \"sensorDarkCurrent.temperatureModel.darkCurrentElectronsPerSecond\"\n        )\n    };\n  }\n\n  const logLinear =\n    record.kind ===\n    \"log-linear-temperature-table\";\n  if (\n    record.kind !==\n      \"piecewise-linear-temperature-table\" &&\n    !logLinear\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorDarkCurrent.temperatureModel.kind is invalid.\"\n    );\n  }\n  if (\n    record.interpolation !==\n      (logLinear ? \"log-linear\" : \"piecewise-linear\")\n  ) {\n    throw new InvalidConfigurationError(\n      logLinear\n        ? 'sensorDarkCurrent.temperatureModel.interpolation must be \"log-linear\".'\n        : 'sensorDarkCurrent.temperatureModel.interpolation must be \"piecewise-linear\".'\n    );\n  }\n  if (\n    record.outsideRangeBehavior !==\n      \"fail-closed\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorDarkCurrent.temperatureModel.outsideRangeBehavior must be \"fail-closed\".'\n    );\n  }\n  if (\n    !Array.isArray(record.samples) ||\n    record.samples.length < 2\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorDarkCurrent.temperatureModel.samples must contain at least two samples.\"\n    );\n  }\n\n  let previousTemperature =\n    Number.NEGATIVE_INFINITY;\n  const samples =\n    record.samples.map(\n      (sample, index) => {\n        const parsed = requireRecord(\n          sample,\n          \"sensorDarkCurrent.temperatureModel.samples[\" +\n            index +\n            \"]\", [\"temperatureC\", \"darkCurrentElectronsPerSecond\"]\n        );\n        const temperatureC =\n          requireFinite(\n            parsed.temperatureC,\n            \"sensorDarkCurrent.temperatureModel.samples[\" +\n              index +\n              \"].temperatureC\"\n          );\n        if (\n          temperatureC <=\n          previousTemperature\n        ) {\n          throw new InvalidConfigurationError(\n            \"sensorDarkCurrent.temperatureModel.samples must be strictly increasing in temperature.\"\n          );\n        }\n        previousTemperature =\n          temperatureC;\n        return {\n          temperatureC,\n          darkCurrentElectronsPerSecond:\n            requireNonNegativeFinite(\n              parsed.darkCurrentElectronsPerSecond,\n              \"sensorDarkCurrent.temperatureModel.samples[\" +\n                index +\n                \"].darkCurrentElectronsPerSecond\"\n            )\n        };\n      }\n    );\n\n  if (\n    logLinear &&\n    samples.some(\n      (sample) =>\n        sample\n          .darkCurrentElectronsPerSecond <=\n        0\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorDarkCurrent.temperatureModel log-linear samples require strictly positive rates.\"\n    );\n  }\n\n  return logLinear\n    ? {\n        kind:\n          \"log-linear-temperature-table\",\n        interpolation: \"log-linear\",\n        outsideRangeBehavior:\n          \"fail-closed\",\n        samples\n      }\n    : {\n        kind:\n          \"piecewise-linear-temperature-table\",\n        interpolation: \"piecewise-linear\",\n        outsideRangeBehavior:\n          \"fail-closed\",\n        samples\n      };\n}\n\n/**\n * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\n *\n * The profile declares the dark-current rate (before compensation) against temperature, at an exact\n * temperature or as samples. Interpolation (log-linear, or the legacy linear rule) is allowed only\n * within the declared range. No universal doubling-temperature law is assumed.\n * @param value - Untrusted data. TypeScript types alone are not validation.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function parseSensorDarkCurrentProfile(\n  value: unknown\n): SensorDarkCurrentProfile {\n  const record = requireRecord(\n    value,\n    \"sensorDarkCurrent\", [\"schemaVersion\", \"chargeMeaning\", \"scientificStatus\", \"darkCurrentCompensationIncluded\", \"spatialDarkCurrentNonuniformityModeled\", \"uncertainty\", \"siteApplicability\", \"profileId\", \"colorSamplingProfileId\", \"channelId\", \"evidence\", \"temperatureModel\"]\n  );\n\n  if (\n    record.schemaVersion !== \"0.1.0\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorDarkCurrent.schemaVersion must be \"0.1.0\".'\n    );\n  }\n  if (\n    record.chargeMeaning !==\n      \"pre-compensation-thermally-generated-electrons\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorDarkCurrent.chargeMeaning is invalid.\"\n    );\n  }\n  if (\n    record.scientificStatus !==\n      \"calibrated\" &&\n    record.scientificStatus !==\n      \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorDarkCurrent.scientificStatus is invalid.\"\n    );\n  }\n  if (\n    record.darkCurrentCompensationIncluded !==\n      false\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorDarkCurrent.darkCurrentCompensationIncluded must be false.\"\n    );\n  }\n  if (\n    typeof record\n      .spatialDarkCurrentNonuniformityModeled !==\n      \"boolean\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorDarkCurrent.spatialDarkCurrentNonuniformityModeled must be boolean.\"\n    );\n  }\n\n  const uncertainty =\n    parseUncertainty(\n      record.uncertainty,\n      \"sensorDarkCurrent.uncertainty\"\n    );\n  if (\n    record.scientificStatus ===\n      \"calibrated\" &&\n    uncertainty.kind ===\n      \"not-quantified\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"A calibrated dark-current profile must declare quantified relative uncertainty.\"\n    );\n  }\n\n  const siteApplicability =\n    parseSiteApplicability(\n      record.siteApplicability\n    );\n  if (\n    siteApplicability.kind ===\n      \"uniform-site-mean-approximation\" &&\n    record.scientificStatus !==\n      \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"Uniform site-mean dark current must remain an approximation.\"\n    );\n  }\n  if (\n    siteApplicability.kind ===\n      \"uniform-site-mean-approximation\" &&\n    record\n      .spatialDarkCurrentNonuniformityModeled !==\n      false\n  ) {\n    throw new InvalidConfigurationError(\n      \"Uniform site-mean dark current cannot claim spatial dark-current nonuniformity is modeled.\"\n    );\n  }\n\n  return {\n    schemaVersion: \"0.1.0\",\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"sensorDarkCurrent.profileId\"\n      ),\n    colorSamplingProfileId:\n      requireNonEmptyString(\n        record.colorSamplingProfileId,\n        \"sensorDarkCurrent.colorSamplingProfileId\"\n      ),\n    channelId:\n      requireNonEmptyString(\n        record.channelId,\n        \"sensorDarkCurrent.channelId\"\n      ),\n    scientificStatus:\n      record.scientificStatus,\n    uncertainty,\n    evidence: parseEvidenceList(\n      record.evidence,\n      \"sensorDarkCurrent.evidence\"\n    ),\n    chargeMeaning:\n      \"pre-compensation-thermally-generated-electrons\",\n    siteApplicability,\n    temperatureModel:\n      parseTemperatureModel(\n        record.temperatureModel\n      ),\n    darkCurrentCompensationIncluded:\n      false,\n    spatialDarkCurrentNonuniformityModeled:\n      record\n        .spatialDarkCurrentNonuniformityModeled\n  };\n}\n\nfunction sameSite(\n  a: { x: number; y: number },\n  b: { x: number; y: number }\n): boolean {\n  return a.x === b.x && a.y === b.y;\n}\n\nfunction resolveDarkCurrentRate(\n  model:\n    SensorDarkCurrentTemperatureModel,\n  operatingTemperatureC: number\n): {\n  rate: number;\n  interpolationUsed: boolean;\n} {\n  if (\n    !Number.isFinite(\n      operatingTemperatureC\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"operatingTemperatureC must be finite.\"\n    );\n  }\n\n  if (\n    model.kind ===\n      \"fixed-reference-temperature\"\n  ) {\n    if (\n      operatingTemperatureC !==\n      model.referenceTemperatureC\n    ) {\n      throw new InvalidScientificInputError(\n        \"Fixed-reference dark current may only be used at its exact reference temperature.\"\n      );\n    }\n    return {\n      rate:\n        model\n          .darkCurrentElectronsPerSecond,\n      interpolationUsed: false\n    };\n  }\n\n  const first =\n    model.samples[0]!;\n  const last =\n    model.samples[\n      model.samples.length - 1\n    ]!;\n  if (\n    operatingTemperatureC <\n      first.temperatureC ||\n    operatingTemperatureC >\n      last.temperatureC\n  ) {\n    throw new InvalidScientificInputError(\n      \"operatingTemperatureC is outside the measured dark-current temperature range; extrapolation is not permitted.\"\n    );\n  }\n\n  const exact =\n    model.samples.find(\n      (sample) =>\n        sample.temperatureC ===\n        operatingTemperatureC\n    );\n  if (exact !== undefined) {\n    return {\n      rate:\n        exact\n          .darkCurrentElectronsPerSecond,\n      interpolationUsed: false\n    };\n  }\n\n  const upperIndex =\n    model.samples.findIndex(\n      (sample) =>\n        sample.temperatureC >\n        operatingTemperatureC\n    );\n  const upper =\n    model.samples[upperIndex]!;\n  const lower =\n    model.samples[upperIndex - 1]!;\n  const alpha =\n    (operatingTemperatureC -\n      lower.temperatureC) /\n    (upper.temperatureC -\n      lower.temperatureC);\n  if (\n    model.kind ===\n    \"log-linear-temperature-table\"\n  ) {\n    // r = r0^(1-alpha) * r1^alpha, written as r0 * (r1/r0)^alpha.\n    return {\n      rate:\n        lower\n          .darkCurrentElectronsPerSecond *\n        (upper\n          .darkCurrentElectronsPerSecond /\n          lower\n            .darkCurrentElectronsPerSecond) **\n          alpha,\n      interpolationUsed: true\n    };\n  }\n  const rate =\n    lower\n      .darkCurrentElectronsPerSecond +\n    alpha *\n      (\n        upper\n          .darkCurrentElectronsPerSecond -\n        lower\n          .darkCurrentElectronsPerSecond\n      );\n\n  return {\n    rate,\n    interpolationUsed: true\n  };\n}\n\nfunction validateExposure(\n  exposure:\n    SensorEqePhotoExposure\n): void {\n  requireInputObject(exposure, \"exposure input\");\n  if (exposure.kind === \"eqe-temporal-photo-signal\") parseSensorEqeTemporalPhotoSignal(exposure);\n  if (\n    (exposure.kind !== \"eqe-expected-counts\" && exposure.kind !== \"eqe-temporal-photo-signal\") ||\n    exposure.temporalIntegrationApplied !==\n      true ||\n    exposure.exposureDurationApplied !==\n      true ||\n    exposure.accumulatedSignalCompleteness !==\n      \"photo-signal-only\" ||\n    exposure.darkChargeIncluded !== false ||\n    exposure.otherChargeIncluded !== false ||\n    exposure\n      .physicalFullWellAssessmentAuthorized !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Dark-current composition requires an unmodified photo-signal-only EQE exposure integration.\"\n    );\n  }\n\n  if (\n    typeof exposure\n      .localExposureDurationSeconds !==\n      \"number\" ||\n    !Number.isFinite(\n      exposure\n        .localExposureDurationSeconds\n    ) ||\n    exposure\n      .localExposureDurationSeconds <=\n      0\n  ) {\n    throw new InvalidScientificInputError(\n      \"EQE exposure local duration must be finite and positive.\"\n    );\n  }\n}\n\n/**\n * Evaluates the declared dark-current rate at the sensor temperature and integrates it over the exact\n * local exposure of the photo signal.\n *\n * The rate is a population mean, an approximation. Hot pixels and DCNU (dark-current non-uniformity)\n * are not modelled. No universal doubling-temperature law is assumed.\n * @param input - Dark-current input whose exposure is a per-exposure photo signal (SensorEqeExposureIntegration); see `CalculateSensorDarkCurrentChargeInput`.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function calculateSensorDarkCurrentCharge(\n  input: Omit<CalculateSensorDarkCurrentChargeInput, \"exposure\"> & { exposure: SensorEqeExposureIntegration }\n): CalculationResult<SensorDarkCurrentCharge>;\n/**\n * Evaluates the declared dark-current rate at the sensor temperature and integrates it over the exact\n * local exposure of the photo signal.\n *\n * The rate is a population mean, an approximation. Hot pixels and DCNU (dark-current non-uniformity)\n * are not modelled. No universal doubling-temperature law is assumed.\n * @param input - Dark-current input whose exposure is a time-resolved photo signal (SensorEqeTemporalPhotoSignal); see `CalculateSensorDarkCurrentChargeInput`.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function calculateSensorDarkCurrentCharge(\n  input: Omit<CalculateSensorDarkCurrentChargeInput, \"exposure\"> & { exposure: SensorEqeTemporalPhotoSignal }\n): CalculationResult<SensorTemporalDarkCurrentCharge>;\n/**\n * Evaluates the declared dark-current rate at the sensor temperature and integrates it over the exact\n * local exposure of the photo signal.\n *\n * The rate is a population mean, an approximation. Hot pixels and DCNU (dark-current non-uniformity)\n * are not modelled. No universal doubling-temperature law is assumed.\n * @param input - The input; see `CalculateSensorDarkCurrentChargeInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function calculateSensorDarkCurrentCharge(\n  input: CalculateSensorDarkCurrentChargeInput<SensorEqePhotoExposure>\n): CalculationResult<SensorPhotoDarkCurrentCharge>;\n/**\n * Evaluates the declared dark-current rate at the sensor temperature and integrates it over the exact\n * local exposure of the photo signal.\n *\n * The rate is a population mean, an approximation. Hot pixels and DCNU (dark-current non-uniformity)\n * are not modelled. No universal doubling-temperature law is assumed.\n * @param input - The input; see `CalculateSensorDarkCurrentChargeInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function calculateSensorDarkCurrentCharge(\n  input:\n    CalculateSensorDarkCurrentChargeInput<SensorEqePhotoExposure>\n): CalculationResult<SensorPhotoDarkCurrentCharge> {\n  requireInputKeys(input, \"calculateSensorDarkCurrentCharge\", [\"exposure\", \"darkCurrentProfile\", \"operatingTemperatureC\"]);\n  validateExposure(input.exposure);\n  const profile =\n    parseSensorDarkCurrentProfile(\n      input.darkCurrentProfile\n    );\n\n  if (\n    profile.colorSamplingProfileId !==\n      input.exposure\n        .colorSamplingProfileId ||\n    profile.channelId !==\n      input.exposure.channelId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Dark-current profile color/channel identity must match the EQE exposure.\"\n    );\n  }\n\n  const site =\n    input.exposure.site;\n  if (\n    profile.siteApplicability.kind ===\n      \"exact-site\" &&\n    !sameSite(\n      profile.siteApplicability.site,\n      site\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Exact-site dark-current profile does not apply to the exposure site.\"\n    );\n  }\n\n  const resolved =\n    resolveDarkCurrentRate(\n      profile.temperatureModel,\n      input.operatingTemperatureC\n    );\n  const expectedDarkElectronCount =\n    resolved.rate *\n    input.exposure\n      .localExposureDurationSeconds;\n\n  if (\n    !Number.isFinite(\n      expectedDarkElectronCount\n    ) ||\n    expectedDarkElectronCount < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Expected dark-electron count must remain finite and nonnegative.\"\n    );\n  }\n\n  const result:\n    SensorPhotoDarkCurrentCharge = {\n      darkCurrentProfileId:\n        profile.profileId,\n      colorSamplingProfileId:\n        input.exposure\n          .colorSamplingProfileId,\n      channelId:\n        input.exposure.channelId,\n      site: {\n        ...site\n      },\n      bindingId:\n        input.exposure.bindingId,\n      ...(input.exposure.kind === \"eqe-temporal-photo-signal\"\n        ? { temporalIntegrationId: input.exposure.temporalIntegrationId }\n        : { stationarityProfileId: input.exposure.stationarityProfileId }),\n      timeReference:\n        input.exposure.timeReference,\n      startOffsetSecondsFromOpeningReference:\n        input.exposure\n          .startOffsetSecondsFromOpeningReference,\n      endOffsetSecondsFromOpeningReference:\n        input.exposure\n          .endOffsetSecondsFromOpeningReference,\n      operatingTemperatureC:\n        input.operatingTemperatureC,\n      temperatureModel:\n        profile.temperatureModel.kind,\n      temperatureInterpolationUsed:\n        resolved.interpolationUsed,\n      darkCurrentElectronsPerSecond:\n        resolved.rate,\n      localExposureDurationSeconds:\n        input.exposure\n          .localExposureDurationSeconds,\n      expectedDarkElectronCount,\n      countMeaning:\n        \"expected-thermally-generated-electrons\",\n      expectationValueOnly: true,\n      integerDarkElectronCountSampled:\n        false,\n      darkShotNoiseApplied: false,\n      darkCurrentCompensationApplied:\n        false,\n      spatialDarkCurrentNonuniformityModeled:\n        profile\n          .spatialDarkCurrentNonuniformityModeled,\n      photoSignalIncluded: false,\n      otherChargeIncluded: false,\n      physicalFullWellAssessmentAuthorized:\n        false,\n      saturationAssessed: false,\n      componentEvidence: {\n        darkCurrent:\n          profile.evidence,\n        siteApproximation:\n          profile.siteApplicability.kind ===\n            \"uniform-site-mean-approximation\"\n            ? profile\n                .siteApplicability\n                .evidence\n            : [],\n        exposure:\n          input.exposure\n            .componentEvidence\n      }\n    } as SensorPhotoDarkCurrentCharge;\n\n  const assumptions = [\n    \"Dark current is modeled as pre-compensation thermally generated electron rate in electrons per second.\",\n    \"Release 4.0 style temperature handling is data-driven: no universal exponential or doubling-temperature law is inferred.\",\n    profile.temperatureModel.kind ===\n      \"log-linear-temperature-table\"\n      ? \"Log-linear (exponential-in-temperature) interpolation between adjacent declared samples is allowed only inside the sampled table; extrapolation fails closed.\"\n      : \"Piecewise-linear interpolation is allowed only inside an explicitly sampled temperature table; extrapolation fails closed.\",\n    \"Dark-current compensation, dark offset, hot-pixel/defect excess, leakage and charge injection remain separate from this thermal dark-current expectation.\",\n    \"Expected dark-electron count is rate × the exact local exposure duration; no integer sampling or dark-current shot-noise realization is performed.\",\n    \"This result is dark charge only. Photo-signal and other accumulated charge are not included, so physical full-well assessment remains unauthorized.\",\n    \"A/W current-domain exposure results cannot enter this electron-storage path without a separate carrier/storage mapping.\"\n  ];\n\n  return profile.scientificStatus ===\n    \"calibrated\"\n    ? calculatedResult(\n        result,\n        \"sensor-dark-current-charge\",\n        input.exposure.kind === \"eqe-temporal-photo-signal\" ? \"1.1.0\" : \"1.0.0\",\n        assumptions\n      )\n    : approximationResult(\n        result,\n        \"sensor-dark-current-charge\",\n        input.exposure.kind === \"eqe-temporal-photo-signal\" ? \"1.1.0\" : \"1.0.0\",\n        [\n          ...assumptions,\n          ...(profile\n            .siteApplicability.kind ===\n            \"uniform-site-mean-approximation\"\n            ? [\n                profile\n                  .siteApplicability\n                  .limitation\n              ]\n            : [])\n        ]\n      );\n}\n"]}

package/dist/sensor/environment-photo-signal.d.ts

@@ -1,20 +1,20 @@
 /**
- * Module boundary and integration notes.
- * Preflight all optical, spatial, spectral and temporal support into an internal owned execution plan
- * without invoking provider code. Planning checks complete spatial/spectral/temporal support before
- * invoking supplied synchronous radiance code. Queries use explicit environment directions, vacuum/air
- * wavelength and opening-reference seconds. Optical throughput, optional local PSF and typed EQE
- * produce photo expectations; callback invocation does not verify transport, visibility or
- * calibration.
- * Internal executor consumes a completed bounded geometric plan; returns no partial success on
- * failure.
+ * Photo signal for one sensor site from a scene-radiance provider (the "environment"): asks the
+ * provider for radiance along each sampled direction, then applies optics and the sensor response.
+ *
+ * Work is split into a plan and an execution step. Planning checks spatial, spectral and temporal
+ * coverage and builds an internal plan before any provider code runs. Each query gives an explicit
+ * scene direction, a wavelength (air or vacuum) and a time in seconds from the shutter's opening
+ * reference. Optical throughput, an optional local PSF (point-spread function) and the EQE (external
+ * quantum efficiency) response then give the expected photo signal. Calling the provider does not
+ * verify its light transport, visibility or calibration.
  * @see docs/ENVIRONMENT_RAW_CAPTURE.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 { validateSceneRadianceEvaluationBindings, type SceneRadianceEvaluationRequest, type SceneRadianceEvaluationResult } from "../schema/scene-radiance.js";
-import { calculateSensorEnvironmentRadianceQuery, type CalculateSensorEnvironmentRadianceQueryInput } from "../optics/sensor-environment-query.js";
+import { calculateSensorEnvironmentRadianceQuery, type CalculateSensorEnvironmentRadianceQueryInput, type EnvironmentLensFieldMapping } from "../optics/sensor-environment-query.js";
 import { calculateSceneRadianceToSensorIrradiance, type CalculateSceneRadianceToSensorIrradianceInput } from "../optics/scene-to-sensor-irradiance.js";
 import { calculateSensorPsfIrradianceQuadrature, type CalculateSensorPsfIrradianceQuadratureInput } from "../optics/sensor-psf-quadrature.js";
 import { type IlluminationVignettingProfile } from "../optics/illumination-vignetting.js";
@@ -24,7 +24,7 @@ import { calculateSensorSpectralQuadrature } from "./spectral-quadrature.js";
 import { createSensorEqeTemporalPhotoSignal } from "./temporal-photo-signal.js";
 import type { CalculateSensorEqeTemporalExposureInput } from "./eqe-temporal-exposure.js";
 import type { CalculateSceneToSensorIrradianceQuadratureInput } from "../optics/scene-to-sensor-quadrature.js";
-/** Supplied synchronous code executes locally. Invocation does not prove physical transport. */
+/** Caller-supplied synchronous radiance function, run locally. Calling it does not prove its light transport is physical. */
 export type EnvironmentRadianceEvaluator = (request: Readonly<SceneRadianceEvaluationRequest>) => SceneRadianceEvaluationResult;
 export type EnvironmentApertureRadianceEvaluator = (request: Readonly<SceneRadianceEvaluationRequest>, apertureRay: Readonly<SensorApertureRay>) => SceneRadianceEvaluationResult;
 export interface CalculateEnvironmentSensorPhotoSignalInput {
@@ -34,9 +34,16 @@ export interface CalculateEnvironmentSensorPhotoSignalInput {
     optics: Omit<CalculateSceneRadianceToSensorIrradianceInput, "sceneRadianceRequest" | "sceneRadianceResult" | "imagePointMm" | "fieldThroughput">;
     motion: Pick<CalculateSensorEnvironmentRadianceQueryInput, "angularVelocityRadPerSec" | "timeReference" | "environmentDirectionConvention">;
     temporalSampleCount: number;
-    /** Optional ideal geometric DOF/visibility support; cannot combine with a sampled PSF. */
+    /** Optional ideal circular pupil, for geometric depth of field (DOF) and visibility. Cannot be combined with a sampled PSF. */
     pupil?: IdealCircularPupil;
-    /** Explicit source-field attenuation, applied once before PSF redistribution. */
+    /**
+     * Optional lens field mapping (added in 2.0): a projection model and radial or Brown-Conrady
+     * distortion for the scene-ray query. Its distortion area factor is applied to irradiance exactly
+     * once. If omitted, the ideal rectilinear, distortion-free path is unchanged. Cannot be combined
+     * with `pupil`.
+     */
+    lensFieldMapping?: EnvironmentLensFieldMapping;
+    /** Explicit attenuation across the field (such as vignetting), applied once before the PSF spreads the light. */
     fieldThroughput: {
         kind: "unity";
         evidence: readonly EvidenceProvenance[];
@@ -56,7 +63,7 @@ export interface CalculateEnvironmentSensorPhotoSignalInput {
         configuration: Pick<CalculateSensorPsfIrradianceQuadratureInput, "psf" | "psfWavelengthBasis" | "spatialModel">;
     };
     evaluateRadiance: EnvironmentRadianceEvaluator;
-    /** Required with pupil; origin-aware scene intersections cannot use direction-only code. */
+    /** Required with `pupil`: rays start at different points on the aperture, so a direction-only function cannot be used. */
     evaluateApertureRadiance?: EnvironmentApertureRadianceEvaluator;
 }
 export interface EnvironmentSensorPhotoSignal {
@@ -91,7 +98,7 @@ export interface EnvironmentSensorPhotoSignal {
         }[];
     }[];
 }
-/** Internal preflight is shared with the full-frame composer to bound all work before callbacks. */
+/** Internal plan, shared with the full-frame composer, so all work is bounded before any callback runs. */
 interface EnvironmentPhotoPlan {
     owned: Omit<CalculateEnvironmentSensorPhotoSignalInput, "evaluateRadiance" | "evaluateApertureRadiance">;
     sceneBindings: CalculateSceneToSensorIrradianceQuadratureInput["sceneBindings"];
@@ -112,30 +119,64 @@ interface EnvironmentPhotoPlan {
                     x: number;
                     y: number;
                 };
-                query: ReturnType<typeof calculateSensorEnvironmentRadianceQuery>;
+                /** Deep-frozen provider request of the planned query (the same object as query.value.request). */
+                request: SceneRadianceEvaluationRequest;
+                /** The planned query's image-plane source point (the same object as query.value.sourcePointImagePlaneMm). */
+                sourcePointImagePlaneMm: {
+                    x: number;
+                    y: number;
+                };
+                /** The complete query result. Kept only by "full" plans, whose per-evaluation records include it. */
+                query?: ReturnType<typeof calculateSensorEnvironmentRadianceQuery>;
                 apertureRays?: readonly SensorApertureRay[];
+                /** 1 / det(d distorted / d ideal), the change in area from distortion. Present only with a lens field mapping. */
+                distortionAreaFactor?: number;
                 fieldThroughput: CalculateSceneRadianceToSensorIrradianceInput["fieldThroughput"];
             }[];
         }[];
     }[];
 }
 /**
- * Preflight all optical, spatial, spectral and temporal support into an internal owned execution plan
- * without invoking provider code.
+ * Builds an internal execution plan covering all optical, spatial, spectral and temporal sampling,
+ * without calling any provider code.
  *
- * Planning checks complete spatial/spectral/temporal support before invoking supplied synchronous
- * radiance code. Queries use explicit environment directions, vacuum/air wavelength and
- * opening-reference seconds. Optical throughput, optional local PSF and typed EQE produce photo
- * expectations; callback invocation does not verify transport, visibility or calibration.
- * @param input - Omit<CalculateEnvironmentSensorPhotoSignalInput, "evaluateRadiance" | "evaluateApertureRadiance">. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns EnvironmentPhotoPlan. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Coverage is checked completely before any supplied radiance function runs. Each query gives an
+ * explicit scene direction, a wavelength (air or vacuum) and seconds from the opening reference.
+ * @param input - The photo-signal input without its radiance functions; see
+ *   `CalculateEnvironmentSensorPhotoSignalInput`.
+ * @param ownership - Internal. "copy" (default) makes a structured clone of the input. "engine-owned"
+ * uses the input as the plan's own data without cloning again. Only engine callers that already hold a
+ * private structured clone, never shown to supplied code and never changed afterwards, may pass it.
+ * @param retention - Internal. "full" (default) keeps every planned query result for "full" execution
+ * records. "photo-only" keeps only each query's frozen request and image-plane point, which is all that
+ * photo-only execution reads. Every query is still computed and validated at plan time, so limit checks
+ * and errors are unchanged.
+ * @returns The result. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
+ */
+export declare function planEnvironmentSensorPhotoSignal(input: Omit<CalculateEnvironmentSensorPhotoSignalInput, "evaluateRadiance" | "evaluateApertureRadiance">, ownership?: "copy" | "engine-owned", retention?: "full" | "photo-only"): EnvironmentPhotoPlan;
+/**
+ * Internal: the frozen provider request and frozen private ray copy of one ideal-pupil query (sample ID suffix "-a"
+ * and the pupil index, reversed ray direction). If prebuildApertureRadianceQuery already built this query for a batch,
+ * the same objects are returned once, so the batch and the executor share them; otherwise new ones are built.
+ */
+export declare function apertureRadianceQuery(base: SceneRadianceEvaluationRequest, ray: SensorApertureRay): {
+    request: SceneRadianceEvaluationRequest;
+    apertureRay: SensorApertureRay;
+};
+/** Internal: builds a pupil query for a batched provider and keeps it for the executor's apertureRadianceQuery call. */
+export declare function prebuildApertureRadianceQuery(base: SceneRadianceEvaluationRequest, ray: SensorApertureRay): {
+    request: SceneRadianceEvaluationRequest;
+    apertureRay: SensorApertureRay;
+};
+/**
+ * Internal: runs a completed, bounded plan. On failure nothing partial is returned.
+ * With retention "full" (default), every per-evaluation record is kept in value.instants[].evaluations.
+ * With "photo-only", those lists are empty, for engine callers that read only value.photo. Photo values
+ * are identical either way.
  */
-export declare function planEnvironmentSensorPhotoSignal(input: Omit<CalculateEnvironmentSensorPhotoSignalInput, "evaluateRadiance" | "evaluateApertureRadiance">): EnvironmentPhotoPlan;
-/** Internal executor consumes a completed bounded geometric plan; returns no partial success on failure. */
-export declare function executeEnvironmentSensorPhotoSignal(plan: ReturnType<typeof planEnvironmentSensorPhotoSignal>, evaluate: EnvironmentRadianceEvaluator, evaluateAperture?: EnvironmentApertureRadianceEvaluator): CalculationResult<EnvironmentSensorPhotoSignal>;
-/** Generate, evaluate and integrate one site's actual local midpoint environment support. */
+export declare function executeEnvironmentSensorPhotoSignal(plan: ReturnType<typeof planEnvironmentSensorPhotoSignal>, evaluate: EnvironmentRadianceEvaluator, evaluateAperture?: EnvironmentApertureRadianceEvaluator, retention?: "full" | "photo-only"): CalculationResult<EnvironmentSensorPhotoSignal>;
+/** Plans, queries the provider and integrates the photo signal for one site, at the site's own midpoint sample positions. */
 export declare function calculateEnvironmentSensorPhotoSignal(input: CalculateEnvironmentSensorPhotoSignalInput): CalculationResult<EnvironmentSensorPhotoSignal>;
 export {};
-//# sourceMappingURL=environment-photo-signal.d.ts.map