@photivra/engine 1.4.0 → 2.0.0

package/dist/capture/native-raw-dng.js

@@ -0,0 +1,167 @@
+// SPDX-License-Identifier: Apache-2.0
+// This product includes DNG technology under license by Adobe.
+/**
+ * Writes a packed native RAW (`NativeRawOutput`, from the native RAW or native environment RAW tasks) as a
+ * lossless, uncompressed 16-bit DNG with a CFA (colour filter array) mosaic.
+ *
+ * The file describes only what the packed RAW, the caller's declared colour profile and noise model
+ * contain. It never claims a linear float master as its source, or a developed image. The tag layout reuses
+ * the TIFF/DNG writers of the paired photographic export (`packExportTiff`, DNG 1.4 tags, Adobe DNG
+ * Specification 1.7.1.0):
+ *
+ * - CFA geometry: CFARepeatPatternDim 2×2, CFAPattern and BlackLevel phases relative to the ActiveArea
+ *   origin (DNG applies them to the stage-2, ActiveArea-cropped image); DefaultCropOrigin/Size are the
+ *   capture's oriented output crop mapped back to stored (native) coordinates; Orientation from the capture.
+ * - Levels: BlackLevel per 2×2 phase (the packed per-site black levels must repeat with the CFA tile).
+ *   WhiteLevel is the smallest per-phase effective white code, so no channel is reported as unsaturated
+ *   above its own saturation point. DNG cannot represent a saturation flag on a site whose code is below
+ *   WhiteLevel; such sites are counted in `unrepresentedSaturationFlagCount`.
+ * - Colour: ColorMatrix1 = (camera→XYZ)⁻¹ with CalibrationIlluminant1 D65 (21), ForwardMatrix1 =
+ *   Bradford(D65→D50)·M·diag(w), AnalogBalance 1, AsShotNeutral from the capture's white-balance intent
+ *   (the same operator native development uses), BaselineExposure as declared (default 0).
+ * - Noise: NoiseProfile (51041) per CFA plane, var(x) = S·x + O for x = (code − black)/(WhiteLevel − black),
+ *   S = 1/(G·span), O = (σ_read²/G² + 1/12)/span², written only when the caller supplies each channel's
+ *   output-referred conversion gain G (electrons per code) and read noise σ_read (electrons). The model
+ *   covers only Poisson photo and dark shot noise, Gaussian read noise and uniform quantization. It is an
+ *   approximation: PRNU (photo-response non-uniformity), DSNU (dark-signal non-uniformity) and other
+ *   fixed-pattern noise are not included.
+ * @see docs/NATIVE_RAW_AND_PRINT.md for the tag table, limits and the round trip through parseDngRawImage.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { requireAllowlistedRecord } from "../core/record-validation.js";
+import { ENGINE_API_VERSION } from "../core/version.js";
+import { resolveCaptureColorModel } from "../color/capture-color.js";
+import { invertSensorColorMatrix, prepareSensorColorDevelopment, sensorColorReferenceWhite } from "../color/sensor-color-development.js";
+import { ICC_D50_WHITE_XYZ } from "../color/srgb-icc.js";
+import { chromaticAdaptationMatrix } from "../color/chromatic-adaptation.js";
+import { transformOrientedRasterRectToNative } from "../output/capture-geometry.js";
+import { checkNativeRawIntegrity, validatePackedNativeRaw } from "./native-raw-development.js";
+import { parseExportSensorColorProfile } from "./photographic-export.js";
+import { packExportTiff, exportTiffAscii as ascii, exportTiffNumbers as numbers, exportTiffRationals as rationals, exportTiffBytes as rawBytes, exportTiffDoubles as doubles } from "./export-tiff.js";
+export const NATIVE_RAW_DNG_SCHEMA_VERSION = "1.0.0";
+function fail(message) { throw new InvalidConfigurationError("Native RAW DNG: " + message); }
+async function sha256(bytes) {
+    const subtle = globalThis.crypto?.subtle;
+    if (!subtle)
+        fail("needs crypto.subtle (a secure browser context or Node 22+).");
+    return Array.from(new Uint8Array(await subtle.digest("SHA-256", bytes)), (b) => b.toString(16).padStart(2, "0")).join("");
+}
+/** Values exactly as stored by a RATIONAL/SRATIONAL tag (numerator / denominator), so reported metadata equals what a reader decodes. */
+function stored(tag) {
+    const view = new DataView(tag.data.buffer, tag.data.byteOffset, tag.data.byteLength);
+    return Array.from({ length: tag.count }, (_, i) => (tag.type === 10 ? view.getInt32(i * 8, true) : view.getUint32(i * 8, true)) / view.getUint32(i * 8 + 4, true));
+}
+const ORIENTATION = { landscape: 1, "portrait-clockwise": 6, "landscape-inverted": 3, "portrait-counter-clockwise": 8 };
+/**
+ * Writes packed native RAW codes as a lossless, uncompressed CFA DNG. The module notes list every tag and
+ * where its value comes from. The input arrays are copied before the first await.
+ */
+export async function serializeNativeRawDng(input) {
+    const r = requireAllowlistedRecord(input, ["raw", "colorProfile", "noise", "baselineExposureEv", "capturedAtUtc"], "Invalid native RAW DNG input.");
+    const raw = r.raw, plan = validatePackedNativeRaw(raw);
+    const mosaic = plan.frame.colorSamplingProfile.layout;
+    if (mosaic.kind === "periodic-mosaic")
+        checkNativeRawIntegrity(raw, plan.exposure.geometry.nativeRaster.pixelWidth, mosaic.repeatWidthSites, mosaic.repeatHeightSites, 0, plan.exposure.geometry.nativeRaster.pixelHeight);
+    const color = parseExportSensorColorProfile(r.colorProfile), frame = plan.frame, layout = frame.colorSamplingProfile.layout;
+    if (layout.kind !== "periodic-mosaic" || layout.repeatWidthSites !== 2 || layout.repeatHeightSites !== 2 ||
+        [...layout.siteChannelIds].sort().join() !== "blue,green,green,red" || color.channelIds.join() !== "red,green,blue")
+        fail("supports 2×2 RGB Bayer CFAs with red, green, blue colour-profile channels only.");
+    if (color.colorSamplingProfileId !== frame.colorSamplingProfile.profileId)
+        fail("colour profile is not bound to the RAW's CFA.");
+    const baseline = r.baselineExposureEv === undefined ? 0 : r.baselineExposureEv;
+    if (typeof baseline !== "number" || !Number.isFinite(baseline) || Math.abs(baseline) > 16)
+        fail("baselineExposureEv must be finite within ±16.");
+    const capturedAtUtc = r.capturedAtUtc;
+    if (capturedAtUtc !== undefined && (typeof capturedAtUtc !== "string" || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{3}Z$/.test(capturedAtUtc) || Number.isNaN(Date.parse(capturedAtUtc))))
+        fail("capturedAtUtc must be YYYY-MM-DDTHH:mm:ss.sssZ.");
+    const native = plan.exposure.geometry.nativeRaster, width = native.pixelWidth, height = native.pixelHeight, g = plan.exposure.resolvedGeometry;
+    const active = g.activeCapture.nativeRect;
+    const crop = transformOrientedRasterRectToNative({ rect: g.output.cropRect, nativeRaster: g.activeCapture.raster, orientation: plan.exposure.geometry.orientation });
+    // Copy before any await: the caller keeps ownership of the packed arrays.
+    const codes = raw.codes.slice(), blacks = raw.blackLevels.slice(), flags = raw.saturationFlags.slice(), whiteByPhase = Array.from(raw.effectiveSaturationCodes);
+    // Levels per CFA phase, relative to the active area. The black-level tile must repeat exactly.
+    const blackLevels = [], cfaPattern = [], whites = [], phaseChannel = [];
+    for (let py = 0; py < 2; py++)
+        for (let px = 0; px < 2; px++) {
+            const ax = (active.x + px) % 2, ay = (active.y + py) % 2;
+            const black = blacks[ay * width + ax];
+            for (let y = ay; y < height; y += 2)
+                for (let x = ax; x < width; x += 2)
+                    if (blacks[y * width + x] !== black)
+                        fail("per-site black levels do not repeat with the 2×2 CFA tile.");
+            const channel = layout.siteChannelIds[ay * 2 + ax];
+            blackLevels.push(black);
+            whites.push(whiteByPhase[ay * 2 + ax]);
+            phaseChannel.push(channel);
+            cfaPattern.push(["red", "green", "blue"].indexOf(channel));
+        }
+    const whiteLevel = Math.min(...whites);
+    if (blackLevels.some((b) => b >= whiteLevel))
+        fail("black level must be below the effective WhiteLevel.");
+    let unrepresented = 0;
+    for (let i = 0; i < codes.length; i++)
+        if (flags[i] !== 0 && codes[i] < whiteLevel)
+            unrepresented++;
+    // NoiseProfile: one (S, O) pair per CFA plane colour, only when every phase of a channel shares its black level.
+    let noiseProfile = null;
+    if (r.noise !== undefined) {
+        const noise = requireAllowlistedRecord(r.noise, ["red", "green", "blue"], "Invalid native RAW DNG noise.");
+        noiseProfile = [];
+        for (const channel of ["red", "green", "blue"]) {
+            const n = noise[channel];
+            if (!n)
+                fail("noise needs red, green and blue entries.");
+            requireAllowlistedRecord(n, ["conversionGainElectronsPerCode", "readNoiseRmsElectrons"], "Invalid native RAW DNG channel noise.");
+            const gain = n.conversionGainElectronsPerCode, read = n.readNoiseRmsElectrons;
+            if (typeof gain !== "number" || !Number.isFinite(gain) || gain <= 0 || typeof read !== "number" || !Number.isFinite(read) || read < 0)
+                fail("noise gain must be positive and read noise non-negative.");
+            const phaseBlacks = blackLevels.filter((_, i) => phaseChannel[i] === channel);
+            if (phaseBlacks.some((b) => b !== phaseBlacks[0])) {
+                noiseProfile = null;
+                break;
+            }
+            const span = whiteLevel - phaseBlacks[0];
+            noiseProfile.push(1 / (gain * span), (read * read / (gain * gain) + 1 / 12) / (span * span));
+        }
+    }
+    // Colour tags from the declared profile and the capture's white-balance intent.
+    const m = color.normalizedCameraChannelsToXyz, colorMatrix = invertSensorColorMatrix(m), intent = plan.exposure.whiteBalanceIntent;
+    const development = prepareSensorColorDevelopment(m, intent ? [intent.channelGains.red, intent.channelGains.green, intent.channelGains.blue] : null);
+    const cameraWhite = sensorColorReferenceWhite(colorMatrix);
+    const chad = chromaticAdaptationMatrix({ transform: "bradford", sourceWhiteXyz: resolveCaptureColorModel().referenceWhiteXyz,
+        destinationWhiteXyz: { x: ICC_D50_WHITE_XYZ[0], y: 1, z: ICC_D50_WHITE_XYZ[2] } }).matrix;
+    const forward = chad.map((row) => [0, 1, 2].map((j) => row.reduce((sum, x, k) => sum + x * m[k][j] * cameraWhite[j], 0)));
+    const pixels = new Uint8Array(codes.length * 2), view = new DataView(pixels.buffer);
+    codes.forEach((c, i) => view.setUint16(i * 2, c, true));
+    const header = new TextEncoder().encode(JSON.stringify({ schema: "photivra-native-raw-data-id-0.1", width, height, cfa: layout.siteChannelIds, containerBitDepth: 16 }));
+    const idInput = new Uint8Array(header.length + pixels.length);
+    idInput.set(header);
+    idInput.set(pixels, header.length);
+    const rawDataUniqueId = (await sha256(idInput)).slice(0, 32);
+    const colorHash = (await sha256(new TextEncoder().encode(JSON.stringify(color)))).slice(0, 16);
+    const uniqueCameraModel = "Photivra Virtual Camera " + color.profileId + " " + color.profileVersion + " " + colorHash;
+    const orientation = ORIENTATION[plan.exposure.geometry.orientation];
+    const e = plan.exposure.exposure, software = "Photivra " + ENGINE_API_VERSION;
+    const description = "Simulated capture: packed native RAW from the Photivra engine (" + frame.frameId + "). Source " + plan.exposure.source.kind +
+        "; no linear master image or developed rendering is stored.";
+    const exif = [rawBytes(36864, 7, new TextEncoder().encode("0232")), rationals(33434, false, [e.shutterSeconds]), rationals(33437, false, [e.aperture]),
+        ...(Number.isInteger(e.iso) && e.iso >= 1 && e.iso <= 65535 ? [numbers(34855, 3, [e.iso]), numbers(34864, 3, [2]), numbers(34866, 4, [e.iso])] : []),
+        rationals(37386, false, [e.focalLengthMm]), numbers(40961, 3, [65535]), numbers(40962, 4, [crop.width]), numbers(40963, 4, [crop.height]),
+        ...(capturedAtUtc === undefined ? [] : [ascii(36867, capturedAtUtc.slice(0, 19).replaceAll("-", ":").replace("T", " ")), ascii(36881, "+00:00"), ascii(37521, capturedAtUtc.slice(20, 23))])];
+    const colorMatrixTag = rationals(50721, true, colorMatrix.flat()), neutralTag = rationals(50728, false, [...development.asShotNeutral]);
+    const bytes = packExportTiff([ascii(270, description), ascii(271, "Photivra"), ascii(272, "Photivra Virtual Camera"), ascii(305, software), numbers(274, 3, [orientation]),
+        numbers(254, 4, [0]), numbers(256, 4, [width]), numbers(257, 4, [height]), numbers(258, 3, [16]), numbers(259, 3, [1]), numbers(262, 3, [32803]),
+        { ...numbers(273, 4, [0]), pointer: "pixels" }, numbers(277, 3, [1]), numbers(278, 4, [height]), numbers(279, 4, [pixels.length]),
+        numbers(284, 3, [1]), numbers(339, 3, [1]), numbers(33421, 3, [2, 2]), numbers(33422, 1, cfaPattern),
+        numbers(50706, 1, [1, 4, 0, 0]), numbers(50707, 1, [1, 1, 0, 0]), ascii(50708, uniqueCameraModel), numbers(50710, 1, [0, 1, 2]), numbers(50711, 3, [1]),
+        numbers(50713, 3, [2, 2]), rationals(50714, false, blackLevels), numbers(50717, 4, [whiteLevel]), numbers(50719, 4, [crop.x, crop.y]), numbers(50720, 4, [crop.width, crop.height]),
+        colorMatrixTag, rationals(50727, false, [1, 1, 1]), neutralTag,
+        rationals(50730, true, [baseline]), numbers(50778, 3, [21]),
+        rawBytes(50781, 1, Uint8Array.from(rawDataUniqueId.match(/../g).map((s) => parseInt(s, 16)))),
+        numbers(50829, 4, [active.y, active.x, active.y + active.height, active.x + active.width]),
+        rationals(50964, true, forward.flat()), ...(noiseProfile ? [doubles(51041, noiseProfile)] : [])], exif, pixels);
+    return Object.freeze({ schemaVersion: NATIVE_RAW_DNG_SCHEMA_VERSION, mediaType: "image/dng", bytes, sha256: await sha256(bytes), rawDataUniqueId, uniqueCameraModel,
+        activeArea: { ...active }, defaultCrop: { ...crop }, orientation, blackLevels, whiteLevel, cfaPattern, colorMatrix1: stored(colorMatrixTag), asShotNeutral: stored(neutralTag),
+        noiseProfile, unrepresentedSaturationFlagCount: unrepresented, source: "packed-native-raw", linearMasterDeclared: false });
+}
+//# sourceMappingURL=native-raw-dng.js.map

