@photivra/engine 1.5.0 → 2.0.0

package/dist/sensor/accumulated-charge.js

@@ -1,18 +1,14 @@
 // 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. Photo, dark and
- * explicitly incremental stored-electron components must share the exact site/channel/local shutter
- * event. Completeness is an evidence-backed declaration, not the consequence of an empty component
- * array. Expected stored charge remains distinct from a stochastic realization or nonlinear full-well
- * clamp.
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary. Photo, dark and
- * explicitly incremental stored-electron components must share the exact site/channel/local shutter
- * event. Completeness is an evidence-backed declaration, not the consequence of an empty component
- * array. Expected stored charge remains distinct from a stochastic realization or nonlinear full-well
- * clamp.
+ * Accumulated charge: adds up the expected electrons stored in one sensor site during one exposure.
+ *
+ * The parts are photo charge (from light), dark charge (from dark current) and any other stored
+ * charge declared explicitly as an addition. All parts must belong to the exact same site, colour
+ * channel and local shutter event. Whether the list of parts is complete is a declaration backed by
+ * evidence; an empty list does not mean "complete".
+ *
+ * The result is the expected (mean) charge. It is separate from a random (noise) realization and from
+ * the non-linear full-well clamp, which later steps apply.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -21,6 +17,7 @@ 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";
+import { requireInputObject, requireInputKeys, rejectUnknownFields, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS } from "../core/record-validation.js";
 function addCompensated(state, value) {
     const adjusted = value - state.correction;
     const next = state.sum + adjusted;
@@ -28,12 +25,14 @@ function addCompensated(state, value) {
         (next - state.sum) - adjusted;
     state.sum = next;
 }
-function requireRecord(value, path) {
+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) {
@@ -68,7 +67,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");
         return {
@@ -114,20 +114,16 @@ function parseWindowIdentity(record, path) {
     };
 }
 /**
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary.
- *
- * Photo, dark and explicitly incremental stored-electron components must share the exact
- * site/channel/local shutter event. Completeness is an evidence-backed declaration, not the
- * consequence of an empty component array. Expected stored charge remains distinct from a stochastic
- * realization or nonlinear full-well clamp.
- * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
- * @returns SensorAdditionalStoredChargeComponent. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Validates an untrusted additional stored-charge component (charge other than photo and dark
+ * charge, declared explicitly as an addition) and returns it normalized. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
+ * @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 parseSensorAdditionalStoredChargeComponent(value) {
-    const record = requireRecord(value, "sensorAdditionalStoredCharge");
+    const record = requireRecord(value, "sensorAdditionalStoredCharge", ["kind", "accountingMeaning", "site", "timeReference", "startOffsetSecondsFromOpeningReference", "endOffsetSecondsFromOpeningReference", "bindingId", "scientificStatus", "uncertainty", "componentId", "colorSamplingProfileId", "channelId", "expectedElectronCount", "evidence"]);
     const kinds = new Set([
         "hot-pixel-defect-excess",
         "leakage",
@@ -143,7 +139,7 @@ export function parseSensorAdditionalStoredChargeComponent(value) {
         "incremental-stored-electrons-beyond-photo-and-modeled-dark-current") {
         throw new InvalidConfigurationError("sensorAdditionalStoredCharge.accountingMeaning is invalid.");
     }
-    const site = requireRecord(record.site, "sensorAdditionalStoredCharge.site");
+    const site = requireRecord(record.site, "sensorAdditionalStoredCharge.site", ["x", "y"]);
     const window = parseWindowIdentity(record, "sensorAdditionalStoredCharge");
     const scientificStatus = parseStatus(record.scientificStatus, "sensorAdditionalStoredCharge.scientificStatus");
     const uncertainty = parseUncertainty(record.uncertainty, "sensorAdditionalStoredCharge.uncertainty");
@@ -173,20 +169,18 @@ export function parseSensorAdditionalStoredChargeComponent(value) {
     };
 }
 /**
- * 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 an untrusted completeness profile and returns it normalized. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
  *
- * Photo, dark and explicitly incremental stored-electron components must share the exact
- * site/channel/local shutter event. Completeness is an evidence-backed declaration, not the
- * consequence of an empty component array. Expected stored charge remains distinct from a stochastic
- * realization or nonlinear full-well clamp.
- * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
- * @returns SensorAccumulatedChargeCompletenessProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Completeness is a declaration backed by evidence. An empty list of components does not
+ * mean the charge accounting is complete.
+ * @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 parseSensorAccumulatedChargeCompletenessProfile(value) {
-    const record = requireRecord(value, "sensorAccumulatedChargeCompleteness");
+    const record = requireRecord(value, "sensorAccumulatedChargeCompleteness", ["schemaVersion", "coverageMeaning", "site", "timeReference", "startOffsetSecondsFromOpeningReference", "endOffsetSecondsFromOpeningReference", "bindingId", "scientificStatus", "limitation", "includedAdditionalComponentIds", "profileId", "colorSamplingProfileId", "channelId", "darkCurrentProfileId", "evidence"]);
     if (record.schemaVersion !== "0.1.0") {
         throw new InvalidConfigurationError('sensorAccumulatedChargeCompleteness.schemaVersion must be "0.1.0".');
     }
@@ -194,7 +188,7 @@ export function parseSensorAccumulatedChargeCompletenessProfile(value) {
         "all-material-stored-electron-contributors-accounted-for") {
         throw new InvalidConfigurationError("sensorAccumulatedChargeCompleteness.coverageMeaning is invalid.");
     }
-    const site = requireRecord(record.site, "sensorAccumulatedChargeCompleteness.site");
+    const site = requireRecord(record.site, "sensorAccumulatedChargeCompleteness.site", ["x", "y"]);
     const window = parseWindowIdentity(record, "sensorAccumulatedChargeCompleteness");
     const scientificStatus = parseStatus(record.scientificStatus, "sensorAccumulatedChargeCompleteness.scientificStatus");
     const limitation = record.limitation === undefined
@@ -244,6 +238,7 @@ function sameWindow(startA, endA, startB, endB) {
         endA === endB);
 }
 function validatePhoto(photo) {
+    requireInputObject(photo, "photo input");
     if (photo.kind === "eqe-temporal-photo-signal")
         parseSensorEqeTemporalPhotoSignal(photo);
     if ((photo.kind !== "eqe-expected-counts" && photo.kind !== "eqe-temporal-photo-signal") ||
@@ -308,19 +303,18 @@ function validateComponentBinding(component, photo) {
     }
 }
 /**
- * Compose photo, independently evaluated dark and explicitly incremental charge by exact local
- * exposure identity, retaining completeness assessment before capacity/noise.
+ * Adds photo charge, separately computed dark charge and any explicitly declared extra charge for
+ * one exact local exposure, and keeps the completeness assessment. Capacity and noise come later.
  *
- * Photo, dark and explicitly incremental stored-electron components must share the exact
- * site/channel/local shutter event. Completeness is an evidence-backed declaration, not the
- * consequence of an empty component array. Expected stored charge remains distinct from a stochastic
- * realization or nonlinear full-well clamp.
- * @param input - ComposeSensorPhotoAccumulatedChargeInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns CalculationResult<SensorPhotoAccumulatedChargeComposition>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * All parts must belong to the exact same site, colour channel and local shutter event. The
+ * result is the expected charge, separate from a random realization or the full-well clamp.
+ * @param input - The input; see `ComposeSensorPhotoAccumulatedChargeInput` 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 composeSensorAccumulatedCharge(input) {
+    requireInputKeys(input, "composeSensorAccumulatedCharge", ["photoSignal", "darkCharge", "additionalChargeComponents", "completenessProfile"]);
     validatePhoto(input.photoSignal);
     validateDarkBinding(input.photoSignal, input.darkCharge);
     const profile = parseSensorAccumulatedChargeCompletenessProfile(input.completenessProfile);

package/dist/sensor/accumulated-charge.js.map

@@ -1 +1 @@
-{"version":3,"file":"accumulated-charge.js","sourceRoot":"","sources":["../../src/sensor/accumulated-charge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"accumulated-charge.js","sourceRoot":"","sources":["../../src/sensor/accumulated-charge.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Accumulated charge: adds up the expected electrons stored in one sensor site during one exposure.\n *\n * The parts are photo charge (from light), dark charge (from dark current) and any other stored\n * charge declared explicitly as an addition. All parts must belong to the exact same site, colour\n * channel and local shutter event. Whether the list of parts is complete is a declaration backed by\n * evidence; an empty list does not mean \"complete\".\n *\n * The result is the expected (mean) charge. It is separate from a random (noise) realization and from\n * the non-linear full-well clamp, which later steps apply.\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 { parseSensorEqeTemporalPhotoSignal } from \"./temporal-photo-signal.js\";\nimport type { SensorEqeExposureIntegration } from \"./constant-rate-temporal-integration.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport type {\n  SensorEqePhotoExposure, SensorEqeTemporalPhotoSignal\n} from \"./temporal-photo-signal.js\";\nimport type {\n  SensorPhotoDarkCurrentCharge, SensorDarkCurrentCharge, SensorTemporalDarkCurrentCharge\n} from \"./dark-current.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 SensorAdditionalStoredChargeKind =\n  | \"hot-pixel-defect-excess\"\n  | \"leakage\"\n  | \"charge-injection\"\n  | \"clock-induced-charge\"\n  | \"other\";\n\nexport interface SensorAdditionalStoredChargeComponent {\n  componentId: string;\n  kind:\n    SensorAdditionalStoredChargeKind;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  timeReference:\n    \"first-opening-boundary-phase\";\n  startOffsetSecondsFromOpeningReference:\n    number;\n  endOffsetSecondsFromOpeningReference:\n    number;\n  accountingMeaning:\n    \"incremental-stored-electrons-beyond-photo-and-modeled-dark-current\";\n  expectedElectronCount: number;\n  scientificStatus:\n    SensorSpectralResponseScientificStatus;\n  uncertainty:\n    SensorSpectralResponseUncertainty;\n  evidence:\n    readonly EvidenceProvenance[];\n}\n\nexport interface SensorAccumulatedChargeCompletenessProfile {\n  schemaVersion: \"0.1.0\";\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  timeReference:\n    \"first-opening-boundary-phase\";\n  startOffsetSecondsFromOpeningReference:\n    number;\n  endOffsetSecondsFromOpeningReference:\n    number;\n  darkCurrentProfileId: string;\n  includedAdditionalComponentIds:\n    readonly string[];\n  coverageMeaning:\n    \"all-material-stored-electron-contributors-accounted-for\";\n  scientificStatus:\n    SensorSpectralResponseScientificStatus;\n  evidence:\n    readonly EvidenceProvenance[];\n  limitation?: string;\n}\n\nexport interface ComposeSensorAccumulatedChargeInput<\n  Photo extends SensorEqePhotoExposure = SensorEqeExposureIntegration,\n  Dark extends SensorPhotoDarkCurrentCharge = SensorDarkCurrentCharge\n> {\n  photoSignal:\n    Photo;\n  darkCharge:\n    Dark;\n  additionalChargeComponents?:\n    readonly SensorAdditionalStoredChargeComponent[];\n  completenessProfile:\n    SensorAccumulatedChargeCompletenessProfile;\n}\n\nexport type ComposeSensorPhotoAccumulatedChargeInput = ComposeSensorAccumulatedChargeInput<SensorEqePhotoExposure, SensorPhotoDarkCurrentCharge>;\n\nexport interface SensorAccumulatedChargeComposition<\n  Photo extends SensorEqePhotoExposure = SensorEqeExposureIntegration,\n  Dark extends SensorPhotoDarkCurrentCharge = SensorDarkCurrentCharge\n> {\n  completenessProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  timeReference:\n    \"first-opening-boundary-phase\";\n  startOffsetSecondsFromOpeningReference:\n    number;\n  endOffsetSecondsFromOpeningReference:\n    number;\n  localExposureDurationSeconds:\n    number;\n  photoExpectedElectronCount:\n    number;\n  darkExpectedElectronCount:\n    number;\n  additionalExpectedElectronCount:\n    number;\n  totalExpectedStoredElectronCount:\n    number;\n  additionalComponents:\n    readonly {\n      componentId: string;\n      kind:\n        SensorAdditionalStoredChargeKind;\n      expectedElectronCount: number;\n      scientificStatus:\n        SensorSpectralResponseScientificStatus;\n      uncertainty:\n        SensorSpectralResponseUncertainty;\n      evidence:\n        readonly EvidenceProvenance[];\n    }[];\n  accumulatedChargeCompleteness:\n    \"complete-for-physical-storage-capacity-assessment\";\n  completenessScientificStatus:\n    SensorSpectralResponseScientificStatus;\n  allCountsAreExpectationValues: true;\n  integerChargeSampled: false;\n  photoSignalIncluded: true;\n  darkChargeIncluded: true;\n  otherChargeIncluded: boolean;\n  darkShotNoiseApplied: false;\n  photoShotNoiseApplied: false;\n  readNoiseApplied: false;\n  physicalFullWellAssessmentAuthorized:\n    true;\n  cameraSaturationAssessmentAuthorized:\n    false;\n  saturationAssessed: false;\n  bloomingModeled: false;\n  adcQuantizationApplied: false;\n  rawCodeValueProduced: false;\n  componentEvidence: {\n    completeness:\n      readonly EvidenceProvenance[];\n    photoSignal:\n      Photo[\"componentEvidence\"];\n    darkCurrent:\n      Dark[\"componentEvidence\"];\n  };\n}\n\nexport type SensorPhotoAccumulatedChargeComposition = SensorAccumulatedChargeComposition<SensorEqePhotoExposure, SensorPhotoDarkCurrentCharge>;\n\ninterface CompensatedSum {\n  sum: number;\n  correction: number;\n}\n\nfunction addCompensated(\n  state: CompensatedSum,\n  value: number\n): void {\n  const adjusted =\n    value - state.correction;\n  const next =\n    state.sum + adjusted;\n  state.correction =\n    (next - state.sum) - adjusted;\n  state.sum = next;\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 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    return {\n      kind: \"relative\",\n      fraction,\n      basis: requireNonEmptyString(\n        record.basis,\n        path + \".basis\"\n      )\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 parseStatus(\n  value: unknown,\n  path: string\n): SensorSpectralResponseScientificStatus {\n  if (\n    value !== \"calibrated\" &&\n    value !== \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" is invalid.\"\n    );\n  }\n  return value;\n}\n\nfunction parseWindowIdentity(\n  record: UnknownRecord,\n  path: string\n): {\n  bindingId: string;\n  timeReference:\n    \"first-opening-boundary-phase\";\n  start:\n    number;\n  end:\n    number;\n} {\n  if (\n    record.timeReference !==\n      \"first-opening-boundary-phase\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.timeReference must be \"first-opening-boundary-phase\".'\n    );\n  }\n  const start =\n    requireFinite(\n      record.startOffsetSecondsFromOpeningReference,\n      path +\n        \".startOffsetSecondsFromOpeningReference\"\n    );\n  const end =\n    requireFinite(\n      record.endOffsetSecondsFromOpeningReference,\n      path +\n        \".endOffsetSecondsFromOpeningReference\"\n    );\n  if (!(end > start)) {\n    throw new InvalidConfigurationError(\n      path +\n        \" exposure window end must be greater than start.\"\n    );\n  }\n  return {\n    bindingId:\n      requireNonEmptyString(\n        record.bindingId,\n        path + \".bindingId\"\n      ),\n    timeReference:\n      \"first-opening-boundary-phase\",\n    start,\n    end\n  };\n}\n\n/**\n * Validates an untrusted additional stored-charge component (charge other than photo and dark\n * charge, declared explicitly as an addition) and returns it normalized. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\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 parseSensorAdditionalStoredChargeComponent(\n  value: unknown\n): SensorAdditionalStoredChargeComponent {\n  const record = requireRecord(\n    value,\n    \"sensorAdditionalStoredCharge\", [\"kind\", \"accountingMeaning\", \"site\", \"timeReference\", \"startOffsetSecondsFromOpeningReference\", \"endOffsetSecondsFromOpeningReference\", \"bindingId\", \"scientificStatus\", \"uncertainty\", \"componentId\", \"colorSamplingProfileId\", \"channelId\", \"expectedElectronCount\", \"evidence\"]\n  );\n\n  const kinds =\n    new Set<SensorAdditionalStoredChargeKind>([\n      \"hot-pixel-defect-excess\",\n      \"leakage\",\n      \"charge-injection\",\n      \"clock-induced-charge\",\n      \"other\"\n    ]);\n  if (\n    typeof record.kind !== \"string\" ||\n    !kinds.has(\n      record.kind as\n        SensorAdditionalStoredChargeKind\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorAdditionalStoredCharge.kind is invalid.\"\n    );\n  }\n  if (\n    record.accountingMeaning !==\n      \"incremental-stored-electrons-beyond-photo-and-modeled-dark-current\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorAdditionalStoredCharge.accountingMeaning is invalid.\"\n    );\n  }\n\n  const site = requireRecord(\n    record.site,\n    \"sensorAdditionalStoredCharge.site\", [\"x\", \"y\"]\n  );\n  const window =\n    parseWindowIdentity(\n      record,\n      \"sensorAdditionalStoredCharge\"\n    );\n  const scientificStatus =\n    parseStatus(\n      record.scientificStatus,\n      \"sensorAdditionalStoredCharge.scientificStatus\"\n    );\n  const uncertainty =\n    parseUncertainty(\n      record.uncertainty,\n      \"sensorAdditionalStoredCharge.uncertainty\"\n    );\n  if (\n    scientificStatus === \"calibrated\" &&\n    uncertainty.kind ===\n      \"not-quantified\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"A calibrated additional stored-charge component must declare quantified relative uncertainty.\"\n    );\n  }\n\n  return {\n    componentId:\n      requireNonEmptyString(\n        record.componentId,\n        \"sensorAdditionalStoredCharge.componentId\"\n      ),\n    kind:\n      record.kind as\n        SensorAdditionalStoredChargeKind,\n    colorSamplingProfileId:\n      requireNonEmptyString(\n        record.colorSamplingProfileId,\n        \"sensorAdditionalStoredCharge.colorSamplingProfileId\"\n      ),\n    channelId:\n      requireNonEmptyString(\n        record.channelId,\n        \"sensorAdditionalStoredCharge.channelId\"\n      ),\n    site: {\n      x: requireSiteIndex(\n        site.x,\n        \"sensorAdditionalStoredCharge.site.x\"\n      ),\n      y: requireSiteIndex(\n        site.y,\n        \"sensorAdditionalStoredCharge.site.y\"\n      )\n    },\n    bindingId: window.bindingId,\n    timeReference:\n      window.timeReference,\n    startOffsetSecondsFromOpeningReference:\n      window.start,\n    endOffsetSecondsFromOpeningReference:\n      window.end,\n    accountingMeaning:\n      \"incremental-stored-electrons-beyond-photo-and-modeled-dark-current\",\n    expectedElectronCount:\n      requireNonNegativeFinite(\n        record.expectedElectronCount,\n        \"sensorAdditionalStoredCharge.expectedElectronCount\"\n      ),\n    scientificStatus,\n    uncertainty,\n    evidence: parseEvidenceList(\n      record.evidence,\n      \"sensorAdditionalStoredCharge.evidence\"\n    )\n  };\n}\n\n/**\n * Validates an untrusted completeness profile and returns it normalized. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\n *\n * Completeness is a declaration backed by evidence. An empty list of components does not\n * mean the charge accounting is complete.\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 parseSensorAccumulatedChargeCompletenessProfile(\n  value: unknown\n): SensorAccumulatedChargeCompletenessProfile {\n  const record = requireRecord(\n    value,\n    \"sensorAccumulatedChargeCompleteness\", [\"schemaVersion\", \"coverageMeaning\", \"site\", \"timeReference\", \"startOffsetSecondsFromOpeningReference\", \"endOffsetSecondsFromOpeningReference\", \"bindingId\", \"scientificStatus\", \"limitation\", \"includedAdditionalComponentIds\", \"profileId\", \"colorSamplingProfileId\", \"channelId\", \"darkCurrentProfileId\", \"evidence\"]\n  );\n  if (\n    record.schemaVersion !== \"0.1.0\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorAccumulatedChargeCompleteness.schemaVersion must be \"0.1.0\".'\n    );\n  }\n  if (\n    record.coverageMeaning !==\n      \"all-material-stored-electron-contributors-accounted-for\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorAccumulatedChargeCompleteness.coverageMeaning is invalid.\"\n    );\n  }\n\n  const site = requireRecord(\n    record.site,\n    \"sensorAccumulatedChargeCompleteness.site\", [\"x\", \"y\"]\n  );\n  const window =\n    parseWindowIdentity(\n      record,\n      \"sensorAccumulatedChargeCompleteness\"\n    );\n  const scientificStatus =\n    parseStatus(\n      record.scientificStatus,\n      \"sensorAccumulatedChargeCompleteness.scientificStatus\"\n    );\n  const limitation =\n    record.limitation === undefined\n      ? undefined\n      : requireNonEmptyString(\n          record.limitation,\n          \"sensorAccumulatedChargeCompleteness.limitation\"\n        );\n  if (\n    scientificStatus === \"approximation\" &&\n    limitation === undefined\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorAccumulatedChargeCompleteness.limitation is required for an approximation.\"\n    );\n  }\n  if (\n    !Array.isArray(\n      record.includedAdditionalComponentIds\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorAccumulatedChargeCompleteness.includedAdditionalComponentIds must be an array.\"\n    );\n  }\n\n  const ids =\n    record.includedAdditionalComponentIds.map(\n      (entry, index) =>\n        requireNonEmptyString(\n          entry,\n          \"sensorAccumulatedChargeCompleteness.includedAdditionalComponentIds[\" +\n            index +\n            \"]\"\n        )\n    );\n  if (\n    new Set(ids).size !== ids.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorAccumulatedChargeCompleteness.includedAdditionalComponentIds must not contain duplicates.\"\n    );\n  }\n\n  return {\n    schemaVersion: \"0.1.0\",\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"sensorAccumulatedChargeCompleteness.profileId\"\n      ),\n    colorSamplingProfileId:\n      requireNonEmptyString(\n        record.colorSamplingProfileId,\n        \"sensorAccumulatedChargeCompleteness.colorSamplingProfileId\"\n      ),\n    channelId:\n      requireNonEmptyString(\n        record.channelId,\n        \"sensorAccumulatedChargeCompleteness.channelId\"\n      ),\n    site: {\n      x: requireSiteIndex(\n        site.x,\n        \"sensorAccumulatedChargeCompleteness.site.x\"\n      ),\n      y: requireSiteIndex(\n        site.y,\n        \"sensorAccumulatedChargeCompleteness.site.y\"\n      )\n    },\n    bindingId: window.bindingId,\n    timeReference:\n      window.timeReference,\n    startOffsetSecondsFromOpeningReference:\n      window.start,\n    endOffsetSecondsFromOpeningReference:\n      window.end,\n    darkCurrentProfileId:\n      requireNonEmptyString(\n        record.darkCurrentProfileId,\n        \"sensorAccumulatedChargeCompleteness.darkCurrentProfileId\"\n      ),\n    includedAdditionalComponentIds:\n      [...ids].sort(),\n    coverageMeaning:\n      \"all-material-stored-electron-contributors-accounted-for\",\n    scientificStatus,\n    evidence: parseEvidenceList(\n      record.evidence,\n      \"sensorAccumulatedChargeCompleteness.evidence\"\n    ),\n    ...(limitation === undefined\n      ? {}\n      : { limitation })\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 sameWindow(\n  startA: number,\n  endA: number,\n  startB: number,\n  endB: number\n): boolean {\n  return (\n    startA === startB &&\n    endA === endB\n  );\n}\n\nfunction validatePhoto(\n  photo:\n    SensorEqePhotoExposure\n): void {\n  requireInputObject(photo, \"photo input\");\n  if (photo.kind === \"eqe-temporal-photo-signal\") parseSensorEqeTemporalPhotoSignal(photo);\n  if (\n    (photo.kind !== \"eqe-expected-counts\" && photo.kind !== \"eqe-temporal-photo-signal\") ||\n    photo.temporalIntegrationApplied !==\n      true ||\n    photo.accumulatedSignalCompleteness !==\n      \"photo-signal-only\" ||\n    photo.darkChargeIncluded !== false ||\n    photo.otherChargeIncluded !== false ||\n    photo\n      .physicalFullWellAssessmentAuthorized !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge composition requires an unmodified photo-signal-only EQE exposure result.\"\n    );\n  }\n  if (\n    !Number.isFinite(\n      photo\n        .expectedGeneratedElectronCount\n    ) ||\n    photo\n      .expectedGeneratedElectronCount < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Photo expected electron count must be finite and nonnegative.\"\n    );\n  }\n}\n\nfunction validateDarkBinding(\n  photo:\n    SensorEqePhotoExposure,\n  dark:\n    SensorPhotoDarkCurrentCharge\n): void {\n  if (\n    dark.colorSamplingProfileId !==\n      photo.colorSamplingProfileId ||\n    dark.channelId !==\n      photo.channelId ||\n    !sameSite(dark.site, photo.site) ||\n    dark.bindingId !==\n      photo.bindingId ||\n    (photo.kind === \"eqe-temporal-photo-signal\"\n      ? dark.stationarityProfileId !== undefined || dark.temporalIntegrationId !== photo.temporalIntegrationId\n      : dark.temporalIntegrationId !== undefined || dark.stationarityProfileId !== photo.stationarityProfileId) ||\n    dark.timeReference !==\n      photo.timeReference ||\n    !sameWindow(\n      dark.startOffsetSecondsFromOpeningReference,\n      dark.endOffsetSecondsFromOpeningReference,\n      photo.startOffsetSecondsFromOpeningReference,\n      photo.endOffsetSecondsFromOpeningReference\n    ) ||\n    dark.localExposureDurationSeconds !==\n      photo.localExposureDurationSeconds ||\n    dark.photoSignalIncluded !== false ||\n    dark.otherChargeIncluded !== false ||\n    dark\n      .physicalFullWellAssessmentAuthorized !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Dark charge must bind to the exact same uncombined EQE local exposure event.\"\n    );\n  }\n  if (\n    !Number.isFinite(\n      dark.expectedDarkElectronCount\n    ) ||\n    dark.expectedDarkElectronCount < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Dark expected electron count must be finite and nonnegative.\"\n    );\n  }\n}\n\nfunction validateComponentBinding(\n  component:\n    SensorAdditionalStoredChargeComponent,\n  photo:\n    SensorEqePhotoExposure\n): void {\n  if (\n    component.colorSamplingProfileId !==\n      photo.colorSamplingProfileId ||\n    component.channelId !==\n      photo.channelId ||\n    !sameSite(\n      component.site,\n      photo.site\n    ) ||\n    component.bindingId !==\n      photo.bindingId ||\n    component.timeReference !==\n      photo.timeReference ||\n    !sameWindow(\n      component.startOffsetSecondsFromOpeningReference,\n      component.endOffsetSecondsFromOpeningReference,\n      photo.startOffsetSecondsFromOpeningReference,\n      photo.endOffsetSecondsFromOpeningReference\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Additional stored-charge component must bind to the exact same local exposure event.\"\n    );\n  }\n}\n\n/**\n * Adds photo charge, separately computed dark charge and any explicitly declared extra charge for\n * one exact local exposure, and keeps the completeness assessment. Capacity and noise come later.\n *\n * All parts must belong to the exact same site, colour channel and local shutter event. The\n * result is the expected charge, separate from a random realization or the full-well clamp.\n * @param input - Charge input with a per-exposure photo signal (SensorEqeExposureIntegration) and\n *   dark charge (SensorDarkCurrentCharge); see `ComposeSensorAccumulatedChargeInput`.\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 composeSensorAccumulatedCharge(\n  input: Omit<ComposeSensorAccumulatedChargeInput, \"photoSignal\" | \"darkCharge\"> & {\n    photoSignal: SensorEqeExposureIntegration; darkCharge: SensorDarkCurrentCharge;\n  }\n): CalculationResult<SensorAccumulatedChargeComposition>;\n/**\n * Adds photo charge, separately computed dark charge and any explicitly declared extra charge for\n * one exact local exposure, and keeps the completeness assessment. Capacity and noise come later.\n *\n * All parts must belong to the exact same site, colour channel and local shutter event. The\n * result is the expected charge, separate from a random realization or the full-well clamp.\n * @param input - Charge input with a time-resolved photo signal (SensorEqeTemporalPhotoSignal) and\n *   dark charge (SensorTemporalDarkCurrentCharge); see `ComposeSensorAccumulatedChargeInput`.\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 composeSensorAccumulatedCharge(\n  input: Omit<ComposeSensorAccumulatedChargeInput, \"photoSignal\" | \"darkCharge\"> & {\n    photoSignal: SensorEqeTemporalPhotoSignal; darkCharge: SensorTemporalDarkCurrentCharge;\n  }\n): CalculationResult<SensorAccumulatedChargeComposition<SensorEqeTemporalPhotoSignal, SensorTemporalDarkCurrentCharge>>;\n/**\n * Adds photo charge, separately computed dark charge and any explicitly declared extra charge for\n * one exact local exposure, and keeps the completeness assessment. Capacity and noise come later.\n *\n * All parts must belong to the exact same site, colour channel and local shutter event. The\n * result is the expected charge, separate from a random realization or the full-well clamp.\n * @param input - The input; see `ComposeSensorPhotoAccumulatedChargeInput` 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 composeSensorAccumulatedCharge(\n  input: ComposeSensorPhotoAccumulatedChargeInput\n): CalculationResult<SensorPhotoAccumulatedChargeComposition>;\n/**\n * Adds photo charge, separately computed dark charge and any explicitly declared extra charge for\n * one exact local exposure, and keeps the completeness assessment. Capacity and noise come later.\n *\n * All parts must belong to the exact same site, colour channel and local shutter event. The\n * result is the expected charge, separate from a random realization or the full-well clamp.\n * @param input - The input; see `ComposeSensorPhotoAccumulatedChargeInput` 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 composeSensorAccumulatedCharge(\n  input: ComposeSensorPhotoAccumulatedChargeInput\n): CalculationResult<SensorPhotoAccumulatedChargeComposition> {\n  requireInputKeys(input, \"composeSensorAccumulatedCharge\", [\"photoSignal\", \"darkCharge\", \"additionalChargeComponents\", \"completenessProfile\"]);\n  validatePhoto(input.photoSignal);\n  validateDarkBinding(\n    input.photoSignal,\n    input.darkCharge\n  );\n  const profile =\n    parseSensorAccumulatedChargeCompletenessProfile(\n      input.completenessProfile\n    );\n  const components =\n    (\n      input.additionalChargeComponents ??\n      []\n    ).map(\n      parseSensorAdditionalStoredChargeComponent\n    );\n\n  if (\n    profile.colorSamplingProfileId !==\n      input.photoSignal\n        .colorSamplingProfileId ||\n    profile.channelId !==\n      input.photoSignal.channelId ||\n    !sameSite(\n      profile.site,\n      input.photoSignal.site\n    ) ||\n    profile.bindingId !==\n      input.photoSignal.bindingId ||\n    profile.timeReference !==\n      input.photoSignal.timeReference ||\n    !sameWindow(\n      profile.startOffsetSecondsFromOpeningReference,\n      profile.endOffsetSecondsFromOpeningReference,\n      input.photoSignal.startOffsetSecondsFromOpeningReference,\n      input.photoSignal.endOffsetSecondsFromOpeningReference\n    ) ||\n    profile.darkCurrentProfileId !==\n      input.darkCharge\n        .darkCurrentProfileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge-completeness profile must bind to the exact photo/dark exposure pipeline.\"\n    );\n  }\n\n  const seen =\n    new Set<string>();\n  for (const component of components) {\n    validateComponentBinding(\n      component,\n      input.photoSignal\n    );\n    if (\n      seen.has(component.componentId)\n    ) {\n      throw new InvalidScientificInputError(\n        \"Additional stored-charge component IDs must be unique.\"\n      );\n    }\n    seen.add(component.componentId);\n  }\n\n  const actualIds =\n    [...seen].sort();\n  if (\n    JSON.stringify(actualIds) !==\n    JSON.stringify(\n      profile\n        .includedAdditionalComponentIds\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge-completeness profile additional component IDs must exactly match the supplied components.\"\n    );\n  }\n\n  const sum: CompensatedSum = {\n    sum: 0,\n    correction: 0\n  };\n  addCompensated(\n    sum,\n    input.photoSignal\n      .expectedGeneratedElectronCount\n  );\n  addCompensated(\n    sum,\n    input.darkCharge\n      .expectedDarkElectronCount\n  );\n\n  let additionalTotal = 0;\n  for (const component of components) {\n    additionalTotal +=\n      component.expectedElectronCount;\n    addCompensated(\n      sum,\n      component.expectedElectronCount\n    );\n  }\n\n  if (\n    !Number.isFinite(\n      additionalTotal\n    ) ||\n    !Number.isFinite(sum.sum) ||\n    sum.sum < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Accumulated stored-electron totals must remain finite and nonnegative.\"\n    );\n  }\n\n  const result:\n    SensorPhotoAccumulatedChargeComposition = {\n      completenessProfileId:\n        profile.profileId,\n      colorSamplingProfileId:\n        input.photoSignal\n          .colorSamplingProfileId,\n      channelId:\n        input.photoSignal.channelId,\n      site: {\n        ...input.photoSignal.site\n      },\n      bindingId:\n        input.photoSignal.bindingId,\n      timeReference:\n        input.photoSignal.timeReference,\n      startOffsetSecondsFromOpeningReference:\n        input.photoSignal\n          .startOffsetSecondsFromOpeningReference,\n      endOffsetSecondsFromOpeningReference:\n        input.photoSignal\n          .endOffsetSecondsFromOpeningReference,\n      localExposureDurationSeconds:\n        input.photoSignal\n          .localExposureDurationSeconds,\n      photoExpectedElectronCount:\n        input.photoSignal\n          .expectedGeneratedElectronCount,\n      darkExpectedElectronCount:\n        input.darkCharge\n          .expectedDarkElectronCount,\n      additionalExpectedElectronCount:\n        additionalTotal,\n      totalExpectedStoredElectronCount:\n        sum.sum,\n      additionalComponents:\n        components.map(\n          (component) => ({\n            componentId:\n              component.componentId,\n            kind: component.kind,\n            expectedElectronCount:\n              component.expectedElectronCount,\n            scientificStatus:\n              component.scientificStatus,\n            uncertainty:\n              component.uncertainty,\n            evidence:\n              component.evidence\n          })\n        ),\n      accumulatedChargeCompleteness:\n        \"complete-for-physical-storage-capacity-assessment\",\n      completenessScientificStatus:\n        profile.scientificStatus,\n      allCountsAreExpectationValues:\n        true,\n      integerChargeSampled: false,\n      photoSignalIncluded: true,\n      darkChargeIncluded: true,\n      otherChargeIncluded:\n        components.length > 0,\n      darkShotNoiseApplied: false,\n      photoShotNoiseApplied: false,\n      readNoiseApplied: false,\n      physicalFullWellAssessmentAuthorized:\n        true,\n      cameraSaturationAssessmentAuthorized:\n        false,\n      saturationAssessed: false,\n      bloomingModeled: false,\n      adcQuantizationApplied:\n        false,\n      rawCodeValueProduced: false,\n      componentEvidence: {\n        completeness:\n          profile.evidence,\n        photoSignal:\n          input.photoSignal\n            .componentEvidence,\n        darkCurrent:\n          input.darkCharge\n            .componentEvidence\n      }\n    };\n\n  const assumptions = [\n    \"Stored-electron accounting is bound to one exact EQE local exposure event; equal duration alone is insufficient.\",\n    \"Photo-signal expected electrons and thermally generated dark electrons are separate terms.\",\n    \"Every additional component must declare itself incremental beyond both modeled photo signal and modeled dark current to avoid silent double counting.\",\n    \"The completeness profile is an evidence-backed scientific assertion that all material stored-electron contributors for physical charge-capacity assessment are accounted for; it is not inferred from an empty additional-component list.\",\n    \"All values remain expectation counts. Photo/dark shot noise, read noise and stochastic integer sampling are not applied.\",\n    \"Physical full-well assessment becomes structurally authorized, but no saturation or blooming behavior is calculated by this composition.\",\n    \"Camera/digital saturation remains a separate response-chain property and is not authorized by physical charge completeness.\",\n    \"A/W current/charge results remain outside this stored-electron composition until a separate carrier/storage mapping exists.\"\n  ];\n\n  return profile.scientificStatus ===\n    \"calibrated\"\n    ? calculatedResult(\n        result,\n        \"sensor-accumulated-charge-composition\",\n        input.photoSignal.kind === \"eqe-temporal-photo-signal\" ? \"1.1.0\" : \"1.0.0\",\n        assumptions\n      )\n    : approximationResult(\n        result,\n        \"sensor-accumulated-charge-composition\",\n        input.photoSignal.kind === \"eqe-temporal-photo-signal\" ? \"1.1.0\" : \"1.0.0\",\n        [\n          ...assumptions,\n          profile.limitation!\n        ]\n      );\n}\n"]}

package/dist/sensor/architecture.d.ts

@@ -1,10 +1,9 @@
 /**
- * Module boundary and integration notes.
- * Parses untrusted descriptive sensor-architecture metadata. Schema 0.2.0 remains accepted and returns
- * a 0.2.0 profile unchanged in semantic identity. Schema 0.3.0 adds optional evidence-backed CMOS/CCD
- * technology-family metadata. Unknown facts should be omitted instead of inferred. The parser
- * validates structure, supported vocabulary, and field-level evidence only; it does not verify that a
- * cited real-world claim is factually true and technology family does not activate hidden physics.
+ * Sensor architecture: descriptive metadata about a sensor's hardware (such as CMOS or CCD, and its
+ * readout capabilities), each fact backed by evidence.
+ *
+ * This metadata describes; it does not switch on any physics. The parser checks structure, allowed
+ * values and per-field evidence. It does not check that a cited real-world claim is true.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -24,9 +23,9 @@ interface SensorArchitectureProfileBase {
     illumination?: SourcedSensorArchitectureFact<SensorIlluminationArchitecture>;
     integration?: SourcedSensorArchitectureFact<SensorIntegrationArchitecture>;
     /**
-     * Hardware readout capabilities, not the readout mode selected for one
-     * capture. Each capability carries its own evidence because different
-     * readout modes may be documented by different sources.
+     * Readout modes the hardware supports, not the mode chosen for one capture.
+     * Each capability has its own evidence, because different readout modes may
+     * be documented by different sources.
      */
     readoutCapabilities?: readonly SourcedSensorArchitectureFact<SensorReadoutArchitecture>[];
     colorSamplingFamily?: SourcedSensorArchitectureFact<SensorColorSamplingFamily>;
@@ -34,42 +33,40 @@ interface SensorArchitectureProfileBase {
 /**
  * Legacy sensor-architecture schema.
  *
- * Schema 0.2.0 remains accepted and is preserved exactly when parsed. It does
- * not support technologyFamily; omission remains unknown/unasserted.
+ * Schema 0.2.0 is still accepted and kept exactly as parsed. It has no
+ * technologyFamily field; leaving it out means "unknown, not stated".
  */
 export interface SensorArchitectureProfileV0_2 extends SensorArchitectureProfileBase {
     schemaVersion: typeof LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION;
     technologyFamily?: never;
 }
 /**
- * Current descriptive sensor hardware/capability metadata.
+ * Current descriptive metadata about the sensor hardware and its capabilities.
  *
- * Omitted properties mean unknown/unasserted. These fields are not scientific
- * effect switches: no architecture value changes noise, dynamic range, FOV,
- * crop factor, exposure, readout timing, or sampling without a separate
- * downstream model that explicitly consumes that fact.
+ * An omitted property means "unknown, not stated". These fields do not switch
+ * on scientific effects. No architecture value changes noise, dynamic range,
+ * field of view, crop factor, exposure, readout timing or sampling unless a
+ * separate downstream model explicitly uses that fact.
  */
 export interface SensorArchitectureProfileV0_3 extends SensorArchitectureProfileBase {
     schemaVersion: typeof SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION;
-    /** Coarse detector technology identity only; never a performance switch. */
+    /** Broad detector technology (for example CMOS or CCD) only. It never changes performance. */
     technologyFamily?: SourcedSensorArchitectureFact<SensorTechnologyFamily>;
 }
 export type SensorArchitectureProfile = SensorArchitectureProfileV0_2 | SensorArchitectureProfileV0_3;
 /**
  * Parses untrusted descriptive sensor-architecture metadata.
  *
- * Schema 0.2.0 remains accepted and returns a 0.2.0 profile unchanged in
- * semantic identity. Schema 0.3.0 adds optional evidence-backed CMOS/CCD
- * technology-family metadata. Unknown facts should be omitted instead of
- * inferred.
+ * Schema 0.2.0 is still accepted and returns a 0.2.0 profile with the same
+ * meaning. Schema 0.3.0 adds an optional, evidence-backed technology family
+ * (CMOS or CCD). Leave out facts you do not know rather than guessing them.
  *
- * The parser validates structure, supported vocabulary, and field-level
- * evidence only; it does not verify that a cited real-world claim is
- * factually true and technology family does not activate hidden physics.
+ * The parser checks structure, allowed values and per-field evidence only. It
+ * does not check that a cited real-world claim is true, and the technology
+ * family does not switch on any hidden physics.
  *
  * @param value Unknown external data.
  * @returns Validated sensor architecture profile preserving input schema identity.
  */
 export declare function parseSensorArchitectureProfile(value: unknown): SensorArchitectureProfile;
 export {};
-//# sourceMappingURL=architecture.d.ts.map

package/dist/sensor/architecture.js

@@ -1,15 +1,15 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Parses untrusted descriptive sensor-architecture metadata. Schema 0.2.0 remains accepted and returns
- * a 0.2.0 profile unchanged in semantic identity. Schema 0.3.0 adds optional evidence-backed CMOS/CCD
- * technology-family metadata. Unknown facts should be omitted instead of inferred. The parser
- * validates structure, supported vocabulary, and field-level evidence only; it does not verify that a
- * cited real-world claim is factually true and technology family does not activate hidden physics.
+ * Sensor architecture: descriptive metadata about a sensor's hardware (such as CMOS or CCD, and its
+ * readout capabilities), each fact backed by evidence.
+ *
+ * This metadata describes; it does not switch on any physics. The parser checks structure, allowed
+ * values and per-field evidence. It does not check that a cited real-world claim is true.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
 import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { rejectUnknownFields } from "../core/record-validation.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 export const SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION = "0.3.0";
 const LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION = "0.2.0";
@@ -37,10 +37,12 @@ const COLOR_SAMPLING_VALUES = new Set([
     "custom-rgb-mosaic",
     "layered-color"
 ]);
-function requireRecord(value, path) {
+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(record, key, path) {
@@ -51,7 +53,7 @@ function requireNonEmptyString(record, key, path) {
     return value;
 }
 function parseScalarFact(value, path, allowed) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["value", "evidence"]);
     const factValue = requireNonEmptyString(record, "value", path);
     if (!allowed.has(factValue)) {
         throw new InvalidConfigurationError(`${path}.value is invalid.`);
@@ -99,20 +101,19 @@ function parseSharedArchitectureFields(profile) {
 /**
  * Parses untrusted descriptive sensor-architecture metadata.
  *
- * Schema 0.2.0 remains accepted and returns a 0.2.0 profile unchanged in
- * semantic identity. Schema 0.3.0 adds optional evidence-backed CMOS/CCD
- * technology-family metadata. Unknown facts should be omitted instead of
- * inferred.
+ * Schema 0.2.0 is still accepted and returns a 0.2.0 profile with the same
+ * meaning. Schema 0.3.0 adds an optional, evidence-backed technology family
+ * (CMOS or CCD). Leave out facts you do not know rather than guessing them.
  *
- * The parser validates structure, supported vocabulary, and field-level
- * evidence only; it does not verify that a cited real-world claim is
- * factually true and technology family does not activate hidden physics.
+ * The parser checks structure, allowed values and per-field evidence only. It
+ * does not check that a cited real-world claim is true, and the technology
+ * family does not switch on any hidden physics.
  *
  * @param value Unknown external data.
  * @returns Validated sensor architecture profile preserving input schema identity.
  */
 export function parseSensorArchitectureProfile(value) {
-    const profile = requireRecord(value, "sensorArchitecture");
+    const profile = requireRecord(value, "sensorArchitecture", ["illumination", "integration", "readoutCapabilities", "colorSamplingFamily", "schemaVersion", "technologyFamily"]);
     const shared = parseSharedArchitectureFields(profile);
     if (profile.schemaVersion ===
         LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION) {

package/dist/sensor/architecture.js.map

@@ -1 +1 @@
-{"version":3,"file":"architecture.js","sourceRoot":"","sources":["../../src/sensor/architecture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"architecture.js","sourceRoot":"","sources":["../../src/sensor/architecture.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Sensor architecture: descriptive metadata about a sensor's hardware (such as CMOS or CCD, and its\n * readout capabilities), each fact backed by evidence.\n *\n * This metadata describes; it does not switch on any physics. The parser checks structure, allowed\n * values and per-field evidence. It does not check that a cited real-world claim is true.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport {\n  parseEvidenceList,\n  type EvidenceBackedFact,\n  type EvidenceProvenance,\n  type EvidenceReuseStatus,\n  type EvidenceSourceOrigin\n} from \"../core/evidence-provenance.js\";\nimport { rejectUnknownFields } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport const SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION = \"0.3.0\" as const;\nconst LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION = \"0.2.0\" as const;\n\nexport type SensorTechnologyFamily = \"cmos\" | \"ccd\";\n\nexport type SensorIlluminationArchitecture = \"fsi\" | \"bsi\";\n\nexport type SensorIntegrationArchitecture =\n  | \"monolithic\"\n  | \"partially-stacked\"\n  | \"stacked\";\n\nexport type SensorReadoutArchitecture = \"rolling\" | \"global\";\n\nexport type SensorColorSamplingFamily =\n  | \"bayer\"\n  | \"quad-bayer\"\n  | \"monochrome\"\n  | \"custom-rgb-mosaic\"\n  | \"layered-color\";\n\nexport type SensorArchitectureSourceKind = EvidenceSourceOrigin;\nexport type SensorArchitectureReuseStatus = EvidenceReuseStatus;\nexport type SensorArchitectureFactProvenance = EvidenceProvenance;\nexport type SourcedSensorArchitectureFact<T> = EvidenceBackedFact<T>;\n\ninterface SensorArchitectureProfileBase {\n  illumination?: SourcedSensorArchitectureFact<SensorIlluminationArchitecture>;\n  integration?: SourcedSensorArchitectureFact<SensorIntegrationArchitecture>;\n  /**\n   * Readout modes the hardware supports, not the mode chosen for one capture.\n   * Each capability has its own evidence, because different readout modes may\n   * be documented by different sources.\n   */\n  readoutCapabilities?: readonly SourcedSensorArchitectureFact<SensorReadoutArchitecture>[];\n  colorSamplingFamily?: SourcedSensorArchitectureFact<SensorColorSamplingFamily>;\n}\n\n/**\n * Legacy sensor-architecture schema.\n *\n * Schema 0.2.0 is still accepted and kept exactly as parsed. It has no\n * technologyFamily field; leaving it out means \"unknown, not stated\".\n */\nexport interface SensorArchitectureProfileV0_2\n  extends SensorArchitectureProfileBase {\n  schemaVersion: typeof LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION;\n  technologyFamily?: never;\n}\n\n/**\n * Current descriptive metadata about the sensor hardware and its capabilities.\n *\n * An omitted property means \"unknown, not stated\". These fields do not switch\n * on scientific effects. No architecture value changes noise, dynamic range,\n * field of view, crop factor, exposure, readout timing or sampling unless a\n * separate downstream model explicitly uses that fact.\n */\nexport interface SensorArchitectureProfileV0_3\n  extends SensorArchitectureProfileBase {\n  schemaVersion: typeof SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION;\n  /** Broad detector technology (for example CMOS or CCD) only. It never changes performance. */\n  technologyFamily?: SourcedSensorArchitectureFact<SensorTechnologyFamily>;\n}\n\nexport type SensorArchitectureProfile =\n  | SensorArchitectureProfileV0_2\n  | SensorArchitectureProfileV0_3;\n\nconst TECHNOLOGY_FAMILY_VALUES = new Set<SensorTechnologyFamily>([\n  \"cmos\",\n  \"ccd\"\n]);\n\nconst ILLUMINATION_VALUES = new Set<SensorIlluminationArchitecture>([\n  \"fsi\",\n  \"bsi\"\n]);\n\nconst INTEGRATION_VALUES = new Set<SensorIntegrationArchitecture>([\n  \"monolithic\",\n  \"partially-stacked\",\n  \"stacked\"\n]);\n\nconst READOUT_VALUES = new Set<SensorReadoutArchitecture>([\n  \"rolling\",\n  \"global\"\n]);\n\nconst COLOR_SAMPLING_VALUES = new Set<SensorColorSamplingFamily>([\n  \"bayer\",\n  \"quad-bayer\",\n  \"monochrome\",\n  \"custom-rgb-mosaic\",\n  \"layered-color\"\n]);\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new InvalidConfigurationError(`${path} must be an object.`);\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonEmptyString(\n  record: UnknownRecord,\n  key: string,\n  path: string\n): string {\n  const value = record[key];\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new InvalidConfigurationError(\n      `${path}.${key} must be a non-empty string.`\n    );\n  }\n  return value;\n}\n\nfunction parseScalarFact<T extends string>(\n  value: unknown,\n  path: string,\n  allowed: ReadonlySet<T>\n): SourcedSensorArchitectureFact<T> {\n  const record = requireRecord(value, path, [\"value\", \"evidence\"]);\n  const factValue = requireNonEmptyString(record, \"value\", path);\n  if (!allowed.has(factValue as T)) {\n    throw new InvalidConfigurationError(`${path}.value is invalid.`);\n  }\n\n  return {\n    value: factValue as T,\n    evidence: parseEvidenceList(record.evidence, `${path}.evidence`)\n  };\n}\n\nfunction parseReadoutCapabilities(\n  value: unknown,\n  path: string\n): readonly SourcedSensorArchitectureFact<SensorReadoutArchitecture>[] {\n  if (!Array.isArray(value) || value.length === 0) {\n    throw new InvalidConfigurationError(\n      `${path} must be a non-empty array.`\n    );\n  }\n\n  const parsed = value.map((entry, index) =>\n    parseScalarFact(\n      entry,\n      `${path}[${index}]`,\n      READOUT_VALUES\n    )\n  );\n\n  const values = parsed.map((fact) => fact.value);\n  if (new Set(values).size !== values.length) {\n    throw new InvalidConfigurationError(\n      `${path} must not contain duplicate capability values.`\n    );\n  }\n\n  return parsed;\n}\n\nfunction parseSharedArchitectureFields(\n  profile: UnknownRecord\n): SensorArchitectureProfileBase {\n  return {\n    ...(profile.illumination === undefined\n      ? {}\n      : {\n          illumination: parseScalarFact(\n            profile.illumination,\n            \"sensorArchitecture.illumination\",\n            ILLUMINATION_VALUES\n          )\n        }),\n    ...(profile.integration === undefined\n      ? {}\n      : {\n          integration: parseScalarFact(\n            profile.integration,\n            \"sensorArchitecture.integration\",\n            INTEGRATION_VALUES\n          )\n        }),\n    ...(profile.readoutCapabilities === undefined\n      ? {}\n      : {\n          readoutCapabilities: parseReadoutCapabilities(\n            profile.readoutCapabilities,\n            \"sensorArchitecture.readoutCapabilities\"\n          )\n        }),\n    ...(profile.colorSamplingFamily === undefined\n      ? {}\n      : {\n          colorSamplingFamily: parseScalarFact(\n            profile.colorSamplingFamily,\n            \"sensorArchitecture.colorSamplingFamily\",\n            COLOR_SAMPLING_VALUES\n          )\n        })\n  };\n}\n\n/**\n * Parses untrusted descriptive sensor-architecture metadata.\n *\n * Schema 0.2.0 is still accepted and returns a 0.2.0 profile with the same\n * meaning. Schema 0.3.0 adds an optional, evidence-backed technology family\n * (CMOS or CCD). Leave out facts you do not know rather than guessing them.\n *\n * The parser checks structure, allowed values and per-field evidence only. It\n * does not check that a cited real-world claim is true, and the technology\n * family does not switch on any hidden physics.\n *\n * @param value Unknown external data.\n * @returns Validated sensor architecture profile preserving input schema identity.\n */\nexport function parseSensorArchitectureProfile(\n  value: unknown\n): SensorArchitectureProfile {\n  const profile = requireRecord(value, \"sensorArchitecture\", [\"illumination\", \"integration\", \"readoutCapabilities\", \"colorSamplingFamily\", \"schemaVersion\", \"technologyFamily\"]);\n  const shared = parseSharedArchitectureFields(profile);\n\n  if (\n    profile.schemaVersion ===\n    LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION\n  ) {\n    if (profile.technologyFamily !== undefined) {\n      throw new InvalidConfigurationError(\n        \"sensorArchitecture schema 0.2.0 does not support technologyFamily; use schema 0.3.0.\"\n      );\n    }\n\n    return {\n      schemaVersion: LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION,\n      ...shared\n    };\n  }\n\n  if (profile.schemaVersion === SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION) {\n    return {\n      schemaVersion: SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION,\n      ...shared,\n      ...(profile.technologyFamily === undefined\n        ? {}\n        : {\n            technologyFamily: parseScalarFact(\n              profile.technologyFamily,\n              \"sensorArchitecture.technologyFamily\",\n              TECHNOLOGY_FAMILY_VALUES\n            )\n          })\n    };\n  }\n\n  throw new InvalidConfigurationError(\n    'sensorArchitecture.schemaVersion must be \"0.2.0\" or \"0.3.0\".'\n  );\n}\n"]}

package/dist/sensor/camera-saturation-capacity.d.ts

@@ -1,15 +1,11 @@
 /**
- * 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.
  */
@@ -110,29 +106,26 @@ export interface SensorCameraSaturationCapacityAssessment {
     };
 }
 /**
- * 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 declare function parseSensorCameraSaturationCapacityProfile(value: unknown): SensorCameraSaturationCapacityProfile;
 /**
- * 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 declare function assessSensorCameraSaturationCapacity(input: AssessSensorCameraSaturationCapacityInput): CalculationResult<SensorCameraSaturationCapacityAssessment>;
-//# sourceMappingURL=camera-saturation-capacity.d.ts.map