@photivra/engine 1.1.0 → 1.2.0

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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## 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.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.
 
 ## calculateLensCorrectedCapture
 

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

@@ -0,0 +1,150 @@
+# output/native-capture-sdr.ts public contracts
+
+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.
+
+## 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.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.
+
+## 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;
+}
+```

package/docs/api/output-print-detail.md

@@ -1,6 +1,6 @@
 # output/print-detail.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.
 
 ## calculatePrintRegionDetail
 

package/docs/api/output-print-plan.md

@@ -1,6 +1,6 @@
 # output/print-plan.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.
 
 ## calculatePrintPlan
 

package/docs/api/output-print-region-statistics.md

@@ -0,0 +1,165 @@
+# output/print-region-statistics.ts public contracts
+
+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.
+
+## calculatePrintRegionDifference
+
+Measure registered processing changes; residual is not automatically compression/noise.
+
+```ts
+export function calculatePrintRegionDifference(value: PrintRegionDifferenceInput): CalculationResult<PrintRegionStatisticsAssessment<PrintRegionDifferenceInput, PrintRegionDifferenceMeasurement>>;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## calculatePrintRegionNoise
+
+Measure n-1 per-site temporal sample variance, independently of scene spatial texture.
+
+```ts
+export function calculatePrintRegionNoise(value: PrintRegionNoiseInput): CalculationResult<PrintRegionStatisticsAssessment<PrintRegionNoiseInput, PrintRegionNoiseMeasurement>>;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## MAX_PRINT_REGION_STATISTICS_SAMPLES
+
+Maximum scalar samples across every frame/reference in one request.
+
+```ts
+MAX_PRINT_REGION_STATISTICS_SAMPLES = MAX_PRINT_DETAIL_REGION_SAMPLES
+```
+
+## parsePrintRegionDifferenceInput
+
+Parse/copy an untrusted paired scalar ROI request.
+
+```ts
+export function parsePrintRegionDifferenceInput(v: unknown): PrintRegionDifferenceInput;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## parsePrintRegionNoiseInput
+
+Parse/copy an untrusted repeat-capture ensemble with a total scalar work bound.
+
+```ts
+export function parsePrintRegionNoiseInput(v: unknown): PrintRegionNoiseInput;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## PRINT_REGION_STATISTICS_MODEL_VERSION
+
+Independent of the root distribution and coherent-detail protocol.
+
+```ts
+PRINT_REGION_STATISTICS_MODEL_VERSION = "0.1.0" as const
+```
+
+## PrintRegionDifferenceInput
+
+Compare identical sample sites through processing, without mixing noise draws.
+A known range is a declared reference signal range, never a clipping threshold.
+
+```ts
+export interface PrintRegionDifferenceInput {
+  assessmentId: string;
+  before: PrintRegionRaster;
+  after: PrintRegionRaster;
+  purpose: "processing-change" | "decoded-file-change";
+  realizationPolicy: "same-noise-realization" | "deterministic-reference";
+  referenceRange: { lowerRelativeLuminance: number; upperRelativeLuminance: number } | null;
+}
+```
+
+## PrintRegionDifferenceMeasurement
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface PrintRegionDifferenceMeasurement {
+  meanSignedDifferenceRelativeLuminance: number;
+  rmsDifferenceRelativeLuminance: number;
+  maximumAbsoluteDifferenceRelativeLuminance: number;
+  /** Null unless the caller supplied a reference range; not a halo classifier. */
+  rangeExcursions: {
+    beforeBelowRangeCount: number;
+    beforeAboveRangeCount: number;
+    afterBelowRangeCount: number;
+    afterAboveRangeCount: number;
+    beforeMaximumUndershootRelativeLuminance: number;
+    beforeMaximumOvershootRelativeLuminance: number;
+    afterMaximumUndershootRelativeLuminance: number;
+    afterMaximumOvershootRelativeLuminance: number;
+  } | null;
+}
+```
+
+## PrintRegionNoiseInput
+
+Sample statistics at registered sites over independently acquired repeats.
+Stationarity/independence are declarations; a single frame is never a noise ensemble.
+
+```ts
+export interface PrintRegionNoiseInput {
+  assessmentId: string;
+  ensembleId: string;
+  stationarySceneId: string;
+  repeatPolicy: "independent-stationary-captures";
+  frames: readonly PrintRegionRaster[];
+}
+```
+
+## PrintRegionNoiseMeasurement
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface PrintRegionNoiseMeasurement {
+  frameCount: number;
+  siteCount: number;
+  meanRelativeLuminance: number;
+  /** Mean of per-site sample variances with n-1 denominator, in squared linear units. */
+  meanTemporalSampleVarianceRelativeLuminanceSquared: number;
+  temporalRmsRelativeLuminance: number;
+  /** Separately retained so scene texture/fixed pattern is not relabelled temporal noise. */
+  perSiteMeansRelativeLuminance: readonly number[];
+  perSiteSampleVariancesRelativeLuminanceSquared: readonly number[];
+}
+```
+
+## PrintRegionRaster
+
+Exact, unwarped scalar linear ROI; sample and hash verification remains external.
+
+```ts
+export interface PrintRegionRaster {
+  print: PrintPlanInput;
+  source: PrintDetailSource;
+  region: PrintDetailRegion;
+  samples: readonly number[];
+}
+```
+
+## PrintRegionStatisticsAssessment
+
+Measurements remain diagnostic. No physical-noise calibration or print verdict.
+
+```ts
+export interface PrintRegionStatisticsAssessment<TInput, TMeasurement> {
+  assessmentId: string;
+  engineApiVersion: string;
+  modelVersion: typeof PRINT_REGION_STATISTICS_MODEL_VERSION;
+  input: TInput;
+  status: "diagnostic-only" | "blocked" | "unsupported";
+  blockers: string[];
+  print: PrintPlan;
+  measurement: TMeasurement | null;
+  sourceArtifactVerification: "caller-declared-unverified";
+  acquisitionQualification: "unassessed";
+  uncertainty: "not-quantified";
+  overallPrintVerdict: "not-offered";
+}
+```

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

@@ -1,6 +1,6 @@
 # output/sdr-rendering.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.
 
 ## calculateSdrRendering
 

package/docs/api/output-subject-framing-crop.md

@@ -1,6 +1,6 @@
 # output/subject-framing-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.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.
 
 ## calculateSubjectFramingCrop
 

package/docs/api/schema-camera.md

@@ -1,6 +1,6 @@
 # schema/camera.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.
 
 ## CameraConfiguration
 

package/docs/api/schema-illumination-spectral.md

@@ -1,6 +1,6 @@
 # schema/illumination-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.
 
 ## createSceneIlluminationSpectralCoverageParticipant
 

package/docs/api/schema-illumination-temporal.md

@@ -1,6 +1,6 @@
 # schema/illumination-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.
 
 ## evaluateSceneIlluminationTemporalMultiplier
 

package/docs/api/schema-illumination.md

@@ -1,6 +1,6 @@
 # schema/illumination.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.
 
 ## parseSceneIlluminationProfile
 

package/docs/api/schema-scene-radiance-temporal.md

@@ -1,6 +1,6 @@
 # schema/scene-radiance-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.
 
 ## createSceneRadianceTemporalSamplingPlan
 

package/docs/api/schema-scene-radiance.md

@@ -1,6 +1,6 @@
 # schema/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.
 
 ## assessSceneMaterialResponseFidelity
 

package/docs/api/schema-scene.md

@@ -1,6 +1,6 @@
 # schema/scene.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.
 
 ## SceneCapability