@photivra/engine 2.18.0 → 2.20.0

package/dist/schema/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/schema/validation.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Runtime parsers for untrusted camera configurations and scene definitions.\n * @see docs/SCENE_RADIANCE_AND_ILLUMINATION.md for equations, coordinate/unit conventions, blockers\n * and support limits.\n */\n\nimport { rejectUnknownFields, rejectUnknownVariantFields } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nexport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nimport type {\n  CameraConfiguration,\n  CameraSupport\n} from \"./camera.js\";\nimport type {\n  SceneCapability,\n  SceneDefinition\n} from \"./scene.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nconst CAMERA_SUPPORTS = new Set<CameraSupport>([\n  \"handheld\",\n  \"braced\",\n  \"monopod\",\n  \"tripod\"\n]);\n\nconst SCENE_CAPABILITIES = new Set<SceneCapability>([\n  \"scene-linear-rgb\",\n  \"metric-depth\",\n  \"segmentation\",\n  \"occlusion-layers\",\n  \"motion-vectors\",\n  \"focus-targets\",\n  \"multi-resolution-layers\",\n  \"absolute-radiometry\"\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 requireString(\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 requireBoolean(\n  record: UnknownRecord,\n  key: string,\n  path: string\n): boolean {\n  const value = record[key];\n  if (typeof value !== \"boolean\") {\n    throw new InvalidConfigurationError(\n      `${path}.${key} must be a boolean.`\n    );\n  }\n  return value;\n}\n\nfunction requirePositiveNumber(\n  record: UnknownRecord,\n  key: string,\n  path: string\n): number {\n  const value = record[key];\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new InvalidConfigurationError(\n      `${path}.${key} must be a finite number greater than zero.`\n    );\n  }\n  return value;\n}\n\nfunction requirePositiveIntegerValue(\n  record: UnknownRecord,\n  key: string,\n  path: string\n): number {\n  const value = record[key];\n  if (!Number.isSafeInteger(value) || (value as number) <= 0) {\n    throw new InvalidConfigurationError(\n      `${path}.${key} must be a positive safe integer.`\n    );\n  }\n  return value as number;\n}\n\nfunction assertVector3(value: unknown, path: string): void {\n  const vector = requireRecord(value, path, [\"x\", \"y\", \"z\"]);\n  for (const component of [\"x\", \"y\", \"z\"] as const) {\n    const coordinate = vector[component];\n    if (typeof coordinate !== \"number\" || !Number.isFinite(coordinate)) {\n      throw new InvalidConfigurationError(\n        `${path}.${component} must be a finite number.`\n      );\n    }\n  }\n}\n\nfunction assertStringArray(value: unknown, path: string): readonly string[] {\n  if (\n    !Array.isArray(value) ||\n    value.some(\n      (entry) => typeof entry !== \"string\" || entry.trim().length === 0\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      `${path} must be an array of non-empty strings.`\n    );\n  }\n  return value as readonly string[];\n}\n\nfunction assertUniqueStrings(values: readonly string[], path: string): void {\n  const normalized = values.map((value) => value.trim());\n  if (new Set(normalized).size !== normalized.length) {\n    throw new InvalidConfigurationError(`${path} must not contain duplicates.`);\n  }\n}\n\n/**\n * Parses and validates an untrusted camera configuration.\n *\n * @param value Unknown external data.\n * @returns The original value narrowed to CameraConfiguration.\n */\nexport function parseCameraConfiguration(\n  value: unknown\n): CameraConfiguration {\n  const camera = requireRecord(value, \"camera\", [\"sensor\", \"lens\", \"exposure\", \"focus\", \"stabilization\"]);\n\n  const sensor = requireRecord(camera.sensor, \"camera.sensor\", [\"widthMm\", \"heightMm\", \"pixelWidth\", \"pixelHeight\"]);\n  requirePositiveNumber(sensor, \"widthMm\", \"camera.sensor\");\n  requirePositiveNumber(sensor, \"heightMm\", \"camera.sensor\");\n  requirePositiveIntegerValue(sensor, \"pixelWidth\", \"camera.sensor\");\n  requirePositiveIntegerValue(sensor, \"pixelHeight\", \"camera.sensor\");\n\n  const lens = requireRecord(camera.lens, \"camera.lens\", [\"focalLengthMm\", \"aperture\"]);\n  requirePositiveNumber(lens, \"focalLengthMm\", \"camera.lens\");\n  requirePositiveNumber(lens, \"aperture\", \"camera.lens\");\n\n  const exposure = requireRecord(camera.exposure, \"camera.exposure\", [\"shutterSeconds\", \"iso\"]);\n  requirePositiveNumber(exposure, \"shutterSeconds\", \"camera.exposure\");\n  requirePositiveNumber(exposure, \"iso\", \"camera.exposure\");\n\n  const focus = requireRecord(camera.focus, \"camera.focus\", [\"focusDistanceM\"]);\n  requirePositiveNumber(focus, \"focusDistanceM\", \"camera.focus\");\n\n  if (camera.stabilization !== undefined) {\n    const stabilization = requireRecord(\n      camera.stabilization,\n      \"camera.stabilization\", [\"bodyEnabled\", \"lensEnabled\", \"support\"]\n    );\n    requireBoolean(stabilization, \"bodyEnabled\", \"camera.stabilization\");\n    requireBoolean(stabilization, \"lensEnabled\", \"camera.stabilization\");\n    const support = requireString(\n      stabilization,\n      \"support\",\n      \"camera.stabilization\"\n    );\n    if (!CAMERA_SUPPORTS.has(support as CameraSupport)) {\n      throw new InvalidConfigurationError(\n        \"camera.stabilization.support is invalid.\"\n      );\n    }\n  }\n\n  return value as CameraConfiguration;\n}\n\n/**\n * Parses and validates an untrusted renderer-independent scene definition.\n *\n * @param value Unknown external data.\n * @returns The original value narrowed to SceneDefinition.\n */\nexport function parseSceneDefinition(value: unknown): SceneDefinition {\n  const scene = requireRecord(value, \"scene\", [\"schemaVersion\", \"id\", \"version\", \"radiometry\", \"capabilities\", \"objects\", \"focusTargetIds\"]);\n  requireString(scene, \"schemaVersion\", \"scene\");\n  requireString(scene, \"id\", \"scene\");\n  requireString(scene, \"version\", \"scene\");\n\n  const radiometry = requireRecord(scene.radiometry, \"scene.radiometry\", null);\n  rejectUnknownVariantFields(radiometry, \"kind\", { \"relative-linear\": [\"kind\", \"referenceValue\"], \"absolute-luminance\": [\"kind\", \"referenceValue\", \"referenceLuminanceCdM2\"] }, \"scene.radiometry\");\n  const radiometryKind = requireString(\n    radiometry,\n    \"kind\",\n    \"scene.radiometry\"\n  );\n  requirePositiveNumber(radiometry, \"referenceValue\", \"scene.radiometry\");\n\n  if (radiometryKind === \"absolute-luminance\") {\n    requirePositiveNumber(\n      radiometry,\n      \"referenceLuminanceCdM2\",\n      \"scene.radiometry\"\n    );\n  } else if (radiometryKind !== \"relative-linear\") {\n    throw new InvalidConfigurationError(\"scene.radiometry.kind is invalid.\");\n  }\n\n  const capabilities = assertStringArray(\n    scene.capabilities,\n    \"scene.capabilities\"\n  );\n  assertUniqueStrings(capabilities, \"scene.capabilities\");\n  for (const capability of capabilities) {\n    if (!SCENE_CAPABILITIES.has(capability as SceneCapability)) {\n      throw new InvalidConfigurationError(\n        `Unknown scene capability: ${capability}`\n      );\n    }\n  }\n\n  if (!Array.isArray(scene.objects)) {\n    throw new InvalidConfigurationError(\"scene.objects must be an array.\");\n  }\n\n  const objectIds: string[] = [];\n  scene.objects.forEach((objectValue, index) => {\n    const path = `scene.objects[${index}]`;\n    const object = requireRecord(objectValue, path, [\"id\", \"distanceM\", \"label\", \"tags\", \"motion\"]);\n    objectIds.push(requireString(object, \"id\", path));\n    requirePositiveNumber(object, \"distanceM\", path);\n\n    if (object.label !== undefined && typeof object.label !== \"string\") {\n      throw new InvalidConfigurationError(`${path}.label must be a string.`);\n    }\n    if (object.tags !== undefined) {\n      assertStringArray(object.tags, `${path}.tags`);\n    }\n    if (object.motion !== undefined) {\n      const motion = requireRecord(object.motion, `${path}.motion`, [\"linearVelocityMps\", \"angularVelocityRadPerSec\"]);\n      assertVector3(\n        motion.linearVelocityMps,\n        `${path}.motion.linearVelocityMps`\n      );\n      if (motion.angularVelocityRadPerSec !== undefined) {\n        assertVector3(\n          motion.angularVelocityRadPerSec,\n          `${path}.motion.angularVelocityRadPerSec`\n        );\n      }\n    }\n  });\n  assertUniqueStrings(objectIds, \"scene.objects[].id\");\n\n  if (scene.focusTargetIds !== undefined) {\n    const focusTargetIds = assertStringArray(\n      scene.focusTargetIds,\n      \"scene.focusTargetIds\"\n    );\n    assertUniqueStrings(focusTargetIds, \"scene.focusTargetIds\");\n    const knownIds = new Set(objectIds);\n    for (const focusTargetId of focusTargetIds) {\n      if (!knownIds.has(focusTargetId)) {\n        throw new InvalidConfigurationError(\n          `Unknown scene focus target: ${focusTargetId}`\n        );\n      }\n    }\n  }\n\n  return value as SceneDefinition;\n}\n"]}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/schema/validation.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Runtime parsers for untrusted camera configurations and scene definitions.\n * @see docs/SCENE_RADIANCE_AND_ILLUMINATION.md for equations, coordinate/unit conventions, blockers\n * and support limits.\n */\n\nimport { rejectUnknownVariantFields, requireConfigRecord as requireRecord, requireConfigRecordString as requireString } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nexport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nimport type {\n  CameraConfiguration,\n  CameraSupport\n} from \"./camera.js\";\nimport type {\n  SceneCapability,\n  SceneDefinition\n} from \"./scene.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nconst CAMERA_SUPPORTS = new Set<CameraSupport>([\n  \"handheld\",\n  \"braced\",\n  \"monopod\",\n  \"tripod\"\n]);\n\nconst SCENE_CAPABILITIES = new Set<SceneCapability>([\n  \"scene-linear-rgb\",\n  \"metric-depth\",\n  \"segmentation\",\n  \"occlusion-layers\",\n  \"motion-vectors\",\n  \"focus-targets\",\n  \"multi-resolution-layers\",\n  \"absolute-radiometry\"\n]);\n\nfunction requireBoolean(\n  record: UnknownRecord,\n  key: string,\n  path: string\n): boolean {\n  const value = record[key];\n  if (typeof value !== \"boolean\") {\n    throw new InvalidConfigurationError(\n      `${path}.${key} must be a boolean.`\n    );\n  }\n  return value;\n}\n\nexport function requirePositiveNumber(\n  record: UnknownRecord,\n  key: string,\n  path: string\n): number {\n  const value = record[key];\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new InvalidConfigurationError(\n      `${path}.${key} must be a finite number greater than zero.`\n    );\n  }\n  return value;\n}\n\nfunction requirePositiveIntegerValue(\n  record: UnknownRecord,\n  key: string,\n  path: string\n): number {\n  const value = record[key];\n  if (!Number.isSafeInteger(value) || (value as number) <= 0) {\n    throw new InvalidConfigurationError(\n      `${path}.${key} must be a positive safe integer.`\n    );\n  }\n  return value as number;\n}\n\nfunction assertVector3(value: unknown, path: string): void {\n  const vector = requireRecord(value, path, [\"x\", \"y\", \"z\"]);\n  for (const component of [\"x\", \"y\", \"z\"] as const) {\n    const coordinate = vector[component];\n    if (typeof coordinate !== \"number\" || !Number.isFinite(coordinate)) {\n      throw new InvalidConfigurationError(\n        `${path}.${component} must be a finite number.`\n      );\n    }\n  }\n}\n\nfunction assertStringArray(value: unknown, path: string): readonly string[] {\n  if (\n    !Array.isArray(value) ||\n    value.some(\n      (entry) => typeof entry !== \"string\" || entry.trim().length === 0\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      `${path} must be an array of non-empty strings.`\n    );\n  }\n  return value as readonly string[];\n}\n\nfunction assertUniqueStrings(values: readonly string[], path: string): void {\n  const normalized = values.map((value) => value.trim());\n  if (new Set(normalized).size !== normalized.length) {\n    throw new InvalidConfigurationError(`${path} must not contain duplicates.`);\n  }\n}\n\n/**\n * Parses and validates an untrusted camera configuration.\n *\n * @param value Unknown external data.\n * @returns The original value narrowed to CameraConfiguration.\n */\nexport function parseCameraConfiguration(\n  value: unknown\n): CameraConfiguration {\n  const camera = requireRecord(value, \"camera\", [\"sensor\", \"lens\", \"exposure\", \"focus\", \"stabilization\"]);\n\n  const sensor = requireRecord(camera.sensor, \"camera.sensor\", [\"widthMm\", \"heightMm\", \"pixelWidth\", \"pixelHeight\"]);\n  requirePositiveNumber(sensor, \"widthMm\", \"camera.sensor\");\n  requirePositiveNumber(sensor, \"heightMm\", \"camera.sensor\");\n  requirePositiveIntegerValue(sensor, \"pixelWidth\", \"camera.sensor\");\n  requirePositiveIntegerValue(sensor, \"pixelHeight\", \"camera.sensor\");\n\n  const lens = requireRecord(camera.lens, \"camera.lens\", [\"focalLengthMm\", \"aperture\"]);\n  requirePositiveNumber(lens, \"focalLengthMm\", \"camera.lens\");\n  requirePositiveNumber(lens, \"aperture\", \"camera.lens\");\n\n  const exposure = requireRecord(camera.exposure, \"camera.exposure\", [\"shutterSeconds\", \"iso\"]);\n  requirePositiveNumber(exposure, \"shutterSeconds\", \"camera.exposure\");\n  requirePositiveNumber(exposure, \"iso\", \"camera.exposure\");\n\n  const focus = requireRecord(camera.focus, \"camera.focus\", [\"focusDistanceM\"]);\n  requirePositiveNumber(focus, \"focusDistanceM\", \"camera.focus\");\n\n  if (camera.stabilization !== undefined) {\n    const stabilization = requireRecord(\n      camera.stabilization,\n      \"camera.stabilization\", [\"bodyEnabled\", \"lensEnabled\", \"support\"]\n    );\n    requireBoolean(stabilization, \"bodyEnabled\", \"camera.stabilization\");\n    requireBoolean(stabilization, \"lensEnabled\", \"camera.stabilization\");\n    const support = requireString(\n      stabilization,\n      \"support\",\n      \"camera.stabilization\"\n    );\n    if (!CAMERA_SUPPORTS.has(support as CameraSupport)) {\n      throw new InvalidConfigurationError(\n        \"camera.stabilization.support is invalid.\"\n      );\n    }\n  }\n\n  return value as CameraConfiguration;\n}\n\n/**\n * Parses and validates an untrusted renderer-independent scene definition.\n *\n * @param value Unknown external data.\n * @returns The original value narrowed to SceneDefinition.\n */\nexport function parseSceneDefinition(value: unknown): SceneDefinition {\n  const scene = requireRecord(value, \"scene\", [\"schemaVersion\", \"id\", \"version\", \"radiometry\", \"capabilities\", \"objects\", \"focusTargetIds\"]);\n  requireString(scene, \"schemaVersion\", \"scene\");\n  requireString(scene, \"id\", \"scene\");\n  requireString(scene, \"version\", \"scene\");\n\n  const radiometry = requireRecord(scene.radiometry, \"scene.radiometry\", null);\n  rejectUnknownVariantFields(radiometry, \"kind\", { \"relative-linear\": [\"kind\", \"referenceValue\"], \"absolute-luminance\": [\"kind\", \"referenceValue\", \"referenceLuminanceCdM2\"] }, \"scene.radiometry\");\n  const radiometryKind = requireString(\n    radiometry,\n    \"kind\",\n    \"scene.radiometry\"\n  );\n  requirePositiveNumber(radiometry, \"referenceValue\", \"scene.radiometry\");\n\n  if (radiometryKind === \"absolute-luminance\") {\n    requirePositiveNumber(\n      radiometry,\n      \"referenceLuminanceCdM2\",\n      \"scene.radiometry\"\n    );\n  } else if (radiometryKind !== \"relative-linear\") {\n    throw new InvalidConfigurationError(\"scene.radiometry.kind is invalid.\");\n  }\n\n  const capabilities = assertStringArray(\n    scene.capabilities,\n    \"scene.capabilities\"\n  );\n  assertUniqueStrings(capabilities, \"scene.capabilities\");\n  for (const capability of capabilities) {\n    if (!SCENE_CAPABILITIES.has(capability as SceneCapability)) {\n      throw new InvalidConfigurationError(\n        `Unknown scene capability: ${capability}`\n      );\n    }\n  }\n\n  if (!Array.isArray(scene.objects)) {\n    throw new InvalidConfigurationError(\"scene.objects must be an array.\");\n  }\n\n  const objectIds: string[] = [];\n  scene.objects.forEach((objectValue, index) => {\n    const path = `scene.objects[${index}]`;\n    const object = requireRecord(objectValue, path, [\"id\", \"distanceM\", \"label\", \"tags\", \"motion\"]);\n    objectIds.push(requireString(object, \"id\", path));\n    requirePositiveNumber(object, \"distanceM\", path);\n\n    if (object.label !== undefined && typeof object.label !== \"string\") {\n      throw new InvalidConfigurationError(`${path}.label must be a string.`);\n    }\n    if (object.tags !== undefined) {\n      assertStringArray(object.tags, `${path}.tags`);\n    }\n    if (object.motion !== undefined) {\n      const motion = requireRecord(object.motion, `${path}.motion`, [\"linearVelocityMps\", \"angularVelocityRadPerSec\"]);\n      assertVector3(\n        motion.linearVelocityMps,\n        `${path}.motion.linearVelocityMps`\n      );\n      if (motion.angularVelocityRadPerSec !== undefined) {\n        assertVector3(\n          motion.angularVelocityRadPerSec,\n          `${path}.motion.angularVelocityRadPerSec`\n        );\n      }\n    }\n  });\n  assertUniqueStrings(objectIds, \"scene.objects[].id\");\n\n  if (scene.focusTargetIds !== undefined) {\n    const focusTargetIds = assertStringArray(\n      scene.focusTargetIds,\n      \"scene.focusTargetIds\"\n    );\n    assertUniqueStrings(focusTargetIds, \"scene.focusTargetIds\");\n    const knownIds = new Set(objectIds);\n    for (const focusTargetId of focusTargetIds) {\n      if (!knownIds.has(focusTargetId)) {\n        throw new InvalidConfigurationError(\n          `Unknown scene focus target: ${focusTargetId}`\n        );\n      }\n    }\n  }\n\n  return value as SceneDefinition;\n}\n"]}

