@photivra/engine 1.5.0 → 2.1.0

package/dist/sensor/readout-timing.d.ts

@@ -1,13 +1,15 @@
 /**
- * Module boundary and integration notes.
- * Resolves a capture-specific native sensor readout scan schedule. Rolling readout uses a
- * uniform-linear single-axis approximation across the declared active capture. The caller supplies the
- * spatial timing span explicitly; it is never inferred from total data-readout duration, active crop
- * dimensions, native raster density, output resolution, sensor architecture metadata, or shutter
- * mechanism. Global readout has no spatial phase skew in this model even when a non-zero data-readout
- * duration is declared. This foundation does not define local exposure start/end times, mechanical
- * curtain travel, EFCS curtain behavior, rolling-shutter image distortion, flash/flicker interactions,
- * or motion integration.
+ * Sensor readout timing: when each position on the sensor is read out during one capture.
+ *
+ * Rolling readout is modelled as a uniform linear scan along one axis of the declared active capture.
+ * The caller supplies the scan's time span (skew) explicitly. It is never worked out from the total
+ * data-readout time, the crop size, pixel density, output resolution, sensor-architecture metadata or
+ * the shutter mechanism. Global readout has no skew in this model, even when a non-zero data-readout
+ * time is declared.
+ *
+ * Not covered here: local exposure start and end times, mechanical curtain travel, EFCS (electronic
+ * first-curtain shutter) behaviour, rolling-shutter image distortion, flash or flicker, and motion
+ * integration.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -17,11 +19,11 @@ import type { RasterPoint, RasterRect } from "../output/capture-geometry.js";
 import type { NativeImageRaster } from "./sensor-geometry.js";
 import type { SensorReadoutArchitecture } from "./architecture.js";
 /**
- * Readout architecture selected for one capture.
+ * The readout mode chosen for one capture.
  *
- * This reuses the architecture vocabulary but is not a hardware-capability
- * assertion. SensorArchitectureProfile.readoutCapabilities remains descriptive
- * metadata and is not consulted automatically.
+ * It uses the same names as the architecture metadata, but does not claim the
+ * hardware supports it. SensorArchitectureProfile.readoutCapabilities is
+ * descriptive only and is not checked automatically.
  */
 export type SensorReadoutMode = SensorReadoutArchitecture;
 export type NativeSensorReadoutScanDirection = "top-to-bottom" | "bottom-to-top" | "left-to-right" | "right-to-left";
