@photivra/engine 1.5.0 → 2.1.0

package/dist/output/capture-corrected-sdr.js

@@ -1,8 +1,10 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Strict boundary; execution also checks capture optics, native raster binding and source history.
- * Internal shared validation for capture-derived exporters; does not create or validate pixel values.
+ * SDR (standard dynamic range) output from a simulated capture with lens corrections applied.
+ *
+ * Pipeline: committed capture → colour and white balance (WB) → lens correction in native sensor
+ * coordinates → oriented output view → SDR rendering. It produces a derived view only; the
+ * capture's physical geometry is unchanged.
  * @see docs/PROCESSED_OUTPUT.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -20,13 +22,16 @@ export const CAPTURE_CORRECTED_SDR_SCHEMA_VERSION = "0.1.0";
 function fields(value, allowed) {
     return requireAllowlistedRecord(value, allowed, "Invalid capture correction fields.");
 }
-/** Strict boundary; execution also checks capture optics, native raster binding and source history. */
+/**
+ * Strictly parses untrusted input. Running the calculation also checks the capture's optics,
+ * native pixel-grid binding and source history.
+ */
 export function parseCaptureCorrectedSdrInput(input) {
     const r = fields(input, ["capture", "sourcePlaneId", "color", "profile", "correction"]);
     const base = parseCaptureSdrInput({ capture: r.capture, sourcePlaneId: r.sourcePlaneId, color: r.color, profile: r.profile });
     return { ...base, correction: parseCaptureCorrectionChoice(r.correction, base.capture, base.color.kind === "transform" ? [base.color.outputImageStateId] : []) };
 }