package/dist/capture/native-raw-dng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-raw-dng.js","sourceRoot":"","sources":["../../src/capture/native-raw-dng.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n// This product includes DNG technology under license by Adobe.\n\n/**\n * Writes a packed native RAW (`NativeRawOutput`, from the native RAW or native environment RAW tasks) as a\n * lossless, uncompressed 16-bit DNG with a CFA (colour filter array) mosaic.\n *\n * The file describes only what the packed RAW, the caller's declared colour profile and noise model\n * contain. It never claims a linear float master as its source, or a developed image. The tag layout reuses\n * the TIFF/DNG writers of the paired photographic export (`packExportTiff`, DNG 1.4 tags, Adobe DNG\n * Specification 1.7.1.0):\n *\n * - CFA geometry: CFARepeatPatternDim 2×2, CFAPattern and BlackLevel phases relative to the ActiveArea\n *   origin (DNG applies them to the stage-2, ActiveArea-cropped image); DefaultCropOrigin/Size are the\n *   capture's oriented output crop mapped back to stored (native) coordinates; Orientation from the capture.\n * - Levels: BlackLevel per 2×2 phase (the packed per-site black levels must repeat with the CFA tile).\n *   WhiteLevel is the smallest per-phase effective white code, so no channel is reported as unsaturated\n *   above its own saturation point. DNG cannot represent a saturation flag on a site whose code is below\n *   WhiteLevel; such sites are counted in `unrepresentedSaturationFlagCount`.\n * - Colour: ColorMatrix1 = (camera→XYZ)⁻¹ with CalibrationIlluminant1 D65 (21), ForwardMatrix1 =\n *   Bradford(D65→D50)·M·diag(w), AnalogBalance 1, AsShotNeutral from the capture's white-balance intent\n *   (the same operator native development uses), BaselineExposure as declared (default 0).\n * - Noise: NoiseProfile (51041) per CFA plane, var(x) = S·x + O for x = (code − black)/(WhiteLevel − black),\n *   S = 1/(G·span), O = (σ_read²/G² + 1/12)/span², written only when the caller supplies each channel's\n *   output-referred conversion gain G (electrons per code) and read noise σ_read (electrons). The model\n *   covers only Poisson photo and dark shot noise, Gaussian read noise and uniform quantization. It is an\n *   approximation: PRNU (photo-response non-uniformity), DSNU (dark-signal non-uniformity) and other\n *   fixed-pattern noise are not included.\n * @see docs/NATIVE_RAW_AND_PRINT.md for the tag table, limits and the round trip through parseDngRawImage.\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { requireAllowlistedRecord } from \"../core/record-validation.js\";\nimport { ENGINE_API_VERSION } from \"../core/version.js\";\nimport { resolveCaptureColorModel } from \"../color/capture-color.js\";\nimport { invertSensorColorMatrix, prepareSensorColorDevelopment, sensorColorReferenceWhite } from \"../color/sensor-color-development.js\";\nimport { ICC_D50_WHITE_XYZ } from \"../color/srgb-icc.js\";\nimport { chromaticAdaptationMatrix } from \"../color/chromatic-adaptation.js\";\nimport { transformOrientedRasterRectToNative } from \"../output/capture-geometry.js\";\nimport type { NativeRawOutput } from \"./native-raw.js\";\nimport { checkNativeRawIntegrity, validatePackedNativeRaw } from \"./native-raw-development.js\";\nimport { parseExportSensorColorProfile, type ExportSensorColorProfile } from \"./photographic-export.js\";\nimport { packExportTiff, exportTiffAscii as ascii, exportTiffNumbers as numbers, exportTiffRationals as rationals,\n  exportTiffBytes as rawBytes, exportTiffDoubles as doubles } from \"./export-tiff.js\";\n\nexport const NATIVE_RAW_DNG_SCHEMA_VERSION = \"1.0.0\" as const;\n\n/** Output-referred noise parameters of one CFA channel (see the module notes). */\nexport interface NativeRawDngChannelNoise {\n  /** Electrons per output RAW code (system conversion gain divided by any post-ADC digital gain). */\n  conversionGainElectronsPerCode: number;\n  /** Combined RMS read noise, electrons. */\n  readNoiseRmsElectrons: number;\n}\nexport interface SerializeNativeRawDngInput {\n  /** Packed native RAW. It is read, never taken over or modified. */\n  raw: NativeRawOutput;\n  /** Declared camera→XYZ (D65) colour profile for the RAW's CFA. Native development uses the same profile. */\n  colorProfile: ExportSensorColorProfile;\n  /** Optional NoiseProfile parameters by channel ID. If omitted, no NoiseProfile tag is written. */\n  noise?: Readonly<Record<string, NativeRawDngChannelNoise>>;\n  /** BaselineExposure in EV (exposure value stops). Default 0: the RAW white level maps to display white, as in native development. */\n  baselineExposureEv?: number;\n  /** Optional UTC time of the capture, exactly YYYY-MM-DDTHH:mm:ss.sssZ. If omitted, no date tags are written; the engine never makes up a clock time. */\n  capturedAtUtc?: string;\n}\nexport interface NativeRawDng {\n  schemaVersion: typeof NATIVE_RAW_DNG_SCHEMA_VERSION;\n  mediaType: \"image/dng\";\n  bytes: Uint8Array;\n  sha256: string;\n  /** RawDataUniqueID (32 hex digits): the first 128 bits of SHA-256 over a fixed header and the little-endian codes. */\n  rawDataUniqueId: string;\n  uniqueCameraModel: string;\n  /** Stored geometry, levels and colour values exactly as written (rationals as numerator/denominator). */\n  activeArea: { x: number; y: number; width: number; height: number };\n  defaultCrop: { x: number; y: number; width: number; height: number };\n  orientation: number;\n  blackLevels: readonly number[];\n  whiteLevel: number;\n  cfaPattern: readonly number[];\n  colorMatrix1: readonly number[];\n  asShotNeutral: readonly number[];\n  noiseProfile: readonly number[] | null;\n  /** Sites flagged saturated whose code is below WhiteLevel; DNG has no field for them. */\n  unrepresentedSaturationFlagCount: number;\n  source: \"packed-native-raw\";\n  linearMasterDeclared: false;\n}\n\nfunction fail(message: string): never { throw new InvalidConfigurationError(\"Native RAW DNG: \" + message); }\nasync function sha256(bytes: Uint8Array): Promise<string> {\n  const subtle = globalThis.crypto?.subtle;\n  if (!subtle) fail(\"needs crypto.subtle (a secure browser context or Node 22+).\");\n  return Array.from(new Uint8Array(await subtle.digest(\"SHA-256\", bytes as Uint8Array<ArrayBuffer>)), (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n/** Values exactly as stored by a RATIONAL/SRATIONAL tag (numerator / denominator), so reported metadata equals what a reader decodes. */\nfunction stored(tag: ReturnType<typeof rationals>): number[] {\n  const view = new DataView(tag.data.buffer, tag.data.byteOffset, tag.data.byteLength);\n  return Array.from({ length: tag.count }, (_, i) => (tag.type === 10 ? view.getInt32(i * 8, true) : view.getUint32(i * 8, true)) / view.getUint32(i * 8 + 4, true));\n}\nconst ORIENTATION = { landscape: 1, \"portrait-clockwise\": 6, \"landscape-inverted\": 3, \"portrait-counter-clockwise\": 8 } as const;\n\n/**\n * Writes packed native RAW codes as a lossless, uncompressed CFA DNG. The module notes list every tag and\n * where its value comes from. The input arrays are copied before the first await.\n */\nexport async function serializeNativeRawDng(input: SerializeNativeRawDngInput): Promise<NativeRawDng> {\n  const r = requireAllowlistedRecord(input, [\"raw\", \"colorProfile\", \"noise\", \"baselineExposureEv\", \"capturedAtUtc\"], \"Invalid native RAW DNG input.\");\n  const raw = r.raw as NativeRawOutput, plan = validatePackedNativeRaw(raw);\n  const mosaic = plan.frame.colorSamplingProfile.layout;\n  if (mosaic.kind === \"periodic-mosaic\") checkNativeRawIntegrity(raw, plan.exposure.geometry.nativeRaster.pixelWidth, mosaic.repeatWidthSites, mosaic.repeatHeightSites, 0, plan.exposure.geometry.nativeRaster.pixelHeight);\n  const color = parseExportSensorColorProfile(r.colorProfile), frame = plan.frame, layout = frame.colorSamplingProfile.layout;\n  if (layout.kind !== \"periodic-mosaic\" || layout.repeatWidthSites !== 2 || layout.repeatHeightSites !== 2 ||\n    [...layout.siteChannelIds].sort().join() !== \"blue,green,green,red\" || color.channelIds.join() !== \"red,green,blue\")\n    fail(\"supports 2×2 RGB Bayer CFAs with red, green, blue colour-profile channels only.\");\n  if (color.colorSamplingProfileId !== frame.colorSamplingProfile.profileId) fail(\"colour profile is not bound to the RAW's CFA.\");\n  const baseline = r.baselineExposureEv === undefined ? 0 : r.baselineExposureEv;\n  if (typeof baseline !== \"number\" || !Number.isFinite(baseline) || Math.abs(baseline) > 16) fail(\"baselineExposureEv must be finite within ±16.\");\n  const capturedAtUtc = r.capturedAtUtc as string | undefined;\n  if (capturedAtUtc !== undefined && (typeof capturedAtUtc !== \"string\" || !/^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d\\.\\d{3}Z$/.test(capturedAtUtc) || Number.isNaN(Date.parse(capturedAtUtc))))\n    fail(\"capturedAtUtc must be YYYY-MM-DDTHH:mm:ss.sssZ.\");\n\n  const native = plan.exposure.geometry.nativeRaster, width = native.pixelWidth, height = native.pixelHeight, g = plan.exposure.resolvedGeometry;\n  const active = g.activeCapture.nativeRect;\n  const crop = transformOrientedRasterRectToNative({ rect: g.output.cropRect, nativeRaster: g.activeCapture.raster, orientation: plan.exposure.geometry.orientation });\n  // Copy before any await: the caller keeps ownership of the packed arrays.\n  const codes = raw.codes.slice(), blacks = raw.blackLevels.slice(), flags = raw.saturationFlags.slice(), whiteByPhase = Array.from(raw.effectiveSaturationCodes);\n\n  // Levels per CFA phase, relative to the active area. The black-level tile must repeat exactly.\n  const blackLevels: number[] = [], cfaPattern: number[] = [], whites: number[] = [], phaseChannel: string[] = [];\n  for (let py = 0; py < 2; py++) for (let px = 0; px < 2; px++) {\n    const ax = (active.x + px) % 2, ay = (active.y + py) % 2;\n    const black = blacks[ay * width + ax]!;\n    for (let y = ay; y < height; y += 2) for (let x = ax; x < width; x += 2) if (blacks[y * width + x] !== black) fail(\"per-site black levels do not repeat with the 2×2 CFA tile.\");\n    const channel = layout.siteChannelIds[ay * 2 + ax]!;\n    blackLevels.push(black); whites.push(whiteByPhase[ay * 2 + ax]!); phaseChannel.push(channel); cfaPattern.push([\"red\", \"green\", \"blue\"].indexOf(channel));\n  }\n  const whiteLevel = Math.min(...whites);\n  if (blackLevels.some((b) => b >= whiteLevel)) fail(\"black level must be below the effective WhiteLevel.\");\n  let unrepresented = 0;\n  for (let i = 0; i < codes.length; i++) if (flags[i] !== 0 && codes[i]! < whiteLevel) unrepresented++;\n\n  // NoiseProfile: one (S, O) pair per CFA plane colour, only when every phase of a channel shares its black level.\n  let noiseProfile: number[] | null = null;\n  if (r.noise !== undefined) {\n    const noise = requireAllowlistedRecord(r.noise, [\"red\", \"green\", \"blue\"], \"Invalid native RAW DNG noise.\") as Record<string, NativeRawDngChannelNoise>;\n    noiseProfile = [];\n    for (const channel of [\"red\", \"green\", \"blue\"]) {\n      const n = noise[channel];\n      if (!n) fail(\"noise needs red, green and blue entries.\");\n      requireAllowlistedRecord(n, [\"conversionGainElectronsPerCode\", \"readNoiseRmsElectrons\"], \"Invalid native RAW DNG channel noise.\");\n      const gain = n.conversionGainElectronsPerCode, read = n.readNoiseRmsElectrons;\n      if (typeof gain !== \"number\" || !Number.isFinite(gain) || gain <= 0 || typeof read !== \"number\" || !Number.isFinite(read) || read < 0) fail(\"noise gain must be positive and read noise non-negative.\");\n      const phaseBlacks = blackLevels.filter((_, i) => phaseChannel[i] === channel);\n      if (phaseBlacks.some((b) => b !== phaseBlacks[0])) { noiseProfile = null; break; }\n      const span = whiteLevel - phaseBlacks[0]!;\n      noiseProfile.push(1 / (gain * span), (read * read / (gain * gain) + 1 / 12) / (span * span));\n    }\n  }\n\n  // Colour tags from the declared profile and the capture's white-balance intent.\n  const m = color.normalizedCameraChannelsToXyz, colorMatrix = invertSensorColorMatrix(m), intent = plan.exposure.whiteBalanceIntent;\n  const development = prepareSensorColorDevelopment(m, intent ? [intent.channelGains.red, intent.channelGains.green, intent.channelGains.blue] : null);\n  const cameraWhite = sensorColorReferenceWhite(colorMatrix);\n  const chad = chromaticAdaptationMatrix({ transform: \"bradford\", sourceWhiteXyz: resolveCaptureColorModel().referenceWhiteXyz,\n    destinationWhiteXyz: { x: ICC_D50_WHITE_XYZ[0], y: 1, z: ICC_D50_WHITE_XYZ[2] } }).matrix;\n  const forward = chad.map((row) => [0, 1, 2].map((j) => row.reduce((sum, x, k) => sum + x * m[k]![j]! * cameraWhite[j]!, 0)));\n\n  const pixels = new Uint8Array(codes.length * 2), view = new DataView(pixels.buffer);\n  codes.forEach((c, i) => view.setUint16(i * 2, c, true));\n  const header = new TextEncoder().encode(JSON.stringify({ schema: \"photivra-native-raw-data-id-0.1\", width, height, cfa: layout.siteChannelIds, containerBitDepth: 16 }));\n  const idInput = new Uint8Array(header.length + pixels.length); idInput.set(header); idInput.set(pixels, header.length);\n  const rawDataUniqueId = (await sha256(idInput)).slice(0, 32);\n  const colorHash = (await sha256(new TextEncoder().encode(JSON.stringify(color)))).slice(0, 16);\n  const uniqueCameraModel = \"Photivra Virtual Camera \" + color.profileId + \" \" + color.profileVersion + \" \" + colorHash;\n  const orientation = ORIENTATION[plan.exposure.geometry.orientation];\n  const e = plan.exposure.exposure, software = \"Photivra \" + ENGINE_API_VERSION;\n  const description = \"Simulated capture: packed native RAW from the Photivra engine (\" + frame.frameId + \"). Source \" + plan.exposure.source.kind +\n    \"; no linear master image or developed rendering is stored.\";\n\n  const exif = [rawBytes(36864, 7, new TextEncoder().encode(\"0232\")), rationals(33434, false, [e.shutterSeconds]), rationals(33437, false, [e.aperture]),\n    ...(Number.isInteger(e.iso) && e.iso >= 1 && e.iso <= 65535 ? [numbers(34855, 3, [e.iso]), numbers(34864, 3, [2]), numbers(34866, 4, [e.iso])] : []),\n    rationals(37386, false, [e.focalLengthMm]), numbers(40961, 3, [65535]), numbers(40962, 4, [crop.width]), numbers(40963, 4, [crop.height]),\n    ...(capturedAtUtc === undefined ? [] : [ascii(36867, capturedAtUtc.slice(0, 19).replaceAll(\"-\", \":\").replace(\"T\", \" \")), ascii(36881, \"+00:00\"), ascii(37521, capturedAtUtc.slice(20, 23))])];\n  const colorMatrixTag = rationals(50721, true, colorMatrix.flat()), neutralTag = rationals(50728, false, [...development.asShotNeutral]);\n  const bytes = packExportTiff([ascii(270, description), ascii(271, \"Photivra\"), ascii(272, \"Photivra Virtual Camera\"), ascii(305, software), numbers(274, 3, [orientation]),\n    numbers(254, 4, [0]), numbers(256, 4, [width]), numbers(257, 4, [height]), numbers(258, 3, [16]), numbers(259, 3, [1]), numbers(262, 3, [32803]),\n    { ...numbers(273, 4, [0]), pointer: \"pixels\" as const }, numbers(277, 3, [1]), numbers(278, 4, [height]), numbers(279, 4, [pixels.length]),\n    numbers(284, 3, [1]), numbers(339, 3, [1]), numbers(33421, 3, [2, 2]), numbers(33422, 1, cfaPattern),\n    numbers(50706, 1, [1, 4, 0, 0]), numbers(50707, 1, [1, 1, 0, 0]), ascii(50708, uniqueCameraModel), numbers(50710, 1, [0, 1, 2]), numbers(50711, 3, [1]),\n    numbers(50713, 3, [2, 2]), rationals(50714, false, blackLevels), numbers(50717, 4, [whiteLevel]), numbers(50719, 4, [crop.x, crop.y]), numbers(50720, 4, [crop.width, crop.height]),\n    colorMatrixTag, rationals(50727, false, [1, 1, 1]), neutralTag,\n    rationals(50730, true, [baseline]), numbers(50778, 3, [21]),\n    rawBytes(50781, 1, Uint8Array.from(rawDataUniqueId.match(/../g)!.map((s) => parseInt(s, 16)))),\n    numbers(50829, 4, [active.y, active.x, active.y + active.height, active.x + active.width]),\n    rationals(50964, true, forward.flat()), ...(noiseProfile ? [doubles(51041, noiseProfile)] : [])], exif, pixels);\n  return Object.freeze({ schemaVersion: NATIVE_RAW_DNG_SCHEMA_VERSION, mediaType: \"image/dng\" as const, bytes, sha256: await sha256(bytes), rawDataUniqueId, uniqueCameraModel,\n    activeArea: { ...active }, defaultCrop: { ...crop }, orientation, blackLevels, whiteLevel, cfaPattern, colorMatrix1: stored(colorMatrixTag), asShotNeutral: stored(neutralTag),\n    noiseProfile, unrepresentedSaturationFlagCount: unrepresented, source: \"packed-native-raw\" as const, linearMasterDeclared: false as const });\n}\n"]}