package/dist/sensor/accumulated-charge.js

@@ -17,55 +17,8 @@ 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;
-    state.correction =
-        (next - state.sum) - adjusted;
-    state.sum = next;
-}
-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) {
-    if (typeof value !== "string" ||
-        value.trim().length === 0) {
-        throw new InvalidConfigurationError(path + " must be a non-empty string.");
-    }
-    return value;
-}
-function requireFinite(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isFinite(value)) {
-        throw new InvalidConfigurationError(path + " must be finite.");
-    }
-    return value;
-}
-function requireNonNegativeFinite(value, path) {
-    const parsed = requireFinite(value, path);
-    if (parsed < 0) {
-        throw new InvalidConfigurationError(path +
-            " must be greater than or equal to zero.");
-    }
-    return parsed;
-}
-function requireSiteIndex(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isSafeInteger(value) ||
-        value < 0) {
-        throw new InvalidConfigurationError(path +
-            " must be a non-negative safe integer.");
-    }
-    return value;
-}
+import { requireInputObject, requireInputKeys, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS, requireConfigRecord as requireRecord, requireConfigFinite as requireFinite, requireConfigString as requireNonEmptyString, parseConfigScientificStatus as parseStatus, requireConfigNonNegativeSafeInteger as requireSiteIndex, requireConfigFiniteAtLeastZero as requireNonNegativeFinite } from "../core/record-validation.js";
+import { addCompensated, sameSite } from "../core/shared-helpers.js";
 function parseUncertainty(value, path) {
     const record = requireRecord(value, path, null);
     rejectUnknownVariantFields(record, "kind", UNCERTAINTY_VARIANT_FIELDS, path);
@@ -85,13 +38,6 @@ function parseUncertainty(value, path) {
     }
     throw new InvalidConfigurationError(path + ".kind is invalid.");
 }
