@photivra/engine 1.3.0 → 1.4.0

package/docs/api/camera-field-of-view.md

@@ -1,6 +1,6 @@
 # camera/field-of-view.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## calculateFieldOfView
 

package/docs/api/camera-projected-object-size.md

@@ -1,6 +1,6 @@
 # camera/projected-object-size.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## calculateProjectedObjectSize
 

package/docs/api/capture-capture-export-metadata.md

@@ -1,6 +1,6 @@
 # capture/capture-export-metadata.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## CAPTURE_EXPORT_METADATA_SCHEMA_VERSION
 

package/docs/api/capture-environment-raw-producer.md

@@ -1,6 +1,6 @@
 # capture/environment-raw-producer.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## EnvironmentSensorRawFrame
 
@@ -45,12 +45,13 @@ export interface SimulateEnvironmentSensorRawFrameInput {
   /** Shared shutter schedule is bound to the committed frame duration. */
   exposureWindow: NonNullable<SensorRawProducerInput["exposureWindow"]>;
   sites: readonly {
-    environment: Omit<CalculateEnvironmentSensorPhotoSignalInput, "evaluateRadiance">;
+    environment: Omit<CalculateEnvironmentSensorPhotoSignalInput, "evaluateRadiance" | "evaluateApertureRadiance">;
     darkCurrentProfile: SensorDarkCurrentProfile;
     operatingTemperatureC: number;
     charge: Omit<SensorRawProducerSiteInput["charge"], "photoSignal" | "darkCharge">;
     readout: Omit<SensorRawProducerSiteInput, "charge">;
   }[];
   evaluateRadiance: EnvironmentRadianceEvaluator;
+  evaluateApertureRadiance?: EnvironmentApertureRadianceEvaluator;
 }
 ```

package/docs/api/capture-focus-control.md

@@ -1,6 +1,6 @@
 # capture/focus-control.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## assessFocusReleaseGate
 

package/docs/api/capture-linear-encoding.md

@@ -1,6 +1,6 @@
 # capture/linear-encoding.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## calculateLinearCaptureEncoding
 

package/docs/api/capture-native-environment-raw.md

@@ -0,0 +1,88 @@
+# capture/native-environment-raw.ts public contracts
+
+Package **1.4.0**, root API **1.4.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.
+
+## createNativeEnvironmentRawTask
+
+Every tile is planned and admission-checked before its radiance callbacks; no partial output escapes.
+
+```ts
+export function createNativeEnvironmentRawTask(input:NativeEnvironmentRawInput,provider:NativeEnvironmentRawProvider):NativeEnvironmentRawTask;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## NativeEnvironmentPhotoTile
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeEnvironmentPhotoTile extends NativeRawTileRequest {
+  sites:readonly {nativeIndex:number;expectedIncidentPhotonCount:number;expectedGeneratedElectronCount:number}[];
+}
+```
+
+## NativeEnvironmentRawInput
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeEnvironmentRawInput {
+  raw: NativeRawInput;
+  sceneBinding: SimulateEnvironmentSensorRawFrameInput["sceneBinding"];
+  /** Full-event admission budget; maximum 2 billion calls. No convergence is inferred. */
+  maximumProviderEvaluations: number;
+}
+```
+
+## NativeEnvironmentRawOutput
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeEnvironmentRawOutput {
+  raw: NativeRawOutput;
+  sceneBinding: NativeEnvironmentRawInput["sceneBinding"];
+  providerEvaluationCount: number;
+  upstreamOrigin: "executed-environment-query-provider-optics-psf-eqe";
+  providerTransportVerified: false;
+  productionPlanActivated: false;
+}
+```
+
+## NativeEnvironmentRawProvider
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeEnvironmentRawProvider {
+  /** Supplies physical site profiles, not photo counts or precomputed RAW codes. */
+  readTile(request: Readonly<NativeRawTileRequest>,signal:AbortSignal):Promise<NativeEnvironmentRawTile>;
+  evaluateRadiance: SimulateEnvironmentSensorRawFrameInput["evaluateRadiance"];
+  evaluateApertureRadiance?: SimulateEnvironmentSensorRawFrameInput["evaluateApertureRadiance"];
+  /** Optional bounded diagnostic observer; counts are expectation values before any noise/clamp/ADC. */
+  observePhotoTile?(tile:Readonly<NativeEnvironmentPhotoTile>,signal:AbortSignal):void|Promise<void>;
+  yieldControl(signal:AbortSignal):Promise<void>;
+}
+```
+
+## NativeEnvironmentRawTask
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeEnvironmentRawTask extends Omit<NativeRawTask,"takeOutput"> {
+  readonly providerEvaluationCount: number;
+  takeOutput(): NativeEnvironmentRawOutput;
+}
+```
+
+## NativeEnvironmentRawTile
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeEnvironmentRawTile extends NativeRawTileRequest {
+  sites: SimulateEnvironmentSensorRawFrameInput["sites"];
+}
+```

