@forgeax/engine-render 0.1.19 → 0.1.20

package/dist/chunk-M2MP4ZOU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/record/frame-snapshot.ts"],"names":[],"mappings":"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","file":"chunk-M2MP4ZOU.mjs","sourcesContent":["// @forgeax/engine-runtime - RenderSystem record stage: frame-snapshot.\n// Extracted from render-system-record.ts (feat-20260704 M3/w17, pure move).\n\nimport type { World } from '@forgeax/engine-ecs';\nimport { vec3 } from '@forgeax/engine-math';\nimport type { ResolvedColorTargetDescriptor } from '@forgeax/engine-render-graph';\nimport type { Texture } from '@forgeax/engine-rhi';\nimport type { ClusterBinScratch } from '../cluster-binner';\nimport type { EnvironmentGeneration } from '../environment/generation';\nimport type { EnvironmentLifecycle } from '../environment/lifecycle';\nimport type { GpuBuffer } from '../gpu-resource';\nimport type { TemporalGpuState } from '../temporal/gpu';\nimport type { TemporalView } from '../temporal/view';\n\nexport type TemporalCommitOutcome =\n  | { readonly kind: 'none' }\n  | { readonly kind: 'off'; readonly view: TemporalView }\n  | { readonly kind: 'taa'; readonly view: TemporalView };\n\n/**\n * feat-20260708-composited-multi-world-rendering M1 / D-1 / D-9:\n * worldId-entityKey composite key helper. Formula: `worldId * 2^32 + entityKey`.\n *\n * worldId is the index into `worlds[]` (the `draw` call argument). entityKey\n * is the packed Entity u32 (encodeEntity(indexSlot, generation)) surfaced\n * through `RenderableSnapshot.entityKey`.\n *\n * Key properties:\n *   - worldId=0 identity: `worldEntityKey(0, k) === k` — single-world path\n *     cache behavior is bit-for-bit unchanged (AC-03 regression guarantee).\n *   - JS safe integer: worldId < 2^21 keeps the composite key below\n *     Number.MAX_SAFE_INTEGER (2^53).\n *   - SSOT: all cache-key compositing consumers import this single helper;\n *     no inline `worldId * 2^32 + k` duplication (D-9).\n *\n * @internal — exported for unit test + glyph/tilemap/record consumers;\n * not part of the public @forgeax/engine-runtime API surface.\n */\nexport function worldEntityKey(worldId: number, entityKey: number): number {\n  return worldId * 4294967296 + entityKey; // 2^32 = 4294967296\n}\n\n/**\n * Cross-frame cache entry for a material bind group whose source material and\n * all resolved GPU resources are stable. The material snapshot identity is\n * the extract-layer invalidation token; the builder only stores entries after\n * all explicit resource handles resolved to resident GPU objects.\n */\nexport interface MaterialBgAssemblyCacheEntry {\n  readonly material: MaterialSnapshot;\n  /** Invalidates when a texture/sampler residency identity changes. */\n  readonly materialResourceEpoch: number;\n  readonly materialBgl: BindGroupLayout;\n  /** Buffer identity changes when the shared material capacity grows. */\n  readonly materialBuffer: Buffer;\n  readonly skylightResources: SkylightBindGroupResources;\n  readonly bindGroup: BindGroup;\n}\n\nimport type { CompiledRenderGraph } from '@forgeax/engine-render-graph';\nimport type { BindGroup, BindGroupLayout, Buffer, TextureView } from '@forgeax/engine-rhi';\nimport type { MaterialRenderState, RenderPipelineAsset } from '@forgeax/engine-types';\nimport type { MeshGpuHandles } from '../device/gpu-residency';\nimport type { SkylightBindGroupResources } from '../ibl/skylight-bind-group';\nimport type { InstanceBufferCacheEntry } from '../instance-buffer-cache';\nimport type { CameraSnapshot, VolumetricFogFrameContext } from '../render-contract';\nimport type { RenderPipeline as RenderPipelineDef, RenderPipelineFrame } from '../render-pipeline';\nimport type {\n  DispatchEntry,\n  MaterialSnapshot,\n  PointShadowSnapshot,\n  RenderableSnapshot,\n  SpotLightSnapshot,\n} from '../render-system-extract';\nimport type { ShadowAtlas } from '../shadow-atlas';\nimport type {\n  TemporalFrame,\n  TemporalFrameInput,\n  TemporalFrameTransaction,\n} from '../temporal/frame';\nimport type { VolumetricFogInspection } from '../volume/inspection';\nimport type { VolumeTemporalSignature } from '../volume/temporal';\n\n/**\n * feat-20260608-create-app-param-surface-trim / M1 / D-8 (q8 user lock):\n * fallback clear color when the world carries no Camera entity. Opaque\n * black `[0, 0, 0, 1]`, replacing the historical\n * `[0.06, 0.06, 0.08, 1.0]` dark-slate sentinel. Single SSOT consumed by\n * the synthetic CameraSnapshot built when `cameras.length === 0`\n * (Case B in `recordFrame`) and read directly by tests\n * (`zero-camera-clear-fallback.test.ts`). AC-05.\n */\nexport const ZERO_CAMERA_CLEAR_FALLBACK: readonly [number, number, number, number] = [0, 0, 0, 1];\n\nexport interface FrameObservationSource {\n  readonly texture: Texture;\n  readonly descriptor: ResolvedColorTargetDescriptor;\n  readonly frameId: number;\n  readonly pipelineId: 'forgeax::standard';\n  readonly backendId: string;\n}\n\n/** Internal test/diagnostic view of one compiled graph color target. */\nexport interface CurrentGraphTarget {\n  readonly name: string;\n  readonly texture: Texture;\n  /** Stable opaque identity for this RHI handle during the renderer lifetime. */\n  readonly textureIdentity: number;\n  readonly descriptor: ResolvedColorTargetDescriptor;\n  readonly frameId: number;\n  /** Monotonic identity of the compiled graph that owns this texture. */\n  readonly graphGeneration: number;\n}\n\nconst textureIdentities = new WeakMap<object, number>();\nlet nextTextureIdentity = 1;\n\n/**\n * Project an opaque RHI texture handle to a stable diagnostic identity.\n * RHI handles intentionally expose no serializable fields; object identity is\n * the only valid comparison boundary for a copy-time capture.\n */\nexport function getTextureIdentity(texture: Texture): number {\n  const object = texture as object;\n  const existing = textureIdentities.get(object);\n  if (existing !== undefined) return existing;\n  const identity = nextTextureIdentity++;\n  textureIdentities.set(object, identity);\n  return identity;\n}\n\nexport type GraphTargetCaptureReadbackValidation =\n  | { readonly ok: true }\n  | {\n      readonly ok: false;\n      readonly code:\n        | 'capture-readback-length'\n        | 'capture-readback-untouched-sentinel'\n        | 'capture-readback-empty'\n        | 'capture-readback-non-finite';\n    };\n\n/** Validate a mapped rgba16float capture before a consumer decodes its values. */\nexport function validateGraphTargetCaptureReadback(input: {\n  readonly bytes: Uint8Array;\n  readonly expectedByteLength: number;\n  readonly sentinel?: Uint8Array;\n}): GraphTargetCaptureReadbackValidation {\n  const { bytes, expectedByteLength, sentinel } = input;\n  if (bytes.byteLength !== expectedByteLength)\n    return { ok: false, code: 'capture-readback-length' };\n  if (sentinel?.every((value, index) => bytes[index] === value)) {\n    return { ok: false, code: 'capture-readback-untouched-sentinel' };\n  }\n  if (bytes.every((value) => value === 0)) return { ok: false, code: 'capture-readback-empty' };\n  for (let index = 0; index + 1 < bytes.length; index += 2) {\n    const exponent = ((bytes[index + 1] ?? 0) >>> 2) & 0x1f;\n    if (exponent === 0x1f) return { ok: false, code: 'capture-readback-non-finite' };\n  }\n  return { ok: true };\n}\n\n/** Internal readback request consumed by the record encoder in the same submit. */\nexport interface GraphTargetCaptureRequest {\n  readonly name: string;\n  readonly buffer: Buffer;\n  readonly bytesPerRow: number;\n  readonly width: number;\n  readonly height: number;\n  /** Descriptor contract checked against the resolved target at copy time. */\n  readonly expected: {\n    readonly format: ResolvedColorTargetDescriptor['format'];\n    readonly width: number;\n    readonly height: number;\n    readonly usage: number;\n    /** Optional caller binding; when present it is checked at copy time. */\n    readonly identity?: {\n      readonly graphGeneration: number;\n      readonly frameId: number;\n      readonly textureIdentity: number;\n    };\n  };\n}\n\n/**\n * Build a synthetic CameraSnapshot the record stage uses when the world\n * carries no Camera entity. Identity-shaped projection / view inputs\n * keep the existing matrix math numerically stable; clear-color quartet\n * sourced from `ZERO_CAMERA_CLEAR_FALLBACK` so the swap-chain still\n * paints `[0, 0, 0, 1]` (AI-user friendly observable signal that the\n * `'render-system-no-camera'` diagnostic fired without leaving stale\n * pixels on screen).\n */\nexport function makeZeroCameraFallbackSnapshot(): CameraSnapshot {\n  // Identity world mat4 so `mat4.invert(world)` yields identity view.\n  const identityWorld = new Float32Array(16);\n  identityWorld[0] = 1;\n  identityWorld[5] = 1;\n  identityWorld[10] = 1;\n  identityWorld[15] = 1;\n  return {\n    position: vec3.create(0, 0, 0),\n    world: identityWorld,\n    fov: Math.PI / 4,\n    aspect: 1,\n    near: 0.1,\n    far: 100,\n    // feat-20260613 M6 / w20: synthetic camera defaults to perspective so\n    // the CSM extract path stays consistent with the previously-implicit\n    // perspective shape (unchanged behavior; explicit field).\n    projection: 'perspective',\n    orthoLeft: -1,\n    orthoRight: 1,\n    orthoBottom: -1,\n    orthoTop: 1,\n    tonemap: 'none',\n    exposure: 1.0,\n    whitePoint: 4.0,\n    antialias: 'none',\n    bloom: 'off',\n    bloomThreshold: 1.0,\n    bloomIntensity: 1.0,\n    bloomBlurRadius: 4.0,\n    clearColor: ZERO_CAMERA_CLEAR_FALLBACK,\n  };\n}\n\n// feat-20260621-merge-directionallightshadow-into-directionallight M3 / m3-t2\n// (D-7): host-clamp the merged DirectionalLight's pcfKernelSize to the nearest\n// valid odd kernel in {1,3,5} before it reaches the View UBO float [128].\n// lighting-directional.wgsl runs a constant-trip-count loop to MAX_PCF_HALF=2\n// (merged 5.3-production-shadow-demos AC-14 variant-free pattern) and clips each\n// iteration to half = (pcfKernelSize-1)/2, so the supported kernel set is\n// {1,3,5} (cap 5). undefined (no shadow fields) defaults to 3.\nexport function clampPcfKernelSize(value: number | undefined): number {\n  if (value === undefined) return 3;\n  if (value <= 1) return 1;\n  if (value <= 3) return 3;\n  return 5;\n}\n\n/**\n * Per-RenderSystem mutable frame state.\n *\n * Owned by the `createRenderSystem` closure; advanced once per\n * `recordFrame` invocation. The `instanceBuffers` map holds the per-entity\n * GPU storage buffers for Instances-bearing entities (cache key = the\n * packed Entity u32 surfaced via `InstancesSnapshot.cacheKey`); entries\n * are recreated when the `archVersion` bumps or `byteLength` changes.\n *\n * feat-20260518-pbr-direct-lighting-mvp M3 / w14 (AC-17 a): the\n * `warnedZeroLightStandard` flag latches the first-frame warning that\n * fires when the world contains a StandardMaterial entity but zero\n * DirectionalLight entries — once latched the next 100 frames suppress\n * the warning so the AI user is not flooded with repeated noise (charter\n * P3 silent failure -> explicit warning at most once per RenderSystem\n * lifetime).\n */\nexport interface RenderFrameState {\n  frameNumber: number;\n  /** Monotonic compiled-graph identity used by diagnostic readbacks. */\n  graphGeneration: number;\n  /** Number of successfully submitted TAA frames; failed attempts do not advance it. */\n  successfulTemporalFrameIndex?: number;\n  /** The renderer-owned accepted-submit temporal fact consumed by consumers. */\n  temporalFrame?: TemporalFrame;\n  /** The sole transaction that advances temporal history after queue.submit. */\n  readonly temporalFrameTransaction: TemporalFrameTransaction;\n  /** Staged input is consumed only by the graph submit owner. */\n  temporalFrameInput: TemporalFrameInput | undefined;\n  /** Optional graph resource lookup used by low-level record helpers and tests. */\n  perFrameGraph?: {\n    readonly getColorTargetDescriptor: (key: string) => ResolvedColorTargetDescriptor | undefined;\n    readonly getColorTargetView: (key: string) => TextureView | undefined;\n    readonly getColorTargetTexture: (key: string) => Texture | undefined;\n    readonly graphGeneration: number;\n  } | null;\n  graphTargetCapture?: GraphTargetCaptureRequest | undefined;\n  /** Last successfully rendered static directional shadow atlas token. */\n  directionalShadowCache: DirectionalShadowCache | null;\n  /** Last successfully submitted camera post-process mode. */\n  lastSuccessfulBloom: 'off' | 'on';\n  /** Bloom record receipts staged by this frame; cleared on abort. */\n  bloomFrameReceipts?: BloomFrameReceipts | undefined;\n  /** Set by a directional shadow pass when this frame refreshed the atlas. */\n  directionalShadowCacheRecorded: boolean;\n  /** The sole compiled owner for compute, copy, feature, and raster work. */\n  compiledFrameGraph: CompiledRenderGraph<RenderPipelineFrame> | null;\n  compiledFrameGraphTopologyKey: string | null;\n  /**\n   * Last-known-good graph held while a volume topology candidate is tested.\n   * The candidate is promoted only after its command buffer is submitted;\n   * failed encoding/finish/submit restores this graph and its topology key.\n   */\n  volumetricFogPreviousGraph: CompiledRenderGraph<RenderPipelineFrame> | null;\n  volumetricFogPreviousGraphKey: string | null;\n  volumetricFogCandidateGraph: CompiledRenderGraph<RenderPipelineFrame> | null;\n  /** Two renderer-owned parameter slots; only the pending slot is writable. */\n  volumetricFogParamsBuffers: [Buffer | null, Buffer | null];\n  /** Candidate parameter slot, promoted only after queue submission succeeds. */\n  volumetricFogParamsPendingSlot: 0 | 1 | null;\n  /** Parameter slot consumed by the last accepted volume frame. */\n  volumetricFogParamsAcceptedSlot: 0 | 1 | null;\n  /** CPU copy of the accepted parameter payload for degraded-frame staging. */\n  volumetricFogAcceptedParams: Float32Array | undefined;\n  /** CPU copy of the current candidate payload before submit. */\n  volumetricFogPendingParams: Float32Array | undefined;\n  /** Last candidate/accepted volume projection exposed through inspect(). */\n  volumetricFogInspection: VolumetricFogInspection;\n  /** Accepted volume POD/context retained while a later candidate degrades. */\n  volumetricFogAccepted: import('../render-system-extract').ExtractedVolumetricFog | undefined;\n  volumetricFogAcceptedContext: VolumetricFogFrameContext | undefined;\n  /** Accepted graph identity and ping-pong slot for temporal volume history. */\n  volumetricFogHistoryGraph: CompiledRenderGraph<RenderPipelineFrame> | null;\n  volumetricFogHistorySlot: 0 | 1 | null;\n  volumetricFogHistorySignature: VolumeTemporalSignature | null;\n  readonly retiredCompiledFrameGraphs: Set<CompiledRenderGraph<RenderPipelineFrame>>;\n  /** Physical outputs projected by typed graph passes for downstream observers. */\n  currentFrameObservationSource: FrameObservationSource | undefined;\n  /** Camera antialias mode for the last successfully submitted graph. */\n  lastSuccessfulCameraAntialias: CameraSnapshot['antialias'] | undefined;\n  /** Staged TAA GPU state is promoted only after queue.submit succeeds. */\n  temporalGpuState: TemporalGpuState | undefined;\n  /** Last successful TAA GPU state; candidate replacement stays staged until submit. */\n  activeTemporalGpuState: TemporalGpuState | undefined;\n  /** Submitted temporal generations retained until their queue fence resolves. */\n  readonly retiringTemporalGpuStates: Set<TemporalGpuState>;\n  /** Last successful projection; candidate frames never overwrite it. */\n  lastSuccessfulTemporalView: TemporalView | undefined;\n  pendingTemporalCommit: TemporalCommitOutcome;\n  /** Staged environment generation is promoted only after queue.submit succeeds. */\n  environmentGeneration: EnvironmentGeneration | undefined;\n  readonly environmentLifecycle: EnvironmentLifecycle | undefined;\n  currentDirectionalShadowView: TextureView | null;\n  currentSpotShadowView: TextureView | null;\n  readonly instanceBuffers: Map<number, InstanceBufferCacheEntry>;\n  /** Per-entity vertex buffers for the Standard CPU morph lane. */\n  readonly morphBuffers?: Map<number, MorphBufferCacheEntry>;\n  readonly hdrpClusterBinScratch: ClusterBinScratch;\n  /** Reusable HDRP cluster output buffers; sized once and grown only if the grid/cap changes. */\n  hdrpClusterGridScratch: Uint32Array | null;\n  hdrpLightIndexListScratch: Uint32Array | null;\n  /** Compute bind group for the optional WebGPU HDRP membership producer. */\n  hdrpClusterMembershipBindGroup: BindGroup | null;\n  transientInstanceBuffers: InstanceBufferCacheEntry[];\n  warnedZeroLightStandard: boolean;\n  /**\n   * feax-20260608-multi-light-warn-once M3: once-warn latch for multi-light\n   * overrun per bucket (directional N>1 / point N>4 / spot N>4). Fires at\n   * most once per RenderSystem lifetime per bucket so AI users see a single\n   * actionable console.warn without per-frame flooding (charter P3 explicit\n   * failure: warn-once preserves signal/noise floor).\n   */\n  warnedMultiLightDirectional: boolean;\n  warnedMultiLightPoint: boolean;\n  warnedMultiLightSpot: boolean;\n  /**\n   * feat-20260630-equirect-kind-internalized-ibl-declarative-skyligh M3 / w19:\n   * once-warn latches for >1 Skylight / >1 SkyboxBackground entity. Fire at most\n   * once per RenderSystem lifetime so the multi-entity warn (which names the\n   * winning entity handle, F-8) does not flood the console every frame.\n   */\n  warnedMultiSkylight: boolean;\n  warnedMultiSkybox: boolean;\n  /** feat-20260531-skybox-env-background M3 / w20: once-warn when camera\n   * tonemap is 'none' but a SkyboxBackground entity exists. Skybox needs\n   * the HDR render target allocated by the tonemap path; without it the\n   * skybox pass is skipped (plan-strategy D-2 NOTE). */\n  warnedSkyboxTonemapNone: boolean;\n  /**\n   * Per-handle warn-once anchor for the missing baseColor-texture fallback,\n   * shared by every textured material path (sprite / sprite-lit / standard-pbr\n   * / pbr-skin / unlit — feat-20260520-2d-sprite-layer-mvp M-3 / w25 seeded it\n   * for sprites; feat-future-pbr-missing-texture-fallback-explicit generalised\n   * it to PBR/skin so GLB textures that fail to reach the GPU no longer render\n   * silently flat). A `Set<number>` keyed by the raw Handle<TextureAsset> id -\n   * the writer fires `console.warn` exactly once per missing texture handle per\n   * RenderSystem lifetime so AI users see a single actionable message without\n   * per-frame log flooding. The set lives across frames so the second frame on\n   * the same missing handle stays silent (charter P3 explicit failure:\n   * warn-once preserves signal / noise floor while structured RhiError below\n   * stays per-frame fire).\n   *\n   * Note on the WeakSet/Set choice: plan-strategy mentions WeakSet but\n   * Handle values are numeric brand u32s (not object references), so\n   * WeakSet<object> is not applicable; Set<number> gives identical\n   * warn-once-per-handle semantics at zero additional cost (charter F1\n   * minimal surface; the per-RenderSystem lifetime cap is the upper\n   * bound).\n   */\n  readonly warnedMissingBaseColorTextureHandles: Set<number>;\n  /**\n   * feat-20260527-sprite-nineslice M2 / w11 + M4 / w16 (AC-16): once-per-\n   * renderable guard for the `nineslice.scale-too-small` metric increment.\n   * Keyed by `renderableIndex` so the second frame on the same mis-scaled\n   * entity does NOT keep bumping the counter — AI users see one counter\n   * tick per offending entity per RenderSystem lifetime, matching the\n   * single-event semantics of the structured fail-fast (charter P3:\n   * machine-readable signal, not a per-frame inflation). M4 retired the\n   * placeholder console.warn; the increment lands on the per-Renderer\n   * EngineMetrics through `runtime.metrics.increment(...)`.\n   */\n  readonly warnedNineSliceScaleEntities: Set<number>;\n  /**\n   * feat-20260630-equirect-kind-internalized-ibl-declarative-skyligh M3 / w18:\n   * per-handle fire-once anchor for the lazy equirect-to-cubemap projection\n   * failure. A `Set<number>` keyed by the raw Handle<EquirectAsset> id - the\n   * record arm fires the structured `EquirectProjectionFailedError` exactly\n   * once per failed source per RenderSystem lifetime (the store records\n   * `status:'failed'` permanently and never retries, R-2 / AC-09; without this\n   * latch the record arm would re-fire the error every frame). The set lives\n   * across frames so the second frame on the same failed handle stays silent\n   * (charter P3: warn-once preserves signal / noise floor).\n   */\n  readonly firedEquirectProjectionFailedHandles: Set<number>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w3: per-frame\n   * bind group caches converted to nested WeakMap chain roots (D-3).\n   * Each root is a WeakMap<object, WeakMap<...>> walked by\n   * getOrCreateFromChain; the chain depth varies by variant\n   * (view-main = 7, mesh = 1, hdrp-unified = 5, skin = 2).\n   * Roots are stable between device recoveries and replaced when the renderer\n   * swaps to a fresh device. Chain keys are always inner buffer handles, never\n   * wrappers (D-3).\n   */\n  viewBindGroupCache: WeakMap<object, unknown>;\n  meshBindGroupCache: WeakMap<object, unknown>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w2: per-entity\n   * bind group caches scoped by entityKey (packed u32 as number).\n   * Outer Map<number, WeakMap<handle, ...>> lets GC collect entries for\n   * destroyed entities whose handles are unreachable; per-entity material\n   * and instances share the same two-level shape (D-1). The inner WeakMap\n   * value is opaque (`unknown`) because `getOrCreateFromChain` walks a\n   * variable-depth chain — intermediate handles map to nested WeakMaps and\n   * only the final handle maps to the variant->BindGroup leaf Map. Direct\n   * readers (HDRP shadow-instances read end) assert the leaf shape locally.\n   */\n  /**\n   * feat-20260708-composited-multi-world-rendering M1 / D-1a #2: outer Map\n   * keyed by `worldEntityKey(worldId, entityKey)`. Inner WeakMap unchanged.\n   */\n  readonly materialBgPerEntity: Map<number, WeakMap<object, unknown>>;\n  /**\n   * feat-20260708-composited-multi-world-rendering M1 / D-1a #3: outer Map\n   * keyed by `worldEntityKey(worldId, entityKey)`. Inner WeakMap unchanged.\n   */\n  readonly instancesBgPerEntity: Map<number, WeakMap<object, unknown>>;\n  /** Identity-keyed instances BGs shared across entities using the same buffer. */\n  readonly instancesBgShared: WeakMap<object, unknown>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w2: cross-entity\n   * shared material bind group cache (OQ-1 option A). Outer key is the\n   * material shaderId string; inner chain is a WeakMap keyed by the same\n   * handle objects used in per-entity chains. Reuses the generic\n   * `getOrCreatePerEntity` helper with outerKey string|number (D-1).\n   */\n  readonly materialBgShared: Map<string, WeakMap<object, unknown>>;\n  /** Cross-frame fast path for fully-resident, immutable material snapshots. */\n  readonly materialBgAssemblyCache: Map<string, MaterialBgAssemblyCacheEntry>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w2: singleton\n   * material bind group cache (D-6). Single flat Map<variant, BindGroup>\n   * for the one true singleton in production: shadow-material-singleton.\n   * shadow-instances-singleton is a test fixture fiction (research F3);\n   * no second singleton field is needed.\n   */\n  readonly singletonMaterialCache: Map<string, BindGroup>;\n  /**\n   * Post-process bind group cache: nested WeakMap chain root shared by the\n   * built-in bloom (bright / blur-H / blur-V / composite), FXAA, and HDRP SSAO\n   * (calc / blur) fullscreen passes. Each of these passes samples graph-owned\n   * transient render targets (hdrColor / ldrColor / bloom* / ssaoRaw /\n   * gbuf0 / hdrDepth); on canvas resize the graph retires the old physical\n   * textures and allocates new ones, so the bind group must be rebuilt to\n   * reference the new TextureView identity. Keying the cache on the physical\n   * TextureView (or `::tex` texture handle for passes that recreate their bound\n   * view every frame) makes invalidation automatic: a resized target yields a\n   * new key object -> WeakMap miss -> factory rebuild, and dead views are GC'd\n   * (same identity-invalidation mechanism as view/mesh caches, D-3). Replaces\n   * the pre-fix `pp.*BindGroup === null` single-slot caches that never\n   * invalidated on resize and submitted destroyed textures.\n   */\n  postProcessBgCache: WeakMap<object, unknown>;\n  /**\n   * Raw handle of the currently installed RenderPipelineAsset (0 = builtin).\n   * Installation brands the next candidate topology; the prior compiled graph\n   * remains last-known-good until the candidate compiles successfully.\n   */\n  installedPipelineHandle: number;\n  /**\n   * Active topology declaration resolved from the pipeline registry.\n   */\n  activePipeline: RenderPipelineDef;\n  /**\n   * Install-time config projected into `RenderPipelineTopology.config`.\n   */\n  installedPipelineConfig: RenderPipelineAsset['config'];\n  /**\n   * Whether the configured standard graph resolved to the clustered lane.\n   * Capability gating keeps URP forward bindings on WebGL2 fallback even\n   * when a clustered profile was requested.\n   */\n  isHdrpActive: boolean;\n  /**\n   * feat-20260608-cluster-lighting M5 / w20 + M6 / w23 + M5 / w22:\n   * once-per-frame fire dedup set for HDRP per-frame fail-soft errors\n   * (`hdrp-light-budget-exceeded`, `hdrp-index-list-overflow`). Cleared\n   * at the end of each frame so the next frame re-fires if the condition\n   * persists. Set<string> keyed by RuntimeErrorCode literal.\n   */\n  hdrpOncePerFrameFired: Set<string>;\n  /**\n   * feat-20260612-point-light-shadows-urp-hdrp M3 / T-M3-2 (plan-strategy §D-1).\n   * Lazily-allocated cube_array shadow atlas owned by the RenderSystem\n   * lifetime. `null` until the first frame whose `lights.pointShadow` is\n   * non-empty (zero-shadow scenes never allocate; AC-09). The atlas is\n   * disposed by the renderer dispose path; subsequent frames with a non-empty\n   * snapshot list re-allocate.\n   */\n  pointShadowAtlas: ShadowAtlas | null;\n  /**\n   * feat-20260612-point-light-shadows-urp-hdrp M3 / T-M3-2 (plan-strategy §D-3):\n   * per-frame projection of `lights.pointShadow` from the extract stage. The\n   * typed point-shadow pass reads this list to drive the 6 x N face iteration.\n   * Empty array means the topology declares no point-shadow passes.\n   */\n  pointShadowSnapshots: readonly PointShadowSnapshot[];\n  /**\n   * feat-20260622-chunk-gpu-instancing-sprite-tilemap M1 / w4 (D-1):\n   * last fold-pass output, computed at `recordFrame` entry from the\n   * transparent-sort-ordered dispatch + mode-gate (D-5: only mode 0\n   * folds; other modes yield singleton buckets). Currently an\n   * observational compute — the drawIndexed swap (1 instanced draw per\n   * fold bucket) is the follow-on integration that wires each bucket\n   * into the sprite-pass / geometry-pass dispatch loops. The bucket\n   * count is the source of truth for `render.instancing.foldedDraws`\n   * metric (M3 / w13) — every fold-eligible bucket (bucketSize >= 1\n   * under mode 0 AND not bypassed) contributes one increment.\n   */\n  lastFoldBucketCount: number;\n  /**\n   * feat-20260625-spot-light-shadow-mapping M2 / w9 (D-2): per-frame projection\n   * of `lights.spot` from the extract stage. The typed spot-shadow graph\n   * pass reads this list to render each\n   * castShadow spot's perspective depth into its `spotShadowDepth` atlas tile\n   * (viewport keyed on `shadowAtlasTile`). `recordFrame` writes it before\n   * graph execution. Spots with `shadowAtlasTile < 0` (castShadow:false,\n   * degenerate direction, or clipped beyond cap 4) are skipped — zero\n   * shadow-casting spots means zero spot shadow passes (AC-03).\n   */\n  spotShadowSnapshots: readonly SpotLightSnapshot[];\n}\n\nexport interface MorphBufferCacheEntry {\n  readonly buffer: GpuBuffer;\n  readonly byteLength: number;\n}\n\n/**\n * feat-20260518-pbr-direct-lighting-mvp M5 / w22.11 (D-2 + D-10 + AC-06):\n * mutable per-frame dispatch counter object owned by `createRenderSystem`\n * and bumped here at the actual `pass.setPipeline(...)` call site (the\n * only point with both `mat.materialShaderId` and `mesh.layoutProjection` in scope).\n * Unlit / custom shader pipeline dispatch tracked here.\n */\nexport interface DispatchCounts {\n  unlit: number;\n  /** feat-20260523 M4-T07: 'standard' counter removed; schema-driven\n   *  materials are tracked via materialShaderId in the pipeline cache. */\n}\n\n/**\n * feat-20260531-per-frame-bind-group-cache M1 / w4: per-frame\n * createBindGroup counter. Closure-mutable object aligned with\n * DispatchCounts precedent. Reset in draw(world) entry, bumped on\n * cache-miss createBindGroup calls (M2-M4).\n */\nexport interface BindGroupCounts {\n  createBindGroup: number;\n  /**\n   * Debug-only: records the variant of every cache-miss BindGroup created via\n   * `getOrCreateFromChain` for unit-test observability. Production paths do\n   * not read this array.\n   */\n  keys: string[];\n}\n\n/**\n * Successful Bloom record operations staged for the current frame. These\n * counters are promoted only after the shared renderer queue submission.\n */\nexport interface BloomFrameReceipts {\n  readonly uploadCount: number;\n  readonly bindGroupCount: number;\n  readonly encodeCount: number;\n}\n\n/**\n * A renderable resolved against the AssetRegistry for the current frame:\n * its source snapshot, the GPU mesh handles, the row index used to correlate\n * transparent-sort output back to this entry, and an optional per-material\n * renderState override (bug-20260527-renderstate-pipeline-dispatch-gap D-4).\n * Module-scoped so RenderPipelineContext can type `validated` / `validatedOrdered`\n * without a dynamic type escape (was a recordFrame-local interface before F-4).\n */\nexport interface ValidatedRenderable {\n  readonly source: RenderableSnapshot;\n  /** World that owns the renderable's asset handles and material snapshots. */\n  readonly world?: World;\n  readonly mesh: MeshGpuHandles;\n  readonly renderableIndex: number;\n  readonly renderState: MaterialRenderState | undefined;\n  /**\n   * Canonical authored material-variant request folded from the selected\n   * pass's `defines` map. Capability axes are merged at the renderer seam;\n   * this field carries only the pass-owned selection into record.\n   */\n  readonly variantSet?: string | undefined;\n  /**\n   * w10: per-pass stencil reference value folded from\n   * {@link DispatchEntry.stencilReference} (draw-call dynamic state). The draw\n   * loop calls `pass.setStencilReference(stencilReference ?? 0)` before each\n   * draw; `undefined` falls back to the WebGPU default 0 (semantic no-op).\n   */\n  readonly stencilReference: number | undefined;\n}\n\n/**\n * Cross-frame validity token for the directional shadow atlas.\n *\n * The atlas is a render target, not authored state. Keeping its validity\n * token beside the other RenderFrameState caches lets recordFrame skip a\n * static caster submission without teaching the public render-pipeline\n * contract about caching. Every source that can change caster depth is part\n * of the token: world mutation, asset catalogue, graph/target identity, CSM\n * matrices, and the GPU mesh-residency epoch.\n *\n * @internal\n */\nexport interface DirectionalShadowCache {\n  readonly worlds: readonly World[];\n  readonly worldStateTokens: readonly DirectionalShadowWorldState[];\n  readonly assetCatalogEpoch: number;\n  readonly pipelineHandle: number;\n  readonly graphTopologyKey: string | null;\n  readonly shadowMapSize: number;\n  readonly cascadeCount: number;\n  readonly lightViewProj: readonly Float32Array[];\n  readonly meshResidencyEpoch: number;\n}\n\n/**\n * ECS state that can change the contents of a directional shadow map.\n *\n * The ECS-owned RenderReadLease is the only render-facing mutation boundary.\n * Its cursor is intentionally conservative: any published World change\n * invalidates the cached atlas, while render never reaches through World for\n * component-clock storage.\n */\nexport interface DirectionalShadowWorldState {\n  readonly worldIdentity: string;\n  readonly changeCursor: number;\n}\n"]}