package/dist/capture/native-raw.d.ts

@@ -1,6 +1,11 @@
-/** Metadata-only admission and bounded execution of the existing native scalar RAW model. */
+/**
+ * Native RAW capture with the existing per-site (scalar) RAW model: an up-front plan and limit check from
+ * metadata only, then bounded tile-by-tile execution.
+ */
 import { type SimulatedCaptureInput, type SimulatedCapture, type CaptureExposureSource } from "./simulated-capture.js";
-import { type NativeRawProducerFrameContext, type SensorRawProducerSiteInput, type SensorRawProducerExposureWindowInput } from "./sensor-raw-producer.js";
+import { type HostYieldCadence, type HostYieldGate } from "./host-yield-cadence.js";
+import { calculateCaptureExposureWindows } from "../sensor/exposure-window.js";
+import { calculateNativeRawSite, type NativeRawProducerFrameContext, type SensorRawProducerSiteInput, type SensorRawProducerExposureWindowInput } from "./sensor-raw-producer.js";
 export declare const NATIVE_RAW_SCHEMA_VERSION: "0.1.0";
 export declare const NATIVE_RAW_LIMITS: Readonly<{
     maximumPixels: 24000000;
@@ -9,7 +14,7 @@ export declare const NATIVE_RAW_LIMITS: Readonly<{
     tileHeight: 1;
     outputBytesPerPixel: 7;
 }>;
-/** A shooting event and source provenance, not a produced float master or committed RAW frame. */
+/** A shooting event and where its source came from. Not a finished float master or committed RAW frame. */
 export type NativeRawExposureInput = Omit<SimulatedCaptureInput, "planes" | "source"> & {
     source: CaptureExposureSource;
 };
@@ -25,6 +30,8 @@ export interface NativeRawInput {
     bindingProfile: NativeRawProducerFrameContext["bindingProfile"];
     exposureWindow?: SensorRawProducerExposureWindowInput;
     maximumOutputBytes: number;
+    /** Optional tile width for execution, in native sites, 1–256. Default 256. It does not affect sampling. */
+    tileWidth?: number;
 }
 export interface NativeRawPlan {
     schemaVersion: typeof NATIVE_RAW_SCHEMA_VERSION;
@@ -34,10 +41,12 @@ export interface NativeRawPlan {
     pixelCount: number;
     outputBytes: number;
     tileCount: number;
+    /** Present only when an execution tile width was given. Otherwise the plan keeps its earlier shape. */
+    tileWidth?: number;
     upstreamRadiometryVerified: false;
-    seedSchedule: "capture-seed-plus-two-native-index-modulo-2-to-32-v1";
+    seedSchedule: "murmur3-capture-seed-native-index-stream-v2";
 }
-/** Rectangle is absolute full-native CFA space, before orientation, active crop or output scaling. */
+/** Tile rectangle, in absolute full-sensor CFA coordinates, before orientation, active-area crop or output scaling. */
 export interface NativeRawTileRequest {
     captureId: string;
     frameId: string;
@@ -53,14 +62,40 @@ export interface NativeRawProvider {
     readTile(request: Readonly<NativeRawTileRequest>, signal: AbortSignal): Promise<NativeRawTile>;
     yieldControl(signal: AbortSignal): Promise<void>;
 }
-/** Sole-owner row-major arrays. They are not attachable to the bounded SensorRawFrame contract. */
+/** Row-major arrays owned only by the output. They cannot be attached to the bounded SensorRawFrame type. */
 export interface NativeRawOutput {
     plan: NativeRawPlan;
     codes: Uint16Array;
     blackLevels: Uint16Array;
     digitalSaturationCodes: Uint16Array;
-    /** Bits 0,1,2: physical scalar clamp, pre-ADC clamp, digital saturation respectively. */
+    /** Saturation flags. Bit 0: physical charge clamp; bit 1: pre-ADC clamp; bit 2: digital saturation. */
     saturationFlags: Uint8Array;
+    /**
+     * Effective white (full-saturation) code for each absolute CFA repeat phase, indexed
+     * `phaseY*repeatWidthSites+phaseX`: min(digital saturation, round(black + min(capacity, pre-ADC
+     * saturation)/gain)). See `calculateEffectiveSaturationCode`. A few bytes, not one value per pixel.
+     */
+    effectiveSaturationCodes: Uint16Array;
+}
+/** Internal: lean per-site outputs of an engine-built site (see native-environment-lean.ts). */
+export interface NativeRawLeanOutput {
+    rawCode: number;
+    blackLevelCode: number;
+    digitalSaturationCode: number;
+    flags: number;
+    whiteCode: number;
+}
+/**
+ * Internal hook for tiles the engine builds itself (native environment RAW).
+ *
+ * claim() recognizes only entries the hook itself created, for sites whose parsing and identity checks are
+ * provably redundant. compute() returns the outputs calculateNativeRawSite would produce, falling back to it
+ * internally. observe() sees every fully computed site.
+ */
+export interface NativeRawLeanSensorHook {
+    claim(site: unknown): object | undefined;
+    compute(handle: object, index: number, seed: number, timing: ReturnType<typeof calculateCaptureExposureWindows>["value"]["samples"][number] | undefined): NativeRawLeanOutput;
+    observe(index: number, parsed: SensorRawProducerSiteInput, result: ReturnType<typeof calculateNativeRawSite>, whiteCode: number, seed: number): void;
 }
 export type NativeRawTaskState = "ready" | "running" | "completed" | "cancelled" | "failed" | "disposed" | "transferred";
 export interface NativeRawTask {
@@ -72,8 +107,30 @@ export interface NativeRawTask {
     dispose(): void;
     takeOutput(): NativeRawOutput;
 }
-/** Full raster/resource/profile admission before callbacks or output allocation; no placeholder plane. */
+/** Plans the task and checks the image size, resources and profiles before any callback or output allocation. No placeholder plane is made. */
 export declare function calculateNativeRawPlan(input: NativeRawInput): NativeRawPlan;
-/** Executes validated EQE/dark/completeness events through the shared reference scalar physics. */
+/**
+ * Runs validated per-site events (EQE photo signal, dark signal, charge completeness) through the shared
+ * reference per-site physics.
+ *
+ * Tiles are read and committed one at a time. The task yields to the host at tile boundaries once about
+ * 8 ms of work has passed since the last yield, and after the final tile. It checks for cancellation
+ * before every tile, after every read and after every yield.
+ */
 export declare function createNativeRawTask(input: NativeRawInput, provider: NativeRawProvider): NativeRawTask;
-//# sourceMappingURL=native-raw.d.ts.map
+/** Internal: the same task with an explicit host-yield timing. Timing never changes tiles, seeds or output. Not exported from the package. */
+export declare function createNativeRawTaskWithCadence(input: NativeRawInput, provider: NativeRawProvider, cadence: HostYieldCadence, 
+/** Internal: a yield timer shared with a provider that also yields inside readTile, so both use one time budget. */
+sharedGate?: HostYieldGate, 
+/** Internal: faster ("lean") per-site sensor execution for engine-built tiles. It never changes output or errors. */
+leanSensor?: NativeRawLeanSensorHook, 
+/**
+ * Internal: run only native rows [y, y + height) (a partition). The output arrays then hold just those rows, and
+ * effectiveSaturationCodes holds 0 for CFA phases the rows do not contain; the merge step completes them.
+ * Seeds, tiles and per-site values are those of the whole-frame task.
+ */
+rows?: {
+    readonly y: number;
+    readonly height: number;
+    readonly firstSite?: (site: SensorRawProducerSiteInput) => void;
+}): NativeRawTask;

package/dist/capture/native-raw.js

@@ -1,10 +1,15 @@
 // SPDX-License-Identifier: Apache-2.0
-/** Metadata-only admission and bounded execution of the existing native scalar RAW model. */
+/**
+ * Native RAW capture with the existing per-site (scalar) RAW model: an up-front plan and limit check from
+ * metadata only, then bounded tile-by-tile execution.
+ */
 import { normalizeCaptureExposureMetadata } from "./simulated-capture.js";
 import { ENGINE_API_VERSION } from "../core/version.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { requireAllowlistedRecord, requirePublicOpaqueId } from "../core/record-validation.js";
 import { freezeOwnedData } from "../core/owned-data.js";
+import { calculateSiteEffectiveSaturationCode, createPhaseWhiteLevelAccumulator } from "./raw-white-level.js";
+import { DEFAULT_HOST_YIELD_CADENCE, createHostYieldGate } from "./host-yield-cadence.js";
 import { parseCaptureModeProfile } from "../sensor/capture-mode.js";
 import { parseSensorColorSamplingProfile } from "../sensor/color-sampling.js";
 import { parseNativeEffectiveRasterColorSamplingBindingProfile, resolveCaptureModeColorSamplingContributors } from "../sensor/capture-color-sampling-binding.js";
@@ -28,9 +33,12 @@ function windows(exposure, schedule, points) {
         throw new InvalidConfigurationError("RAW schedule differs from exposure duration.");
     return result.value;
 }
-/** Full raster/resource/profile admission before callbacks or output allocation; no placeholder plane. */
+/** Plans the task and checks the image size, resources and profiles before any callback or output allocation. No placeholder plane is made. */
 export function calculateNativeRawPlan(input) {
-    const r = requireAllowlistedRecord(input, ["exposure", "frameId", "modeId", "captureModeProfile", "colorSamplingProfile", "bindingProfile", "exposureWindow", "maximumOutputBytes"], "Invalid native RAW input.");
+    const r = requireAllowlistedRecord(input, ["exposure", "frameId", "modeId", "captureModeProfile", "colorSamplingProfile", "bindingProfile", "exposureWindow", "maximumOutputBytes", "tileWidth"], "Invalid native RAW input.");
+    if (r.tileWidth !== undefined && (typeof r.tileWidth !== "number" || !Number.isSafeInteger(r.tileWidth) || r.tileWidth < 1 || r.tileWidth > NATIVE_RAW_LIMITS.tileWidth))
+        throw new InvalidConfigurationError("Native RAW tile width must be an integer from 1 to 256.");
+    const tileWidth = r.tileWidth ?? NATIVE_RAW_LIMITS.tileWidth;
     const exposure = normalizeCaptureExposureMetadata(r.exposure, ENGINE_API_VERSION, true), native = exposure.geometry.nativeRaster;
     const pixelCount = native.pixelWidth * native.pixelHeight, outputBytes = pixelCount * NATIVE_RAW_LIMITS.outputBytesPerPixel;
     if (pixelCount > NATIVE_RAW_LIMITS.maximumPixels || native.pixelWidth > NATIVE_RAW_LIMITS.maximumDimension || native.pixelHeight > NATIVE_RAW_LIMITS.maximumDimension ||
@@ -44,34 +52,58 @@ export function calculateNativeRawPlan(input) {
     if (exposure.noise.model.id !== SENSOR_RAW_PRODUCER_NOISE_MODEL.id || exposure.noise.model.version !== SENSOR_RAW_PRODUCER_NOISE_MODEL.version ||
         frame.colorSamplingProfile.layout.kind !== "periodic-mosaic" || mode?.acquisition.kind !== "single-frame" || mode.perFrameSampling.kind !== "native-effective-raster" || (mode.reconstructionStages?.length ?? 0) !== 0)
         throw new InvalidConfigurationError("Native RAW requires exact noise identity and single-frame native periodic CFA.");
-    // Binding is global and affine; validate both corners before any provider work.
+    // The binding is one affine mapping for the whole frame, so checking both corners covers it. Do this before any provider work.
     for (const p of [{ x: 0, y: 0 }, { x: native.pixelWidth - 1, y: native.pixelHeight - 1 }]) {
         const c = resolveCaptureModeColorSamplingContributors({ nativeRaster: native, captureModeProfile: frame.captureModeProfile, modeId: frame.modeId, colorSamplingProfile: frame.colorSamplingProfile, bindingProfile: frame.bindingProfile, modeSampleIndexFullFrame: p });
         if (c.totalContributorSites !== 1 || c.channelComposition.kind !== "single-channel")
             throw new InvalidConfigurationError("Native RAW must preserve one native CFA site per sample.");
     }
     const schedule = r.exposureWindow === undefined ? undefined : structuredClone(r.exposureWindow);
-    // Supported linear scan extrema occur at raster corners. Check them before acquisition.
+    // For the supported linear scans, the extreme values occur at the image corners. Check them before capture.
     if (schedule)
         windows(exposure, schedule, [{ x: .5, y: .5 }, { x: native.pixelWidth - .5, y: .5 }, { x: .5, y: native.pixelHeight - .5 }, { x: native.pixelWidth - .5, y: native.pixelHeight - .5 }]);
     return freezeOwnedData({ schemaVersion: NATIVE_RAW_SCHEMA_VERSION, exposure, frame, pixelCount, outputBytes,
-        tileCount: Math.ceil(native.pixelWidth / NATIVE_RAW_LIMITS.tileWidth) * native.pixelHeight,
+        tileCount: Math.ceil(native.pixelWidth / tileWidth) * native.pixelHeight,
+        ...(r.tileWidth === undefined ? {} : { tileWidth }),
         ...(schedule ? { exposureWindow: schedule } : {}), upstreamRadiometryVerified: false,
-        seedSchedule: "capture-seed-plus-two-native-index-modulo-2-to-32-v1" });
+        seedSchedule: "murmur3-capture-seed-native-index-stream-v2" });
 }
-/** Executes validated EQE/dark/completeness events through the shared reference scalar physics. */
+/**
+ * Runs validated per-site events (EQE photo signal, dark signal, charge completeness) through the shared
+ * reference per-site physics.
+ *
+ * Tiles are read and committed one at a time. The task yields to the host at tile boundaries once about
+ * 8 ms of work has passed since the last yield, and after the final tile. It checks for cancellation
+ * before every tile, after every read and after every yield.
+ */
 export function createNativeRawTask(input, provider) {
+    return createNativeRawTaskWithCadence(input, provider, DEFAULT_HOST_YIELD_CADENCE);
+}
+/** Internal: the same task with an explicit host-yield timing. Timing never changes tiles, seeds or output. Not exported from the package. */
+export function createNativeRawTaskWithCadence(input, provider, cadence, 
+/** Internal: a yield timer shared with a provider that also yields inside readTile, so both use one time budget. */
+sharedGate, 
+/** Internal: faster ("lean") per-site sensor execution for engine-built tiles. It never changes output or errors. */
+leanSensor, 
+/**
+ * Internal: run only native rows [y, y + height) (a partition). The output arrays then hold just those rows, and
+ * effectiveSaturationCodes holds 0 for CFA phases the rows do not contain; the merge step completes them.
+ * Seeds, tiles and per-site values are those of the whole-frame task.
+ */
+rows) {
     const plan = calculateNativeRawPlan(input);
     if (!provider || typeof provider.readTile !== "function" || typeof provider.yieldControl !== "function")
         throw new InvalidConfigurationError("Native RAW requires reader and host event-loop yield.");
     const read = provider.readTile.bind(provider), yieldControl = provider.yieldControl.bind(provider), abort = new AbortController();
-    const native = plan.exposure.geometry.nativeRaster;
+    const native = plan.exposure.geometry.nativeRaster, tileWidth = plan.tileWidth ?? NATIVE_RAW_LIMITS.tileWidth;
+    const rowStart = rows?.y ?? 0, rowEnd = rowStart + (rows?.height ?? native.pixelHeight), offset = rowStart * native.pixelWidth, length = (rowEnd - rowStart) * native.pixelWidth;
     let state = "ready", count = 0, output = null, first;
     function release() { if (output) {
         output.codes.fill(0);
         output.blackLevels.fill(0);
         output.digitalSaturationCodes.fill(0);
         output.saturationFlags.fill(0);
+        output.effectiveSaturationCodes.fill(0);
     } output = null; first = undefined; }
     function active() { if (abort.signal.aborted)
         throw new InvalidConfigurationError("Native RAW execution aborted."); }
@@ -81,11 +113,17 @@ export function createNativeRawTask(input, provider) {
                 throw new InvalidConfigurationError("Native RAW task is single-use.");
             state = "running";
             try {
-                output = { plan, codes: new Uint16Array(plan.pixelCount), blackLevels: new Uint16Array(plan.pixelCount), digitalSaturationCodes: new Uint16Array(plan.pixelCount), saturationFlags: new Uint8Array(plan.pixelCount) };
-                for (let y = 0; y < native.pixelHeight; y++)
-                    for (let x = 0; x < native.pixelWidth; x += NATIVE_RAW_LIMITS.tileWidth) {
+                const gate = sharedGate ?? createHostYieldGate(cadence);
+                sharedGate?.restart();
+                const layout = plan.frame.colorSamplingProfile.layout;
+                if (layout.kind !== "periodic-mosaic")
+                    throw new InvalidConfigurationError("Native RAW requires periodic CFA.");
+                const white = createPhaseWhiteLevelAccumulator(native.pixelWidth, layout.repeatWidthSites, layout.repeatHeightSites);
+                output = { plan, codes: new Uint16Array(length), blackLevels: new Uint16Array(length), digitalSaturationCodes: new Uint16Array(length), saturationFlags: new Uint8Array(length), effectiveSaturationCodes: new Uint16Array(layout.repeatWidthSites * layout.repeatHeightSites) };
+                for (let y = rowStart; y < rowEnd; y++)
+                    for (let x = 0; x < native.pixelWidth; x += tileWidth) {
                         active();
-                        const request = Object.freeze({ captureId: plan.exposure.captureId, frameId: plan.frame.frameId, x, y, width: Math.min(NATIVE_RAW_LIMITS.tileWidth, native.pixelWidth - x), height: 1 });
+                        const request = Object.freeze({ captureId: plan.exposure.captureId, frameId: plan.frame.frameId, x, y, width: Math.min(tileWidth, native.pixelWidth - x), height: 1 });
                         {
                             const supplied = await read(request, abort.signal);
                             active();
@@ -96,23 +134,51 @@ export function createNativeRawTask(input, provider) {
                             if (!Array.isArray(tile.sites) || tile.sites.length !== request.width || Array.from({ length: request.width }, (_, i) => i in tile.sites).includes(false))
                                 throw new InvalidConfigurationError("Native RAW tile needs exact dense coverage.");
                             const timing = plan.exposureWindow ? windows(plan.exposure, plan.exposureWindow, Array.from({ length: request.width }, (_, i) => ({ x: x + i + .5, y: y + .5 }))) : undefined;
-                            const sites = tile.sites.map((site, j) => parseNativeRawProducerSite(site, y * native.pixelWidth + x + j, plan.frame, timing?.samples[j]));
-                            first ??= sites[0];
+                            // Lean entries (built by the engine, provably valid against an earlier verified template) skip parsing and
+                            // identity checks. They are only claimed once the frame's first site is fixed.
+                            const lean = leanSensor && first !== undefined ? tile.sites.map(site => leanSensor.claim(site)) : undefined;
+                            const sites = tile.sites.map((site, j) => lean?.[j] ? undefined : parseNativeRawProducerSite(site, y * native.pixelWidth + x + j, plan.frame, timing?.samples[j]));
+                            if (first === undefined) {
+                                first = sites[0];
+                                if (first)
+                                    rows?.firstSite?.(first);
+                            }
                             for (const s of sites)
-                                validateNativeRawReadoutIdentity(s, first);
-                            // Every site in this tile is validated before writing owned output. Failures never publish partial output.
+                                if (s)
+                                    validateNativeRawReadoutIdentity(s, first);
+                            // Every site in this tile is validated before any output is written. A failure never returns partial output.
+                            const seed = plan.exposure.noise.seedUint32;
                             for (let j = 0; j < sites.length; j++) {
-                                const index = y * native.pixelWidth + x + j, r = calculateNativeRawSite(sites[j], plan.exposure.noise.seedUint32, index).readout.value;
-                                output.codes[index] = r.rawCode;
-                                output.blackLevels[index] = r.blackLevelCode;
-                                output.digitalSaturationCodes[index] = r.digitalSaturationCode;
-                                output.saturationFlags[index] = Number(r.physicalScalarSaturationApplied) | Number(r.preAdcSaturationApplied) << 1 | Number(r.digitalSaturationApplied) << 2;
+                                // index: absolute native index (seeds, CFA phase); at: position in this task's output arrays.
+                                const index = y * native.pixelWidth + x + j, at = index - offset, handle = lean?.[j];
+                                if (handle) {
+                                    const o = leanSensor.compute(handle, index, seed, timing?.samples[j]);
+                                    output.codes[at] = o.rawCode;
+                                    output.blackLevels[at] = o.blackLevelCode;
+                                    output.digitalSaturationCodes[at] = o.digitalSaturationCode;
+                                    output.saturationFlags[at] = o.flags;
+                                    white.record(index, o.whiteCode);
+                                    continue;
+                                }
+                                const result = calculateNativeRawSite(sites[j], seed, index), r = result.readout.value;
+                                output.codes[at] = r.rawCode;
+                                output.blackLevels[at] = r.blackLevelCode;
+                                output.digitalSaturationCodes[at] = r.digitalSaturationCode;
+                                output.saturationFlags[at] = Number(r.physicalScalarSaturationApplied) | Number(r.preAdcSaturationApplied) << 1 | Number(r.digitalSaturationApplied) << 2;
+                                const whiteCode = calculateSiteEffectiveSaturationCode(r, sites[j].readoutProfile, sites[j].regimeId);
+                                white.record(index, whiteCode);
+                                leanSensor?.observe(index, sites[j], result, whiteCode, seed);
                             }
                             count++;
                         }
-                        await yieldControl(abort.signal);
-                        active();
+                        // Yield when the time budget is spent, and always after the final tile. Yield timing never changes output.
+                        if (gate.due() || (y === rowEnd - 1 && x + tileWidth >= native.pixelWidth)) {
+                            await yieldControl(abort.signal);
+                            active();
+                            gate.restart();
+                        }
                     }
+                output.effectiveSaturationCodes.set(rows ? white.partial() : white.finish());
                 first = undefined;
                 state = "completed";
             }