-/** Internal shared validation for capture-derived exporters; does not create or validate pixel values. */
+/** Internal: validates the correction choice for exporters that start from a capture. It neither creates nor checks pixel values. */
 export function parseCaptureCorrectionChoice(input, capture, forbiddenImageStateIds = []) {
     const c = fields(input, ["profile", "state", "coordinateFrame", "selections", "selectionKind", "frameTimeSeconds",
         "resampler", "clippingLevel", "invalidSupport", "outputImageStateId"]);
@@ -69,7 +74,7 @@ function nativeRaster(bounds, width, height, orientation) {
     return { width: w, height: h, pitchMm: pitchX,
         centerMm: { x: (Math.min(...x) + Math.max(...x)) / 2, y: (Math.min(...y) + Math.max(...y)) / 2 } };
 }
-/** Exact quarter-turn index permutation through the capture geometry contract, not another resampling pass. */
+/** Reorders pixel indices for a quarter-turn orientation, using the capture geometry functions. This is an exact reorder, not another resampling pass. */
 function orientedIndices(raster, orientation, orientedWidth) {
     return Array.from({ length: raster.width * raster.height }, (_, i) => {
         const p = transformNativeRasterPointToOriented({ point: { x: i % raster.width + .5, y: Math.floor(i / raster.width) + .5 },
@@ -77,7 +82,10 @@ function orientedIndices(raster, orientation, orientedWidth) {
         return Math.floor(p.y) * orientedWidth + Math.floor(p.x);
     });
 }
-/** Bounded committed capture → color/WB → native correction → oriented output view → SDR. No physical stage activation. */
+/**
+ * Runs a bounded committed capture through colour/WB → native lens correction → oriented output
+ * view → SDR. No physical simulation stage is run.
+ */
 export function calculateCaptureCorrectedSdr(input) {
     const v = parseCaptureCorrectedSdrInput(input), c = v.correction;
     const { value, source, plane, color, applied } = prepareCaptureSdrSource({
@@ -101,7 +109,7 @@ export function calculateCaptureCorrectedSdr(input) {
     const samples = plane.storage.samples, sourceIndices = orientedIndices(src, orientation, plane.pixelWidth);
     const channels = { red: sourceIndices.map((i) => samples[3 * i]), green: sourceIndices.map((i) => samples[3 * i + 1]),
         blue: sourceIndices.map((i) => samples[3 * i + 2]) };
-    // Existing engine projection owns finite-focus distance; never substitute scene-clock time or focal length.
+    // The engine's projection model supplies the finite focus distance. Never substitute scene-clock time or focal length for it.
     const projection = calculateFieldOfView({ focalLengthMm: capture.exposure.focalLengthMm,
         sensorDimensionMm: g.activeCapture.imagingArea.widthMm, focusDistanceM: c.state.focusDistanceM });
     const correction = calculateLensCorrectedCapture({ plan: plan.value, capture: { state: c.state,

package/dist/output/capture-corrected-sdr.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture-corrected-sdr.js","sourceRoot":"","sources":["../../src/output/capture-corrected-sdr.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"capture-corrected-sdr.js","sourceRoot":"","sources":["../../src/output/capture-corrected-sdr.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * SDR (standard dynamic range) output from a simulated capture with lens corrections applied.\n *\n * Pipeline: committed capture → colour and white balance (WB) → lens correction in native sensor\n * coordinates → oriented output view → SDR rendering. It produces a derived view only; the\n * capture's physical geometry is unchanged.\n * @see docs/PROCESSED_OUTPUT.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { requireAllowlistedRecord, isPublicOpaqueId } from \"../core/record-validation.js\";\nimport { approximationResult, type CalculationResult } from \"../core/calculation-result.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { calculateFieldOfView } from \"../camera/field-of-view.js\";\nimport { parseOpticalProfileState, type OpticalProfileState } from \"../optics/profile-contract.js\";\nimport { prepareCaptureSdrSource, parseCaptureSdrInput, type CaptureSdrInput, type CaptureSdrResult } from \"./capture-sdr.js\";\nimport { resolveLensCorrectionPlan, calculateLensCorrectedCapture, parseGenericLensCorrectionProfile,\n  type GenericLensCorrectionProfile, type ResolvedLensCorrectionPlan } from \"./lens-corrections.js\";\nimport { calculateValidSourceCrop, type GeometricRaster, type GeometricResampler } from \"./geometric-transforms.js\";\nimport { mapOrientedPhysicalUvToImagePlanePoint, transformNativeRasterPointToOriented,\n  type PhysicalBoundsFromOpticalAxisMm, type RasterRect, type CaptureOrientation } from \"./capture-geometry.js\";\nimport { calculateSdrRendering } from \"./sdr-rendering.js\";\n\nexport const CAPTURE_CORRECTED_SDR_SCHEMA_VERSION = \"0.1.0\" as const;\n/**\n * Input: a capture plus an explicit lens-correction choice in native optical coordinates. Camera\n * body, lens and mode identities are taken as the capture producer declared them.\n */\nexport interface CaptureCorrectedSdrInput extends CaptureSdrInput {\n  correction: {\n    profile: GenericLensCorrectionProfile;\n    state: OpticalProfileState;\n    /** Native optical coordinates (+X right, +Y up), in the RGB space after the selected colour/WB step. */\n    coordinateFrame: \"native-optical-linear-srgb-d65\";\n    selections: Readonly<Record<string, \"on\" | \"off\" | \"auto\">>;\n    selectionKind: ResolvedLensCorrectionPlan[\"selectionKind\"];\n    /** Seconds from exposure start, not the capture's scene-clock time. */\n    frameTimeSeconds: number;\n    resampler: GeometricResampler;\n    clippingLevel: number;\n    invalidSupport: \"reject\" | \"joint-valid-crop\";\n    outputImageStateId: string;\n  };\n}\n/** A derived output view. It never replaces the committed capture's physical geometry. */\nexport interface CaptureCorrectedSdrResult extends Omit<CaptureSdrResult, \"schemaVersion\"> {\n  schemaVersion: typeof CAPTURE_CORRECTED_SDR_SCHEMA_VERSION;\n  sceneTimeSeconds: number;\n  plan: CalculationResult<ResolvedLensCorrectionPlan>;\n  correction: ReturnType<typeof calculateLensCorrectedCapture>;\n  projection: ReturnType<typeof calculateFieldOfView>;\n  /** Valid-source mask over the full oriented output. The nested correction plans still use native optical coordinates. */\n  validSourceMask: readonly boolean[];\n  outputView: { imageStateId: string; rect: RasterRect; pixelWidth: number; pixelHeight: number; samples: readonly number[] };\n}\nfunction fields(value: unknown, allowed: readonly string[]): Record<string, unknown> {\n  return requireAllowlistedRecord(value, allowed, \"Invalid capture correction fields.\");\n}\n/**\n * Strictly parses untrusted input. Running the calculation also checks the capture's optics,\n * native pixel-grid binding and source history.\n */\nexport function parseCaptureCorrectedSdrInput(input: unknown): CaptureCorrectedSdrInput {\n  const r = fields(input, [\"capture\", \"sourcePlaneId\", \"color\", \"profile\", \"correction\"]);\n  const base = parseCaptureSdrInput({ capture: r.capture, sourcePlaneId: r.sourcePlaneId, color: r.color, profile: r.profile });\n  return { ...base, correction: parseCaptureCorrectionChoice(r.correction, base.capture,\n    base.color.kind === \"transform\" ? [base.color.outputImageStateId] : []) };\n}\n/** Internal: validates the correction choice for exporters that start from a capture. It neither creates nor checks pixel values. */\nexport function parseCaptureCorrectionChoice(input: unknown, capture: CaptureSdrInput[\"capture\"],\n  forbiddenImageStateIds: readonly string[] = []): CaptureCorrectedSdrInput[\"correction\"] {\n  const c = fields(input, [\"profile\", \"state\", \"coordinateFrame\", \"selections\", \"selectionKind\", \"frameTimeSeconds\",\n    \"resampler\", \"clippingLevel\", \"invalidSupport\", \"outputImageStateId\"]);\n  const profile = parseGenericLensCorrectionProfile(c.profile), state = parseOpticalProfileState(c.state);\n  const selections = fields(c.selections, profile.components.map((v) => v.id));\n  if (Object.values(selections).some((v) => v !== \"on\" && v !== \"off\" && v !== \"auto\") ||\n      c.coordinateFrame !== \"native-optical-linear-srgb-d65\" ||\n      (c.selectionKind !== \"camera-selectable\" && c.selectionKind !== \"reference-bypass\") ||\n      (c.invalidSupport !== \"reject\" && c.invalidSupport !== \"joint-valid-crop\") ||\n      typeof c.frameTimeSeconds !== \"number\" || !Number.isFinite(c.frameTimeSeconds) || c.frameTimeSeconds < 0 ||\n      typeof c.clippingLevel !== \"number\" || !Number.isFinite(c.clippingLevel) || c.clippingLevel <= 0 ||\n      !isPublicOpaqueId(c.outputImageStateId) ||\n      capture.planes.some((p) => p.imageStateId === c.outputImageStateId) ||\n      forbiddenImageStateIds.includes(c.outputImageStateId)) {\n    throw new InvalidConfigurationError(\"Invalid correction choice, clock, threshold or derived state identity.\");\n  }\n  const s = fields(c.resampler, [\"id\", \"version\", \"filter\", \"antialias\"]);\n  if (typeof s.id !== \"string\" || !s.id.trim() || typeof s.version !== \"string\" || !s.version.trim() ||\n      (s.filter !== \"nearest\" && s.filter !== \"bilinear\") || (s.antialias !== \"none\" && s.antialias !== \"source-prefiltered\")) {\n    throw new InvalidConfigurationError(\"Invalid correction resampler.\");\n  }\n  resolveLensCorrectionPlan({ profile, state, selections: selections as CaptureCorrectedSdrInput[\"correction\"][\"selections\"],\n    outputKind: \"processed\", selectionKind: c.selectionKind });\n  return { profile, state, coordinateFrame: c.coordinateFrame,\n    selections: selections as CaptureCorrectedSdrInput[\"correction\"][\"selections\"], selectionKind: c.selectionKind,\n    frameTimeSeconds: c.frameTimeSeconds, clippingLevel: c.clippingLevel, invalidSupport: c.invalidSupport,\n    outputImageStateId: c.outputImageStateId, resampler: { id: s.id, version: s.version, filter: s.filter, antialias: s.antialias } };\n}\nfunction nativeRaster(bounds: PhysicalBoundsFromOpticalAxisMm, width: number, height: number,\n  orientation: CaptureOrientation): GeometricRaster {\n  const corners = [0, 1].flatMap((u) => [0, 1].map((v) => mapOrientedPhysicalUvToImagePlanePoint({\n    uv: { u, v }, orientation, orientedPhysicalBoundsFromOpticalAxisMm: bounds })));\n  const x = corners.map((p) => p.x), y = corners.map((p) => p.y);\n  const quarter = orientation === \"portrait-clockwise\" || orientation === \"portrait-counter-clockwise\";\n  const w = quarter ? height : width, h = quarter ? width : height;\n  const pitchX = (Math.max(...x)-Math.min(...x))/w, pitchY = (Math.max(...y)-Math.min(...y))/h;\n  if (Math.abs(pitchX-pitchY) > 1e-12*Math.max(pitchX, pitchY)) {\n    throw new InvalidConfigurationError(\"Correction executor requires square physical pixel pitch; no implicit stretching.\");\n  }\n  return { width: w, height: h, pitchMm: pitchX,\n    centerMm: { x: (Math.min(...x)+Math.max(...x))/2, y: (Math.min(...y)+Math.max(...y))/2 } };\n}\n/** Reorders pixel indices for a quarter-turn orientation, using the capture geometry functions. This is an exact reorder, not another resampling pass. */\nfunction orientedIndices(raster: GeometricRaster, orientation: CaptureOrientation, orientedWidth: number): number[] {\n  return Array.from({ length: raster.width*raster.height }, (_, i): number => {\n    const p = transformNativeRasterPointToOriented({ point: { x: i%raster.width+.5, y: Math.floor(i/raster.width)+.5 },\n      nativeRaster: { pixelWidth: raster.width, pixelHeight: raster.height }, orientation });\n    return Math.floor(p.y)*orientedWidth+Math.floor(p.x);\n  });\n}\n/**\n * Runs a bounded committed capture through colour/WB → native lens correction → oriented output\n * view → SDR. No physical simulation stage is run.\n */\nexport function calculateCaptureCorrectedSdr(input: CaptureCorrectedSdrInput): CalculationResult<CaptureCorrectedSdrResult> {\n  const v = parseCaptureCorrectedSdrInput(input), c = v.correction;\n  const { value, source, plane, color, applied } = prepareCaptureSdrSource({\n    capture: v.capture, sourcePlaneId: v.sourcePlaneId, color: v.color, profile: v.profile });\n  if (plane.storage.kind !== \"inline-float64\" || plane.pixelWidth*plane.pixelHeight > 65536 ||\n      plane.appliedTransforms.some((t) => t.kind === \"digital-lens-correction\")) {\n    throw new InvalidConfigurationError(\"Requires bounded inline RGB without prior digital lens correction; no implicit loading or double correction.\");\n  }\n  const capture = value.capture, g = capture.resolvedGeometry, orientation = g.orientedCapture.orientation;\n  const sourceBounds = plane.rasterBinding === \"output\" ? g.output.physicalBoundsFromOpticalAxisMm : g.orientedCapture.physicalBoundsFromOpticalAxisMm;\n  const src = nativeRaster(sourceBounds, plane.pixelWidth, plane.pixelHeight, orientation);\n  const dst = nativeRaster(g.output.physicalBoundsFromOpticalAxisMm, g.output.raster.pixelWidth, g.output.raster.pixelHeight, orientation);\n  if (c.state.focalLengthMm !== capture.exposure.focalLengthMm || c.state.aperture !== capture.exposure.aperture ||\n      capture.focus.kind !== \"finite\" || c.state.focusDistanceM !== capture.focus.distanceM ||\n      c.state.outputWidth !== dst.width || c.state.outputHeight !== dst.height || c.frameTimeSeconds > capture.exposure.shutterSeconds) {\n    throw new InvalidConfigurationError(\"Correction state differs from committed optics/native output raster or local exposure interval.\");\n  }\n  const plan = resolveLensCorrectionPlan({ profile: c.profile, state: c.state, selections: c.selections,\n    selectionKind: c.selectionKind, outputKind: \"processed\" });\n  const samples = plane.storage.samples, sourceIndices = orientedIndices(src, orientation, plane.pixelWidth);\n  const channels = { red: sourceIndices.map((i) => samples[3*i]!), green: sourceIndices.map((i) => samples[3*i+1]!),\n    blue: sourceIndices.map((i) => samples[3*i+2]!) };\n  // The engine's projection model supplies the finite focus distance. Never substitute scene-clock time or focal length for it.\n  const projection = calculateFieldOfView({ focalLengthMm: capture.exposure.focalLengthMm,\n    sensorDimensionMm: g.activeCapture.imagingArea.widthMm, focusDistanceM: c.state.focusDistanceM });\n  const correction = calculateLensCorrectedCapture({ plan: plan.value, capture: { state: c.state,\n    captureId: capture.captureId, noiseRealizationId: capture.noise.realizationId, timeSeconds: c.frameTimeSeconds, raster: src, channels },\n    destinationRaster: dst, resampler: c.resampler, clippingLevel: c.clippingLevel,\n    physicalProjectionDistanceMm: projection.value.projectionDistanceMm });\n  const width = g.output.raster.pixelWidth, height = g.output.raster.pixelHeight;\n  const indices = orientedIndices(dst, orientation, width), mask = Array<boolean>(width*height).fill(false);\n  const rgb = Array<number | null>(width*height*3).fill(null);\n  indices.forEach((index, i) => {\n    mask[index] = correction.value.validSourceMask[i]!;\n    rgb[3*index] = correction.value.channels.red[i]!;\n    rgb[3*index+1] = correction.value.channels.green[i]!;\n    rgb[3*index+2] = correction.value.channels.blue[i]!;\n  });\n  if (c.invalidSupport === \"reject\" && mask.some((valid) => !valid)) throw new InvalidConfigurationError(\"Corrected output has unavailable channel support.\");\n  const rect = c.invalidSupport === \"reject\" ? { x: 0, y: 0, width, height } : calculateValidSourceCrop(mask, width, height);\n  if (rect === null) throw new InvalidConfigurationError(\"No joint-valid corrected output crop.\");\n  const outputSamples: number[] = [];\n  for (let y = rect.y; y < rect.y+rect.height; y++) for (let x = rect.x; x < rect.x+rect.width; x++) {\n    const offset = 3*(y*width+x);\n    outputSamples.push(rgb[offset]!, rgb[offset+1]!, rgb[offset+2]!);\n  }\n  const rendering = calculateSdrRendering({ sourceImageStateId: c.outputImageStateId,\n    inputImageState: \"color-transformed-linear-rgb\", inputColorSpace: \"linear-srgb-d65\",\n    whiteBalanceHandling: applied ? \"already-applied-upstream\" : \"not-required\", pixelWidth: rect.width, pixelHeight: rect.height,\n    referenceWhiteValue: plane.referenceWhiteValue, samples: outputSamples, profile: value.profile });\n  return approximationResult({ schemaVersion: CAPTURE_CORRECTED_SDR_SCHEMA_VERSION, captureId: capture.captureId,\n    sourcePlaneId: source.id, sourceImageStateId: source.imageStateId, rasterBinding: source.rasterBinding,\n    sourceCaptureSaturation: source.captureSaturation, sourceDynamicRangeHistory: capture.source.dynamicRangeHistory,\n    noiseRealizationId: capture.noise.realizationId, sceneTimeSeconds: capture.sceneTimeSeconds,\n    whiteBalance: applied ? color ? \"applied-here\" : \"already-applied-upstream\" : \"not-required\",\n    color, plan, correction, projection, validSourceMask: mask,\n    outputView: { imageStateId: c.outputImageStateId, rect, pixelWidth: rect.width, pixelHeight: rect.height, samples: outputSamples }, rendering },\n  \"capture-corrected-sdr-adapter\", CAPTURE_CORRECTED_SDR_SCHEMA_VERSION, [\n    \"Generic corrections are explicitly declared for native optical coordinates and the post-color/WB linear-sRGB basis\",\n    \"Body/lens identity, acquisition mode, stabilization and prefilter adequacy remain producer declarations, not verified calibration\",\n    \"Quarter-turn permutations reuse capture geometry; crop never rewrites physical capture or focal equivalence\",\n    \"Gain clipping events, upstream saturation and SDR gamut clipping remain distinct; no covariance/noise regeneration\",\n    \"Bounded reference integration only; no production-plan activation, RAW correction bake, streaming or external IO\"]);\n}\n"]}

package/dist/output/capture-geometry.d.ts

@@ -34,9 +34,9 @@ export interface NormalizedRasterUv {
     v: number;
 }
 /**
- * Pre-orientation optical image-plane coordinate in millimetres.
+ * A point on the optical image plane, in millimetres, before camera orientation is applied.
  *
- * Origin is the optical axis; +X points right and +Y points up.
+ * The origin is the optical axis. +X points right and +Y points up.
  */
 export interface ImagePlaneMetricPointMm {
     x: number;
@@ -71,16 +71,16 @@ export interface ResolveCaptureGeometryInput {
      */
     activeCaptureRect?: RasterRect;
     /**
-     * Final digital/output crop in oriented active-capture raster coordinates.
+     * Final digital (output) crop, in oriented active-capture pixel coordinates.
      *
      * Defaults to the full oriented active capture.
      */
     outputCropRect?: RasterRect;
     /**
-     * Final output raster after optional digital crop/resampling.
+     * Final output image size after the optional digital crop and resampling.
      *
-     * Defaults to the output-crop dimensions. The output raster must preserve
-     * the crop aspect ratio within a small integer-rounding tolerance.
+     * Defaults to the output-crop size. The output must keep the crop's aspect
+     * ratio, allowing only a small tolerance for integer rounding.
      */
     outputRaster?: RasterDimensions;
 }
@@ -104,7 +104,7 @@ export interface ResolvedCaptureGeometry {
         /** Native physical bounds relative to the optical axis. */
         physicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
         /**
-         * Current generic model assumes native image samples uniformly span the
+         * The current generic model assumes the native pixels evenly cover the
          * declared physical imaging area.
          */
         imagingAreaDerivation: "uniform-native-raster";
@@ -119,9 +119,9 @@ export interface ResolvedCaptureGeometry {
     };
     output: {
         /**
-         * Digital/output crop expressed in oriented active-capture coordinates.
+         * Digital (output) crop, in oriented active-capture coordinates.
          *
-         * This crop does not mutate physical sensor identity or active-capture
+         * This crop does not change the physical sensor or the active-capture
          * geometry.
          */
         cropRect: RasterRect;
@@ -131,7 +131,7 @@ export interface ResolvedCaptureGeometry {
         physicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
         centerOffsetFromOpticalAxisMm: RasterVector;
         sourceRetainedAreaFraction: number;
-        /** Pixel-domain resampling from oriented active capture into output. */
+        /** Pixel resampling from the oriented active capture to the output image. */
         orientedCaptureToOutputScale: {
             x: number;
             y: number;
@@ -175,8 +175,8 @@ export interface ActiveCaptureFieldOfView {
     horizontalDegrees: number;
     verticalDegrees: number;
     /**
-     * Larger of the two opposite-corner diagonal angular spans. For centered
-     * crops both diagonal spans are equal.
+     * The larger of the two corner-to-corner diagonal angles. For a centred
+     * crop the two diagonals are equal.
      */
     diagonalDegrees: number;
     horizontalBoundsDegrees: {
@@ -223,34 +223,33 @@ export interface OutputFieldOfView {
     };
 }
 /**
- * Transforms a continuous native raster edge-coordinate point into oriented
- * capture coordinates. Pixel centers can be represented with +0.5 offsets.
+ * Converts a point in native pixel coordinates to oriented capture coordinates.
+ * Coordinates are continuous and measured from pixel edges, so a pixel centre is at +0.5.
  */
 export declare function transformNativeRasterPointToOriented(input: TransformRasterPointInput): RasterPoint;
-/** Transforms an oriented raster edge-coordinate point back to native coordinates. */
+/** Converts a point in oriented pixel coordinates (measured from pixel edges) back to native coordinates. */
 export declare function transformOrientedRasterPointToNative(input: TransformRasterPointInput): RasterPoint;
 /** Rotates a native raster vector into oriented coordinates. */
 export declare function transformNativeRasterVectorToOriented(input: TransformRasterVectorInput): RasterVector;
 /** Rotates an oriented raster vector back into native coordinates. */
 export declare function transformOrientedRasterVectorToNative(input: TransformRasterVectorInput): RasterVector;
 /**
- * Maps normalized coordinates in an oriented physical raster region into the
- * pre-orientation optical image plane used by lens-field and camera-mapping
- * APIs.
+ * Maps normalized (0–1) coordinates in an oriented physical image region to the
+ * optical image plane used by the lens-field and camera-mapping APIs, before
+ * camera orientation.
  *
- * The supplied physical bounds use the capture contract's +Y-down basis after
- * physical camera orientation. The returned image-plane point uses optical-axis
- * origin, +X right and +Y up. No lens or projection equation is applied.
+ * The input bounds are after camera orientation and use +Y down. The returned
+ * point has its origin on the optical axis, with +X right and +Y up. No lens or
+ * projection equation is applied.
  */
 export declare function mapOrientedPhysicalUvToImagePlanePoint(input: MapOrientedPhysicalUvToImagePlaneInput): ImagePlaneMetricPointMm;
 /**
- * Maps a pre-orientation optical image-plane point into normalized coordinates
- * of an oriented physical raster region.
+ * Maps an optical image-plane point (before camera orientation) to normalized
+ * coordinates in an oriented physical image region.
  *
- * This is the exact coordinate inverse of
- * mapOrientedPhysicalUvToImagePlanePoint(). Points outside the supplied region
- * fail closed; a tiny tolerance only absorbs floating-point round-trip noise at
- * an edge.
+ * This is the exact inverse of mapOrientedPhysicalUvToImagePlanePoint(). A point
+ * outside the region is rejected. A tiny tolerance only absorbs floating-point
+ * round-trip error at an edge.
  */
 export declare function mapImagePlanePointToOrientedPhysicalUv(input: MapImagePlanePointToOrientedPhysicalUvInput): NormalizedRasterUv;
 /** Transforms an integer half-open native raster rectangle into oriented coordinates. */
@@ -258,21 +257,20 @@ export declare function transformNativeRasterRectToOriented(input: TransformRast
 /** Transforms an oriented integer half-open rectangle back to native coordinates. */
 export declare function transformOrientedRasterRectToNative(input: TransformRasterRectInput): RasterRect;
 /**
- * Resolves native sensor geometry, active capture, physical camera orientation,
- * and final digital/output geometry without conflating their identities.
+ * Resolves native sensor geometry, active capture area, physical camera orientation
+ * and final digital (output) geometry, keeping each one distinct.
  */
 export declare function resolveCaptureGeometry(input: ResolveCaptureGeometryInput): CalculationResult<ResolvedCaptureGeometry>;
 /**
- * Calculates asymmetric horizontal/vertical FOV plus opposite-corner diagonal
- * spans for the active physical capture area after physical camera orientation.
+ * Calculates the field of view (FOV) of the active physical capture area after
+ * camera orientation. Horizontal and vertical FOV can be asymmetric about the
+ * optical axis; both corner-to-corner diagonals are reported.
  *
- * Final digital/output crop is intentionally excluded.
+ * The final digital (output) crop is deliberately not included.
  */
 export declare function calculateActiveCaptureFieldOfView(input: CalculateActiveCaptureFieldOfViewInput): CalculationResult<ActiveCaptureFieldOfView>;
 /**
- * Calculates final visible field of view after physical active capture,
- * orientation, and digital/output crop. Output raster resolution does not
- * affect this optical/framing result.
+ * Calculates the final visible field of view after the active capture area,
+ * orientation and digital (output) crop. Output resolution does not affect it.
  */
 export declare function calculateOutputFieldOfView(input: CalculateOutputFieldOfViewInput): CalculationResult<OutputFieldOfView>;
-//# sourceMappingURL=capture-geometry.d.ts.map

package/dist/output/capture-geometry.js

@@ -1,9 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Transforms a continuous native raster edge-coordinate point into oriented capture coordinates. Pixel
- * centers can be represented with +0.5 offsets.
- * Transforms an oriented raster edge-coordinate point back to native coordinates.
+ * Capture geometry: how the native sensor, the active capture area, the camera's physical
+ * orientation and the final output crop relate to each other.
+ *
+ * It converts points, vectors and rectangles between native and oriented pixel coordinates,
+ * maps oriented positions to the optical image plane and back, and computes field of view (FOV)
+ * for the active capture and the final output.
  * @see docs/PHYSICS_FOUNDATION.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -11,6 +13,8 @@ import { calculateFieldOfViewBounds } from "../camera/field-of-view.js";
 import { calculatedResult } from "../core/calculation-result.js";
 import { InvalidScientificInputError, requirePositiveFinite, requirePositiveInteger } from "../core/validation.js";
 import {} from "../sensor/sensor-geometry.js";
+import { requireInputKeys, requireInputObject } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
 const CAPTURE_ORIENTATIONS = new Set([
     "landscape",
     "portrait-clockwise",
@@ -20,10 +24,11 @@ const CAPTURE_ORIENTATIONS = new Set([
 function requireCaptureOrientation(value) {
     if (typeof value !== "string" ||
         !CAPTURE_ORIENTATIONS.has(value)) {
-        throw new InvalidScientificInputError("orientation is invalid.");
+        throw new InvalidConfigurationError("orientation is invalid.");
     }
 }
 function requireRasterDimensions(name, raster) {
+    requireInputObject(raster, name);
     requirePositiveInteger(`${name}.pixelWidth`, raster.pixelWidth);
     requirePositiveInteger(`${name}.pixelHeight`, raster.pixelHeight);
 }
@@ -33,6 +38,7 @@ function requireNonNegativeInteger(name, value) {
     }
 }
 function validateRasterRect(name, rect, bounds) {
+    requireInputObject(rect, name);
     requireNonNegativeInteger(`${name}.x`, rect.x);
     requireNonNegativeInteger(`${name}.y`, rect.y);
     requirePositiveInteger(`${name}.width`, rect.width);
@@ -43,6 +49,7 @@ function validateRasterRect(name, rect, bounds) {
     }
 }
 function validateRasterPoint(name, point, bounds) {
+    requireInputObject(point, name);
     if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) {
         throw new InvalidScientificInputError(`${name} coordinates must be finite.`);
     }
@@ -54,6 +61,7 @@ function validateRasterPoint(name, point, bounds) {
     }
 }
 function validateRasterVector(name, vector) {
+    requireInputObject(vector, name);
     if (!Number.isFinite(vector.x) || !Number.isFinite(vector.y)) {
         throw new InvalidScientificInputError(`${name} coordinates must be finite.`);
     }
@@ -65,6 +73,7 @@ function physicalCoordinateTolerance(value, minimum, maximum) {
     return Number.EPSILON * PHYSICAL_EDGE_TOLERANCE_ULPS * scale;
 }
 function validatePhysicalBounds(name, bounds) {
+    requireInputObject(bounds, name);
     for (const key of ["left", "right", "top", "bottom"]) {
         if (!Number.isFinite(bounds[key])) {
             throw new InvalidScientificInputError(`${name}.${key} must be finite.`);
@@ -88,6 +97,7 @@ function validatePhysicalBounds(name, bounds) {
     }
 }
 function validateNormalizedUv(name, uv) {
+    requireInputObject(uv, name);
     if (!Number.isFinite(uv.u) || !Number.isFinite(uv.v)) {
         throw new InvalidScientificInputError(`${name} coordinates must be finite.`);
     }
@@ -152,10 +162,11 @@ function inverseRotateVector(vector, orientation) {
     }
 }
 /**
- * Transforms a continuous native raster edge-coordinate point into oriented
- * capture coordinates. Pixel centers can be represented with +0.5 offsets.
+ * Converts a point in native pixel coordinates to oriented capture coordinates.
+ * Coordinates are continuous and measured from pixel edges, so a pixel centre is at +0.5.
  */
 export function transformNativeRasterPointToOriented(input) {
+    requireInputKeys(input, "transformNativeRasterPointToOriented", ["point", "nativeRaster", "orientation"]);
     requireCaptureOrientation(input.orientation);
     requireRasterDimensions("nativeRaster", input.nativeRaster);
     validateRasterPoint("point", input.point, input.nativeRaster);
@@ -171,8 +182,9 @@ export function transformNativeRasterPointToOriented(input) {
             return { x: input.point.y, y: width - input.point.x };
     }
 }
-/** Transforms an oriented raster edge-coordinate point back to native coordinates. */
+/** Converts a point in oriented pixel coordinates (measured from pixel edges) back to native coordinates. */
 export function transformOrientedRasterPointToNative(input) {
+    requireInputKeys(input, "transformOrientedRasterPointToNative", ["point", "nativeRaster", "orientation"]);
     requireCaptureOrientation(input.orientation);
     requireRasterDimensions("nativeRaster", input.nativeRaster);
     const orientedRaster = orientRaster(input.nativeRaster, input.orientation);
@@ -191,26 +203,29 @@ export function transformOrientedRasterPointToNative(input) {
 }
 /** Rotates a native raster vector into oriented coordinates. */
 export function transformNativeRasterVectorToOriented(input) {
+    requireInputKeys(input, "transformNativeRasterVectorToOriented", ["vector", "orientation"]);
     requireCaptureOrientation(input.orientation);
     validateRasterVector("vector", input.vector);
     return rotateVector(input.vector, input.orientation);
 }
 /** Rotates an oriented raster vector back into native coordinates. */
 export function transformOrientedRasterVectorToNative(input) {
+    requireInputKeys(input, "transformOrientedRasterVectorToNative", ["vector", "orientation"]);
     requireCaptureOrientation(input.orientation);
     validateRasterVector("vector", input.vector);
     return inverseRotateVector(input.vector, input.orientation);
 }
 /**
- * Maps normalized coordinates in an oriented physical raster region into the
- * pre-orientation optical image plane used by lens-field and camera-mapping
- * APIs.
+ * Maps normalized (0–1) coordinates in an oriented physical image region to the
+ * optical image plane used by the lens-field and camera-mapping APIs, before
+ * camera orientation.
  *
- * The supplied physical bounds use the capture contract's +Y-down basis after
- * physical camera orientation. The returned image-plane point uses optical-axis
- * origin, +X right and +Y up. No lens or projection equation is applied.
+ * The input bounds are after camera orientation and use +Y down. The returned
+ * point has its origin on the optical axis, with +X right and +Y up. No lens or
+ * projection equation is applied.
  */
 export function mapOrientedPhysicalUvToImagePlanePoint(input) {
+    requireInputKeys(input, "mapOrientedPhysicalUvToImagePlanePoint", ["uv", "orientedPhysicalBoundsFromOpticalAxisMm", "orientation"]);
     requireCaptureOrientation(input.orientation);
     validateNormalizedUv("uv", input.uv);
     validatePhysicalBounds("orientedPhysicalBoundsFromOpticalAxisMm", input.orientedPhysicalBoundsFromOpticalAxisMm);
@@ -226,15 +241,15 @@ export function mapOrientedPhysicalUvToImagePlanePoint(input) {
     };
 }
 /**
- * Maps a pre-orientation optical image-plane point into normalized coordinates
- * of an oriented physical raster region.
+ * Maps an optical image-plane point (before camera orientation) to normalized
+ * coordinates in an oriented physical image region.
  *
- * This is the exact coordinate inverse of
- * mapOrientedPhysicalUvToImagePlanePoint(). Points outside the supplied region
- * fail closed; a tiny tolerance only absorbs floating-point round-trip noise at
- * an edge.
+ * This is the exact inverse of mapOrientedPhysicalUvToImagePlanePoint(). A point
+ * outside the region is rejected. A tiny tolerance only absorbs floating-point
+ * round-trip error at an edge.
  */
 export function mapImagePlanePointToOrientedPhysicalUv(input) {
+    requireInputKeys(input, "mapImagePlanePointToOrientedPhysicalUv", ["imagePlanePointMm", "orientedPhysicalBoundsFromOpticalAxisMm", "orientation"]);
     requireCaptureOrientation(input.orientation);
     validateRasterVector("imagePlanePointMm", input.imagePlanePointMm);
     validatePhysicalBounds("orientedPhysicalBoundsFromOpticalAxisMm", input.orientedPhysicalBoundsFromOpticalAxisMm);
@@ -251,6 +266,7 @@ export function mapImagePlanePointToOrientedPhysicalUv(input) {
 }
 /** Transforms an integer half-open native raster rectangle into oriented coordinates. */
 export function transformNativeRasterRectToOriented(input) {
+    requireInputKeys(input, "transformNativeRasterRectToOriented", ["rect", "nativeRaster", "orientation"]);
     requireCaptureOrientation(input.orientation);
     requireRasterDimensions("nativeRaster", input.nativeRaster);
     validateRasterRect("rect", input.rect, input.nativeRaster);
@@ -284,6 +300,7 @@ export function transformNativeRasterRectToOriented(input) {
 }
 /** Transforms an oriented integer half-open rectangle back to native coordinates. */
 export function transformOrientedRasterRectToNative(input) {
+    requireInputKeys(input, "transformOrientedRasterRectToNative", ["rect", "nativeRaster", "orientation"]);
     requireCaptureOrientation(input.orientation);
     requireRasterDimensions("nativeRaster", input.nativeRaster);
     const orientedRaster = orientRaster(input.nativeRaster, input.orientation);
@@ -351,10 +368,9 @@ function physicalBoundsFromRectWithinBounds(sourceBounds, sourceRaster, rect) {
     };
 }
 function validateOutputAspectRatio(cropRect, outputRaster) {
-    // Preserve one isotropic output scale while allowing only the sub-pixel
-    // disagreement introduced when an ideal scaled dimension is rounded to an
-    // integer raster size. A fixed percentage tolerance can admit visible
-    // anisotropic stretching at large output dimensions.
+    // Keep one scale factor for both axes. Allow only the sub-pixel mismatch that
+    // comes from rounding an ideal scaled size to whole pixels. A fixed percentage
+    // tolerance would allow visible stretching along one axis at large sizes.
     const widthScaleMinimum = (outputRaster.pixelWidth - 0.5) / cropRect.width;
     const widthScaleMaximum = (outputRaster.pixelWidth + 0.5) / cropRect.width;
     const heightScaleMinimum = (outputRaster.pixelHeight - 0.5) / cropRect.height;
@@ -419,11 +435,13 @@ function calculateBoundsFieldOfView(bounds, focalLengthMm, focusDistanceM) {
     };
 }
 /**
- * Resolves native sensor geometry, active capture, physical camera orientation,
- * and final digital/output geometry without conflating their identities.
+ * Resolves native sensor geometry, active capture area, physical camera orientation
+ * and final digital (output) geometry, keeping each one distinct.
  */
 export function resolveCaptureGeometry(input) {
+    requireInputKeys(input, "resolveCaptureGeometry", ["imagingArea", "nativeRaster", "orientation", "activeCaptureRect", "outputCropRect", "outputRaster"]);
     requireCaptureOrientation(input.orientation);
+    requireInputObject(input.imagingArea, "imagingArea");
     requirePositiveFinite("imagingArea.widthMm", input.imagingArea.widthMm);
     requirePositiveFinite("imagingArea.heightMm", input.imagingArea.heightMm);
     requireRasterDimensions("nativeRaster", input.nativeRaster);
@@ -515,12 +533,14 @@ export function resolveCaptureGeometry(input) {
     ]);
 }
 /**
- * Calculates asymmetric horizontal/vertical FOV plus opposite-corner diagonal
- * spans for the active physical capture area after physical camera orientation.
+ * Calculates the field of view (FOV) of the active physical capture area after
+ * camera orientation. Horizontal and vertical FOV can be asymmetric about the
+ * optical axis; both corner-to-corner diagonals are reported.
  *
- * Final digital/output crop is intentionally excluded.
+ * The final digital (output) crop is deliberately not included.
  */
 export function calculateActiveCaptureFieldOfView(input) {
+    requireInputKeys(input, "calculateActiveCaptureFieldOfView", ["imagingArea", "nativeRaster", "orientation", "activeCaptureRect", "focalLengthMm", "focusDistanceM"]);
     requirePositiveFinite("focalLengthMm", input.focalLengthMm);
     const geometry = resolveCaptureGeometry({
         imagingArea: input.imagingArea,
@@ -548,11 +568,11 @@ export function calculateActiveCaptureFieldOfView(input) {
     ]);
 }
 /**
- * Calculates final visible field of view after physical active capture,
- * orientation, and digital/output crop. Output raster resolution does not
- * affect this optical/framing result.
+ * Calculates the final visible field of view after the active capture area,
+ * orientation and digital (output) crop. Output resolution does not affect it.
  */
 export function calculateOutputFieldOfView(input) {
+    requireInputKeys(input, "calculateOutputFieldOfView", ["imagingArea", "nativeRaster", "orientation", "activeCaptureRect", "outputCropRect", "focalLengthMm", "focusDistanceM"]);
     requirePositiveFinite("focalLengthMm", input.focalLengthMm);
     const geometry = resolveCaptureGeometry({
         imagingArea: input.imagingArea,