package/dist/{chunk-LOSO4CTV.mjs → chunk-TBQJOK2L.mjs}

@@ -12,6 +12,17 @@ var LifecycleConstructionError = class extends Error {
     this.detail = detail;
   }
 };
+var TemporalFrameSubmitError = class extends Error {
+  code = "temporal-frame-submit-rejected";
+  expected = "the staged frame is accepted by queue.submit before temporal facts advance";
+  hint = "inspect the queue submission and retry the frame after the device is available";
+  detail;
+  constructor(reason) {
+    super(`temporal-frame-submit-rejected: ${reason}`);
+    this.name = "TemporalFrameSubmitError";
+    this.detail = { reason };
+  }
+};
 var ShadowInvalidConfigError = class extends Error {
   code = "shadow-invalid-config";
   expected;
@@ -591,6 +602,52 @@ var PointsLinesPrepareFailedError = class extends Error {
     this.detail = detail;
   }
 };
+var VolumeOwnerConflictError = class extends Error {
+  code = "volume-owner-conflict";
+  expected = "exactly one global VolumetricFog owner is authored";
+  hint = "remove additional VolumetricFog owners and retry extraction";
+  detail;
+  constructor(ownerCount) {
+    super(`volume-owner-conflict: received ${ownerCount} owners`);
+    this.name = "VolumeOwnerConflictError";
+    this.detail = { ownerCount };
+  }
+};
+var VolumeDensityShapeMismatchError = class extends Error {
+  code = "volume-density-shape-mismatch";
+  expected = "density is a linear 3D TextureAsset";
+  hint = "bind a verified linear texture with viewDimension 3d";
+  detail;
+  constructor(guid, viewDimension) {
+    super(`volume-density-shape-mismatch: ${viewDimension} density is not 3d`);
+    this.name = "VolumeDensityShapeMismatchError";
+    this.detail = { guid, viewDimension };
+  }
+};
+var VolumeInvalidBoundsError = class extends Error {
+  code = "volume-invalid-bounds";
+  expected = "bounds are finite and max is greater than min on every axis";
+  hint = "set finite non-degenerate volume bounds";
+  detail;
+  constructor(bounds) {
+    super("volume-invalid-bounds: bounds must be finite and non-degenerate");
+    this.name = "VolumeInvalidBoundsError";
+    this.detail = bounds;
+  }
+};
+var VolumeInvalidParametersError = class extends Error {
+  code = "volume-invalid-parameters";
+  expected = "volume parameters remain finite and inside their closed ranges";
+  hint = "repair extinction, albedo, emission, anisotropy, or maxDistance";
+  detail;
+  constructor(input) {
+    const field = input.maxDistance !== void 0 && input.maxDistance <= 0 ? "maxDistance" : "parameters";
+    const value = field === "maxDistance" ? input.maxDistance : input.anisotropy;
+    super(`volume-invalid-parameters: ${field} is outside the authored range`);
+    this.name = "VolumeInvalidParametersError";
+    this.detail = { field, value };
+  }
+};
 
 // src/temporal/scene-data.ts
 var SCENE_DATA_TEMPORAL_V1_SCHEMA = "forgeax::scene-data::temporal-v1";
@@ -809,9 +866,16 @@ var DEFAULT_STANDARD_PROFILE = Object.freeze({
   pbr: true,
   ibl: true,
   ssao: false,
+  bloom: true,
+  tone: "aces-filmic",
+  antialias: "fxaa",
+  sky: true,
   fallback: "native",
   postStages: STANDARD_POST_STAGE_NAMES
 });