package/docs/api/capture-native-raw-development.md

@@ -0,0 +1,66 @@
+# capture/native-raw-development.ts public contracts
+
+Package **1.4.0**, root API **1.4.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.
+
+## createNativeRawDevelopmentTask
+
+Validates complete phase/halo support, snapshots RAW once, and yields between 256-pixel output tiles.
+
+```ts
+export function createNativeRawDevelopmentTask(input: NativeRawDevelopmentInput,
+  yieldControl: (signal:AbortSignal)=>Promise<void>): NativeRawDevelopmentTask;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## NativeRawDevelopmentInput
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawDevelopmentInput {
+  raw: NativeRawOutput;
+  phaseProfiles: readonly RawFrameReconstructionPhaseProfile[];
+  colorProfile: ExportSensorColorProfile;
+  whiteBalance: "not-required" | "apply-resolved-sensor-gains";
+  rendering: SdrRenderingProfile;
+  /** Includes one owned packed RAW copy plus integer output; not caller buffers, process heap or GPU. */
+  maximumRetainedPayloadBytes: number;
+}
+```
+
+## NativeRawDevelopmentOutput
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawDevelopmentOutput {
+  raw: NativeRawOutput;
+  phaseProfiles: readonly RawFrameReconstructionPhaseProfile[];
+  colorProfile: ExportSensorColorProfile;
+  whiteBalance: NativeRawDevelopmentInput["whiteBalance"];
+  width: number;
+  height: number;
+  integerSamples: Uint8Array | Uint16Array;
+  diagnostics: SdrRenderingResult["diagnostics"];
+  outputEncoding: SdrRenderingResult["outputEncoding"];
+  rendering: SdrRenderingProfile;
+  displayAdaptation: SdrRenderingResult["displayAdaptation"];
+  imageDataPairing: "derived-from-exact-packed-native-raw";
+  producerOriginVerified: false;
+}
+```
+
+## NativeRawDevelopmentTask
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawDevelopmentTask {
+  readonly state: NativeRawTaskState;
+  run(): Promise<void>;
+  cancel(): void;
+  dispose(): void;
+  takeOutput(): NativeRawDevelopmentOutput;
+}
+```

package/docs/api/capture-native-raw.md

