@photivra/engine 2.20.0 → 2.21.0

package/dist/capture/native-environment-tabulated.js

@@ -7,6 +7,7 @@ import { admitNativeEnvironmentInput } from "./native-environment-raw.js";
 import { composeNativeEnvironmentSensorSite } from "./native-environment-optical-stage.js";
 import { calculateNativeRawSite, parseNativeRawProducerSite } from "./sensor-raw-producer.js";
 import { calculateSiteEffectiveSaturationCode, createPhaseWhiteLevelAccumulator } from "./raw-white-level.js";
+import { EXPOSURE_BUILD_UP_STAGES } from "./exposure-build-up-stage.js";
 import { createVerifiedNativeSiteReadout } from "./native-environment-lean.js";
 /** Largest relative difference between a verification site's tabulated and chain electrons: rounding only (a few ulps of each term). */
 export const TABULATED_RELATIVE_TOLERANCE = 1e-9;
@@ -51,7 +52,7 @@ export async function renderTabulatedNativeRaw(t) {
     const region = t.region ?? { x: 0, y: 0, width: W, height: native.pixelHeight };
     if (region.width < 2 || region.height < 2)
         return undefined;
-    const seed = plan.exposure.noise.seedUint32, schedule = plan.exposureWindow, memo = createEnvironmentRawFrameCanonicalMemo(plan.frame, schedule);
+    const seed = plan.exposure.noise.seedUint32, b = EXPOSURE_BUILD_UP_STAGES.get(t.input.raw), schedule = plan.exposureWindow, memo = createEnvironmentRawFrameCanonicalMemo(plan.frame, schedule);
     let evaluations = 0;
     const evaluate = (request) => { evaluations++; return t.evaluateRadiance(request); };
     // The counting wrapper returns the evaluator's own results, so they are engine-built exactly when the evaluator is.
@@ -70,9 +71,9 @@ export async function renderTabulatedNativeRaw(t) {
             testHook.fullPhoto(photoResult, executeEnvironmentSensorPhotoSignal(full, t.evaluateRadiance, undefined, "photo-only").value.photo);
         const timing = calculateCaptureExposureWindows({ ...schedule, nativeRaster: native, samplePointsNative: [{ x: x + 0.5, y: y + 0.5 }] }).value.samples[0];
         const parsed = parseNativeRawProducerSite(composeNativeEnvironmentSensorSite(site, photo), index, plan.frame, timing);
-        const result = calculateNativeRawSite(parsed, seed, index);
+        const result = calculateNativeRawSite(parsed, seed, index, b);
         const whiteCode = calculateSiteEffectiveSaturationCode(result.readout.value, parsed.readoutProfile, parsed.regimeId);
-        const readout = createVerifiedNativeSiteReadout(parsed, result, whiteCode, photo, x, y, index, seed);
+        const readout = createVerifiedNativeSiteReadout(parsed, result, whiteCode, photo, x, y, index, seed, b);
         if (!readout)
             return undefined;
         t.electrons.window(x, y, x + 1, y + 1);

package/dist/capture/native-environment-tabulated.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-environment-tabulated.js","sourceRoot":"","sources":["../../src/capture/native-environment-tabulated.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Internal (#394 step 2, not exported from the package): the native RAW of an engine-built planar scene (a chart preset or a\n * caller material scene, still camera, rectilinear, no distortion, vignetting, pupil rays or caller PSF) from tabulated\n * expected electrons instead of the per-site environment chain.\n *\n * Each site's expected photo electrons come from the display view's tabulated expected signal (`createDisplayViewExpectedSignal`):\n * the same sum over pixel-aperture nodes, anti-aliasing spots, diffraction taps and spectral nodes as the environment chain,\n * formed in another order, so the value differs from the chain's only in the last bits. The sensor stage is the native one:\n * dark charge, both Poisson draws, read noise and the ADC with the site's own seeds (`createVerifiedNativeSiteReadout`). A\n * site whose expected electrons differ in the last bit can therefore, rarely, draw a different integer; the statistics are\n * unchanged.\n *\n * Verification at run time: one site of each CFA phase runs the full chain (planning, the evaluator's callbacks, composition,\n * parsing and `calculateNativeRawSite`). Its readout template must reproduce that site bit for bit, and its tabulated\n * electrons must agree with the chain's within `TABULATED_RELATIVE_TOLERANCE`; otherwise the caller runs the environment task.\n * #453: the chain's photo signal comes from `executeEngineOwnedEnvironmentPhotoSignal`, the same operations and values as\n * `executeEnvironmentSensorPhotoSignal` for these engine-built records, without re-validating records that cannot have changed.\n */\n\nimport type { EnvironmentRadianceEvaluator } from \"../sensor/environment-photo-signal.js\";\nimport { executeEngineOwnedEnvironmentPhotoSignal, executeEnvironmentSensorPhotoSignal } from \"../sensor/environment-photo-signal.js\";\nimport { isInternalSceneRadianceEvaluator } from \"../core/internal-radiance-evaluator.js\";\nimport { calculateCaptureExposureWindows, prepareCaptureExposureWindowSampler } from \"../sensor/exposure-window.js\";\nimport { createEnvironmentRawFrameCanonicalMemo, planEnvironmentRawSite, type SimulateEnvironmentSensorRawFrameInput } from \"./environment-raw-producer.js\";\nimport { admitNativeEnvironmentInput, type NativeEnvironmentRawInput } from \"./native-environment-raw.js\";\nimport { composeNativeEnvironmentSensorSite } from \"./native-environment-optical-stage.js\";\nimport { calculateNativeRawSite, parseNativeRawProducerSite } from \"./sensor-raw-producer.js\";\nimport { calculateSiteEffectiveSaturationCode, createPhaseWhiteLevelAccumulator } from \"./raw-white-level.js\";\nimport { createVerifiedNativeSiteReadout, type NativeSiteReadout } from \"./native-environment-lean.js\";\nimport type { NativeRawOutput } from \"./native-raw.js\";\n\n/** Largest relative difference between a verification site's tabulated and chain electrons: rounding only (a few ulps of each term). */\nexport const TABULATED_RELATIVE_TOLERANCE = 1e-9;\n/** Rows per expected-signal cache window. */\nconst BAND_ROWS = 32;\n/** Host-yield budget in milliseconds (the native task's cadence); the task also yields after its last row. */\nconst YIELD_MS = 8;\n\n/** Internal counters (tests assert how many verification sites ran the chain per call; four, one per CFA phase). */\nexport const tabulatedVerificationStatistics = { chainExecutions: 0 };\n\n/**\n * Internal test hook (never set by the engine): `fullPhoto` also runs each verification site through\n * `executeEnvironmentSensorPhotoSignal` (with the uncounted evaluator) and hands both photo signals to the test;\n * `tabulatedElectrons` replaces the tabulated electrons the gate compares, to show that a wrong fast path is rejected.\n */\nexport interface TabulatedVerificationTestHook {\n  fullPhoto?(engineOwned: unknown, full: unknown): void;\n  tabulatedElectrons?(value: number, x: number, y: number): number;\n}\nlet testHook: TabulatedVerificationTestHook | undefined;\nexport function setTabulatedVerificationTestHook(hook: TabulatedVerificationTestHook | undefined): void { testHook = hook; }\n\nlet tabulatedDisabled = false;\n/** Disables the tabulated path process-wide (internal; tests of the environment path itself turn it off). */\nexport function setTabulatedNativeRawEnabled(enabled: boolean): void { tabulatedDisabled = !enabled; }\n\nexport interface TabulatedNativeRawInput {\n  input: NativeEnvironmentRawInput;\n  /** Native rectangle to render (region rendering); absent: the whole raster. */\n  region?: { x: number; y: number; width: number; height: number } | undefined;\n  /** The engine-built site record of a native index (the facade's `siteInput`). */\n  siteInput(index: number): SimulateEnvironmentSensorRawFrameInput[\"sites\"][number];\n  /** The evaluator the environment task would use (for the verification sites). */\n  evaluateRadiance: EnvironmentRadianceEvaluator;\n  /** Expected photo electrons of native sites (`createDisplayViewExpectedSignal`). */\n  electrons: { window(x0: number, y0: number, x1: number, y1: number): void; site(x: number, y: number): number; readonly lookups: number };\n  /** Called once per native tile-equivalent (progress), as the environment task reads its tiles. */\n  onTile?: () => void;\n  tileWidth: number;\n  /**\n   * #568: the largest relative difference the verification accepts (default `TABULATED_RELATIVE_TOLERANCE`): a fast method that\n   * approximates the chain (`lens.catalogue`'s field-grid PSF) passes its own measured bound.\n   */\n  relativeTolerance?: number;\n  yieldControl(): Promise<void>;\n  checkAbort(): void;\n}\n\nexport interface TabulatedNativeRawResult {\n  raw: NativeRawOutput;\n  /** Evaluator callbacks of the verification sites plus the tabulated signal's scene lookups. */\n  providerEvaluationCount: number;\n  /** Largest relative difference between tabulated and chain electrons over the verification sites. */\n  verificationRelativeDifference: number;\n}\n\n/**\n * #449: the local exposure duration shared by every site of `region`, or undefined when the sampler must run per site. With\n * simultaneous opening and closing boundaries both boundary phases are 0 at every point (exposure-window.ts, boundaryPhase), so\n * each site's duration is the nominal one the sampler gives at the region's first site. The sampler's only other per-point step\n * is its check that the point lies in the active capture rectangle; the region's first and last site centres bound every other\n * centre, so when both pass every site passes. When either throws, the per-site path runs (and throws where it did).\n */\nexport function simultaneousExposureDuration(schedule: { opening: unknown; closing: unknown }, sampler: (point: { x: number; y: number }) => { localExposureDurationSeconds: number },\n  region: { x: number; y: number; width: number; height: number }): number | undefined {\n  if ((schedule.opening as { kind?: unknown }).kind !== \"simultaneous\" || (schedule.closing as { kind?: unknown }).kind !== \"simultaneous\") return undefined;\n  try {\n    const first = sampler({ x: region.x + 0.5, y: region.y + 0.5 }).localExposureDurationSeconds;\n    const last = sampler({ x: region.x + region.width - 0.5, y: region.y + region.height - 0.5 }).localExposureDurationSeconds;\n    return Object.is(first, last) ? first : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Renders the native RAW from tabulated expected electrons, or returns undefined when verification fails (see the module comment). */\nexport async function renderTabulatedNativeRaw(t: TabulatedNativeRawInput): Promise<TabulatedNativeRawResult | undefined> {\n  if (tabulatedDisabled) return undefined;\n  const { plan, sceneBinding } = admitNativeEnvironmentInput(t.input);\n  const native = plan.exposure.geometry.nativeRaster, W = native.pixelWidth, layout = plan.frame.colorSamplingProfile.layout;\n  if (layout.kind !== \"periodic-mosaic\" || layout.repeatWidthSites !== 2 || layout.repeatHeightSites !== 2 || !plan.exposureWindow) return undefined;\n  const region = t.region ?? { x: 0, y: 0, width: W, height: native.pixelHeight };\n  if (region.width < 2 || region.height < 2) return undefined;\n  const seed = plan.exposure.noise.seedUint32, schedule = plan.exposureWindow, memo = createEnvironmentRawFrameCanonicalMemo(plan.frame, schedule);\n  let evaluations = 0;\n  const evaluate: EnvironmentRadianceEvaluator = (request) => { evaluations++; return t.evaluateRadiance(request); };\n  // The counting wrapper returns the evaluator's own results, so they are engine-built exactly when the evaluator is.\n  const engineBuiltResults = isInternalSceneRadianceEvaluator(t.evaluateRadiance);\n  // Verification: the region's top-left 2 × 2 block, one site per CFA phase, through the full chain.\n  const readouts: NativeSiteReadout[] = [];\n  let worst = 0;\n  for (let k = 0; k < 4; k++) {\n    const x = region.x + (k & 1), y = region.y + (k >> 1), index = y * W + x, site = t.siteInput(index);\n    const full = planEnvironmentRawSite(site, index, plan.frame, sceneBinding, schedule, \"engine-owned\", memo, \"photo-only\");\n    // #453: the chain for these engine-built site records (the same operations and values as executeEnvironmentSensorPhotoSignal,\n    // without re-validating records that have not changed; see executeEngineOwnedEnvironmentPhotoSignal).\n    const photoResult = executeEngineOwnedEnvironmentPhotoSignal(full, evaluate, engineBuiltResults), photo = photoResult.value.photoSignal;\n    tabulatedVerificationStatistics.chainExecutions++;\n    if (testHook?.fullPhoto) testHook.fullPhoto(photoResult, executeEnvironmentSensorPhotoSignal(full, t.evaluateRadiance, undefined, \"photo-only\").value.photo);\n    const timing = calculateCaptureExposureWindows({ ...schedule, nativeRaster: native, samplePointsNative: [{ x: x + 0.5, y: y + 0.5 }] }).value.samples[0];\n    const parsed = parseNativeRawProducerSite(composeNativeEnvironmentSensorSite(site, photo), index, plan.frame, timing);\n    const result = calculateNativeRawSite(parsed, seed, index);\n    const whiteCode = calculateSiteEffectiveSaturationCode(result.readout.value, parsed.readoutProfile, parsed.regimeId);\n    const readout = createVerifiedNativeSiteReadout(parsed, result, whiteCode, photo, x, y, index, seed);\n    if (!readout) return undefined;\n    t.electrons.window(x, y, x + 1, y + 1);\n    const chain = photo.expectedGeneratedElectronCount, tabulated = testHook?.tabulatedElectrons ? testHook.tabulatedElectrons(t.electrons.site(x, y), x, y) : t.electrons.site(x, y);\n    const difference = chain === tabulated ? 0 : Math.abs(tabulated - chain) / Math.max(Math.abs(chain), Number.MIN_VALUE);\n    if (!(difference <= (t.relativeTolerance ?? TABULATED_RELATIVE_TOLERANCE))) return undefined;\n    worst = Math.max(worst, difference);\n    readouts[(y & 1) * 2 + (x & 1)] = readout;\n  }\n  const length = region.width * region.height;\n  const raw: NativeRawOutput = { plan, codes: new Uint16Array(length), blackLevels: new Uint16Array(length), digitalSaturationCodes: new Uint16Array(length),\n    saturationFlags: new Uint8Array(length), effectiveSaturationCodes: new Uint16Array(4) };\n  const white = createPhaseWhiteLevelAccumulator(W, 2, 2), sampler = prepareCaptureExposureWindowSampler({ ...schedule, nativeRaster: native });\n  const tilesPerRow = Math.ceil(region.width / t.tileWidth), point = { x: 0, y: 0 };\n  const constantDuration = simultaneousExposureDuration(schedule, sampler, region);\n  let last = Date.now();\n  for (let y0 = region.y; y0 < region.y + region.height; y0 += BAND_ROWS) {\n    const y1 = Math.min(region.y + region.height, y0 + BAND_ROWS);\n    t.electrons.window(region.x, y0, region.x + region.width, y1);\n    for (let y = y0; y < y1; y++) {\n      for (let x = region.x; x < region.x + region.width; x++) {\n        const index = y * W + x, at = (y - region.y) * region.width + x - region.x;\n        let duration = constantDuration;\n        if (duration === undefined) { point.x = x + 0.5; point.y = y + 0.5; duration = sampler(point).localExposureDurationSeconds; }\n        const o = readouts[(y & 1) * 2 + (x & 1)]!.compute(t.electrons.site(x, y), duration, x, y, index, seed);\n        // A check of the full path failed for this site: let the environment task decide (it throws its own error).\n        if (!o) return undefined;\n        raw.codes[at] = o.rawCode; raw.blackLevels[at] = o.blackLevelCode; raw.digitalSaturationCodes[at] = o.digitalSaturationCode; raw.saturationFlags[at] = o.flags;\n        white.record(index, o.whiteCode);\n      }\n      for (let k = 0; k < tilesPerRow; k++) t.onTile?.();\n      if (y === region.y + region.height - 1 || Date.now() - last >= YIELD_MS) { await t.yieldControl(); t.checkAbort(); last = Date.now(); }\n    }\n  }\n  raw.effectiveSaturationCodes.set(t.region ? white.partial() : white.finish());\n  return { raw, providerEvaluationCount: evaluations + t.electrons.lookups, verificationRelativeDifference: worst };\n}\n"]}
+{"version":3,"file":"native-environment-tabulated.js","sourceRoot":"","sources":["../../src/capture/native-environment-tabulated.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Internal (#394 step 2, not exported from the package): the native RAW of an engine-built planar scene (a chart preset or a\n * caller material scene, still camera, rectilinear, no distortion, vignetting, pupil rays or caller PSF) from tabulated\n * expected electrons instead of the per-site environment chain.\n *\n * Each site's expected photo electrons come from the display view's tabulated expected signal (`createDisplayViewExpectedSignal`):\n * the same sum over pixel-aperture nodes, anti-aliasing spots, diffraction taps and spectral nodes as the environment chain,\n * formed in another order, so the value differs from the chain's only in the last bits. The sensor stage is the native one:\n * dark charge, both Poisson draws, read noise and the ADC with the site's own seeds (`createVerifiedNativeSiteReadout`). A\n * site whose expected electrons differ in the last bit can therefore, rarely, draw a different integer; the statistics are\n * unchanged.\n *\n * Verification at run time: one site of each CFA phase runs the full chain (planning, the evaluator's callbacks, composition,\n * parsing and `calculateNativeRawSite`). Its readout template must reproduce that site bit for bit, and its tabulated\n * electrons must agree with the chain's within `TABULATED_RELATIVE_TOLERANCE`; otherwise the caller runs the environment task.\n * #453: the chain's photo signal comes from `executeEngineOwnedEnvironmentPhotoSignal`, the same operations and values as\n * `executeEnvironmentSensorPhotoSignal` for these engine-built records, without re-validating records that cannot have changed.\n */\n\nimport type { EnvironmentRadianceEvaluator } from \"../sensor/environment-photo-signal.js\";\nimport { executeEngineOwnedEnvironmentPhotoSignal, executeEnvironmentSensorPhotoSignal } from \"../sensor/environment-photo-signal.js\";\nimport { isInternalSceneRadianceEvaluator } from \"../core/internal-radiance-evaluator.js\";\nimport { calculateCaptureExposureWindows, prepareCaptureExposureWindowSampler } from \"../sensor/exposure-window.js\";\nimport { createEnvironmentRawFrameCanonicalMemo, planEnvironmentRawSite, type SimulateEnvironmentSensorRawFrameInput } from \"./environment-raw-producer.js\";\nimport { admitNativeEnvironmentInput, type NativeEnvironmentRawInput } from \"./native-environment-raw.js\";\nimport { composeNativeEnvironmentSensorSite } from \"./native-environment-optical-stage.js\";\nimport { calculateNativeRawSite, parseNativeRawProducerSite } from \"./sensor-raw-producer.js\";\nimport { calculateSiteEffectiveSaturationCode, createPhaseWhiteLevelAccumulator } from \"./raw-white-level.js\";\nimport { EXPOSURE_BUILD_UP_STAGES } from \"./exposure-build-up-stage.js\";\nimport { createVerifiedNativeSiteReadout, type NativeSiteReadout } from \"./native-environment-lean.js\";\nimport type { NativeRawOutput } from \"./native-raw.js\";\n\n/** Largest relative difference between a verification site's tabulated and chain electrons: rounding only (a few ulps of each term). */\nexport const TABULATED_RELATIVE_TOLERANCE = 1e-9;\n/** Rows per expected-signal cache window. */\nconst BAND_ROWS = 32;\n/** Host-yield budget in milliseconds (the native task's cadence); the task also yields after its last row. */\nconst YIELD_MS = 8;\n\n/** Internal counters (tests assert how many verification sites ran the chain per call; four, one per CFA phase). */\nexport const tabulatedVerificationStatistics = { chainExecutions: 0 };\n\n/**\n * Internal test hook (never set by the engine): `fullPhoto` also runs each verification site through\n * `executeEnvironmentSensorPhotoSignal` (with the uncounted evaluator) and hands both photo signals to the test;\n * `tabulatedElectrons` replaces the tabulated electrons the gate compares, to show that a wrong fast path is rejected.\n */\nexport interface TabulatedVerificationTestHook {\n  fullPhoto?(engineOwned: unknown, full: unknown): void;\n  tabulatedElectrons?(value: number, x: number, y: number): number;\n}\nlet testHook: TabulatedVerificationTestHook | undefined;\nexport function setTabulatedVerificationTestHook(hook: TabulatedVerificationTestHook | undefined): void { testHook = hook; }\n\nlet tabulatedDisabled = false;\n/** Disables the tabulated path process-wide (internal; tests of the environment path itself turn it off). */\nexport function setTabulatedNativeRawEnabled(enabled: boolean): void { tabulatedDisabled = !enabled; }\n\nexport interface TabulatedNativeRawInput {\n  input: NativeEnvironmentRawInput;\n  /** Native rectangle to render (region rendering); absent: the whole raster. */\n  region?: { x: number; y: number; width: number; height: number } | undefined;\n  /** The engine-built site record of a native index (the facade's `siteInput`). */\n  siteInput(index: number): SimulateEnvironmentSensorRawFrameInput[\"sites\"][number];\n  /** The evaluator the environment task would use (for the verification sites). */\n  evaluateRadiance: EnvironmentRadianceEvaluator;\n  /** Expected photo electrons of native sites (`createDisplayViewExpectedSignal`). */\n  electrons: { window(x0: number, y0: number, x1: number, y1: number): void; site(x: number, y: number): number; readonly lookups: number };\n  /** Called once per native tile-equivalent (progress), as the environment task reads its tiles. */\n  onTile?: () => void;\n  tileWidth: number;\n  /**\n   * #568: the largest relative difference the verification accepts (default `TABULATED_RELATIVE_TOLERANCE`): a fast method that\n   * approximates the chain (`lens.catalogue`'s field-grid PSF) passes its own measured bound.\n   */\n  relativeTolerance?: number;\n  yieldControl(): Promise<void>;\n  checkAbort(): void;\n}\n\nexport interface TabulatedNativeRawResult {\n  raw: NativeRawOutput;\n  /** Evaluator callbacks of the verification sites plus the tabulated signal's scene lookups. */\n  providerEvaluationCount: number;\n  /** Largest relative difference between tabulated and chain electrons over the verification sites. */\n  verificationRelativeDifference: number;\n}\n\n/**\n * #449: the local exposure duration shared by every site of `region`, or undefined when the sampler must run per site. With\n * simultaneous opening and closing boundaries both boundary phases are 0 at every point (exposure-window.ts, boundaryPhase), so\n * each site's duration is the nominal one the sampler gives at the region's first site. The sampler's only other per-point step\n * is its check that the point lies in the active capture rectangle; the region's first and last site centres bound every other\n * centre, so when both pass every site passes. When either throws, the per-site path runs (and throws where it did).\n */\nexport function simultaneousExposureDuration(schedule: { opening: unknown; closing: unknown }, sampler: (point: { x: number; y: number }) => { localExposureDurationSeconds: number },\n  region: { x: number; y: number; width: number; height: number }): number | undefined {\n  if ((schedule.opening as { kind?: unknown }).kind !== \"simultaneous\" || (schedule.closing as { kind?: unknown }).kind !== \"simultaneous\") return undefined;\n  try {\n    const first = sampler({ x: region.x + 0.5, y: region.y + 0.5 }).localExposureDurationSeconds;\n    const last = sampler({ x: region.x + region.width - 0.5, y: region.y + region.height - 0.5 }).localExposureDurationSeconds;\n    return Object.is(first, last) ? first : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Renders the native RAW from tabulated expected electrons, or returns undefined when verification fails (see the module comment). */\nexport async function renderTabulatedNativeRaw(t: TabulatedNativeRawInput): Promise<TabulatedNativeRawResult | undefined> {\n  if (tabulatedDisabled) return undefined;\n  const { plan, sceneBinding } = admitNativeEnvironmentInput(t.input);\n  const native = plan.exposure.geometry.nativeRaster, W = native.pixelWidth, layout = plan.frame.colorSamplingProfile.layout;\n  if (layout.kind !== \"periodic-mosaic\" || layout.repeatWidthSites !== 2 || layout.repeatHeightSites !== 2 || !plan.exposureWindow) return undefined;\n  const region = t.region ?? { x: 0, y: 0, width: W, height: native.pixelHeight };\n  if (region.width < 2 || region.height < 2) return undefined;\n  const seed = plan.exposure.noise.seedUint32, b = EXPOSURE_BUILD_UP_STAGES.get(t.input.raw), schedule = plan.exposureWindow, memo = createEnvironmentRawFrameCanonicalMemo(plan.frame, schedule);\n  let evaluations = 0;\n  const evaluate: EnvironmentRadianceEvaluator = (request) => { evaluations++; return t.evaluateRadiance(request); };\n  // The counting wrapper returns the evaluator's own results, so they are engine-built exactly when the evaluator is.\n  const engineBuiltResults = isInternalSceneRadianceEvaluator(t.evaluateRadiance);\n  // Verification: the region's top-left 2 × 2 block, one site per CFA phase, through the full chain.\n  const readouts: NativeSiteReadout[] = [];\n  let worst = 0;\n  for (let k = 0; k < 4; k++) {\n    const x = region.x + (k & 1), y = region.y + (k >> 1), index = y * W + x, site = t.siteInput(index);\n    const full = planEnvironmentRawSite(site, index, plan.frame, sceneBinding, schedule, \"engine-owned\", memo, \"photo-only\");\n    // #453: the chain for these engine-built site records (the same operations and values as executeEnvironmentSensorPhotoSignal,\n    // without re-validating records that have not changed; see executeEngineOwnedEnvironmentPhotoSignal).\n    const photoResult = executeEngineOwnedEnvironmentPhotoSignal(full, evaluate, engineBuiltResults), photo = photoResult.value.photoSignal;\n    tabulatedVerificationStatistics.chainExecutions++;\n    if (testHook?.fullPhoto) testHook.fullPhoto(photoResult, executeEnvironmentSensorPhotoSignal(full, t.evaluateRadiance, undefined, \"photo-only\").value.photo);\n    const timing = calculateCaptureExposureWindows({ ...schedule, nativeRaster: native, samplePointsNative: [{ x: x + 0.5, y: y + 0.5 }] }).value.samples[0];\n    const parsed = parseNativeRawProducerSite(composeNativeEnvironmentSensorSite(site, photo), index, plan.frame, timing);\n    const result = calculateNativeRawSite(parsed, seed, index, b);\n    const whiteCode = calculateSiteEffectiveSaturationCode(result.readout.value, parsed.readoutProfile, parsed.regimeId);\n    const readout = createVerifiedNativeSiteReadout(parsed, result, whiteCode, photo, x, y, index, seed, b);\n    if (!readout) return undefined;\n    t.electrons.window(x, y, x + 1, y + 1);\n    const chain = photo.expectedGeneratedElectronCount, tabulated = testHook?.tabulatedElectrons ? testHook.tabulatedElectrons(t.electrons.site(x, y), x, y) : t.electrons.site(x, y);\n    const difference = chain === tabulated ? 0 : Math.abs(tabulated - chain) / Math.max(Math.abs(chain), Number.MIN_VALUE);\n    if (!(difference <= (t.relativeTolerance ?? TABULATED_RELATIVE_TOLERANCE))) return undefined;\n    worst = Math.max(worst, difference);\n    readouts[(y & 1) * 2 + (x & 1)] = readout;\n  }\n  const length = region.width * region.height;\n  const raw: NativeRawOutput = { plan, codes: new Uint16Array(length), blackLevels: new Uint16Array(length), digitalSaturationCodes: new Uint16Array(length),\n    saturationFlags: new Uint8Array(length), effectiveSaturationCodes: new Uint16Array(4) };\n  const white = createPhaseWhiteLevelAccumulator(W, 2, 2), sampler = prepareCaptureExposureWindowSampler({ ...schedule, nativeRaster: native });\n  const tilesPerRow = Math.ceil(region.width / t.tileWidth), point = { x: 0, y: 0 };\n  const constantDuration = simultaneousExposureDuration(schedule, sampler, region);\n  let last = Date.now();\n  for (let y0 = region.y; y0 < region.y + region.height; y0 += BAND_ROWS) {\n    const y1 = Math.min(region.y + region.height, y0 + BAND_ROWS);\n    t.electrons.window(region.x, y0, region.x + region.width, y1);\n    for (let y = y0; y < y1; y++) {\n      for (let x = region.x; x < region.x + region.width; x++) {\n        const index = y * W + x, at = (y - region.y) * region.width + x - region.x;\n        let duration = constantDuration;\n        if (duration === undefined) { point.x = x + 0.5; point.y = y + 0.5; duration = sampler(point).localExposureDurationSeconds; }\n        const o = readouts[(y & 1) * 2 + (x & 1)]!.compute(t.electrons.site(x, y), duration, x, y, index, seed);\n        // A check of the full path failed for this site: let the environment task decide (it throws its own error).\n        if (!o) return undefined;\n        raw.codes[at] = o.rawCode; raw.blackLevels[at] = o.blackLevelCode; raw.digitalSaturationCodes[at] = o.digitalSaturationCode; raw.saturationFlags[at] = o.flags;\n        white.record(index, o.whiteCode);\n      }\n      for (let k = 0; k < tilesPerRow; k++) t.onTile?.();\n      if (y === region.y + region.height - 1 || Date.now() - last >= YIELD_MS) { await t.yieldControl(); t.checkAbort(); last = Date.now(); }\n    }\n  }\n  raw.effectiveSaturationCodes.set(t.region ? white.partial() : white.finish());\n  return { raw, providerEvaluationCount: evaluations + t.electrons.lookups, verificationRelativeDifference: worst };\n}\n"]}

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

@@ -2,6 +2,7 @@
  * 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 ExposureBuildUpStage } from "./exposure-build-up-stage.js";
 import { type SimulatedCaptureInput, type SimulatedCapture, type CaptureExposureSource } from "./simulated-capture.js";
 import { type HostYieldCadence, type HostYieldGate } from "./host-yield-cadence.js";
 import { calculateCaptureExposureWindows } from "../sensor/exposure-window.js";
@@ -105,8 +106,8 @@ export interface NativeRawLeanOutput {
  */
 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;
+    compute(handle: object, index: number, seed: number, timing: ReturnType<typeof calculateCaptureExposureWindows>["value"]["samples"][number] | undefined, b?: ExposureBuildUpStage): NativeRawLeanOutput;
+    observe(index: number, parsed: SensorRawProducerSiteInput, result: ReturnType<typeof calculateNativeRawSite>, whiteCode: number, seed: number, b?: ExposureBuildUpStage): void;
 }
 export type NativeRawTaskState = "ready" | "running" | "completed" | "cancelled" | "failed" | "disposed" | "transferred";
 export interface NativeRawTask {

package/dist/capture/native-raw.js

@@ -3,6 +3,7 @@
  * 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 { EXPOSURE_BUILD_UP_STAGES } from "./exposure-build-up-stage.js";
 import { normalizeCaptureExposureMetadata } from "./simulated-capture.js";
 import { ENGINE_API_VERSION } from "../core/version.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
@@ -163,12 +164,12 @@ rows) {
                                 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;
+                            const seed = plan.exposure.noise.seedUint32, b = EXPOSURE_BUILD_UP_STAGES.get(input);
                             for (let j = 0; j < sites.length; j++) {
                                 // index: absolute native index (seeds, CFA phase); at: position in this task's output arrays.
                                 const index = y * native.pixelWidth + x + j, at = (y - rowStart) * bandWidth + x + j - colStart, handle = lean?.[j];
                                 if (handle) {
-                                    const o = leanSensor.compute(handle, index, seed, timing?.samples[j]);
+                                    const o = leanSensor.compute(handle, index, seed, timing?.samples[j], b);
                                     output.codes[at] = o.rawCode;
                                     output.blackLevels[at] = o.blackLevelCode;
                                     output.digitalSaturationCodes[at] = o.digitalSaturationCode;
@@ -176,14 +177,14 @@ rows) {
                                     white.record(index, o.whiteCode);
                                     continue;
                                 }
-                                const result = calculateNativeRawSite(sites[j], seed, index), r = result.readout.value;
+                                const result = calculateNativeRawSite(sites[j], seed, index, b), 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);
+                                leanSensor?.observe(index, sites[j], result, whiteCode, seed, b);
                             }
                             count++;
                         }

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

@@ -1 +1 @@
-{"version":3,"file":"native-raw.js","sourceRoot":"","sources":["../../src/capture/native-raw.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Native RAW capture with the existing per-site (scalar) RAW model: an up-front plan and limit check from\n * metadata only, then bounded tile-by-tile execution.\n */\nimport { normalizeCaptureExposureMetadata, type SimulatedCaptureInput, type SimulatedCapture, type CaptureExposureSource } from \"./simulated-capture.js\";\nimport { ENGINE_API_VERSION } from \"../core/version.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { requireAllowlistedRecord, requirePublicOpaqueId } from \"../core/record-validation.js\";\nimport { freezeOwnedData } from \"../core/owned-data.js\";\nimport { FULL_RESOLUTION_CEILING_PIXELS, resolveRaisedLimit, scaleBudgetCeiling } from \"../core/pixel-limits.js\";\nimport { calculateSiteEffectiveSaturationCode, createPhaseWhiteLevelAccumulator } from \"./raw-white-level.js\";\nimport { DEFAULT_HOST_YIELD_CADENCE, createHostYieldGate, type HostYieldCadence, type HostYieldGate } from \"./host-yield-cadence.js\";\nimport { parseCaptureModeProfile } from \"../sensor/capture-mode.js\";\nimport { parseSensorColorSamplingProfile } from \"../sensor/color-sampling.js\";\nimport { parseNativeEffectiveRasterColorSamplingBindingProfile, resolveCaptureModeColorSamplingContributors } from \"../sensor/capture-color-sampling-binding.js\";\nimport { calculateCaptureExposureWindows } from \"../sensor/exposure-window.js\";\nimport { SENSOR_RAW_PRODUCER_NOISE_MODEL, calculateNativeRawSite, parseNativeRawProducerSite,\n  validateNativeRawReadoutIdentity, type NativeRawProducerFrameContext, type SensorRawProducerSiteInput,\n  type SensorRawProducerExposureWindowInput } from \"./sensor-raw-producer.js\";\n\nexport const NATIVE_RAW_SCHEMA_VERSION = \"0.1.0\" as const;\n/** `maximumPixels` is the default pixel limit; a request may raise it with its own `maximumPixels`, up to `ceilingPixels`. */\nexport const NATIVE_RAW_LIMITS = /* @__PURE__ */ Object.freeze({ maximumPixels: 24_000_000, ceilingPixels: FULL_RESOLUTION_CEILING_PIXELS, maximumDimension: 16_384,\n  tileWidth: 256, tileHeight: 1, outputBytesPerPixel: 7 });\n/** Default whole-event radiance query budget ceiling of the native environment tasks; it scales with a raised `maximumPixels`. */\nconst DEFAULT_MAXIMUM_PROVIDER_EVALUATIONS = 2_000_000_000;\n/** A shooting event and where its source came from. Not a finished float master or committed RAW frame. */\nexport type NativeRawExposureInput = Omit<SimulatedCaptureInput, \"planes\" | \"source\"> & {source:CaptureExposureSource};\nexport type NativeRawExposure = Omit<SimulatedCapture, \"schemaVersion\" | \"planes\" | \"source\"> & {source:CaptureExposureSource};\nexport interface NativeRawInput {\n  exposure: NativeRawExposureInput;\n  frameId: string;\n  modeId: string;\n  captureModeProfile: NativeRawProducerFrameContext[\"captureModeProfile\"];\n  colorSamplingProfile: NativeRawProducerFrameContext[\"colorSamplingProfile\"];\n  bindingProfile: NativeRawProducerFrameContext[\"bindingProfile\"];\n  exposureWindow?: SensorRawProducerExposureWindowInput;\n  maximumOutputBytes: number;\n  /** Optional tile width for execution, in native sites, 1–256. Default 256. It does not affect sampling. */\n  tileWidth?: number;\n  /**\n   * Optional opt-in pixel limit for large sensors: an integer from 1 to `NATIVE_RAW_LIMITS.ceilingPixels`.\n   * Default `NATIVE_RAW_LIMITS.maximumPixels` (24 000 000). `maximumOutputBytes` still applies. A raised limit\n   * also raises the native environment tasks' whole-event query budget ceiling in proportion\n   * (2 000 000 000 per 24 000 000 pixels). It does not affect sampling.\n   */\n  maximumPixels?: number;\n}\nexport interface NativeRawPlan {\n  schemaVersion: typeof NATIVE_RAW_SCHEMA_VERSION;\n  exposure: NativeRawExposure;\n  frame: NativeRawProducerFrameContext;\n  exposureWindow?: SensorRawProducerExposureWindowInput;\n  pixelCount: number;\n  outputBytes: number;\n  tileCount: number;\n  /** Present only when an execution tile width was given. Otherwise the plan keeps its earlier shape. */\n  tileWidth?: number;\n  /** Present only when a pixel limit was given. Otherwise the plan keeps its earlier shape. */\n  maximumPixels?: number;\n  upstreamRadiometryVerified: false;\n  seedSchedule: \"murmur3-capture-seed-native-index-stream-v2\";\n}\n/** Tile rectangle, in absolute full-sensor CFA coordinates, before orientation, active-area crop or output scaling. */\nexport interface NativeRawTileRequest { captureId: string; frameId: string; x: number; y: number; width: number; height: number }\nexport interface NativeRawTile extends NativeRawTileRequest { sites: readonly SensorRawProducerSiteInput[] }\nexport interface NativeRawProvider {\n  readTile(request: Readonly<NativeRawTileRequest>, signal: AbortSignal): Promise<NativeRawTile>;\n  yieldControl(signal: AbortSignal): Promise<void>;\n}\n/** Row-major arrays owned only by the output. They cannot be attached to the bounded SensorRawFrame type. */\nexport interface NativeRawOutput {\n  plan: NativeRawPlan;\n  codes: Uint16Array;\n  blackLevels: Uint16Array;\n  digitalSaturationCodes: Uint16Array;\n  /** Saturation flags. Bit 0: physical charge clamp; bit 1: pre-ADC clamp; bit 2: digital saturation. */\n  saturationFlags: Uint8Array;\n  /**\n   * Effective white (full-saturation) code for each absolute CFA repeat phase, indexed\n   * `phaseY*repeatWidthSites+phaseX`: min(digital saturation, round(black + min(capacity, pre-ADC\n   * saturation)/gain)). See `calculateEffectiveSaturationCode`. A few bytes, not one value per pixel.\n   */\n  effectiveSaturationCodes: Uint16Array;\n}\n/** Internal: lean per-site outputs of an engine-built site (see native-environment-lean.ts). */\nexport interface NativeRawLeanOutput { rawCode: number; blackLevelCode: number; digitalSaturationCode: number; flags: number; whiteCode: number }\n/**\n * Internal hook for tiles the engine builds itself (native environment RAW).\n *\n * claim() recognizes only entries the hook itself created, for sites whose parsing and identity checks are\n * provably redundant. compute() returns the outputs calculateNativeRawSite would produce, falling back to it\n * internally. observe() sees every fully computed site.\n */\nexport interface NativeRawLeanSensorHook {\n  claim(site: unknown): object | undefined;\n  compute(handle: object, index: number, seed: number, timing: ReturnType<typeof calculateCaptureExposureWindows>[\"value\"][\"samples\"][number] | undefined): NativeRawLeanOutput;\n  observe(index: number, parsed: SensorRawProducerSiteInput, result: ReturnType<typeof calculateNativeRawSite>, whiteCode: number, seed: number): void;\n}\nexport type NativeRawTaskState = \"ready\" | \"running\" | \"completed\" | \"cancelled\" | \"failed\" | \"disposed\" | \"transferred\";\nexport interface NativeRawTask {\n  readonly plan: NativeRawPlan;\n  readonly state: NativeRawTaskState;\n  readonly completedTileCount: number;\n  run(): Promise<void>;\n  cancel(): void;\n  dispose(): void;\n  takeOutput(): NativeRawOutput;\n}\nfunction windows(exposure: NativeRawExposure, schedule: SensorRawProducerExposureWindowInput,\n  points: readonly {x:number;y:number}[]): ReturnType<typeof calculateCaptureExposureWindows>[\"value\"] {\n  const r=requireAllowlistedRecord(schedule,[\"shutterMechanism\",\"nominalExposureDurationSeconds\",\"opening\",\"closing\"],\"Invalid RAW exposure schedule.\");\n  requireAllowlistedRecord(r.nominalExposureDurationSeconds,[\"value\",\"unit\",\"evidence\"],\"Invalid RAW nominal exposure.\");\n  for(const boundary of [r.opening,r.closing]){\n    const b=requireAllowlistedRecord(boundary,[\"kind\",\"directionNative\",\"traversalDurationSeconds\"],\"Invalid RAW exposure boundary.\");\n    if(b.directionNative!==undefined)requireAllowlistedRecord(b.directionNative,[\"value\",\"evidence\"],\"Invalid RAW scan direction.\");\n    if(b.traversalDurationSeconds!==undefined)requireAllowlistedRecord(b.traversalDurationSeconds,[\"value\",\"unit\",\"evidence\"],\"Invalid RAW scan duration.\");\n  }\n  const result=calculateCaptureExposureWindows({...schedule,nativeRaster:exposure.geometry.nativeRaster,samplePointsNative:points});\n  if(result.value.nominalExposureDurationSeconds.value!==exposure.exposure.shutterSeconds)throw new InvalidConfigurationError(\"RAW schedule differs from exposure duration.\");\n  return result.value;\n}\n/** Plans the task and checks the image size, resources and profiles before any callback or output allocation. No placeholder plane is made. */\nexport function calculateNativeRawPlan(input: NativeRawInput): NativeRawPlan {\n  const r=requireAllowlistedRecord(input,[\"exposure\",\"frameId\",\"modeId\",\"captureModeProfile\",\"colorSamplingProfile\",\"bindingProfile\",\"exposureWindow\",\"maximumOutputBytes\",\"tileWidth\",\"maximumPixels\"],\"Invalid native RAW input.\");\n  if(r.tileWidth!==undefined&&(typeof r.tileWidth!==\"number\"||!Number.isSafeInteger(r.tileWidth)||r.tileWidth<1||r.tileWidth>NATIVE_RAW_LIMITS.tileWidth))\n    throw new InvalidConfigurationError(\"Native RAW tile width must be an integer from 1 to 256.\");\n  const tileWidth=(r.tileWidth as number|undefined)??NATIVE_RAW_LIMITS.tileWidth;\n  const maximumPixels=resolveRaisedLimit(r.maximumPixels,NATIVE_RAW_LIMITS.maximumPixels,NATIVE_RAW_LIMITS.ceilingPixels,\n    \"Native RAW maximumPixels must be an integer from 1 to \"+NATIVE_RAW_LIMITS.ceilingPixels+\".\");\n  const exposure=normalizeCaptureExposureMetadata(r.exposure,ENGINE_API_VERSION,true),native=exposure.geometry.nativeRaster;\n  const pixelCount=native.pixelWidth*native.pixelHeight,outputBytes=pixelCount*NATIVE_RAW_LIMITS.outputBytesPerPixel;\n  if(pixelCount>maximumPixels||native.pixelWidth>NATIVE_RAW_LIMITS.maximumDimension||native.pixelHeight>NATIVE_RAW_LIMITS.maximumDimension||\n    !Number.isSafeInteger(r.maximumOutputBytes)||typeof r.maximumOutputBytes!==\"number\"||r.maximumOutputBytes<outputBytes)throw new InvalidConfigurationError(\"Native RAW raster exceeds output admission budget.\");\n  const frame={frameId:requirePublicOpaqueId(r.frameId,\"Invalid RAW frame ID.\"),capture:exposure,\n    modeId:requirePublicOpaqueId(r.modeId,\"Invalid RAW mode ID.\"),containerBitDepth:16 as const,\n    captureModeProfile:parseCaptureModeProfile(r.captureModeProfile),colorSamplingProfile:parseSensorColorSamplingProfile(r.colorSamplingProfile),\n    bindingProfile:parseNativeEffectiveRasterColorSamplingBindingProfile(r.bindingProfile)};\n  const mode=frame.captureModeProfile.modes.find(m=>m.modeId===frame.modeId);\n  if(exposure.noise.model.id!==SENSOR_RAW_PRODUCER_NOISE_MODEL.id||exposure.noise.model.version!==SENSOR_RAW_PRODUCER_NOISE_MODEL.version||\n    frame.colorSamplingProfile.layout.kind!==\"periodic-mosaic\"||mode?.acquisition.kind!==\"single-frame\"||mode.perFrameSampling.kind!==\"native-effective-raster\"||(mode.reconstructionStages?.length??0)!==0)\n    throw new InvalidConfigurationError(\"Native RAW requires exact noise identity and single-frame native periodic CFA.\");\n  // The binding is one affine mapping for the whole frame, so checking both corners covers it. Do this before any provider work.\n  for(const p of [{x:0,y:0},{x:native.pixelWidth-1,y:native.pixelHeight-1}]){\n    const c=resolveCaptureModeColorSamplingContributors({nativeRaster:native,captureModeProfile:frame.captureModeProfile,modeId:frame.modeId,colorSamplingProfile:frame.colorSamplingProfile,bindingProfile:frame.bindingProfile,modeSampleIndexFullFrame:p});\n    if(c.totalContributorSites!==1||c.channelComposition.kind!==\"single-channel\")throw new InvalidConfigurationError(\"Native RAW must preserve one native CFA site per sample.\");\n  }\n  const schedule=r.exposureWindow===undefined?undefined:structuredClone(r.exposureWindow) as SensorRawProducerExposureWindowInput;\n  // For the supported linear scans, the extreme values occur at the image corners. Check them before capture.\n  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}]);\n  return freezeOwnedData({schemaVersion:NATIVE_RAW_SCHEMA_VERSION,exposure,frame,pixelCount,outputBytes,\n    tileCount:Math.ceil(native.pixelWidth/tileWidth)*native.pixelHeight,\n    ...(r.tileWidth===undefined?{}:{tileWidth}),\n    ...(r.maximumPixels===undefined?{}:{maximumPixels}),\n    ...(schedule?{exposureWindow:schedule}:{}),upstreamRadiometryVerified:false as const,\n    seedSchedule:\"murmur3-capture-seed-native-index-stream-v2\" as const});\n}\n/**\n * Internal: the largest whole-event radiance query budget a native environment task admits for this plan:\n * 2 000 000 000, scaled in proportion when the plan raised its pixel limit above 24 000 000. Not exported from the package.\n */\nexport function nativeRawMaximumProviderEvaluations(plan: Pick<NativeRawPlan,\"maximumPixels\">): number {\n  return plan.maximumPixels===undefined?DEFAULT_MAXIMUM_PROVIDER_EVALUATIONS:scaleBudgetCeiling(DEFAULT_MAXIMUM_PROVIDER_EVALUATIONS,plan.maximumPixels);\n}\n/**\n * Runs validated per-site events (EQE photo signal, dark signal, charge completeness) through the shared\n * reference per-site physics.\n *\n * Tiles are read and committed one at a time. The task yields to the host at tile boundaries once about\n * 8 ms of work has passed since the last yield, and after the final tile. It checks for cancellation\n * before every tile, after every read and after every yield.\n */\nexport function createNativeRawTask(input: NativeRawInput,provider: NativeRawProvider): NativeRawTask {\n  return createNativeRawTaskWithCadence(input,provider,DEFAULT_HOST_YIELD_CADENCE);\n}\n/** Internal: the same task with an explicit host-yield timing. Timing never changes tiles, seeds or output. Not exported from the package. */\nexport function createNativeRawTaskWithCadence(input: NativeRawInput,provider: NativeRawProvider,cadence: HostYieldCadence,\n  /** Internal: a yield timer shared with a provider that also yields inside readTile, so both use one time budget. */\n  sharedGate?: HostYieldGate,\n  /** Internal: faster (\"lean\") per-site sensor execution for engine-built tiles. It never changes output or errors. */\n  leanSensor?: NativeRawLeanSensorHook,\n  /**\n   * Internal: run only native rows [y, y + height) (a partition). The output arrays then hold just those rows, and\n   * effectiveSaturationCodes holds 0 for CFA phases the rows do not contain; the merge step completes them.\n   * Seeds, tiles and per-site values are those of the whole-frame task.\n   */\n  rows?: { readonly y: number; readonly height: number; readonly firstSite?: (site: SensorRawProducerSiteInput) => void;\n    /** Internal (2.3 region rendering): also restrict to native columns [x, x + width). The output arrays are then that rectangle, row-major. */\n    readonly x?: number; readonly width?: number }): NativeRawTask {\n  const plan=calculateNativeRawPlan(input);\n  if(!provider||typeof provider.readTile!==\"function\"||typeof provider.yieldControl!==\"function\")throw new InvalidConfigurationError(\"Native RAW requires reader and host event-loop yield.\");\n  const read=provider.readTile.bind(provider),yieldControl=provider.yieldControl.bind(provider),abort=new AbortController();\n  const native=plan.exposure.geometry.nativeRaster,tileWidth=plan.tileWidth??NATIVE_RAW_LIMITS.tileWidth;\n  const rowStart=rows?.y??0,rowEnd=rowStart+(rows?.height??native.pixelHeight),colStart=rows?.x??0,colEnd=colStart+(rows?.width??native.pixelWidth);\n  if(colStart<0||colEnd>native.pixelWidth||colEnd<=colStart)throw new InvalidConfigurationError(\"Native RAW column band must lie inside the native raster.\");\n  const bandWidth=colEnd-colStart,length=(rowEnd-rowStart)*bandWidth;\n  let state:NativeRawTaskState=\"ready\",count=0,output:NativeRawOutput|null=null,first:SensorRawProducerSiteInput|undefined;\n  function release(): void {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;}\n  function active(): void {if(abort.signal.aborted)throw new InvalidConfigurationError(\"Native RAW execution aborted.\");}\n  return {plan,get state(): NativeRawTaskState {return state;},get completedTileCount(): number {return count;},\n    async run(): Promise<void> {\n      if(state!==\"ready\")throw new InvalidConfigurationError(\"Native RAW task is single-use.\");state=\"running\";\n      try{\n        const gate=sharedGate??createHostYieldGate(cadence);sharedGate?.restart();\n        const layout=plan.frame.colorSamplingProfile.layout;if(layout.kind!==\"periodic-mosaic\")throw new InvalidConfigurationError(\"Native RAW requires periodic CFA.\");\n        const white=createPhaseWhiteLevelAccumulator(native.pixelWidth,layout.repeatWidthSites,layout.repeatHeightSites);\n        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)};\n        for(let y=rowStart;y<rowEnd;y++)for(let x=colStart;x<colEnd;x+=tileWidth){\n          active();const request=Object.freeze({captureId:plan.exposure.captureId,frameId:plan.frame.frameId,x,y,width:Math.min(tileWidth,colEnd-x),height:1});\n          {\n            const supplied=await read(request,abort.signal);active();\n            const tile=requireAllowlistedRecord(supplied,[\"captureId\",\"frameId\",\"x\",\"y\",\"width\",\"height\",\"sites\"],\"Invalid native RAW tile.\");\n            for(const key of Object.keys(request) as (keyof NativeRawTileRequest)[])if(tile[key]!==request[key])throw new InvalidConfigurationError(\"Native RAW tile identity mismatch.\");\n            if(!Array.isArray(tile.sites)||tile.sites.length!==request.width||Array.from({length:request.width},(_,i)=>i in (tile.sites as unknown[])).includes(false))throw new InvalidConfigurationError(\"Native RAW tile needs exact dense coverage.\");\n            const timing=plan.exposureWindow?windows(plan.exposure,plan.exposureWindow,Array.from({length:request.width},(_,i)=>({x:x+i+.5,y:y+.5}))):undefined;\n            // Lean entries (built by the engine, provably valid against an earlier verified template) skip parsing and\n            // identity checks. They are only claimed once the frame's first site is fixed.\n            const lean=leanSensor&&first!==undefined?(tile.sites as unknown[]).map(site=>leanSensor.claim(site)):undefined;\n            const sites=tile.sites.map((site,j)=>lean?.[j]?undefined:parseNativeRawProducerSite(site,y*native.pixelWidth+x+j,plan.frame,timing?.samples[j]));\n            if(first===undefined){first=sites[0];if(first)rows?.firstSite?.(first);}for(const s of sites)if(s)validateNativeRawReadoutIdentity(s,first!);\n            // Every site in this tile is validated before any output is written. A failure never returns partial output.\n            const seed=plan.exposure.noise.seedUint32;\n            for(let j=0;j<sites.length;j++){\n              // index: absolute native index (seeds, CFA phase); at: position in this task's output arrays.\n              const index=y*native.pixelWidth+x+j,at=(y-rowStart)*bandWidth+x+j-colStart,handle=lean?.[j];\n              if(handle){\n                const o=leanSensor!.compute(handle,index,seed,timing?.samples[j]);\n                output.codes[at]=o.rawCode;output.blackLevels[at]=o.blackLevelCode;output.digitalSaturationCodes[at]=o.digitalSaturationCode;\n                output.saturationFlags[at]=o.flags;white.record(index,o.whiteCode);continue;\n              }\n              const result=calculateNativeRawSite(sites[j]!,seed,index),r=result.readout.value;\n              output.codes[at]=r.rawCode;output.blackLevels[at]=r.blackLevelCode;output.digitalSaturationCodes[at]=r.digitalSaturationCode;\n              output.saturationFlags[at]=Number(r.physicalScalarSaturationApplied)|Number(r.preAdcSaturationApplied)<<1|Number(r.digitalSaturationApplied)<<2;\n              const whiteCode=calculateSiteEffectiveSaturationCode(r,sites[j]!.readoutProfile,sites[j]!.regimeId);\n              white.record(index,whiteCode);\n              leanSensor?.observe(index,sites[j]!,result,whiteCode,seed);\n            }\n            count++;\n          }\n          // Yield when the time budget is spent, and always after the final tile. Yield timing never changes output.\n          if(gate.due()||(y===rowEnd-1&&x+tileWidth>=colEnd)){await yieldControl(abort.signal);active();gate.restart();}\n        }\n        output.effectiveSaturationCodes.set(rows?white.partial():white.finish());first=undefined;state=\"completed\";\n      }catch(error){release();if(!abort.signal.aborted){state=\"failed\";abort.abort();}throw error;}\n    },\n    cancel(): void {if(state===\"ready\"||state===\"running\"||state===\"completed\"){state=\"cancelled\";abort.abort();release();}},\n    dispose(): void {if(state!==\"transferred\"){state=\"disposed\";abort.abort();release();}},\n    takeOutput(): NativeRawOutput {if(state!==\"completed\"||!output)throw new InvalidConfigurationError(\"Native RAW output unavailable.\");const result=output;output=null;first=undefined;state=\"transferred\";return result;}\n  };\n}\n"]}
+{"version":3,"file":"native-raw.js","sourceRoot":"","sources":["../../src/capture/native-raw.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Native RAW capture with the existing per-site (scalar) RAW model: an up-front plan and limit check from\n * metadata only, then bounded tile-by-tile execution.\n */\nimport { EXPOSURE_BUILD_UP_STAGES, type ExposureBuildUpStage } from \"./exposure-build-up-stage.js\";\nimport { normalizeCaptureExposureMetadata, type SimulatedCaptureInput, type SimulatedCapture, type CaptureExposureSource } from \"./simulated-capture.js\";\nimport { ENGINE_API_VERSION } from \"../core/version.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { requireAllowlistedRecord, requirePublicOpaqueId } from \"../core/record-validation.js\";\nimport { freezeOwnedData } from \"../core/owned-data.js\";\nimport { FULL_RESOLUTION_CEILING_PIXELS, resolveRaisedLimit, scaleBudgetCeiling } from \"../core/pixel-limits.js\";\nimport { calculateSiteEffectiveSaturationCode, createPhaseWhiteLevelAccumulator } from \"./raw-white-level.js\";\nimport { DEFAULT_HOST_YIELD_CADENCE, createHostYieldGate, type HostYieldCadence, type HostYieldGate } from \"./host-yield-cadence.js\";\nimport { parseCaptureModeProfile } from \"../sensor/capture-mode.js\";\nimport { parseSensorColorSamplingProfile } from \"../sensor/color-sampling.js\";\nimport { parseNativeEffectiveRasterColorSamplingBindingProfile, resolveCaptureModeColorSamplingContributors } from \"../sensor/capture-color-sampling-binding.js\";\nimport { calculateCaptureExposureWindows } from \"../sensor/exposure-window.js\";\nimport { SENSOR_RAW_PRODUCER_NOISE_MODEL, calculateNativeRawSite, parseNativeRawProducerSite,\n  validateNativeRawReadoutIdentity, type NativeRawProducerFrameContext, type SensorRawProducerSiteInput,\n  type SensorRawProducerExposureWindowInput } from \"./sensor-raw-producer.js\";\n\nexport const NATIVE_RAW_SCHEMA_VERSION = \"0.1.0\" as const;\n/** `maximumPixels` is the default pixel limit; a request may raise it with its own `maximumPixels`, up to `ceilingPixels`. */\nexport const NATIVE_RAW_LIMITS = /* @__PURE__ */ Object.freeze({ maximumPixels: 24_000_000, ceilingPixels: FULL_RESOLUTION_CEILING_PIXELS, maximumDimension: 16_384,\n  tileWidth: 256, tileHeight: 1, outputBytesPerPixel: 7 });\n/** Default whole-event radiance query budget ceiling of the native environment tasks; it scales with a raised `maximumPixels`. */\nconst DEFAULT_MAXIMUM_PROVIDER_EVALUATIONS = 2_000_000_000;\n/** A shooting event and where its source came from. Not a finished float master or committed RAW frame. */\nexport type NativeRawExposureInput = Omit<SimulatedCaptureInput, \"planes\" | \"source\"> & {source:CaptureExposureSource};\nexport type NativeRawExposure = Omit<SimulatedCapture, \"schemaVersion\" | \"planes\" | \"source\"> & {source:CaptureExposureSource};\nexport interface NativeRawInput {\n  exposure: NativeRawExposureInput;\n  frameId: string;\n  modeId: string;\n  captureModeProfile: NativeRawProducerFrameContext[\"captureModeProfile\"];\n  colorSamplingProfile: NativeRawProducerFrameContext[\"colorSamplingProfile\"];\n  bindingProfile: NativeRawProducerFrameContext[\"bindingProfile\"];\n  exposureWindow?: SensorRawProducerExposureWindowInput;\n  maximumOutputBytes: number;\n  /** Optional tile width for execution, in native sites, 1–256. Default 256. It does not affect sampling. */\n  tileWidth?: number;\n  /**\n   * Optional opt-in pixel limit for large sensors: an integer from 1 to `NATIVE_RAW_LIMITS.ceilingPixels`.\n   * Default `NATIVE_RAW_LIMITS.maximumPixels` (24 000 000). `maximumOutputBytes` still applies. A raised limit\n   * also raises the native environment tasks' whole-event query budget ceiling in proportion\n   * (2 000 000 000 per 24 000 000 pixels). It does not affect sampling.\n   */\n  maximumPixels?: number;\n}\nexport interface NativeRawPlan {\n  schemaVersion: typeof NATIVE_RAW_SCHEMA_VERSION;\n  exposure: NativeRawExposure;\n  frame: NativeRawProducerFrameContext;\n  exposureWindow?: SensorRawProducerExposureWindowInput;\n  pixelCount: number;\n  outputBytes: number;\n  tileCount: number;\n  /** Present only when an execution tile width was given. Otherwise the plan keeps its earlier shape. */\n  tileWidth?: number;\n  /** Present only when a pixel limit was given. Otherwise the plan keeps its earlier shape. */\n  maximumPixels?: number;\n  upstreamRadiometryVerified: false;\n  seedSchedule: \"murmur3-capture-seed-native-index-stream-v2\";\n}\n/** Tile rectangle, in absolute full-sensor CFA coordinates, before orientation, active-area crop or output scaling. */\nexport interface NativeRawTileRequest { captureId: string; frameId: string; x: number; y: number; width: number; height: number }\nexport interface NativeRawTile extends NativeRawTileRequest { sites: readonly SensorRawProducerSiteInput[] }\nexport interface NativeRawProvider {\n  readTile(request: Readonly<NativeRawTileRequest>, signal: AbortSignal): Promise<NativeRawTile>;\n  yieldControl(signal: AbortSignal): Promise<void>;\n}\n/** Row-major arrays owned only by the output. They cannot be attached to the bounded SensorRawFrame type. */\nexport interface NativeRawOutput {\n  plan: NativeRawPlan;\n  codes: Uint16Array;\n  blackLevels: Uint16Array;\n  digitalSaturationCodes: Uint16Array;\n  /** Saturation flags. Bit 0: physical charge clamp; bit 1: pre-ADC clamp; bit 2: digital saturation. */\n  saturationFlags: Uint8Array;\n  /**\n   * Effective white (full-saturation) code for each absolute CFA repeat phase, indexed\n   * `phaseY*repeatWidthSites+phaseX`: min(digital saturation, round(black + min(capacity, pre-ADC\n   * saturation)/gain)). See `calculateEffectiveSaturationCode`. A few bytes, not one value per pixel.\n   */\n  effectiveSaturationCodes: Uint16Array;\n}\n/** Internal: lean per-site outputs of an engine-built site (see native-environment-lean.ts). */\nexport interface NativeRawLeanOutput { rawCode: number; blackLevelCode: number; digitalSaturationCode: number; flags: number; whiteCode: number }\n/**\n * Internal hook for tiles the engine builds itself (native environment RAW).\n *\n * claim() recognizes only entries the hook itself created, for sites whose parsing and identity checks are\n * provably redundant. compute() returns the outputs calculateNativeRawSite would produce, falling back to it\n * internally. observe() sees every fully computed site.\n */\nexport interface NativeRawLeanSensorHook {\n  claim(site: unknown): object | undefined;\n  compute(handle: object, index: number, seed: number, timing: ReturnType<typeof calculateCaptureExposureWindows>[\"value\"][\"samples\"][number] | undefined, b?: ExposureBuildUpStage): NativeRawLeanOutput;\n  observe(index: number, parsed: SensorRawProducerSiteInput, result: ReturnType<typeof calculateNativeRawSite>, whiteCode: number, seed: number, b?: ExposureBuildUpStage): void;\n}\nexport type NativeRawTaskState = \"ready\" | \"running\" | \"completed\" | \"cancelled\" | \"failed\" | \"disposed\" | \"transferred\";\nexport interface NativeRawTask {\n  readonly plan: NativeRawPlan;\n  readonly state: NativeRawTaskState;\n  readonly completedTileCount: number;\n  run(): Promise<void>;\n  cancel(): void;\n  dispose(): void;\n  takeOutput(): NativeRawOutput;\n}\nfunction windows(exposure: NativeRawExposure, schedule: SensorRawProducerExposureWindowInput,\n  points: readonly {x:number;y:number}[]): ReturnType<typeof calculateCaptureExposureWindows>[\"value\"] {\n  const r=requireAllowlistedRecord(schedule,[\"shutterMechanism\",\"nominalExposureDurationSeconds\",\"opening\",\"closing\"],\"Invalid RAW exposure schedule.\");\n  requireAllowlistedRecord(r.nominalExposureDurationSeconds,[\"value\",\"unit\",\"evidence\"],\"Invalid RAW nominal exposure.\");\n  for(const boundary of [r.opening,r.closing]){\n    const b=requireAllowlistedRecord(boundary,[\"kind\",\"directionNative\",\"traversalDurationSeconds\"],\"Invalid RAW exposure boundary.\");\n    if(b.directionNative!==undefined)requireAllowlistedRecord(b.directionNative,[\"value\",\"evidence\"],\"Invalid RAW scan direction.\");\n    if(b.traversalDurationSeconds!==undefined)requireAllowlistedRecord(b.traversalDurationSeconds,[\"value\",\"unit\",\"evidence\"],\"Invalid RAW scan duration.\");\n  }\n  const result=calculateCaptureExposureWindows({...schedule,nativeRaster:exposure.geometry.nativeRaster,samplePointsNative:points});\n  if(result.value.nominalExposureDurationSeconds.value!==exposure.exposure.shutterSeconds)throw new InvalidConfigurationError(\"RAW schedule differs from exposure duration.\");\n  return result.value;\n}\n/** Plans the task and checks the image size, resources and profiles before any callback or output allocation. No placeholder plane is made. */\nexport function calculateNativeRawPlan(input: NativeRawInput): NativeRawPlan {\n  const r=requireAllowlistedRecord(input,[\"exposure\",\"frameId\",\"modeId\",\"captureModeProfile\",\"colorSamplingProfile\",\"bindingProfile\",\"exposureWindow\",\"maximumOutputBytes\",\"tileWidth\",\"maximumPixels\"],\"Invalid native RAW input.\");\n  if(r.tileWidth!==undefined&&(typeof r.tileWidth!==\"number\"||!Number.isSafeInteger(r.tileWidth)||r.tileWidth<1||r.tileWidth>NATIVE_RAW_LIMITS.tileWidth))\n    throw new InvalidConfigurationError(\"Native RAW tile width must be an integer from 1 to 256.\");\n  const tileWidth=(r.tileWidth as number|undefined)??NATIVE_RAW_LIMITS.tileWidth;\n  const maximumPixels=resolveRaisedLimit(r.maximumPixels,NATIVE_RAW_LIMITS.maximumPixels,NATIVE_RAW_LIMITS.ceilingPixels,\n    \"Native RAW maximumPixels must be an integer from 1 to \"+NATIVE_RAW_LIMITS.ceilingPixels+\".\");\n  const exposure=normalizeCaptureExposureMetadata(r.exposure,ENGINE_API_VERSION,true),native=exposure.geometry.nativeRaster;\n  const pixelCount=native.pixelWidth*native.pixelHeight,outputBytes=pixelCount*NATIVE_RAW_LIMITS.outputBytesPerPixel;\n  if(pixelCount>maximumPixels||native.pixelWidth>NATIVE_RAW_LIMITS.maximumDimension||native.pixelHeight>NATIVE_RAW_LIMITS.maximumDimension||\n    !Number.isSafeInteger(r.maximumOutputBytes)||typeof r.maximumOutputBytes!==\"number\"||r.maximumOutputBytes<outputBytes)throw new InvalidConfigurationError(\"Native RAW raster exceeds output admission budget.\");\n  const frame={frameId:requirePublicOpaqueId(r.frameId,\"Invalid RAW frame ID.\"),capture:exposure,\n    modeId:requirePublicOpaqueId(r.modeId,\"Invalid RAW mode ID.\"),containerBitDepth:16 as const,\n    captureModeProfile:parseCaptureModeProfile(r.captureModeProfile),colorSamplingProfile:parseSensorColorSamplingProfile(r.colorSamplingProfile),\n    bindingProfile:parseNativeEffectiveRasterColorSamplingBindingProfile(r.bindingProfile)};\n  const mode=frame.captureModeProfile.modes.find(m=>m.modeId===frame.modeId);\n  if(exposure.noise.model.id!==SENSOR_RAW_PRODUCER_NOISE_MODEL.id||exposure.noise.model.version!==SENSOR_RAW_PRODUCER_NOISE_MODEL.version||\n    frame.colorSamplingProfile.layout.kind!==\"periodic-mosaic\"||mode?.acquisition.kind!==\"single-frame\"||mode.perFrameSampling.kind!==\"native-effective-raster\"||(mode.reconstructionStages?.length??0)!==0)\n    throw new InvalidConfigurationError(\"Native RAW requires exact noise identity and single-frame native periodic CFA.\");\n  // The binding is one affine mapping for the whole frame, so checking both corners covers it. Do this before any provider work.\n  for(const p of [{x:0,y:0},{x:native.pixelWidth-1,y:native.pixelHeight-1}]){\n    const c=resolveCaptureModeColorSamplingContributors({nativeRaster:native,captureModeProfile:frame.captureModeProfile,modeId:frame.modeId,colorSamplingProfile:frame.colorSamplingProfile,bindingProfile:frame.bindingProfile,modeSampleIndexFullFrame:p});\n    if(c.totalContributorSites!==1||c.channelComposition.kind!==\"single-channel\")throw new InvalidConfigurationError(\"Native RAW must preserve one native CFA site per sample.\");\n  }\n  const schedule=r.exposureWindow===undefined?undefined:structuredClone(r.exposureWindow) as SensorRawProducerExposureWindowInput;\n  // For the supported linear scans, the extreme values occur at the image corners. Check them before capture.\n  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}]);\n  return freezeOwnedData({schemaVersion:NATIVE_RAW_SCHEMA_VERSION,exposure,frame,pixelCount,outputBytes,\n    tileCount:Math.ceil(native.pixelWidth/tileWidth)*native.pixelHeight,\n    ...(r.tileWidth===undefined?{}:{tileWidth}),\n    ...(r.maximumPixels===undefined?{}:{maximumPixels}),\n    ...(schedule?{exposureWindow:schedule}:{}),upstreamRadiometryVerified:false as const,\n    seedSchedule:\"murmur3-capture-seed-native-index-stream-v2\" as const});\n}\n/**\n * Internal: the largest whole-event radiance query budget a native environment task admits for this plan:\n * 2 000 000 000, scaled in proportion when the plan raised its pixel limit above 24 000 000. Not exported from the package.\n */\nexport function nativeRawMaximumProviderEvaluations(plan: Pick<NativeRawPlan,\"maximumPixels\">): number {\n  return plan.maximumPixels===undefined?DEFAULT_MAXIMUM_PROVIDER_EVALUATIONS:scaleBudgetCeiling(DEFAULT_MAXIMUM_PROVIDER_EVALUATIONS,plan.maximumPixels);\n}\n/**\n * Runs validated per-site events (EQE photo signal, dark signal, charge completeness) through the shared\n * reference per-site physics.\n *\n * Tiles are read and committed one at a time. The task yields to the host at tile boundaries once about\n * 8 ms of work has passed since the last yield, and after the final tile. It checks for cancellation\n * before every tile, after every read and after every yield.\n */\nexport function createNativeRawTask(input: NativeRawInput,provider: NativeRawProvider): NativeRawTask {\n  return createNativeRawTaskWithCadence(input,provider,DEFAULT_HOST_YIELD_CADENCE);\n}\n/** Internal: the same task with an explicit host-yield timing. Timing never changes tiles, seeds or output. Not exported from the package. */\nexport function createNativeRawTaskWithCadence(input: NativeRawInput,provider: NativeRawProvider,cadence: HostYieldCadence,\n  /** Internal: a yield timer shared with a provider that also yields inside readTile, so both use one time budget. */\n  sharedGate?: HostYieldGate,\n  /** Internal: faster (\"lean\") per-site sensor execution for engine-built tiles. It never changes output or errors. */\n  leanSensor?: NativeRawLeanSensorHook,\n  /**\n   * Internal: run only native rows [y, y + height) (a partition). The output arrays then hold just those rows, and\n   * effectiveSaturationCodes holds 0 for CFA phases the rows do not contain; the merge step completes them.\n   * Seeds, tiles and per-site values are those of the whole-frame task.\n   */\n  rows?: { readonly y: number; readonly height: number; readonly firstSite?: (site: SensorRawProducerSiteInput) => void;\n    /** Internal (2.3 region rendering): also restrict to native columns [x, x + width). The output arrays are then that rectangle, row-major. */\n    readonly x?: number; readonly width?: number }): NativeRawTask {\n  const plan=calculateNativeRawPlan(input);\n  if(!provider||typeof provider.readTile!==\"function\"||typeof provider.yieldControl!==\"function\")throw new InvalidConfigurationError(\"Native RAW requires reader and host event-loop yield.\");\n  const read=provider.readTile.bind(provider),yieldControl=provider.yieldControl.bind(provider),abort=new AbortController();\n  const native=plan.exposure.geometry.nativeRaster,tileWidth=plan.tileWidth??NATIVE_RAW_LIMITS.tileWidth;\n  const rowStart=rows?.y??0,rowEnd=rowStart+(rows?.height??native.pixelHeight),colStart=rows?.x??0,colEnd=colStart+(rows?.width??native.pixelWidth);\n  if(colStart<0||colEnd>native.pixelWidth||colEnd<=colStart)throw new InvalidConfigurationError(\"Native RAW column band must lie inside the native raster.\");\n  const bandWidth=colEnd-colStart,length=(rowEnd-rowStart)*bandWidth;\n  let state:NativeRawTaskState=\"ready\",count=0,output:NativeRawOutput|null=null,first:SensorRawProducerSiteInput|undefined;\n  function release(): void {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;}\n  function active(): void {if(abort.signal.aborted)throw new InvalidConfigurationError(\"Native RAW execution aborted.\");}\n  return {plan,get state(): NativeRawTaskState {return state;},get completedTileCount(): number {return count;},\n    async run(): Promise<void> {\n      if(state!==\"ready\")throw new InvalidConfigurationError(\"Native RAW task is single-use.\");state=\"running\";\n      try{\n        const gate=sharedGate??createHostYieldGate(cadence);sharedGate?.restart();\n        const layout=plan.frame.colorSamplingProfile.layout;if(layout.kind!==\"periodic-mosaic\")throw new InvalidConfigurationError(\"Native RAW requires periodic CFA.\");\n        const white=createPhaseWhiteLevelAccumulator(native.pixelWidth,layout.repeatWidthSites,layout.repeatHeightSites);\n        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)};\n        for(let y=rowStart;y<rowEnd;y++)for(let x=colStart;x<colEnd;x+=tileWidth){\n          active();const request=Object.freeze({captureId:plan.exposure.captureId,frameId:plan.frame.frameId,x,y,width:Math.min(tileWidth,colEnd-x),height:1});\n          {\n            const supplied=await read(request,abort.signal);active();\n            const tile=requireAllowlistedRecord(supplied,[\"captureId\",\"frameId\",\"x\",\"y\",\"width\",\"height\",\"sites\"],\"Invalid native RAW tile.\");\n            for(const key of Object.keys(request) as (keyof NativeRawTileRequest)[])if(tile[key]!==request[key])throw new InvalidConfigurationError(\"Native RAW tile identity mismatch.\");\n            if(!Array.isArray(tile.sites)||tile.sites.length!==request.width||Array.from({length:request.width},(_,i)=>i in (tile.sites as unknown[])).includes(false))throw new InvalidConfigurationError(\"Native RAW tile needs exact dense coverage.\");\n            const timing=plan.exposureWindow?windows(plan.exposure,plan.exposureWindow,Array.from({length:request.width},(_,i)=>({x:x+i+.5,y:y+.5}))):undefined;\n            // Lean entries (built by the engine, provably valid against an earlier verified template) skip parsing and\n            // identity checks. They are only claimed once the frame's first site is fixed.\n            const lean=leanSensor&&first!==undefined?(tile.sites as unknown[]).map(site=>leanSensor.claim(site)):undefined;\n            const sites=tile.sites.map((site,j)=>lean?.[j]?undefined:parseNativeRawProducerSite(site,y*native.pixelWidth+x+j,plan.frame,timing?.samples[j]));\n            if(first===undefined){first=sites[0];if(first)rows?.firstSite?.(first);}for(const s of sites)if(s)validateNativeRawReadoutIdentity(s,first!);\n            // Every site in this tile is validated before any output is written. A failure never returns partial output.\n            const seed=plan.exposure.noise.seedUint32,b=EXPOSURE_BUILD_UP_STAGES.get(input);\n            for(let j=0;j<sites.length;j++){\n              // index: absolute native index (seeds, CFA phase); at: position in this task's output arrays.\n              const index=y*native.pixelWidth+x+j,at=(y-rowStart)*bandWidth+x+j-colStart,handle=lean?.[j];\n              if(handle){\n                const o=leanSensor!.compute(handle,index,seed,timing?.samples[j],b);\n                output.codes[at]=o.rawCode;output.blackLevels[at]=o.blackLevelCode;output.digitalSaturationCodes[at]=o.digitalSaturationCode;\n                output.saturationFlags[at]=o.flags;white.record(index,o.whiteCode);continue;\n              }\n              const result=calculateNativeRawSite(sites[j]!,seed,index,b),r=result.readout.value;\n              output.codes[at]=r.rawCode;output.blackLevels[at]=r.blackLevelCode;output.digitalSaturationCodes[at]=r.digitalSaturationCode;\n              output.saturationFlags[at]=Number(r.physicalScalarSaturationApplied)|Number(r.preAdcSaturationApplied)<<1|Number(r.digitalSaturationApplied)<<2;\n              const whiteCode=calculateSiteEffectiveSaturationCode(r,sites[j]!.readoutProfile,sites[j]!.regimeId);\n              white.record(index,whiteCode);\n              leanSensor?.observe(index,sites[j]!,result,whiteCode,seed,b);\n            }\n            count++;\n          }\n          // Yield when the time budget is spent, and always after the final tile. Yield timing never changes output.\n          if(gate.due()||(y===rowEnd-1&&x+tileWidth>=colEnd)){await yieldControl(abort.signal);active();gate.restart();}\n        }\n        output.effectiveSaturationCodes.set(rows?white.partial():white.finish());first=undefined;state=\"completed\";\n      }catch(error){release();if(!abort.signal.aborted){state=\"failed\";abort.abort();}throw error;}\n    },\n    cancel(): void {if(state===\"ready\"||state===\"running\"||state===\"completed\"){state=\"cancelled\";abort.abort();release();}},\n    dispose(): void {if(state!==\"transferred\"){state=\"disposed\";abort.abort();release();}},\n    takeOutput(): NativeRawOutput {if(state!==\"completed\"||!output)throw new InvalidConfigurationError(\"Native RAW output unavailable.\");const result=output;output=null;first=undefined;state=\"transferred\";return result;}\n  };\n}\n"]}

package/dist/capture/sensor-raw-producer.d.ts

@@ -3,6 +3,7 @@ import { type SensorRawFrameInput, type SensorRawFrame } from "./sensor-raw-fram
 import { composeSensorAccumulatedCharge, type ComposeSensorPhotoAccumulatedChargeInput as ComposeSensorAccumulatedChargeInput } from "../sensor/accumulated-charge.js";
 import { assessSensorPhysicalChargeCapacity, type SensorPhysicalChargeCapacityProfile } from "../sensor/physical-charge-capacity.js";
 import { simulateSensorChargeRealization, simulateSensorRawCode, type SensorChargeSamplingProfile, type SensorReadoutConversionProfile } from "../sensor/raw-readout.js";
+import type { ExposureBuildUpStage } from "./exposure-build-up-stage.js";
 import { type SensorFixedPatternNoiseProfile } from "../sensor/fixed-pattern-noise.js";
 import { type CalculateCaptureExposureWindowsInput, type CaptureExposureWindows } from "../sensor/exposure-window.js";
 export declare const SENSOR_RAW_PRODUCER_SCHEMA_VERSION: "0.3.0";
@@ -60,7 +61,9 @@ export type NativeRawProducerFrameContext = Omit<SensorRawProducerInput["frame"]
 export declare function parseNativeRawProducerSite(site: unknown, i: number, frame: NativeRawProducerFrameContext, window?: CaptureExposureWindows["samples"][number]): SensorRawProducerSiteInput;
 export declare function validateNativeRawReadoutIdentity(s: SensorRawProducerSiteInput, first: SensorRawProducerSiteInput): void;
 /** The shared per-site pipeline holds all the charge, capacity, random-noise and ADC equations. `i` is the absolute native row-major index. */
-export declare function calculateNativeRawSite(s: SensorRawProducerSiteInput, seed: number, i: number): SensorRawProducerResult["sites"][number];
+export declare function calculateNativeRawSite(s: SensorRawProducerSiteInput, seed: number, i: number, 
+/** Internal (#534): a build-up fraction's stage, which splits the realized counts down to the fraction and reads with its own stream. */
+b?: ExposureBuildUpStage): SensorRawProducerResult["sites"][number];
 /** Validates the complete per-site exposure inputs. Charge, noise or RAW codes are never accepted as a shortcut. */
 export declare function parseSensorRawProducerInput(value: unknown): SensorRawProducerInput;
 /** Runs accumulated charge → capacity → Poisson noise → read noise and ADC → native sample → immutable frame. */

package/dist/capture/sensor-raw-producer.js

@@ -231,16 +231,25 @@ export function validateNativeRawReadoutIdentity(s, first) {
     }
 }
 /** The shared per-site pipeline holds all the charge, capacity, random-noise and ADC equations. `i` is the absolute native row-major index. */