+function resolveVolumetricFogProfile(profile) {
+  return profile.volumetricFog ?? { quality: "high", depth: 64, tileSize: 4 };
+}
 function resolveStandardLane(profile, capabilities) {
   if (!capabilities.compute || !capabilities.storageBuffer) return "cpu-webgl2";
   return profile.lighting;
@@ -896,6 +960,6 @@ var RENDER_PHASE_CATALOG = [
   ...RENDER_RECORD_PHASE_CATALOG
 ];
 
-export { AtmosphereInvalidParameterError, CLUSTER_GRID_STRIDE_U32, DEFAULT_CLUSTER_GRID, DEFAULT_STANDARD_PROFILE, EnvironmentGenerationFailedError, EnvironmentSourceConflictError, EquirectProjectionFailedError, FogCardinalityError, FrameReceiptStaleError, HdrpDeferredCapsInsufficientError, HdrpIndexListOverflowError, HdrpLightBudgetExceededError, LIGHT_INDEX_LIST_CAPACITY, LifecycleConstructionError, MAX_LIGHTS, MaterialSkinAttrMissingError, ObservationUnavailableError, OwnerStageFailedError, PointShadowAtlasBoundsViolationError, PointShadowAtlasUninitializedError, PointsLinesBudgetExceededError, PointsLinesInvalidStyleError, PointsLinesMaterialUnsupportedError, PointsLinesPrepareFailedError, PointsLinesStyleUnsupportedError, PointsLinesTopologyMismatchError, RENDER_PHASE_CATALOG, RenderFeatureCapabilityMissingError, RenderFeatureDrawRecordingFailedError, RenderFeaturePreparationFailedError, RenderFeaturePreparedStateMismatchError, RenderFeatureRegistrationConflictError, RenderFeatureStageFailedError, RendererContractFailureError, RendererOperationError, SCENE_DATA_TEMPORAL_V1_DESCRIPTOR, SCENE_DATA_TEMPORAL_V1_SCHEMA, STANDARD_LIGHT_COUNTS, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, STANDARD_PIPELINE_ID, STANDARD_POST_STAGE_NAMES, SceneDataUnavailableError, ShadowInvalidConfigError, SkinMaterialMismatchError, SkinPaletteOverflowError, TaaCapsInsufficientError, TransmissionCapabilityMissingError, VertexColorVariantConflictError, VideoUploadUnsupportedError, createSceneDataCatalog, isSceneDataTarget, registerSceneDataTarget, resolveStandardLane, sceneDataError, sceneDataTargetAsAttachment, sceneDataTargetOwner, sceneDataTokenMismatch };
-//# sourceMappingURL=chunk-LOSO4CTV.mjs.map
-//# sourceMappingURL=chunk-LOSO4CTV.mjs.map
+export { AtmosphereInvalidParameterError, CLUSTER_GRID_STRIDE_U32, DEFAULT_CLUSTER_GRID, DEFAULT_STANDARD_PROFILE, EnvironmentGenerationFailedError, EnvironmentSourceConflictError, EquirectProjectionFailedError, FogCardinalityError, FrameReceiptStaleError, HdrpDeferredCapsInsufficientError, HdrpIndexListOverflowError, HdrpLightBudgetExceededError, LIGHT_INDEX_LIST_CAPACITY, LifecycleConstructionError, MAX_LIGHTS, MaterialSkinAttrMissingError, ObservationUnavailableError, OwnerStageFailedError, PointShadowAtlasBoundsViolationError, PointShadowAtlasUninitializedError, PointsLinesBudgetExceededError, PointsLinesInvalidStyleError, PointsLinesMaterialUnsupportedError, PointsLinesPrepareFailedError, PointsLinesStyleUnsupportedError, PointsLinesTopologyMismatchError, RENDER_PHASE_CATALOG, RenderFeatureCapabilityMissingError, RenderFeatureDrawRecordingFailedError, RenderFeaturePreparationFailedError, RenderFeaturePreparedStateMismatchError, RenderFeatureRegistrationConflictError, RenderFeatureStageFailedError, RendererContractFailureError, RendererOperationError, SCENE_DATA_TEMPORAL_V1_DESCRIPTOR, SCENE_DATA_TEMPORAL_V1_SCHEMA, STANDARD_LIGHT_COUNTS, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, STANDARD_PIPELINE_ID, STANDARD_POST_STAGE_NAMES, SceneDataUnavailableError, ShadowInvalidConfigError, SkinMaterialMismatchError, SkinPaletteOverflowError, TaaCapsInsufficientError, TemporalFrameSubmitError, TransmissionCapabilityMissingError, VertexColorVariantConflictError, VideoUploadUnsupportedError, VolumeDensityShapeMismatchError, VolumeInvalidBoundsError, VolumeInvalidParametersError, VolumeOwnerConflictError, createSceneDataCatalog, isSceneDataTarget, registerSceneDataTarget, resolveStandardLane, resolveVolumetricFogProfile, sceneDataError, sceneDataTargetAsAttachment, sceneDataTargetOwner, sceneDataTokenMismatch };
+//# sourceMappingURL=chunk-TBQJOK2L.mjs.map
+//# sourceMappingURL=chunk-TBQJOK2L.mjs.map

package/dist/chunk-TBQJOK2L.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/render.ts","../src/temporal/scene-data.ts","../src/temporal/scene-data-catalog.ts","../src/pipeline/standard-profile.ts","../src/render-contract.ts"],"names":[],"mappings":"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","file":"chunk-TBQJOK2L.mjs","sourcesContent":["// @forgeax/engine-render -- render cluster error classes.\n//\n// feat-20260704-runtime-tier1-decomposition M2 / w8 (D-3): the monolithic\n// errors.ts RuntimeErrorCode / RuntimeError top-level aggregate unions are\n// decomposed into five per-cluster files (render / asset / skin / recover /\n// environment). Each cluster owns a closed *ErrorCode code union + a closed\n// *Error class union; error class names, .code literals, and .detail shapes\n// are preserved byte-for-byte (OOS-4: zero semantic change).\n//\n// The render cluster holds the shadow / HDRP cluster-forward + deferred /\n// g-buffer / point-shadow-atlas / video-upload / vertex-storage-buffer render\n// path errors. ShadowInvalidConfigError is consumed by the DirectionalLight /\n// SpotLight / PointLightShadow component validators (forward cross-directory\n// import, no cycle -- research Finding C2).\n\nimport type {\n  RenderSurfaceFailureDetail,\n  SurfaceFailureCode,\n  SurfaceFailureKind,\n} from '@forgeax/engine-render-graph';\nimport type { DeviceResourceKind, DeviceScopeReceipt } from '../device/resource-types';\nimport type {\n  PreparedKind,\n  RenderFeatureCapabilityKey,\n  RenderFeatureRecovery,\n  RenderFeatureStage,\n} from '../features/vocabulary';\nimport type { SceneDataLane, SceneDataSchemaId } from '../temporal/scene-data';\nimport type { TransmissionCapabilityFact } from '../transmission/backdrop';\n\nexport interface LifecycleConstructionFailureDetail {\n  readonly owner: string;\n  readonly generation: number;\n  readonly operation: 'create' | 'dispose';\n  readonly resourceKind: DeviceResourceKind;\n  readonly cause: unknown;\n  readonly cleanupFailures: readonly {\n    readonly resourceKind: DeviceResourceKind;\n    readonly cause: unknown;\n  }[];\n  readonly receipt: DeviceScopeReceipt;\n}\n\nexport class LifecycleConstructionError extends Error {\n  readonly code = 'lifecycle-construction-failed' as const;\n  readonly expected = 'all DeviceScope resources establish and terminate in order';\n  readonly hint = 'inspect detail and cleanupFailures, then recover or rebuild the DeviceScope';\n  readonly detail: LifecycleConstructionFailureDetail;\n\n  constructor(detail: LifecycleConstructionFailureDetail) {\n    super(`lifecycle-construction-failed: ${detail.resourceKind} lifecycle transaction failed`);\n    this.name = 'LifecycleConstructionError';\n    this.detail = detail;\n  }\n}\n\nconst SURFACE_FAILURE_POLICY: Readonly<\n  Record<SurfaceFailureCode, { readonly expected: string; readonly hint: string }>\n> = {\n  'surface-allocation-failed': {\n    expected: 'the required surface resource can be allocated with its declared format and usage',\n    hint: 'inspect the capability detail, release transient resources, and retry the candidate graph',\n  },\n  'surface-attachment-failed': {\n    expected: 'the float target is renderable as the declared attachment',\n    hint: 'verify float color attachment support and retry without hiding the failure',\n  },\n  'surface-sampled-read-failed': {\n    expected: 'the float target can be sampled by the next post-processing stage',\n    hint: 'verify sampled-read support for the declared format before rebuilding the graph',\n  },\n  'surface-view-domain-failed': {\n    expected: 'surface storage and display views preserve their declared color domains',\n    hint: 'repair the explicit format/domain pair and retry the candidate graph',\n  },\n  'surface-raw-endpoint-failed': {\n    expected: 'the surface presentation endpoint has descriptor, acquisition, and validation proof',\n    hint: 'run the concrete presentation probe; keep the last-known-good surface when proof is absent',\n  },\n};\n\n/** Render-surface failure with an exhaustive code and actionable detail. */\nexport class RenderSurfaceError<\n  Code extends SurfaceFailureCode = SurfaceFailureCode,\n> extends Error {\n  readonly code: Code;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderSurfaceFailureDetail;\n\n  constructor(code: Code, detail: RenderSurfaceFailureDetail) {\n    const policy = SURFACE_FAILURE_POLICY[code];\n    if (policy === undefined) {\n      throw new Error(`unknown render surface failure code: ${code}`);\n    }\n    super(`[RenderSurfaceError ${code}] expected: ${policy.expected}; hint: ${policy.hint}`);\n    this.name = 'RenderSurfaceError';\n    this.code = code;\n    this.expected = policy.expected;\n    this.hint = policy.hint;\n    this.detail = detail;\n  }\n}\n\nexport type { RenderSurfaceFailureDetail, SurfaceFailureCode, SurfaceFailureKind };\n\nexport type RenderSurfaceExpectedError = {\n  readonly [Code in SurfaceFailureCode]: RenderSurfaceError<Code>;\n}[SurfaceFailureCode];\n\n/** Construct the closed surface error from its failure-stage discriminant. */\nexport function createRenderSurfaceError(\n  kind: SurfaceFailureKind,\n  detail: RenderSurfaceFailureDetail,\n): RenderSurfaceExpectedError {\n  return new RenderSurfaceError(`surface-${kind}-failed` as SurfaceFailureCode, detail);\n}\n\nexport interface TemporalFrameSubmitDetail {\n  readonly reason: 'queue-submit-failed';\n}\n\nexport class TemporalFrameSubmitError extends Error {\n  readonly code = 'temporal-frame-submit-rejected' as const;\n  readonly expected = 'the staged frame is accepted by queue.submit before temporal facts advance';\n  readonly hint = 'inspect the queue submission and retry the frame after the device is available';\n  readonly detail: TemporalFrameSubmitDetail;\n\n  constructor(reason: 'queue-submit-failed') {\n    super(`temporal-frame-submit-rejected: ${reason}`);\n    this.name = 'TemporalFrameSubmitError';\n    this.detail = { reason };\n  }\n}\n\n// ── ShadowInvalidConfigError ──────────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'shadow-invalid-config'`.\n *\n * Emitted by `DirectionalLight.validate` shadow-field path when a field value violates\n * runtime constraints (e.g. mapSize < 1, cascadeCount not in {1..4}).\n * AI users access `.detail.field` / `.detail.value` / `.detail.min` /\n * `.detail.max` via property access — no string parsing.\n *\n * `max` is `undefined` for lower-bound-only validations (e.g. mapSize < 1).\n * feat-20260613-csm: max added for upper-bound cascade validations\n * (cascadeCount max=4, splitLambda max=1, cascadeBlend max=0.5).\n */\nexport interface ShadowInvalidConfigDetail {\n  readonly field: string;\n  readonly value: number;\n  readonly min: number;\n  readonly max?: number;\n}\n\n/**\n * Structured error for shadow component config validation failures.\n *\n * Emitted by `DirectionalLight.validate()` shadow-field path (mapSize / cascadeCount /\n * splitLambda / cascadeBlend / shadowDistance) and `PointLightShadow.validate()`\n * (mapSize / farPlane > nearPlane / pcfKernelSize); both shadow component\n * types share this single error class so `switch (err.code)` on\n * `RuntimeErrorCode` only needs one branch (charter P4 — closed-union SSOT).\n * Four-field surface per AGENTS.md error model:\n *   - `.code = 'shadow-invalid-config'` (closed RuntimeErrorCode)\n *   - `.expected` — expected-state description (programmatic predicate form)\n *   - `.hint` — actionable recovery guidance (imperative; AI users paste into\n *     spawn calls). Integer-typed fields (e.g. `cascadeCount`, `pcfKernelSize`)\n *     get an \"integer in [min, max]\" hint; otherwise \"[min, max]\" range or\n *     \"<comparator> min\".\n *   - `.detail = { field, value, min, max? }` — structured values (charter P4)\n *\n * 4th constructor parameter is a union over the two range shapes:\n *   - `number` — `max` for a closed `[min, max]` range (CSM cascadeCount /\n *     splitLambda / cascadeBlend). hint uses \"in [min, max]\"; integer-typed\n *     fields get \"integer in [min, max]\".\n *   - `'>' | '>='` — comparator for an open lower-bound predicate. `'>'` is\n *     used when `min` carries dynamic context (e.g. `farPlane > nearPlane` —\n *     the surfaced hint reads \"must be > nearPlane\" so AI users setting\n *     farPlane=nearPlane don't re-fail the spawn loop with the wrong cue).\n *   - `undefined` — defaults to `'>='`. Callsites for mapSize < 1 validation\n *     stay backward-compatible (3-arg form).\n */\nexport class ShadowInvalidConfigError extends Error {\n  readonly code = 'shadow-invalid-config' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: ShadowInvalidConfigDetail;\n\n  constructor(field: string, value: number, min: number, maxOrComparator?: number | '>' | '>=') {\n    const isComparator = maxOrComparator === '>' || maxOrComparator === '>=';\n    const max = !isComparator && typeof maxOrComparator === 'number' ? maxOrComparator : undefined;\n    const comparator: '>' | '>=' = isComparator ? (maxOrComparator as '>' | '>=') : '>=';\n    // Integer-typed fields get an \"integer in [min, max]\" hint when a range\n    // is supplied. Expand this set as new integer-typed shadow fields land.\n    const isInteger = field === 'cascadeCount' || field === 'pcfKernelSize';\n    // pcfKernelSize must be odd (kernel is symmetric around the center tap).\n    // Naming \"odd\" in the hint stops an AI retry from looping min->min+1 (4->6).\n    const isOdd = field === 'pcfKernelSize';\n    const hint =\n      max !== undefined\n        ? isInteger\n          ? `set ${field} to an integer in [${min}, ${max}]; got ${value}`\n          : `set ${field} to a value in [${min}, ${max}]; got ${value}`\n        : isOdd\n          ? `set ${field} to an odd integer ${comparator} ${min}; got ${value}`\n          : `set ${field} to a value ${comparator} ${min}; got ${value}`;\n    const expected =\n      max !== undefined ? `${field} in [${min}, ${max}]` : `${field} ${comparator} ${min}`;\n    super(\n      max !== undefined\n        ? `shadow component .${field} must be in [${min}, ${max}], got ${value}`\n        : `shadow component .${field} must be ${comparator} ${min}, got ${value}`,\n    );\n    this.name = 'ShadowInvalidConfigError';\n    this.hint = hint;\n    this.expected = expected;\n    this.detail = { field, value, min, ...(max !== undefined ? { max } : {}) };\n  }\n}\n\n// ── EquirectProjectionFailedError ────────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'equirect-projection-failed'`.\n *\n * Emitted when the equirect-to-cubemap IBL projection fails for the equirect\n * handle referenced by a `Skylight` / `SkyboxBackground` component. The handle\n * id is carried so AI users can trace which equirect source failed projection.\n * Degradation: the record arm records `status:'failed'`, binds the white-cube\n * fallback, fires this error ONCE, and does NOT retry the projection.\n *\n * feat-20260630 D-5: structured error with detail carrying the handle id.\n */\nexport interface EquirectProjectionFailedDetail {\n  readonly handle: number;\n}\n\n/**\n * Structured error for a failed equirect-to-cubemap IBL projection.\n *\n * Emitted by the record stage when the internal cubemap projection for an\n * equirect handle returns a failure (or records `status:'failed'`). Four-field\n * surface per AGENTS.md error model:\n *   - `.code = 'equirect-projection-failed'` (closed RuntimeErrorCode)\n *   - `.expected` — equirect-to-cubemap projection + IBL precompute succeeds\n *   - `.hint` — declare `Skylight{equirect}` with a valid HDR equirect source;\n *     check `device.caps.rgba16floatRenderable`. The projection is internal —\n *     there is no user upload call to retry\n *   - `.detail = { handle }` — the numeric equirect handle id for diagnostics\n */\nexport class EquirectProjectionFailedError extends Error {\n  readonly code = 'equirect-projection-failed' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: EquirectProjectionFailedDetail;\n\n  constructor(handle: number) {\n    const expected = `equirect handle ${handle} projects to a GPU cubemap + IBL precompute`;\n    const hint =\n      `equirect handle ${handle} referenced by Skylight/SkyboxBackground failed projection; ` +\n      `declare Skylight{equirect} with a valid HDR equirect source and check device.caps.rgba16floatRenderable. ` +\n      `The projection is internal (no user upload call); the record arm does not retry`;\n    super(`equirect handle ${handle} cubemap projection failed`);\n    this.name = 'EquirectProjectionFailedError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { handle };\n  }\n}\n\n// ── HdrpLightBudgetExceededError ───────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'hdrp-light-budget-exceeded'`.\n *\n * Emitted per-frame (once-per-frame fire) when light count exceeds HDRP budget.\n */\nexport interface HdrpLightBudgetExceededDetail {\n  readonly actual: number;\n  readonly budget: number;\n}\n\n/**\n * Structured error for HDRP light budget exceeded (AC-06/AC-07).\n *\n * Emitted per-frame in recordFrame when the total punctual light count\n * exceeds the HDRP budget (256). Fail-soft: fire once per frame, truncate to 256.\n *   - `.code = 'hdrp-light-budget-exceeded'` (closed RuntimeErrorCode)\n *   - `.expected` — 'light count <= 256'\n *   - `.hint` — 'reduce world light count or increase budget (OOS-hdrp-larger-budget)'\n *   - `.detail = { actual, budget }`\n */\nexport class HdrpLightBudgetExceededError extends Error {\n  readonly code = 'hdrp-light-budget-exceeded' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: HdrpLightBudgetExceededDetail;\n\n  constructor(actual: number, budget: number) {\n    const expected = `light count <= ${budget}`;\n    const hint =\n      `${actual} lights exceed HDRP budget ${budget}; ` +\n      'truncating to 256. Reduce light count or wait for OOS-hdrp-larger-budget';\n    super(`HDRP light budget exceeded: ${actual} > ${budget}`);\n    this.name = 'HdrpLightBudgetExceededError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { actual, budget };\n  }\n}\n\n// ── HdrpIndexListOverflowError ─────────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'hdrp-index-list-overflow'`.\n *\n * Emitted per-frame (once-per-frame fire) when the cluster binner overflows\n * the light index list capacity (65536). Upgraded from ClusterBinError.\n */\nexport interface HdrpIndexListOverflowDetail {\n  readonly actual: number;\n  readonly capacity: number;\n}\n\n/**\n * Structured error for HDRP cluster binner index list overflow (AC-24).\n *\n * Emitted per-frame in recordFrame when the CPU binner returns\n * `ClusterBinError('index-overflow')`. Fail-soft: fire once per frame,\n * continue rendering with what fit.\n *   - `.code = 'hdrp-index-list-overflow'` (closed RuntimeErrorCode)\n *   - `.expected` — 'light index list entries <= 65536'\n *   - `.hint` — 'reduce lights, shrink cluster grid, or increase capacity'\n *   - `.detail = { actual, capacity }`\n */\nexport class HdrpIndexListOverflowError extends Error {\n  readonly code = 'hdrp-index-list-overflow' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: HdrpIndexListOverflowDetail;\n\n  constructor(actual: number, capacity: number) {\n    const expected = `light index list entries <= ${capacity}`;\n    const hint =\n      `cluster binner overflow: writeCount ${actual} exceeds capacity ${capacity}; ` +\n      'reduce lights, shrink cluster grid, or increase LIGHT_INDEX_LIST_CAPACITY';\n    super(`HDRP index list overflow: ${actual} > ${capacity}`);\n    this.name = 'HdrpIndexListOverflowError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { actual, capacity };\n  }\n}\n\n// ── HdrpDeferredCapsInsufficientError ──────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'hdrp-deferred-caps-insufficient'`.\n *\n * Emitted when the Standard clustered lane has fewer than 4 color attachments,\n * meaning the deferred path cannot allocate 3 g-buffer color targets + depth.\n */\nexport interface HdrpDeferredCapsInsufficientDetail {\n  readonly actual: number;\n  readonly expected: number;\n}\n\n/**\n * Structured error for deferred-path capability gate failure.\n *\n * Emitted during Standard clustered lane validation — synchronous throw.\n *   - `.code = 'hdrp-deferred-caps-insufficient'` (closed RuntimeErrorCode)\n *   - `.expected` — 'maxColorAttachments >= 4'\n *   - `.hint` — actionable guidance to upgrade browser or select URP\n *   - `.detail = { actual, expected }`\n *\n * @see plan-strategy D-5 (capability validation, no silent fallback)\n */\nexport class HdrpDeferredCapsInsufficientError extends Error {\n  readonly code = 'hdrp-deferred-caps-insufficient' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: HdrpDeferredCapsInsufficientDetail;\n\n  constructor(actual: number) {\n    const _expected = 4;\n    const _expectedStr = `maxColorAttachments >= ${_expected}`;\n    const hint =\n      `WebGPU maxColorAttachments = ${actual} (need >= ${_expected}). ` +\n      'Upgrade browser to latest Chrome/Edge/Safari, or use URP (forgeax::urp) instead of HDRP.';\n    super(\n      `HDRP deferred caps insufficient: maxColorAttachments = ${actual} (need >= ${_expected})`,\n    );\n    this.name = 'HdrpDeferredCapsInsufficientError';\n    this.expected = _expectedStr;\n    this.hint = hint;\n    this.detail = { actual, expected: _expected };\n  }\n}\n\n// ── PointShadowAtlasUninitializedError ─────────────────────────────────────\n\n/**\n * Structured error for `ShadowAtlas.faceView` called before `ensure()`\n * allocated the cube_array texture. Replaces the prior bare\n * `throw new Error()` (Round-2 F-4: P3 closed-union compliance).\n *\n *   - `.code = 'point-shadow-atlas-uninitialized'`\n *   - `.expected` — call `ensure()` before iterating face views\n *   - `.hint` — gate `faceView` on `isAllocated()` or call `ensure()` once\n *     in the per-frame extract step before recording the 6 x N caster passes\n *   - `.detail = undefined` (no per-call data needed)\n */\nexport class PointShadowAtlasUninitializedError extends Error {\n  readonly code = 'point-shadow-atlas-uninitialized' as const;\n  readonly expected: string;\n  readonly hint: string;\n\n  constructor() {\n    const expected = 'ShadowAtlas.ensure() invoked before faceView()';\n    const hint =\n      'Gate faceView on isAllocated() or call ensure() once in the per-frame extract step before iterating face views';\n    super('ShadowAtlas.faceView called before ensure(); the cube_array texture is not allocated');\n    this.name = 'PointShadowAtlasUninitializedError';\n    this.expected = expected;\n    this.hint = hint;\n  }\n}\n\n// ── PointShadowAtlasBoundsViolationError ───────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'point-shadow-atlas-bounds-violation'`.\n *\n * Emitted by `ShadowAtlas.faceView` when `layer` falls outside `[0, layers)`\n * or `face` falls outside `[0, 6)`. Both axes are reported as\n * `{ axis, value, max }` so AI users discriminate without parsing the message.\n */\nexport interface PointShadowAtlasBoundsViolationDetail {\n  readonly axis: 'layer' | 'face';\n  readonly value: number;\n  readonly max: number;\n}\n\n/**\n * Structured error for `ShadowAtlas.faceView(layer, face)` arguments outside\n * the allocated atlas range. Replaces the prior bare `throw new Error()`\n * (Round-2 F-4: P3 closed-union compliance).\n *\n *   - `.code = 'point-shadow-atlas-bounds-violation'`\n *   - `.expected` — `0 <= layer < layers && 0 <= face < 6`\n *   - `.hint` — clamp `shadowAtlasLayer` or face index before calling\n *     `faceView`; the cap on layers is `PointLightShadow` cardinality (4)\n *   - `.detail = { axis, value, max }` — discriminates layer vs face\n */\nexport class PointShadowAtlasBoundsViolationError extends Error {\n  readonly code = 'point-shadow-atlas-bounds-violation' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointShadowAtlasBoundsViolationDetail;\n\n  constructor(axis: 'layer' | 'face', value: number, max: number) {\n    const expected = `0 <= ${axis} < ${max}`;\n    const hint =\n      axis === 'layer'\n        ? `clamp PointLight.shadowAtlasLayer to [0, ${max}); the cap on layers equals PointLightShadow cardinality (4)`\n        : `clamp face index to [0, ${max}); cube faces are indexed 0..5 in +X/-X/+Y/-Y/+Z/-Z order`;\n    super(`ShadowAtlas.faceView ${axis} out of range: ${value} (must be in [0, ${max}))`);\n    this.name = 'PointShadowAtlasBoundsViolationError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { axis, value, max };\n  }\n}\n\n// ── VideoUploadUnsupportedError ─────────────────────────────────────────\n\n/**\n * Structured error for `RuntimeErrorCode 'video-upload-unsupported'`\n * (feat-20260623-world-space-video-asset M3 / w11 — AC-10).\n *\n * Fired by the per-frame record stage (`videoTextureView`) when a VideoPlayer\n * entity can reach neither video upload path this frame: the general\n * `copyExternalImageToTexture` path (no host HTMLVideoElement resolved via\n * `VideoElementProvider`) AND the high-perf `GPUExternalTexture` path\n * (capability absent). The engine surfaces this explicit failure rather than\n * silently rendering a stale/garbage texture (charter P3, plan-strategy D-6).\n *   - `.code = 'video-upload-unsupported'`\n *   - `.expected` — at least one upload path available (host element or\n *     GPUExternalTexture capability)\n *   - `.hint` — actionable recovery: use a static texture or switch backend\n *   - `.detail` — undefined (no narrowed detail variant)\n */\nexport class VideoUploadUnsupportedError extends Error {\n  readonly code = 'video-upload-unsupported' as const;\n  readonly expected: string;\n  readonly hint: string;\n\n  constructor() {\n    const expected =\n      'at least one video upload path available: a host HTMLVideoElement (general copyExternalImageToTexture path) or GPUExternalTexture capability (high-perf path)';\n    const hint =\n      'this backend exposes no usable video upload path; render a static texture instead, or switch to a WebGPU backend that supports video texture upload';\n    super('video upload unsupported — no general or high-perf path available');\n    this.name = 'VideoUploadUnsupportedError';\n    this.expected = expected;\n    this.hint = hint;\n  }\n}\n\n// ── VertexStorageBufferUnavailableError ─────────────────────────────────\n\n/**\n * Structured error for missing vertex-stage storage buffer capability.\n *\n * Emitted at createRenderer time (cap-gate).\n *   - `.code = 'vertex-storage-buffer-unavailable'`\n *   - `.expected` — device.caps supports vertex-stage storage buffer\n *   - `.hint` — switch to a WebGPU adapter with vertex storage buffer support or use uniform-buffer fallback (OOS-uniform-palette)\n *   - `.detail` — undefined (no narrowed detail variant)\n */\nexport class VertexStorageBufferUnavailableError extends Error {\n  readonly code = 'vertex-storage-buffer-unavailable' as const;\n  readonly expected: string;\n  readonly hint: string;\n\n  constructor() {\n    const expected =\n      'device.caps supports vertex-stage storage buffer (maxStorageBuffersPerShaderStage >= 1)';\n    const hint =\n      'this device does not support vertex-stage storage buffers; skinning requires vertex-stage storage buffer access (OOS-uniform-palette fallback not implemented)';\n    super('vertex-stage storage buffer unavailable — skinning cannot operate');\n    this.name = 'VertexStorageBufferUnavailableError';\n    this.expected = expected;\n    this.hint = hint;\n  }\n}\n\n// ── VertexColorVariantConflictError ───────────────────────────────────────\n\nexport interface VertexColorVariantConflictDetail {\n  readonly authored: true;\n  readonly authoredValue: string;\n  readonly projected: boolean;\n}\n\n/** The authored color axis disagrees with the canonical geometry projection. */\nexport class VertexColorVariantConflictError extends Error {\n  readonly code = 'vertex-color-variant-conflict' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: VertexColorVariantConflictDetail;\n\n  constructor(authoredValue: string, projected: boolean) {\n    const expected = `VERTEX_COLOR_AVAILABLE=${projected ? 'true' : 'false'}`;\n    const hint =\n      'derive the shader variant from the mesh VertexLayoutProjection; COLOR_0 presence is a geometry fact';\n    super(`authored vertex-color variant ${authoredValue} disagrees with projected ${expected}`);\n    this.name = 'VertexColorVariantConflictError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { authored: true, authoredValue, projected };\n  }\n}\n\n// ── Skin palette/material validation errors ────────────────────────────────\n\n/** Detail for a palette buffer that exceeds the device storage limit. */\nexport interface SkinPaletteOverflowDetail {\n  readonly requestedBytes: number;\n  readonly limit: number;\n}\n\n/**\n * Structured render error for a skin palette allocation that exceeds the\n * device storage-buffer binding limit. The allocator that emits this error\n * lives in render, so the error belongs to the render union rather than the\n * renderer-independent skinning binding package.\n */\nexport class SkinPaletteOverflowError extends Error {\n  readonly code = 'skin-palette-overflow' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: SkinPaletteOverflowDetail;\n\n  constructor(requestedBytes: number, limit: number) {\n    const expected = `skinned joint palette (${requestedBytes} B) fits within device.limits.maxStorageBufferBindingSize (${limit} B)`;\n    const hint =\n      'palette buffer exceeds device maxStorageBufferBindingSize; reduce skinned entity count or split into multiple palette buffers (OOS-skin-palette-batch)';\n    super(`skin palette buffer needs ${requestedBytes} B, exceeds device limit ${limit} B`);\n    this.name = 'SkinPaletteOverflowError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { requestedBytes, limit };\n  }\n}\n\n/** Detail for a skinned entity using a non-skin material shader. */\nexport interface SkinMaterialMismatchDetail {\n  readonly entity: number;\n  readonly actualShader: string | undefined;\n}\n\n/** Structured render error for a Skin/non-skin-material mismatch. */\nexport class SkinMaterialMismatchError extends Error {\n  readonly code = 'skin-material-mismatch' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: SkinMaterialMismatchDetail;\n\n  constructor(entity: number, actualShader: string | undefined) {\n    const expected = \"Skin entity's first material program module === 'forgeax::pbr-skin'\";\n    const hint = `entity ${entity} has Skin but the first material program module is ${actualShader ?? '<empty>'}; load the mesh via the gltf importer (cooker auto-routes 'forgeax::pbr-skin' for skinned primitives), or remove the Skin component to render the entity unskinned with Materials.standard / Materials.unlit`;\n    super(\n      `Skin / material mismatch on entity ${entity}: expected forgeax::pbr-skin, got ${actualShader ?? '<empty>'}`,\n    );\n    this.name = 'SkinMaterialMismatchError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { entity, actualShader };\n  }\n}\n\n/** Detail for a pbr-skin material whose mesh lacks skin attributes. */\nexport interface MaterialSkinAttrMissingDetail {\n  readonly entity: number;\n  readonly missing: 'skinIndex' | 'skinWeight' | 'both';\n}\n\n/** Structured render error for a pbr-skin material/mesh attribute mismatch. */\nexport class MaterialSkinAttrMissingError extends Error {\n  readonly code = 'material-skin-attr-missing' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: MaterialSkinAttrMissingDetail;\n\n  constructor(entity: number, missing: 'skinIndex' | 'skinWeight' | 'both') {\n    const expected = 'pbr-skin material requires mesh.attributes.skinIndex + skinWeight';\n    const hint = `entity ${entity} uses forgeax::pbr-skin but its MeshAsset is missing ${missing}; switch the entity to a skinned glTF mesh authored with JOINTS_0 + WEIGHTS_0, or change the material to a non-skin shader via Materials.standard / Materials.unlit`;\n    super(\n      `material/skin attribute mismatch on entity ${entity}: pbr-skin material with mesh missing ${missing}`,\n    );\n    this.name = 'MaterialSkinAttrMissingError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { entity, missing };\n  }\n}\n\nexport interface TransmissionCapabilityMissingDetail {\n  readonly material: string;\n  readonly capability: 'transmission';\n  readonly stage: 'prepare' | 'record';\n  readonly lane: 'standard-forward';\n  readonly format: string;\n  readonly missing: readonly TransmissionCapabilityFact[];\n}\n\nexport class TransmissionCapabilityMissingError extends Error {\n  readonly code = 'transmission-capability-missing' as const;\n  readonly expected = 'the renderer exposes the transmission capability for this material';\n  readonly hint = 'disable transmission or provide the renderer capability before drawing';\n  readonly detail: TransmissionCapabilityMissingDetail;\n\n  constructor(\n    material: string,\n    stage: 'prepare' | 'record',\n    evidence: {\n      readonly lane: 'standard-forward';\n      readonly format: string;\n      readonly missing: readonly TransmissionCapabilityFact[];\n    },\n  ) {\n    super(`transmission capability is missing for material '${material}'`);\n    this.name = 'TransmissionCapabilityMissingError';\n    this.detail = { material, capability: 'transmission', stage, ...evidence };\n  }\n}\n\n// -- RenderFeature errors ---------------------------------------------------\n\nexport type RenderFeatureErrorCode =\n  | 'render-feature-registration-conflict'\n  | 'render-feature-stage-failed'\n  | 'render-feature-capability-missing'\n  | 'render-feature-pass-order-conflict'\n  | 'render-feature-preparation-failed'\n  | 'render-feature-prepared-state-mismatch'\n  | 'render-feature-draw-recording-failed';\n\nexport interface RenderFeatureRegistrationConflictDetail {\n  readonly featureIdentity: string;\n  readonly order: number;\n  readonly conflictingOrder: number;\n}\n\nexport interface RenderFeatureCleanupFailure {\n  readonly featureIdentity: string;\n  readonly order: number;\n  readonly code: string;\n}\n\nexport interface RenderFeatureStageFailedDetail {\n  readonly featureIdentity: string;\n  readonly order: number;\n  readonly stage: RenderFeatureStage;\n  readonly recovery: RenderFeatureRecovery;\n  readonly cleanupFailures?: readonly RenderFeatureCleanupFailure[];\n}\n\nexport interface RenderFeatureCapabilityMissingDetail {\n  readonly featureIdentity: string;\n  readonly order: number;\n  readonly capability: RenderFeatureCapabilityKey;\n}\n\nexport interface RenderFeaturePassOrderConflictDetail {\n  readonly featureIdentity: string;\n  readonly order: number;\n  readonly passIdentity: string;\n  readonly dependencyIdentity: string;\n}\n\nexport interface RenderFeaturePreparationFailedDetail {\n  readonly featureIdentity: string;\n  readonly order: number;\n  readonly stage: 'prepare';\n  readonly operation: string;\n  readonly resourceKind: PreparedKind;\n  readonly resourceName: string;\n  readonly reason: string;\n  readonly recovery: RenderFeatureRecovery;\n}\n\nexport type RenderFeaturePreparedStateMismatchDetail =\n  | {\n      readonly featureIdentity: string;\n      readonly order: number;\n      readonly stage: 'contribute';\n      readonly operation: string;\n      readonly resourceKind: PreparedKind;\n      readonly reason: 'missing-prepared-state';\n      readonly missingResource: string;\n      readonly recovery: RenderFeatureRecovery;\n    }\n  | {\n      readonly featureIdentity: string;\n      readonly order: number;\n      readonly stage: 'contribute';\n      readonly operation: string;\n      readonly resourceKind: PreparedKind;\n      readonly reason: 'foreign-feature';\n      readonly expectedFeatureIdentity: string;\n      readonly actualFeatureIdentity: string;\n      readonly recovery: RenderFeatureRecovery;\n    }\n  | {\n      readonly featureIdentity: string;\n      readonly order: number;\n      readonly stage: 'contribute';\n      readonly operation: string;\n      readonly resourceKind: PreparedKind;\n      readonly reason: 'foreign-kind';\n      readonly expectedKind: PreparedKind;\n      readonly actualKind: PreparedKind;\n      readonly recovery: RenderFeatureRecovery;\n    }\n  | {\n      readonly featureIdentity: string;\n      readonly order: number;\n      readonly stage: 'contribute';\n      readonly operation: string;\n      readonly resourceKind: PreparedKind;\n      readonly reason: 'generation-mismatch';\n      readonly expectedGeneration: number;\n      readonly actualGeneration: number;\n      readonly recovery: RenderFeatureRecovery;\n    }\n  | {\n      readonly featureIdentity: string;\n      readonly order: number;\n      readonly stage: 'contribute';\n      readonly operation: string;\n      readonly resourceKind: PreparedKind;\n      readonly reason: 'layout-mismatch';\n      readonly expectedLayout: string;\n      readonly actualLayout: string;\n      readonly recovery: RenderFeatureRecovery;\n    }\n  | {\n      readonly featureIdentity: string;\n      readonly order: number;\n      readonly stage: 'contribute';\n      readonly operation: string;\n      readonly resourceKind: PreparedKind;\n      readonly reason: 'format-mismatch';\n      readonly expectedFormat: string;\n      readonly actualFormat: string;\n      readonly recovery: RenderFeatureRecovery;\n    };\n\nexport interface RenderFeatureDrawRecordingFailedDetail {\n  readonly featureIdentity: string;\n  readonly order: number;\n  readonly stage: 'record';\n  readonly operation: string;\n  readonly resourceKind: PreparedKind;\n  readonly reason: string;\n  readonly backendReason: string;\n  readonly recovery: RenderFeatureRecovery;\n}\n\nexport type RenderFeatureErrorDetailByCode = {\n  'render-feature-registration-conflict': RenderFeatureRegistrationConflictDetail;\n  'render-feature-stage-failed': RenderFeatureStageFailedDetail;\n  'render-feature-capability-missing': RenderFeatureCapabilityMissingDetail;\n  'render-feature-pass-order-conflict': RenderFeaturePassOrderConflictDetail;\n  'render-feature-preparation-failed': RenderFeaturePreparationFailedDetail;\n  'render-feature-prepared-state-mismatch': RenderFeaturePreparedStateMismatchDetail;\n  'render-feature-draw-recording-failed': RenderFeatureDrawRecordingFailedDetail;\n};\n\n/** Machine-readable four-field diagnostic exposed by every feature error. */\nexport type RenderFeatureErrorDescriptor = {\n  [Code in RenderFeatureErrorCode]: {\n    readonly code: Code;\n    readonly expected: string;\n    readonly hint: string;\n    readonly detail: RenderFeatureErrorDetailByCode[Code];\n  };\n}[RenderFeatureErrorCode];\n\nconst renderFeatureRecoveryHintByRecovery = {\n  'next-frame': (featureIdentity: string, stage: RenderFeatureStage) =>\n    `correct '${featureIdentity}' ${stage} data and retry on the next frame`,\n  'renderer-recover': (featureIdentity: string, _stage: RenderFeatureStage) =>\n    `wait for renderer recovery before retrying '${featureIdentity}'`,\n  registration: (featureIdentity: string, _stage: RenderFeatureStage) =>\n    `correct '${featureIdentity}' registration before retrying`,\n} satisfies Record<\n  RenderFeatureRecovery,\n  (featureIdentity: string, stage: RenderFeatureStage) => string\n>;\n\nexport class RenderFeatureRegistrationConflictError extends Error {\n  readonly code = 'render-feature-registration-conflict' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderFeatureRegistrationConflictDetail;\n\n  constructor(featureIdentity: string, order: number, conflictingOrder: number) {\n    const expected = `feature identity '${featureIdentity}' is unique`;\n    const hint = `rename '${featureIdentity}' or remove the duplicate feature before registration`;\n    super(`render feature registration conflict for '${featureIdentity}'`);\n    this.name = 'RenderFeatureRegistrationConflictError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { featureIdentity, order, conflictingOrder };\n  }\n}\n\nexport class RenderFeatureStageFailedError extends Error {\n  readonly code = 'render-feature-stage-failed' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderFeatureStageFailedDetail;\n\n  constructor(\n    featureIdentity: string,\n    order: number,\n    stage: RenderFeatureStage,\n    recovery: RenderFeatureRecovery,\n  ) {\n    const expected = `feature '${featureIdentity}' completes its ${stage} stage without an error`;\n    const hint = renderFeatureRecoveryHintByRecovery[recovery](featureIdentity, stage);\n    super(`render feature '${featureIdentity}' failed during ${stage}`);\n    this.name = 'RenderFeatureStageFailedError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { featureIdentity, order, stage, recovery };\n  }\n}\n\nexport class RenderFeatureCapabilityMissingError extends Error {\n  readonly code = 'render-feature-capability-missing' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderFeatureCapabilityMissingDetail;\n\n  constructor(\n    featureIdentity: string,\n    order: number,\n    capability: RenderFeatureCapabilityMissingDetail['capability'],\n  ) {\n    const expected = `device capability '${capability}' is available for feature '${featureIdentity}'`;\n    const hint = `disable '${featureIdentity}' or use a device with '${capability}' capability`;\n    super(`render feature '${featureIdentity}' requires missing capability '${capability}'`);\n    this.name = 'RenderFeatureCapabilityMissingError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { featureIdentity, order, capability };\n  }\n}\n\nexport class RenderFeaturePassOrderConflictError extends Error {\n  readonly code = 'render-feature-pass-order-conflict' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderFeaturePassOrderConflictDetail;\n\n  constructor(\n    featureIdentity: string,\n    order: number,\n    passIdentity: string,\n    dependencyIdentity: string,\n  ) {\n    const expected = `feature pass '${passIdentity}' follows dependency '${dependencyIdentity}'`;\n    const hint = `reorder '${featureIdentity}' passes so '${passIdentity}' follows '${dependencyIdentity}'`;\n    super(`render feature '${featureIdentity}' pass order conflict`);\n    this.name = 'RenderFeaturePassOrderConflictError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { featureIdentity, order, passIdentity, dependencyIdentity };\n  }\n}\n\nexport class RenderFeaturePreparationFailedError extends Error {\n  readonly code = 'render-feature-preparation-failed' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderFeaturePreparationFailedDetail;\n\n  constructor(\n    featureIdentity: string,\n    order: number,\n    operation: string,\n    resourceKind: RenderFeaturePreparationFailedDetail['resourceKind'],\n    resourceName: string,\n    reason: string,\n    recovery: RenderFeatureRecovery,\n  ) {\n    const expected = `${resourceKind} '${resourceName}' is prepared during ${operation}`;\n    const hint = `repair '${resourceName}' and retry feature '${featureIdentity}' on ${recovery}`;\n    super(`render feature '${featureIdentity}' preparation failed for '${resourceName}'`);\n    this.name = 'RenderFeaturePreparationFailedError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = {\n      featureIdentity,\n      order,\n      stage: 'prepare',\n      operation,\n      resourceKind,\n      resourceName,\n      reason,\n      recovery,\n    };\n  }\n}\n\nexport class RenderFeaturePreparedStateMismatchError extends Error {\n  readonly code = 'render-feature-prepared-state-mismatch' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderFeaturePreparedStateMismatchDetail;\n\n  constructor(detail: RenderFeaturePreparedStateMismatchDetail) {\n    const expected = `${detail.resourceKind} state is compatible for '${detail.operation}'`;\n    const hint = `repair '${detail.reason}' for feature '${detail.featureIdentity}' and retry`;\n    super(`render feature '${detail.featureIdentity}' prepared state mismatch`);\n    this.name = 'RenderFeaturePreparedStateMismatchError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = detail;\n  }\n}\n\nexport class RenderFeatureDrawRecordingFailedError extends Error {\n  readonly code = 'render-feature-draw-recording-failed' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderFeatureDrawRecordingFailedDetail;\n\n  constructor(\n    featureIdentity: string,\n    order: number,\n    operation: string,\n    resourceKind: RenderFeatureDrawRecordingFailedDetail['resourceKind'],\n    reason: string,\n    backendReason: string,\n    recovery: RenderFeatureRecovery,\n  ) {\n    const expected = `${resourceKind} recording succeeds for '${operation}'`;\n    const hint = `repair '${reason}' and retry feature '${featureIdentity}' after ${recovery}`;\n    super(`render feature '${featureIdentity}' draw recording failed`);\n    this.name = 'RenderFeatureDrawRecordingFailedError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = {\n      featureIdentity,\n      order,\n      stage: 'record',\n      operation,\n      resourceKind,\n      reason,\n      backendReason,\n      recovery,\n    };\n  }\n}\n\n// ── ObservationUnavailableError ───────────────────────────────────────────\n\nexport type ObservationUnavailableReason =\n  | 'no-frame'\n  | 'resource'\n  | 'copy-src'\n  | 'stale'\n  | 'identity'\n  | 'format'\n  | 'readback-failed';\n\nexport interface ObservationUnavailableDetail {\n  readonly reason: ObservationUnavailableReason;\n  readonly recovery: 'draw-current-frame' | 'enable-copy-src' | 'retry-readback';\n}\n\n/** A producer-owned current-frame observation could not be made available. */\nexport class ObservationUnavailableError extends Error {\n  readonly code = 'observation-unavailable' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: ObservationUnavailableDetail;\n\n  constructor(reason: ObservationUnavailableReason, hint: string) {\n    let recovery: ObservationUnavailableDetail['recovery'];\n    if (reason === 'copy-src') recovery = 'enable-copy-src';\n    else if (reason === 'resource' || reason === 'readback-failed') recovery = 'retry-readback';\n    else recovery = 'draw-current-frame';\n    super(`current-frame observation unavailable: ${reason}`);\n    this.name = 'ObservationUnavailableError';\n    this.expected = 'a fresh producer-owned rgba16float current-frame observation';\n    this.hint = hint;\n    this.detail = { reason, recovery };\n  }\n}\n\nexport type SceneDataUnavailableReason =\n  | 'capability-missing'\n  | 'producer-missing'\n  | 'coverage-incomplete'\n  | 'renderer-recovering';\nexport interface SceneDataUnavailableDetail {\n  readonly featureIdentity: string;\n  readonly schema: SceneDataSchemaId;\n  readonly lane: SceneDataLane;\n  readonly reason: SceneDataUnavailableReason;\n  readonly missingContributorIds: readonly string[];\n  readonly omittedMissingContributorCount: number;\n  readonly recovery: 'enable-capability' | 'next-frame' | 'renderer-recover';\n}\nexport class SceneDataUnavailableError extends Error {\n  readonly code = 'scene-data-unavailable' as const;\n  readonly expected = 'the requested semantic scene data is available for the active plan';\n  readonly hint: string;\n  readonly detail: SceneDataUnavailableDetail;\n  constructor(detail: SceneDataUnavailableDetail) {\n    const hint =\n      detail.recovery === 'enable-capability'\n        ? 'enable rgba16floatRenderable and retry the current frame'\n        : detail.recovery === 'renderer-recover'\n          ? 'wait for renderer recovery, then retry the frame'\n          : 'restore the producer coverage and retry on the next frame';\n    super(`scene data '${detail.schema}' unavailable for '${detail.featureIdentity}'`);\n    this.name = 'SceneDataUnavailableError';\n    this.hint = hint;\n    this.detail = Object.freeze({\n      ...detail,\n      missingContributorIds: Object.freeze([...detail.missingContributorIds].slice(0, 32)),\n      omittedMissingContributorCount: Math.max(\n        detail.omittedMissingContributorCount,\n        Math.max(0, detail.missingContributorIds.length - 32),\n      ),\n    });\n  }\n}\n\nexport class TaaUnavailableError extends Error {\n  readonly code = 'taa-unavailable' as const;\n  readonly expected =\n    'Standard TAA has a renderable rgba16float target and a complete resolve path';\n  readonly hint =\n    'enable rgba16float rendering or select none/fxaa explicitly; do not treat TAA as no-AA';\n  readonly detail: {\n    readonly reason: 'capability' | 'topology' | 'history';\n    readonly observed?: string;\n  };\n  constructor(reason: 'capability' | 'topology' | 'history', observed?: string) {\n    super(`taa-unavailable: ${reason}`);\n    this.name = 'TaaUnavailableError';\n    this.detail = observed === undefined ? { reason } : { reason, observed };\n  }\n}\n\nexport interface FrameReceiptStaleDetail {\n  readonly frameId: number;\n  readonly receiptGeneration: number;\n  readonly currentGeneration: number;\n}\n\n/** Receipt-bound observation failed closed at a generation fence. */\nexport class FrameReceiptStaleError extends Error {\n  readonly code = 'frame-receipt-stale' as const;\n  readonly expected = 'the observation receipt belongs to the active device generation';\n  readonly hint = 'draw a new frame and call observe with its returned FrameReceipt';\n  readonly detail: FrameReceiptStaleDetail;\n\n  constructor(detail: FrameReceiptStaleDetail) {\n    super('frame receipt belongs to a retired device generation');\n    this.name = 'FrameReceiptStaleError';\n    this.detail = detail;\n  }\n}\n\nexport interface RendererContractFailureDetail {\n  readonly operation: 'construct' | 'attach' | 'draw' | 'observe';\n  readonly cause: string;\n}\n\n/** Structured boundary failure while adapting an owner contract. */\nexport class RendererContractFailureError extends Error {\n  readonly code = 'renderer-contract-failed' as const;\n  readonly expected = 'renderer owner contracts remain valid at the public boundary';\n  readonly hint = 'repair the owner contract and retry the operation';\n  readonly detail: RendererContractFailureDetail;\n\n  constructor(operation: RendererContractFailureDetail['operation'], cause: string) {\n    super(`renderer ${operation} contract failed: ${cause}`);\n    this.name = 'RendererContractFailureError';\n    this.detail = { operation, cause };\n  }\n}\n\nexport interface EnvironmentSourceConflictDetail {\n  readonly owners: readonly {\n    readonly kind: 'image' | 'atmosphere';\n    readonly entityKey: number;\n    readonly sourceKey: string;\n  }[];\n}\n\nexport class EnvironmentSourceConflictError extends Error {\n  readonly code = 'environment-source-conflict' as const;\n  readonly expected = 'exactly one environment source owns the frame';\n  readonly hint = 'remove all but one image or atmosphere environment owner';\n  readonly detail: EnvironmentSourceConflictDetail;\n\n  constructor(owners: readonly EnvironmentSourceConflictDetail['owners'][number][]) {\n    super('environment source owners conflict');\n    this.name = 'EnvironmentSourceConflictError';\n    this.detail = { owners: owners.map((owner) => Object.freeze({ ...owner })) };\n  }\n}\n\nexport interface FogCardinalityDetail {\n  readonly count: number;\n}\n\nexport class FogCardinalityError extends Error {\n  readonly code = 'fog-cardinality' as const;\n  readonly expected = 'zero or one Fog owner contributes to a frame';\n  readonly hint = 'remove extra Fog owners so the resource owner has at most one';\n  readonly detail: FogCardinalityDetail;\n\n  constructor(count: number) {\n    super(`Fog owner cardinality is ${count}`);\n    this.name = 'FogCardinalityError';\n    this.detail = { count };\n  }\n}\n\nexport interface TaaCapsInsufficientDetail {\n  readonly required: readonly string[];\n  readonly available: readonly string[];\n}\n\nexport class TaaCapsInsufficientError extends Error {\n  readonly code = 'taa-caps-insufficient' as const;\n  readonly expected = 'the backend exposes the capabilities required by TAA';\n  readonly hint = 'select a backend with the required TAA capabilities or disable TAA on Camera';\n  readonly detail: TaaCapsInsufficientDetail;\n\n  constructor(required: readonly string[], available: readonly string[]) {\n    super('TAA capabilities are insufficient');\n    this.name = 'TaaCapsInsufficientError';\n    this.detail = { required: [...required], available: [...available] };\n  }\n}\n\nexport interface EnvironmentGenerationFailedDetail {\n  readonly sourceKey: string;\n  readonly stage: 'prepare' | 'build' | 'execute' | 'finish' | 'submit';\n}\n\nexport class EnvironmentGenerationFailedError extends Error {\n  readonly code = 'environment-generation-failed' as const;\n  readonly expected = 'the selected environment generation completes its owner stage';\n  readonly hint = 'inspect the stage and sourceKey, then retry after correcting the environment';\n  readonly detail: EnvironmentGenerationFailedDetail;\n\n  constructor(sourceKey: string, stage: EnvironmentGenerationFailedDetail['stage']) {\n    super(`environment generation failed during ${stage}`);\n    this.name = 'EnvironmentGenerationFailedError';\n    this.detail = { sourceKey, stage };\n  }\n}\n\nexport interface AtmosphereInvalidParameterDetail {\n  readonly field: string;\n  readonly value: number;\n}\n\nexport interface AtmosphereParameterRange {\n  readonly min: number;\n  readonly max: number;\n}\n\nexport class AtmosphereInvalidParameterError extends Error {\n  readonly code = 'atmosphere-invalid-parameter' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: AtmosphereInvalidParameterDetail;\n\n  constructor(field: string, value: number, range: AtmosphereParameterRange) {\n    super(`Atmosphere.${field} is invalid`);\n    this.name = 'AtmosphereInvalidParameterError';\n    this.detail = { field, value };\n    const rangeText = Number.isFinite(range.max)\n      ? `[${range.min}, ${range.max}]`\n      : `>= ${range.min}`;\n    this.expected = `Atmosphere.${field} must be finite and ${rangeText}`;\n    this.hint = `set Atmosphere.${field} to a finite value ${rangeText}`;\n  }\n}\n\nexport interface OwnerStageFailedDetail {\n  readonly owner: 'environment' | 'temporal' | 'fog' | 'renderer';\n  readonly stage: 'extract' | 'prepare' | 'record' | 'finish' | 'submit';\n}\n\nexport class OwnerStageFailedError extends Error {\n  readonly code = 'owner-stage-failed' as const;\n  readonly expected = 'the owner completes its current frame stage';\n  readonly hint = 'inspect the owner and stage, keep the last-known-good frame, and retry';\n  readonly detail: OwnerStageFailedDetail;\n\n  constructor(owner: OwnerStageFailedDetail['owner'], stage: OwnerStageFailedDetail['stage']) {\n    super(`${owner} owner failed during ${stage}`);\n    this.name = 'OwnerStageFailedError';\n    this.detail = { owner, stage };\n  }\n}\n\nexport interface RendererOperationCause {\n  readonly code: string;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail?: unknown;\n}\n\nexport interface RendererOperationDetailByCode {\n  readonly 'world-lease-invalid': {\n    readonly operation: 'attach' | 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'frame-input-invalid': {\n    readonly operation: 'draw' | 'set-profile';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'scene-projection-failed': {\n    readonly operation: 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'asset-binding-failed': {\n    readonly operation: 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'feature-plan-failed': {\n    readonly operation: 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'graph-build-failed': {\n    readonly operation: 'draw' | 'set-profile';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'device-operation-failed': {\n    readonly operation: 'draw' | 'complete-frame' | 'renderer-event';\n    readonly frameId?: number;\n    readonly deviceGeneration?: number;\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'surface-unavailable': {\n    readonly operation: 'release-surface' | 'restore-surface';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'renderer-state-invalid': {\n    readonly operation: 'draw' | 'set-profile' | 'recover' | 'dispose';\n    readonly state: string;\n    readonly cause?: RendererOperationCause;\n  };\n  readonly 'recovery-failed': {\n    readonly operation: 'recover';\n    readonly oldGeneration: number;\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'cleanup-failed': {\n    readonly operation: 'dispose';\n    readonly causes: readonly RendererOperationCause[];\n  };\n}\n\nexport type RendererOperationErrorCode = keyof RendererOperationDetailByCode;\n\nconst RENDERER_OPERATION_ERROR_POLICY = {\n  'world-lease-invalid': {\n    expected: 'every render World is represented by a live lease owned by this Renderer',\n    hint: 'attach the World to this Renderer and use the returned lease',\n  },\n  'frame-input-invalid': {\n    expected: 'the frame input references attached leases and a valid immutable RenderProfile',\n    hint: 'repair the frame input and retry draw or setProfile',\n  },\n  'scene-projection-failed': {\n    expected: 'the attached World projects into the renderer-owned RenderScene',\n    hint: 'inspect the structured cause, repair the World publication, and retry draw',\n  },\n  'asset-binding-failed': {\n    expected: 'all frame assets resolve to valid renderer-owned bindings',\n    hint: 'inspect the structured cause, rebuild or cold-cook the asset, and retry draw',\n  },\n  'feature-plan-failed': {\n    expected: 'every installed RenderFeature produces a valid declarative plan',\n    hint: 'inspect the feature cause, repair its plan, and retry draw',\n  },\n  'graph-build-failed': {\n    expected: 'the Standard graph builds from the active profile and feature plans',\n    hint: 'inspect the graph cause, repair the profile or plan, and retry',\n  },\n  'device-operation-failed': {\n    expected: 'the active device generation completes the renderer-owned operation',\n    hint: 'inspect renderer state and the structured cause, then retry or recover',\n  },\n  'surface-unavailable': {\n    expected: 'the presentation surface accepts the requested lifecycle operation',\n    hint: 'inspect renderer state, then restore the surface or create a new Renderer',\n  },\n  'renderer-state-invalid': {\n    expected: 'the Renderer is in a state that accepts the requested operation',\n    hint: 'inspect renderer state and choose retry, restoreSurface, recover, or stop',\n  },\n  'recovery-failed': {\n    expected: 'one recovery attempt publishes a complete replacement device generation',\n    hint: 'inspect the structured cause and retry recover after the host-selected delay',\n  },\n  'cleanup-failed': {\n    expected: 'Renderer disposal completes every registered cleanup in reverse ownership order',\n    hint: 'inspect the ordered cleanup causes; the Renderer remains disposed and must not be reused',\n  },\n} as const satisfies Readonly<\n  Record<RendererOperationErrorCode, { readonly expected: string; readonly hint: string }>\n>;\n\n/** Public renderer-operation failure with a code-narrowed structured detail. */\nexport class RendererOperationError<Code extends RendererOperationErrorCode> extends Error {\n  readonly code: Code;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RendererOperationDetailByCode[Code];\n\n  constructor(code: Code, detail: RendererOperationDetailByCode[Code]) {\n    const policy = RENDERER_OPERATION_ERROR_POLICY[code];\n    super(`${code}: ${policy.expected}`);\n    this.name = 'RendererOperationError';\n    this.code = code;\n    this.expected = policy.expected;\n    this.hint = policy.hint;\n    this.detail = detail;\n  }\n}\n\nexport type RendererExpectedOperationError = {\n  readonly [Code in RendererOperationErrorCode]: RendererOperationError<Code>;\n}[RendererOperationErrorCode];\n\n// -- Points/Lines admission errors -------------------------------------------\n\nexport interface PointsLinesInvalidStyleDetail {\n  readonly entity: number;\n  readonly component: 'Points' | 'Lines' | 'Points/Lines';\n  readonly field: string;\n  readonly value: number | string | undefined;\n  readonly expected: string;\n}\n\nexport class PointsLinesInvalidStyleError extends Error {\n  readonly code = 'points-lines-invalid-style' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesInvalidStyleDetail;\n\n  constructor(detail: PointsLinesInvalidStyleDetail) {\n    super(`invalid ${detail.component} style at ${detail.field}`);\n    this.name = 'PointsLinesInvalidStyleError';\n    this.expected = detail.expected;\n    this.hint = `repair entity ${detail.entity} ${detail.component}.${detail.field} and retry admission`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesTopologyMismatchDetail {\n  readonly entity: number;\n  readonly submesh: number;\n  readonly expected: string;\n  readonly actual: string;\n}\n\nexport class PointsLinesTopologyMismatchError extends Error {\n  readonly code = 'points-lines-topology-mismatch' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesTopologyMismatchDetail;\n\n  constructor(detail: PointsLinesTopologyMismatchDetail) {\n    super(`Points/Lines topology mismatch at submesh ${detail.submesh}`);\n    this.name = 'PointsLinesTopologyMismatchError';\n    this.expected = `submesh ${detail.submesh} topology is ${detail.expected}`;\n    this.hint = `rebuild entity ${detail.entity} with ${detail.expected} geometry before retrying Points/Lines admission`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesStyleUnsupportedDetail {\n  readonly lane: string;\n  readonly field: string;\n  readonly member: string;\n  readonly supported: readonly string[];\n}\n\nexport class PointsLinesStyleUnsupportedError extends Error {\n  readonly code = 'points-lines-style-unsupported' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesStyleUnsupportedDetail;\n\n  constructor(detail: PointsLinesStyleUnsupportedDetail) {\n    super(`unsupported Points/Lines ${detail.field} member ${detail.member}`);\n    this.name = 'PointsLinesStyleUnsupportedError';\n    this.expected = `${detail.field} is one of ${detail.supported.join(', ')}`;\n    this.hint = `use a supported Points/Lines ${detail.field} member or wait for a later milestone`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesMaterialUnsupportedDetail {\n  readonly entity: number;\n  readonly material: string;\n  readonly pass: string;\n  readonly module: string;\n  readonly reason: string;\n}\n\nexport class PointsLinesMaterialUnsupportedError extends Error {\n  readonly code = 'points-lines-material-unsupported' as const;\n  readonly expected = 'one engine-owned unlit forward MaterialAsset pass';\n  readonly hint: string;\n  readonly detail: PointsLinesMaterialUnsupportedDetail;\n\n  constructor(detail: PointsLinesMaterialUnsupportedDetail) {\n    super(`Points/Lines material is unsupported on entity ${detail.entity}`);\n    this.name = 'PointsLinesMaterialUnsupportedError';\n    this.hint = `use Materials.unlit without a shadow-caster pass for entity ${detail.entity}`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesBudgetExceededDetail {\n  readonly lane: string;\n  readonly requested: number;\n  readonly limit: number;\n  readonly unit: 'points' | 'segments' | 'vertices' | 'indices' | 'bytes' | 'draws';\n}\n\nexport class PointsLinesBudgetExceededError extends Error {\n  readonly code = 'points-lines-budget-exceeded' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesBudgetExceededDetail;\n\n  constructor(detail: PointsLinesBudgetExceededDetail) {\n    super(`Points/Lines ${detail.unit} budget exceeded`);\n    this.name = 'PointsLinesBudgetExceededError';\n    this.expected = `${detail.unit} <= ${detail.limit}`;\n    this.hint = `reduce Points/Lines ${detail.unit} or split the entity into bounded equivalent batches`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesPrepareFailedDetail {\n  readonly owner: string;\n  readonly generation: number;\n  readonly stage: 'prepare';\n  readonly cause: string;\n  readonly lastKnownGood: boolean;\n}\n\nexport class PointsLinesPrepareFailedError extends Error {\n  readonly code = 'points-lines-prepare-failed' as const;\n  readonly expected = 'the complete Points/Lines candidate validates before publication';\n  readonly hint: string;\n  readonly detail: PointsLinesPrepareFailedDetail;\n\n  constructor(detail: PointsLinesPrepareFailedDetail) {\n    super(`Points/Lines prepare failed at generation ${detail.generation}`);\n    this.name = 'PointsLinesPrepareFailedError';\n    this.hint = detail.lastKnownGood\n      ? 'retain the last known good candidate, repair the producer, and retry prepare'\n      : 'repair the producer and retry prepare; the failed first candidate produces zero draw';\n    this.detail = detail;\n  }\n}\n\nexport interface VolumeOwnerConflictDetail {\n  readonly ownerCount: number;\n}\n\nexport class VolumeOwnerConflictError extends Error {\n  readonly code = 'volume-owner-conflict' as const;\n  readonly expected = 'exactly one global VolumetricFog owner is authored';\n  readonly hint = 'remove additional VolumetricFog owners and retry extraction';\n  readonly detail: VolumeOwnerConflictDetail;\n\n  constructor(ownerCount: number) {\n    super(`volume-owner-conflict: received ${ownerCount} owners`);\n    this.name = 'VolumeOwnerConflictError';\n    this.detail = { ownerCount };\n  }\n}\n\nexport interface VolumeDensityShapeMismatchDetail {\n  readonly guid: string;\n  readonly viewDimension: string;\n}\n\nexport class VolumeDensityShapeMismatchError extends Error {\n  readonly code = 'volume-density-shape-mismatch' as const;\n  readonly expected = 'density is a linear 3D TextureAsset';\n  readonly hint = 'bind a verified linear texture with viewDimension 3d';\n  readonly detail: VolumeDensityShapeMismatchDetail;\n\n  constructor(guid: string, viewDimension: string) {\n    super(`volume-density-shape-mismatch: ${viewDimension} density is not 3d`);\n    this.name = 'VolumeDensityShapeMismatchError';\n    this.detail = { guid, viewDimension };\n  }\n}\n\nexport interface VolumeInvalidBoundsDetail {\n  readonly min: readonly [number, number, number];\n  readonly max: readonly [number, number, number];\n}\n\nexport class VolumeInvalidBoundsError extends Error {\n  readonly code = 'volume-invalid-bounds' as const;\n  readonly expected = 'bounds are finite and max is greater than min on every axis';\n  readonly hint = 'set finite non-degenerate volume bounds';\n  readonly detail: VolumeInvalidBoundsDetail;\n\n  constructor(bounds: VolumeInvalidBoundsDetail) {\n    super('volume-invalid-bounds: bounds must be finite and non-degenerate');\n    this.name = 'VolumeInvalidBoundsError';\n    this.detail = bounds;\n  }\n}\n\nexport interface VolumeInvalidParametersDetail {\n  readonly field: string;\n  readonly value: unknown;\n}\n\nexport class VolumeInvalidParametersError extends Error {\n  readonly code = 'volume-invalid-parameters' as const;\n  readonly expected = 'volume parameters remain finite and inside their closed ranges';\n  readonly hint = 'repair extinction, albedo, emission, anisotropy, or maxDistance';\n  readonly detail: VolumeInvalidParametersDetail;\n\n  constructor(input: { readonly maxDistance?: number; readonly anisotropy?: number }) {\n    const field =\n      input.maxDistance !== undefined && input.maxDistance <= 0 ? 'maxDistance' : 'parameters';\n    const value = field === 'maxDistance' ? input.maxDistance : input.anisotropy;\n    super(`volume-invalid-parameters: ${field} is outside the authored range`);\n    this.name = 'VolumeInvalidParametersError';\n    this.detail = { field, value };\n  }\n}\n\nexport type VolumeError =\n  | VolumeOwnerConflictError\n  | VolumeDensityShapeMismatchError\n  | VolumeInvalidBoundsError\n  | VolumeInvalidParametersError;\n\nexport interface ProjectorBindingDetail {\n  readonly guid: string;\n  readonly status: 'pending' | 'invalid' | 'bind-failed';\n}\n\nexport class ProjectorBindingError extends Error {\n  readonly code = 'projector-binding-failed' as const;\n  readonly expected = 'authored projector is accepted and bound for both surface and volume';\n  readonly hint =\n    'inspect the projector Meta/Pack receipt, repair the source, and retry with the same GUID';\n  readonly detail: ProjectorBindingDetail;\n\n  constructor(guid: string, status: ProjectorBindingDetail['status']) {\n    super(`projector binding failed for ${guid}: ${status}`);\n    this.name = 'ProjectorBindingError';\n    this.detail = { guid, status };\n  }\n}\n\n// -- RenderErrorCode / RenderError closed unions --------------------------------\n\n/**\n * Closed union of render-cluster error codes. AI users perform exhaustive\n * `switch (err.code)` without default; TS guards completeness.\n */\nexport type RenderErrorCode = RenderError['code'];\n\n/**\n * Closed union of the render-cluster structured error classes, each carrying a\n * `RenderErrorCode` discriminant on `.code`.\n */\nexport type RenderError =\n  | LifecycleConstructionError\n  | RendererExpectedOperationError\n  | FrameReceiptStaleError\n  | RendererContractFailureError\n  | ObservationUnavailableError\n  | SceneDataUnavailableError\n  | TaaUnavailableError\n  | ShadowInvalidConfigError\n  | EquirectProjectionFailedError\n  | HdrpLightBudgetExceededError\n  | HdrpIndexListOverflowError\n  | HdrpDeferredCapsInsufficientError\n  | PointShadowAtlasUninitializedError\n  | PointShadowAtlasBoundsViolationError\n  | VideoUploadUnsupportedError\n  | VertexStorageBufferUnavailableError\n  | VertexColorVariantConflictError\n  | SkinPaletteOverflowError\n  | SkinMaterialMismatchError\n  | MaterialSkinAttrMissingError\n  | TransmissionCapabilityMissingError\n  | RenderFeatureRegistrationConflictError\n  | RenderFeatureStageFailedError\n  | RenderFeatureCapabilityMissingError\n  | RenderFeaturePassOrderConflictError\n  | RenderFeaturePreparationFailedError\n  | RenderFeaturePreparedStateMismatchError\n  | RenderFeatureDrawRecordingFailedError\n  | EnvironmentSourceConflictError\n  | FogCardinalityError\n  | TaaCapsInsufficientError\n  | EnvironmentGenerationFailedError\n  | AtmosphereInvalidParameterError\n  | OwnerStageFailedError\n  | PointsLinesInvalidStyleError\n  | PointsLinesTopologyMismatchError\n  | PointsLinesStyleUnsupportedError\n  | PointsLinesMaterialUnsupportedError\n  | PointsLinesBudgetExceededError\n  | PointsLinesPrepareFailedError\n  | ProjectorBindingError\n  | VolumeError;\n","import { type RenderError, RenderFeaturePreparedStateMismatchError } from '../errors/render';\nimport type { RenderFeatureTargetHandle } from '../features/targets';\n\n/** The closed semantic schema namespace published by the render owner. */\nexport const SCENE_DATA_TEMPORAL_V1_SCHEMA = 'forgeax::scene-data::temporal-v1' as const;\nexport type SceneDataSchemaId = typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n\nexport type SceneDataLane = 'direct' | 'clustered' | 'cpu-webgl2';\n\nexport interface SceneDataTemporalV1Descriptor {\n  readonly schema: typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n  readonly format: 'rgba16float';\n  readonly sampleCount: 1;\n  readonly extent: 'render-resolution';\n  readonly clearValue: readonly [0, 0, -1, 1];\n  readonly channels: Readonly<{\n    readonly motionUv: 'rg';\n    readonly viewDepth: 'b-log2-1-plus-depth';\n    readonly reactive: 'a';\n  }>;\n}\n\nexport const SCENE_DATA_TEMPORAL_V1_DESCRIPTOR: SceneDataTemporalV1Descriptor = Object.freeze({\n  schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n  format: 'rgba16float',\n  sampleCount: 1,\n  extent: 'render-resolution',\n  clearValue: [0, 0, -1, 1] as const,\n  channels: Object.freeze({\n    motionUv: 'rg',\n    viewDepth: 'b-log2-1-plus-depth',\n    reactive: 'a',\n  }),\n});\n\n/** Opaque, sampled-read-only semantic data token. */\nexport interface SceneDataTarget<Schema extends SceneDataSchemaId = SceneDataSchemaId> {\n  readonly kind: 'scene-data';\n  readonly schema: Schema;\n  readonly access: 'sampled-read';\n  readonly format: 'rgba16float';\n  readonly sampleCount: 1;\n  readonly extent: 'render-resolution';\n  readonly __sceneDataTarget: unique symbol;\n}\n\nexport type SceneDataTokenMismatch = RenderFeaturePreparedStateMismatchError;\n\nconst targetOwners = new WeakMap<object, SceneDataCatalogIdentity>();\n\nexport interface SceneDataCatalogIdentity {\n  readonly featureIdentity: string;\n  readonly planIdentity: string;\n  readonly generation: number;\n}\n\nexport function registerSceneDataTarget(\n  target: SceneDataTarget,\n  owner: SceneDataCatalogIdentity,\n): void {\n  targetOwners.set(target, owner);\n}\n\nexport function sceneDataTargetOwner(\n  target: SceneDataTarget,\n): SceneDataCatalogIdentity | undefined {\n  return typeof target === 'object' && target !== null ? targetOwners.get(target) : undefined;\n}\n\nexport function sceneDataTokenMismatch(\n  operation: string,\n  reason: 'foreign-feature' | 'foreign-kind' | 'generation-mismatch' | 'layout-mismatch',\n  owner: SceneDataCatalogIdentity,\n  target: Partial<SceneDataTarget> | undefined,\n): SceneDataTokenMismatch {\n  const detail =\n    reason === 'generation-mismatch'\n      ? {\n          featureIdentity: owner.featureIdentity,\n          order: -1,\n          stage: 'contribute' as const,\n          operation,\n          resourceKind: 'attachment' as const,\n          reason,\n          expectedGeneration: owner.generation,\n          actualGeneration: targetOwners.get(target as object)?.generation ?? -1,\n          recovery: 'renderer-recover' as const,\n        }\n      : reason === 'foreign-feature'\n        ? {\n            featureIdentity: owner.featureIdentity,\n            order: -1,\n            stage: 'contribute' as const,\n            operation,\n            resourceKind: 'attachment' as const,\n            reason,\n            expectedFeatureIdentity: owner.featureIdentity,\n            actualFeatureIdentity: targetOwners.get(target as object)?.featureIdentity ?? 'unknown',\n            recovery: 'next-frame' as const,\n          }\n        : reason === 'foreign-kind'\n          ? {\n              featureIdentity: owner.featureIdentity,\n              order: -1,\n              stage: 'contribute' as const,\n              operation,\n              resourceKind: 'attachment' as const,\n              reason,\n              expectedKind: 'attachment' as const,\n              actualKind: 'pipeline' as const,\n              recovery: 'next-frame' as const,\n            }\n          : {\n              featureIdentity: owner.featureIdentity,\n              order: -1,\n              stage: 'contribute' as const,\n              operation,\n              resourceKind: 'attachment' as const,\n              reason,\n              expectedLayout: 'sampled-read-temporal-v1',\n              actualLayout: target?.access ?? 'unknown',\n              recovery: 'next-frame' as const,\n            };\n  return new RenderFeaturePreparedStateMismatchError(detail);\n}\n\nexport function isSceneDataTarget(value: unknown): value is SceneDataTarget {\n  if (value === null || typeof value !== 'object') return false;\n  const candidate = value as Partial<SceneDataTarget>;\n  return (\n    candidate.kind === 'scene-data' &&\n    candidate.schema === SCENE_DATA_TEMPORAL_V1_SCHEMA &&\n    candidate.access === 'sampled-read' &&\n    candidate.format === 'rgba16float' &&\n    candidate.sampleCount === 1 &&\n    candidate.extent === 'render-resolution' &&\n    targetOwners.has(value)\n  );\n}\n\nexport function sceneDataTargetAsAttachment(_target: SceneDataTarget): never {\n  throw new TypeError('SceneDataTarget is sampled-read-only and cannot be used as an attachment');\n}\n\nexport type SceneDataTargetInput = RenderFeatureTargetHandle | SceneDataTarget;\n\nexport function sceneDataError(error: SceneDataTokenMismatch): RenderError {\n  return error;\n}\n","import { err, ok, type Result } from '@forgeax/engine-types';\nimport type { RenderError } from '../errors/render';\nimport { SceneDataUnavailableError } from '../errors/render';\nimport {\n  registerSceneDataTarget,\n  SCENE_DATA_TEMPORAL_V1_DESCRIPTOR,\n  SCENE_DATA_TEMPORAL_V1_SCHEMA,\n  type SceneDataLane,\n  type SceneDataSchemaId,\n  type SceneDataTarget,\n  sceneDataTargetOwner,\n  sceneDataTokenMismatch,\n} from './scene-data';\n\nexport type SceneDataAvailability =\n  | {\n      readonly status: 'available';\n      readonly completeness: 'exact' | 'exact-with-reactive-fallback';\n    }\n  | {\n      readonly status: 'unavailable';\n      readonly reason:\n        | 'capability-missing'\n        | 'producer-missing'\n        | 'coverage-incomplete'\n        | 'renderer-recovering';\n    };\n\nexport interface SceneDataInspection {\n  readonly schema: SceneDataSchemaId;\n  readonly status: SceneDataAvailability['status'];\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly lane: SceneDataLane;\n  readonly completeness?: 'exact' | 'exact-with-reactive-fallback';\n  readonly reason?: Exclude<SceneDataAvailability, { status: 'available' }>['reason'];\n  readonly missingContributorIds: readonly string[];\n  readonly omittedMissingContributorCount: number;\n}\n\nexport interface SceneDataCatalogOptions {\n  readonly featureIdentity: string;\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly lane?: SceneDataLane;\n  readonly rgba16floatRenderable: boolean;\n  readonly producerPresent?: boolean;\n  readonly coverageComplete?: boolean;\n  readonly recovering?: boolean;\n  readonly reactiveFallback?: boolean;\n  readonly missingContributorIds?: readonly string[];\n}\n\nexport interface SceneDataCatalog {\n  readonly schema: typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly availability: SceneDataAvailability;\n  require<Schema extends SceneDataSchemaId>(schema: Schema): SceneDataTarget<Schema>;\n  validate(target: SceneDataTarget, generation?: number): Result<SceneDataTarget, RenderError>;\n  inspect(): SceneDataInspection;\n}\n\nfunction availability(options: SceneDataCatalogOptions): SceneDataAvailability {\n  if (options.recovering) return { status: 'unavailable', reason: 'renderer-recovering' };\n  if (!options.rgba16floatRenderable)\n    return { status: 'unavailable', reason: 'capability-missing' };\n  if (options.producerPresent === false)\n    return { status: 'unavailable', reason: 'producer-missing' };\n  if (options.coverageComplete === false)\n    return { status: 'unavailable', reason: 'coverage-incomplete' };\n  return {\n    status: 'available',\n    completeness: options.reactiveFallback ? 'exact-with-reactive-fallback' : 'exact',\n  };\n}\n\nfunction createTarget(owner: SceneDataCatalogOptions): SceneDataTarget {\n  const target = Object.freeze({\n    kind: 'scene-data' as const,\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    access: 'sampled-read' as const,\n    format: 'rgba16float' as const,\n    sampleCount: 1 as const,\n    extent: 'render-resolution' as const,\n  }) as SceneDataTarget;\n  registerSceneDataTarget(target, {\n    featureIdentity: owner.featureIdentity,\n    planIdentity: owner.planIdentity,\n    generation: owner.generation,\n  });\n  return target;\n}\n\nfunction tokenError(catalog: SceneDataCatalogOptions, operation: string): RenderError {\n  return sceneDataTokenMismatch(\n    operation,\n    'foreign-kind',\n    {\n      featureIdentity: catalog.featureIdentity,\n      planIdentity: catalog.planIdentity,\n      generation: catalog.generation,\n    },\n    undefined,\n  );\n}\n\nfunction unavailableError(\n  options: SceneDataCatalogOptions,\n  reason: Exclude<SceneDataAvailability, { status: 'available' }>['reason'],\n): RenderError {\n  const recovery =\n    reason === 'capability-missing'\n      ? 'enable-capability'\n      : reason === 'renderer-recovering'\n        ? 'renderer-recover'\n        : 'next-frame';\n  return new SceneDataUnavailableError({\n    featureIdentity: options.featureIdentity,\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    lane: options.lane ?? 'direct',\n    reason,\n    missingContributorIds: options.missingContributorIds ?? [],\n    omittedMissingContributorCount: 0,\n    recovery,\n  });\n}\n\nexport function createSceneDataCatalog(options: SceneDataCatalogOptions): SceneDataCatalog {\n  const state = availability(options);\n  const owner = {\n    featureIdentity: options.featureIdentity,\n    planIdentity: options.planIdentity,\n    generation: options.generation,\n  };\n  const missing = [...(options.missingContributorIds ?? [])];\n  const inspectionBase = {\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    generation: options.generation,\n    planIdentity: options.planIdentity,\n    lane: options.lane ?? 'direct',\n    missingContributorIds: Object.freeze(missing.slice(0, 32)),\n    omittedMissingContributorCount: Math.max(0, missing.length - 32),\n  };\n  return {\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    generation: options.generation,\n    planIdentity: options.planIdentity,\n    availability: state,\n    require(schema) {\n      if (schema !== SCENE_DATA_TEMPORAL_V1_SCHEMA || state.status !== 'available') {\n        if (state.status === 'unavailable') throw unavailableError(options, state.reason);\n        throw tokenError(options, 'require scene-data target');\n      }\n      return createTarget(options) as SceneDataTarget<typeof schema>;\n    },\n    validate(target, generation = options.generation) {\n      const targetOwner = sceneDataTargetOwner(target);\n      if (targetOwner === undefined) {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'foreign-feature', owner, target),\n        );\n      }\n      if (\n        targetOwner.planIdentity !== owner.planIdentity ||\n        targetOwner.featureIdentity !== owner.featureIdentity\n      ) {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'foreign-feature', owner, target),\n        );\n      }\n      if (generation !== owner.generation || targetOwner.generation !== owner.generation) {\n        return err(\n          sceneDataTokenMismatch(\n            'validate scene-data target',\n            'generation-mismatch',\n            owner,\n            target,\n          ),\n        );\n      }\n      if (target.access !== 'sampled-read') {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'layout-mismatch', owner, target),\n        );\n      }\n      return ok(target);\n    },\n    inspect() {\n      return Object.freeze(\n        state.status === 'available'\n          ? { ...inspectionBase, status: state.status, completeness: state.completeness }\n          : { ...inspectionBase, status: state.status, reason: state.reason },\n      );\n    },\n  };\n}\n\nexport { SCENE_DATA_TEMPORAL_V1_SCHEMA } from './scene-data';\nexport { SCENE_DATA_TEMPORAL_V1_DESCRIPTOR };\n","export const STANDARD_PIPELINE_ID = 'forgeax::standard' as const;\nexport const STANDARD_LIGHT_COUNTS = [1, 32, 256] as const;\n/** Shared clustered-lighting facts consumed by pipeline, record, and buffers. */\nexport const DEFAULT_CLUSTER_GRID = { x: 16, y: 9, z: 24 } as const;\nexport const CLUSTER_GRID_STRIDE_U32 = 2;\nexport const LIGHT_INDEX_LIST_CAPACITY = 1048576;\nexport const MAX_LIGHTS = 256;\n\nexport type StandardLightCount = (typeof STANDARD_LIGHT_COUNTS)[number];\nexport type StandardLightingLane = 'direct' | 'clustered';\nexport type StandardFallbackLane = 'native' | 'cpu-webgl2';\nexport type StandardShadowMode = 'off' | 'hard' | 'filtered';\nexport type StandardTone =\n  | 'none'\n  | 'aces-filmic'\n  | 'agx'\n  | 'cineon'\n  | 'linear'\n  | 'neutral'\n  | 'reinhard'\n  | 'reinhard-extended';\nexport type StandardAntialias = 'none' | 'fxaa' | 'msaa';\nexport const STANDARD_POST_STAGE_NAMES = [\n  'transparent-blend',\n  'bloom',\n  'output-transform',\n  'fxaa',\n  'post-effect',\n  'present',\n] as const;\nexport type StandardPostStage = (typeof STANDARD_POST_STAGE_NAMES)[number];\nexport type StandardVolumetricFogQuality = 'low' | 'high';\n\nexport interface StandardVolumetricFogProfile {\n  readonly quality: StandardVolumetricFogQuality;\n  readonly depth: 48 | 64;\n  readonly tileSize: 4 | 16;\n}\n\nexport interface StandardProfile {\n  readonly pipelineId: typeof STANDARD_PIPELINE_ID;\n  readonly lightCount: StandardLightCount;\n  readonly lighting: StandardLightingLane;\n  readonly shadows: StandardShadowMode;\n  readonly pbr: boolean;\n  readonly ibl: boolean;\n  readonly ssao: boolean;\n  readonly bloom: boolean;\n  readonly tone: StandardTone;\n  readonly antialias: StandardAntialias;\n  readonly sky: boolean;\n  /** Renderer-owned 1080p volume profile; tile width/height remain surface-derived. */\n  readonly volumetricFog?: StandardVolumetricFogProfile | undefined;\n  readonly fallback: StandardFallbackLane;\n  readonly postStages: typeof STANDARD_POST_STAGE_NAMES;\n}\n\nexport const DEFAULT_STANDARD_PROFILE: StandardProfile = Object.freeze({\n  pipelineId: STANDARD_PIPELINE_ID,\n  lightCount: 32,\n  lighting: 'direct',\n  shadows: 'filtered',\n  pbr: true,\n  ibl: true,\n  ssao: false,\n  bloom: true,\n  tone: 'aces-filmic',\n  antialias: 'fxaa',\n  sky: true,\n  fallback: 'native',\n  postStages: STANDARD_POST_STAGE_NAMES,\n});\n\nexport function resolveVolumetricFogProfile(\n  profile: Pick<StandardProfile, 'volumetricFog'>,\n): StandardVolumetricFogProfile {\n  return profile.volumetricFog ?? { quality: 'high', depth: 64, tileSize: 4 };\n}\n\nexport type StandardLane = StandardLightingLane | 'cpu-webgl2';\n\nexport function resolveStandardLane(\n  profile: Pick<StandardProfile, 'lighting'>,\n  capabilities: { readonly compute: boolean; readonly storageBuffer: boolean },\n): StandardLane {\n  if (!capabilities.compute || !capabilities.storageBuffer) return 'cpu-webgl2';\n  return profile.lighting;\n}\n","import type { AssetRuntimeError } from '@forgeax/engine-assets-runtime';\nimport type { World } from '@forgeax/engine-ecs';\nimport type { RenderReadLease } from '@forgeax/engine-ecs/projection';\nimport type { Vec3 } from '@forgeax/engine-math';\nimport type { ProfileFrameToken, Profiler } from '@forgeax/engine-profiler';\nimport type { ColorValueDomain, RenderGraphError } from '@forgeax/engine-render-graph';\nimport type {\n  BindGroupLayout,\n  Buffer,\n  Result,\n  RhiCanvasSurfacePresentationProof,\n  RhiCaps,\n  RhiCommandEncoder,\n  RhiDevice,\n  RhiError,\n  RhiInstance,\n  RhiRenderPassEncoder,\n  RenderPipeline as RhiRenderPipeline,\n  Sampler,\n  Texture,\n  TextureFormat,\n  TextureView,\n} from '@forgeax/engine-rhi';\nimport type { SkinError } from '@forgeax/engine-skinning';\nimport type { ImageError } from '@forgeax/engine-types';\nimport type { RhiBackendInstrumentation } from './assembly/backend-contract';\nimport type { Antialias, BloomEnabled, Tonemap } from './components/camera';\nimport type { EnvironmentInspection } from './environment/inspection';\nimport type { RenderError } from './errors/render';\nimport type { RenderFeature, RenderFeatureDiagnostics } from './features/types';\nimport type { PostProcessShaderEntry } from './fullscreen-post-process-pass';\nimport type {\n  BloomInspection,\n  MotionBlurInspection,\n  RenderSceneInspection,\n  TemporalTargetInspection,\n  TransmissionInspection,\n} from './inspection-types';\nimport type { TemporalInspection } from './temporal/inspection';\n\nexport type { TransmissionInspection } from './inspection-types';\nexport type { PointsLinesInspection } from './points-lines/inspection';\n\nimport type { MeshMaterialBindingObservation } from './mesh-material-bindings';\nimport type { StandardProfile } from './pipeline/standard-profile';\nimport type { PostProcessError } from './post-process-errors';\nimport type { VolumeTimingObservation } from './record/gpu-timing';\nimport type { TemporalView } from './temporal/view';\nimport type { VolumetricFogInspection } from './volume/inspection';\n\nexport type RenderResult<T, E> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/** The only World data boundary accepted by the M6 renderer contract. */\nexport type RenderWorldLease = RenderReadLease;\n\n/**\n * Camera facts shared by extract, record, and scene owners.\n *\n * The extract stage resolves ECS camera state once and publishes this closed\n * POD contract. Keeping it beside the render lifecycle contracts prevents\n * extract from depending on the record implementation owner.\n */\nexport interface CameraSnapshot {\n  /** Stable ECS identity used by the frame plan's camera authority fact. */\n  readonly entityKey?: number;\n  /** World index supplied by the multi-world extract merge. */\n  readonly worldId?: number;\n  /** Camera-owned history generation forwarded into the frame plan. */\n  readonly historyVersion?: number;\n  /** World-space camera translation (mat4.getTranslation of Transform.world). */\n  readonly position: Vec3;\n  /** Resolved world-space camera mat4, copied from Transform.world. */\n  readonly world: Float32Array;\n  readonly fov: number;\n  readonly aspect: number;\n  readonly near: number;\n  readonly far: number;\n  /** Camera projection variant used by view and shadow matrix builders. */\n  readonly projection: 'perspective' | 'orthographic';\n  readonly orthoLeft: number;\n  readonly orthoRight: number;\n  readonly orthoBottom: number;\n  readonly orthoTop: number;\n  readonly tonemap: Tonemap;\n  readonly exposure: number;\n  readonly whitePoint: number;\n  readonly antialias: Antialias;\n  readonly bloom: BloomEnabled;\n  readonly bloomThreshold: number;\n  readonly bloomIntensity: number;\n  readonly bloomBlurRadius: number;\n  readonly clearColor: readonly [number, number, number, number];\n  /** Renderer-owned temporal projection used by Standard's TAA producer. */\n  readonly temporal?: TemporalView;\n  /** Active-camera motion blur parameters, present only when demanded. */\n  readonly motionBlur?: {\n    readonly shutterAngle: number;\n    readonly maxRadiusPixels: number;\n    readonly sampleCount: number;\n  };\n}\n\n/** Stable identity owned by the Standard feature host for output transform. */\nexport const STANDARD_OUTPUT_TRANSFORM_FEATURE_ID = 'forgeax::standard::output-transform';\n\nexport type {\n  EnvironmentFrame,\n  EnvironmentSource,\n  FogFrame,\n  FramePlan,\n} from './extract/environment';\nexport type { TemporalView } from './temporal/view';\n\n/**\n * Render-graph state exposed to pipeline declarations. Concrete pipeline\n * caches stay in the assembly owner; graph code only needs the two target\n * formats that affect fullscreen descriptors.\n */\ninterface RenderPipelineStateView {\n  readonly format: TextureFormat;\n  readonly colorAttachmentFormat: TextureFormat;\n  /** Renderer-owned View UBO shared by Standard lighting, shadows, and fog. */\n  readonly viewUniformBuffer: Buffer;\n  /** Renderer-owned SpotLight std430 buffer shared by Standard and volume. */\n  readonly pointLightsBuffer: Buffer;\n  readonly spotLightsBuffer: Buffer;\n  /** Fallback resources keep the shared view layout valid when no projector is authored. */\n  readonly defaultWhiteTextureView: TextureView;\n  readonly defaultSampler: Sampler;\n}\n\n/**\n * Narrow runtime capability consumed by typed graph primitives. The concrete\n * RenderSystemRuntime structurally satisfies this contract, but the public\n * frame surface does not depend on that assembly owner.\n */\ninterface RenderPipelineRuntime {\n  readonly device: RhiDevice;\n  /** Runtime-owned shader module factory used by built-in graph producers. */\n  readonly shaderModuleFactory?: {\n    createShaderModule(input: {\n      readonly code: string;\n      readonly label?: string | undefined;\n    }): import('@forgeax/engine-types').Result<\n      import('@forgeax/engine-rhi').ShaderModule,\n      RhiError\n    >;\n  };\n  readonly errorRegistry: { fire(error: RendererError): void };\n  readonly debugOverlay?: RenderDebugOverlay | undefined;\n  readonly lookupPostProcess?: (id: string) => PostProcessShaderEntry | undefined;\n  readonly getPostProcessParamsBuffer?: (id: string) => Buffer | undefined;\n  readonly getPostProcessPipeline?: (\n    id: string,\n    bgl: BindGroupLayout,\n    colorFormat: GPUTextureFormat,\n  ) => RhiRenderPipeline | null;\n}\n\n/**\n * Render-owned declaration for an app-provided debug overlay. App owns the\n * concrete DebugDraw instance and its GPU lifecycle; Render only records this\n * capability in the typed graph.\n */\nexport interface RenderDebugOverlay {\n  encode(\n    pass: RhiRenderPassEncoder,\n    viewProj: import('@forgeax/engine-math').Mat4,\n  ): Result<void, unknown>;\n}\n\n/**\n * The leaf frame context consumed by RenderPipeline and graph primitives.\n * Concrete assembly data is added only by the internal record extension in\n * render-system.ts, so this contract never imports the RenderSystem owner.\n */\nexport interface RenderPipelineContext {\n  readonly pipelineState: RenderPipelineStateView;\n  readonly runtime: RenderPipelineRuntime;\n  readonly encoder: RhiCommandEncoder;\n  readonly view: TextureView;\n  readonly clear: readonly [number, number, number, number] | number[];\n  readonly targetW: number;\n  readonly targetH: number;\n  readonly currentTexture: Texture;\n  readonly camera: CameraSnapshot;\n  /** Per-frame post-process parameter bytes keyed by shader id. */\n  readonly postProcessParams: ReadonlyMap<string, Uint8Array>;\n  readonly msaaActive: boolean;\n  readonly geometryColorResolveView: TextureView | null;\n  readonly ldrSpriteColorView: TextureView | null;\n  /** Renderer-owned volume resources prepared from the authored ECS snapshot. */\n  readonly volumetricFog?: VolumetricFogFrameContext;\n  /** Renderer-owned SpotLight projector resources, independent of fog. */\n  readonly spotLightProjector?: SpotLightProjectorFrameContext;\n  /** Build-time composed utility sources for the renderer-owned volume passes. */\n  readonly volumetricFogShaders?: VolumetricFogShaderSources;\n}\n\n/** Stable utility entry-point sources emitted by the shader manifest. */\nexport interface VolumetricFogShaderSources {\n  readonly inject: string;\n  readonly temporal: string;\n  readonly integrate: string;\n  readonly composite: string;\n}\n\n/**\n * GPU resources for one validated volumetric-fog candidate.  The record stage\n * owns residency and parameter uploads; graph passes consume this narrow view\n * and never reach into AssetRegistry or World.\n */\nexport interface VolumetricFogFrameContext {\n  readonly densityTexture: Texture;\n  readonly densityView: TextureView;\n  readonly paramsBuffer: Buffer;\n  readonly densityGeneration: number;\n  /** Accepted graph-owned history slot; null means first frame/reset. */\n  readonly historyReadSlot: 0 | 1 | null;\n  /** Pending graph-owned history slot; promoted only after queue.submit succeeds. */\n  readonly historyWriteSlot: 0 | 1;\n  readonly historyValid: boolean;\n  /** Accepted SpotLight projector resources resolved by the GPU residency owner. */\n  readonly projectorTexture?: Texture;\n  readonly projectorView?: TextureView;\n  readonly projectorSampler?: Sampler;\n}\n\n/**\n * GPU resources for the single surface SpotLight projector binding. The\n * projector is a SpotLight-owned cookie and therefore remains available when\n * volumetric fog is disabled; volume integration may reuse the same tuple.\n */\nexport interface SpotLightProjectorFrameContext {\n  readonly texture: Texture;\n  readonly view: TextureView;\n  readonly sampler: Sampler;\n}\n\n/**\n * The sole public renderer contract. Concrete assembly stays behind the host;\n * callers retain only leases, receipts, inspection PODs, and recovery Result.\n */\nexport interface Renderer {\n  attach(world: World): RenderResult<RenderWorldLease, RenderError>;\n  draw(input: RenderFrameInput): RenderResult<FrameReceipt, RenderError>;\n  setProfile(profile: RenderProfile): RenderResult<void, RenderError>;\n  state(): RendererState;\n  inspect(): RenderInspection;\n  observe(\n    receipt: FrameReceipt,\n    request: FrameObservationRequest,\n  ): Promise<RenderResult<FrameReceiptObservation, RenderError>>;\n  subscribe(listener: (event: RendererEvent) => void): () => void;\n  releaseSurface(): RenderResult<void, RenderError>;\n  restoreSurface(): RenderResult<void, RenderError>;\n  recover(): Promise<RenderResult<void, RenderError>>;\n  dispose(): Promise<RenderResult<void, RenderError>>;\n}\n\n/** The single public renderer lifecycle authority. */\nexport type RendererState = 'alive' | 'device-lost' | 'recovering' | 'faulted' | 'disposed';\n\n/** Immutable, inspectable quality and budget policy for the Standard pipeline. */\nexport type RenderProfile = StandardProfile;\n\n/** Ordered events projected from renderer state and expected-operation failures. */\nexport type RendererEvent =\n  | {\n      readonly kind: 'state-changed';\n      readonly previous: RendererState;\n      readonly current: RendererState;\n    }\n  | { readonly kind: 'error'; readonly error: RenderError }\n  /** Emitted only after the renderer's sole submit path returns a receipt. */\n  | {\n      readonly kind: 'frame-submitted';\n      readonly frameId: number;\n      readonly deviceGeneration: number;\n    };\n\n/** Package-local listener alias used by the renderer assembly implementation. */\nexport type RendererEventListener = (event: RendererEvent) => void;\n\n/**\n * Camera authority supplied for one frame; Render owns the lease contract and\n * the host releases it with the frame lifecycle. It is intentionally bound to\n * the attached scene lease and never accepts a backend object.\n */\nexport interface FrameCamera {\n  readonly lease: RenderWorldLease;\n  readonly entityKey?: number;\n}\n\n/**\n * Environment authority supplied for one frame. The scene/environment owner\n * supplies the identity; the host validates it against the attached lease.\n */\nexport interface FrameEnvironment {\n  readonly lease: RenderWorldLease;\n  readonly identity?: string;\n}\n\n/**\n * Receipt-bound observation selection. The request is consumed by `observe`\n * only with the matching FrameReceipt and returns a structured Result error\n * when the generation or frame identity is stale.\n */\nexport interface FrameObservationRequest {\n  readonly include: readonly ('timings' | 'draws' | 'bindings')[];\n}\n\n/**\n * Immutable synchronous proof that the sole host-owned submit reached the\n * queue. It is the only successful synchronous draw signal and is required by\n * every observation request.\n */\nexport interface FrameReceipt {\n  readonly frameId: number;\n  readonly deviceGeneration: number;\n  readonly completed: Promise<RenderResult<void, RenderError>>;\n}\n\n/**\n * The sole public draw input; World objects never cross this boundary. Render\n * owns extraction and graph interpretation, while the host owns encoding,\n * finish, submit, and recovery of the attached lease generation.\n */\nexport interface RenderFrameInput {\n  readonly leases: readonly RenderWorldLease[];\n  readonly camera: FrameCamera;\n  readonly environment: FrameEnvironment;\n  /** Optional profiler correlation token owned by App and consumed by Render. */\n  readonly profileFrame?: ProfileFrameToken;\n}\n\n/** Detached, bounded observation metadata tied to one FrameReceipt and request. */\nexport interface FrameReceiptObservation {\n  readonly frameId: number;\n  readonly deviceGeneration: number;\n  readonly include: readonly ('timings' | 'draws' | 'bindings')[];\n  readonly timings?: VolumeTimingObservation;\n}\n\n/** Stable backend facts for the Standard output transform projection. */\nexport interface RenderOutputInspection {\n  readonly outputTransform?: typeof STANDARD_OUTPUT_TRANSFORM_FEATURE_ID;\n  readonly displayEncoded: boolean;\n  readonly intermediateFormat?: TextureFormat;\n  /** Concrete surface route committed by configureSurface. */\n  readonly surfaceProfile?: 'dual-view' | 'raw-only';\n  /** Pass names from the same committed graph as the output facts. */\n  readonly graphPassNames: readonly string[];\n  /** Detached descriptor for the graph-owned output target, when present. */\n  readonly standardOutputColor?: RenderStandardOutputColorInspection;\n  readonly surfaceStorage: TextureFormat;\n  readonly surfaceDisplay: TextureFormat;\n  readonly endpoint: 'surface.storage.raw';\n  readonly capability: 'rgba16float-renderable' | 'surface-raw-endpoint' | 'unavailable';\n  readonly presentationProof?: RhiCanvasSurfacePresentationProof;\n  readonly error:\n    | {\n        readonly code: string;\n        readonly expected: string;\n        readonly hint: string;\n        readonly detail?: unknown;\n      }\n    | undefined;\n}\n\n/** Detached descriptor for the graph-owned display-encoded intermediate. */\nexport interface RenderStandardOutputColorInspection {\n  readonly format: TextureFormat;\n  readonly domain?: ColorValueDomain;\n  readonly width: number;\n  readonly height: number;\n  readonly sampleCount: number;\n  readonly usage: number;\n}\n\n/** Stable identity refs for a renderer-owned frame observation. */\nexport interface RenderObservationInspection {\n  readonly observationId: string;\n  readonly frameId: number;\n  /** Camera antialias mode used by the frame carrying this observation. */\n  readonly antialias?: Antialias;\n  /** Surface route committed for the same frame graph. */\n  readonly surfaceProfile?: 'dual-view' | 'raw-only';\n  /** Capability fact used when resolving a raw-only float target. */\n  readonly rgba16floatRenderable?: boolean;\n  /** Exact pass names and target descriptor from the committed graph. */\n  readonly passNames: readonly string[];\n  readonly standardOutputColor?: RenderStandardOutputColorInspection;\n}\n\n/**\n * Detached renderer facts for host diagnostics and capability selection.\n *\n * The snapshot contains only POD values. It never exposes a device, queue,\n * registry, encoder, or live renderer-owned collection.\n */\nexport interface RenderInspection {\n  readonly state: RendererState;\n  readonly surface: 'available' | 'released';\n  readonly profile: RenderProfile;\n  readonly capabilities: Readonly<RhiCaps>;\n  readonly frame: {\n    readonly frameId: number;\n    readonly deviceGeneration: number;\n  };\n  /** Renderer-owned authored volume projection and submit/LKG state. */\n  readonly volumetricFog?: VolumetricFogInspection;\n  readonly features: readonly string[];\n  /** Truthful lifecycle facts for every registered declarative feature. */\n  readonly featureDiagnostics: readonly RenderFeatureDiagnostics[];\n  readonly frustumStats: { readonly culled: number; readonly total: number };\n  readonly visibilityStats: { readonly explicitlyHidden: number };\n  readonly renderScene: RenderSceneInspection;\n  /** Last completed transmission candidate facts, detached from GPU handles. */\n  readonly transmission?: TransmissionInspection;\n  readonly meshMaterialBindings: readonly MeshMaterialBindingObservation[];\n  readonly perFramePassNames: readonly string[];\n  readonly bindGroupCounts: {\n    readonly createBindGroup: number;\n    readonly keys: readonly string[];\n  };\n  /** Output transform facts; never includes fixture metrics or pixel bytes. */\n  readonly outputTransform?: typeof STANDARD_OUTPUT_TRANSFORM_FEATURE_ID;\n  readonly displayEncoded: boolean;\n  readonly intermediateFormat?: TextureFormat;\n  readonly surfaceStorage: TextureFormat;\n  readonly surfaceDisplay: TextureFormat;\n  readonly endpoint: 'surface.storage.raw';\n  readonly capability: RenderOutputInspection['capability'];\n  readonly presentationProof?: RhiCanvasSurfacePresentationProof;\n  readonly error: RenderOutputInspection['error'];\n  readonly observation: RenderObservationInspection;\n  readonly environment: EnvironmentInspection;\n  readonly temporal: TemporalInspection;\n  readonly bloom: BloomInspection;\n  /** Semantic Standard temporal target metadata; no graph or RHI handles. */\n  readonly temporalTarget?: TemporalTargetInspection;\n  /** Renderer-owned Motion Blur facts; absent when no component is active. */\n  readonly motionBlur?: MotionBlurInspection;\n}\n\n/** Backend marker — single-element union preserved for future extensibility (D-2). */\n/**\n * `renderer.draw(worlds, options)` owner options\n * (feat-20260709-editor-world-partition M1 / w6, plan-strategy §2 D-3).\n *\n * The single `owner` index that previously served BOTH the surfaced cameras\n * and the singleton render resources (skylight / skybox / postProcessParams) is\n * split into two independent indices:\n *   - `cameraOwner`   — the world whose cameras are surfaced.\n *   - `resourceOwner` — the world whose skylight / skybox / postProcessParams\n *                       are surfaced.\n *\n * Both owners are always explicit. Single-world callers pass zero for both;\n * composite callers may select different worlds.\n */\nexport type DrawOwnerOptions = {\n  readonly cameraOwner: number;\n  readonly resourceOwner: number;\n  readonly profileFrame?: ProfileFrameToken;\n};\n\n/** Information attached to a device-loss notification. */\nexport interface RendererLostInfo {\n  /** Concise machine-readable cause, mapped to a single vocabulary. */\n  reason: string;\n  /** Free-form description (UA / extension / driver text). */\n  message: string;\n}\n\n/** Listener registered through `Renderer.onLost`. */\nexport type RendererLostListener = (info: RendererLostInfo) => void;\n\n/**\n * Composite error type retained for package-local renderer diagnostics. The\n * public Renderer projects expected operation failures through the single\n * `subscribe` event stream and its `error` event; this type does NOT define a\n * error; it only references the cluster unions whose members can arrive here.\n * As such it is an external wire alias (AGENTS.md Change stance add-only wire\n * exception), NOT the eliminated cross-cluster `RuntimeError` SSOT (D-3).\n *\n * Composition = `RhiError | RenderError | AssetRuntimeError | SkinError |\n * PostProcessError`. This equals the pre-decomposition\n * `RhiError | RuntimeError | PostProcessError` exactly: `RuntimeError` was\n * `RenderError | AssetRuntimeError | SkinError` (27 classes). `RecoverError`\n * and `EngineEnvironmentError` are intentionally excluded — neither is ever\n * emitted through the Renderer event stream (`RecoverError` returns from `recover()`,\n * `EngineEnvironmentError` throws at construction), matching the original\n * `RuntimeError` union which excluded both (OOS-3 behavior equivalence).\n *\n * AI consumers do `switch (err.code)` over the union: the disjoint\n * `RhiErrorCode` / `RenderErrorCode` / `AssetRuntimeErrorCode` / `SkinErrorCode`\n * / `PostProcessErrorCode` literal sets let TS narrow each arm to the concrete\n * class (charter P3 union discoverability — every fan-out member is reachable\n * in an exhaustive switch, no untyped escape). Example:\n *\n * ```ts\n * renderer.subscribe((event) => {\n *   if (event.kind !== 'error') return;\n *   switch (event.error.code) {\n *     case 'asset-not-registered': // AssetRuntimeError arm, err narrowed here\n *       return report(err.hint);\n *     // ...one arm per RhiErrorCode | RenderErrorCode | AssetRuntimeErrorCode\n *     //    | SkinErrorCode | PostProcessErrorCode member; no default needed,\n *     //    TS flags every unhandled code at compile time.\n *   }\n * });\n * ```\n */\nexport type RendererError =\n  | RhiError\n  | RenderGraphError\n  | ImageError\n  | RenderError\n  | AssetRuntimeError\n  | SkinError\n  | PostProcessError;\n\n/**\n * Package-local error listener retained for host assembly. Public consumers\n * use `Renderer.subscribe` and receive `RendererEvent` instead.\n */\nexport type RendererErrorListener = (error: RendererError) => void;\n\n/**\n * Built-in graph pass owners used as nested children of `record/graph-execute`.\n * Unknown extension pass names use the explicit `other` bucket so custom\n * pipelines retain a bounded catalog while the default render workload gets\n * actionable owner attribution.\n */\nexport const RENDER_GRAPH_EXECUTION_PHASE_CATALOG = [\n  'record/graph-execute/point-shadow',\n  'record/graph-execute/cluster-binner-upload',\n  'record/graph-execute/g-buffer',\n  'record/graph-execute/g-buffer/geometry-loop',\n  'record/graph-execute/g-buffer/material-bind-groups',\n  'record/graph-execute/g-buffer/pipeline-selection',\n  'record/graph-execute/g-buffer/draw-submit',\n  'record/graph-execute/ssao-calc',\n  'record/graph-execute/ssao-blur',\n  'record/graph-execute/lighting',\n  'record/graph-execute/forward',\n  'record/graph-execute/forward/geometry-loop',\n  'record/graph-execute/forward/material-bind-groups',\n  'record/graph-execute/forward/pipeline-selection',\n  'record/graph-execute/forward/draw-submit',\n  'record/graph-execute/output-transform',\n  'record/graph-execute/present',\n  'record/graph-execute/debug-overlay',\n  'record/graph-execute/shadow',\n  'record/graph-execute/spot-shadow',\n  'record/graph-execute/skybox',\n  'record/graph-execute/main',\n  'record/graph-execute/fxaa',\n  'record/graph-execute/bloom-bright',\n  'record/graph-execute/bloom-blur-h',\n  'record/graph-execute/bloom-blur-v',\n  'record/graph-execute/bloom-composite',\n  'record/graph-execute/other',\n] as const;\n\nexport type RenderGraphExecutionPhase = (typeof RENDER_GRAPH_EXECUTION_PHASE_CATALOG)[number];\n\n/** Bounded producer-owned children of the scene-state record owner. */\nexport const RENDER_HDRP_BINNER_PHASE_CATALOG = [\n  'record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy',\n  'record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/light-aabb',\n  'record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/cluster-occupancy',\n  'record/scene-state/hdrp-cluster/binner/cluster-reserve',\n  'record/scene-state/hdrp-cluster/binner/input-preparation',\n  'record/scene-state/hdrp-cluster/binner/bin-core',\n  'record/scene-state/hdrp-cluster/binner/light-index-write',\n  'record/scene-state/hdrp-cluster/binner/light-index-write/bounds-read',\n  'record/scene-state/hdrp-cluster/binner/light-index-write/cluster-write',\n] as const;\n\nexport const RENDER_HDRP_CLUSTER_PHASE_CATALOG = [\n  'record/scene-state/hdrp-cluster/binner',\n  ...RENDER_HDRP_BINNER_PHASE_CATALOG,\n  'record/scene-state/hdrp-cluster/payload-packing',\n  'record/scene-state/hdrp-cluster/buffer-upload',\n] as const;\n\nexport type RenderHdrpClusterPhase = (typeof RENDER_HDRP_CLUSTER_PHASE_CATALOG)[number];\n\nexport const RENDER_SCENE_STATE_PHASE_CATALOG = [\n  'record/scene-state/fold-buckets',\n  'record/scene-state/lighting-prep',\n  'record/scene-state/ambient-resolution',\n  'record/scene-state/directional-shadow-cache',\n  'record/scene-state/hdrp-cluster',\n  ...RENDER_HDRP_CLUSTER_PHASE_CATALOG,\n] as const;\n\n/**\n * Opt-in boundaries inside one `Renderer.draw` call. The observer is a\n * diagnostics seam only: it receives wall-time boundaries and must never be\n * required for rendering correctness. The stage names mirror the existing\n * engine-owned Extract / Prepare / Record orchestration so a host can measure\n * attribution without guessing from RHI command counts.\n */\nexport const RENDER_RECORD_PHASE_CATALOG = [\n  'record/scene-state',\n  ...RENDER_SCENE_STATE_PHASE_CATALOG,\n  'record/swapchain',\n  'record/render-graph',\n  'record/target-views',\n  'record/validation',\n  'record/dispatch-plan',\n  'record/uploads',\n  'record/bind-groups',\n  'record/graph-execute',\n  ...RENDER_GRAPH_EXECUTION_PHASE_CATALOG,\n] as const;\n\nexport type RenderRecordPhase = (typeof RENDER_RECORD_PHASE_CATALOG)[number];\n\nexport const RENDER_PHASE_CATALOG = [\n  'extract',\n  'bind-groups',\n  'features',\n  'sort',\n  'record',\n  ...RENDER_RECORD_PHASE_CATALOG,\n] as const;\n\nexport type RenderPhase = (typeof RENDER_PHASE_CATALOG)[number];\n\nexport type RenderPhaseSkipReason =\n  | 'feature-host-unavailable'\n  | 'feature-host-empty'\n  | 'pipeline-state-unavailable'\n  | 'camera-unavailable';\n\n/** First-version options bag (intentionally empty; reserved for v0.1). */\nexport interface RendererOptions {\n  /** Producer-owned features installed by the renderer host. */\n  readonly features?: readonly RenderFeature<unknown>[] | undefined;\n  /** Standard profile consumed by the single renderer-owned pipeline. */\n  readonly standardProfile?: RenderProfile | undefined;\n  /** Explicit profiler capability shared by App and Render. */\n  readonly profiler?: Profiler | undefined;\n  /** Explicitly request timestamp-query for receipt-bound GPU profiling. */\n  readonly captureGpuTimings?: boolean | undefined;\n  /** Optional host-owned RHI lifecycle instrumentation, such as recording. */\n  readonly rhiInstrumentation?: RhiBackendInstrumentation | undefined;\n  // feat-20260608-create-app-param-surface-trim / M1 / AC-02: `clearColor`\n  // was deleted as a one-cut breaking change (AGENTS.md Change stance +\n  // requirements constraint #1: no deprecation window, no shim). Scene\n  // clear color now lives on the Camera entity (`clearColor`, an inline\n  // array<f32,4> column as of feat-20260709 M3); zero-Camera fallback uses\n  // `ZERO_CAMERA_CLEAR_FALLBACK = [0, 0, 0, 1]` from\n  // `render-system-record`. AI users that pass `{ clearColor: [...] }` on\n  // RendererOptions still get a TS2353 excess-property error at compile time.\n  //\n  // feat-20260608-create-app-param-surface-trim / M2 / AC-06 + D-3:\n  // `shaderManifestUrl` was deleted from RendererOptions and moved to\n  // the third-arg `BundlerOptions` (build-tool injection channel). The\n  // fallback literal '/shaders/manifest.json' stays at the createRenderer\n  // body site (D-2 q5-A) so the LO 1.1 zero-config takeoff path keeps\n  // working without explicit injection. AI users that pass\n  // `{ shaderManifestUrl: '...' }` to RendererOptions get a TS2353\n  // excess-property error at compile time pointing them to the third\n  // arg (charter P1 progressive disclosure -- the message names\n  // BundlerOptions, not a free-form string).\n  /**\n   * M3 D-P4 escape hatch (feat-20260511-rhi-wgpu-impl): explicit\n   * `RhiInstance` injection bypasses the dynamic-import auto-select\n   * facade. When set, `createRenderer` uses this instance verbatim and\n   * neither concrete backend adapter is imported dynamically (charter\n   * proposition 5 discoverable opt-in /\n   * plan-strategy §6 M3 + §7.4 escape hatch + Bevy\n   * `RenderCreation::Manual` partial equivalent).\n   *\n   * Typical use cases:\n   *   - Testing / debugging — inject a deterministic stub.\n   *   - Pinning a specific backend even when the browser adapter is present,\n   *     for cross-shim regression tests.\n   *   - Advanced AI users implementing their own `RhiInstance` shim.\n   *\n   * AI users who want the default behaviour leave this field omitted;\n   * `navigator.gpu` presence/absence drives the dynamic import (see the\n   * `createRenderer` JSDoc for the full auto-select decision tree).\n   */\n  readonly rhi?: RhiInstance | undefined;\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// Renderer health / recover surface (feat-20260621-renderer-health-recover-skeleton M1)\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Closed union of renderer health states.\n *\n * 3 members per plan-strategy D-1:\n *   - `'alive'` — healthy baseline (registry not yet fired)\n *   - `'device-lost'` — device loss detected\n *   - `'internal-fault'` — internal renderer fault\n *\n * AI users exhaustively switch on `HealthReason` without default; TS guards\n * completeness.\n */\nexport type HealthReason = 'alive' | 'device-lost' | 'internal-fault';\n\n/** Detail for `HealthReason 'device-lost'`. */\nexport interface HealthDetailDeviceLost {\n  readonly lostReason: 'unknown' | 'destroyed';\n  readonly message: string;\n}\n\n/** Detail for `HealthReason 'internal-fault'`. */\nexport interface HealthDetailInternalFault {\n  readonly message: string;\n}\n\n/**\n * Pull-style health snapshot — discriminated union by `reason`.\n *\n * Per plan-strategy D-2: `switch(snap.reason)` narrows `snap.detail` to the\n * per-reason detail type automatically, with zero `as` casts. `alive` has no\n * `.detail` field; `device-lost` / `internal-fault` have a required `.detail`\n * of the respective variant.\n *\n *   - `recoverable` — explicit snapshot data owned by the lifecycle authority\n */\nexport type HealthSnapshot =\n  | { readonly reason: 'alive'; readonly recoverable: boolean }\n  | {\n      readonly reason: 'device-lost';\n      readonly detail: HealthDetailDeviceLost;\n      readonly recoverable: boolean;\n    }\n  | {\n      readonly reason: 'internal-fault';\n      readonly detail: HealthDetailInternalFault;\n      readonly recoverable: boolean;\n    };\n\n/**\n * Maps `HealthReason` to recoverable boolean per the derive table\n * (requirements section \"range\"):\n *\n *   | reason         | recoverable |\n *   |:---------------|:-----------|\n *   | `'alive'`      | false       |\n *   | `'device-lost'`| true        |\n *   | `'internal-fault'` | false   |\n */\n/** Callback type for `Renderer.onHealthChange`. */\nexport type HealthChangeListener = (snapshot: HealthSnapshot) => void;\n"]}

package/dist/components/light-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-helpers.d.ts","sourceRoot":"","sources":["../../src/components/light-helpers.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,GAAG,wBAAwB,CAAC;AAC3F,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;AAKvE;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,kBAAkB,GAAG,WAAW,EAC/C,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,GACvC,4BAA4B,GAAG,IAAI,CAUrC;AAED,wEAAwE;AACxE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CA+BvB;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CAgCvB;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CAMvB;AAED,yEAAyE;AACzE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CAavB"}
+{"version":3,"file":"light-helpers.d.ts","sourceRoot":"","sources":["../../src/components/light-helpers.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,GAAG,wBAAwB,CAAC;AAC3F,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;AAKvE;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,kBAAkB,GAAG,WAAW,EAC/C,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,GACvC,4BAA4B,GAAG,IAAI,CAUrC;AAED,wEAAwE;AACxE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CA+BvB;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CAoCvB;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CAMvB;AAED,yEAAyE;AACzE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,qBAAqB,CAavB"}

package/dist/components/spot-light.d.ts

@@ -1,3 +1,12 @@
+export interface SpotLightProjector {
+    readonly guid: string;
+    readonly generation: number;
+    readonly revision: number;
+}
+export interface SpotLightAuthoring {
+    /** Optional GUID-backed TextureAsset projector; absent keeps the normal spot path. */
+    readonly projector?: SpotLightProjector;
+}
 /**
  * Cone-restricted spot light (KHR_lights_punctual `spot` type).  Casts shadows
  * by default (castShadow defaults to true) — zero-config spawns project hard
@@ -32,6 +41,7 @@
  *   nearPlane                        — shadow-camera near (default 0.1)
  *   farPlane                         — shadow-camera far (default 50)
  *   pcfKernelSize odd >= 1           — PCF kernel width (default 3)
+ *   shadowIntensity in [0,1]         — residual light in shadow (default 1)
  *
  * Atlas capacity is capped at 4 castShadow spot lights by the extract stage;
  * the 5th light onward keeps direct illumination but shadowAtlasTile = -1
@@ -77,5 +87,7 @@ export declare const SpotLight: import("@forgeax/engine-ecs").Component<"SpotLig
     readonly nearPlane: "f32";
     readonly farPlane: "f32";
     readonly pcfKernelSize: "f32";
+    readonly shadowIntensity: "f32";
+    readonly projector: "shared<TextureAsset>";
 }>;
 //# sourceMappingURL=spot-light.d.ts.map

package/dist/components/spot-light.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spot-light.d.ts","sourceRoot":"","sources":["../../src/components/spot-light.ts"],"names":[],"mappings":"AAuCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;EAmBpB,CAAC"}
+{"version":3,"file":"spot-light.d.ts","sourceRoot":"","sources":["../../src/components/spot-light.ts"],"names":[],"mappings":"AAuCA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;EA0BpB,CAAC"}