@@ -0,0 +1,157 @@
+# capture/native-raw.ts public contracts
+
+Package **1.4.0**, root API **1.4.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.
+
+## calculateNativeRawPlan
+
+Full raster/resource/profile admission before callbacks or output allocation; no placeholder plane.
+
+```ts
+export function calculateNativeRawPlan(input: NativeRawInput): NativeRawPlan;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## createNativeRawTask
+
+Executes validated EQE/dark/completeness events through the shared reference scalar physics.
+
+```ts
+export function createNativeRawTask(input: NativeRawInput,provider: NativeRawProvider): NativeRawTask;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## NATIVE_RAW_LIMITS
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+NATIVE_RAW_LIMITS = Object.freeze({ maximumPixels: 24_000_000, maximumDimension: 16_384,
+  tileWidth: 256, tileHeight: 1, outputBytesPerPixel: 7 })
+```
+
+## NATIVE_RAW_SCHEMA_VERSION
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+NATIVE_RAW_SCHEMA_VERSION = "0.1.0" as const
+```
+
+## NativeRawExposure
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export type NativeRawExposure = Omit<SimulatedCapture, "schemaVersion" | "planes" | "source"> & {source:CaptureExposureSource};
+```
+
+## NativeRawExposureInput
+
+A shooting event and source provenance, not a produced float master or committed RAW frame.
+
+```ts
+export type NativeRawExposureInput = Omit<SimulatedCaptureInput, "planes" | "source"> & {source:CaptureExposureSource};
+```
+
+## NativeRawInput
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawInput {
+  exposure: NativeRawExposureInput;
+  frameId: string;
+  modeId: string;
+  captureModeProfile: NativeRawProducerFrameContext["captureModeProfile"];
+  colorSamplingProfile: NativeRawProducerFrameContext["colorSamplingProfile"];
+  bindingProfile: NativeRawProducerFrameContext["bindingProfile"];
+  exposureWindow?: SensorRawProducerExposureWindowInput;
+  maximumOutputBytes: number;
+}
+```
+
+## NativeRawOutput
+
+Sole-owner row-major arrays. They are not attachable to the bounded SensorRawFrame contract.
+
+```ts
+export interface NativeRawOutput {
+  plan: NativeRawPlan;
+  codes: Uint16Array;
+  blackLevels: Uint16Array;
+  digitalSaturationCodes: Uint16Array;
+  /** Bits 0,1,2: physical scalar clamp, pre-ADC clamp, digital saturation respectively. */
+  saturationFlags: Uint8Array;
+}
+```
+
+## NativeRawPlan
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawPlan {
+  schemaVersion: typeof NATIVE_RAW_SCHEMA_VERSION;
+  exposure: NativeRawExposure;
+  frame: NativeRawProducerFrameContext;
+  exposureWindow?: SensorRawProducerExposureWindowInput;
+  pixelCount: number;
+  outputBytes: number;
+  tileCount: number;
+  upstreamRadiometryVerified: false;
+  seedSchedule: "capture-seed-plus-two-native-index-modulo-2-to-32-v1";
+}
+```
+
+## NativeRawProvider
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawProvider {
+  readTile(request: Readonly<NativeRawTileRequest>, signal: AbortSignal): Promise<NativeRawTile>;
+  yieldControl(signal: AbortSignal): Promise<void>;
+}
+```
+
+## NativeRawTask
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawTask {
+  readonly plan: NativeRawPlan;
+  readonly state: NativeRawTaskState;
+  readonly completedTileCount: number;
+  run(): Promise<void>;
+  cancel(): void;
+  dispose(): void;
+  takeOutput(): NativeRawOutput;
+}
+```
+
+## NativeRawTaskState
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export type NativeRawTaskState = "ready" | "running" | "completed" | "cancelled" | "failed" | "disposed" | "transferred";
+```
+
+## NativeRawTile
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export interface NativeRawTile extends NativeRawTileRequest { sites: readonly SensorRawProducerSiteInput[] }
+```
+
+## NativeRawTileRequest
+
+Rectangle is absolute full-native CFA space, before orientation, active crop or output scaling.
+
+```ts
+export interface NativeRawTileRequest { captureId: string; frameId: string; x: number; y: number; width: number; height: number }
+```

package/docs/api/capture-photographic-export.md

@@ -1,6 +1,6 @@
 # capture/photographic-export.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## calculateProcessedSensorRaw
 

package/docs/api/capture-raw-frame-reconstruction.md

@@ -1,6 +1,6 @@
 # capture/raw-frame-reconstruction.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## parseRawFrameReconstructionInput
 

package/docs/api/capture-release-sequence.md

@@ -1,6 +1,6 @@
 # capture/release-sequence.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## CancelledReleaseSequence
 

package/docs/api/capture-sensor-raw-frame.md

@@ -1,6 +1,6 @@
 # capture/sensor-raw-frame.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## createSensorRawFrame
 

package/docs/api/capture-sensor-raw-producer.md

@@ -1,6 +1,6 @@
 # capture/sensor-raw-producer.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## parseSensorRawProducerInput
 

package/docs/api/capture-simulated-capture.md

@@ -1,6 +1,14 @@
 # capture/simulated-capture.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.
+Package **1.4.0**, root API **1.4.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.
+
+## CaptureExposureSource
+
+A procedural/physical source identity without a manufactured linear-master plane.
+
+```ts
+export type CaptureExposureSource = SimulatedCaptureInput["source"] | (Omit<SimulatedCaptureInput["source"], "kind"> & {kind:"scene-radiance-source"});
+```
 
 ## CaptureFloatStorage
 

package/docs/api/color-capture-color.md

@@ -1,6 +1,6 @@
 # color/capture-color.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## calculateCaptureColorTransform
 

package/docs/api/color-srgb-icc.md

@@ -0,0 +1,23 @@
+# color/srgb-icc.ts public contracts
+
+Package **1.4.0**, root API **1.4.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.
+
+## createSrgbIccProfile
+
+Reference: https://registry.color.org/rgb-registry/files/sRGB.pdf and ICC.1:2022.
+This is an original Photivra profile, not a redistributed ICC or operating-system profile.
+Bradford here encodes the D50 profile-connection space; it does not apply shooting WB.
+
+```ts
+export function createSrgbIccProfile():Uint8Array;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## SRGB_ICC_PROFILE_VERSION
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+SRGB_ICC_PROFILE_VERSION="0.1.0" as const
+```

package/docs/api/color-white-balance.md

@@ -1,6 +1,6 @@
 # color/white-balance.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## COLOR_TEMPERATURE_WHITE_BALANCE_INTENT_VERSION
 

package/docs/api/composition-image-formation-plan.md

@@ -1,6 +1,6 @@
 # composition/image-formation-plan.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## createProductionCaptureSnapshot
 

package/docs/api/composition-plan-consumer.md

@@ -1,6 +1,6 @@
 # composition/plan-consumer.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## createProductionPlanConsumerManifest
 

package/docs/api/core-calculation-result.md

@@ -1,6 +1,6 @@
 # core/calculation-result.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## AbsoluteUncertaintyEstimate
 

package/docs/api/core-configuration-error.md

@@ -1,6 +1,6 @@
 # core/configuration-error.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## InvalidConfigurationError
 

package/docs/api/core-image-formation.md

@@ -1,6 +1,6 @@
 # core/image-formation.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## getImageFormationContract
 

package/docs/api/core-scientific-assurance.md

@@ -1,6 +1,6 @@
 # core/scientific-assurance.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.
+Package **1.4.0**, root API **1.4.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.
 
 ## ComposedScientificAssurance
 

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

@@ -1,6 +1,6 @@
 # core/spectral-composition.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.
+Package **1.4.0**, root API **1.4.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.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.
+Package **1.4.0**, root API **1.4.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.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.
+Package **1.4.0**, root API **1.4.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.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.
+Package **1.4.0**, root API **1.4.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.3.0" as const
+ENGINE_API_VERSION = "1.4.0" as const
 ```

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

@@ -1,6 +1,6 @@
 # equipment/exposure-capabilities.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.
+Package **1.4.0**, root API **1.4.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.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.
+Package **1.4.0**, root API **1.4.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.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.
+Package **1.4.0**, root API **1.4.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.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.
+Package **1.4.0**, root API **1.4.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.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.
+Package **1.4.0**, root API **1.4.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