-export function calculateNativeRawSite(s, seed, i) {
+export function calculateNativeRawSite(s, seed, i, 
+/** Internal (#534): a build-up fraction's stage, which splits the realized counts down to the fraction and reads with its own stream. */
+b) {
     const accumulatedCharge = composeSensorAccumulatedCharge(s.charge);
     const capacity = assessSensorPhysicalChargeCapacity({ accumulatedCharge: accumulatedCharge.value, capacityProfile: s.capacityProfile,
         operatingStateId: s.operatingStateId, operatingTemperatureC: s.charge.darkCharge.operatingTemperatureC });
     const pattern = s.fixedPatternNoise === undefined ? {} : { fixedPatternNoise: s.fixedPatternNoise };
-    const realization = simulateSensorChargeRealization({ accumulatedCharge: accumulatedCharge.value, samplingProfile: s.samplingProfile,
+    let realization = simulateSensorChargeRealization({ accumulatedCharge: accumulatedCharge.value, samplingProfile: s.samplingProfile,
         seedUint32: deriveNativeSiteStreamSeedUint32(seed, i, NATIVE_SITE_CHARGE_STREAM_ID), ...pattern });
+    if (b) {
+        const v = realization.value;
+        if (v.additionalComponents.length)
+            throw new InvalidConfigurationError("An exposure build-up takes photo and dark charge only.");
+        b.split(i, v.photoSampledMeanElectronCount, v.darkSampledMeanElectronCount, v.photoRealizedElectronCount, v.darkRealizedElectronCount);
+        realization = { ...realization, value: { ...v, photoRealizedElectronCount: b.photo, darkRealizedElectronCount: b.dark, totalRealizedStoredElectronEquivalentCount: b.photo + b.dark + 0 } };
+    }
     const readout = simulateSensorRawCode({ chargeRealization: realization.value, physicalCapacityAssessment: capacity.value,
         readoutProfile: s.readoutProfile, regimeId: s.regimeId,
-        readNoiseSeedUint32: deriveNativeSiteStreamSeedUint32(seed, i, NATIVE_SITE_READ_NOISE_STREAM_ID), ...pattern });
+        readNoiseSeedUint32: deriveNativeSiteStreamSeedUint32(seed, i, b ? b.read : NATIVE_SITE_READ_NOISE_STREAM_ID), ...pattern });
     return { accumulatedCharge, capacity, realization, readout };
 }
 /** The selected regime's declared INL, which the effective white level needs at saturation. */