@photivra/engine 1.1.0 → 1.2.0

package/docs/api/core-spectral-composition.md

@@ -1,6 +1,6 @@
 # core/spectral-composition.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## composeSpectralCoverage
 

package/docs/api/core-spectral.md

@@ -1,6 +1,6 @@
 # core/spectral.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## parseSpectralWavelengthBasis
 

package/docs/api/core-validation.md

@@ -1,6 +1,6 @@
 # core/validation.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## InvalidScientificInputError
 

package/docs/api/core-version.md

@@ -1,6 +1,6 @@
 # core/version.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## ENGINE_API_VERSION
 
@@ -10,5 +10,5 @@ POC, schema and model contracts keep their independent versions.
 Release checks enforce equality with package.json and the packed distribution.
 
 ```ts
-ENGINE_API_VERSION = "1.1.0" as const
+ENGINE_API_VERSION = "1.2.0" as const
 ```

package/docs/api/equipment-exposure-capabilities.md

@@ -1,6 +1,6 @@
 # equipment/exposure-capabilities.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## FocalLengthFNumberSample
 

package/docs/api/equipment-generic-tier-assets.md

@@ -1,6 +1,6 @@
 # equipment/generic-tier-assets.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## GenericEquipmentTier
 

package/docs/api/equipment-generic-tier-presets.md

@@ -1,6 +1,6 @@
 # equipment/generic-tier-presets.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## createGenericEquipmentTierSelection
 

package/docs/api/equipment-iso-capabilities.md

@@ -1,6 +1,6 @@
 # equipment/iso-capabilities.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## bindIsoCapabilityToExposureCapabilities
 

package/docs/api/equipment-metering-capabilities.md

@@ -1,6 +1,6 @@
 # equipment/metering-capabilities.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## assessExposureMeteringProfileCompatibility
 

package/docs/api/equipment-release-capabilities.md

@@ -1,6 +1,6 @@
 # equipment/release-capabilities.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## GENERIC_RELEASE_CAPABILITY_SCHEMA_VERSION
 

package/docs/api/exports.json

