@photivra/engine 1.1.0 → 1.3.0

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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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.3.0**, root API **1.3.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
 

package/docs/api/optics-profile-contract.md

@@ -1,6 +1,6 @@
 # optics/profile-contract.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.3.0**, root API **1.3.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.
 
 ## GenericOpticalEvidence
 

package/docs/api/optics-psf-foundation.md

@@ -1,6 +1,6 @@
 # optics/psf-foundation.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.3.0**, root API **1.3.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.
 
 ## calculatePsfFoundationComponents
 

package/docs/api/optics-radial-distortion.md

@@ -1,6 +1,6 @@
 # optics/radial-distortion.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.3.0**, root API **1.3.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.
 
 ## calculateInverseRadialDistortionMapping
 

package/docs/api/optics-scene-to-sensor-irradiance.md

@@ -1,6 +1,6 @@
 # optics/scene-to-sensor-irradiance.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.3.0**, root API **1.3.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.
 
 ## calculateSceneRadianceToSensorIrradiance
 

package/docs/api/optics-scene-to-sensor-quadrature.md

@@ -1,6 +1,6 @@
 # optics/scene-to-sensor-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.3.0**, root API **1.3.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.
 
 ## calculateSceneToSensorIrradianceQuadrature
 

package/docs/api/optics-sensor-environment-query.md

@@ -1,6 +1,6 @@
 # optics/sensor-environment-query.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.3.0**, root API **1.3.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.
 
 ## calculateSensorEnvironmentRadianceQuery
 

package/docs/api/optics-sensor-psf-quadrature.md

@@ -1,6 +1,6 @@
 # optics/sensor-psf-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.3.0**, root API **1.3.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.
 
 ## calculateSensorPsfIrradianceQuadrature
 

package/docs/api/optics-stray-light.md

@@ -1,6 +1,6 @@
 # optics/stray-light.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.3.0**, root API **1.3.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.
 
 ## calculateLensStrayLightIrradiance
 

package/docs/api/optics-thin-lens.md

@@ -1,6 +1,6 @@
 # optics/thin-lens.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.3.0**, root API **1.3.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.
 
 ## calculateThinLensImageDistance
 

package/docs/api/output-capture-corrected-sdr.md

@@ -1,6 +1,6 @@
 # output/capture-corrected-sdr.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.3.0**, root API **1.3.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.
 
 ## calculateCaptureCorrectedSdr
 

package/docs/api/output-capture-geometry.md

@@ -1,6 +1,6 @@
 # output/capture-geometry.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.3.0**, root API **1.3.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.
 
 ## ActiveCaptureFieldOfView
 

package/docs/api/output-capture-sdr.md

@@ -1,6 +1,6 @@
 # output/capture-sdr.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.3.0**, root API **1.3.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.
 
 ## calculateCaptureSdr
 

package/docs/api/output-crop.md

@@ -1,6 +1,6 @@
 # output/crop.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.3.0**, root API **1.3.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.
 
 ## calculateCenteredCrop
 

package/docs/api/output-geometric-transforms.md

@@ -1,6 +1,6 @@
 # output/geometric-transforms.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.3.0**, root API **1.3.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.
 
 ## AffineGeometricTransform
 

package/docs/api/output-lens-corrections.md

@@ -1,6 +1,6 @@
 # output/lens-corrections.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.3.0**, root API **1.3.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.
 
 ## calculateLensCorrectedCapture
 

package/docs/api/output-native-capture-sdr.md

