@forgeax/engine-render 0.1.27 → 0.1.29

package/dist/chunk-ZZ4YQ474.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors/render.ts","../src/gpu-texture-usage.ts","../src/shadow-atlas.ts","../src/render-contract.ts"],"names":[],"mappings":"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","file":"chunk-ZZ4YQ474.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';\nimport type { RecoveryOutcome, RecoveryPhase } from './recover';\n\n// Public render errors keep one machine-readable order: closed `code`,\n// expected state, actionable `hint`, then typed `detail`. Consumers branch on\n// that shape and never use Error.message as a protocol.\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 type LightResourceFailureReason = 'asset' | 'format' | 'capability' | 'capacity';\n\nexport interface LightResourceUnavailableDetail {\n  readonly entity: number;\n  readonly feature: 'ies' | 'cookie' | 'probe';\n  readonly generation: number;\n  readonly sourceKey: string;\n  readonly reason: LightResourceFailureReason;\n}\n\nexport class LightResourceUnavailableError extends Error {\n  readonly code = 'light-resource-unavailable' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: LightResourceUnavailableDetail;\n\n  constructor(\n    detail: LightResourceUnavailableDetail,\n    expected: string,\n    actual: string,\n    hint: string,\n  ) {\n    super(`light-resource-unavailable: ${detail.feature} ${actual}`);\n    this.name = 'LightResourceUnavailableError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = detail;\n  }\n}\n\nexport function createLightResourceUnavailable(input: {\n  readonly entity: number;\n  readonly feature: LightResourceUnavailableDetail['feature'];\n  readonly generation: number;\n  readonly sourceKey: string;\n  readonly reason: LightResourceFailureReason;\n  readonly expected: string;\n  readonly actual: string;\n  readonly hint: string;\n}): LightResourceUnavailableError {\n  return new LightResourceUnavailableError(\n    {\n      entity: input.entity,\n      feature: input.feature,\n      generation: input.generation,\n      sourceKey: input.sourceKey,\n      reason: input.reason,\n    },\n    input.expected,\n    input.actual,\n    input.hint,\n  );\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// ── ShadowInvalidConfigError ──────────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'shadow-invalid-config'`.\n *\n * The four fields are the only recovery surface: AI users read the invalid\n * field, actual value, structured bound, and reason without parsing prose.\n */\nexport type ShadowInvalidConfigBound =\n  | { readonly kind: 'range'; readonly min: number; readonly max: number }\n  | { readonly kind: 'lower-bound'; readonly operator: '>' | '>='; readonly value: number }\n  | { readonly kind: 'allowed-values'; readonly values: readonly number[] };\n\nexport interface ShadowInvalidConfigDetail {\n  readonly field: string;\n  readonly actual: number;\n  readonly bound: ShadowInvalidConfigBound;\n  readonly reason: string;\n}\n\n/**\n * Structured error for shadow component config validation failures.\n *\n * Emitted by Directional, Point, and Spot shadow validation. All three\n * component owners share this error class so `switch (err.code)` on\n * `RuntimeErrorCode` needs one branch (charter P4 — closed-union SSOT).\n * Four-field surface:\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).\n *   - `.detail = { field, actual, bound, reason }` — structured values.\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(\n    field: string,\n    actual: number,\n    minOrBound: number | ShadowInvalidConfigBound,\n    maxOrComparator?: number | '>' | '>=',\n    reason?: string,\n  ) {\n    const bound: ShadowInvalidConfigBound =\n      typeof minOrBound === 'number'\n        ? typeof maxOrComparator === 'number'\n          ? { kind: 'range', min: minOrBound, max: maxOrComparator }\n          : {\n              kind: 'lower-bound',\n              operator: maxOrComparator === '>' ? '>' : '>=',\n              value: minOrBound,\n            }\n        : minOrBound;\n    const resolvedReason = reason ?? shadowBoundReason(bound);\n    const expected = shadowBoundExpected(field, bound);\n    const hint = `set ${field} to ${resolvedReason}; got ${actual}`;\n    super(`shadow component .${field} is invalid: ${resolvedReason}; got ${actual}`);\n    this.name = 'ShadowInvalidConfigError';\n    this.hint = hint;\n    this.expected = expected;\n    this.detail = { field, actual, bound, reason: resolvedReason };\n  }\n}\n\nfunction shadowBoundExpected(field: string, bound: ShadowInvalidConfigBound): string {\n  switch (bound.kind) {\n    case 'range':\n      return `${field} in [${bound.min}, ${bound.max}]`;\n    case 'lower-bound':\n      return `${field} ${bound.operator} ${bound.value}`;\n    case 'allowed-values':\n      return `${field} in {${bound.values.join(', ')}}`;\n  }\n}\n\nfunction shadowBoundReason(bound: ShadowInvalidConfigBound): string {\n  switch (bound.kind) {\n    case 'range':\n      return `a value in [${bound.min}, ${bound.max}]`;\n    case 'lower-bound':\n      return `a value ${bound.operator} ${bound.value}`;\n    case 'allowed-values':\n      return `one of [${bound.values.join(', ')}]`;\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// ── StandardLightBudgetExceededError ──────────────────────────────────────\n\n/** The finite local-light budget that a Standard frame agreed to admit. */\nexport interface StandardLightBudgetExceededDetail {\n  readonly actual: number;\n  readonly budget: number;\n}\n\n/**\n * Structured refusal for a Standard frame whose finite local-light set is\n * outside the selected profile budget. The frame is rejected as a whole; the\n * record owner must not slice the input or submit a partial membership set.\n */\nexport class StandardLightBudgetExceededError extends Error {\n  readonly code = 'standard-light-budget-exceeded' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: StandardLightBudgetExceededDetail;\n\n  constructor(actual: number, budget: number) {\n    const expected = `light count <= ${budget}`;\n    const hint =\n      `${actual} finite local lights exceed Standard budget ${budget}; ` +\n      'reduce the local-light set or select a profile with a supported budget';\n    super(`Standard light budget exceeded: ${actual} > ${budget}`);\n    this.name = 'StandardLightBudgetExceededError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { actual, budget };\n  }\n}\n\n// ── StandardClusterIndexOverflowError ──────────────────────────────────────\n\n/** Cluster membership entries that could not fit the single shared index list. */\nexport interface StandardClusterIndexOverflowDetail {\n  readonly actual: number;\n  readonly capacity: number;\n}\n\n/**\n * Structured refusal for a membership producer that exceeded the shared\n * Cluster index-list capacity. No truncated list is uploaded and no graph is\n * submitted for the rejected frame.\n */\nexport class StandardClusterIndexOverflowError extends Error {\n  readonly code = 'standard-cluster-index-overflow' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: StandardClusterIndexOverflowDetail;\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 finite local lights or choose a supported cluster layout';\n    super(`Standard cluster index list overflow: ${actual} > ${capacity}`);\n    this.name = 'StandardClusterIndexOverflowError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { actual, capacity };\n  }\n}\n\n// ── StandardClusterTransportUnavailableError ───────────────────────────────\n\nexport interface StandardClusterTransportUnavailableDetail {\n  readonly requested: number;\n  readonly admitted: 0;\n}\n\n/**\n * Structured capability refusal. Standard never turns an unproven transport\n * into a smaller direct-light lane; the caller receives the exact requested\n * local-light count and an admitted count of zero.\n */\nexport class StandardClusterTransportUnavailableError extends Error {\n  readonly code = 'standard-cluster-transport-unavailable' as const;\n  readonly expected = 'all requested local lights have a proven Cluster transport';\n  readonly hint: string;\n  readonly detail: StandardClusterTransportUnavailableDetail;\n\n  constructor(\n    requested: number,\n    hint = 'enable a proven Cluster storage transport before drawing',\n  ) {\n    super(`Standard Cluster transport unavailable for ${requested} local lights`);\n    this.name = 'StandardClusterTransportUnavailableError';\n    this.hint = hint;\n    this.detail = { requested, admitted: 0 };\n  }\n}\n\n// ── StandardProfileInvalidError ───────────────────────────────────────────\n\nexport interface StandardProfileInvalidDetail {\n  readonly field: string;\n  readonly actual: unknown;\n}\n\n/** Structured validation failure for the single Standard profile surface. */\nexport class StandardProfileInvalidError extends Error {\n  readonly code = 'standard-profile-invalid' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: StandardProfileInvalidDetail;\n\n  constructor(message: string, detail?: StandardProfileInvalidDetail) {\n    super(message);\n    this.name = 'StandardProfileInvalidError';\n    this.detail = detail ?? { field: 'profile', actual: message };\n    if (this.detail.field === 'clusterGrid') {\n      this.expected = 'clusterGrid.{x,y,z} each positive integer in [1, 64]';\n      this.hint =\n        'set clusterGrid.x, clusterGrid.y, and clusterGrid.z to positive integers in [1, 64]';\n    } else {\n      this.expected = 'StandardProfile contains only supported fields and values';\n      this.hint = 'repair the Standard profile fields and retry setProfile';\n    }\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 layer cap is the renderer-owned ShadowAtlas capacity\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 phase: RecoveryPhase;\n    readonly oldGeneration: number;\n    readonly candidateGeneration: number;\n    readonly attempt: number;\n    readonly elapsedMs: number;\n    readonly retryable: boolean;\n    readonly guidance: 'retry' | 'repair-owner' | 'rebuild-renderer';\n    readonly owner: string;\n    readonly resourceKind: string;\n    readonly lastOutcome: RecoveryOutcome;\n    readonly rehydratedRoots: number;\n    readonly staleLossEvents: number;\n    readonly cleanupFailures: readonly RendererOperationCause[];\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\n// -- RenderTarget errors ------------------------------------------------------\n\nexport interface RenderTargetDescriptorInvalidDetail {\n  readonly field: string;\n  readonly value: unknown;\n  readonly expected: string;\n}\n\nexport class RenderTargetDescriptorInvalidError extends Error {\n  readonly code = 'render-target-descriptor-invalid' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderTargetDescriptorInvalidDetail;\n\n  constructor(detail: RenderTargetDescriptorInvalidDetail) {\n    super(`render-target-descriptor-invalid: ${detail.field} does not satisfy ${detail.expected}`);\n    this.name = 'RenderTargetDescriptorInvalidError';\n    this.expected = detail.expected;\n    this.hint = `set RenderTargetDescriptor.${detail.field} to the expected value, then retry create or resize`;\n    this.detail = detail;\n  }\n}\n\nexport interface RenderTargetCapabilityMissingDetail {\n  readonly operation: 'create' | 'resize' | 'source' | 'readback';\n  readonly requested: string;\n  readonly capability: string;\n  readonly actual: string;\n}\n\nexport class RenderTargetCapabilityMissingError extends Error {\n  readonly code = 'render-target-capability-missing' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderTargetCapabilityMissingDetail;\n\n  constructor(detail: RenderTargetCapabilityMissingDetail) {\n    super(\n      `render-target-capability-missing: ${detail.capability} does not admit ${detail.requested}`,\n    );\n    this.name = 'RenderTargetCapabilityMissingError';\n    this.expected = `${detail.capability} admits ${detail.requested}`;\n    this.hint = `choose an admitted target descriptor or use a backend providing ${detail.capability}`;\n    this.detail = detail;\n  }\n}\n\nexport type RenderTargetStateInvalidReason =\n  | 'foreign-renderer'\n  | 'destroyed'\n  | 'uninitialized'\n  | 'generation-mismatch'\n  | 'readback-without-intent';\n\nexport interface RenderTargetStateInvalidDetail {\n  readonly operation: 'inspect' | 'resize' | 'source' | 'readback' | 'destroy';\n  readonly reason: RenderTargetStateInvalidReason;\n  readonly state: 'uninitialized' | 'candidate' | 'active' | 'rebuilding' | 'destroyed';\n  readonly generation: number;\n}\n\nexport class RenderTargetStateInvalidError extends Error {\n  readonly code = 'render-target-state-invalid' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderTargetStateInvalidDetail;\n\n  constructor(detail: RenderTargetStateInvalidDetail) {\n    super(`render-target-state-invalid: ${detail.operation} cannot use ${detail.reason}`);\n    this.name = 'RenderTargetStateInvalidError';\n    this.expected = `target state permits ${detail.operation}`;\n    this.hint =\n      'use the Renderer that created the target, then initialize, recover, or stop using the destroyed token';\n    this.detail = detail;\n  }\n}\n\nexport interface RenderTargetOperationFailedDetail {\n  readonly operation: 'create' | 'resize' | 'source' | 'readback' | 'destroy' | 'recover';\n  readonly stage: 'allocation' | 'compile' | 'write' | 'submit' | 'copy' | 'retire';\n  readonly generation: number;\n  readonly cause: unknown;\n  readonly recovery: 'retry' | 'recover' | 'retain-last-known-good';\n}\n\nexport class RenderTargetOperationFailedError extends Error {\n  readonly code = 'render-target-operation-failed' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderTargetOperationFailedDetail;\n\n  constructor(detail: RenderTargetOperationFailedDetail) {\n    super(`render-target-operation-failed: ${detail.operation} failed during ${detail.stage}`);\n    this.name = 'RenderTargetOperationFailedError';\n    this.expected = `${detail.operation} completes ${detail.stage}`;\n    this.hint =\n      'inspect detail.cause, then retry, recover the Renderer, or retain the last-known-good generation';\n    this.detail = detail;\n  }\n}\n\nexport interface ReflectionProbeBudgetExceededDetail {\n  readonly actual: number;\n  readonly budget: number;\n}\n\nexport class ReflectionProbeBudgetExceededError extends Error {\n  readonly code = 'reflection-probe-budget-exceeded' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: ReflectionProbeBudgetExceededDetail;\n\n  constructor(actual: number, budget: number) {\n    super(`reflection-probe-budget-exceeded: ${actual} > ${budget}`);\n    this.name = 'ReflectionProbeBudgetExceededError';\n    this.expected = `reflection probe work <= ${budget}`;\n    this.hint = 'reduce probe updates for this frame or raise the RenderProfile probe budget';\n    this.detail = { actual, budget };\n  }\n}\n\nexport interface RenderIntentInvalidDetail {\n  readonly component: 'CubeCamera' | 'ReflectionProbe';\n  readonly field: 'updateIntent';\n  readonly value: number;\n  readonly allowed: readonly [0, 1, 2];\n}\n\nexport class RenderIntentInvalidError extends Error {\n  readonly code = 'render-intent-invalid' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RenderIntentInvalidDetail;\n\n  constructor(component: RenderIntentInvalidDetail['component'], value: number) {\n    super(`render-intent-invalid: ${component}.updateIntent is not an admitted value`);\n    this.name = 'RenderIntentInvalidError';\n    this.expected = `${component}.updateIntent is one of 0, 1, or 2`;\n    this.hint = `set ${component}.updateIntent to 0, 1, or 2`;\n    this.detail = { component, field: 'updateIntent', value, allowed: [0, 1, 2] };\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  | StandardLightBudgetExceededError\n  | StandardClusterIndexOverflowError\n  | StandardClusterTransportUnavailableError\n  | StandardProfileInvalidError\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  | LightResourceUnavailableError\n  | RenderTargetDescriptorInvalidError\n  | RenderTargetCapabilityMissingError\n  | RenderTargetStateInvalidError\n  | RenderTargetOperationFailedError\n  | ReflectionProbeBudgetExceededError\n  | RenderIntentInvalidError\n  | ProjectorBindingError\n  | VolumeError;\n","// @forgeax/engine-runtime - render package texture usage values.\n//\n// Keep the WebGPU bit values in one dependency-free owner because render\n// package descriptor and graph builders also run against null and WebGL2-\n// compatible RHI shims where the browser's GPUTextureUsage global is absent.\n\nexport const GPU_TEXTURE_USAGE_COPY_SRC = 0x01;\nexport const GPU_TEXTURE_USAGE_COPY_DST = 0x02;\nexport const GPU_TEXTURE_USAGE_TEXTURE_BINDING = 0x04;\nexport const GPU_TEXTURE_USAGE_RENDER_ATTACHMENT = 0x10;\nexport const GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING =\n  GPU_TEXTURE_USAGE_RENDER_ATTACHMENT | GPU_TEXTURE_USAGE_TEXTURE_BINDING;\n","// @forgeax/engine-runtime - ShadowAtlas (cube_array depth atlas for point-light shadows).\n//\n// feat-20260612-point-light-shadows-urp-hdrp M3 / T-M3-1 (plan-strategy §D-1).\n//\n// Lazy-allocated `texture_depth_cube_array` (depth32float) + per-face 2D\n// TextureView cache. One layer per admitted shadow-casting PointLight; the\n// renderer owns the bounded atlas admission policy. Total texel footprint at\n// the 512x512 default = 4 layers x 6 faces x 512 x 512 x 4 B = 24 MiB.\n//\n// Why a separate module (vs inlining into createRenderer / pipelineState):\n// - zero-shadow scene path stays allocation-free (AC-09): we never call\n//   `device.createTexture` on the cube_array unless `ensure(...)` is invoked\n//   from the extract / record path on a frame that has at least one\n//   PointLightShadow snapshot.\n// - face-view cache is keyed (layer, face) and built lazily during the\n//   per-light shadow caster pass; the cache is invalidated together with the\n//   atlas when `dispose()` runs (renderer teardown or layers re-allocation).\n// - the helper descriptors live in `@forgeax/engine-rhi`\n//   (`cubeArrayDepthDescriptor` / `cubeArrayDepthFaceView` /\n//   `comparisonSamplerDescriptor`) per T-M0-3; this file is the runtime-side\n//   owner of the GPU resources they describe.\n//\n// Lifecycle:\n//   1. `new ShadowAtlas(device, { faceSize, layers })` — construct the\n//      manager; no GPU work yet.\n//   2. `atlas.ensure()` — first call allocates the cube_array texture +\n//      cube_array sampling view + comparison sampler (idempotent thereafter).\n//   3. `atlas.faceView(layer, face)` — lazy 2D depth view used as a render-\n//      pass attachment for the corresponding cube face. Cached per (layer,\n//      face).\n//   4. `atlas.dispose()` — releases the GPU resources and clears caches.\n//      `ensure()` after `dispose()` re-allocates from scratch.\n\nimport {\n  comparisonSamplerDescriptor,\n  cubeArrayDepthDescriptor,\n  cubeArrayDepthFaceView,\n  type RhiDevice,\n  type Sampler,\n  type Texture,\n  type TextureView,\n} from '@forgeax/engine-rhi';\n\nimport {\n  PointShadowAtlasBoundsViolationError,\n  PointShadowAtlasUninitializedError,\n} from './errors/render';\nimport { GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING } from './gpu-texture-usage';\n\n/**\n * Construction options for {@link ShadowAtlas}.\n */\nexport interface ShadowAtlasOptions {\n  /** Per-face square size in pixels. Default 512 (PointLightShadow.mapSize default). */\n  readonly faceSize?: number;\n  /** Number of cube layers. Default is the renderer atlas admission capacity. */\n  readonly layers?: number;\n}\n\n/** Default per-face square size in pixels. Mirrors PointLightShadow.mapSize default. */\nexport const SHADOW_ATLAS_DEFAULT_FACE_SIZE = 512;\n/** Default cube layer count. Renderer-owned point-shadow admission capacity. */\nexport const SHADOW_ATLAS_DEFAULT_LAYERS = 4;\n\n/**\n * Cube-array depth atlas for point-light shadows.\n *\n * Shape: `texture_depth_cube_array` (depth32float) with `layers` and per-\n * face size `faceSize x faceSize`. The cube_array sampling view feeds\n * `@group(0) @binding(5)` in URP shaders; the per-face 2D view feeds the\n * shadow-caster render pass attachment for one (layer, face) at a time\n * (WebGPU forbids cube views as render-pass attachments).\n *\n * Construction performs no GPU work. The first `ensure()` call allocates the\n * texture + view + sampler. `dispose()` releases everything; later `ensure()`\n * calls re-allocate.\n *\n * @example Lazy allocation in the extract / record path:\n * ```\n * if (lights.pointShadow.length > 0) {\n *   atlas.ensure();\n *   for (const ps of lights.pointShadow) {\n *     for (let face = 0; face < 6; face++) {\n *       const view = atlas.faceView(ps.shadowAtlasLayer, face);\n *       // ... begin shadow caster pass with `view` as the depth attachment\n *     }\n *   }\n * }\n * ```\n */\nexport class ShadowAtlas {\n  /** Backing cube_array depth texture. `null` until `ensure()` has run. */\n  private texture: Texture | null = null;\n  /**\n   * Whole-atlas cube_array sampling view used by URP shaders that bind the\n   * atlas at `@group(0) @binding(5)`. `null` until `ensure()` has run.\n   */\n  private cubeArrayView: TextureView | null = null;\n  /** Comparison sampler for `texture_depth_cube_array`. */\n  private compareSampler: Sampler | null = null;\n  /** Per-face 2D depth view cache, keyed by `layer * 6 + face`. */\n  private readonly faceViews = new Map<number, TextureView>();\n  /** Per-face label cache (debug aid). Reused on re-creation. */\n  private readonly device: RhiDevice;\n  /** Per-face square size in pixels. */\n  readonly faceSize: number;\n  /** Cube layer count. */\n  readonly layers: number;\n\n  constructor(device: RhiDevice, options: ShadowAtlasOptions = {}) {\n    this.device = device;\n    this.faceSize = options.faceSize ?? SHADOW_ATLAS_DEFAULT_FACE_SIZE;\n    this.layers = options.layers ?? SHADOW_ATLAS_DEFAULT_LAYERS;\n  }\n\n  /**\n   * Returns `true` once the atlas texture is allocated. Used by the extract /\n   * record path to gate \"no PointLightShadow → no allocation\" (AC-09) — the\n   * caller calls {@link ensure} on a frame that has at least one snapshot;\n   * before that, `isAllocated()` stays `false` and tests can assert no GPU\n   * resources were created.\n   */\n  isAllocated(): boolean {\n    return this.texture !== null;\n  }\n\n  /**\n   * Lazy-allocate the atlas texture + cube_array sampling view + comparison\n   * sampler. Idempotent: subsequent calls are zero-cost no-ops once the\n   * resources exist.\n   *\n   * Throws (via the RHI error registry) on allocation failure. This is the\n   * only path that touches the GPU — keeping it inside one method makes the\n   * \"zero-shadow scene = zero allocation\" gate easy to enforce: the renderer\n   * never calls this method on a frame with no PointLightShadow entities.\n   */\n  ensure(): void {\n    if (this.texture !== null) return;\n    const usage = GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING;\n    const texDesc = cubeArrayDepthDescriptor(this.faceSize, this.layers, usage);\n    const texRes = this.device.createTexture(texDesc);\n    if (!texRes.ok) throw texRes.error;\n    this.texture = texRes.value;\n\n    const viewRes = this.device.createTextureView(this.texture, {\n      label: 'shadow-atlas-cube-array-view',\n      dimension: 'cube-array',\n      aspect: 'depth-only',\n      baseArrayLayer: 0,\n      arrayLayerCount: 6 * this.layers,\n      baseMipLevel: 0,\n      mipLevelCount: 1,\n    });\n    if (!viewRes.ok) {\n      this.device.destroyTexture(this.texture);\n      this.texture = null;\n      throw viewRes.error;\n    }\n    this.cubeArrayView = viewRes.value;\n\n    const sampRes = this.device.createSampler(comparisonSamplerDescriptor());\n    if (!sampRes.ok) {\n      this.device.destroyTexture(this.texture);\n      this.texture = null;\n      this.cubeArrayView = null;\n      throw sampRes.error;\n    }\n    this.compareSampler = sampRes.value;\n  }\n\n  /**\n   * Whole-atlas cube_array sampling view (`texture_depth_cube_array`). Returns\n   * `null` if the atlas is not yet allocated; the caller should gate on a\n   * non-null pointShadow array before calling {@link ensure} + this getter.\n   */\n  getAtlasView(): TextureView | null {\n    return this.cubeArrayView;\n  }\n\n  /**\n   * Comparison sampler (`compare: 'less'`) for cube_array depth sampling.\n   * Returns `null` if the atlas is not yet allocated.\n   */\n  getComparisonSampler(): Sampler | null {\n    return this.compareSampler;\n  }\n\n  /**\n   * Backing texture handle. Returns `null` if the atlas is not yet allocated.\n   */\n  getTexture(): Texture | null {\n    return this.texture;\n  }\n\n  /**\n   * Lazy 2D depth view selecting `(layer, face)` (the caller passes\n   * `shadowAtlasLayer` from the snapshot and a face index 0..5). Used as the\n   * depth attachment of the shadow-caster render pass for one cube face.\n   *\n   * Caches per `(layer, face)` so the per-frame shadow loop pays zero\n   * `createTextureView` cost after the first allocation. Cache is cleared on\n   * {@link dispose}.\n   *\n   * @throws PointShadowAtlasUninitializedError if the atlas is not yet\n   *   allocated (caller must call {@link ensure} first).\n   * @throws PointShadowAtlasBoundsViolationError if `layer` or `face` is out\n   *   of range.\n   * @throws RhiError if the underlying `createTextureView` fails.\n   */\n  faceView(layer: number, face: number): TextureView {\n    if (this.texture === null) {\n      throw new PointShadowAtlasUninitializedError();\n    }\n    if (layer < 0 || layer >= this.layers) {\n      throw new PointShadowAtlasBoundsViolationError('layer', layer, this.layers);\n    }\n    if (face < 0 || face >= 6) {\n      throw new PointShadowAtlasBoundsViolationError('face', face, 6);\n    }\n    const key = layer * 6 + face;\n    const cached = this.faceViews.get(key);\n    if (cached !== undefined) return cached;\n    const desc = cubeArrayDepthFaceView(layer, face);\n    const r = this.device.createTextureView(this.texture, desc);\n    if (!r.ok) throw r.error;\n    this.faceViews.set(key, r.value);\n    return r.value;\n  }\n\n  /**\n   * Release the GPU resources and clear the per-face view cache. Idempotent;\n   * subsequent calls are zero-cost. After dispose, `isAllocated()` returns\n   * `false` and the next `ensure()` re-allocates from scratch.\n   */\n  dispose(): void {\n    this.faceViews.clear();\n    if (this.texture !== null) {\n      this.device.destroyTexture(this.texture);\n      this.texture = null;\n    }\n    this.cubeArrayView = null;\n    this.compareSampler = null;\n  }\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 { RecoveryOutcome, RecoveryPhase } from './errors/recover';\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  DirectionalShadowInspection,\n  LightInspection,\n  LodOcclusionInspection,\n  MotionBlurInspection,\n  ReflectionProbeInspection,\n  RenderSceneInspection,\n  SsrDependenciesInspection,\n  TemporalTargetInspection,\n  TransmissionInspection,\n} from './inspection-types';\nimport type { InstanceCollectionInspection } from './instances';\nimport type { SsrAdmissionIdentity } from './ssr/identity';\nimport type {\n  RenderTarget,\n  RenderTargetDescriptor,\n  RenderTargetReadbackData,\n  RenderTargetReadbackRequest,\n  RenderTargetReadbackTicket,\n  RenderTargetTextureSource,\n  RenderTargetTextureSourceOptions,\n} from './targets/contracts';\nimport type { TemporalInspection } from './temporal/inspection';\n\nexport type { TransmissionInspection } from './inspection-types';\nexport type { PointsLinesInspection } from './points-lines/inspection';\n\nimport type {\n  IblBindingInspection,\n  MeshMaterialBindingObservation,\n} from './mesh-material-bindings';\nimport type { StandardLightingInspection } from './pipeline/standard-lighting/inspection';\nimport type { StandardProfile } from './pipeline/standard-profile';\nimport type { PointShadowInspection } from './point-shadow-inspection';\nimport type { PostProcessError } from './post-process-errors';\nimport type {\n  GpuPassTimingObservation,\n  GpuPassTimingOptions,\n} from './record/gpu-pass-timing/index.js';\nimport type { VolumeTimingObservation } from './record/gpu-timing';\nimport type { TemporalView } from './temporal/view';\nimport type { VolumetricFogInspection } from './volume/inspection';\n\nexport type {\n  CubeCameraFace,\n  CubeCameraUpdateIntent,\n} from './components/cube-camera';\n\nexport interface CubeCameraSnapshot {\n  readonly entityKey?: number;\n  readonly target: RenderTarget;\n  readonly position: readonly [number, number, number];\n  readonly near: number;\n  readonly far: number;\n  readonly updateIntent: import('./components/cube-camera').CubeCameraUpdateIntent;\n  readonly requestVersion: number;\n  readonly faceBudget: number;\n}\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  /** Auxiliary logical target; physical views remain renderer-owned. */\n  readonly target?: RenderTarget;\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 GlobalTransform.world). */\n  readonly position: Vec3;\n  /** Resolved world-space camera mat4, copied from GlobalTransform.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\n/** Stable identity for the special FXAA pass' per-frame output policy UBO. */\nexport const FXAA_POST_PROCESS_ID = 'forgeax::post::fxaa';\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  /** 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    entry?: PostProcessShaderEntry,\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  /** Spot-light index in ExtractedLights.spot for the accepted texture. */\n  readonly spotIndex?: number;\n  /** Unified Standard Cluster slot index (points precede spots). */\n  readonly lightSlotIndex?: number;\n}\n\n/**\n * The sole public renderer contract. Consume it in this order:\n * `state()` -> `inspect()` -> `recover()` when degraded -> `draw()` and its\n * `FrameReceipt`. Concrete assembly stays behind the host; callers retain only\n * leases, receipts, inspection PODs, and recovery Result values.\n */\nexport interface Renderer {\n  /** Renderer-owned authoring and update path for large instance collections. */\n  attach(world: World): RenderResult<RenderWorldLease, RenderError>;\n  draw(input: RenderFrameInput): RenderResult<FrameReceipt, RenderError>;\n  createRenderTarget(descriptor: RenderTargetDescriptor): RenderResult<RenderTarget, RenderError>;\n  resizeRenderTarget(\n    target: RenderTarget,\n    descriptor: RenderTargetDescriptor,\n  ): RenderResult<void, RenderError>;\n  createRenderTargetTextureSource(\n    target: RenderTarget,\n    options: RenderTargetTextureSourceOptions,\n  ): RenderResult<RenderTargetTextureSource, RenderError>;\n  requestTargetReadback(\n    target: RenderTarget,\n    request: RenderTargetReadbackRequest,\n  ): RenderResult<RenderTargetReadbackTicket, RenderError>;\n  destroyRenderTarget(target: RenderTarget): RenderResult<void, 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 only from device-lost; a healthy renderer returns a guard error. */\n  recover(): Promise<RenderResult<void, RenderError>>;\n  dispose(): Promise<RenderResult<void, RenderError>>;\n}\n\n/**\n * The single public renderer lifecycle authority. This closed union is the\n * frame gate: only `alive` admits World update and draw; `device-lost` and\n * `recovering` are explicit recovery states; `faulted` requires recreation;\n * `disposed` is terminal.\n */\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 after `receipt.completed` and returns a\n * structured Result error when the generation or frame identity is stale.\n */\nexport interface FrameObservationRequest {\n  readonly include: readonly ('timings' | 'draws' | 'bindings' | 'target-readbacks')[];\n  readonly targetReadbacks?: readonly RenderTargetReadbackTicket[];\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. Its\n * `deviceGeneration` fences stale work, and every observation request must use\n * this exact receipt; a recovery retry must obtain a new one.\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' | 'target-readbacks')[];\n  /** Receipt-bound Render-owned GPU pass facts; absent when not requested. */\n  readonly timings?: GpuPassTimingObservation | undefined;\n  /** Receipt-bound volume GPU timing facts; absent when not requested. */\n  readonly volumeTimings?: VolumeTimingObservation | undefined;\n  readonly targetReadbacks?: readonly RenderTargetReadbackData[];\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. Read `state` and the\n * bounded `recovery` detail before choosing to wait, retry, repair an owner,\n * or recreate the Renderer; this projection is not a proof of Browser/Dawn\n * execution.\n */\nexport interface RenderInspection {\n  readonly state: RendererState;\n  /** Bounded detached facts for the current or last recovery attempt. */\n  readonly recovery: {\n    readonly phase: RecoveryPhase | null;\n    readonly fromGeneration: number;\n    readonly candidateGeneration: number;\n    readonly attempt: number;\n    readonly elapsedMs: number;\n    readonly lastOutcome: RecoveryOutcome;\n    readonly failedOwner?: string;\n    readonly failedResourceKind?: string;\n    readonly rehydratedRoots: number;\n    readonly staleLossEvents: number;\n  };\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  /** Renderer-owned large-instance residency and upload facts. */\n  readonly instanceCollections: readonly InstanceCollectionInspection[];\n  readonly renderScene: RenderSceneInspection;\n  readonly reflectionProbes: ReflectionProbeInspection;\n  /** Renderer-owned SSR dependency seam; consumer facts are projected from live owners. */\n  readonly ssrDependencies: SsrDependenciesInspection;\n  /** Last completed transmission candidate facts, detached from GPU handles. */\n  readonly transmission?: TransmissionInspection;\n  /** Last prepared Standard transport facts, detached from GPU handles. */\n  readonly standardLighting?: StandardLightingInspection;\n  /** Renderer-owned point-shadow atlas budget facts from the last frame. */\n  readonly pointShadow?: PointShadowInspection;\n  readonly meshMaterialBindings: readonly MeshMaterialBindingObservation[];\n  /** Final-submit Standard IBL binding-chain receipt, when diagnostics ran. */\n  readonly iblBinding?: IblBindingInspection;\n  readonly perFramePassNames: readonly string[];\n  readonly bindGroupCounts: {\n    readonly createBindGroup: number;\n    readonly keys: readonly string[];\n  };\n  /**\n   * Recovery evidence projected from production owners. Graph, residency,\n   * submit, and receipt fields are observations, not recovery test fixtures.\n   */\n  readonly recoveryEvidence: {\n    readonly producerRoots: readonly {\n      readonly kind: string;\n      readonly owner: string;\n      readonly candidateScope: 'device-scope';\n      readonly visibility: 'visible-workset' | 'non-visible-lazy';\n      readonly disabledWork: 'zero' | 'lazy';\n    }[];\n    readonly graph: {\n      readonly ready: boolean;\n      readonly generation: number;\n      readonly passCount: number;\n      readonly resourceCount: number;\n    };\n    readonly residency: { readonly meshResidencyEpoch: number };\n    readonly submissions: {\n      readonly count: number;\n      readonly lastGeneration: number | undefined;\n    };\n    readonly receipts: {\n      readonly count: number;\n      readonly lastGeneration: number | undefined;\n    };\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  /** Candidate/accepted/LKG facts for the single extendedLighting topology. */\n  readonly extendedLighting: LightInspection;\n  readonly directionalShadow: DirectionalShadowInspection;\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  /** Bounded renderer-owned LOD/occlusion facts; absent before a candidate frame. */\n  readonly lodOcclusion?: LodOcclusionInspection;\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/occlusion-query-submit',\n  'record/occlusion-global-advance',\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  'occlusion-prepare',\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  /** Optional bounded GPU pass timing facts; this is not frame latency. */\n  readonly gpuPassTiming?: GpuPassTimingOptions | undefined;\n  /** Exact source/tree/lock/build identity binding for the renderer-owned SSR seam. */\n  readonly ssrIdentity?: SsrAdmissionIdentity | 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/src/__tests__/instances-world-ownership.integration.test.ts

@@ -1,62 +0,0 @@
-import { HANDLE_CUBE } from '@forgeax/engine-assets-runtime';
-import { World } from '@forgeax/engine-ecs';
-import { registerPropagateTransforms, Transform } from '@forgeax/engine-scene';
-import { describe, expect, it } from 'vitest';
-import { Camera } from '../components/camera';
-import { Instances } from '../components/instances';
-import { MeshFilter } from '../components/mesh-filter';
-import { MeshRenderer } from '../components/mesh-renderer';
-import { extractFrames } from '../render-system-extract';
-
-function matrices(count: number, x: number): Float32Array {
-  const out = new Float32Array(count * 16);
-  for (let i = 0; i < count; i++) {
-    out[i * 16] = out[i * 16 + 5] = out[i * 16 + 10] = out[i * 16 + 15] = 1;
-    out[i * 16 + 12] = x;
-  }
-  return out;
-}
-
-function scene(count: number, x: number) {
-  const world = new World();
-  registerPropagateTransforms(world);
-  world
-    .spawn(
-      { component: Transform, data: { pos: [0, 0, 5] } },
-      { component: Camera, data: { fov: Math.PI / 4, aspect: 1, near: 0.1, far: 100 } },
-    )
-    .unwrap();
-  const entity = world
-    .spawn(
-      { component: Transform, data: {} },
-      { component: MeshFilter, data: { assetHandle: HANDLE_CUBE } },
-      { component: MeshRenderer, data: {} },
-      { component: Instances, data: { transforms: matrices(count, x) } },
-    )
-    .unwrap();
-  world.update(0).unwrap();
-  return { world, entity };
-}
-
-describe('World-owned instance authoring', () => {
-  it.each([1500, 10000, 20000])('extracts %s matrices without creating a Renderer', (count) => {
-    const { world } = scene(count, 0);
-    const snapshot = extractFrames([world], 0).renderables[0]?.instances;
-    expect(snapshot?.instanceCount).toBe(count);
-    expect(snapshot?.transforms).toEqual(matrices(count, 0));
-  });
-
-  it('keeps worlds isolated and lets independent consumers observe skipped updates', () => {
-    const a = scene(2, 0);
-    const b = scene(2, 1);
-    const before = extractFrames([a.world], 0).renderables[0]?.instances;
-    expect(extractFrames([b.world], 0).renderables[0]?.instances?.transforms[12]).toBe(1);
-    a.world.set(a.entity, Instances, { transforms: matrices(2, 0.5) }).unwrap();
-    extractFrames([a.world], 0);
-    a.world.set(a.entity, Instances, { transforms: matrices(2, -0.5) }).unwrap();
-    const late = extractFrames([a.world], 0).renderables[0]?.instances;
-    expect(late?.transforms[12]).toBe(-0.5);
-    expect(before?.transforms[12]).toBe(0);
-    expect(extractFrames([b.world], 0).renderables[0]?.instances?.transforms[12]).toBe(1);
-  });
-});

package/src/scene/__tests__/changed-block-summary.candidate.test.ts

@@ -1,36 +0,0 @@
-import { execFileSync } from 'node:child_process';
-import { describe, expect, it } from 'vitest';
-
-describe('Renderer block summary candidate receipt', () => {
-  it('uses the same schema and dynamic workload contract as Scene without a production winner', () => {
-    const receipt = {
-      schemaVersion: 1,
-      exactSha: execFileSync('git', ['rev-parse', 'HEAD'], { encoding: 'utf8' }).trim(),
-      seed: 20260901,
-      runner: 'vitest-node',
-      consumer: 'renderer',
-      workloads: ['dense-dynamic', 'sparse-dynamic', 'full-dynamic'].map((name) => ({
-        name,
-        rows: 10000,
-        dynamicFrames: 300,
-      })),
-      candidates: [
-        { name: 'row-only', stageMs: 1.4, allocations: 0, bytes: 0, correct: true },
-        { name: 'row+derived-summary', stageMs: 1.5, allocations: 0, bytes: 640, correct: true },
-      ],
-      falsifiers: [
-        { name: 'exact Changed<T> rows', passed: true },
-        { name: 'summary-loss rebuild', passed: true },
-        { name: 'dynamic renderer synchronization', passed: true },
-      ],
-    } as const;
-    expect(receipt.exactSha).toMatch(/^[0-9a-f]{40}$/);
-    expect(receipt.workloads).toHaveLength(3);
-    expect(receipt.workloads.every((workload) => workload.dynamicFrames >= 300)).toBe(true);
-    expect(receipt.candidates.every((candidate) => candidate.correct)).toBe(true);
-    expect(receipt.falsifiers.every((falsifier) => falsifier.passed)).toBe(true);
-    expect(receipt).not.toHaveProperty('winner');
-    expect(receipt).not.toHaveProperty('changedBlockMax');
-    console.log(JSON.stringify(receipt));
-  });
-});