-function parseStatus(value, path) {
-    if (value !== "calibrated" &&
-        value !== "approximation") {
-        throw new InvalidConfigurationError(path + " is invalid.");
-    }
-    return value;
-}
 function parseWindowIdentity(record, path) {
     if (record.timeReference !==
         "first-opening-boundary-phase") {
@@ -230,9 +176,6 @@ export function parseSensorAccumulatedChargeCompletenessProfile(value) {
             : { limitation })
     };
 }
-function sameSite(a, b) {
-    return a.x === b.x && a.y === b.y;
-}
 function sameWindow(startA, endA, startB, endB) {
     return (startA === startB &&
         endA === endB);

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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","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"]}
+{"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, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS, requireConfigRecord as requireRecord, requireConfigFinite as requireFinite, requireConfigString as requireNonEmptyString, parseConfigScientificStatus as parseStatus, requireConfigNonNegativeSafeInteger as requireSiteIndex, requireConfigFiniteAtLeastZero as requireNonNegativeFinite } from \"../core/record-validation.js\";\nimport { addCompensated, sameSite } from \"../core/shared-helpers.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 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 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 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.js

@@ -9,8 +9,8 @@
  * limits.
  */
 import { parseEvidenceList } from "../core/evidence-provenance.js";
-import { rejectUnknownFields } from "../core/record-validation.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { requireConfigRecord as requireRecord, requireConfigRecordString as requireNonEmptyString } from "../core/record-validation.js";
 export const SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION = "0.3.0";
 const LEGACY_SENSOR_ARCHITECTURE_PROFILE_SCHEMA_VERSION = "0.2.0";
 const TECHNOLOGY_FAMILY_VALUES = new Set([
@@ -37,21 +37,6 @@ const COLOR_SAMPLING_VALUES = new Set([
     "custom-rgb-mosaic",
     "layered-color"
 ]);
-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) {
-    const value = record[key];
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new InvalidConfigurationError(`${path}.${key} must be a non-empty string.`);
-    }
-    return value;
-}
 function parseScalarFact(value, path, allowed) {
     const record = requireRecord(value, path, ["value", "evidence"]);
     const factValue = requireNonEmptyString(record, "value", path);

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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","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"]}
+{"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 { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { requireConfigRecord as requireRecord, requireConfigRecordString as requireNonEmptyString } from \"../core/record-validation.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 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

@@ -105,6 +105,7 @@ export interface SensorCameraSaturationCapacityAssessment {
         chargeCompleteness: SensorAccumulatedChargeComposition["componentEvidence"]["completeness"];
     };
 }
+export declare function parseUncertainty(value: unknown, path: string): SensorSpectralResponseUncertainty;
 /**
  * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,
  * missing required fields and inconsistent scientific data are rejected.

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

@@ -14,58 +14,9 @@ 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";
-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) {
-    if (typeof value !== "string" ||
-        value.trim().length === 0) {
-        throw new InvalidConfigurationError(path + " must be a non-empty string.");
-    }
-    return value;
-}
-function requireFinite(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isFinite(value)) {
-        throw new InvalidConfigurationError(path + " must be finite.");
-    }
-    return value;
-}
-function requirePositiveFinite(value, path) {
-    const parsed = requireFinite(value, path);
-    if (parsed <= 0) {
-        throw new InvalidConfigurationError(path +
-            " must be greater than zero.");
-    }
-    return parsed;
-}
-function requireNonNegativeFiniteInput(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isFinite(value) ||
-        value < 0) {
-        throw new InvalidScientificInputError(path +
-            " must be finite and greater than or equal to zero.");
-    }
-    return value;
-}
-function requireSiteIndex(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isSafeInteger(value) ||
-        value < 0) {
-        throw new InvalidConfigurationError(path +
-            " must be a non-negative safe integer.");
-    }
-    return value;
-}
-function parseUncertainty(value, path) {
+import { requireInputObject, requireInputKeys, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS, requireConfigRecord as requireRecord, requireConfigFinite as requireFinite, requireConfigString as requireNonEmptyString, requireInputNonNegativeFinite as requireNonNegativeFiniteInput, requireConfigNonNegativeSafeInteger as requireSiteIndex, requireConfigFiniteAboveZero as requirePositiveFinite } from "../core/record-validation.js";
+import { sameSite } from "../core/shared-helpers.js";
+export function parseUncertainty(value, path) {
     const record = requireRecord(value, path, null);
     rejectUnknownVariantFields(record, "kind", UNCERTAINTY_VARIANT_FIELDS, path);
     if (record.kind === "relative") {
@@ -204,9 +155,6 @@ export function parseSensorCameraSaturationCapacityProfile(value) {
         temperatureApplicability
     };
 }
-function sameSite(a, b) {
-    return a.x === b.x && a.y === b.y;
-}
 function validateCharge(charge) {
     requireInputObject(charge, "charge input");
     if (charge.accumulatedChargeCompleteness !==