@@ -0,0 +1,150 @@
+# output/native-capture-sdr.ts public contracts
+
+Package **1.3.0**, root API **1.3.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.
+
+## calculateNativeCaptureSdrPlan
+
+Validates/admission-plans without reading external samples or allocating a raster.
+
+```ts
+export function calculateNativeCaptureSdrPlan(input: NativeCaptureSdrInput): NativeCaptureSdrPlan;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## createNativeCaptureSdrTask
+
+Creates a single-use execution owner. Admission is validated before any buffer/provider work.
+
+```ts
+export function createNativeCaptureSdrTask(input: NativeCaptureSdrInput, provider: NativeCaptureSdrProvider): NativeCaptureSdrTask;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## NATIVE_CAPTURE_SDR_LIMITS
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+NATIVE_CAPTURE_SDR_LIMITS = Object.freeze({ maximumPixels: 24_000_000,
+  maximumDimension: 16_384, tileWidth: 256, tileHeight: 32, maximumTileStorageSamples: 32_768 })
+```
+
+## NATIVE_CAPTURE_SDR_SCHEMA_VERSION
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+NATIVE_CAPTURE_SDR_SCHEMA_VERSION = "0.1.0" as const
+```
+
+## NativeCaptureSdrInput
+
+Metadata-only external float master. Samples must already be color/WB resolved.
+
+```ts
+export interface NativeCaptureSdrInput {
+  capture: SimulatedCapture;
+  sourcePlaneId: string;
+  outputImageStateId: string;
+  profile: SdrRenderingProfile;
+  /** Admission limit for retained integer output, before allocation or provider calls. */
+  maximumOutputBytes: number;
+}
+```
+
+## NativeCaptureSdrOutput
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeCaptureSdrOutput {
+  plan: NativeCaptureSdrPlan;
+  /** Caller-owned packed row-major RGB; 16-bit codes are numeric, not serialized endian bytes. */
+  integerSamples: Uint8Array | Uint16Array;
+  diagnostics: SdrRenderingResult["diagnostics"];
+  outputEncoding: SdrRenderingResult["outputEncoding"];
+  displayAdaptation: SdrRenderingResult["displayAdaptation"];
+}
+```
+
+## NativeCaptureSdrPlan
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeCaptureSdrPlan {
+  schemaVersion: typeof NATIVE_CAPTURE_SDR_SCHEMA_VERSION;
+  capture: SimulatedCapture;
+  sourcePlaneId: string;
+  outputImageStateId: string;
+  profile: SdrRenderingProfile;
+  outputBytes: number;
+  /** Logical array payload bound, not JS heap/GPU/process peak memory or device qualification. */
+  maximumScratchPayloadBytes: number;
+  tileCount: number;
+}
+```
+
+## NativeCaptureSdrProvider
+
+One provider call at a time. Caller must release decoding/GPU resources on abort/settlement.
+
+```ts
+export interface NativeCaptureSdrProvider {
+  readTile(request: Readonly<NativeCaptureSdrTileRequest>, signal: AbortSignal): Promise<NativeCaptureSdrTile>;
+  /** Must yield to the host event loop, allowing cancellation/input events between tiles. */
+  yieldControl(signal: AbortSignal): Promise<void>;
+}
+```
+
+## NativeCaptureSdrTask
+
+Single-use task: no partial output escapes; cancel/dispose prevents late publication.
+
+```ts
+export interface NativeCaptureSdrTask {
+  readonly plan: NativeCaptureSdrPlan;
+  readonly state: NativeCaptureSdrTaskState;
+  readonly completedTileCount: number;
+  run(): Promise<void>;
+  cancel(): void;
+  dispose(): void;
+  /** Transfers sole retained buffer ownership once. Dispose cannot revoke a transferred buffer. */
+  takeOutput(): NativeCaptureSdrOutput;
+}
+```
+
+## NativeCaptureSdrTaskState
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export type NativeCaptureSdrTaskState = "ready" | "running" | "completed" | "cancelled" | "failed" | "disposed" | "transferred";
+```
+
+## NativeCaptureSdrTile
+
+Returned tile is exclusively handed to this call; do not mutate/reuse it. Padding is not image data.
+
+```ts
+export interface NativeCaptureSdrTile extends NativeCaptureSdrTileRequest {
+  rowStrideSamples: number;
+  samples: Float32Array | Float64Array;
+}
+```
+
+## NativeCaptureSdrTileRequest
+
+Absolute coordinates in the selected plane's declared binding, never crop-local sensor indices.
+
+```ts
+export interface NativeCaptureSdrTileRequest {
+  captureId: string;
+  sourcePlaneId: string;
+  artifactId: string;
+  sha256: string;
+  x: number; y: number; width: number; height: number;
+}
+```

package/docs/api/output-print-contrast-reference.md

@@ -0,0 +1,82 @@
+# output/print-contrast-reference.ts public contracts
+
+Package **1.3.0**, root API **1.3.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.
+
+## calculatePrintContrastReference
+
+Estimate the restricted published-model threshold; no individual invisibility claim.
+
+```ts
+export function calculatePrintContrastReference(value: PrintContrastReferenceInput): CalculationResult<PrintContrastReference>;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## parsePrintContrastReferenceInput
+
+Strictly parse/copy explicit reference conditions; no defaults infer an observer.
+
+```ts
+export function parsePrintContrastReferenceInput(value: unknown): PrintContrastReferenceInput;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## PRINT_CONTRAST_REFERENCE_MODEL_VERSION
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+PRINT_CONTRAST_REFERENCE_MODEL_VERSION = "0.1.0" as const
+```
+
+## PRINT_CONTRAST_REFERENCE_UPSTREAM_REVISION
+
+Exact MIT-licensed numerical-model source, not a local calibration identity.
+
+```ts
+PRINT_CONTRAST_REFERENCE_UPSTREAM_REVISION = "f4b0b722af83001d7af979281e06ca642d36e4e8" as const
+```
+
+## PrintContrastReference
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface PrintContrastReference {
+  referenceId: string;
+  engineApiVersion: string;
+  modelVersion: typeof PRINT_CONTRAST_REFERENCE_MODEL_VERSION;
+  upstreamRevision: typeof PRINT_CONTRAST_REFERENCE_UPSTREAM_REVISION;
+  input: PrintContrastReferenceInput;
+  status: "model-estimate" | "unsupported";
+  blockers: string[];
+  estimate: { contrastSensitivity: number; thresholdModulationMichelson: number; suppliedModulationToModelThresholdRatio: number } | null;
+  observerApplicability: "population-reference-unverified-for-individual";
+  naturalImageVisibility: "unassessed";
+  printStimulusMatch: "unassessed";
+  uncertainty: "not-quantified";
+  overallPrintVerdict: "not-offered";
+}
+```
+
+## PrintContrastReferenceInput
+
+Narrow reference stimulus, separate from any measured photographic ROI.
+Positive but out-of-domain quantities return unsupported rather than extrapolation.
+
+```ts
+export interface PrintContrastReferenceInput {
+  referenceId: string;
+  stimulus: "static-neutral-d65-gabor";
+  observer: "published-binocular-natural-pupil-reference";
+  /** Uniform D65 background/carrier mean; not the average of a finite photographic ROI. */
+  meanLuminanceCdPerSquareMeter: number;
+  spatialFrequencyCyclesPerDegree: number;
+  gaussianEnvelopeSigmaDegrees: number;
+  temporalFrequencyHz: number;
+  eccentricityDegrees: number;
+  /** Neutral carrier fractional amplitude before the Gaussian envelope; not arbitrary ROI extrema. */
+  modulationMichelson: number;
+}
+```