@photivra/engine 2.21.0 → 2.23.0

package/docs/api/exports.json

@@ -1,6 +1,6 @@
 {
-  "packageVersion": "2.21.0",
-  "engineApiVersion": "2.21.0",
+  "packageVersion": "2.23.0",
+  "engineApiVersion": "2.23.0",
   "exports": [
     {
       "name": "AbsoluteUncertaintyEstimate",
@@ -102,6 +102,36 @@
       "source": "src/optics/aperture.ts",
       "kind": "type"
     },
+    {
+      "name": "applyDngOpcodes",
+      "source": "src/capture/dng-opcodes.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "ApplyDngOpcodesOptions",
+      "source": "src/capture/dng-opcodes.ts",
+      "kind": "type"
+    },
+    {
+      "name": "applyDngProfileGainTableMap",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "ApplyDngProfileGainTableMapInput",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "type"
+    },
+    {
+      "name": "applyDngRgbTables",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "ApplyDngRgbTablesInput",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "type"
+    },
     {
       "name": "approximationResult",
       "source": "src/core/calculation-result.ts",
@@ -252,6 +282,16 @@
       "source": "src/processing/denoise.ts",
       "kind": "type"
     },
+    {
+      "name": "bindC2paManifestStore",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "BindC2paManifestStoreInput",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
     {
       "name": "bindDisplayViewCorrectionStates",
       "source": "src/facade/display-view.ts",
@@ -347,6 +387,41 @@
       "source": "src/sensor/raw-reconstruction.ts",
       "kind": "type"
     },
+    {
+      "name": "C2PA_ALGORITHMIC_MEDIA_SOURCE_TYPE",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "C2PA_MANIFEST_STORE_MAXIMUM_BYTES",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "C2paBoundFile",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
+    {
+      "name": "C2paByteRange",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
+    {
+      "name": "C2paDataHash",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
+    {
+      "name": "C2paFoundManifestStore",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
+    {
+      "name": "C2paHardBinding",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
     {
       "name": "calculateActiveCaptureFieldOfView",
       "source": "src/output/capture-geometry.ts",
@@ -412,6 +487,26 @@
       "source": "src/optics/brown-conrady-distortion.ts",
       "kind": "type"
     },
+    {
+      "name": "calculateC2paDataHash",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "CalculateC2paDataHashInput",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
+    {
+      "name": "calculateCameraChannelResponse",
+      "source": "src/output/camera-channel-response.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "CalculateCameraChannelResponseInput",
+      "source": "src/output/camera-channel-response.ts",
+      "kind": "type"
+    },
     {
       "name": "calculateCameraRotationImageMapping",
       "source": "src/motion/camera-rotation.ts",
@@ -1602,6 +1697,11 @@
       "source": "src/motion/camera-rotation.ts",
       "kind": "type"
     },
+    {
+      "name": "CameraChannelResponse",
+      "source": "src/output/camera-channel-response.ts",
+      "kind": "type"
+    },
     {
       "name": "CameraColorMatrixFit",
       "source": "src/color/camera-color-matrix.ts",
@@ -2587,6 +2687,11 @@
       "source": "src/sensor/iso-gain.ts",
       "kind": "type"
     },
+    {
+      "name": "createJxlOxideDngDecoder",
+      "source": "src/capture/jpeg-xl-tiles.ts",
+      "kind": "runtime"
+    },
     {
       "name": "createLockedWhiteBalanceState",
       "source": "src/color/white-balance.ts",
@@ -2952,6 +3057,16 @@
       "source": "src/optics/detail-limit.ts",
       "kind": "type"
     },
+    {
+      "name": "developDngStageImage",
+      "source": "src/capture/dng-stage-image.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "DevelopDngStageImageOptions",
+      "source": "src/capture/dng-stage-image.ts",
+      "kind": "type"
+    },
     {
       "name": "DIFFRACTION_LIMITED_PSF_PROFILE_LIMITS",
       "source": "src/optics/diffraction-psf-profile.ts",
@@ -3057,11 +3172,66 @@
       "source": "src/capture/dng-import.ts",
       "kind": "runtime"
     },
+    {
+      "name": "DngImportAsyncInput",
+      "source": "src/capture/dng-import.ts",
+      "kind": "type"
+    },
     {
       "name": "DngImportInput",
       "source": "src/capture/dng-import.ts",
       "kind": "type"
     },
+    {
+      "name": "DngJpegXlDecoder",
+      "source": "src/capture/jpeg-xl-tiles.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngOpcode",
+      "source": "src/capture/dng-opcodes.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngOpcodeArea",
+      "source": "src/capture/dng-opcodes.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngOpcodeParameters",
+      "source": "src/capture/dng-opcodes.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngProfileGainTableMap",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngRgbImage",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngRgbTable",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngRgbTables",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngStageImage",
+      "source": "src/capture/dng-opcodes.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DngStageImageResult",
+      "source": "src/capture/dng-stage-image.ts",
+      "kind": "type"
+    },
     {
       "name": "DurandDorseyToneMappingInput",
       "source": "src/processing/tone-mapping.ts",
@@ -4269,17 +4439,17 @@
     },
     {
       "name": "ImageKernelExecutionError",
-      "source": "src/gpu/image-kernel-execution.ts",
+      "source": "src/core/execution-error.ts",
       "kind": "runtime"
     },
     {
       "name": "ImageKernelFailureReason",
-      "source": "src/gpu/image-kernel-execution.ts",
+      "source": "src/core/execution-error.ts",
       "kind": "type"
     },
     {
       "name": "ImageKernelFallbackReason",
-      "source": "src/gpu/image-kernel-execution.ts",
+      "source": "src/core/execution-error.ts",
       "kind": "type"
     },
     {
@@ -4322,6 +4492,11 @@
       "source": "src/sensor/sensor-geometry.ts",
       "kind": "type"
     },
+    {
+      "name": "importDngRawImage",
+      "source": "src/capture/dng-import.ts",
+      "kind": "runtime"
+    },
     {
       "name": "ImportedDngBlackLevel",
       "source": "src/capture/dng-import.ts",
@@ -4342,6 +4517,11 @@
       "source": "src/capture/dng-import.ts",
       "kind": "type"
     },
+    {
+      "name": "ImportedDngSemanticMask",
+      "source": "src/capture/dng-import.ts",
+      "kind": "type"
+    },
     {
       "name": "IntegratedDiscreteSpectralLineMeasure",
       "source": "src/core/spectral-composition.ts",
@@ -4517,6 +4697,11 @@
       "source": "src/capture/export-jpeg.ts",
       "kind": "type"
     },
+    {
+      "name": "JxlOxideModule",
+      "source": "src/capture/jpeg-xl-tiles.ts",
+      "kind": "type"
+    },
     {
       "name": "LateralCaLensCorrection",
       "source": "src/output/lens-corrections.ts",
@@ -4787,6 +4972,16 @@
       "source": "src/capture/lossless-jpeg.ts",
       "kind": "type"
     },
+    {
+      "name": "LossyJpegImage",
+      "source": "src/capture/lossy-jpeg.ts",
+      "kind": "type"
+    },
+    {
+      "name": "LossyJpegLimits",
+      "source": "src/capture/lossy-jpeg.ts",
+      "kind": "type"
+    },
     {
       "name": "MANUAL_FLASH_PROFILE_SCHEMA_VERSION",
       "source": "src/exposure/flash.ts",
@@ -5387,6 +5582,16 @@
       "source": "src/optics/stray-light.ts",
       "kind": "type"
     },
+    {
+      "name": "parseC2paManifestStore",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "ParseC2paManifestStoreInput",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
     {
       "name": "parseCameraConfiguration",
       "source": "src/schema/validation.ts",
@@ -5432,11 +5637,26 @@
       "source": "src/output/geometric-transforms.ts",
       "kind": "runtime"
     },
+    {
+      "name": "parseDngOpcodeList",
+      "source": "src/capture/dng-opcodes.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "parseDngProfileGainTableMap",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "runtime"
+    },
     {
       "name": "parseDngRawImage",
       "source": "src/capture/dng-import.ts",
       "kind": "runtime"
     },
+    {
+      "name": "parseDngRgbTables",
+      "source": "src/capture/dng-profile-maps.ts",
+      "kind": "runtime"
+    },
     {
       "name": "parseExportSensorColorProfile",
       "source": "src/capture/photographic-export.ts",
@@ -5557,6 +5777,11 @@
       "source": "src/capture/lossless-jpeg.ts",
       "kind": "runtime"
     },
+    {
+      "name": "parseLossyJpeg",
+      "source": "src/capture/lossy-jpeg.ts",
+      "kind": "runtime"
+    },
     {
       "name": "parseManualFlashProfile",
       "source": "src/exposure/flash.ts",
@@ -6112,6 +6337,11 @@
       "source": "src/facade/image-plane-enable.ts",
       "kind": "runtime"
     },
+    {
+      "name": "prepareQualityPaths",
+      "source": "src/facade/quality-paths.ts",
+      "kind": "runtime"
+    },
     {
       "name": "prepareRgbGamutMapping",
       "source": "src/color/gamut-mapping.ts",
@@ -8737,6 +8967,16 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "runtime"
     },
+    {
+      "name": "setC2paManifestStore",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "SetC2paManifestStoreInput",
+      "source": "src/capture/c2pa-embed.ts",
+      "kind": "type"
+    },
     {
       "name": "setExposureCompensationOnMeterTarget",
       "source": "src/exposure/metering-target.ts",
@@ -8952,11 +9192,21 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "SimulateCaptureMidGreyFigure",
+      "source": "src/sensor/sensor-characteristics.ts",
+      "kind": "type"
+    },
     {
       "name": "SimulateCaptureMotion",
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "SimulateCaptureNativeSensorReport",
+      "source": "src/sensor/sensor-characteristics.ts",
+      "kind": "type"
+    },
     {
       "name": "SimulateCaptureNoiseComponents",
       "source": "src/sensor/sensor-characteristics.ts",

package/docs/api/facade-display-view-gpu.md

@@ -58,10 +58,13 @@ export interface DisplayViewGpuConformance {
 2.11 (#481): why a display view that asked for the GPU (`gpu: "auto"`) ran the CPU reference. The accelerator's acquisition
 reasons, plus: `unsupported-on-backend` (no GPU display-view renderer exists in this version, or it does not support the
 request), `conformance-failed` (the device failed the run-time self-check before the view's first GPU render), `device-lost`
-(the device was lost; the rest of the view runs on the CPU) and `disposed` (the prepared view was disposed).
+(the device was lost; the rest of the view runs on the CPU) and `disposed` (the prepared view was disposed). 2.22.0 (#594):
+`quality-code-unavailable` (the on-demand GPU full-quality code could not be loaded; that render runs the CPU reference, and
+the next render that needs the code tries to load it again).
 
 ```ts
-export type DisplayViewGpuFallbackReason = ImageKernelFallbackReason | "unsupported-on-backend" | "conformance-failed" | "device-lost" | "disposed";
+export type DisplayViewGpuFallbackReason = ImageKernelFallbackReason | "unsupported-on-backend" | "conformance-failed" | "device-lost" | "disposed" |
+  "quality-code-unavailable";
 ```
 
 ## DisplayViewGpuMode

package/docs/api/facade-display-view.md

@@ -4,14 +4,10 @@ The package and root API versions are recorded once in [Navigation](../API_REFER
 
 ## bindDisplayViewCorrectionStates
 
-2.10 (#447): adds states another realm computed (an export, or `computeCorrectionStates` results) to this realm's cache and
-returns the number of states added. For each entry, the grid keys its setup does not hold yet are appended; known ones are
-left as they are (a state's values follow from its key, so they are equal). Every entry is checked before the cache is
-touched: `key` a non-empty string, `gridKeys` an Int32Array of grid keys, `values` a Float64Array of 3 × `gridKeys.length`
-finite numbers; otherwise it fails with an InvalidConfigurationError and the cache is unchanged. The cache's bounds apply as
-in a render: an unknown key creates a setup and can evict the least recently used of the four kept, and a setup that
-reaches 65 536 states is cleared before the next one is added. Import only keys a prepared view reported
-(`correctionKey()`), so states a render here will read.
+2.10 (#447), deprecated in 2.22.0: added states another realm computed to this realm's cache. The display view keeps no
+correction states since 2.22.0, so this checks `entries` as before (an array of `{ key, gridKeys, values }` with a non-empty
+string key, an Int32Array of grid keys and a Float64Array of 3 finite values per key; otherwise an
+InvalidConfigurationError) and returns 0: nothing is stored and no render reads them. Kept until 3.0.0.
 
 ```ts
 export function bindDisplayViewCorrectionStates(entries: readonly DisplayViewCorrectionStateSet[]): number;
@@ -21,7 +17,7 @@ This call is synchronous; any supplied provider must follow its explicit synchro
 
 ## DisplayViewCorrectionStateKeys
 
-2.10 (#447): the grid keys of the states a region needs (`PreparedDisplayView.collectCorrectionStates`), ascending.
+2.10 (#447), deprecated in 2.22.0: the grid keys of the states a region needs (`PreparedDisplayView.collectCorrectionStates`).
 
 ```ts
 export interface DisplayViewCorrectionStateKeys { key: string; gridKeys: Int32Array }
@@ -29,9 +25,9 @@ export interface DisplayViewCorrectionStateKeys { key: string; gridKeys: Int32Ar
 
 ## DisplayViewCorrectionStateSet
 
-2.10 (#447): the AHD low-signal correction states of one setup, as a realm sends them to another. `key` is the setup's
-correction key (`PreparedDisplayView.correctionKey()`), `gridKeys[i]` a state's grid key and `values[3·i …]` its three
-values (28 bytes per state). Both arrays are transferable.
+2.10 (#447), deprecated in 2.22.0: the AHD low-signal correction states of one setup, as a realm sent them to another. The
+display view keeps no correction states since 2.22.0, so {@link serializeDisplayViewCorrectionStates} returns none.
+Kept until 3.0.0.
 
 ```ts
 export interface DisplayViewCorrectionStateSet { key: string; gridKeys: Int32Array; values: Float64Array }
@@ -39,9 +35,9 @@ export interface DisplayViewCorrectionStateSet { key: string; gridKeys: Int32Arr
 
 ## serializeDisplayViewCorrectionStates
 
-2.10 (#447): the AHD low-signal correction states this JavaScript realm holds (a Web Worker, a page), one entry per cached
-setup, least recently used first, each state's grid key and three values copied out. Another realm adds them with
-{@link bindDisplayViewCorrectionStates}; a render there then reads them instead of computing them, with the same bytes.
+2.10 (#447), deprecated in 2.22.0: returned the AHD low-signal correction states this realm held. The display view keeps no
+correction states since 2.22.0 (the correction was removed; docs/DISPLAY_VIEW.md, "AHD at low signal"), so this returns an
+empty array. Kept until 3.0.0.
 
 ```ts
 export function serializeDisplayViewCorrectionStates(): DisplayViewCorrectionStateSet[];

package/docs/api/facade-fast-methods.md

@@ -9,9 +9,13 @@ The package and root API versions are recorded once in [Navigation](../API_REFER
 ```ts
 SIMULATE_CAPTURE_FAST_METHODS: readonly SimulateCaptureFastMethod[] = Object.freeze([
   { id: "lens.catalogue/field-grid", override: "lens.catalogue", methods: "fast-and-exact", runs: ["simulateCapture"],
-    fast: "#568: the PSF blended over a field grid and tabulated expected electrons, verified per CFA phase against the exact chain",
+    fast: "#568: the PSF blended over a field grid, with each site's expected electrons integrated from its taps' material spectra at use, verified per CFA phase against the exact chain",
     exact: "the environment PSF quadrature with the PSF resolved at each query point", followsFormatDefault: true,
     resolver: { file: CAPTURE, call: "resolveFast(catalogueFast, fastTop)" }, report: { applied: "lens.catalogue", assumption: "fast.lens.catalogue" } },
+  { id: "lens.catalogue/field-grid-cells", override: "fast", methods: "fast-and-exact", runs: ["simulateCapture"],
+    fast: "#603: when the field-grid method runs on a fast request, at least 4 grid cells per field interval (2.20.0's grid), except for the measured lenses of CATALOGUE_FAST_GRID_FULL_ON_SCREEN, whose fallbacks made 4 cells slower",
+    exact: "at least 10 cells per field interval when the field-grid method runs on an exact request (lens.catalogue fast: true with an export or fast: false)", followsFormatDefault: true,
+    resolver: { file: CAPTURE, call: "catalogueFastGridSubdivisions(catalogue!.lensId, fastTop)" }, report: { assumption: "fast.lens.catalogue" } },
   { id: "lens.catalogue/cats-eye", override: "lens.catalogue", methods: "fast-and-exact", runs: ["simulateCapture", "simulateDisplayView", "prepareDisplayView"],
     fast: "#567: with lens.defocus, the lens's bokeh without its cat's eye (the axis kernel everywhere)",
     exact: "the cat's eye shaped at each field point (fast wides and normals)", followsFormatDefault: true,
@@ -28,10 +32,6 @@ SIMULATE_CAPTURE_FAST_METHODS: readonly SimulateCaptureFastMethod[] = Object.fre
     fast: "#588: under rolling-shutter rotation, each catalogue PSF tap reads the scene at its own source point",
     exact: "each tap reads the scene at its site-lattice point (ties on chart boundaries resolve as on the lattice)", followsFormatDefault: true,
     resolver: { file: CAPTURE, call: "resolveFast(catalogueFast, fastTop)" }, report: { applied: "lens.catalogue", assumption: "fast.lens.catalogue" } },
-  { id: "output.demosaic.ahd/view-low-signal-correction", override: "output.demosaic", methods: "fast-and-exact", runs: ["simulateDisplayView", "prepareDisplayView"],
-    fast: "(H3) 2048 draws per correction state, applied where a pixel's linear noise exceeds 0.01",
-    exact: "8192 draws per state, at the same 0.01 threshold", followsFormatDefault: true,
-    resolver: { file: CAPTURE, call: "resolveFast(demosaicFast, fastTop)" }, report: { applied: "output.demosaic.ahd", assumption: "view.demosaic" } },
   { id: "view.uniform-pixel-sampling", override: "fast", methods: "fast-and-exact", runs: ["simulateDisplayView", "prepareDisplayView"],
     fast: "(H2) a quarter of the samples per axis in display pixels whose pilot finds no detail",
     exact: "the full samples per axis in every display pixel", followsFormatDefault: true,
@@ -41,6 +41,16 @@ SIMULATE_CAPTURE_FAST_METHODS: readonly SimulateCaptureFastMethod[] = Object.fre
     exact: "gpu \"off\": the CPU reference; an explicit gpu wins", followsFormatDefault: true,
     resolver: { file: VIEW, call: "parsePrepareDisplayViewOptions(prepareOptions, (options as { fast?: unknown } | null | undefined)?.fast !== false)" },
     report: { field: "diagnostics.fast.execution" } },
+  { id: "illumination/image-plane-gpu", override: "fast", methods: "fast-and-exact", runs: ["prepareDisplayView"],
+    fast: "#597: gpu \"auto\": an image-plane print under mixed lighting on WebGPU (float32, a bounded approximation): the print's Quality passes light each lattice " +
+      "point per spectral node from the light's spectra and parts (Speed requests too, without site kernels); flagged points resolved on the host",
+    exact: "gpu \"off\": the CPU reference integrates each site from the lit radiance per spectral node in float64; an explicit gpu wins", followsFormatDefault: true,
+    resolver: { file: VIEW, call: "parsePrepareDisplayViewOptions(prepareOptions, (options as { fast?: unknown } | null | undefined)?.fast !== false)" },
+    report: { field: "diagnostics.fast.execution" } },
+  { id: "sensor.spectralStepNanometers", override: "fast", methods: "fast-and-exact", runs: ["simulateCapture", "simulateDisplayView", "prepareDisplayView"],
+    fast: "#590: the default spectral step is 20 nm under any light; under a spiky one (R(20) > 0.01) sensor.spectralSpikiness notes the possible cast",
+    exact: "5 nm under a spiky light, else 20 nm (an explicit sensor.spectralStepNanometers always wins)", followsFormatDefault: true,
+    resolver: { file: CAPTURE, call: "fastTop || !spiky" }, report: { applied: "sensor.spectralStepNanometers", assumption: "sensor.spectralSpikiness" } },
   { id: "sensor.midGrey", override: "fast", methods: "fast-and-exact", runs: ["simulateCapture", "simulateDisplayView", "prepareDisplayView"],
     fast: "#535: the mid-gray noise figure is not computed (about 0.3 ms)", exact: "result.sensor.midGrey is computed", followsFormatDefault: true,
     resolver: { file: CAPTURE, call: "fastTop ? undefined : 0" }, report: { field: "sensor.midGrey" } },
@@ -48,6 +58,25 @@ SIMULATE_CAPTURE_FAST_METHODS: readonly SimulateCaptureFastMethod[] = Object.fre
     fast: "#551: with the default count and a still camera, one temporal midpoint per site of the subject's streak plus one, when that is fewer than 8",
     exact: "the default 8 temporal midpoints (an explicit sensor.temporalSampleCount always wins)", followsFormatDefault: true,
     resolver: { file: CAPTURE, call: "resolveFast(subjectFast, fastTop)" }, report: { applied: "motion.subject", assumption: "fast.motion.subject" } },
+  { id: "dngImport.warpRectilinear", override: "fast", methods: "fast-and-exact", runs: ["developDngStageImage"],
+    fast: "#600: an imported DNG's WarpRectilinear opcode resampled bilinearly", exact: "cubic convolution (Keys, a = −0.75, the DNG SDK's kernel); default fast unless format names an export", followsFormatDefault: true,
+    resolver: { file: "src/capture/dng-stage-image.ts", call: "resolveFast(options.fast, fastFormatDefault(format, \"capture\"))" }, report: { field: "fast" } },
+  { id: "output.toneCurve/view-luminance-moments", override: "fast", methods: "fast-and-exact", runs: ["simulateDisplayView", "prepareDisplayView"],
+    fast: "#593: a luminance tone curve's moments by an 8-point Gauss–Hermite rule in luminance where its range stays clear of L = 0 (else the full rule)",
+    exact: "a composite 4 × 16-point Gauss–Legendre rule over the luminance's ±8.5σ, split at L = 0", followsFormatDefault: true,
+    resolver: { file: CAPTURE, call: "rendering: fastTop" }, report: { assumption: "view.rendering" } },
+  { id: "output.highlightMode.reconstruct/view-moments", override: "fast", methods: "fast-and-exact", runs: ["simulateDisplayView", "prepareDisplayView"],
+    fast: "#593, #601: where the reconstruct blend or the desaturation is within reach, the development chain integrated with 6 Gauss–Hermite points per axis (216 nodes)",
+    exact: "16 points per axis (4,096 nodes)", followsFormatDefault: true,
+    resolver: { file: CAPTURE, call: "rendering: fastTop" }, report: { assumption: "view.rendering" } },
+  { id: "prepareDisplayView.gpu/view-coupled-moments", override: "fast", methods: "fast-and-exact", runs: ["prepareDisplayView"],
+    fast: "#593, #601: the WebGPU Speed and Quality kernels' coupled steps with the fast rules (8-point Gauss–Hermite in luminance; 6 points per axis for the chain), float32 within the a-priori bound",
+    exact: "the same kernels with the full rules (4 × 16 Gauss–Legendre; 16 points per axis), fast: false with an explicit gpu", followsFormatDefault: true,
+    resolver: { file: "src/gpu/wgsl-display-view-coupled.ts", call: "out[C.fast] = r.fast ? 1 : 0" }, report: { assumption: "view.rendering" } },
+  { id: "output.highlightMode.reconstruct-neighbors/region-ratios", override: "fast", methods: "fast-and-exact", runs: ["simulateCapture", "simulateDisplayView", "prepareDisplayView"],
+    fast: "#602: each clipped region takes the mean color ratios of the unclipped pixels within 2 pixels of it; #605: on the WebGPU display view too (the host's ratios, the rebuild in float32 within the a-priori bound)",
+    exact: "the ratios' harmonic (Laplace) interpolation inward from the region's unclipped neighbors (successive over-relaxation), on the CPU and the WebGPU display view alike", followsFormatDefault: true,
+    resolver: { file: CAPTURE, call: "const neighborFast = fastTop" }, report: { assumption: "output.highlightMode.reconstructNeighbors" } },
   { id: "lens.diffraction", override: "lens.diffraction", methods: "exact-only", runs: ["simulateCapture", "simulateDisplayView", "prepareDisplayView"],
     fast: "", exact: "the diffraction kernels (a fast method only under rolling-shutter rotation, above)", followsFormatDefault: true,
     resolver: { file: CAPTURE, call: "resolveFast(diffractionFast, fastTop)" }, report: { applied: "lens.diffraction" } },
@@ -57,9 +86,9 @@ SIMULATE_CAPTURE_FAST_METHODS: readonly SimulateCaptureFastMethod[] = Object.fre
   { id: "sensor.pixelAperture.box", override: "sensor.pixelAperture", methods: "exact-only", runs: ["simulateCapture", "simulateDisplayView", "prepareDisplayView"],
     fast: "", exact: "the N × N midpoint rule", followsFormatDefault: true,
     resolver: { file: CAPTURE, call: "fastInUse" }, report: { applied: "sensor.pixelAperture.box" } },
-  { id: "output.demosaic.ahd", override: "output.demosaic", methods: "exact-only", runs: ["simulateCapture"],
-    fast: "", exact: "the AHD demosaic of the capture (a fast method only in the display view's correction, above)", followsFormatDefault: true,
-    resolver: { file: CAPTURE, call: "resolveFast(demosaicFast, fastTop)" }, report: { applied: "output.demosaic.ahd" } }
+  { id: "output.demosaic.ahd", override: "output.demosaic", methods: "exact-only", runs: ["simulateCapture", "simulateDisplayView", "prepareDisplayView"],
+    fast: "", exact: "the AHD demosaic of the capture; in the display view, AHD's two linear candidates and its choice on the noise-free mosaic (2.22.0: no low-signal correction, so no fast method)", followsFormatDefault: true,
+    resolver: { file: CAPTURE, call: "[\"output.demosaic.ahd\", ahd, demosaicFast]" }, report: { applied: "output.demosaic.ahd" } }
 ] as const satisfies readonly SimulateCaptureFastMethod[])
 ```
 
@@ -79,7 +108,7 @@ export interface SimulateCaptureFastMethod {
   /** "fast-and-exact": both methods exist; "exact-only": the record takes `fast`, but there is no fast method yet (reports false). */
   methods: "fast-and-exact" | "exact-only";
   /** Where it applies. */
-  runs: readonly ("simulateCapture" | "simulateDisplayView" | "prepareDisplayView")[];
+  runs: readonly ("simulateCapture" | "simulateDisplayView" | "prepareDisplayView" | "developDngStageImage")[];
   /** The fast method and the exact one, in words (empty for exact-only). */
   fast: string;
   exact: string;

package/docs/api/facade-quality-paths.md

@@ -0,0 +1,24 @@
+# facade/quality-paths.ts public contracts
+
+The package and root API versions are recorded once in [Navigation](../API_REFERENCE.md) · [Developer guide](https://github.com/Photivra/photivra/blob/main/docs/DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+
+## prepareQualityPaths
+
+Loads the engine's on-demand full-quality code now instead of at the first request that needs it (#594): the CPU Quality kit
+(diffraction, the capture's AHD demosaic, `lens.defocus` beyond the geometric disc, the image-space provider of lens projection,
+distortion and vignetting, the display view's coupled tone, reconstruct and desaturation steps, the neighbor highlight
+reconstruction), the opt-in kit (`sensor.profile`, `illumination`, `motion.subject`) and the display view's GPU full-quality code
+(the Quality passes behind `prepareDisplayView(…, { gpu: "auto" | "require" })`), together with the GPU session it builds on.
+
+Optional: without it, the first request that needs the code loads it. Safe to call at any time and from any number of places:
+concurrent calls share one load, and a call after it loaded resolves at once and loads nothing. It changes no result. If the
+load fails (for example a chunk download error) the promise rejects with `ImageKernelExecutionError` reason
+`quality-code-unavailable`; nothing is remembered, so a later call or request tries again, and a render in the meantime runs
+the CPU reference, labelled with that reason. A bundler that splits dynamic imports keeps this code out of the first load
+whether or not this function is imported.
+
+```ts
+export function prepareQualityPaths(): Promise<void>;
+```
+
+This call is asynchronous; byte hashing uses the caller runtime's Web Crypto.

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

@@ -187,7 +187,7 @@ export interface PlanarSceneRadianceProvider {
    * radiance per node and, for the direct path, Σ_n A_c(λ_n)·L(λ_n) integrated from each pixel's reconstructed spectrum
    * (`ResolvedImagePlaneScene.pixelSignals`, the surround's reflectance times the neutral signal outside the print).
    */
-  imageSignalScene?(wavelengths: readonly number[], perNode: readonly Float64Array[]): ImagePlaneSignalScene;
+  imageSignalScene?(wavelengths: readonly number[], perNode: readonly Float64Array[]): ImagePlaneSignalScene | ImagePlaneLitScene;
 }
 ```