@photivra/engine 2.2.0 → 2.3.0

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 = 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 }): 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),offset=rowStart*native.pixelWidth,length=(rowEnd-rowStart)*native.pixelWidth;\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=0;x<native.pixelWidth;x+=tileWidth){\n          active();const request=Object.freeze({captureId:plan.exposure.captureId,frameId:plan.frame.frameId,x,y,width:Math.min(tileWidth,native.pixelWidth-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=index-offset,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>=native.pixelWidth)){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":"AAAA,sCAAsC;AAEtC;;;GAGG;AACH,OAAO,EAAE,gCAAgC,EAAiF,MAAM,wBAAwB,CAAC;AACzJ,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACjH,OAAO,EAAE,oCAAoC,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAA6C,MAAM,yBAAyB,CAAC;AACrI,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,qDAAqD,EAAE,2CAA2C,EAAE,MAAM,6CAA6C,CAAC;AACjK,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,0BAA0B,EAC1F,gCAAgC,EACW,MAAM,0BAA0B,CAAC;AAE9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAgB,CAAC;AAC1D,8HAA8H;AAC9H,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM;IACjJ,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAC;AAC3D,kIAAkI;AAClI,MAAM,oCAAoC,GAAG,aAAa,CAAC;AAoF3D,SAAS,OAAO,CAAC,QAA2B,EAAE,QAA8C,EAC1F,MAAsC;IACtC,MAAM,CAAC,GAAC,wBAAwB,CAAC,QAAQ,EAAC,CAAC,kBAAkB,EAAC,gCAAgC,EAAC,SAAS,EAAC,SAAS,CAAC,EAAC,gCAAgC,CAAC,CAAC;IACtJ,wBAAwB,CAAC,CAAC,CAAC,8BAA8B,EAAC,CAAC,OAAO,EAAC,MAAM,EAAC,UAAU,CAAC,EAAC,+BAA+B,CAAC,CAAC;IACvH,KAAI,MAAM,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,EAAC,CAAC,CAAC,OAAO,CAAC,EAAC,CAAC;QAC3C,MAAM,CAAC,GAAC,wBAAwB,CAAC,QAAQ,EAAC,CAAC,MAAM,EAAC,iBAAiB,EAAC,0BAA0B,CAAC,EAAC,gCAAgC,CAAC,CAAC;QAClI,IAAG,CAAC,CAAC,eAAe,KAAG,SAAS;YAAC,wBAAwB,CAAC,CAAC,CAAC,eAAe,EAAC,CAAC,OAAO,EAAC,UAAU,CAAC,EAAC,6BAA6B,CAAC,CAAC;QAChI,IAAG,CAAC,CAAC,wBAAwB,KAAG,SAAS;YAAC,wBAAwB,CAAC,CAAC,CAAC,wBAAwB,EAAC,CAAC,OAAO,EAAC,MAAM,EAAC,UAAU,CAAC,EAAC,4BAA4B,CAAC,CAAC;IAC1J,CAAC;IACD,MAAM,MAAM,GAAC,+BAA+B,CAAC,EAAC,GAAG,QAAQ,EAAC,YAAY,EAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAC,kBAAkB,EAAC,MAAM,EAAC,CAAC,CAAC;IAClI,IAAG,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,KAAK,KAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc;QAAC,MAAM,IAAI,yBAAyB,CAAC,8CAA8C,CAAC,CAAC;IAC5K,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AACD,+IAA+I;AAC/I,MAAM,UAAU,sBAAsB,CAAC,KAAqB;IAC1D,MAAM,CAAC,GAAC,wBAAwB,CAAC,KAAK,EAAC,CAAC,UAAU,EAAC,SAAS,EAAC,QAAQ,EAAC,oBAAoB,EAAC,sBAAsB,EAAC,gBAAgB,EAAC,gBAAgB,EAAC,oBAAoB,EAAC,WAAW,EAAC,eAAe,CAAC,EAAC,2BAA2B,CAAC,CAAC;IACnO,IAAG,CAAC,CAAC,SAAS,KAAG,SAAS,IAAE,CAAC,OAAO,CAAC,CAAC,SAAS,KAAG,QAAQ,IAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,IAAE,CAAC,CAAC,SAAS,GAAC,CAAC,IAAE,CAAC,CAAC,SAAS,GAAC,iBAAiB,CAAC,SAAS,CAAC;QACrJ,MAAM,IAAI,yBAAyB,CAAC,yDAAyD,CAAC,CAAC;IACjG,MAAM,SAAS,GAAE,CAAC,CAAC,SAA8B,IAAE,iBAAiB,CAAC,SAAS,CAAC;IAC/E,MAAM,aAAa,GAAC,kBAAkB,CAAC,CAAC,CAAC,aAAa,EAAC,iBAAiB,CAAC,aAAa,EAAC,iBAAiB,CAAC,aAAa,EACpH,wDAAwD,GAAC,iBAAiB,CAAC,aAAa,GAAC,GAAG,CAAC,CAAC;IAChG,MAAM,QAAQ,GAAC,gCAAgC,CAAC,CAAC,CAAC,QAAQ,EAAC,kBAAkB,EAAC,IAAI,CAAC,EAAC,MAAM,GAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC1H,MAAM,UAAU,GAAC,MAAM,CAAC,UAAU,GAAC,MAAM,CAAC,WAAW,EAAC,WAAW,GAAC,UAAU,GAAC,iBAAiB,CAAC,mBAAmB,CAAC;IACnH,IAAG,UAAU,GAAC,aAAa,IAAE,MAAM,CAAC,UAAU,GAAC,iBAAiB,CAAC,gBAAgB,IAAE,MAAM,CAAC,WAAW,GAAC,iBAAiB,CAAC,gBAAgB;QACtI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAE,OAAO,CAAC,CAAC,kBAAkB,KAAG,QAAQ,IAAE,CAAC,CAAC,kBAAkB,GAAC,WAAW;QAAC,MAAM,IAAI,yBAAyB,CAAC,oDAAoD,CAAC,CAAC;IAClN,MAAM,KAAK,GAAC,EAAC,OAAO,EAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,EAAC,uBAAuB,CAAC,EAAC,OAAO,EAAC,QAAQ;QAC5F,MAAM,EAAC,qBAAqB,CAAC,CAAC,CAAC,MAAM,EAAC,sBAAsB,CAAC,EAAC,iBAAiB,EAAC,EAAW;QAC3F,kBAAkB,EAAC,uBAAuB,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAC,oBAAoB,EAAC,+BAA+B,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAC7I,cAAc,EAAC,qDAAqD,CAAC,CAAC,CAAC,cAAc,CAAC,EAAC,CAAC;IAC1F,MAAM,IAAI,GAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,MAAM,KAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3E,IAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAG,+BAA+B,CAAC,EAAE,IAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAG,+BAA+B,CAAC,OAAO;QACrI,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,KAAG,iBAAiB,IAAE,IAAI,EAAE,WAAW,CAAC,IAAI,KAAG,cAAc,IAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAG,yBAAyB,IAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,IAAE,CAAC,CAAC,KAAG,CAAC;QACvM,MAAM,IAAI,yBAAyB,CAAC,gFAAgF,CAAC,CAAC;IACxH,+HAA+H;IAC/H,KAAI,MAAM,CAAC,IAAI,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,EAAC,EAAC,CAAC,EAAC,MAAM,CAAC,UAAU,GAAC,CAAC,EAAC,CAAC,EAAC,MAAM,CAAC,WAAW,GAAC,CAAC,EAAC,CAAC,EAAC,CAAC;QACzE,MAAM,CAAC,GAAC,2CAA2C,CAAC,EAAC,YAAY,EAAC,MAAM,EAAC,kBAAkB,EAAC,KAAK,CAAC,kBAAkB,EAAC,MAAM,EAAC,KAAK,CAAC,MAAM,EAAC,oBAAoB,EAAC,KAAK,CAAC,oBAAoB,EAAC,cAAc,EAAC,KAAK,CAAC,cAAc,EAAC,wBAAwB,EAAC,CAAC,EAAC,CAAC,CAAC;QAC1P,IAAG,CAAC,CAAC,qBAAqB,KAAG,CAAC,IAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,KAAG,gBAAgB;YAAC,MAAM,IAAI,yBAAyB,CAAC,0DAA0D,CAAC,CAAC;IAC/K,CAAC;IACD,MAAM,QAAQ,GAAC,CAAC,CAAC,cAAc,KAAG,SAAS,CAAA,CAAC,CAAA,SAAS,CAAA,CAAC,CAAA,eAAe,CAAC,CAAC,CAAC,cAAc,CAAyC,CAAC;IAChI,4GAA4G;IAC5G,IAAG,QAAQ;QAAC,OAAO,CAAC,QAAQ,EAAC,QAAQ,EAAC,CAAC,EAAC,CAAC,EAAC,EAAE,EAAC,CAAC,EAAC,EAAE,EAAC,EAAC,EAAC,CAAC,EAAC,MAAM,CAAC,UAAU,GAAC,EAAE,EAAC,CAAC,EAAC,EAAE,EAAC,EAAC,EAAC,CAAC,EAAC,EAAE,EAAC,CAAC,EAAC,MAAM,CAAC,WAAW,GAAC,EAAE,EAAC,EAAC,EAAC,CAAC,EAAC,MAAM,CAAC,UAAU,GAAC,EAAE,EAAC,CAAC,EAAC,MAAM,CAAC,WAAW,GAAC,EAAE,EAAC,CAAC,CAAC,CAAC;IACnK,OAAO,eAAe,CAAC,EAAC,aAAa,EAAC,yBAAyB,EAAC,QAAQ,EAAC,KAAK,EAAC,UAAU,EAAC,WAAW;QACnG,SAAS,EAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAC,SAAS,CAAC,GAAC,MAAM,CAAC,WAAW;QACnE,GAAG,CAAC,CAAC,CAAC,SAAS,KAAG,SAAS,CAAA,CAAC,CAAA,EAAE,CAAA,CAAC,CAAA,EAAC,SAAS,EAAC,CAAC;QAC3C,GAAG,CAAC,CAAC,CAAC,aAAa,KAAG,SAAS,CAAA,CAAC,CAAA,EAAE,CAAA,CAAC,CAAA,EAAC,aAAa,EAAC,CAAC;QACnD,GAAG,CAAC,QAAQ,CAAA,CAAC,CAAA,EAAC,cAAc,EAAC,QAAQ,EAAC,CAAA,CAAC,CAAA,EAAE,CAAC,EAAC,0BAA0B,EAAC,KAAc;QACpF,YAAY,EAAC,6CAAsD,EAAC,CAAC,CAAC;AAC1E,CAAC;AACD;;;GAGG;AACH,MAAM,UAAU,mCAAmC,CAAC,IAAyC;IAC3F,OAAO,IAAI,CAAC,aAAa,KAAG,SAAS,CAAA,CAAC,CAAA,oCAAoC,CAAA,CAAC,CAAA,kBAAkB,CAAC,oCAAoC,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzJ,CAAC;AACD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAqB,EAAC,QAA2B;IACnF,OAAO,8BAA8B,CAAC,KAAK,EAAC,QAAQ,EAAC,0BAA0B,CAAC,CAAC;AACnF,CAAC;AACD,8IAA8I;AAC9I,MAAM,UAAU,8BAA8B,CAAC,KAAqB,EAAC,QAA2B,EAAC,OAAyB;AACxH,oHAAoH;AACpH,UAA0B;AAC1B,qHAAqH;AACrH,UAAoC;AACpC;;;;GAIG;AACH,IAEgD;IAChD,MAAM,IAAI,GAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAG,CAAC,QAAQ,IAAE,OAAO,QAAQ,CAAC,QAAQ,KAAG,UAAU,IAAE,OAAO,QAAQ,CAAC,YAAY,KAAG,UAAU;QAAC,MAAM,IAAI,yBAAyB,CAAC,uDAAuD,CAAC,CAAC;IAC5L,MAAM,IAAI,GAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAC,YAAY,GAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAC,KAAK,GAAC,IAAI,eAAe,EAAE,CAAC;IAC1H,MAAM,MAAM,GAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAC,SAAS,GAAC,IAAI,CAAC,SAAS,IAAE,iBAAiB,CAAC,SAAS,CAAC;IACvG,MAAM,QAAQ,GAAC,IAAI,EAAE,CAAC,IAAE,CAAC,EAAC,MAAM,GAAC,QAAQ,GAAC,CAAC,IAAI,EAAE,MAAM,IAAE,MAAM,CAAC,WAAW,CAAC,EAAC,QAAQ,GAAC,IAAI,EAAE,CAAC,IAAE,CAAC,EAAC,MAAM,GAAC,QAAQ,GAAC,CAAC,IAAI,EAAE,KAAK,IAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAClJ,IAAG,QAAQ,GAAC,CAAC,IAAE,MAAM,GAAC,MAAM,CAAC,UAAU,IAAE,MAAM,IAAE,QAAQ;QAAC,MAAM,IAAI,yBAAyB,CAAC,2DAA2D,CAAC,CAAC;IAC3J,MAAM,SAAS,GAAC,MAAM,GAAC,QAAQ,EAAC,MAAM,GAAC,CAAC,MAAM,GAAC,QAAQ,CAAC,GAAC,SAAS,CAAC;IACnE,IAAI,KAAK,GAAoB,OAAO,EAAC,KAAK,GAAC,CAAC,EAAC,MAAM,GAAsB,IAAI,EAAC,KAA0C,CAAC;IACzH,SAAS,OAAO,KAAU,IAAG,MAAM,EAAC,CAAC;QAAA,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,MAAM,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAAA,CAAC,CAAA,MAAM,GAAC,IAAI,CAAC,CAAA,KAAK,GAAC,SAAS,CAAC,CAAA,CAAC;IAChO,SAAS,MAAM,KAAU,IAAG,KAAK,CAAC,MAAM,CAAC,OAAO;QAAC,MAAM,IAAI,yBAAyB,CAAC,+BAA+B,CAAC,CAAC,CAAA,CAAC;IACvH,OAAO,EAAC,IAAI,EAAC,IAAI,KAAK,KAAwB,OAAO,KAAK,CAAC,CAAA,CAAC,EAAC,IAAI,kBAAkB,KAAY,OAAO,KAAK,CAAC,CAAA,CAAC;QAC3G,KAAK,CAAC,GAAG;YACP,IAAG,KAAK,KAAG,OAAO;gBAAC,MAAM,IAAI,yBAAyB,CAAC,gCAAgC,CAAC,CAAC;YAAA,KAAK,GAAC,SAAS,CAAC;YACzG,IAAG,CAAC;gBACF,MAAM,IAAI,GAAC,UAAU,IAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBAAA,UAAU,EAAE,OAAO,EAAE,CAAC;gBAC1E,MAAM,MAAM,GAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC;gBAAA,IAAG,MAAM,CAAC,IAAI,KAAG,iBAAiB;oBAAC,MAAM,IAAI,yBAAyB,CAAC,mCAAmC,CAAC,CAAC;gBAChK,MAAM,KAAK,GAAC,gCAAgC,CAAC,MAAM,CAAC,UAAU,EAAC,MAAM,CAAC,gBAAgB,EAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBACjH,MAAM,GAAC,EAAC,IAAI,EAAC,KAAK,EAAC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAC,WAAW,EAAC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAC,sBAAsB,EAAC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAC,eAAe,EAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAC,wBAAwB,EAAC,IAAI,WAAW,CAAC,MAAM,CAAC,gBAAgB,GAAC,MAAM,CAAC,iBAAiB,CAAC,EAAC,CAAC;gBACjQ,KAAI,IAAI,CAAC,GAAC,QAAQ,EAAC,CAAC,GAAC,MAAM,EAAC,CAAC,EAAE;oBAAC,KAAI,IAAI,CAAC,GAAC,QAAQ,EAAC,CAAC,GAAC,MAAM,EAAC,CAAC,IAAE,SAAS,EAAC,CAAC;wBACxE,MAAM,EAAE,CAAC;wBAAA,MAAM,OAAO,GAAC,MAAM,CAAC,MAAM,CAAC,EAAC,SAAS,EAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAC,OAAO,EAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAC,CAAC,EAAC,CAAC,EAAC,KAAK,EAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAC,MAAM,GAAC,CAAC,CAAC,EAAC,MAAM,EAAC,CAAC,EAAC,CAAC,CAAC;wBACrJ,CAAC;4BACC,MAAM,QAAQ,GAAC,MAAM,IAAI,CAAC,OAAO,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC;4BAAA,MAAM,EAAE,CAAC;4BACzD,MAAM,IAAI,GAAC,wBAAwB,CAAC,QAAQ,EAAC,CAAC,WAAW,EAAC,SAAS,EAAC,GAAG,EAAC,GAAG,EAAC,OAAO,EAAC,QAAQ,EAAC,OAAO,CAAC,EAAC,0BAA0B,CAAC,CAAC;4BAClI,KAAI,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAmC;gCAAC,IAAG,IAAI,CAAC,GAAG,CAAC,KAAG,OAAO,CAAC,GAAG,CAAC;oCAAC,MAAM,IAAI,yBAAyB,CAAC,oCAAoC,CAAC,CAAC;4BAC9K,IAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAE,IAAI,CAAC,KAAK,CAAC,MAAM,KAAG,OAAO,CAAC,KAAK,IAAE,KAAK,CAAC,IAAI,CAAC,EAAC,MAAM,EAAC,OAAO,CAAC,KAAK,EAAC,EAAC,CAAC,CAAC,EAAC,CAAC,EAAC,EAAE,CAAA,CAAC,IAAK,IAAI,CAAC,KAAmB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;gCAAC,MAAM,IAAI,yBAAyB,CAAC,6CAA6C,CAAC,CAAC;4BAC9O,MAAM,MAAM,GAAC,IAAI,CAAC,cAAc,CAAA,CAAC,CAAA,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAC,IAAI,CAAC,cAAc,EAAC,KAAK,CAAC,IAAI,CAAC,EAAC,MAAM,EAAC,OAAO,CAAC,KAAK,EAAC,EAAC,CAAC,CAAC,EAAC,CAAC,EAAC,EAAE,CAAA,CAAC,EAAC,CAAC,EAAC,CAAC,GAAC,CAAC,GAAC,EAAE,EAAC,CAAC,EAAC,CAAC,GAAC,EAAE,EAAC,CAAC,CAAC,CAAC,CAAA,CAAC,CAAA,SAAS,CAAC;4BACpJ,2GAA2G;4BAC3G,+EAA+E;4BAC/E,MAAM,IAAI,GAAC,UAAU,IAAE,KAAK,KAAG,SAAS,CAAA,CAAC,CAAC,IAAI,CAAC,KAAmB,CAAC,GAAG,CAAC,IAAI,CAAA,EAAE,CAAA,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA,CAAC,CAAA,SAAS,CAAC;4BAC/G,MAAM,KAAK,GAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAC,CAAC,EAAC,EAAE,CAAA,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA,CAAC,CAAA,SAAS,CAAA,CAAC,CAAA,0BAA0B,CAAC,IAAI,EAAC,CAAC,GAAC,MAAM,CAAC,UAAU,GAAC,CAAC,GAAC,CAAC,EAAC,IAAI,CAAC,KAAK,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;4BACjJ,IAAG,KAAK,KAAG,SAAS,EAAC,CAAC;gCAAA,KAAK,GAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gCAAA,IAAG,KAAK;oCAAC,IAAI,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;4BAAA,CAAC;4BAAA,KAAI,MAAM,CAAC,IAAI,KAAK;gCAAC,IAAG,CAAC;oCAAC,gCAAgC,CAAC,CAAC,EAAC,KAAM,CAAC,CAAC;4BAC7I,6GAA6G;4BAC7G,MAAM,IAAI,GAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;4BAC1C,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,KAAK,CAAC,MAAM,EAAC,CAAC,EAAE,EAAC,CAAC;gCAC9B,8FAA8F;gCAC9F,MAAM,KAAK,GAAC,CAAC,GAAC,MAAM,CAAC,UAAU,GAAC,CAAC,GAAC,CAAC,EAAC,EAAE,GAAC,CAAC,CAAC,GAAC,QAAQ,CAAC,GAAC,SAAS,GAAC,CAAC,GAAC,CAAC,GAAC,QAAQ,EAAC,MAAM,GAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gCAC5F,IAAG,MAAM,EAAC,CAAC;oCACT,MAAM,CAAC,GAAC,UAAW,CAAC,OAAO,CAAC,MAAM,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;oCAClE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC,OAAO,CAAC;oCAAA,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC,cAAc,CAAC;oCAAA,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC,qBAAqB,CAAC;oCAC7H,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC,KAAK,CAAC;oCAAA,KAAK,CAAC,MAAM,CAAC,KAAK,EAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oCAAA,SAAS;gCAC9E,CAAC;gCACD,MAAM,MAAM,GAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAE,EAAC,IAAI,EAAC,KAAK,CAAC,EAAC,CAAC,GAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gCACjF,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC,OAAO,CAAC;gCAAA,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC,cAAc,CAAC;gCAAA,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC,qBAAqB,CAAC;gCAC7H,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,+BAA+B,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,IAAE,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAE,CAAC,CAAC;gCAChJ,MAAM,SAAS,GAAC,oCAAoC,CAAC,CAAC,EAAC,KAAK,CAAC,CAAC,CAAE,CAAC,cAAc,EAAC,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC;gCACpG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAC,SAAS,CAAC,CAAC;gCAC9B,UAAU,EAAE,OAAO,CAAC,KAAK,EAAC,KAAK,CAAC,CAAC,CAAE,EAAC,MAAM,EAAC,SAAS,EAAC,IAAI,CAAC,CAAC;4BAC7D,CAAC;4BACD,KAAK,EAAE,CAAC;wBACV,CAAC;wBACD,2GAA2G;wBAC3G,IAAG,IAAI,CAAC,GAAG,EAAE,IAAE,CAAC,CAAC,KAAG,MAAM,GAAC,CAAC,IAAE,CAAC,GAAC,SAAS,IAAE,MAAM,CAAC,EAAC,CAAC;4BAAA,MAAM,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;4BAAA,MAAM,EAAE,CAAC;4BAAA,IAAI,CAAC,OAAO,EAAE,CAAC;wBAAA,CAAC;oBAChH,CAAC;gBACD,MAAM,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAA,CAAC,CAAA,KAAK,CAAC,OAAO,EAAE,CAAA,CAAC,CAAA,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAAA,KAAK,GAAC,SAAS,CAAC;gBAAA,KAAK,GAAC,WAAW,CAAC;YAC7G,CAAC;YAAA,OAAM,KAAK,EAAC,CAAC;gBAAA,OAAO,EAAE,CAAC;gBAAA,IAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAC,CAAC;oBAAA,KAAK,GAAC,QAAQ,CAAC;oBAAA,KAAK,CAAC,KAAK,EAAE,CAAC;gBAAA,CAAC;gBAAA,MAAM,KAAK,CAAC;YAAA,CAAC;QAC/F,CAAC;QACD,MAAM,KAAU,IAAG,KAAK,KAAG,OAAO,IAAE,KAAK,KAAG,SAAS,IAAE,KAAK,KAAG,WAAW,EAAC,CAAC;YAAA,KAAK,GAAC,WAAW,CAAC;YAAA,KAAK,CAAC,KAAK,EAAE,CAAC;YAAA,OAAO,EAAE,CAAC;QAAA,CAAC,CAAA,CAAC;QACxH,OAAO,KAAU,IAAG,KAAK,KAAG,aAAa,EAAC,CAAC;YAAA,KAAK,GAAC,UAAU,CAAC;YAAA,KAAK,CAAC,KAAK,EAAE,CAAC;YAAA,OAAO,EAAE,CAAC;QAAA,CAAC,CAAA,CAAC;QACtF,UAAU,KAAqB,IAAG,KAAK,KAAG,WAAW,IAAE,CAAC,MAAM;YAAC,MAAM,IAAI,yBAAyB,CAAC,gCAAgC,CAAC,CAAC,CAAA,MAAM,MAAM,GAAC,MAAM,CAAC,CAAA,MAAM,GAAC,IAAI,CAAC,CAAA,KAAK,GAAC,SAAS,CAAC,CAAA,KAAK,GAAC,aAAa,CAAC,CAAA,OAAO,MAAM,CAAC,CAAA,CAAC;KACzN,CAAC;AACJ,CAAC","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 = 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"]}

package/dist/core/version.d.ts

@@ -6,4 +6,4 @@
  * own versions. Release checks confirm it matches package.json and the packed package.
  * @see docs/RELEASE_1_0_1.md
  */
-export declare const ENGINE_API_VERSION: "2.2.0";
+export declare const ENGINE_API_VERSION: "2.3.0";

package/dist/core/version.js

@@ -7,5 +7,5 @@
  * own versions. Release checks confirm it matches package.json and the packed package.
  * @see docs/RELEASE_1_0_1.md
  */
-export const ENGINE_API_VERSION = "2.2.0";
+export const ENGINE_API_VERSION = "2.3.0";
 //# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAgB,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Version of the engine release. Since 1.0.1 it equals the npm package version.\n *\n * New captures and plans record this version as their creator. Archived records keep the\n * version they were made with. Proof-of-concept (POC), schema and model contracts have their\n * own versions. Release checks confirm it matches package.json and the packed package.\n * @see docs/RELEASE_1_0_1.md\n */\nexport const ENGINE_API_VERSION = \"2.2.0\" as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAgB,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Version of the engine release. Since 1.0.1 it equals the npm package version.\n *\n * New captures and plans record this version as their creator. Archived records keep the\n * version they were made with. Proof-of-concept (POC), schema and model contracts have their\n * own versions. Release checks confirm it matches package.json and the packed package.\n * @see docs/RELEASE_1_0_1.md\n */\nexport const ENGINE_API_VERSION = \"2.3.0\" as const;\n"]}

package/dist/equipment/generic-prime-lenses.d.ts

@@ -0,0 +1,46 @@
+/** Full-frame-equivalent focal lengths of the generic prime family, mm. */
+export declare const GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM: readonly [10, 12, 14, 16, 20, 24, 28, 35, 40, 50, 85, 105, 135, 200, 300, 400, 500, 600, 800, 1200];
+export type GenericPrimeEquivalentFocalLengthMm = typeof GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM[number];
+/**
+ * The marked third-stop f-numbers (the conventional rounded values of N = 2^(k/6), k = 0, 1, …), from f/1 to f/32.
+ * A lens's `fNumbers` are those within its range; any f-number inside the range is accepted.
+ */
+export declare const GENERIC_PRIME_THIRD_STOP_F_NUMBERS: readonly [1, 1.1, 1.2, 1.4, 1.6, 1.8, 2, 2.2, 2.5, 2.8, 3.2, 3.5, 4, 4.5, 5, 5.6, 6.3, 7.1, 8, 9, 10, 11, 13, 14, 16, 18, 20, 22, 25, 29, 32];
+/** Minimum focus rule: the object distance at this magnification, but at least `minimumDistanceM`. */
+export declare const GENERIC_PRIME_MINIMUM_FOCUS: Readonly<{
+    magnification: 0.15;
+    minimumDistanceM: 0.1;
+}>;
+export interface GenericPrimeLens {
+    /** Public opaque id, for example "generic-prime-50mm-equivalent". */
+    lensId: string;
+    equivalentFocalLengthMm: GenericPrimeEquivalentFocalLengthMm;
+    /** Physical focal length for this sensor: equivalent ÷ crop factor. */
+    focalLengthMm: number;
+    /** Diagonal crop factor of the sensor (36 × 24 mm = 1). */
+    cropFactor35Mm: number;
+    /** Widest aperture (smallest f-number) and narrowest aperture. */
+    widestFNumber: number;
+    narrowestFNumber: number;
+    /** The marked third-stop f-numbers within the range. */
+    fNumbers: readonly number[];
+    /** max(0.10 m, f·(1 + 1/0.15)), metres from the lens (thin lens). */
+    minimumFocusDistanceM: number;
+    /** Magnification at the minimum focus distance, f/(d − f). */
+    maximumMagnification: number;
+    scientificStatus: "approximation";
+    limitations: readonly string[];
+}
+/** Minimum focus distance of a generic prime of physical focal length `focalLengthMm`: max(0.10 m, f·(1 + 1/0.15)). */
+export declare function calculateGenericPrimeMinimumFocusDistanceM(focalLengthMm: number): number;
+/**
+ * Resolves a generic prime for a sensor: its actual focal length, f-number range, marked f-numbers and minimum focus.
+ * `activeImagingArea` is the sensor's active capture area in millimetres.
+ */
+export declare function resolveGenericPrimeLens(input: {
+    equivalentFocalLengthMm: number;
+    activeImagingArea: {
+        widthMm: number;
+        heightMm: number;
+    };
+}): GenericPrimeLens;

package/dist/equipment/generic-prime-lenses.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Generic prime lens family (2.3): educational lenses named by their full-frame-equivalent focal length,
+ * written for this engine. They are not real products and carry no brand. Each lens is defined by three
+ * rules only:
+ * - actual focal length = equivalent focal length ÷ the sensor's diagonal crop factor
+ *   (`calculateEquivalentFocalLength35Mm`, 36 × 24 mm reference);
+ * - an f-number range by focal-length class (widest aperture) and focal length (narrowest aperture);
+ * - a minimum focus distance max(0.10 m, f·(1 + 1/0.15)): the thin-lens object distance at 0.15×
+ *   magnification (d = f(1 + 1/m)), but never closer than 10 cm. A generic thin-lens approximation, not a
+ *   measured lens.
+ * @see docs/QUICK_START.md, "Generic prime lenses".
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { requireInputKeys, requireInputObject } from "../core/record-validation.js";
+import { calculateEquivalentFocalLength35Mm } from "../camera/equivalent-focal-length.js";
+/** Full-frame-equivalent focal lengths of the generic prime family, mm. */
+export const GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM = Object.freeze([10, 12, 14, 16, 20, 24, 28, 35, 40, 50, 85, 105, 135, 200, 300, 400, 500, 600, 800, 1200]);
+/**
+ * The marked third-stop f-numbers (the conventional rounded values of N = 2^(k/6), k = 0, 1, …), from f/1 to f/32.
+ * A lens's `fNumbers` are those within its range; any f-number inside the range is accepted.
+ */
+export const GENERIC_PRIME_THIRD_STOP_F_NUMBERS = Object.freeze([1, 1.1, 1.2, 1.4, 1.6, 1.8, 2, 2.2, 2.5, 2.8, 3.2, 3.5, 4, 4.5, 5, 5.6, 6.3, 7.1, 8, 9, 10, 11,
+    13, 14, 16, 18, 20, 22, 25, 29, 32]);
+/** Minimum focus rule: the object distance at this magnification, but at least `minimumDistanceM`. */
+export const GENERIC_PRIME_MINIMUM_FOCUS = Object.freeze({ magnification: 0.15, minimumDistanceM: 0.1 });
+/** Widest f-number by equivalent focal length (inclusive upper bounds of each class). */
+const WIDEST = [[16, 2.8], [28, 1.8], [85, 1.4], [135, 2], [300, 2.8], [600, 4], [800, 5.6], [1200, 8]];
+/** Narrowest f-number by equivalent focal length. */
+const NARROWEST = [[16, 16], [135, 22], [1200, 32]];
+/** Minimum focus distance of a generic prime of physical focal length `focalLengthMm`: max(0.10 m, f·(1 + 1/0.15)). */
+export function calculateGenericPrimeMinimumFocusDistanceM(focalLengthMm) {
+    if (typeof focalLengthMm !== "number" || !Number.isFinite(focalLengthMm) || focalLengthMm <= 0)
+        throw new InvalidConfigurationError("focalLengthMm must be a positive finite number.");
+    return Math.max(GENERIC_PRIME_MINIMUM_FOCUS.minimumDistanceM, focalLengthMm / 1000 * (1 + 1 / GENERIC_PRIME_MINIMUM_FOCUS.magnification));
+}
+/**
+ * Resolves a generic prime for a sensor: its actual focal length, f-number range, marked f-numbers and minimum focus.
+ * `activeImagingArea` is the sensor's active capture area in millimetres.
+ */
+export function resolveGenericPrimeLens(input) {
+    requireInputObject(input, "resolveGenericPrimeLens input");
+    requireInputKeys(input, "resolveGenericPrimeLens", ["equivalentFocalLengthMm", "activeImagingArea"]);
+    const equivalent = input.equivalentFocalLengthMm;
+    if (!GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM.includes(equivalent))
+        throw new InvalidConfigurationError("equivalentFocalLengthMm must be one of the generic primes: " + GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM.join(", ") + " mm.");
+    requireInputObject(input.activeImagingArea, "activeImagingArea");
+    const crop = calculateEquivalentFocalLength35Mm({ focalLengthMm: 1, activeImagingArea: { widthMm: input.activeImagingArea.widthMm, heightMm: input.activeImagingArea.heightMm } }).value.cropFactor35Mm;
+    const focalLengthMm = equivalent / crop;
+    const widest = WIDEST.find(([bound]) => equivalent <= bound)[1], narrowest = NARROWEST.find(([bound]) => equivalent <= bound)[1];
+    const minimumFocusDistanceM = calculateGenericPrimeMinimumFocusDistanceM(focalLengthMm), f = focalLengthMm / 1000;
+    return Object.freeze({ lensId: "generic-prime-" + equivalent + "mm-equivalent", equivalentFocalLengthMm: equivalent, focalLengthMm,
+        cropFactor35Mm: crop, widestFNumber: widest, narrowestFNumber: narrowest,
+        fNumbers: Object.freeze(GENERIC_PRIME_THIRD_STOP_F_NUMBERS.filter((n) => n >= widest && n <= narrowest)), minimumFocusDistanceM,
+        maximumMagnification: f / (minimumFocusDistanceM - f), scientificStatus: "approximation",
+        limitations: Object.freeze(["Generic educational prime defined by focal length, f-number range and a thin-lens minimum-focus rule; not a real product.",
+            "Minimum focus max(0.10 m, f·(1 + 1/0.15)) is a thin-lens approximation measured from the lens; real lenses differ (internal focusing, pupil positions, focus breathing)."]) });
+}
+//# sourceMappingURL=generic-prime-lenses.js.map

package/dist/equipment/generic-prime-lenses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-prime-lenses.js","sourceRoot":"","sources":["../../src/equipment/generic-prime-lenses.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Generic prime lens family (2.3): educational lenses named by their full-frame-equivalent focal length,\n * written for this engine. They are not real products and carry no brand. Each lens is defined by three\n * rules only:\n * - actual focal length = equivalent focal length ÷ the sensor's diagonal crop factor\n *   (`calculateEquivalentFocalLength35Mm`, 36 × 24 mm reference);\n * - an f-number range by focal-length class (widest aperture) and focal length (narrowest aperture);\n * - a minimum focus distance max(0.10 m, f·(1 + 1/0.15)): the thin-lens object distance at 0.15×\n *   magnification (d = f(1 + 1/m)), but never closer than 10 cm. A generic thin-lens approximation, not a\n *   measured lens.\n * @see docs/QUICK_START.md, \"Generic prime lenses\".\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { requireInputKeys, requireInputObject } from \"../core/record-validation.js\";\nimport { calculateEquivalentFocalLength35Mm } from \"../camera/equivalent-focal-length.js\";\n\n/** Full-frame-equivalent focal lengths of the generic prime family, mm. */\nexport const GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM = Object.freeze([10, 12, 14, 16, 20, 24, 28, 35, 40, 50, 85, 105, 135, 200, 300, 400, 500, 600, 800, 1200] as const);\nexport type GenericPrimeEquivalentFocalLengthMm = typeof GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM[number];\n/**\n * The marked third-stop f-numbers (the conventional rounded values of N = 2^(k/6), k = 0, 1, …), from f/1 to f/32.\n * A lens's `fNumbers` are those within its range; any f-number inside the range is accepted.\n */\nexport const GENERIC_PRIME_THIRD_STOP_F_NUMBERS = Object.freeze([1, 1.1, 1.2, 1.4, 1.6, 1.8, 2, 2.2, 2.5, 2.8, 3.2, 3.5, 4, 4.5, 5, 5.6, 6.3, 7.1, 8, 9, 10, 11,\n  13, 14, 16, 18, 20, 22, 25, 29, 32] as const);\n/** Minimum focus rule: the object distance at this magnification, but at least `minimumDistanceM`. */\nexport const GENERIC_PRIME_MINIMUM_FOCUS = Object.freeze({ magnification: 0.15, minimumDistanceM: 0.1 });\n\n/** Widest f-number by equivalent focal length (inclusive upper bounds of each class). */\nconst WIDEST: readonly (readonly [number, number])[] = [[16, 2.8], [28, 1.8], [85, 1.4], [135, 2], [300, 2.8], [600, 4], [800, 5.6], [1200, 8]];\n/** Narrowest f-number by equivalent focal length. */\nconst NARROWEST: readonly (readonly [number, number])[] = [[16, 16], [135, 22], [1200, 32]];\n\nexport interface GenericPrimeLens {\n  /** Public opaque id, for example \"generic-prime-50mm-equivalent\". */\n  lensId: string;\n  equivalentFocalLengthMm: GenericPrimeEquivalentFocalLengthMm;\n  /** Physical focal length for this sensor: equivalent ÷ crop factor. */\n  focalLengthMm: number;\n  /** Diagonal crop factor of the sensor (36 × 24 mm = 1). */\n  cropFactor35Mm: number;\n  /** Widest aperture (smallest f-number) and narrowest aperture. */\n  widestFNumber: number;\n  narrowestFNumber: number;\n  /** The marked third-stop f-numbers within the range. */\n  fNumbers: readonly number[];\n  /** max(0.10 m, f·(1 + 1/0.15)), metres from the lens (thin lens). */\n  minimumFocusDistanceM: number;\n  /** Magnification at the minimum focus distance, f/(d − f). */\n  maximumMagnification: number;\n  scientificStatus: \"approximation\";\n  limitations: readonly string[];\n}\n\n/** Minimum focus distance of a generic prime of physical focal length `focalLengthMm`: max(0.10 m, f·(1 + 1/0.15)). */\nexport function calculateGenericPrimeMinimumFocusDistanceM(focalLengthMm: number): number {\n  if (typeof focalLengthMm !== \"number\" || !Number.isFinite(focalLengthMm) || focalLengthMm <= 0) throw new InvalidConfigurationError(\"focalLengthMm must be a positive finite number.\");\n  return Math.max(GENERIC_PRIME_MINIMUM_FOCUS.minimumDistanceM, focalLengthMm / 1000 * (1 + 1 / GENERIC_PRIME_MINIMUM_FOCUS.magnification));\n}\n\n/**\n * Resolves a generic prime for a sensor: its actual focal length, f-number range, marked f-numbers and minimum focus.\n * `activeImagingArea` is the sensor's active capture area in millimetres.\n */\nexport function resolveGenericPrimeLens(input: { equivalentFocalLengthMm: number; activeImagingArea: { widthMm: number; heightMm: number } }): GenericPrimeLens {\n  requireInputObject(input, \"resolveGenericPrimeLens input\");\n  requireInputKeys(input, \"resolveGenericPrimeLens\", [\"equivalentFocalLengthMm\", \"activeImagingArea\"]);\n  const equivalent = input.equivalentFocalLengthMm;\n  if (!(GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM as readonly number[]).includes(equivalent))\n    throw new InvalidConfigurationError(\"equivalentFocalLengthMm must be one of the generic primes: \" + GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM.join(\", \") + \" mm.\");\n  requireInputObject(input.activeImagingArea, \"activeImagingArea\");\n  const crop = calculateEquivalentFocalLength35Mm({ focalLengthMm: 1, activeImagingArea: { widthMm: input.activeImagingArea.widthMm, heightMm: input.activeImagingArea.heightMm } }).value.cropFactor35Mm;\n  const focalLengthMm = equivalent / crop;\n  const widest = WIDEST.find(([bound]) => equivalent <= bound)![1], narrowest = NARROWEST.find(([bound]) => equivalent <= bound)![1];\n  const minimumFocusDistanceM = calculateGenericPrimeMinimumFocusDistanceM(focalLengthMm), f = focalLengthMm / 1000;\n  return Object.freeze({ lensId: \"generic-prime-\" + equivalent + \"mm-equivalent\", equivalentFocalLengthMm: equivalent as GenericPrimeEquivalentFocalLengthMm, focalLengthMm,\n    cropFactor35Mm: crop, widestFNumber: widest, narrowestFNumber: narrowest,\n    fNumbers: Object.freeze(GENERIC_PRIME_THIRD_STOP_F_NUMBERS.filter((n) => n >= widest && n <= narrowest)), minimumFocusDistanceM,\n    maximumMagnification: f / (minimumFocusDistanceM - f), scientificStatus: \"approximation\" as const,\n    limitations: Object.freeze([\"Generic educational prime defined by focal length, f-number range and a thin-lens minimum-focus rule; not a real product.\",\n      \"Minimum focus max(0.10 m, f·(1 + 1/0.15)) is a thin-lens approximation measured from the lens; real lenses differ (internal focusing, pupil positions, focus breathing).\"]) });\n}\n"]}

package/dist/facade/chart-scenes.d.ts

@@ -24,6 +24,13 @@ export interface SiemensStarChartScene {
     lightReflectance?: number;
     /** Reflectance outside the star. Default 0.18. */
     backgroundReflectance?: number;
+    /**
+     * 2.3: angular reflectance profile. `bar` (default): square-wave sectors. `sine`: a sinusoidal star,
+     * R(θ) = mid + amp·sin(2π·cycles·(θ/2π + ½)) between the dark and light reflectances, zero crossings at
+     * the bar star's sector edges, quantized to {@link CHART_CONTINUOUS_LEVELS} levels. Reported in the
+     * parameters only when given, so 2.2 scene digests are unchanged.
+     */
+    profile?: "bar" | "sine";
 }
 export interface StepWedgeChartScene {
     preset: "step-wedge";
@@ -70,9 +77,146 @@ export interface PatchChartScene {
     gapFraction?: number;
     backgroundReflectance?: number;
 }
-export type ChartScene = UniformChartScene | SlantedEdgeChartScene | SiemensStarChartScene | StepWedgeChartScene | GreyRampChartScene | CheckerboardChartScene | PointGridChartScene | PatchChartScene;
+/**
+ * 2.3: seeded dead-leaves texture (Matheron's random closed set model, in the scale-invariant form used for
+ * camera texture measurement by Cao, Guichard and Hornung): opaque disks with Poisson-distributed centres,
+ * radius density ∝ r⁻³ on [radiusMinimum, radiusMaximum] and a grey drawn uniformly in [minimum, maximum]
+ * reflectance. Disks are drawn in order with earlier disks on top until every point of the chart (plus 0.1
+ * frame units around it) is covered, which samples the stationary dead-leaves image exactly (Kendall and
+ * Thönnes' backward "perfect simulation"). Radii are in frame units (fraction of the frame half-width).
+ */
+export interface DeadLeavesChartScene {
+    preset: "dead-leaves";
+    /** Smallest disk radius, frame units, [0.002, radiusMaximum). Default 0.01. */
+    radiusMinimum?: number;
+    /** Largest disk radius, frame units, (radiusMinimum, 2]. Default 0.5. */
+    radiusMaximum?: number;
+    /** Grey range (neutral reflectances). Defaults 0.2 and 0.6. */
+    minimumReflectance?: number;
+    maximumReflectance?: number;
+    /** Random seed (uint32); the same seed gives the same disks on every platform. Default 1. */
+    seed?: number;
+}
+/**
+ * 2.3: groups of three dark bars on a light plate (the three-bar concept of the US Air Force 1951 target,
+ * a US-government publication, in the engine's own arrangement): one group per frequency, vertical bars (horizontal resolution)
+ * in the upper row and horizontal bars (vertical resolution) below, optionally labelled with engine-drawn
+ * seven-segment numerals. Frequencies are line widths per picture height (LW/PH, as in ISO 12233), where
+ * the picture height is the chart's height: one bar is PH/LW wide.
+ */
+export interface BarGroupsChartScene {
+    preset: "bar-groups";
+    /** One group per entry, left to right: integers 1..100000. Default [100, 200, 400, 800]. 1..32 entries. */
+    lineWidthsPerPictureHeight?: readonly number[];
+    /** Draw each group's LW/PH value below it. Default true. */
+    numerals?: boolean;
+    darkReflectance?: number;
+    lightReflectance?: number;
+}
+/**
+ * 2.3: hyperbolic wedge: `lineCount` dark lines separated by light gaps of the same width, whose width
+ * shrinks along the wedge axis so that the frequency rises linearly from the minimum to the maximum LW/PH.
+ * The line edges are hyperbolas. `horizontal`: the axis runs left to right and the lines are nearly
+ * horizontal (vertical resolution); `vertical`: the axis runs bottom to top (horizontal resolution).
+ */
+export interface HyperbolicWedgeChartScene {
+    preset: "hyperbolic-wedge";
+    orientation?: "horizontal" | "vertical";
+    /** Dark lines, 1..50. Default 5. */
+    lineCount?: number;
+    /** LW/PH at the start and end of the axis. Defaults 100 and 1000. */
+    minimumLineWidthsPerPictureHeight?: number;
+    maximumLineWidthsPerPictureHeight?: number;
+    darkReflectance?: number;
+    lightReflectance?: number;
+}
+/**
+ * 2.3: circular zone plate R(r) = mid + amp·cos(π·k·r²): the local frequency k·r rises linearly from 0 at
+ * the centre to `maximumCyclesPerPictureHeight` at the rim (the quadratic-phase chirp of a Fresnel zone
+ * plate). Quantized to {@link CHART_CONTINUOUS_LEVELS} levels.
+ */
+export interface ZonePlateChartScene {
+    preset: "zone-plate";
+    /** Plate radius as a fraction of the frame half-height, (0, 1]. Default 0.9. */
+    radiusFraction?: number;
+    /** Frequency at the rim, cycles per picture height. Default 200. */
+    maximumCyclesPerPictureHeight?: number;
+    darkReflectance?: number;
+    lightReflectance?: number;
+    backgroundReflectance?: number;
+}
+/**
+ * 2.3: a field of dark squares rotated clockwise by `angleDegrees` on a light background, one centred in
+ * each of columns × rows equal cells: every square gives two near-vertical and two near-horizontal slanted
+ * edges (Burns, PICS 2000). See {@link calculateSlantedSquareEdges}.
+ */
+export interface SlantedSquaresChartScene {
+    preset: "slanted-squares";
+    columns?: number;
+    rows?: number;
+    /** Square side as a fraction of the smaller cell side, (0, 1); the rotated square must stay in its cell. Default 0.5. */
+    sizeFraction?: number;
+    /** Clockwise rotation, degrees, in (-45, 45). Default 5. */
+    angleDegrees?: number;
+    /** Square (dark) and background (light) reflectances. Defaults 0.15 and 0.6 (4:1). */
+    darkReflectance?: number;
+    lightReflectance?: number;
+}
+/** 2.3: straight lines at every multiple of `spacing` from the centre in u and v (a distortion and registration grid). */
+export interface LineGridChartScene {
+    preset: "line-grid";
+    /** Distance between lines, frame units, (0, 2]. Default 1/3 (six cells across). */
+    spacing?: number;
+    /** Line width, frame units, (0, spacing). Default 0.01. */
+    lineWidth?: number;
+    lineReflectance?: number;
+    backgroundReflectance?: number;
+}
+/** 2.3: registration fiducial: a 2 × 2 checker disk inside a dark ring; `inverted` swaps the checker phase (an orientation cue). */
+export interface FiducialChartScene {
+    preset: "fiducial";
+    /** Disk radius as a fraction of the frame half-height, (0, 1]. Default 0.8. */
+    radiusFraction?: number;
+    /** Ring width as a fraction of the radius, (0, 1). Default 0.18. */
+    ringFraction?: number;
+    /** Default false: the upper-right and lower-left quadrants are dark. */
+    inverted?: boolean;
+    darkReflectance?: number;
+    lightReflectance?: number;
+    backgroundReflectance?: number;
+}
+/** Any chart preset except `composite`: a composite's background or element. */
+export type ChartElementScene = UniformChartScene | SlantedEdgeChartScene | SiemensStarChartScene | StepWedgeChartScene | GreyRampChartScene | CheckerboardChartScene | PointGridChartScene | PatchChartScene | DeadLeavesChartScene | BarGroupsChartScene | HyperbolicWedgeChartScene | ZonePlateChartScene | SlantedSquaresChartScene | LineGridChartScene | FiducialChartScene;
+/**
+ * One element of a composite chart: a preset drawn inside its placement rectangle (frame units of the
+ * composite). The element sees its own frame: u = ±1 at the rectangle's left and right edges, aspect =
+ * height / width, and LW/PH frequencies still refer to the composite's picture height.
+ */
+export interface CompositeChartElement {
+    scene: ChartElementScene;
+    centerU: number;
+    centerV: number;
+    width: number;
+    height: number;
+    /** `rectangle` (default) or `ellipse` inscribed in the rectangle; outside it, earlier elements or the background show. */
+    mask?: "rectangle" | "ellipse";
+}
+/**
+ * 2.3: an ordered list of elements over a background. Later elements cover earlier ones. The engine
+ * provides only the generic parts; a branded or product-specific layout stays in the application.
+ */
+export interface CompositeChartScene {
+    preset: "composite";
+    /** Fills the whole composite frame. Default `{ preset: "uniform", reflectance: 0.18 }`. */
+    background?: ChartElementScene;
+    /** 1..256 elements, drawn in order. */
+    elements: readonly CompositeChartElement[];
+}
+export type ChartScene = ChartElementScene | CompositeChartScene;
 export type ChartScenePresetId = ChartScene["preset"];
 export declare const CHART_SCENE_PRESETS: readonly ChartScenePresetId[];
+/** Neutral levels that represent a continuous pattern (grey ramp; 2.3 sine star, zone plate and dead-leaves greys). */
+export declare const CHART_CONTINUOUS_LEVELS = 1024;
 /** Engine-chosen chart parameters, each reported when the caller omitted it. */
 export declare const CHART_SCENE_DEFAULTS: Readonly<{
     uniform: Readonly<{
@@ -116,6 +260,62 @@ export declare const CHART_SCENE_DEFAULTS: Readonly<{
         gapFraction: 0.1;
         backgroundReflectance: 0.18;
     }>;
+    "dead-leaves": Readonly<{
+        radiusMinimum: 0.01;
+        radiusMaximum: 0.5;
+        minimumReflectance: 0.2;
+        maximumReflectance: 0.6;
+        seed: 1;
+    }>;
+    "bar-groups": Readonly<{
+        lineWidthsPerPictureHeight: readonly number[];
+        numerals: true;
+        darkReflectance: 0.05;
+        lightReflectance: 0.8;
+    }>;
+    "hyperbolic-wedge": Readonly<{
+        orientation: "horizontal";
+        lineCount: 5;
+        minimumLineWidthsPerPictureHeight: 100;
+        maximumLineWidthsPerPictureHeight: 1000;
+        darkReflectance: 0.05;
+        lightReflectance: 0.8;
+    }>;
+    "zone-plate": Readonly<{
+        radiusFraction: 0.9;
+        maximumCyclesPerPictureHeight: 200;
+        darkReflectance: 0.1;
+        lightReflectance: 0.7;
+        backgroundReflectance: 0.18;
+    }>;
+    "slanted-squares": Readonly<{
+        columns: 3;
+        rows: 2;
+        sizeFraction: 0.5;
+        angleDegrees: 5;
+        darkReflectance: 0.15;
+        lightReflectance: 0.6;
+    }>;
+    "line-grid": Readonly<{
+        spacing: number;
+        lineWidth: 0.01;
+        lineReflectance: 0.42;
+        backgroundReflectance: 0.6;
+    }>;
+    fiducial: Readonly<{
+        radiusFraction: 0.8;
+        ringFraction: 0.18;
+        inverted: false;
+        darkReflectance: 0.05;
+        lightReflectance: 0.8;
+        backgroundReflectance: 0.18;
+    }>;
+    composite: Readonly<{
+        background: Readonly<{
+            preset: "uniform";
+            reflectance: 0.18;
+        }>;
+    }>;
 }>;
 /** A validated chart: every parameter resolved, plus which ones came from {@link CHART_SCENE_DEFAULTS}. */
 export interface ResolvedChartScene {
@@ -148,6 +348,11 @@ export declare const CHART_SPECTRAL_RANGE_NANOMETERS: Readonly<{
     minimum: 380;
     maximum: 780;
 }>;
+/**
+ * Internal (not exported from the package): the caller input behind each material of a resolved chart, in
+ * material order (`undefined` for an engine neutral). The facade hashes caller spectra from these inputs.
+ */
+export declare function chartMaterialInputs(chart: ResolvedChartScene): readonly unknown[];
 /**
  * Validates a chart description and resolves every default. `aspect` is the frame height/width. Unknown
  * fields are rejected so that a mistyped parameter never silently falls back to a default.
@@ -156,6 +361,70 @@ export declare function resolveChartScene(input: {
     scene: ChartScene;
     aspect: number;
 }): ResolvedChartScene;
+/** An axis-aligned rectangle in chart frame units: u0 ≤ u ≤ u1, v0 ≤ v ≤ v1. */
+export interface ChartRectangle {
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+}
+/** One bar group of a `bar-groups` chart or composite element, in the chart's frame units. */
+export interface ChartBarGroupTarget {
+    /** Composite element index, or null for a plain `bar-groups` chart. */
+    elementIndex: number | null;
+    lineWidthsPerPictureHeight: number;
+    /** Line pairs (cycles) per picture height: LW/PH ÷ 2. */
+    cyclesPerPictureHeight: number;
+    /** Width of one bar, frame units. */
+    lineWidth: number;
+    /** The three vertical bars (horizontal resolution) and the three horizontal bars (vertical resolution). */
+    verticalBars: ChartRectangle;
+    horizontalBars: ChartRectangle;
+}
+/**
+ * The bar groups of a `bar-groups` chart, or of every `bar-groups` element of a composite, in the chart's
+ * frame units (2.3). `aspect` is the chart's height / width, as for {@link resolveChartScene}.
+ */
+export declare function calculateBarGroupTargets(input: {
+    scene: ChartScene;
+    aspect: number;
+}): ChartBarGroupTarget[];
+/** One square of a `slanted-squares` chart and its four edges, in the chart's frame units. */
+export interface ChartSlantedSquare {
+    elementIndex: number | null;
+    center: {
+        u: number;
+        v: number;
+    };
+    /** Side length, frame units. */
+    side: number;
+    /** Clockwise rotation, degrees. */
+    angleDegrees: number;
+    darkReflectance: number;
+    lightReflectance: number;
+    /** `left`/`right` edges are near-vertical (horizontal MTF), `top`/`bottom` near-horizontal (vertical MTF). */
+    edges: {
+        side: "left" | "right" | "top" | "bottom";
+        midpoint: {
+            u: number;
+            v: number;
+        };
+        direction: {
+            u: number;
+            v: number;
+        };
+        length: number;
+    }[];
+}
+/**
+ * Squares and edges of a `slanted-squares` chart, or of every `slanted-squares` element of a composite, in
+ * the chart's frame units (2.3), for slanted-edge regions of interest (Burns, PICS 2000). Directions are unit
+ * vectors along each edge (u right, v up).
+ */
+export declare function calculateSlantedSquareEdges(input: {
+    scene: ChartScene;
+    aspect: number;
+}): ChartSlantedSquare[];
 /**
  * Step reflectances of a step wedge. `equal-density` spaces optical density D = -log10(R) evenly, which
  * gives geometric reflectance steps, as on a photographic step tablet. `linear` spaces reflectance evenly.