@photivra/engine 1.4.0 → 2.0.0

package/dist/sensor/camera-saturation-capacity.js

@@ -1,16 +1,12 @@
 // 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. Camera saturation
- * capacity is a dark-corrected photo-signal electron-equivalent limit. It is not physical total-charge
- * storage capacity, ADC maximum or evidence of the limiting hardware stage. This assessment compares
- * expectations and does not synthesize post-saturation codes.
- * Compare dark-corrected expected photo signal with the declared camera response-chain capacity
- * without adding dark charge or identifying a hardware clamp. Camera saturation capacity is a
- * dark-corrected photo-signal electron-equivalent limit. It is not physical total-charge storage
- * capacity, ADC maximum or evidence of the limiting hardware stage. This assessment compares
- * expectations and does not synthesize post-saturation codes.
+ * Camera saturation capacity: checks whether the expected photo signal would exceed the camera's
+ * declared saturation limit.
+ *
+ * Camera saturation capacity is the largest photo signal, in electron equivalents and after dark
+ * correction, that the whole camera response chain records before saturating. It is not the
+ * physical charge a pixel can store, not the ADC maximum, and does not say which hardware stage
+ * limits it. The check compares expected values only; it does not make up codes beyond saturation.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -18,12 +14,15 @@ import { approximationResult } from "../core/calculation-result.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";
-function requireRecord(value, path) {
+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) {
@@ -67,7 +66,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 = requireFinite(record.fraction, path + ".fraction");
         if (fraction < 0) {
@@ -89,9 +89,10 @@ function parseUncertainty(value, path) {
     throw new InvalidConfigurationError(path + ".kind is invalid.");
 }
 function parseSiteApplicability(value) {
-    const record = requireRecord(value, "sensorCameraSaturation.siteApplicability");
+    const record = requireRecord(value, "sensorCameraSaturation.siteApplicability", null);
+    rejectUnknownVariantFields(record, "kind", { "exact-site": ["kind", "site"], "channel-population-mean-approximation": ["kind", "limitation", "evidence"] }, "sensorCameraSaturation.siteApplicability");
     if (record.kind === "exact-site") {
-        const site = requireRecord(record.site, "sensorCameraSaturation.siteApplicability.site");
+        const site = requireRecord(record.site, "sensorCameraSaturation.siteApplicability.site", ["x", "y"]);
         return {
             kind: "exact-site",
             site: {
@@ -111,7 +112,8 @@ function parseSiteApplicability(value) {
     throw new InvalidConfigurationError("sensorCameraSaturation.siteApplicability.kind is invalid.");
 }
 function parseTemperatureApplicability(value) {
-    const record = requireRecord(value, "sensorCameraSaturation.temperatureApplicability");
+    const record = requireRecord(value, "sensorCameraSaturation.temperatureApplicability", null);
+    rejectUnknownVariantFields(record, "kind", { "exact-reference-temperature": ["kind", "temperatureC"], "not-modeled": ["kind", "limitation", "evidence"] }, "sensorCameraSaturation.temperatureApplicability");
     if (record.kind ===
         "exact-reference-temperature") {
         return {
@@ -129,19 +131,19 @@ function parseTemperatureApplicability(value) {
     throw new InvalidConfigurationError("sensorCameraSaturation.temperatureApplicability.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.
+ * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
  *
- * Camera saturation capacity is a dark-corrected photo-signal electron-equivalent limit. It is not
- * physical total-charge storage capacity, ADC maximum or evidence of the limiting hardware stage. This
- * assessment compares expectations and does not synthesize post-saturation codes.
- * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
- * @returns SensorCameraSaturationCapacityProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Camera saturation capacity is a limit on the dark-corrected photo signal, in electron
+ * equivalents. It is not the physical charge storage capacity or the ADC maximum, and does not
+ * identify which hardware stage limits it.
+ * @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 parseSensorCameraSaturationCapacityProfile(value) {
-    const record = requireRecord(value, "sensorCameraSaturation");
+    const record = requireRecord(value, "sensorCameraSaturation", ["schemaVersion", "capacityMeaning", "signalDomain", "scientificStatus", "uncertainty", "siteApplicability", "temperatureApplicability", "operatingState", "profileId", "colorSamplingProfileId", "channelId", "saturationCapacityElectrons", "evidence", "measurementMethodId", "measurementMethodEvidence"]);
     if (record.schemaVersion !== "0.1.0") {
         throw new InvalidConfigurationError('sensorCameraSaturation.schemaVersion must be "0.1.0".');
     }
@@ -180,7 +182,7 @@ export function parseSensorCameraSaturationCapacityProfile(value) {
             "approximation") {
         throw new InvalidConfigurationError("A camera saturation capacity with unmodeled temperature dependence must remain an approximation.");
     }
-    const state = requireRecord(record.operatingState, "sensorCameraSaturation.operatingState");
+    const state = requireRecord(record.operatingState, "sensorCameraSaturation.operatingState", ["stateId", "evidence"]);
     return {
         schemaVersion: "0.1.0",
         profileId: requireNonEmptyString(record.profileId, "sensorCameraSaturation.profileId"),
@@ -206,6 +208,7 @@ function sameSite(a, b) {
     return a.x === b.x && a.y === b.y;
 }
 function validateCharge(charge) {
+    requireInputObject(charge, "charge input");
     if (charge.accumulatedChargeCompleteness !==
         "complete-for-physical-storage-capacity-assessment" ||
         charge.saturationAssessed !==
@@ -222,18 +225,17 @@ function validateCharge(charge) {
     };
 }
 /**
- * Compare dark-corrected expected photo signal with the declared camera response-chain capacity
- * without adding dark charge or identifying a hardware clamp.
+ * Compares the expected photo signal (dark-corrected) with the camera's declared saturation
+ * capacity. Dark charge is not added, and no hardware clamp is identified.
  *
- * Camera saturation capacity is a dark-corrected photo-signal electron-equivalent limit. It is not
- * physical total-charge storage capacity, ADC maximum or evidence of the limiting hardware stage. This
- * assessment compares expectations and does not synthesize post-saturation codes.
- * @param input - AssessSensorCameraSaturationCapacityInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns CalculationResult<SensorCameraSaturationCapacityAssessment>. Read structured blockers before consuming an authorization.
+ * This compares expected values only. It does not make up codes beyond saturation.
+ * @param input - The input; see `AssessSensorCameraSaturationCapacityInput` for its fields, units and coordinates.
+ * @returns The assessment. Read its structured blockers before acting on an authorization.
  *
- * @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 assessSensorCameraSaturationCapacity(input) {
+    requireInputKeys(input, "assessSensorCameraSaturationCapacity", ["accumulatedCharge", "saturationProfile", "operatingStateId", "operatingTemperatureC"]);
     const charge = validateCharge(input.accumulatedCharge);
     const profile = parseSensorCameraSaturationCapacityProfile(input.saturationProfile);
     if (profile.colorSamplingProfileId !==

package/dist/sensor/camera-saturation-capacity.js.map

@@ -1 +1 @@
-{"version":3,"file":"camera-saturation-capacity.js","sourceRoot":"","sources":["../../src/sensor/camera-saturation-capacity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"camera-saturation-capacity.js","sourceRoot":"","sources":["../../src/sensor/camera-saturation-capacity.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Camera saturation capacity: checks whether the expected photo signal would exceed the camera's\n * declared saturation limit.\n *\n * Camera saturation capacity is the largest photo signal, in electron equivalents and after dark\n * correction, that the whole camera response chain records before saturating. It is not the\n * physical charge a pixel can store, not the ADC maximum, and does not say which hardware stage\n * limits it. The check compares expected values only; it does not make up codes beyond saturation.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport {\n  approximationResult,\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 { InvalidScientificInputError } from \"../core/validation.js\";\nimport type {\n  SensorPhotoAccumulatedChargeComposition as SensorAccumulatedChargeComposition\n} from \"./accumulated-charge.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 SensorCameraSaturationSiteApplicability =\n  | {\n      kind: \"exact-site\";\n      site: {\n        x: number;\n        y: number;\n      };\n    }\n  | {\n      kind:\n        \"channel-population-mean-approximation\";\n      limitation: string;\n      evidence:\n        readonly EvidenceProvenance[];\n    };\n\nexport type SensorCameraSaturationTemperatureApplicability =\n  | {\n      kind:\n        \"exact-reference-temperature\";\n      temperatureC: number;\n    }\n  | {\n      kind: \"not-modeled\";\n      limitation: string;\n      evidence:\n        readonly EvidenceProvenance[];\n    };\n\nexport interface SensorCameraSaturationCapacityProfile {\n  schemaVersion: \"0.1.0\";\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  capacityMeaning:\n    \"camera-signal-saturation-capacity-electrons\";\n  signalDomain:\n    \"dark-corrected-photo-generated-electron-equivalent\";\n  saturationCapacityElectrons: number;\n  scientificStatus:\n    SensorSpectralResponseScientificStatus;\n  uncertainty:\n    SensorSpectralResponseUncertainty;\n  evidence:\n    readonly EvidenceProvenance[];\n  measurementMethodId: string;\n  measurementMethodEvidence:\n    readonly EvidenceProvenance[];\n  siteApplicability:\n    SensorCameraSaturationSiteApplicability;\n  operatingState: {\n    stateId: string;\n    evidence:\n      readonly EvidenceProvenance[];\n  };\n  temperatureApplicability:\n    SensorCameraSaturationTemperatureApplicability;\n}\n\nexport interface AssessSensorCameraSaturationCapacityInput {\n  accumulatedCharge:\n    SensorAccumulatedChargeComposition;\n  saturationProfile:\n    SensorCameraSaturationCapacityProfile;\n  operatingStateId: string;\n  operatingTemperatureC: number;\n}\n\nexport interface SensorCameraSaturationCapacityAssessment {\n  saturationProfileId: string;\n  completenessProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  operatingStateId: string;\n  operatingTemperatureC: number;\n  capacityMeaning:\n    \"camera-signal-saturation-capacity-electrons\";\n  signalDomain:\n    \"dark-corrected-photo-generated-electron-equivalent\";\n  cameraSignalSaturationCapacityElectrons:\n    number;\n  expectedPhotoSignalElectronCount:\n    number;\n  totalExpectedStoredElectronCountDiagnostic:\n    number;\n  totalStoredChargeUsedForCameraSaturationComparison:\n    false;\n  expectedSignalToCameraSaturationRatio:\n    number;\n  expectedSignalHeadroomElectrons:\n    number;\n  expectedCameraSignalCapacityStatus:\n    | \"below-capacity\"\n    | \"at-capacity\"\n    | \"above-capacity\";\n  expectedPhotoSignalExceedsCameraCapacity:\n    boolean;\n  cameraSaturationCapacityAssessmentPerformed:\n    true;\n  assessmentMeaning:\n    \"expected-dark-corrected-photo-signal-vs-camera-saturation-capacity\";\n  physicalChargeCapacityUsed:\n    false;\n  limitingSaturationMechanismResolved:\n    false;\n  analogClippingThresholdModeled:\n    false;\n  digitalClippingThresholdModeled:\n    false;\n  adcMaximumCodeUsed:\n    false;\n  actualStochasticSaturationStateKnown:\n    false;\n  stochasticSaturationProbabilityAssessed:\n    false;\n  outputSignalAfterSaturationCalculated:\n    false;\n  clampApplied: false;\n  physicalStoredChargeModified:\n    false;\n  adcQuantizationApplied: false;\n  rawCodeValueProduced: false;\n  saturationCapacityUncertaintyPropagated:\n    false;\n  photoSignalUncertaintyPropagated:\n    false;\n  componentEvidence: {\n    saturationCapacity:\n      readonly EvidenceProvenance[];\n    measurementMethod:\n      readonly EvidenceProvenance[];\n    operatingState:\n      readonly EvidenceProvenance[];\n    siteApproximation:\n      readonly EvidenceProvenance[];\n    temperatureApproximation:\n      readonly EvidenceProvenance[];\n    chargeCompleteness:\n      SensorAccumulatedChargeComposition[\"componentEvidence\"][\"completeness\"];\n  };\n}\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 requirePositiveFinite(\n  value: unknown,\n  path: string\n): number {\n  const parsed = requireFinite(\n    value,\n    path\n  );\n  if (parsed <= 0) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be greater than zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction requireNonNegativeFiniteInput(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value < 0\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be finite and greater than or equal to zero.\"\n    );\n  }\n  return value;\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 = requireRecord(\n    value,\n    path, null\n  );\n  rejectUnknownVariantFields(record, \"kind\", UNCERTAINTY_VARIANT_FIELDS, path);\n  if (record.kind === \"relative\") {\n    const fraction = requireFinite(\n      record.fraction,\n      path + \".fraction\"\n    );\n    if (fraction < 0) {\n      throw new InvalidConfigurationError(\n        path +\n          \".fraction must be nonnegative.\"\n      );\n    }\n    return {\n      kind: \"relative\",\n      fraction,\n      basis: requireNonEmptyString(\n        record.basis,\n        path + \".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  throw new InvalidConfigurationError(\n    path + \".kind is invalid.\"\n  );\n}\n\nfunction parseSiteApplicability(\n  value: unknown\n): SensorCameraSaturationSiteApplicability {\n  const record = requireRecord(\n    value,\n    \"sensorCameraSaturation.siteApplicability\", null\n  );\n  rejectUnknownVariantFields(record, \"kind\", { \"exact-site\": [\"kind\", \"site\"], \"channel-population-mean-approximation\": [\"kind\", \"limitation\", \"evidence\"] }, \"sensorCameraSaturation.siteApplicability\");\n  if (record.kind === \"exact-site\") {\n    const site = requireRecord(\n      record.site,\n      \"sensorCameraSaturation.siteApplicability.site\", [\"x\", \"y\"]\n    );\n    return {\n      kind: \"exact-site\",\n      site: {\n        x: requireSiteIndex(\n          site.x,\n          \"sensorCameraSaturation.siteApplicability.site.x\"\n        ),\n        y: requireSiteIndex(\n          site.y,\n          \"sensorCameraSaturation.siteApplicability.site.y\"\n        )\n      }\n    };\n  }\n  if (\n    record.kind ===\n      \"channel-population-mean-approximation\"\n  ) {\n    return {\n      kind:\n        \"channel-population-mean-approximation\",\n      limitation:\n        requireNonEmptyString(\n          record.limitation,\n          \"sensorCameraSaturation.siteApplicability.limitation\"\n        ),\n      evidence: parseEvidenceList(\n        record.evidence,\n        \"sensorCameraSaturation.siteApplicability.evidence\"\n      )\n    };\n  }\n  throw new InvalidConfigurationError(\n    \"sensorCameraSaturation.siteApplicability.kind is invalid.\"\n  );\n}\n\nfunction parseTemperatureApplicability(\n  value: unknown\n): SensorCameraSaturationTemperatureApplicability {\n  const record = requireRecord(\n    value,\n    \"sensorCameraSaturation.temperatureApplicability\", null\n  );\n  rejectUnknownVariantFields(record, \"kind\", { \"exact-reference-temperature\": [\"kind\", \"temperatureC\"], \"not-modeled\": [\"kind\", \"limitation\", \"evidence\"] }, \"sensorCameraSaturation.temperatureApplicability\");\n  if (\n    record.kind ===\n      \"exact-reference-temperature\"\n  ) {\n    return {\n      kind:\n        \"exact-reference-temperature\",\n      temperatureC:\n        requireFinite(\n          record.temperatureC,\n          \"sensorCameraSaturation.temperatureApplicability.temperatureC\"\n        )\n    };\n  }\n  if (record.kind === \"not-modeled\") {\n    return {\n      kind: \"not-modeled\",\n      limitation:\n        requireNonEmptyString(\n          record.limitation,\n          \"sensorCameraSaturation.temperatureApplicability.limitation\"\n        ),\n      evidence: parseEvidenceList(\n        record.evidence,\n        \"sensorCameraSaturation.temperatureApplicability.evidence\"\n      )\n    };\n  }\n  throw new InvalidConfigurationError(\n    \"sensorCameraSaturation.temperatureApplicability.kind is invalid.\"\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 * Camera saturation capacity is a limit on the dark-corrected photo signal, in electron\n * equivalents. It is not the physical charge storage capacity or the ADC maximum, and does not\n * identify which hardware stage limits it.\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 parseSensorCameraSaturationCapacityProfile(\n  value: unknown\n): SensorCameraSaturationCapacityProfile {\n  const record = requireRecord(\n    value,\n    \"sensorCameraSaturation\", [\"schemaVersion\", \"capacityMeaning\", \"signalDomain\", \"scientificStatus\", \"uncertainty\", \"siteApplicability\", \"temperatureApplicability\", \"operatingState\", \"profileId\", \"colorSamplingProfileId\", \"channelId\", \"saturationCapacityElectrons\", \"evidence\", \"measurementMethodId\", \"measurementMethodEvidence\"]\n  );\n\n  if (\n    record.schemaVersion !== \"0.1.0\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorCameraSaturation.schemaVersion must be \"0.1.0\".'\n    );\n  }\n  if (\n    record.capacityMeaning !==\n      \"camera-signal-saturation-capacity-electrons\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorCameraSaturation.capacityMeaning is invalid.\"\n    );\n  }\n  if (\n    record.signalDomain !==\n      \"dark-corrected-photo-generated-electron-equivalent\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorCameraSaturation.signalDomain is invalid.\"\n    );\n  }\n  if (\n    record.scientificStatus !==\n      \"calibrated\" &&\n    record.scientificStatus !==\n      \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorCameraSaturation.scientificStatus is invalid.\"\n    );\n  }\n\n  const uncertainty =\n    parseUncertainty(\n      record.uncertainty,\n      \"sensorCameraSaturation.uncertainty\"\n    );\n  if (\n    record.scientificStatus ===\n      \"calibrated\" &&\n    uncertainty.kind ===\n      \"not-quantified\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"A calibrated camera saturation-capacity profile must declare quantified relative uncertainty.\"\n    );\n  }\n\n  const siteApplicability =\n    parseSiteApplicability(\n      record.siteApplicability\n    );\n  const temperatureApplicability =\n    parseTemperatureApplicability(\n      record.temperatureApplicability\n    );\n\n  if (\n    siteApplicability.kind ===\n      \"channel-population-mean-approximation\" &&\n    record.scientificStatus !==\n      \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"A channel-population mean camera saturation capacity must remain an approximation when applied to one site.\"\n    );\n  }\n  if (\n    temperatureApplicability.kind ===\n      \"not-modeled\" &&\n    record.scientificStatus !==\n      \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"A camera saturation capacity with unmodeled temperature dependence must remain an approximation.\"\n    );\n  }\n\n  const state = requireRecord(\n    record.operatingState,\n    \"sensorCameraSaturation.operatingState\", [\"stateId\", \"evidence\"]\n  );\n\n  return {\n    schemaVersion: \"0.1.0\",\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"sensorCameraSaturation.profileId\"\n      ),\n    colorSamplingProfileId:\n      requireNonEmptyString(\n        record.colorSamplingProfileId,\n        \"sensorCameraSaturation.colorSamplingProfileId\"\n      ),\n    channelId:\n      requireNonEmptyString(\n        record.channelId,\n        \"sensorCameraSaturation.channelId\"\n      ),\n    capacityMeaning:\n      \"camera-signal-saturation-capacity-electrons\",\n    signalDomain:\n      \"dark-corrected-photo-generated-electron-equivalent\",\n    saturationCapacityElectrons:\n      requirePositiveFinite(\n        record.saturationCapacityElectrons,\n        \"sensorCameraSaturation.saturationCapacityElectrons\"\n      ),\n    scientificStatus:\n      record.scientificStatus,\n    uncertainty,\n    evidence: parseEvidenceList(\n      record.evidence,\n      \"sensorCameraSaturation.evidence\"\n    ),\n    measurementMethodId:\n      requireNonEmptyString(\n        record.measurementMethodId,\n        \"sensorCameraSaturation.measurementMethodId\"\n      ),\n    measurementMethodEvidence:\n      parseEvidenceList(\n        record.measurementMethodEvidence,\n        \"sensorCameraSaturation.measurementMethodEvidence\"\n      ),\n    siteApplicability,\n    operatingState: {\n      stateId:\n        requireNonEmptyString(\n          state.stateId,\n          \"sensorCameraSaturation.operatingState.stateId\"\n        ),\n      evidence: parseEvidenceList(\n        state.evidence,\n        \"sensorCameraSaturation.operatingState.evidence\"\n      )\n    },\n    temperatureApplicability\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 validateCharge(\n  charge:\n    SensorAccumulatedChargeComposition\n): {\n  photo: number;\n  total: number;\n} {\n  requireInputObject(charge, \"charge input\");\n  if (\n    charge.accumulatedChargeCompleteness !==\n      \"complete-for-physical-storage-capacity-assessment\" ||\n    charge.saturationAssessed !==\n      false ||\n    charge.adcQuantizationApplied !==\n      false ||\n    charge.rawCodeValueProduced !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Camera saturation assessment requires an unmodified pre-saturation accumulated-charge composition.\"\n    );\n  }\n\n  return {\n    photo: requireNonNegativeFiniteInput(\n      charge.photoExpectedElectronCount,\n      \"accumulatedCharge.photoExpectedElectronCount\"\n    ),\n    total: requireNonNegativeFiniteInput(\n      charge.totalExpectedStoredElectronCount,\n      \"accumulatedCharge.totalExpectedStoredElectronCount\"\n    )\n  };\n}\n\n/**\n * Compares the expected photo signal (dark-corrected) with the camera's declared saturation\n * capacity. Dark charge is not added, and no hardware clamp is identified.\n *\n * This compares expected values only. It does not make up codes beyond saturation.\n * @param input - The input; see `AssessSensorCameraSaturationCapacityInput` for its fields, units and coordinates.\n * @returns The assessment. Read its structured blockers before acting on an authorization.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function assessSensorCameraSaturationCapacity(\n  input:\n    AssessSensorCameraSaturationCapacityInput\n): CalculationResult<SensorCameraSaturationCapacityAssessment> {\n  requireInputKeys(input, \"assessSensorCameraSaturationCapacity\", [\"accumulatedCharge\", \"saturationProfile\", \"operatingStateId\", \"operatingTemperatureC\"]);\n  const charge =\n    validateCharge(\n      input.accumulatedCharge\n    );\n  const profile =\n    parseSensorCameraSaturationCapacityProfile(\n      input.saturationProfile\n    );\n\n  if (\n    profile.colorSamplingProfileId !==\n      input.accumulatedCharge\n        .colorSamplingProfileId ||\n    profile.channelId !==\n      input.accumulatedCharge.channelId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Camera saturation-capacity profile color/channel identity must match the accumulated charge.\"\n    );\n  }\n  if (\n    profile.siteApplicability.kind ===\n      \"exact-site\" &&\n    !sameSite(\n      profile.siteApplicability.site,\n      input.accumulatedCharge.site\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Exact-site camera saturation capacity does not apply to the accumulated-charge site.\"\n    );\n  }\n  if (\n    typeof input.operatingStateId !==\n      \"string\" ||\n    input.operatingStateId.trim().length ===\n      0 ||\n    input.operatingStateId !==\n      profile.operatingState.stateId\n  ) {\n    throw new InvalidScientificInputError(\n      \"operatingStateId must exactly match the camera saturation-capacity calibration state.\"\n    );\n  }\n  if (\n    typeof input.operatingTemperatureC !==\n      \"number\" ||\n    !Number.isFinite(\n      input.operatingTemperatureC\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"operatingTemperatureC must be finite.\"\n    );\n  }\n  if (\n    profile.temperatureApplicability.kind ===\n      \"exact-reference-temperature\" &&\n    input.operatingTemperatureC !==\n      profile.temperatureApplicability\n        .temperatureC\n  ) {\n    throw new InvalidScientificInputError(\n      \"operatingTemperatureC must exactly match the camera saturation-capacity reference temperature.\"\n    );\n  }\n\n  const capacity =\n    profile.saturationCapacityElectrons;\n  const ratio =\n    charge.photo / capacity;\n  const headroom =\n    capacity - charge.photo;\n\n  if (\n    !Number.isFinite(ratio) ||\n    !Number.isFinite(headroom)\n  ) {\n    throw new InvalidScientificInputError(\n      \"Camera saturation-capacity comparison must remain finite.\"\n    );\n  }\n\n  const status =\n    charge.photo < capacity\n      ? \"below-capacity\"\n      : charge.photo === capacity\n        ? \"at-capacity\"\n        : \"above-capacity\";\n\n  return approximationResult(\n    {\n      saturationProfileId:\n        profile.profileId,\n      completenessProfileId:\n        input.accumulatedCharge\n          .completenessProfileId,\n      colorSamplingProfileId:\n        input.accumulatedCharge\n          .colorSamplingProfileId,\n      channelId:\n        input.accumulatedCharge.channelId,\n      site: {\n        ...input.accumulatedCharge.site\n      },\n      bindingId:\n        input.accumulatedCharge.bindingId,\n      operatingStateId:\n        input.operatingStateId,\n      operatingTemperatureC:\n        input.operatingTemperatureC,\n      capacityMeaning:\n        \"camera-signal-saturation-capacity-electrons\",\n      signalDomain:\n        \"dark-corrected-photo-generated-electron-equivalent\",\n      cameraSignalSaturationCapacityElectrons:\n        capacity,\n      expectedPhotoSignalElectronCount:\n        charge.photo,\n      totalExpectedStoredElectronCountDiagnostic:\n        charge.total,\n      totalStoredChargeUsedForCameraSaturationComparison:\n        false,\n      expectedSignalToCameraSaturationRatio:\n        ratio,\n      expectedSignalHeadroomElectrons:\n        headroom,\n      expectedCameraSignalCapacityStatus:\n        status,\n      expectedPhotoSignalExceedsCameraCapacity:\n        status === \"above-capacity\",\n      cameraSaturationCapacityAssessmentPerformed:\n        true,\n      assessmentMeaning:\n        \"expected-dark-corrected-photo-signal-vs-camera-saturation-capacity\",\n      physicalChargeCapacityUsed: false,\n      limitingSaturationMechanismResolved:\n        false,\n      analogClippingThresholdModeled:\n        false,\n      digitalClippingThresholdModeled:\n        false,\n      adcMaximumCodeUsed: false,\n      actualStochasticSaturationStateKnown:\n        false,\n      stochasticSaturationProbabilityAssessed:\n        false,\n      outputSignalAfterSaturationCalculated:\n        false,\n      clampApplied: false,\n      physicalStoredChargeModified:\n        false,\n      adcQuantizationApplied: false,\n      rawCodeValueProduced: false,\n      saturationCapacityUncertaintyPropagated:\n        false,\n      photoSignalUncertaintyPropagated:\n        false,\n      componentEvidence: {\n        saturationCapacity:\n          profile.evidence,\n        measurementMethod:\n          profile\n            .measurementMethodEvidence,\n        operatingState:\n          profile.operatingState\n            .evidence,\n        siteApproximation:\n          profile.siteApplicability.kind ===\n            \"channel-population-mean-approximation\"\n            ? profile\n                .siteApplicability\n                .evidence\n            : [],\n        temperatureApproximation:\n          profile.temperatureApplicability.kind ===\n            \"not-modeled\"\n            ? profile\n                .temperatureApplicability\n                .evidence\n            : [],\n        chargeCompleteness:\n          input.accumulatedCharge\n            .componentEvidence\n            .completeness\n      }\n    },\n    \"sensor-camera-saturation-capacity-assessment\",\n    \"1.0.0\",\n    [\n      \"The camera saturation capacity is a measured/calibrated dark-corrected photo-signal capacity in electron-equivalent signal units; total stored charge is deliberately not used for this comparison.\",\n      \"Physical charge-storage capacity is a separate sensor property and is not used by this assessment.\",\n      \"The camera saturation capacity may be limited by a downstream camera stage before physical pixel storage is full; this contract does not infer which analog or digital stage is limiting.\",\n      \"The operating-state identifier is an exact calibration-state key covering the source-specific camera/readout configuration; Photivra does not infer equivalence from ISO, gain or bit-depth labels.\",\n      \"A channel-population mean applied to one site or unmodeled temperature dependence remains an explicit approximation.\",\n      \"Expected photo signal below the measured capacity does not establish the actual stochastic saturation state; no saturation probability is calculated.\",\n      \"No signal clamp, analog clipping transfer, ADC maximum code, RAW code or post-saturation output is calculated.\",\n      \"Dark and other stored charge remain diagnostics for physical storage accounting and are not silently added to a dark-corrected camera-signal capacity.\",\n      \"Capacity and photo-signal uncertainties are not propagated into a saturation probability or confidence interval by this version.\"\n    ]\n  );\n}\n"]}

package/dist/sensor/capture-color-sampling-binding.d.ts

@@ -7,34 +7,35 @@ export interface NativeEffectiveRasterColorSamplingBindingProfile {
     bindingId: string;
     colorSamplingProfileId: string;
     /**
-     * Exact canonical native effective raster this binding was evidenced for.
-     * The binding must not be reused against a different raster merely because
-     * another sensor/mode has similar dimensions or a matching aspect ratio.
+     * The exact native image grid this binding has evidence for. Do not reuse
+     * the binding with another grid just because another sensor or mode has
+     * similar dimensions or the same aspect ratio.
      */
     nativeRaster: NativeImageRaster;
     /**
-     * Evidence supporting the native-effective-grid ↔ color-site-grid
-     * relationship itself.
+     * Evidence for the link between the native image grid and the colour-site
+     * grid itself.
      *
-     * Capture-mode and color-topology facts retain separate provenance.
+     * Capture-mode and colour-layout facts keep their own separate evidence.
      */
     evidence: readonly EvidenceProvenance[];
     relationship: {
         kind: "regular-native-effective-sample-blocks";
         /**
-         * Number of abstract color-sampling sites spanned horizontally by one
-         * native effective image sample.
+         * Number of colour-sampling sites one native image sample spans
+         * horizontally.
          */
         sitesPerNativeSampleX: number;
         /**
-         * Number of abstract color-sampling sites spanned vertically by one
-         * native effective image sample.
+         * Number of colour-sampling sites one native image sample spans
+         * vertically.
          */
         sitesPerNativeSampleY: number;
         /**
-         * Both grids are anchored to the same native sensor top-left.
+         * Both grids start at the same native sensor top-left corner.
          *
-         * This keeps phase absolute across later active crops/orientation.
+         * This keeps the CFA phase absolute through later active-area crops and
+         * orientation changes.
          */
         anchor: "shared-native-top-left";
     };
@@ -79,9 +80,9 @@ export interface ColorSamplingSiteRect {
 }
 export interface CaptureModeFullFrameSampleIndex {
     /**
-     * Zero-based index in the selected mode's full-frame per-frame effective
-     * sampling raster. Crop-local coordinates must be translated to absolute
-     * full-frame mode indices before calling this API.
+     * Zero-based index in the selected mode's full-frame sample grid (per frame).
+     * Convert crop-relative coordinates to absolute full-frame indices before
+     * calling this API.
      */
     x: number;
     y: number;
@@ -109,8 +110,8 @@ export interface ResolveCaptureModeColorSamplingContributorsInput {
     bindingProfile: NativeEffectiveRasterColorSamplingBindingProfile;
     modeSampleIndexFullFrame: CaptureModeFullFrameSampleIndex;
     /**
-     * Required for grouped-native-samples modes because #68 declares grouping
-     * factors but does not itself prove the grouping phase/origin.
+     * Required for modes that group native samples, because the capture-mode
+     * profile declares grouping factors but does not prove where the groups start.
      */
     groupedSamplingAnchor?: GroupedCaptureModeSamplingAnchorDeclaration;
 }
@@ -131,8 +132,8 @@ export interface ResolvedCaptureModeColorSamplingContributors {
     channelSiteCounts: readonly ColorSamplingChannelSiteCount[];
     channelComposition: ColorSamplingChannelComposition;
     /**
-     * Present only when the selected capture mode groups native effective
-     * samples before producing one per-frame effective sample.
+     * Present only when the selected capture mode groups several native samples
+     * into one sample per frame.
      */
     grouping: {
         groupWidthSamples: SourcedCaptureModeFact<number>;
@@ -142,10 +143,10 @@ export interface ResolvedCaptureModeColorSamplingContributors {
         anchorEvidence: readonly EvidenceProvenance[];
     } | null;
     /**
-     * Sensor-shift sequence remains attached to the sensor/capture mode.
+     * The sensor-shift sequence stays attached to the sensor and capture mode.
      *
-     * The sensor and its CFA move together, so these offsets must not be applied
-     * as changes to color-site channel assignment.
+     * The sensor and its CFA move together, so these offsets must not change
+     * which colour channel a site belongs to.
      */
     interFrameSensorOffsetsNativeSamples?: SourcedCaptureModeFact<readonly CaptureModeSensorOffsetNativeSamples[]>;
     sensorShiftChangesColorSiteAssignment: false;
@@ -163,21 +164,20 @@ export interface ResolvedCaptureModeColorSamplingContributors {
     };
 }
 /**
- * Parses the explicit relationship between the canonical native effective image
- * raster and the separate native sensor color-sampling-site lattice.
+ * Parses the explicit link between the native image pixel grid and the separate
+ * grid of colour-sampling sites.
  *
- * This first binding supports only regular rectangular site blocks with a
- * shared native top-left anchor. Irregular mappings, sparse exceptions and
- * mode-specific declared-effective rasters require later explicit contracts.
+ * This first version supports only regular rectangular blocks of sites that
+ * share the native top-left corner. Irregular mappings, sparse exceptions and
+ * mode-specific declared grids would need new, explicit contracts.
  */
 export declare function parseNativeEffectiveRasterColorSamplingBindingProfile(value: unknown): NativeEffectiveRasterColorSamplingBindingProfile;
 /**
- * Validates and resolves the sensor-level binding between NativeImageRaster and
- * an exact monochrome/periodic color-sampling topology.
+ * Validates and resolves the link between NativeImageRaster and an exact colour
+ * sampling layout (monochrome or a repeating pattern such as a CFA).
  *
- * Matching dimensions are never treated as proof of a 1:1 relationship. The
- * relationship exists only because the caller supplied this evidence-backed
- * binding profile.
+ * Matching dimensions are never taken as proof of a one-to-one link. The link
+ * exists only because the caller supplied this evidence-backed binding profile.
  */
 export declare function resolveNativeEffectiveRasterColorSamplingBinding(input: {
     nativeRaster: NativeImageRaster;
@@ -185,28 +185,23 @@ export declare function resolveNativeEffectiveRasterColorSamplingBinding(input:
     bindingProfile: NativeEffectiveRasterColorSamplingBindingProfile;
 }): ResolvedNativeEffectiveRasterColorSamplingBinding;
 /**
- * Resolves which color-sampling sites form the pre-reconstruction structural source region for one selected
- * capture-mode effective sample.
+ * Finds which colour-sampling sites lie under one capture-mode sample, before any
+ * reconstruction (demosaicing).
  *
- * The mode sample index is always absolute in the selected mode's full-frame
- * per-frame raster. The API intentionally does not accept crop-local indices,
- * preventing active-crop origins from silently resetting CFA phase.
+ * The sample index is always absolute in the selected mode's full-frame grid. Crop-relative
+ * indices are not accepted, so an active-area crop can never silently reset the CFA phase.
  *
- * For grouped-native-sample modes, the returned site rectangle covers all
- * native effective samples in the declared regular group. This is a structural
- * pre-reconstruction association only: the engine reports channel-site counts
- * but never claims complete downstream digital-pixel dependency or invents
- * signal-combination weights, sum/average semantics, spectral response, or
- * photon/electron values.
+ * For modes that group native samples, the returned rectangle covers every native sample in
+ * the declared regular group. This only describes which sites lie under the sample. The engine
+ * reports how many sites of each channel there are, but does not claim this is every dependency
+ * of the final digital pixel. It never makes up combination weights, sum or average rules,
+ * spectral response, or photon or electron values.
  *
- * Declared-effective-raster modes fail closed because #68 explicitly says
- * their relationship to the native effective grid is not safely expressible as
- * simple integer grouping.
+ * Modes with a declared sample grid are rejected, because the capture-mode profile says their
+ * relationship to the native grid cannot safely be written as simple integer grouping.
  *
- * Inter-frame sensor shifts are preserved as capture-mode metadata only. The
- * sensor and CFA move together, so those offsets do not change site channel
- * assignment; their optical-registration effect belongs to a later spatial
- * sampling/image-formation contract.
+ * Sensor shifts between frames are kept as capture-mode metadata only. The sensor and CFA move
+ * together, so the shifts do not change which channel a site belongs to. Their effect on optical
+ * registration belongs to a later spatial-sampling or image-formation model.
  */
 export declare function resolveCaptureModeColorSamplingContributors(input: ResolveCaptureModeColorSamplingContributorsInput): ResolvedCaptureModeColorSamplingContributors;
-//# sourceMappingURL=capture-color-sampling-binding.d.ts.map

package/dist/sensor/capture-color-sampling-binding.js

@@ -1,14 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Parses the explicit relationship between the canonical native effective image raster and the
- * separate native sensor color-sampling-site lattice. This first binding supports only regular
- * rectangular site blocks with a shared native top-left anchor. Irregular mappings, sparse exceptions
- * and mode-specific declared-effective rasters require later explicit contracts.
- * Validates and resolves the sensor-level binding between NativeImageRaster and an exact
- * monochrome/periodic color-sampling topology. Matching dimensions are never treated as proof of a 1:1
- * relationship. The relationship exists only because the caller supplied this evidence-backed binding
- * profile.
+ * Links the sensor's native image pixel grid to its grid of colour-sampling sites (for example the
+ * cells of a CFA, colour filter array), and finds which sites feed each capture-mode sample.
+ *
+ * The link exists only because the caller supplies an evidence-backed binding. Matching grid sizes
+ * are never taken as proof of a one-to-one link. This first version supports only regular
+ * rectangular blocks of sites that share the native top-left corner.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -17,12 +14,15 @@ import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError, requirePositiveInteger } from "../core/validation.js";
 import { resolveCaptureMode } from "./capture-mode.js";
 import { parseSensorColorSamplingProfile } from "./color-sampling.js";
-function requireRecord(value, path) {
+import { requireInputObject, requireInputKeys, rejectUnknownFields } 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) {
@@ -41,7 +41,7 @@ function requirePositiveSafeInteger(value, path) {
     return value;
 }
 function parseBoundNativeRaster(value) {
-    const nativeRaster = requireRecord(value, "colorSamplingBinding.nativeRaster");
+    const nativeRaster = requireRecord(value, "colorSamplingBinding.nativeRaster", ["pixelWidth", "pixelHeight"]);
     const pixelWidth = requirePositiveSafeInteger(nativeRaster.pixelWidth, "colorSamplingBinding.nativeRaster.pixelWidth");
     const pixelHeight = requirePositiveSafeInteger(nativeRaster.pixelHeight, "colorSamplingBinding.nativeRaster.pixelHeight");
     if (!Number.isSafeInteger(pixelWidth * pixelHeight)) {
@@ -63,6 +63,7 @@ function safeProduct(values, path) {
     return result;
 }
 function validateNativeRaster(raster) {
+    requireInputObject(raster, "raster input");
     requirePositiveInteger("nativeRaster.pixelWidth", raster.pixelWidth);
     requirePositiveInteger("nativeRaster.pixelHeight", raster.pixelHeight);
     safeProduct([raster.pixelWidth, raster.pixelHeight], "nativeRaster total image-sample count");
@@ -77,19 +78,19 @@ function requireFullFrameSampleIndex(value, path) {
     return value;
 }
 /**
- * Parses the explicit relationship between the canonical native effective image
- * raster and the separate native sensor color-sampling-site lattice.
+ * Parses the explicit link between the native image pixel grid and the separate
+ * grid of colour-sampling sites.
  *
- * This first binding supports only regular rectangular site blocks with a
- * shared native top-left anchor. Irregular mappings, sparse exceptions and
- * mode-specific declared-effective rasters require later explicit contracts.
+ * This first version supports only regular rectangular blocks of sites that
+ * share the native top-left corner. Irregular mappings, sparse exceptions and
+ * mode-specific declared grids would need new, explicit contracts.
  */
 export function parseNativeEffectiveRasterColorSamplingBindingProfile(value) {
-    const profile = requireRecord(value, "colorSamplingBinding");
+    const profile = requireRecord(value, "colorSamplingBinding", ["schemaVersion", "relationship", "bindingId", "colorSamplingProfileId", "nativeRaster", "evidence"]);
     if (profile.schemaVersion !== "0.1.0") {
         throw new InvalidConfigurationError('colorSamplingBinding.schemaVersion must be "0.1.0".');
     }
-    const relationship = requireRecord(profile.relationship, "colorSamplingBinding.relationship");
+    const relationship = requireRecord(profile.relationship, "colorSamplingBinding.relationship", ["kind", "anchor", "sitesPerNativeSampleX", "sitesPerNativeSampleY"]);
     if (relationship.kind !==
         "regular-native-effective-sample-blocks") {
         throw new InvalidConfigurationError("colorSamplingBinding.relationship.kind is invalid.");
@@ -113,14 +114,14 @@ export function parseNativeEffectiveRasterColorSamplingBindingProfile(value) {
     };
 }
 /**
- * Validates and resolves the sensor-level binding between NativeImageRaster and
- * an exact monochrome/periodic color-sampling topology.
+ * Validates and resolves the link between NativeImageRaster and an exact colour
+ * sampling layout (monochrome or a repeating pattern such as a CFA).
  *
- * Matching dimensions are never treated as proof of a 1:1 relationship. The
- * relationship exists only because the caller supplied this evidence-backed
- * binding profile.
+ * Matching dimensions are never taken as proof of a one-to-one link. The link
+ * exists only because the caller supplied this evidence-backed binding profile.
  */
 export function resolveNativeEffectiveRasterColorSamplingBinding(input) {
+    requireInputKeys(input, "resolveNativeEffectiveRasterColorSamplingBinding", ["nativeRaster", "colorSamplingProfile", "bindingProfile"]);
     validateNativeRaster(input.nativeRaster);
     const colorSamplingProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
     const bindingProfile = parseNativeEffectiveRasterColorSamplingBindingProfile(input.bindingProfile);
@@ -244,30 +245,27 @@ function channelCountsForSiteRect(profile, rect) {
     return result;
 }
 /**
- * Resolves which color-sampling sites form the pre-reconstruction structural source region for one selected
- * capture-mode effective sample.
+ * Finds which colour-sampling sites lie under one capture-mode sample, before any
+ * reconstruction (demosaicing).
  *
- * The mode sample index is always absolute in the selected mode's full-frame
- * per-frame raster. The API intentionally does not accept crop-local indices,
- * preventing active-crop origins from silently resetting CFA phase.
+ * The sample index is always absolute in the selected mode's full-frame grid. Crop-relative
+ * indices are not accepted, so an active-area crop can never silently reset the CFA phase.
  *
- * For grouped-native-sample modes, the returned site rectangle covers all
- * native effective samples in the declared regular group. This is a structural
- * pre-reconstruction association only: the engine reports channel-site counts
- * but never claims complete downstream digital-pixel dependency or invents
- * signal-combination weights, sum/average semantics, spectral response, or
- * photon/electron values.
+ * For modes that group native samples, the returned rectangle covers every native sample in
+ * the declared regular group. This only describes which sites lie under the sample. The engine
+ * reports how many sites of each channel there are, but does not claim this is every dependency
+ * of the final digital pixel. It never makes up combination weights, sum or average rules,
+ * spectral response, or photon or electron values.
  *
- * Declared-effective-raster modes fail closed because #68 explicitly says
- * their relationship to the native effective grid is not safely expressible as
- * simple integer grouping.
+ * Modes with a declared sample grid are rejected, because the capture-mode profile says their
+ * relationship to the native grid cannot safely be written as simple integer grouping.
  *
- * Inter-frame sensor shifts are preserved as capture-mode metadata only. The
- * sensor and CFA move together, so those offsets do not change site channel
- * assignment; their optical-registration effect belongs to a later spatial
- * sampling/image-formation contract.
+ * Sensor shifts between frames are kept as capture-mode metadata only. The sensor and CFA move
+ * together, so the shifts do not change which channel a site belongs to. Their effect on optical
+ * registration belongs to a later spatial-sampling or image-formation model.
  */
 export function resolveCaptureModeColorSamplingContributors(input) {
+    requireInputKeys(input, "resolveCaptureModeColorSamplingContributors", ["nativeRaster", "captureModeProfile", "modeId", "colorSamplingProfile", "bindingProfile", "modeSampleIndexFullFrame", "groupedSamplingAnchor"]);
     const colorSamplingProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
     const binding = resolveNativeEffectiveRasterColorSamplingBinding({
         nativeRaster: input.nativeRaster,