@@ -36,9 +38,9 @@ export type SourcedSensorReadoutFact<T> = EvidenceBackedFact<T>;
 export interface GlobalSensorReadoutTimingDeclaration {
     readoutMode: "global";
     /**
-     * Capture-specific sensor data-readout duration.
+     * Sensor data-readout time for this capture.
      *
-     * This is deliberately not interpreted as spatial exposure/readout skew.
+     * It is deliberately not treated as the spatial exposure or readout skew.
      */
     captureReadoutDurationSeconds: SourcedSensorTimingSeconds;
     scanDirectionNative?: never;
@@ -47,11 +49,10 @@ export interface GlobalSensorReadoutTimingDeclaration {
 export interface RollingSensorReadoutTimingDeclaration {
     readoutMode: "rolling";
     /**
-     * Capture-specific sensor data-readout duration.
+     * Sensor data-readout time for this capture.
      *
-     * This fact is retained independently from spatial sampling skew because
-     * published/declared readout duration and the spatial timing span need not be
-     * treated as the same quantity.
+     * It is kept separate from the spatial skew, because a published readout time
+     * and the scan's time span are not necessarily the same quantity.
      */
     captureReadoutDurationSeconds: SourcedSensorTimingSeconds;
     /**
@@ -59,8 +60,8 @@ export interface RollingSensorReadoutTimingDeclaration {
      */
     scanDirectionNative: SourcedSensorReadoutFact<NativeSensorReadoutScanDirection>;
     /**
-     * Time difference between the first and last spatial scan positions in the
-     * uniform-linear timing approximation.
+     * Time between the first and last scan positions, in the uniform linear
+     * timing approximation (the readout skew).
      */
     spatialSamplingSkewSeconds: SourcedSensorTimingSeconds;
 }
@@ -68,23 +69,23 @@ export type SensorReadoutTimingDeclaration = GlobalSensorReadoutTimingDeclaratio
 export interface CalculateSensorReadoutTimingInput {
     nativeRaster: NativeImageRaster;
     /**
-     * Active capture rectangle in invariant native raster coordinates.
+     * Active capture rectangle, in fixed native pixel coordinates.
      *
-     * Defaults to the complete native raster. Timing is never inferred by
-     * scaling a full-frame value to this rectangle.
+     * Defaults to the whole native image. Timing is never worked out by scaling
+     * a full-frame value to this rectangle.
      */
     activeCaptureRect?: RasterRect;
     /**
-     * Selected shutter mechanism for the capture.
+     * The shutter mechanism chosen for the capture.
      *
-     * It is reported independently and does not modify the sensor timing
-     * schedule in this foundation.
+     * It is reported separately and does not change the sensor readout timing
+     * in this model.
      */
     shutterMechanism: CaptureShutterMechanism;
     readout: SensorReadoutTimingDeclaration;
     /**
-     * Optional continuous native raster edge-coordinate points for timing
-     * diagnostics. Pixel centers may be represented with +0.5 offsets.
+     * Optional points, in continuous native pixel coordinates measured from pixel
+     * edges, to report timing for. A pixel centre is at +0.5.
      */
     samplePointsNative?: readonly RasterPoint[];
 }
@@ -92,10 +93,9 @@ export interface SensorReadoutTimingSample {
     pointNative: RasterPoint;
     normalizedScanPosition: number | null;
     /**
-     * Relative native-sensor readout phase in seconds.
+     * Readout time of this point, in seconds, relative to the first scan position (0).
      *
-     * Zero is the first spatial scan position. This is not automatically an
-     * exposure-start time or shutter-curtain time.
+     * It is not automatically an exposure-start time or a shutter-curtain time.
      */
     readoutPhaseOffsetSeconds: number;
 }
@@ -118,20 +118,19 @@ export interface SensorReadoutTiming {
     samples: readonly SensorReadoutTimingSample[];
 }
 /**
- * Resolves a capture-specific native sensor readout scan schedule.
+ * Resolves the sensor readout scan schedule for one capture.
  *
- * Rolling readout uses a uniform-linear single-axis approximation across the
- * declared active capture. The caller supplies the spatial timing span
- * explicitly; it is never inferred from total data-readout duration, active
- * crop dimensions, native raster density, output resolution, sensor
- * architecture metadata, or shutter mechanism.
+ * Rolling readout is modelled as a uniform linear scan along one axis of the
+ * declared active capture. The caller supplies the scan's time span (skew)
+ * explicitly. It is never worked out from the total data-readout time, crop
+ * size, pixel density, output resolution, sensor-architecture metadata or the
+ * shutter mechanism.
  *
- * Global readout has no spatial phase skew in this model even when a non-zero
- * data-readout duration is declared.
+ * Global readout has no skew in this model, even when a non-zero data-readout
+ * time is declared.
  *
- * This foundation does not define local exposure start/end times, mechanical
- * curtain travel, EFCS curtain behavior, rolling-shutter image distortion,
- * flash/flicker interactions, or motion integration.
+ * Not covered: local exposure start and end times, mechanical curtain travel,
+ * EFCS (electronic first-curtain shutter) behaviour, rolling-shutter image
+ * distortion, flash or flicker, and motion integration.
  */
 export declare function calculateSensorReadoutTiming(input: CalculateSensorReadoutTimingInput): CalculationResult<SensorReadoutTiming>;
-//# sourceMappingURL=readout-timing.d.ts.map

package/dist/sensor/readout-timing.js

@@ -1,20 +1,24 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Resolves a capture-specific native sensor readout scan schedule. Rolling readout uses a
- * uniform-linear single-axis approximation across the declared active capture. The caller supplies the
- * spatial timing span explicitly; it is never inferred from total data-readout duration, active crop
- * dimensions, native raster density, output resolution, sensor architecture metadata, or shutter
- * mechanism. Global readout has no spatial phase skew in this model even when a non-zero data-readout
- * duration is declared. This foundation does not define local exposure start/end times, mechanical
- * curtain travel, EFCS curtain behavior, rolling-shutter image distortion, flash/flicker interactions,
- * or motion integration.
+ * Sensor readout timing: when each position on the sensor is read out during one capture.
+ *
+ * Rolling readout is modelled as a uniform linear scan along one axis of the declared active capture.
+ * The caller supplies the scan's time span (skew) explicitly. It is never worked out from the total
+ * data-readout time, the crop size, pixel density, output resolution, sensor-architecture metadata or
+ * the shutter mechanism. Global readout has no skew in this model, even when a non-zero data-readout
+ * time is declared.
+ *
+ * Not covered here: local exposure start and end times, mechanical curtain travel, EFCS (electronic
+ * first-curtain shutter) behaviour, rolling-shutter image distortion, flash or flicker, and motion
+ * integration.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
 import { approximationResult } from "../core/calculation-result.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError, requirePositiveInteger } from "../core/validation.js";
+import { requireInputObject, requireInputKeys, rejectUnknownFields } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
 const READOUT_MODES = new Set(["rolling", "global"]);
 const SCAN_DIRECTIONS = new Set([
     "top-to-bottom",
@@ -27,10 +31,12 @@ const SHUTTER_MECHANISMS = new Set([
     "electronic-first-curtain",
     "electronic"
 ]);
-function requireRecord(value, path) {
+function requireRecord(value, path, allowedKeys) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        throw new InvalidScientificInputError(path + " must be an object.");
+        throw new InvalidConfigurationError(path + " must be an object.");
     }
+    if (allowedKeys !== null)
+        rejectUnknownFields(value, allowedKeys, path);
     return value;
 }
 function requireNonNegativeInteger(name, value) {
@@ -51,9 +57,9 @@ function requirePositiveFinite(name, value) {
     return value;
 }
 function parseSecondsFact(value, path, positive) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["unit", "value", "evidence"]);
     if (record.unit !== "s") {
-        throw new InvalidScientificInputError(path + '.unit must be "s".');
+        throw new InvalidConfigurationError(path + '.unit must be "s".');
     }
     const seconds = positive
         ? requirePositiveFinite(path + ".value", record.value)
@@ -65,10 +71,10 @@ function parseSecondsFact(value, path, positive) {
     };
 }
 function parseDirectionFact(value, path) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["value", "evidence"]);
     if (typeof record.value !== "string" ||
         !SCAN_DIRECTIONS.has(record.value)) {
-        throw new InvalidScientificInputError(path + ".value is invalid.");
+        throw new InvalidConfigurationError(path + ".value is invalid.");
     }
     return {
         value: record.value,
@@ -76,10 +82,10 @@ function parseDirectionFact(value, path) {
     };
 }
 function parseReadoutDeclaration(value) {
-    const record = requireRecord(value, "readout");
+    const record = requireRecord(value, "readout", ["readoutMode", "captureReadoutDurationSeconds", "scanDirectionNative", "spatialSamplingSkewSeconds"]);
     if (typeof record.readoutMode !== "string" ||
         !READOUT_MODES.has(record.readoutMode)) {
-        throw new InvalidScientificInputError("readout.readoutMode is invalid.");
+        throw new InvalidConfigurationError("readout.readoutMode is invalid.");
     }
     const captureReadoutDurationSeconds = parseSecondsFact(record.captureReadoutDurationSeconds, "readout.captureReadoutDurationSeconds", false);
     if (record.readoutMode === "global") {
@@ -102,6 +108,7 @@ function parseReadoutDeclaration(value) {
     };
 }
 function validateNativeRaster(raster) {
+    requireInputObject(raster, "raster input");
     requirePositiveInteger("nativeRaster.pixelWidth", raster.pixelWidth);
     requirePositiveInteger("nativeRaster.pixelHeight", raster.pixelHeight);
 }
@@ -126,7 +133,7 @@ function validateActiveCaptureRect(rect, raster) {
 function validateShutterMechanism(value) {
     if (typeof value !== "string" ||
         !SHUTTER_MECHANISMS.has(value)) {
-        throw new InvalidScientificInputError("shutterMechanism is invalid.");
+        throw new InvalidConfigurationError("shutterMechanism is invalid.");
     }
 }
 function validatePointWithinActiveCapture(point, rect, index) {
@@ -167,22 +174,23 @@ function normalizedScanPosition(point, rect, direction) {
     }
 }
 /**
- * Resolves a capture-specific native sensor readout scan schedule.
+ * Resolves the sensor readout scan schedule for one capture.
  *
- * Rolling readout uses a uniform-linear single-axis approximation across the
- * declared active capture. The caller supplies the spatial timing span
- * explicitly; it is never inferred from total data-readout duration, active
- * crop dimensions, native raster density, output resolution, sensor
- * architecture metadata, or shutter mechanism.
+ * Rolling readout is modelled as a uniform linear scan along one axis of the
+ * declared active capture. The caller supplies the scan's time span (skew)
+ * explicitly. It is never worked out from the total data-readout time, crop
+ * size, pixel density, output resolution, sensor-architecture metadata or the
+ * shutter mechanism.
  *
- * Global readout has no spatial phase skew in this model even when a non-zero
- * data-readout duration is declared.
+ * Global readout has no skew in this model, even when a non-zero data-readout
+ * time is declared.
  *
- * This foundation does not define local exposure start/end times, mechanical
- * curtain travel, EFCS curtain behavior, rolling-shutter image distortion,
- * flash/flicker interactions, or motion integration.
+ * Not covered: local exposure start and end times, mechanical curtain travel,
+ * EFCS (electronic first-curtain shutter) behaviour, rolling-shutter image
+ * distortion, flash or flicker, and motion integration.
  */
 export function calculateSensorReadoutTiming(input) {
+    requireInputKeys(input, "calculateSensorReadoutTiming", ["nativeRaster", "activeCaptureRect", "shutterMechanism", "readout", "samplePointsNative"]);
     validateNativeRaster(input.nativeRaster);
     validateShutterMechanism(input.shutterMechanism);
     const readout = parseReadoutDeclaration(input.readout);
@@ -190,7 +198,7 @@ export function calculateSensorReadoutTiming(input) {
     validateActiveCaptureRect(activeCaptureRect, input.nativeRaster);
     if (input.samplePointsNative !== undefined &&
         !Array.isArray(input.samplePointsNative)) {
-        throw new InvalidScientificInputError("samplePointsNative must be an array when supplied.");
+        throw new InvalidConfigurationError("samplePointsNative must be an array when supplied.");
     }
     const scan = readout.readoutMode === "rolling"
         ? {

package/dist/sensor/readout-timing.js.map

@@ -1 +1 @@
-{"version":3,"file":"readout-timing.js","sourceRoot":"","sources":["../../src/sensor/readout-timing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"readout-timing.js","sourceRoot":"","sources":["../../src/sensor/readout-timing.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Sensor readout timing: when each position on the sensor is read out during one capture.\n *\n * Rolling readout is modelled as a uniform linear scan along one axis of the declared active capture.\n * The caller supplies the scan's time span (skew) explicitly. It is never worked out from the total\n * data-readout time, the crop size, pixel density, output resolution, sensor-architecture metadata or\n * the shutter mechanism. Global readout has no skew in this model, even when a non-zero data-readout\n * time is declared.\n *\n * Not covered here: local exposure start and end times, mechanical curtain travel, EFCS (electronic\n * first-curtain shutter) behaviour, rolling-shutter image distortion, flash or flicker, and motion\n * integration.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { approximationResult, type CalculationResult } from \"../core/calculation-result.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceBackedFact\n} from \"../core/evidence-provenance.js\";\nimport { InvalidScientificInputError, requirePositiveInteger } from \"../core/validation.js\";\nimport type { RasterPoint, RasterRect } from \"../output/capture-geometry.js\";\nimport type { NativeImageRaster } from \"./sensor-geometry.js\";\nimport type { SensorReadoutArchitecture } from \"./architecture.js\";\nimport { requireInputObject, requireInputKeys, rejectUnknownFields } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\n/**\n * The readout mode chosen for one capture.\n *\n * It uses the same names as the architecture metadata, but does not claim the\n * hardware supports it. SensorArchitectureProfile.readoutCapabilities is\n * descriptive only and is not checked automatically.\n */\nexport type SensorReadoutMode = SensorReadoutArchitecture;\n\nexport type NativeSensorReadoutScanDirection =\n  | \"top-to-bottom\"\n  | \"bottom-to-top\"\n  | \"left-to-right\"\n  | \"right-to-left\";\n\nexport type CaptureShutterMechanism =\n  | \"mechanical\"\n  | \"electronic-first-curtain\"\n  | \"electronic\";\n\n/**\n * Evidence-backed timing value with an explicit seconds unit.\n */\nexport interface SourcedSensorTimingSeconds\n  extends EvidenceBackedFact<number> {\n  unit: \"s\";\n}\n\nexport type SourcedSensorReadoutFact<T> = EvidenceBackedFact<T>;\n\nexport interface GlobalSensorReadoutTimingDeclaration {\n  readoutMode: \"global\";\n  /**\n   * Sensor data-readout time for this capture.\n   *\n   * It is deliberately not treated as the spatial exposure or readout skew.\n   */\n  captureReadoutDurationSeconds: SourcedSensorTimingSeconds;\n  scanDirectionNative?: never;\n  spatialSamplingSkewSeconds?: never;\n}\n\nexport interface RollingSensorReadoutTimingDeclaration {\n  readoutMode: \"rolling\";\n  /**\n   * Sensor data-readout time for this capture.\n   *\n   * It is kept separate from the spatial skew, because a published readout time\n   * and the scan's time span are not necessarily the same quantity.\n   */\n  captureReadoutDurationSeconds: SourcedSensorTimingSeconds;\n  /**\n   * Native-sensor scan direction for the selected capture mode.\n   */\n  scanDirectionNative: SourcedSensorReadoutFact<NativeSensorReadoutScanDirection>;\n  /**\n   * Time between the first and last scan positions, in the uniform linear\n   * timing approximation (the readout skew).\n   */\n  spatialSamplingSkewSeconds: SourcedSensorTimingSeconds;\n}\n\nexport type SensorReadoutTimingDeclaration =\n  | GlobalSensorReadoutTimingDeclaration\n  | RollingSensorReadoutTimingDeclaration;\n\nexport interface CalculateSensorReadoutTimingInput {\n  nativeRaster: NativeImageRaster;\n  /**\n   * Active capture rectangle, in fixed native pixel coordinates.\n   *\n   * Defaults to the whole native image. Timing is never worked out by scaling\n   * a full-frame value to this rectangle.\n   */\n  activeCaptureRect?: RasterRect;\n  /**\n   * The shutter mechanism chosen for the capture.\n   *\n   * It is reported separately and does not change the sensor readout timing\n   * in this model.\n   */\n  shutterMechanism: CaptureShutterMechanism;\n  readout: SensorReadoutTimingDeclaration;\n  /**\n   * Optional points, in continuous native pixel coordinates measured from pixel\n   * edges, to report timing for. A pixel centre is at +0.5.\n   */\n  samplePointsNative?: readonly RasterPoint[];\n}\n\nexport interface SensorReadoutTimingSample {\n  pointNative: RasterPoint;\n  normalizedScanPosition: number | null;\n  /**\n   * Readout time of this point, in seconds, relative to the first scan position (0).\n   *\n   * It is not automatically an exposure-start time or a shutter-curtain time.\n   */\n  readoutPhaseOffsetSeconds: number;\n}\n\nexport interface SensorReadoutTiming {\n  readoutMode: SensorReadoutMode;\n  shutterMechanism: CaptureShutterMechanism;\n  nativeRaster: NativeImageRaster;\n  activeCaptureRect: RasterRect;\n  captureReadoutDurationSeconds: SourcedSensorTimingSeconds;\n  maximumSpatialSamplingSkewSeconds: number;\n  scan:\n    | {\n        pattern: \"uniform-linear-single-axis\";\n        directionNative: SourcedSensorReadoutFact<NativeSensorReadoutScanDirection>;\n        unitVectorNative: { x: number; y: number };\n        spatialSamplingSkewSeconds: SourcedSensorTimingSeconds;\n      }\n    | null;\n  samples: readonly SensorReadoutTimingSample[];\n}\n\ntype UnknownRecord = Record<string, unknown>;\n\nconst READOUT_MODES = new Set<SensorReadoutMode>([\"rolling\", \"global\"]);\nconst SCAN_DIRECTIONS = new Set<NativeSensorReadoutScanDirection>([\n  \"top-to-bottom\",\n  \"bottom-to-top\",\n  \"left-to-right\",\n  \"right-to-left\"\n]);\nconst SHUTTER_MECHANISMS = new Set<CaptureShutterMechanism>([\n  \"mechanical\",\n  \"electronic-first-curtain\",\n  \"electronic\"\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 requireNonNegativeInteger(name: string, value: number): void {\n  if (!Number.isSafeInteger(value) || value < 0) {\n    throw new InvalidScientificInputError(\n      name + \" must be a non-negative safe integer.\"\n    );\n  }\n}\n\nfunction requireNonNegativeFinite(name: string, value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n    throw new InvalidScientificInputError(\n      name + \" must be a finite number greater than or equal to zero.\"\n    );\n  }\n  return value;\n}\n\nfunction requirePositiveFinite(name: string, value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new InvalidScientificInputError(\n      name + \" must be a finite number greater than zero.\"\n    );\n  }\n  return value;\n}\n\nfunction parseSecondsFact(\n  value: unknown,\n  path: string,\n  positive: boolean\n): SourcedSensorTimingSeconds {\n  const record = requireRecord(value, path, [\"unit\", \"value\", \"evidence\"]);\n  if (record.unit !== \"s\") {\n    throw new InvalidConfigurationError(path + '.unit must be \"s\".');\n  }\n\n  const seconds = positive\n    ? requirePositiveFinite(path + \".value\", record.value)\n    : requireNonNegativeFinite(path + \".value\", record.value);\n\n  return {\n    value: seconds,\n    unit: \"s\",\n    evidence: parseEvidenceList(record.evidence, path + \".evidence\")\n  };\n}\n\nfunction parseDirectionFact(\n  value: unknown,\n  path: string\n): SourcedSensorReadoutFact<NativeSensorReadoutScanDirection> {\n  const record = requireRecord(value, path, [\"value\", \"evidence\"]);\n  if (\n    typeof record.value !== \"string\" ||\n    !SCAN_DIRECTIONS.has(\n      record.value as NativeSensorReadoutScanDirection\n    )\n  ) {\n    throw new InvalidConfigurationError(path + \".value is invalid.\");\n  }\n\n  return {\n    value: record.value as NativeSensorReadoutScanDirection,\n    evidence: parseEvidenceList(record.evidence, path + \".evidence\")\n  };\n}\n\nfunction parseReadoutDeclaration(\n  value: unknown\n): SensorReadoutTimingDeclaration {\n  const record = requireRecord(value, \"readout\", [\"readoutMode\", \"captureReadoutDurationSeconds\", \"scanDirectionNative\", \"spatialSamplingSkewSeconds\"]);\n  if (\n    typeof record.readoutMode !== \"string\" ||\n    !READOUT_MODES.has(record.readoutMode as SensorReadoutMode)\n  ) {\n    throw new InvalidConfigurationError(\"readout.readoutMode is invalid.\");\n  }\n\n  const captureReadoutDurationSeconds = parseSecondsFact(\n    record.captureReadoutDurationSeconds,\n    \"readout.captureReadoutDurationSeconds\",\n    false\n  );\n\n  if (record.readoutMode === \"global\") {\n    if (record.scanDirectionNative !== undefined) {\n      throw new InvalidScientificInputError(\n        \"readout.scanDirectionNative must be omitted for global readout.\"\n      );\n    }\n    if (record.spatialSamplingSkewSeconds !== undefined) {\n      throw new InvalidScientificInputError(\n        \"readout.spatialSamplingSkewSeconds must be omitted for global readout.\"\n      );\n    }\n\n    return {\n      readoutMode: \"global\",\n      captureReadoutDurationSeconds\n    };\n  }\n\n  return {\n    readoutMode: \"rolling\",\n    captureReadoutDurationSeconds,\n    scanDirectionNative: parseDirectionFact(\n      record.scanDirectionNative,\n      \"readout.scanDirectionNative\"\n    ),\n    spatialSamplingSkewSeconds: parseSecondsFact(\n      record.spatialSamplingSkewSeconds,\n      \"readout.spatialSamplingSkewSeconds\",\n      true\n    )\n  };\n}\n\nfunction validateNativeRaster(raster: NativeImageRaster): void {\n  requireInputObject(raster, \"raster input\");\n  requirePositiveInteger(\"nativeRaster.pixelWidth\", raster.pixelWidth);\n  requirePositiveInteger(\"nativeRaster.pixelHeight\", raster.pixelHeight);\n}\n\nfunction fullRect(raster: NativeImageRaster): RasterRect {\n  return {\n    x: 0,\n    y: 0,\n    width: raster.pixelWidth,\n    height: raster.pixelHeight\n  };\n}\n\nfunction validateActiveCaptureRect(\n  rect: RasterRect,\n  raster: NativeImageRaster\n): void {\n  requireNonNegativeInteger(\"activeCaptureRect.x\", rect.x);\n  requireNonNegativeInteger(\"activeCaptureRect.y\", rect.y);\n  requirePositiveInteger(\"activeCaptureRect.width\", rect.width);\n  requirePositiveInteger(\"activeCaptureRect.height\", rect.height);\n\n  if (\n    rect.x + rect.width > raster.pixelWidth ||\n    rect.y + rect.height > raster.pixelHeight\n  ) {\n    throw new InvalidScientificInputError(\n      \"activeCaptureRect must fit entirely within nativeRaster.\"\n    );\n  }\n}\n\nfunction validateShutterMechanism(\n  value: unknown\n): asserts value is CaptureShutterMechanism {\n  if (\n    typeof value !== \"string\" ||\n    !SHUTTER_MECHANISMS.has(value as CaptureShutterMechanism)\n  ) {\n    throw new InvalidConfigurationError(\"shutterMechanism is invalid.\");\n  }\n}\n\nfunction validatePointWithinActiveCapture(\n  point: RasterPoint,\n  rect: RasterRect,\n  index: number\n): void {\n  if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) {\n    throw new InvalidScientificInputError(\n      \"samplePointsNative[\" + index + \"] coordinates must be finite.\"\n    );\n  }\n\n  if (\n    point.x < rect.x ||\n    point.x > rect.x + rect.width ||\n    point.y < rect.y ||\n    point.y > rect.y + rect.height\n  ) {\n    throw new InvalidScientificInputError(\n      \"samplePointsNative[\" +\n        index +\n        \"] must lie within activeCaptureRect edge-coordinate bounds.\"\n    );\n  }\n}\n\nfunction scanVector(\n  direction: NativeSensorReadoutScanDirection\n): { x: number; y: number } {\n  switch (direction) {\n    case \"top-to-bottom\":\n      return { x: 0, y: 1 };\n    case \"bottom-to-top\":\n      return { x: 0, y: -1 };\n    case \"left-to-right\":\n      return { x: 1, y: 0 };\n    case \"right-to-left\":\n      return { x: -1, y: 0 };\n  }\n}\n\nfunction normalizedScanPosition(\n  point: RasterPoint,\n  rect: RasterRect,\n  direction: NativeSensorReadoutScanDirection\n): number {\n  switch (direction) {\n    case \"top-to-bottom\":\n      return (point.y - rect.y) / rect.height;\n    case \"bottom-to-top\":\n      return 1 - (point.y - rect.y) / rect.height;\n    case \"left-to-right\":\n      return (point.x - rect.x) / rect.width;\n    case \"right-to-left\":\n      return 1 - (point.x - rect.x) / rect.width;\n  }\n}\n\n/**\n * Resolves the sensor readout scan schedule for one capture.\n *\n * Rolling readout is modelled as a uniform linear scan along one axis of the\n * declared active capture. The caller supplies the scan's time span (skew)\n * explicitly. It is never worked out from the total data-readout time, crop\n * size, pixel density, output resolution, sensor-architecture metadata or the\n * shutter mechanism.\n *\n * Global readout has no skew in this model, even when a non-zero data-readout\n * time is declared.\n *\n * Not covered: local exposure start and end times, mechanical curtain travel,\n * EFCS (electronic first-curtain shutter) behaviour, rolling-shutter image\n * distortion, flash or flicker, and motion integration.\n */\nexport function calculateSensorReadoutTiming(\n  input: CalculateSensorReadoutTimingInput\n): CalculationResult<SensorReadoutTiming> {\n  requireInputKeys(input, \"calculateSensorReadoutTiming\", [\"nativeRaster\", \"activeCaptureRect\", \"shutterMechanism\", \"readout\", \"samplePointsNative\"]);\n  validateNativeRaster(input.nativeRaster);\n  validateShutterMechanism(input.shutterMechanism);\n\n  const readout = parseReadoutDeclaration(input.readout);\n  const activeCaptureRect =\n    input.activeCaptureRect ?? fullRect(input.nativeRaster);\n  validateActiveCaptureRect(activeCaptureRect, input.nativeRaster);\n\n  if (\n    input.samplePointsNative !== undefined &&\n    !Array.isArray(input.samplePointsNative)\n  ) {\n    throw new InvalidConfigurationError(\n      \"samplePointsNative must be an array when supplied.\"\n    );\n  }\n\n  const scan =\n    readout.readoutMode === \"rolling\"\n      ? {\n          pattern: \"uniform-linear-single-axis\" as const,\n          directionNative: readout.scanDirectionNative,\n          unitVectorNative: scanVector(readout.scanDirectionNative.value),\n          spatialSamplingSkewSeconds: readout.spatialSamplingSkewSeconds\n        }\n      : null;\n\n  const samples = (input.samplePointsNative ?? []).map((point, index) => {\n    validatePointWithinActiveCapture(point, activeCaptureRect, index);\n\n    if (scan === null) {\n      return {\n        pointNative: { x: point.x, y: point.y },\n        normalizedScanPosition: null,\n        readoutPhaseOffsetSeconds: 0\n      };\n    }\n\n    const normalized = normalizedScanPosition(\n      point,\n      activeCaptureRect,\n      scan.directionNative.value\n    );\n\n    return {\n      pointNative: { x: point.x, y: point.y },\n      normalizedScanPosition: normalized,\n      readoutPhaseOffsetSeconds:\n        normalized * scan.spatialSamplingSkewSeconds.value\n    };\n  });\n\n  return approximationResult(\n    {\n      readoutMode: readout.readoutMode,\n      shutterMechanism: input.shutterMechanism,\n      nativeRaster: { ...input.nativeRaster },\n      activeCaptureRect: { ...activeCaptureRect },\n      captureReadoutDurationSeconds:\n        readout.captureReadoutDurationSeconds,\n      maximumSpatialSamplingSkewSeconds:\n        readout.readoutMode === \"rolling\"\n          ? readout.spatialSamplingSkewSeconds.value\n          : 0,\n      scan,\n      samples\n    },\n    \"native-sensor-readout-scan-timing\",\n    \"1.0.0\",\n    [\n      \"Native raster coordinates use top-left origin, +X right and +Y down and remain invariant under physical camera orientation.\",\n      \"Rolling timing uses a uniform-linear single-axis approximation over continuous effective native-raster coordinates.\",\n      \"NativeImageRaster is an effective image-sampling grid; the timing map does not assert one raster row or column equals one physical photodiode or hardware readout line.\",\n      \"Capture data-readout duration and spatial sampling skew are independently declared facts; no equality or ordering relationship is inferred between them.\",\n      \"Global readout has zero spatial sampling skew in this model even when capture data-readout duration is non-zero.\",\n      \"Active-capture timing is caller-declared and is not inferred by scaling full-frame timing by crop dimensions.\",\n      \"Physical orientation and digital output crop/resolution are downstream of this invariant native timing schedule.\",\n      \"Shutter mechanism is reported independently and does not alter the sensor scan schedule in this foundation.\",\n      \"The model does not represent segmented, center-out, interleaved, multi-tap or other non-uniform readout patterns.\",\n      \"The model does not define exposure windows, shutter-curtain travel, rolling-shutter geometry distortion, flash/flicker interaction or camera/subject motion integration.\"\n    ]\n  );\n}\n"]}

package/dist/sensor/response-application-compatibility.d.ts

@@ -1,15 +1,11 @@
 /**
- * Module boundary and integration notes.
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary. Response application
- * checks exact profile/channel, source plane, incident-area basis, spatial uniformity and reference
- * conditions. Structural compatibility alone does not authorize signal conversion; per-bin
- * operating-range validity and the typed EQE/A-W path are separate gates.
- * Assess whether exact source-plane, area, profile/channel and reference-condition bindings permit the
- * selected response application path. Response application checks exact profile/channel, source plane,
- * incident-area basis, spatial uniformity and reference conditions. Structural compatibility alone
- * does not authorize signal conversion; per-bin operating-range validity and the typed EQE/A-W path
- * are separate gates.
+ * Response application compatibility: checks that a measured sensor response can be applied to this
+ * light input.
+ *
+ * It checks the exact profile and channel, the plane where the input light is measured (source
+ * plane), the area the response refers to, spatial uniformity and the reference conditions of the
+ * measurement. Passing this check alone does not allow converting light to signal. The per-bin
+ * operating-range check and the EQE or A/W conversion are separate steps.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -108,29 +104,26 @@ export interface SensorResponseApplicationCompatibilityAssessment {
     };
 }
 /**
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary.
+ * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
  *
- * Response application checks exact profile/channel, source plane, incident-area basis, spatial
- * uniformity and reference conditions. Structural compatibility alone does not authorize signal
- * conversion; per-bin operating-range validity and the typed EQE/A-W path are separate gates.
- * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
- * @returns SensorResponseApplicationProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * The profile states the source plane, incident-area basis, spatial uniformity and reference
+ * conditions under which a response applies.
+ * @param value - Untrusted data. TypeScript types alone are not validation.
+ * @returns The result. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function parseSensorResponseApplicationProfile(value: unknown): SensorResponseApplicationProfile;
 /**
- * Assess whether exact source-plane, area, profile/channel and reference-condition bindings permit the
- * selected response application path.
+ * Checks whether the source plane, area, profile, channel and reference conditions allow the
+ * selected way of applying the response.
  *
- * Response application checks exact profile/channel, source plane, incident-area basis, spatial
- * uniformity and reference conditions. Structural compatibility alone does not authorize signal
- * conversion; per-bin operating-range validity and the typed EQE/A-W path are separate gates.
- * @param input - AssessSensorResponseApplicationCompatibilityInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns CalculationResult<SensorResponseApplicationCompatibilityAssessment>. Read structured blockers before consuming an authorization.
+ * Passing this alone does not allow converting light to signal. The per-bin operating-range check
+ * and the EQE or A/W conversion are separate steps.
+ * @param input - The input; see `AssessSensorResponseApplicationCompatibilityInput` for its fields, units and coordinates.
+ * @returns The assessment. Read its structured blockers before acting on an authorization.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function assessSensorResponseApplicationCompatibility(input: AssessSensorResponseApplicationCompatibilityInput): CalculationResult<SensorResponseApplicationCompatibilityAssessment>;
-//# sourceMappingURL=response-application-compatibility.d.ts.map

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

@@ -1,16 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary. Response application
- * checks exact profile/channel, source plane, incident-area basis, spatial uniformity and reference
- * conditions. Structural compatibility alone does not authorize signal conversion; per-bin
- * operating-range validity and the typed EQE/A-W path are separate gates.
- * Assess whether exact source-plane, area, profile/channel and reference-condition bindings permit the
- * selected response application path. Response application checks exact profile/channel, source plane,
- * incident-area basis, spatial uniformity and reference conditions. Structural compatibility alone
- * does not authorize signal conversion; per-bin operating-range validity and the typed EQE/A-W path
- * are separate gates.
+ * Response application compatibility: checks that a measured sensor response can be applied to this
+ * light input.
+ *
+ * It checks the exact profile and channel, the plane where the input light is measured (source
+ * plane), the area the response refers to, spatial uniformity and the reference conditions of the
+ * measurement. Passing this check alone does not allow converting light to signal. The per-bin
+ * operating-range check and the EQE or A/W conversion are separate steps.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -18,13 +14,16 @@ import { calculatedResult } from "../core/calculation-result.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";
+import { requireInputObject, requireInputKeys, rejectUnknownFields, rejectUnknownVariantFields } from "../core/record-validation.js";
 const AREA_TOLERANCE = 1e-10;
-function requireRecord(value, path) {
+function requireRecord(value, path, allowedKeys) {
     if (typeof value !== "object" ||
         value === null ||
         Array.isArray(value)) {
         throw new InvalidConfigurationError(path + " must be an object.");
     }
+    if (allowedKeys !== null)
+        rejectUnknownFields(value, allowedKeys, path);
     return value;
 }
 function requireNonEmptyString(value, path) {
@@ -44,7 +43,7 @@ function requirePositiveFinite(value, path) {
     return value;
 }
 function parseIncidentAreaBasis(value, path) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["areaSquareMicrometers", "kind"]);
     const areaSquareMicrometers = requirePositiveFinite(record.areaSquareMicrometers, path + ".areaSquareMicrometers");
     if (record.kind !==
         "geometric-sensitive-aperture" &&
@@ -59,7 +58,8 @@ function parseIncidentAreaBasis(value, path) {
     };
 }
 function parseSpatialResponseModel(value, path) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, null);
+    rejectUnknownVariantFields(record, "kind", { "not-established": ["kind", "limitation"], "uniform-over-geometric-sensitive-aperture": ["kind", "scientificStatus", "evidence", "limitation"] }, path);
     if (record.kind === "not-established") {
         return {
             kind: "not-established",
@@ -96,7 +96,8 @@ function parseSpatialResponseModel(value, path) {
     };
 }
 function parseReferenceConditionPolicy(value, path) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, null);
+    rejectUnknownVariantFields(record, "kind", { "exact-match-required": ["kind"], "assume-compatible": ["kind", "limitation", "evidence"] }, path);
     if (record.kind ===
         "exact-match-required") {
         return {
@@ -113,19 +114,18 @@ function parseReferenceConditionPolicy(value, path) {
     throw new InvalidConfigurationError(path + ".kind is invalid.");
 }
 /**
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary.
+ * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
  *
- * Response application checks exact profile/channel, source plane, incident-area basis, spatial
- * uniformity and reference conditions. Structural compatibility alone does not authorize signal
- * conversion; per-bin operating-range validity and the typed EQE/A-W path are separate gates.
- * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
- * @returns SensorResponseApplicationProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * The profile states the source plane, incident-area basis, spatial uniformity and reference
+ * conditions under which a response applies.
+ * @param value - Untrusted data. TypeScript types alone are not validation.
+ * @returns The result. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function parseSensorResponseApplicationProfile(value) {
-    const record = requireRecord(value, "sensorResponseApplication");
+    const record = requireRecord(value, "sensorResponseApplication", ["schemaVersion", "profileId", "spectralResponseProfileId", "colorSamplingProfileId", "channelId", "samplingApertureProfileId", "opticalStackProfileId", "evidence", "incidentAreaBasis", "spatialResponseModel", "referenceConditionPolicy"]);
     if (record.schemaVersion !== "0.1.0") {
         throw new InvalidConfigurationError('sensorResponseApplication.schemaVersion must be "0.1.0".');
     }
@@ -144,11 +144,11 @@ export function parseSensorResponseApplicationProfile(value) {
     };
 }
 function parseSourcePlane(value) {
-    const record = requireRecord(value, "sourcePlane");
+    const record = requireRecord(value, "sourcePlane", ["value", "evidence"]);
     if (record.value !==
         "sensor-package-incident" &&
         record.value !== "site-incident") {
-        throw new InvalidScientificInputError("sourcePlane.value is invalid.");
+        throw new InvalidConfigurationError("sourcePlane.value is invalid.");
     }
     return {
         value: record.value,
@@ -191,6 +191,7 @@ function conditionsMatch(reference, operating) {
     return true;
 }
 function validateReductionBoundary(reduction) {
+    requireInputObject(reduction, "reduction input");
     if (reduction.outputMeaning !==
         "pre-response-spatio-spectral-radiometric-reduction" ||
         reduction
@@ -218,18 +219,18 @@ function validateReductionBoundary(reduction) {
         .geometricApertureAreaSquareMicrometers;
 }
 /**
- * Assess whether exact source-plane, area, profile/channel and reference-condition bindings permit the
- * selected response application path.
+ * Checks whether the source plane, area, profile, channel and reference conditions allow the
+ * selected way of applying the response.
  *
- * Response application checks exact profile/channel, source plane, incident-area basis, spatial
- * uniformity and reference conditions. Structural compatibility alone does not authorize signal
- * conversion; per-bin operating-range validity and the typed EQE/A-W path are separate gates.
- * @param input - AssessSensorResponseApplicationCompatibilityInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns CalculationResult<SensorResponseApplicationCompatibilityAssessment>. Read structured blockers before consuming an authorization.
+ * Passing this alone does not allow converting light to signal. The per-bin operating-range check
+ * and the EQE or A/W conversion are separate steps.
+ * @param input - The input; see `AssessSensorResponseApplicationCompatibilityInput` for its fields, units and coordinates.
+ * @returns The assessment. Read its structured blockers before acting on an authorization.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function assessSensorResponseApplicationCompatibility(input) {
+    requireInputKeys(input, "assessSensorResponseApplicationCompatibility", ["reduction", "applicationProfile", "sourcePlane", "operatingConditions"]);
     const geometricArea = validateReductionBoundary(input.reduction);
     const profile = parseSensorResponseApplicationProfile(input.applicationProfile);
     const sourcePlane = parseSourcePlane(input.sourcePlane);