@@ -1,6 +1,6 @@
 {
-  "packageVersion": "1.1.0",
-  "engineApiVersion": "1.1.0",
+  "packageVersion": "1.2.0",
+  "engineApiVersion": "1.2.0",
   "exports": [
     {
       "name": "AbsoluteUncertaintyEstimate",
@@ -582,6 +582,11 @@
       "source": "src/capture/linear-encoding.ts",
       "kind": "runtime"
     },
+    {
+      "name": "calculateNativeCaptureSdrPlan",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "runtime"
+    },
     {
       "name": "calculateOutputFieldOfView",
       "source": "src/output/capture-geometry.ts",
@@ -627,6 +632,11 @@
       "source": "src/sensor/pixel-pitch.ts",
       "kind": "type"
     },
+    {
+      "name": "calculatePrintContrastReference",
+      "source": "src/output/print-contrast-reference.ts",
+      "kind": "runtime"
+    },
     {
       "name": "calculatePrintPlan",
       "source": "src/output/print-plan.ts",
@@ -637,6 +647,16 @@
       "source": "src/output/print-detail.ts",
       "kind": "runtime"
     },
+    {
+      "name": "calculatePrintRegionDifference",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "calculatePrintRegionNoise",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "runtime"
+    },
     {
       "name": "calculatePrintSizeLimit",
       "source": "src/output/print-plan.ts",
@@ -1417,6 +1437,11 @@
       "source": "src/exposure/flash.ts",
       "kind": "type"
     },
+    {
+      "name": "createNativeCaptureSdrTask",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "runtime"
+    },
     {
       "name": "createPhotographicExportPair",
       "source": "src/capture/photographic-export.ts",
@@ -2622,6 +2647,11 @@
       "source": "src/output/print-detail.ts",
       "kind": "runtime"
     },
+    {
+      "name": "MAX_PRINT_REGION_STATISTICS_SAMPLES",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "runtime"
+    },
     {
       "name": "MeteringCapabilityCompatibilityAssessment",
       "source": "src/equipment/metering-capabilities.ts",
@@ -2662,6 +2692,56 @@
       "source": "src/optics/lens-psf-profile.ts",
       "kind": "type"
     },
+    {
+      "name": "NATIVE_CAPTURE_SDR_LIMITS",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "NATIVE_CAPTURE_SDR_SCHEMA_VERSION",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "NativeCaptureSdrInput",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
+    {
+      "name": "NativeCaptureSdrOutput",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
+    {
+      "name": "NativeCaptureSdrPlan",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
+    {
+      "name": "NativeCaptureSdrProvider",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
+    {
+      "name": "NativeCaptureSdrTask",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
+    {
+      "name": "NativeCaptureSdrTaskState",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
+    {
+      "name": "NativeCaptureSdrTile",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
+    {
+      "name": "NativeCaptureSdrTileRequest",
+      "source": "src/output/native-capture-sdr.ts",
+      "kind": "type"
+    },
     {
       "name": "NativeColorSamplingSiteCoordinateSystem",
       "source": "src/sensor/color-sampling.ts",
@@ -2967,6 +3047,11 @@
       "source": "src/composition/image-formation-plan.ts",
       "kind": "runtime"
     },
+    {
+      "name": "parsePrintContrastReferenceInput",
+      "source": "src/output/print-contrast-reference.ts",
+      "kind": "runtime"
+    },
     {
       "name": "parsePrintPlanInput",
       "source": "src/output/print-plan.ts",
@@ -2977,6 +3062,16 @@
       "source": "src/output/print-detail.ts",
       "kind": "runtime"
     },
+    {
+      "name": "parsePrintRegionDifferenceInput",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "parsePrintRegionNoiseInput",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "runtime"
+    },
     {
       "name": "parseProcessedSensorRawInput",
       "source": "src/capture/photographic-export.ts",
@@ -3332,11 +3427,36 @@
       "source": "src/color/white-balance.ts",
       "kind": "type"
     },
+    {
+      "name": "PRINT_CONTRAST_REFERENCE_MODEL_VERSION",
+      "source": "src/output/print-contrast-reference.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "PRINT_CONTRAST_REFERENCE_UPSTREAM_REVISION",
+      "source": "src/output/print-contrast-reference.ts",
+      "kind": "runtime"
+    },
     {
       "name": "PRINT_REGION_DETAIL_MODEL_VERSION",
       "source": "src/output/print-detail.ts",
       "kind": "runtime"
     },
+    {
+      "name": "PRINT_REGION_STATISTICS_MODEL_VERSION",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "PrintContrastReference",
+      "source": "src/output/print-contrast-reference.ts",
+      "kind": "type"
+    },
+    {
+      "name": "PrintContrastReferenceInput",
+      "source": "src/output/print-contrast-reference.ts",
+      "kind": "type"
+    },
     {
       "name": "PrintDetailRegion",
       "source": "src/output/print-detail.ts",
@@ -3392,6 +3512,36 @@
       "source": "src/output/print-detail.ts",
       "kind": "type"
     },
+    {
+      "name": "PrintRegionDifferenceInput",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "type"
+    },
+    {
+      "name": "PrintRegionDifferenceMeasurement",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "type"
+    },
+    {
+      "name": "PrintRegionNoiseInput",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "type"
+    },
+    {
+      "name": "PrintRegionNoiseMeasurement",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "type"
+    },
+    {
+      "name": "PrintRegionRaster",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "type"
+    },
+    {
+      "name": "PrintRegionStatisticsAssessment",
+      "source": "src/output/print-region-statistics.ts",
+      "kind": "type"
+    },
     {
       "name": "PrintSamplingCriterion",
       "source": "src/output/print-plan.ts",

package/docs/api/exposure-exposure-duration-control.md

@@ -1,6 +1,6 @@
 # exposure/exposure-duration-control.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## bindResolvedExposureDurationToCaptureExposureInput
 

package/docs/api/exposure-exposure-mode-resolver.md

@@ -1,6 +1,6 @@
 # exposure/exposure-mode-resolver.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## AperturePriorityAutoIsoExposureModeResolution
 

package/docs/api/exposure-exposure.md

@@ -1,6 +1,6 @@
 # exposure/exposure.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateEquivalentIso
 

package/docs/api/exposure-flash.md

@@ -1,6 +1,6 @@
 # exposure/flash.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## createManualFlashIlluminationOverlay
 

package/docs/api/exposure-metering-scene-radiance.md

@@ -1,6 +1,6 @@
 # exposure/metering-scene-radiance.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## createSceneRadianceDerivedExposureMeteringSampleSet
 

package/docs/api/exposure-metering-target.md

@@ -1,6 +1,6 @@
 # exposure/metering-target.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## createExposureMeterTargetFromMeteringResult
 

package/docs/api/exposure-metering-temporal.md

@@ -1,6 +1,6 @@
 # exposure/metering-temporal.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## meterSceneRadianceTemporalExposure
 

package/docs/api/exposure-metering.md

@@ -1,6 +1,6 @@
 # exposure/metering.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## EXPOSURE_METERING_PROFILE_SCHEMA_VERSION
 

package/docs/api/exposure-program-line.md

@@ -1,6 +1,6 @@
 # exposure/program-line.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION
 

package/docs/api/motion-camera-rotation.md

@@ -1,6 +1,6 @@
 # motion/camera-rotation.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## AxisSamplingPitchMicrometers
 

package/docs/api/motion-capture-rotation-inverse-mapping.md

@@ -1,6 +1,6 @@
 # motion/capture-rotation-inverse-mapping.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateCaptureRotationInverseMappings
 

package/docs/api/motion-capture-rotation-temporal-quadrature.md

@@ -1,6 +1,6 @@
 # motion/capture-rotation-temporal-quadrature.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateCaptureRotationTemporalQuadrature
 

package/docs/api/motion-capture-rotation-trajectory.md

@@ -1,6 +1,6 @@
 # motion/capture-rotation-trajectory.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateCaptureRotationTrajectories
 

package/docs/api/motion-capture-translation-parallax-temporal-quadrature.md

@@ -1,6 +1,6 @@
 # motion/capture-translation-parallax-temporal-quadrature.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateCaptureTranslationParallaxTemporalQuadrature
 

package/docs/api/motion-extended-object-projection.md

@@ -1,6 +1,6 @@
 # motion/extended-object-projection.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateCaptureExtendedObjectTemporalProjection
 

package/docs/api/motion-projected-motion.md

@@ -1,6 +1,6 @@
 # motion/projected-motion.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateProjectedMotionBlur
 

package/docs/api/optics-aperture.md

@@ -1,6 +1,6 @@
 # optics/aperture.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## ApertureVertex
 

package/docs/api/optics-circle-of-confusion.md

@@ -1,6 +1,6 @@
 # optics/circle-of-confusion.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## EquivalentViewingCircleOfConfusion
 

package/docs/api/optics-complex-pupil-psf.md

@@ -1,6 +1,6 @@
 # optics/complex-pupil-psf.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateLensComplexPupilPsf
 
@@ -29,6 +29,10 @@ The exact contract is declared below; use the domain guide for assumptions and s
 export interface CalculateLensComplexPupilPsfInput {
   profile:
     LensComplexPupilProfile;
+  /** Physical pupil-to-image propagation scale in mm. Omission preserves the
+   * nominal focal-plane reference. Finite-focus callers must explicitly resolve
+   * the supported principal-plane geometry; profile metadata does not do so. */
+  propagationDistanceMm?: number;
 }
 ```
 
@@ -133,6 +137,8 @@ The exact contract is declared below; use the domain guide for assumptions and s
 
 ```ts
 export interface LensComplexPupilPsf {
+  propagationDistanceMm: number;
+  propagationDistanceSource: "explicit" | "nominal-focal-plane-reference";
   profileId: string;
   profileVersion: string;
   scientificStatus:

package/docs/api/optics-depth-of-field.md

@@ -1,6 +1,6 @@
 # optics/depth-of-field.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateDefocusCircle
 

package/docs/api/optics-diffraction.md

@@ -1,6 +1,6 @@
 # optics/diffraction.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## AiryDisk
 

package/docs/api/optics-focus-breathing.md

@@ -1,6 +1,6 @@
 # optics/focus-breathing.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateFocusBreathingFieldOfView
 

package/docs/api/optics-focus-state.md

@@ -1,6 +1,6 @@
 # optics/focus-state.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateFocusPlaneImageDistance
 

package/docs/api/optics-front-of-lens-filter.md

@@ -1,6 +1,6 @@
 # optics/front-of-lens-filter.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## ComposedFrontOfLensFilterTransmission
 

package/docs/api/optics-illumination-vignetting.md

@@ -1,6 +1,6 @@
 # optics/illumination-vignetting.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateIlluminationVignetting
 

package/docs/api/optics-lateral-chromatic-aberration.md

@@ -1,6 +1,6 @@
 # optics/lateral-chromatic-aberration.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## calculateInverseLateralChromaticAberrationMapping
 

package/docs/api/optics-lens-psf-profile.md

@@ -1,6 +1,6 @@
 # optics/lens-psf-profile.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## assessMtfOnlyPsfRenderability
 

package/docs/api/optics-polygon-diffraction.md

@@ -1,6 +1,6 @@
 # optics/polygon-diffraction.ts public contracts
 
-Package **1.1.0**, root API **1.1.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+Package **1.2.0**, root API **1.2.0**. [Navigation](../API_REFERENCE.md) · [Developer guide](../DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
 
 ## CalculateIdealPolygonDiffractionInput