@forgeax/engine-render 0.1.4 → 0.1.7

package/dist/chunk-YEJIUW7D.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/render.ts","../src/components/camera.ts","../src/components/directional-light.ts","../src/components/instances.ts","../src/components/layer.ts","../src/components/lines.ts","../src/components/mesh-filter.ts","../src/components/mesh-renderer.ts","../src/components/point-light.ts","../src/components/point-light-shadow.ts","../src/components/points.ts","../src/components/post-process-params.ts","../src/components/scene-instance.ts","../src/components/skybox-background.ts","../src/components/skylight.ts","../src/components/sort-key.ts","../src/components/spot-light.ts","../src/components/visibility.ts","../src/pipeline/standard-profile.ts","../src/render-contract.ts","../src/points-lines/admission.ts","../src/extract/visibility.ts"],"names":["defineComponent","pass"],"mappings":"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","file":"chunk-YEJIUW7D.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 { DeviceResourceKind, DeviceScopeReceipt } from '../device/resource-types';\nimport type {\n  PreparedKind,\n  RenderFeatureCapabilityKey,\n  RenderFeatureRecovery,\n  RenderFeatureStage,\n} from '../features/vocabulary';\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\n// ── ShadowInvalidConfigError ──────────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'shadow-invalid-config'`.\n *\n * Emitted by `DirectionalLight.validate` shadow-field path when a field value violates\n * runtime constraints (e.g. mapSize < 1, cascadeCount not in {1..4}).\n * AI users access `.detail.field` / `.detail.value` / `.detail.min` /\n * `.detail.max` via property access — no string parsing.\n *\n * `max` is `undefined` for lower-bound-only validations (e.g. mapSize < 1).\n * feat-20260613-csm: max added for upper-bound cascade validations\n * (cascadeCount max=4, splitLambda max=1, cascadeBlend max=0.5).\n */\nexport interface ShadowInvalidConfigDetail {\n  readonly field: string;\n  readonly value: number;\n  readonly min: number;\n  readonly max?: number;\n}\n\n/**\n * Structured error for shadow component config validation failures.\n *\n * Emitted by `DirectionalLight.validate()` shadow-field path (mapSize / cascadeCount /\n * splitLambda / cascadeBlend / shadowDistance) and `PointLightShadow.validate()`\n * (mapSize / farPlane > nearPlane / pcfKernelSize); both shadow component\n * types share this single error class so `switch (err.code)` on\n * `RuntimeErrorCode` only needs one branch (charter P4 — closed-union SSOT).\n * Four-field surface per AGENTS.md error model:\n *   - `.code = 'shadow-invalid-config'` (closed RuntimeErrorCode)\n *   - `.expected` — expected-state description (programmatic predicate form)\n *   - `.hint` — actionable recovery guidance (imperative; AI users paste into\n *     spawn calls). Integer-typed fields (e.g. `cascadeCount`, `pcfKernelSize`)\n *     get an \"integer in [min, max]\" hint; otherwise \"[min, max]\" range or\n *     \"<comparator> min\".\n *   - `.detail = { field, value, min, max? }` — structured values (charter P4)\n *\n * 4th constructor parameter is a union over the two range shapes:\n *   - `number` — `max` for a closed `[min, max]` range (CSM cascadeCount /\n *     splitLambda / cascadeBlend). hint uses \"in [min, max]\"; integer-typed\n *     fields get \"integer in [min, max]\".\n *   - `'>' | '>='` — comparator for an open lower-bound predicate. `'>'` is\n *     used when `min` carries dynamic context (e.g. `farPlane > nearPlane` —\n *     the surfaced hint reads \"must be > nearPlane\" so AI users setting\n *     farPlane=nearPlane don't re-fail the spawn loop with the wrong cue).\n *   - `undefined` — defaults to `'>='`. Callsites for mapSize < 1 validation\n *     stay backward-compatible (3-arg form).\n */\nexport class ShadowInvalidConfigError extends Error {\n  readonly code = 'shadow-invalid-config' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: ShadowInvalidConfigDetail;\n\n  constructor(field: string, value: number, min: number, maxOrComparator?: number | '>' | '>=') {\n    const isComparator = maxOrComparator === '>' || maxOrComparator === '>=';\n    const max = !isComparator && typeof maxOrComparator === 'number' ? maxOrComparator : undefined;\n    const comparator: '>' | '>=' = isComparator ? (maxOrComparator as '>' | '>=') : '>=';\n    // Integer-typed fields get an \"integer in [min, max]\" hint when a range\n    // is supplied. Expand this set as new integer-typed shadow fields land.\n    const isInteger = field === 'cascadeCount' || field === 'pcfKernelSize';\n    // pcfKernelSize must be odd (kernel is symmetric around the center tap).\n    // Naming \"odd\" in the hint stops an AI retry from looping min->min+1 (4->6).\n    const isOdd = field === 'pcfKernelSize';\n    const hint =\n      max !== undefined\n        ? isInteger\n          ? `set ${field} to an integer in [${min}, ${max}]; got ${value}`\n          : `set ${field} to a value in [${min}, ${max}]; got ${value}`\n        : isOdd\n          ? `set ${field} to an odd integer ${comparator} ${min}; got ${value}`\n          : `set ${field} to a value ${comparator} ${min}; got ${value}`;\n    const expected =\n      max !== undefined ? `${field} in [${min}, ${max}]` : `${field} ${comparator} ${min}`;\n    super(\n      max !== undefined\n        ? `shadow component .${field} must be in [${min}, ${max}], got ${value}`\n        : `shadow component .${field} must be ${comparator} ${min}, got ${value}`,\n    );\n    this.name = 'ShadowInvalidConfigError';\n    this.hint = hint;\n    this.expected = expected;\n    this.detail = { field, value, min, ...(max !== undefined ? { max } : {}) };\n  }\n}\n\n// ── EquirectProjectionFailedError ────────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'equirect-projection-failed'`.\n *\n * Emitted when the equirect-to-cubemap IBL projection fails for the equirect\n * handle referenced by a `Skylight` / `SkyboxBackground` component. The handle\n * id is carried so AI users can trace which equirect source failed projection.\n * Degradation: the record arm records `status:'failed'`, binds the white-cube\n * fallback, fires this error ONCE, and does NOT retry the projection.\n *\n * feat-20260630 D-5: structured error with detail carrying the handle id.\n */\nexport interface EquirectProjectionFailedDetail {\n  readonly handle: number;\n}\n\n/**\n * Structured error for a failed equirect-to-cubemap IBL projection.\n *\n * Emitted by the record stage when the internal cubemap projection for an\n * equirect handle returns a failure (or records `status:'failed'`). Four-field\n * surface per AGENTS.md error model:\n *   - `.code = 'equirect-projection-failed'` (closed RuntimeErrorCode)\n *   - `.expected` — equirect-to-cubemap projection + IBL precompute succeeds\n *   - `.hint` — declare `Skylight{equirect}` with a valid HDR equirect source;\n *     check `device.caps.rgba16floatRenderable`. The projection is internal —\n *     there is no user upload call to retry\n *   - `.detail = { handle }` — the numeric equirect handle id for diagnostics\n */\nexport class EquirectProjectionFailedError extends Error {\n  readonly code = 'equirect-projection-failed' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: EquirectProjectionFailedDetail;\n\n  constructor(handle: number) {\n    const expected = `equirect handle ${handle} projects to a GPU cubemap + IBL precompute`;\n    const hint =\n      `equirect handle ${handle} referenced by Skylight/SkyboxBackground failed projection; ` +\n      `declare Skylight{equirect} with a valid HDR equirect source and check device.caps.rgba16floatRenderable. ` +\n      `The projection is internal (no user upload call); the record arm does not retry`;\n    super(`equirect handle ${handle} cubemap projection failed`);\n    this.name = 'EquirectProjectionFailedError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { handle };\n  }\n}\n\n// ── HdrpLightBudgetExceededError ───────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'hdrp-light-budget-exceeded'`.\n *\n * Emitted per-frame (once-per-frame fire) when light count exceeds HDRP budget.\n */\nexport interface HdrpLightBudgetExceededDetail {\n  readonly actual: number;\n  readonly budget: number;\n}\n\n/**\n * Structured error for HDRP light budget exceeded (AC-06/AC-07).\n *\n * Emitted per-frame in recordFrame when the total punctual light count\n * exceeds the HDRP budget (256). Fail-soft: fire once per frame, truncate to 256.\n *   - `.code = 'hdrp-light-budget-exceeded'` (closed RuntimeErrorCode)\n *   - `.expected` — 'light count <= 256'\n *   - `.hint` — 'reduce world light count or increase budget (OOS-hdrp-larger-budget)'\n *   - `.detail = { actual, budget }`\n */\nexport class HdrpLightBudgetExceededError extends Error {\n  readonly code = 'hdrp-light-budget-exceeded' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: HdrpLightBudgetExceededDetail;\n\n  constructor(actual: number, budget: number) {\n    const expected = `light count <= ${budget}`;\n    const hint =\n      `${actual} lights exceed HDRP budget ${budget}; ` +\n      'truncating to 256. Reduce light count or wait for OOS-hdrp-larger-budget';\n    super(`HDRP light budget exceeded: ${actual} > ${budget}`);\n    this.name = 'HdrpLightBudgetExceededError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { actual, budget };\n  }\n}\n\n// ── HdrpIndexListOverflowError ─────────────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'hdrp-index-list-overflow'`.\n *\n * Emitted per-frame (once-per-frame fire) when the cluster binner overflows\n * the light index list capacity (65536). Upgraded from ClusterBinError.\n */\nexport interface HdrpIndexListOverflowDetail {\n  readonly actual: number;\n  readonly capacity: number;\n}\n\n/**\n * Structured error for HDRP cluster binner index list overflow (AC-24).\n *\n * Emitted per-frame in recordFrame when the CPU binner returns\n * `ClusterBinError('index-overflow')`. Fail-soft: fire once per frame,\n * continue rendering with what fit.\n *   - `.code = 'hdrp-index-list-overflow'` (closed RuntimeErrorCode)\n *   - `.expected` — 'light index list entries <= 65536'\n *   - `.hint` — 'reduce lights, shrink cluster grid, or increase capacity'\n *   - `.detail = { actual, capacity }`\n */\nexport class HdrpIndexListOverflowError extends Error {\n  readonly code = 'hdrp-index-list-overflow' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: HdrpIndexListOverflowDetail;\n\n  constructor(actual: number, capacity: number) {\n    const expected = `light index list entries <= ${capacity}`;\n    const hint =\n      `cluster binner overflow: writeCount ${actual} exceeds capacity ${capacity}; ` +\n      'reduce lights, shrink cluster grid, or increase LIGHT_INDEX_LIST_CAPACITY';\n    super(`HDRP index list overflow: ${actual} > ${capacity}`);\n    this.name = 'HdrpIndexListOverflowError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { actual, capacity };\n  }\n}\n\n// ── HdrpDeferredCapsInsufficientError ──────────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'hdrp-deferred-caps-insufficient'`.\n *\n * Emitted when the Standard clustered lane has fewer than 4 color attachments,\n * meaning the deferred path cannot allocate 3 g-buffer color targets + depth.\n */\nexport interface HdrpDeferredCapsInsufficientDetail {\n  readonly actual: number;\n  readonly expected: number;\n}\n\n/**\n * Structured error for deferred-path capability gate failure.\n *\n * Emitted during Standard clustered lane validation — synchronous throw.\n *   - `.code = 'hdrp-deferred-caps-insufficient'` (closed RuntimeErrorCode)\n *   - `.expected` — 'maxColorAttachments >= 4'\n *   - `.hint` — actionable guidance to upgrade browser or select URP\n *   - `.detail = { actual, expected }`\n *\n * @see plan-strategy D-5 (capability validation, no silent fallback)\n */\nexport class HdrpDeferredCapsInsufficientError extends Error {\n  readonly code = 'hdrp-deferred-caps-insufficient' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: HdrpDeferredCapsInsufficientDetail;\n\n  constructor(actual: number) {\n    const _expected = 4;\n    const _expectedStr = `maxColorAttachments >= ${_expected}`;\n    const hint =\n      `WebGPU maxColorAttachments = ${actual} (need >= ${_expected}). ` +\n      'Upgrade browser to latest Chrome/Edge/Safari, or use URP (forgeax::urp) instead of HDRP.';\n    super(\n      `HDRP deferred caps insufficient: maxColorAttachments = ${actual} (need >= ${_expected})`,\n    );\n    this.name = 'HdrpDeferredCapsInsufficientError';\n    this.expected = _expectedStr;\n    this.hint = hint;\n    this.detail = { actual, expected: _expected };\n  }\n}\n\n// ── PointShadowAtlasUninitializedError ─────────────────────────────────────\n\n/**\n * Structured error for `ShadowAtlas.faceView` called before `ensure()`\n * allocated the cube_array texture. Replaces the prior bare\n * `throw new Error()` (Round-2 F-4: P3 closed-union compliance).\n *\n *   - `.code = 'point-shadow-atlas-uninitialized'`\n *   - `.expected` — call `ensure()` before iterating face views\n *   - `.hint` — gate `faceView` on `isAllocated()` or call `ensure()` once\n *     in the per-frame extract step before recording the 6 x N caster passes\n *   - `.detail = undefined` (no per-call data needed)\n */\nexport class PointShadowAtlasUninitializedError extends Error {\n  readonly code = 'point-shadow-atlas-uninitialized' as const;\n  readonly expected: string;\n  readonly hint: string;\n\n  constructor() {\n    const expected = 'ShadowAtlas.ensure() invoked before faceView()';\n    const hint =\n      'Gate faceView on isAllocated() or call ensure() once in the per-frame extract step before iterating face views';\n    super('ShadowAtlas.faceView called before ensure(); the cube_array texture is not allocated');\n    this.name = 'PointShadowAtlasUninitializedError';\n    this.expected = expected;\n    this.hint = hint;\n  }\n}\n\n// ── PointShadowAtlasBoundsViolationError ───────────────────────────────────\n\n/**\n * Detail for `RuntimeErrorCode 'point-shadow-atlas-bounds-violation'`.\n *\n * Emitted by `ShadowAtlas.faceView` when `layer` falls outside `[0, layers)`\n * or `face` falls outside `[0, 6)`. Both axes are reported as\n * `{ axis, value, max }` so AI users discriminate without parsing the message.\n */\nexport interface PointShadowAtlasBoundsViolationDetail {\n  readonly axis: 'layer' | 'face';\n  readonly value: number;\n  readonly max: number;\n}\n\n/**\n * Structured error for `ShadowAtlas.faceView(layer, face)` arguments outside\n * the allocated atlas range. Replaces the prior bare `throw new Error()`\n * (Round-2 F-4: P3 closed-union compliance).\n *\n *   - `.code = 'point-shadow-atlas-bounds-violation'`\n *   - `.expected` — `0 <= layer < layers && 0 <= face < 6`\n *   - `.hint` — clamp `shadowAtlasLayer` or face index before calling\n *     `faceView`; the cap on layers is `PointLightShadow` cardinality (4)\n *   - `.detail = { axis, value, max }` — discriminates layer vs face\n */\nexport class PointShadowAtlasBoundsViolationError extends Error {\n  readonly code = 'point-shadow-atlas-bounds-violation' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointShadowAtlasBoundsViolationDetail;\n\n  constructor(axis: 'layer' | 'face', value: number, max: number) {\n    const expected = `0 <= ${axis} < ${max}`;\n    const hint =\n      axis === 'layer'\n        ? `clamp PointLight.shadowAtlasLayer to [0, ${max}); the cap on layers equals PointLightShadow cardinality (4)`\n        : `clamp face index to [0, ${max}); cube faces are indexed 0..5 in +X/-X/+Y/-Y/+Z/-Z order`;\n    super(`ShadowAtlas.faceView ${axis} out of range: ${value} (must be in [0, ${max}))`);\n    this.name = 'PointShadowAtlasBoundsViolationError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { axis, value, max };\n  }\n}\n\n// ── VideoUploadUnsupportedError ─────────────────────────────────────────\n\n/**\n * Structured error for `RuntimeErrorCode 'video-upload-unsupported'`\n * (feat-20260623-world-space-video-asset M3 / w11 — AC-10).\n *\n * Fired by the per-frame record stage (`videoTextureView`) when a VideoPlayer\n * entity can reach neither video upload path this frame: the general\n * `copyExternalImageToTexture` path (no host HTMLVideoElement resolved via\n * `VideoElementProvider`) AND the high-perf `GPUExternalTexture` path\n * (capability absent). The engine surfaces this explicit failure rather than\n * silently rendering a stale/garbage texture (charter P3, plan-strategy D-6).\n *   - `.code = 'video-upload-unsupported'`\n *   - `.expected` — at least one upload path available (host element or\n *     GPUExternalTexture capability)\n *   - `.hint` — actionable recovery: use a static texture or switch backend\n *   - `.detail` — undefined (no narrowed detail variant)\n */\nexport class VideoUploadUnsupportedError extends Error {\n  readonly code = 'video-upload-unsupported' as const;\n  readonly expected: string;\n  readonly hint: string;\n\n  constructor() {\n    const expected =\n      'at least one video upload path available: a host HTMLVideoElement (general copyExternalImageToTexture path) or GPUExternalTexture capability (high-perf path)';\n    const hint =\n      'this backend exposes no usable video upload path; render a static texture instead, or switch to a WebGPU backend that supports video texture upload';\n    super('video upload unsupported — no general or high-perf path available');\n    this.name = 'VideoUploadUnsupportedError';\n    this.expected = expected;\n    this.hint = hint;\n  }\n}\n\n// ── VertexStorageBufferUnavailableError ─────────────────────────────────\n\n/**\n * Structured error for missing vertex-stage storage buffer capability.\n *\n * Emitted at createRenderer time (cap-gate).\n *   - `.code = 'vertex-storage-buffer-unavailable'`\n *   - `.expected` — device.caps supports vertex-stage storage buffer\n *   - `.hint` — switch to a WebGPU adapter with vertex storage buffer support or use uniform-buffer fallback (OOS-uniform-palette)\n *   - `.detail` — undefined (no narrowed detail variant)\n */\nexport class VertexStorageBufferUnavailableError extends Error {\n  readonly code = 'vertex-storage-buffer-unavailable' as const;\n  readonly expected: string;\n  readonly hint: string;\n\n  constructor() {\n    const expected =\n      'device.caps supports vertex-stage storage buffer (maxStorageBuffersPerShaderStage >= 1)';\n    const hint =\n      'this device does not support vertex-stage storage buffers; skinning requires vertex-stage storage buffer access (OOS-uniform-palette fallback not implemented)';\n    super('vertex-stage storage buffer unavailable — skinning cannot operate');\n    this.name = 'VertexStorageBufferUnavailableError';\n    this.expected = expected;\n    this.hint = hint;\n  }\n}\n\n// ── VertexColorVariantConflictError ───────────────────────────────────────\n\nexport interface VertexColorVariantConflictDetail {\n  readonly authored: true;\n  readonly authoredValue: string;\n  readonly projected: boolean;\n}\n\n/** The authored color axis disagrees with the canonical geometry projection. */\nexport class VertexColorVariantConflictError extends Error {\n  readonly code = 'vertex-color-variant-conflict' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: VertexColorVariantConflictDetail;\n\n  constructor(authoredValue: string, projected: boolean) {\n    const expected = `VERTEX_COLOR_AVAILABLE=${projected ? 'true' : 'false'}`;\n    const hint =\n      'derive the shader variant from the mesh VertexLayoutProjection; COLOR_0 presence is a geometry fact';\n    super(`authored vertex-color variant ${authoredValue} disagrees with projected ${expected}`);\n    this.name = 'VertexColorVariantConflictError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { authored: true, authoredValue, projected };\n  }\n}\n\n// ── Skin palette/material validation errors ────────────────────────────────\n\n/** Detail for a palette buffer that exceeds the device storage limit. */\nexport interface SkinPaletteOverflowDetail {\n  readonly requestedBytes: number;\n  readonly limit: number;\n}\n\n/**\n * Structured render error for a skin palette allocation that exceeds the\n * device storage-buffer binding limit. The allocator that emits this error\n * lives in render, so the error belongs to the render union rather than the\n * renderer-independent skinning binding package.\n */\nexport class SkinPaletteOverflowError extends Error {\n  readonly code = 'skin-palette-overflow' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: SkinPaletteOverflowDetail;\n\n  constructor(requestedBytes: number, limit: number) {\n    const expected = `skinned joint palette (${requestedBytes} B) fits within device.limits.maxStorageBufferBindingSize (${limit} B)`;\n    const hint =\n      'palette buffer exceeds device maxStorageBufferBindingSize; reduce skinned entity count or split into multiple palette buffers (OOS-skin-palette-batch)';\n    super(`skin palette buffer needs ${requestedBytes} B, exceeds device limit ${limit} B`);\n    this.name = 'SkinPaletteOverflowError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { requestedBytes, limit };\n  }\n}\n\n/** Detail for a skinned entity using a non-skin material shader. */\nexport interface SkinMaterialMismatchDetail {\n  readonly entity: number;\n  readonly actualShader: string | undefined;\n}\n\n/** Structured render error for a Skin/non-skin-material mismatch. */\nexport class SkinMaterialMismatchError extends Error {\n  readonly code = 'skin-material-mismatch' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: SkinMaterialMismatchDetail;\n\n  constructor(entity: number, actualShader: string | undefined) {\n    const expected = \"Skin entity's first material program module === 'forgeax::pbr-skin'\";\n    const hint = `entity ${entity} has Skin but the first material program module is ${actualShader ?? '<empty>'}; load the mesh via the gltf importer (cooker auto-routes 'forgeax::pbr-skin' for skinned primitives), or remove the Skin component to render the entity unskinned with Materials.standard / Materials.unlit`;\n    super(\n      `Skin / material mismatch on entity ${entity}: expected forgeax::pbr-skin, got ${actualShader ?? '<empty>'}`,\n    );\n    this.name = 'SkinMaterialMismatchError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { entity, actualShader };\n  }\n}\n\n/** Detail for a pbr-skin material whose mesh lacks skin attributes. */\nexport interface MaterialSkinAttrMissingDetail {\n  readonly entity: number;\n  readonly missing: 'skinIndex' | 'skinWeight' | 'both';\n}\n\n/** Structured render error for a pbr-skin material/mesh attribute mismatch. */\nexport class MaterialSkinAttrMissingError extends Error {\n  readonly code = 'material-skin-attr-missing' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: MaterialSkinAttrMissingDetail;\n\n  constructor(entity: number, missing: 'skinIndex' | 'skinWeight' | 'both') {\n    const expected = 'pbr-skin material requires mesh.attributes.skinIndex + skinWeight';\n    const hint = `entity ${entity} uses forgeax::pbr-skin but its MeshAsset is missing ${missing}; switch the entity to a skinned glTF mesh authored with JOINTS_0 + WEIGHTS_0, or change the material to a non-skin shader via Materials.standard / Materials.unlit`;\n    super(\n      `material/skin attribute mismatch on entity ${entity}: pbr-skin material with mesh missing ${missing}`,\n    );\n    this.name = 'MaterialSkinAttrMissingError';\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = { entity, missing };\n  }\n}\n\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 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 RendererOperationCause {\n  readonly code: string;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail?: unknown;\n}\n\nexport interface RendererOperationDetailByCode {\n  readonly 'world-lease-invalid': {\n    readonly operation: 'attach' | 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'frame-input-invalid': {\n    readonly operation: 'draw' | 'set-profile';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'scene-projection-failed': {\n    readonly operation: 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'asset-binding-failed': {\n    readonly operation: 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'feature-plan-failed': {\n    readonly operation: 'draw';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'graph-build-failed': {\n    readonly operation: 'draw' | 'set-profile';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'device-operation-failed': {\n    readonly operation: 'draw' | 'complete-frame' | 'renderer-event';\n    readonly frameId?: number;\n    readonly deviceGeneration?: number;\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'surface-unavailable': {\n    readonly operation: 'release-surface' | 'restore-surface';\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'renderer-state-invalid': {\n    readonly operation: 'draw' | 'set-profile' | 'recover' | 'dispose';\n    readonly state: string;\n    readonly cause?: RendererOperationCause;\n  };\n  readonly 'recovery-failed': {\n    readonly operation: 'recover';\n    readonly oldGeneration: number;\n    readonly cause: RendererOperationCause;\n  };\n  readonly 'cleanup-failed': {\n    readonly operation: 'dispose';\n    readonly causes: readonly RendererOperationCause[];\n  };\n}\n\nexport type RendererOperationErrorCode = keyof RendererOperationDetailByCode;\n\nconst RENDERER_OPERATION_ERROR_POLICY = {\n  'world-lease-invalid': {\n    expected: 'every render World is represented by a live lease owned by this Renderer',\n    hint: 'attach the World to this Renderer and use the returned lease',\n  },\n  'frame-input-invalid': {\n    expected: 'the frame input references attached leases and a valid immutable RenderProfile',\n    hint: 'repair the frame input and retry draw or setProfile',\n  },\n  'scene-projection-failed': {\n    expected: 'the attached World projects into the renderer-owned RenderScene',\n    hint: 'inspect the structured cause, repair the World publication, and retry draw',\n  },\n  'asset-binding-failed': {\n    expected: 'all frame assets resolve to valid renderer-owned bindings',\n    hint: 'inspect the structured cause, rebuild or cold-cook the asset, and retry draw',\n  },\n  'feature-plan-failed': {\n    expected: 'every installed RenderFeature produces a valid declarative plan',\n    hint: 'inspect the feature cause, repair its plan, and retry draw',\n  },\n  'graph-build-failed': {\n    expected: 'the Standard graph builds from the active profile and feature plans',\n    hint: 'inspect the graph cause, repair the profile or plan, and retry',\n  },\n  'device-operation-failed': {\n    expected: 'the active device generation completes the renderer-owned operation',\n    hint: 'inspect renderer state and the structured cause, then retry or recover',\n  },\n  'surface-unavailable': {\n    expected: 'the presentation surface accepts the requested lifecycle operation',\n    hint: 'inspect renderer state, then restore the surface or create a new Renderer',\n  },\n  'renderer-state-invalid': {\n    expected: 'the Renderer is in a state that accepts the requested operation',\n    hint: 'inspect renderer state and choose retry, restoreSurface, recover, or stop',\n  },\n  'recovery-failed': {\n    expected: 'one recovery attempt publishes a complete replacement device generation',\n    hint: 'inspect the structured cause and retry recover after the host-selected delay',\n  },\n  'cleanup-failed': {\n    expected: 'Renderer disposal completes every registered cleanup in reverse ownership order',\n    hint: 'inspect the ordered cleanup causes; the Renderer remains disposed and must not be reused',\n  },\n} as const satisfies Readonly<\n  Record<RendererOperationErrorCode, { readonly expected: string; readonly hint: string }>\n>;\n\n/** Public renderer-operation failure with a code-narrowed structured detail. */\nexport class RendererOperationError<Code extends RendererOperationErrorCode> extends Error {\n  readonly code: Code;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: RendererOperationDetailByCode[Code];\n\n  constructor(code: Code, detail: RendererOperationDetailByCode[Code]) {\n    const policy = RENDERER_OPERATION_ERROR_POLICY[code];\n    super(`${code}: ${policy.expected}`);\n    this.name = 'RendererOperationError';\n    this.code = code;\n    this.expected = policy.expected;\n    this.hint = policy.hint;\n    this.detail = detail;\n  }\n}\n\nexport type RendererExpectedOperationError = {\n  readonly [Code in RendererOperationErrorCode]: RendererOperationError<Code>;\n}[RendererOperationErrorCode];\n\n// -- Points/Lines admission errors -------------------------------------------\n\nexport interface PointsLinesInvalidStyleDetail {\n  readonly entity: number;\n  readonly component: 'Points' | 'Lines' | 'Points/Lines';\n  readonly field: string;\n  readonly value: number | string | undefined;\n  readonly expected: string;\n}\n\nexport class PointsLinesInvalidStyleError extends Error {\n  readonly code = 'points-lines-invalid-style' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesInvalidStyleDetail;\n\n  constructor(detail: PointsLinesInvalidStyleDetail) {\n    super(`invalid ${detail.component} style at ${detail.field}`);\n    this.name = 'PointsLinesInvalidStyleError';\n    this.expected = detail.expected;\n    this.hint = `repair entity ${detail.entity} ${detail.component}.${detail.field} and retry admission`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesTopologyMismatchDetail {\n  readonly entity: number;\n  readonly submesh: number;\n  readonly expected: string;\n  readonly actual: string;\n}\n\nexport class PointsLinesTopologyMismatchError extends Error {\n  readonly code = 'points-lines-topology-mismatch' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesTopologyMismatchDetail;\n\n  constructor(detail: PointsLinesTopologyMismatchDetail) {\n    super(`Points/Lines topology mismatch at submesh ${detail.submesh}`);\n    this.name = 'PointsLinesTopologyMismatchError';\n    this.expected = `submesh ${detail.submesh} topology is ${detail.expected}`;\n    this.hint = `rebuild entity ${detail.entity} with ${detail.expected} geometry before retrying Points/Lines admission`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesStyleUnsupportedDetail {\n  readonly lane: string;\n  readonly field: string;\n  readonly member: string;\n  readonly supported: readonly string[];\n}\n\nexport class PointsLinesStyleUnsupportedError extends Error {\n  readonly code = 'points-lines-style-unsupported' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesStyleUnsupportedDetail;\n\n  constructor(detail: PointsLinesStyleUnsupportedDetail) {\n    super(`unsupported Points/Lines ${detail.field} member ${detail.member}`);\n    this.name = 'PointsLinesStyleUnsupportedError';\n    this.expected = `${detail.field} is one of ${detail.supported.join(', ')}`;\n    this.hint = `use a supported Points/Lines ${detail.field} member or wait for a later milestone`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesMaterialUnsupportedDetail {\n  readonly entity: number;\n  readonly material: string;\n  readonly pass: string;\n  readonly module: string;\n  readonly reason: string;\n}\n\nexport class PointsLinesMaterialUnsupportedError extends Error {\n  readonly code = 'points-lines-material-unsupported' as const;\n  readonly expected = 'one engine-owned unlit forward MaterialAsset pass';\n  readonly hint: string;\n  readonly detail: PointsLinesMaterialUnsupportedDetail;\n\n  constructor(detail: PointsLinesMaterialUnsupportedDetail) {\n    super(`Points/Lines material is unsupported on entity ${detail.entity}`);\n    this.name = 'PointsLinesMaterialUnsupportedError';\n    this.hint = `use Materials.unlit without a shadow-caster pass for entity ${detail.entity}`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesBudgetExceededDetail {\n  readonly lane: string;\n  readonly requested: number;\n  readonly limit: number;\n  readonly unit: 'points' | 'segments' | 'vertices' | 'indices' | 'bytes' | 'draws';\n}\n\nexport class PointsLinesBudgetExceededError extends Error {\n  readonly code = 'points-lines-budget-exceeded' as const;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PointsLinesBudgetExceededDetail;\n\n  constructor(detail: PointsLinesBudgetExceededDetail) {\n    super(`Points/Lines ${detail.unit} budget exceeded`);\n    this.name = 'PointsLinesBudgetExceededError';\n    this.expected = `${detail.unit} <= ${detail.limit}`;\n    this.hint = `reduce Points/Lines ${detail.unit} or split the entity into bounded equivalent batches`;\n    this.detail = detail;\n  }\n}\n\nexport interface PointsLinesPrepareFailedDetail {\n  readonly owner: string;\n  readonly generation: number;\n  readonly stage: 'prepare';\n  readonly cause: string;\n  readonly lastKnownGood: boolean;\n}\n\nexport class PointsLinesPrepareFailedError extends Error {\n  readonly code = 'points-lines-prepare-failed' as const;\n  readonly expected = 'the complete Points/Lines candidate validates before publication';\n  readonly hint: string;\n  readonly detail: PointsLinesPrepareFailedDetail;\n\n  constructor(detail: PointsLinesPrepareFailedDetail) {\n    super(`Points/Lines prepare failed at generation ${detail.generation}`);\n    this.name = 'PointsLinesPrepareFailedError';\n    this.hint = detail.lastKnownGood\n      ? 'retain the last known good candidate, repair the producer, and retry prepare'\n      : 'repair the producer and retry prepare; the failed first candidate produces zero draw';\n    this.detail = detail;\n  }\n}\n\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  | ShadowInvalidConfigError\n  | EquirectProjectionFailedError\n  | HdrpLightBudgetExceededError\n  | HdrpIndexListOverflowError\n  | HdrpDeferredCapsInsufficientError\n  | PointShadowAtlasUninitializedError\n  | PointShadowAtlasBoundsViolationError\n  | VideoUploadUnsupportedError\n  | VertexStorageBufferUnavailableError\n  | VertexColorVariantConflictError\n  | SkinPaletteOverflowError\n  | SkinMaterialMismatchError\n  | MaterialSkinAttrMissingError\n  | RenderFeatureRegistrationConflictError\n  | RenderFeatureStageFailedError\n  | RenderFeatureCapabilityMissingError\n  | RenderFeaturePassOrderConflictError\n  | RenderFeaturePreparationFailedError\n  | RenderFeaturePreparedStateMismatchError\n  | RenderFeatureDrawRecordingFailedError\n  | PointsLinesInvalidStyleError\n  | PointsLinesTopologyMismatchError\n  | PointsLinesStyleUnsupportedError\n  | PointsLinesMaterialUnsupportedError\n  | PointsLinesBudgetExceededError\n  | PointsLinesPrepareFailedError;\n","// @forgeax/engine-render - Camera (projection variant + ortho extension).\n//\n// Schema: 9 f32 columns — perspective quartet (fov + aspect + near + far)\n// + projection discriminator (0 = perspective, 1 = orthographic) + ortho\n// quartet (left + right + bottom + top). The view matrix continues to be\n// derived from the entity's Transform (AC-06 case B fires\n// 'render-system-no-camera' when 0 such entities exist).\n//\n// Projection discriminator:\n//   projection === 0 → perspective path; RenderSystem builds\n//                      mat4.perspective(out, fov, aspect, near, far).\n//                      WebGPU [0, 1] NDC z; perspective reverse-Z hook is\n//                      a future spin-off path (plan-strategy §R-7) kept\n//                      outside M3 scope — the short-name mat4.perspective\n//                      already writes [0, 1] NDC, matching the ortho branch.\n//   projection === 1 → orthographic path; RenderSystem builds\n//                      mat4.orthographic(out, left, right, bottom, top,\n//                      near, far) (WebGPU [0, 1] NDC; same z convention).\n//\n// Naming convention: forgeax uses the bare `Camera` name (no `Component`\n// suffix) to follow the unity-style flavor for \"individuating\" component\n// names per plan-strategy 7.2 + D-Q5a user lock.\n//\n// Related: requirements §AC-16 (Camera Ortho + Box3 / Sphere);\n//          plan-strategy §M3 range + §R-7 risk (single perspective camera\n//          in hello-room does NOT trigger depth-func conflict; multi-camera\n//          mixed perspective + ortho deferred to feat-future-camera-depth-func);\n//          plan-tasks.json w9 acceptanceCheck.\n\nimport { defineComponent, type SchemaOf, type ShapeOf } from '@forgeax/engine-ecs';\nimport { TONEMAP_SHADER_MODE } from '@forgeax/engine-shader';\n\n/**\n * Projection discriminator literal union (AC-16 narrowing surface).\n * Exposed for consumer code that maps `camera.projection` numeric values back\n * to a switch-able string literal (e.g. RenderSystem dispatch / inspector\n * snapshot rendering).\n */\nexport type CameraProjection = 'perspective' | 'orthographic';\n\n/** Numeric encoding of perspective projection (schema value for `projection`). */\nexport const CAMERA_PROJECTION_PERSPECTIVE = 0;\n/** Numeric encoding of orthographic projection (schema value for `projection`). */\nexport const CAMERA_PROJECTION_ORTHOGRAPHIC = 1;\n\n/**\n * Map a `camera.projection` numeric value to the closed `CameraProjection`\n * string-literal union. Values other than 0 / 1 fall back to `'perspective'`\n * (defensive for defaulted / uninitialised entities; charter proposition 4\n * no silent exception).\n */\nexport function cameraProjectionFromF32(value: number): CameraProjection {\n  return value === CAMERA_PROJECTION_ORTHOGRAPHIC ? 'orthographic' : 'perspective';\n}\n\n/**\n * Tone-mapping mode discriminator literal union (AC-01 narrowing surface;\n * feat-20260519-tonemap-reinhard-mvp / M1).\n *\n * Two members for the MVP:\n *   `'none'`              - default; render-target stays `bgra8unorm-srgb`\n *                            and the geometry pass writes directly to the\n *                            swap-chain (zero-overhead opt-out path).\n *   `'reinhard-extended'` - Forgeax Reinhard 2002 extended (luminance-domain)\n *                            opt-in;\n *   `'reinhard'`          - Three r184 per-channel Reinhard opt-in;\n *                            geometry pass routes through an `rgba16float`\n *                            HDR target and a fullscreen tonemap pass\n *                            (`packages/shader/src/tonemap.wgsl`).\n *\n * The remaining members mirror the Three r184 public names and formulas.\n */\nexport type Tonemap =\n  | 'none'\n  | 'reinhard-extended'\n  | 'reinhard'\n  | 'linear'\n  | 'cineon'\n  | 'aces-filmic'\n  | 'agx'\n  | 'neutral';\n\n/** Numeric encoding of the no-op tonemap path (schema value for `tonemap`). */\nexport const TONEMAP_NONE = TONEMAP_SHADER_MODE.none;\n/**\n * Numeric encoding of the Reinhard-extended tonemap path\n * (schema value for `tonemap`).\n */\nexport const TONEMAP_REINHARD_EXTENDED = TONEMAP_SHADER_MODE.reinhardExtended;\n/** Numeric encoding of the Three r184 per-channel Reinhard path. */\nexport const TONEMAP_REINHARD = TONEMAP_SHADER_MODE.reinhard;\n/** Numeric encoding of the linear (identity after exposure) tonemap path. */\nexport const TONEMAP_LINEAR = TONEMAP_SHADER_MODE.linear;\n/** Numeric encoding of the Cineon (Kodak log) tonemap path. */\nexport const TONEMAP_CINEON = TONEMAP_SHADER_MODE.cineon;\n/** Numeric encoding of the ACES filmic (Narkowicz 2015) tonemap path. */\nexport const TONEMAP_ACES_FILMIC = TONEMAP_SHADER_MODE.acesFilmic;\n/** Numeric encoding of the AgX (Troy Sobotka / Blender 3.x) tonemap path. */\nexport const TONEMAP_AGX = TONEMAP_SHADER_MODE.agx;\n/** Numeric encoding of the Khronos PBR neutral tonemap path. */\nexport const TONEMAP_NEUTRAL = TONEMAP_SHADER_MODE.neutral;\n\n/**\n * Map a `camera.tonemap` numeric value to the closed `Tonemap` string-literal\n * union. Unknown values fall back to `'none'` for defensive schema decoding.\n */\nexport function tonemapFromF32(value: number): Tonemap {\n  switch (value) {\n    case TONEMAP_REINHARD_EXTENDED:\n      return 'reinhard-extended';\n    case TONEMAP_REINHARD:\n      return 'reinhard';\n    case TONEMAP_LINEAR:\n      return 'linear';\n    case TONEMAP_CINEON:\n      return 'cineon';\n    case TONEMAP_ACES_FILMIC:\n      return 'aces-filmic';\n    case TONEMAP_AGX:\n      return 'agx';\n    case TONEMAP_NEUTRAL:\n      return 'neutral';\n    default:\n      return 'none';\n  }\n}\n\n/**\n * Inverse of {@link tonemapFromF32}: map the closed `Tonemap` string-literal\n * union to the u32 mode the tonemap WGSL `params.mode` switch reads. SSOT for\n * the mode encoding shared by the extract-stage built-in tonemap provider\n * (feat-20260621 M-A3 / w13: `Camera.tonemap` -> `forgeax::tonemap` 16B data)\n * and any other consumer. `'none'` maps to 0 (the tonemap pass never dispatches\n * on the LDR path, so 0 is only ever a placeholder).\n */\nexport function tonemapToU32(mode: Tonemap): number {\n  switch (mode) {\n    case 'reinhard-extended':\n      return TONEMAP_REINHARD_EXTENDED;\n    case 'reinhard':\n      return TONEMAP_REINHARD;\n    case 'linear':\n      return TONEMAP_LINEAR;\n    case 'cineon':\n      return TONEMAP_CINEON;\n    case 'aces-filmic':\n      return TONEMAP_ACES_FILMIC;\n    case 'agx':\n      return TONEMAP_AGX;\n    case 'neutral':\n      return TONEMAP_NEUTRAL;\n    case 'none':\n      return TONEMAP_NONE;\n  }\n  throw new RangeError(`Invalid tonemap mode: ${String(mode)}.`);\n}\n\n/**\n * Anti-alias mode discriminator literal union\n * (feat-20260528-fxaa-post-processing / w2;\n *  feat-20260604-learn-render-4-10-anti-aliasing-msaa adds `'msaa'`).\n *\n * Four members:\n *   `'none'` - default; no anti-aliasing (zero-overhead opt-out path)\n *   `'fxaa'` - FXAA 3.11 fullscreen post-processing pass (screen-space, shading-aliasing)\n *   `'msaa'` - 4x hardware multi-sample anti-aliasing (geometry-edge coverage).\n *              Active on both HDR and LDR-swap-chain paths, so a default Camera\n *              (`tonemap='none'`) with `antialias='msaa'` is NOT a silent no-op.\n *   `'taa'`  - temporal anti-aliasing; renderer temporal projection owns its\n *              jitter and successful-submit history contract.\n *\n * MSAA and FXAA are orthogonal: MSAA resolves geometry-edge aliasing, FXAA\n * resolves shading/high-frequency aliasing. TAA is mutually exclusive with both.\n */\nexport type Antialias = 'none' | 'fxaa' | 'msaa' | 'taa';\n\n/** Numeric encoding of anti-alias disabled (schema value for `antialias`). */\nexport const ANTIALIAS_NONE = 0;\n/** Numeric encoding of FXAA anti-aliasing (schema value for `antialias`). */\nexport const ANTIALIAS_FXAA = 1;\n/** Numeric encoding of MSAA multi-sample anti-aliasing (schema value for `antialias`). */\nexport const ANTIALIAS_MSAA = 2;\n/** Numeric encoding of temporal anti-aliasing (schema value for `antialias`). */\nexport const ANTIALIAS_TAA = 3;\n\n/**\n * Map a `camera.antialias` numeric value to the closed `Antialias`\n * string-literal union. Invalid values fail-fast with structured error (charter P3).\n */\nexport function antialiasFromF32(value: number): Antialias {\n  if (value === ANTIALIAS_NONE) return 'none';\n  if (value === ANTIALIAS_FXAA) return 'fxaa';\n  if (value === ANTIALIAS_MSAA) return 'msaa';\n  if (value === ANTIALIAS_TAA) return 'taa';\n  throw new RangeError(\n    `Invalid antialias value: ${value}. Expected ${ANTIALIAS_NONE} (none), ${ANTIALIAS_FXAA} (fxaa), ${ANTIALIAS_MSAA} (msaa), or ${ANTIALIAS_TAA} (taa).`,\n  );\n}\n\n/**\n * Bloom enabled discriminator literal union\n * (feat-20260531-bloom-first-declarative-render-graph-pass / w2).\n *\n * Two members:\n *   `'off'` - default; no bloom post-processing (zero-overhead opt-out path)\n *   `'on'`  - bloom bright-pass + separable blur + composite pipeline\n *\n * Bloom is a discrete enum (0/1) — illegal values fail-fast with RangeError\n * (charter P3), matching antialiasFromF32 precedent.\n */\nexport type BloomEnabled = 'off' | 'on';\n\n/** Numeric encoding of bloom disabled (schema value for `bloom`). */\nexport const BLOOM_DISABLED = 0;\n/** Numeric encoding of bloom enabled (schema value for `bloom`). */\nexport const BLOOM_ENABLED = 1;\n\n/**\n * Map a `camera.bloom` numeric value to the closed `BloomEnabled` string-literal\n * union. Invalid values fail-fast with structured error (charter P3).\n */\nexport function bloomEnabledFromF32(value: number): BloomEnabled {\n  if (value === BLOOM_DISABLED) return 'off';\n  if (value === BLOOM_ENABLED) return 'on';\n  throw new RangeError(\n    `Invalid bloom value: ${value}. Expected ${BLOOM_DISABLED} (off) or ${BLOOM_ENABLED} (on).`,\n  );\n}\n\n/**\n * Camera projection parameters (perspective + orthographic variants) +\n * tonemap trio (mode + exposure + whitePoint).\n *\n * Camera transform comes from the entity's `Transform` (AI users\n * spawn camera entities with both components: see example below).\n *\n * Defaults (do not auto-apply; spawn explicitly for the perspective quartet):\n *   fov        = pi/4       - 45-degree vertical field of view\n *   aspect     = 16/9       - widescreen aspect (use canvas.width / canvas.height)\n *   near       = 0.1\n *   far        = 100\n *   projection = 0          - CAMERA_PROJECTION_PERSPECTIVE (layer-2)\n *   left       = -1, right  = 1, bottom = -1, top = 1  (orthographic; layer-2)\n *   tonemap    = 0          - TONEMAP_NONE (layer-2; opt-in path stays\n *                              0-overhead by default)\n *   exposure   = 1.0        - layer-2 default for the Reinhard-extended path\n *                              @applicableWhen tonemap === 'reinhard-extended'\n *   whitePoint = 4.0        - layer-2 default for the Reinhard-extended path\n *                              @applicableWhen tonemap === 'reinhard-extended'\n *                              @minimum 0 (shader floor `max(Y, 1e-5)` keeps\n *                              the divisor finite even at 0; D-O3)\n *   clearColor = [0, 0, 0, 0]\n *                            - feat-20260709 M3 / D-3: clear-color is one\n *                              inline `array<f32,4>` column (collapsed from the\n *                              feat-20260608 clearR/G/B/A quartet). Defaults to\n *                              transparent black; an explicit alpha remains\n *                              visible through this public field.\n *\n * MVP supports a single active camera (the first archetype iteration hit;\n * N>1 fires 'render-system-multi-camera' + uses first). Multi-viewport is\n * OOS (see feat-future-multi-viewport). The orthographic path reuses the\n * same near / far as the perspective path — both variants share the single\n * Camera archetype (17 scalar f32 columns + one historyVersion u32 column +\n * the `clearColor` array<f32,4> column + the `autoAspect` bool column).\n *\n * @example Perspective camera at (0, 0, 3) looking down -Z (zero-config tonemap):\n *   world.spawn(\n *     { component: Transform, data: {\n *       pos: [0, 0, 3],\n *       quat: [0, 0, 0, 1],\n *       scale: [1, 1, 1],\n *     } },\n *     { component: Camera, data: {\n *       fov: Math.PI / 4, aspect: 16 / 9, near: 0.1, far: 100,\n *     } },\n *   );\n *   // tonemap defaults to 0 (TONEMAP_NONE) - 0-overhead path.\n *\n * @example Opt-in Reinhard-extended tonemap (high-intensity HDR scene):\n *   world.spawn(\n *     { component: Transform, data: { ... } },\n *     { component: Camera, data: {\n *       fov: Math.PI / 4, aspect: 16 / 9, near: 0.1, far: 100,\n *       tonemap: TONEMAP_REINHARD_EXTENDED,\n *       exposure: 1.0,\n *       whitePoint: 4.0,\n *     } },\n *   );\n *\n * @example Orthographic camera spanning [-10, 10]^2 on the near plane:\n *   world.spawn(\n *     { component: Transform, data: {\n *       pos: [0, 0, 5],\n *       quat: [0, 0, 0, 1],\n *       scale: [1, 1, 1],\n *     } },\n *     { component: Camera, data: {\n *       fov: 0, aspect: 1, near: 0.1, far: 100,\n *       projection: CAMERA_PROJECTION_ORTHOGRAPHIC,\n *       left: -10, right: 10, bottom: -10, top: 10,\n *     } },\n *   );\n */\nexport const Camera = defineComponent('Camera', {\n  fov: { type: 'f32' },\n  aspect: { type: 'f32' },\n  near: { type: 'f32' },\n  far: { type: 'f32' },\n  projection: { type: 'f32', default: 0 },\n  left: { type: 'f32', default: -1 },\n  right: { type: 'f32', default: 1 },\n  bottom: { type: 'f32', default: -1 },\n  top: { type: 'f32', default: 1 },\n  tonemap: { type: 'f32', default: 0 },\n  exposure: { type: 'f32', default: 1.0 },\n  whitePoint: { type: 'f32', default: 4.0 },\n  antialias: { type: 'f32', default: 0 },\n  historyVersion: { type: 'u32', default: 0 },\n  bloom: { type: 'f32', default: 0 },\n  bloomThreshold: { type: 'f32', default: 1.0 },\n  bloomIntensity: { type: 'f32', default: 1.0 },\n  bloomBlurRadius: { type: 'f32', default: 4.0 },\n  // feat-20260709 M3 / D-3: clear-color is one inline `array<f32,4>` column.\n  // The earlier 4-scalar form (clearR/G/B/A) was chosen when this was believed\n  // to be the only SoA-safe shape; the Transform (pos/quat/scale) and light\n  // (direction/color) precedents disprove that -- an `array<f32,N>` IS an\n  // inline stride-N SoA column, read on the hot path as `col[i*N+a]` with zero\n  // allocation, so collapsing four scalars into one column removes three field\n  // names a reader must track without changing the storage layout or read\n  // pattern. The default `[0, 0, 0, 0]` is transparent black; explicit alpha\n  // stays visible through the same public array field.\n  clearColor: { type: 'array<f32, 4>', default: new Float32Array([0, 0, 0, 0]) },\n  // feat-20260617-host-engine-contract-and-video-cutscene / M3 / D-4: the\n  // aspect-sync sidecar on the createApp(canvas) path writes\n  // canvas.width / canvas.height into `aspect` every frame when this flag is\n  // true. Reuses the existing `bool` column tier (AnimationPlayer.paused /\n  // AudioSource.playing precedent) -- zero ECS infrastructure change. Default\n  // true so demos that never touch aspect track the canvas automatically\n  // (charter P1 default-is-correct); set false for render-to-texture /\n  // split-screen cameras that drive aspect themselves. Read it via\n  // world.get (readRow narrows bool -> JS boolean); the query-bundle path\n  // returns a raw 0/1 number (the `!== 0` always-true trap).\n  autoAspect: { type: 'bool', default: true },\n});\n\n// ─── Camera POD type (derived from Camera token — single source, AC-07) ─────\n//\n// ShapeOf<SchemaOf<typeof Camera>> resolves the 20-field POD from the Camera\n// token's schema, which is itself derived from Camera.fields[k].type (D-A7).\n// This replaces the hand-maintained CameraDataPod interface — the field set\n// lives exclusively in the Camera component definition above.\ntype CameraPod = ShapeOf<SchemaOf<typeof Camera>>;\n\n// ─── Camera factory functions (w13 SSOT refactoring) ─────────────────────\n//\n// Standalone factory functions that return 20-field CameraPod objects\n// matching the Camera component column shape. Not static methods because\n// TypeScript const-namespace merge is not supported, and Object.assign\n// would break the Camera token's reference identity (archetype columns /\n// queries key off the global owner identity associated with the token).\n//\n// Import as:\n//   import { Camera, perspective, orthographic } from '@forgeax/engine-render';\n//   world.spawn({ component: Camera, data: perspective({ fov: 60, aspect: 4/3 }) });\n//\n// Charter P1 progressive disclosure: Barrel re-exports put perspective\n// / orthographic next to Camera in IDE autocomplete.\n//\n// D-A4 factory retention reason: perspective() / orthographic() carry\n// required/optional parameter semantics that cannot be derived from\n// the schema.  perspective requires fov + aspect (no universal default),\n// orthographic requires left/right/bottom/top.  The schema/defaults system\n// only records type + optional default value per field — it has no concept\n// of \"this field MUST be supplied by the caller.\"  The factories encode\n// that contract at the TypeScript type level, which schema/defaults alone\n// cannot express.  Per AC-07, the factories are kept; only the POD type\n// and default literals are derived from the Camera token (SSOT).\n\ninterface CameraPerspectiveOpts {\n  fov: number;\n  aspect: number;\n  near?: number;\n  far?: number;\n  /**\n   * feat-20260617-host-engine-contract-and-video-cutscene / M3: when true\n   * (the schema default), the aspect-sync sidecar on the createApp(canvas)\n   * path overwrites `aspect` with `canvas.width / canvas.height` every frame.\n   * Omit it for the default-correct behaviour; set `false` to opt out (the\n   * factory then leaves `aspect` under your control -- render-to-texture,\n   * split-screen). Cameras built on the bare `createRenderer` path never\n   * receive aspect-sync regardless of this flag.\n   */\n  autoAspect?: boolean;\n}\n\ninterface CameraOrthographicOpts {\n  left: number;\n  right: number;\n  bottom: number;\n  top: number;\n  near?: number;\n  far?: number;\n}\n\n/**\n * Build a CameraPod base from Camera.fields defaults (per-field SSOT).\n * Fields without a default (fov / aspect / near / far — OOS-5) are left\n * unset; caller fills them from opts or sentinel values.\n */\nfunction cameraPodFromDefaults(): CameraPod {\n  const base: Record<string, unknown> = {};\n  for (const [key, field] of Object.entries(Camera.fields)) {\n    if ('default' in field && field.default !== undefined) {\n      base[key] = field.default;\n    }\n  }\n  return base as CameraPod;\n}\n\n/**\n * Convenience factory: perspective CameraData POD.\n *\n * `fov` and `aspect` are required (no sensible universal default).\n * `near` defaults to 0.1, `far` defaults to 100.\n * Orthographic quartet defaults to [-1, 1]x[-1, 1]; tonemap defaults to\n * TONEMAP_NONE (0-overhead path).\n *\n * When `autoAspect` is `true` (the default once shipped in M3), the\n * aspect-sync sidecar on the `createApp(canvas)` path automatically writes\n * `canvas.width / canvas.height` into `Camera.aspect` every frame. Set\n * `autoAspect = false` to opt out (render-to-texture, split-screen).\n * Cameras on the `createRenderer` path do not receive aspect-sync.\n *\n * @see {@link https://github.com/Ubpa/forgeax-engine/blob/main/docs/how-to/2026-06-18-host-engine-contract.md | Host-engine contract SSOT}\n *\n * @example\n * ```ts\n * import { Camera, perspective } from '@forgeax/engine-render';\n * world.spawn(\n *   { component: Camera, data: perspective({ fov: Math.PI / 3, aspect: 4 / 3 }) }\n * ).unwrap();\n * ```\n *\n * @example With explicit near/far:\n * ```ts\n * const camData = perspective({ fov: Math.PI / 4, aspect: 16 / 9, near: 0.01, far: 1000 });\n * world.spawn({ component: Camera, data: camData }).unwrap();\n * ```\n *\n * @example With non-default clear color (default is `[0, 0, 0, 0]`).\n * `clearColor` is an inline `array<f32,4>` field on `Camera`; spread the\n * factory then override:\n * ```ts\n * world.spawn({\n *   component: Camera,\n *   data: { ...perspective({ fov: Math.PI / 3, aspect: 4 / 3 }), clearColor: [0, 1, 0, 1] },\n * }).unwrap();\n * ```\n */\nexport function perspective(opts: CameraPerspectiveOpts): CameraPod {\n  return {\n    // cameraPodFromDefaults() reads autoAspect's schema default (true), so an\n    // omitted opts.autoAspect lands the default-correct value; an explicit\n    // false overrides it below (D-4: factory one-step opt-out, charter P1).\n    ...cameraPodFromDefaults(),\n    fov: opts.fov,\n    aspect: opts.aspect,\n    near: opts.near ?? 0.1,\n    far: opts.far ?? 100,\n    projection: CAMERA_PROJECTION_PERSPECTIVE,\n    ...(opts.autoAspect !== undefined ? { autoAspect: opts.autoAspect } : {}),\n  };\n}\n\n/**\n * Convenience factory: orthographic CameraData POD.\n *\n * All four ortho bounds (`left` / `right` / `bottom` / `top`) are required.\n * `near` defaults to 0.1, `far` defaults to 100.\n * Perspective fields get sentinel defaults (fov=0, aspect=1) for column\n * alignment with the 12-field schema.\n *\n * @example\n * ```ts\n * import { Camera, orthographic } from '@forgeax/engine-render';\n * world.spawn(\n *   { component: Camera, data: orthographic({\n *     left: -10, right: 10, bottom: -10, top: 10,\n *   }) }\n * ).unwrap();\n * ```\n *\n * @example Screen-aligned orthographic for pixel-unit rendering:\n * ```ts\n * const camData = orthographic({ left: 0, right: 800, bottom: 600, top: 0 });\n * world.spawn({ component: Camera, data: camData }).unwrap();\n * ```\n */\nexport function orthographic(opts: CameraOrthographicOpts): CameraPod {\n  return {\n    ...cameraPodFromDefaults(),\n    fov: 0,\n    aspect: 1,\n    near: opts.near ?? 0.1,\n    far: opts.far ?? 100,\n    projection: CAMERA_PROJECTION_ORTHOGRAPHIC,\n    left: opts.left,\n    right: opts.right,\n    bottom: opts.bottom,\n    top: opts.top,\n  };\n}\n","// @forgeax/engine-render - DirectionalLight (directional light parameters\n// with merged shadow config).\n//\n// Schema: direction array<f32,3> + color array<f32,3> + intensity f32 + 1 bool\n// castShadow + 8 f32 shadow columns (feat-20260709 M2: direction/color collapsed\n// from 6 per-axis scalar columns to two inline array<f32,3> columns).\n//\n// Direction (xyz, outgoing) + color (rgb, linear space) + intensity in lux.\n// No Transform dependency (directional lights have no position).\n// The public world-unit convention is 1 world unit = 1 meter. Exposure is a\n// camera output concern and is not folded into this light's intensity.\n//\n// 0 DirectionalLight + standard material -> physically correct black render\n// (charter v2 P3/P4); details: AGENTS.md section Breaking changes 2026-05-18.\n//\n// Naming convention: bare entity name aligned with Bevy ECS conventions\n// (feat-20260513-component-naming-bevy-align). Camera / Transform / etc.\n// follow the same single-semantic-entity rule (charter proposition 5).\n//\n// charter mapping: proposition 1 (single import) + proposition 3 (silent\n// failure -> explicit warning; first-frame warn) + proposition 5 (consistent\n// abstraction: lighting parameters mirror GPU-side pbr.wgsl @group(0) view\n// BG light fields).\n//\n// feat-20260621-merge-directionallightshadow-into-directionallight M1:\n// DirectionalLightShadow's 9 shadow fields are merged into DirectionalLight\n// to collapse the dual-component spawn into a single component (D-6 primary\n// decision). castShadow defaults to true so zero-config spawns get shadows\n// by default; set castShadow=false to opt out. D-6 directional stays\n// first-hit-wins -- no ECS cardinality cap. Renderer allocation policy stays\n// with the shadow atlas owner.\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Directional light (sun-like infinite light source) with merged shadow\n * parameters.\n *\n * `direction` @semantics outgoing — points FROM light source TO surface\n * (opposite of Three.js convention; the shader internally negates this\n * vector to obtain the L vector for BRDF evaluation). `color` is\n * linear-space rgb in [0, 1] per channel and `intensity` is lux. Exposure is\n * applied after lighting by the camera output stage; no hidden light\n * multiplier is applied here.\n *\n * castShadow defaults to true — zero-config spawns cast cascaded shadow maps.\n * Set castShadow: false to opt out (shadow fields are still stored but their\n * validation is skipped).\n *\n * Shadow fields (migrated from DirectionalLightShadow, feat-20260621 M1):\n *   cascadeCount   ∈ {1,2,3,4}  — number of cascades (default 4)\n *   splitLambda    ∈ [0,1]      — PSSM split weight (default 0.75)\n *   cascadeBlend   ∈ [0,0.5]    — blend width between cascades (default 0.2)\n *   mapSize        >= 1         — shadow map resolution (default 2048)\n *   depthBias                    — shadow acne bias (default 0.005)\n *   normalBias                   — shadow acne normal offset (default 0.05)\n *   shadowDistance > 0           — how far shadows reach in front of the camera,\n *                                  in world units (default 200). This is the sole\n *                                  coverage knob: the CSM cascades are PSSM-split\n *                                  across [camera near, shadowDistance] and each\n *                                  cascade's orthographic bounds are fit to the\n *                                  camera frustum slice automatically. The near\n *                                  end is derived from the active camera's near\n *                                  plane (no separate near knob — any value other\n *                                  than the camera near either drops near shadows\n *                                  or wastes cascade-0 resolution).\n *   pcfKernelSize  odd >= 1     — PCF kernel width (default 3)\n *\n * @example Spawn a single directional light with default shadows:\n *   world.spawn({ component: DirectionalLight, data: {\n *     direction: [-0.5, -1, -0.3], // [x, y, z]\n *     color: [1, 1, 1], // [r, g, b]\n *     intensity: 1,\n *   } });\n *\n * @example Opt out of shadows:\n *   world.spawn({ component: DirectionalLight, data: {\n *     direction: [0, -1, 0], // [x, y, z]\n *     castShadow: false,\n *   } });\n *\n * @example Explicit shadow config (single-component spawn):\n *   world.spawn({ component: DirectionalLight, data: {\n *     direction: [0.2, -0.98, 0], // [x, y, z]\n *     color: [1, 1, 1], intensity: 1, // color is [r, g, b]\n *     cascadeCount: 4, splitLambda: 0.75, cascadeBlend: 0.2,\n *     mapSize: 2048, shadowDistance: 200,\n *   } });\n *\n * @example 0-light scene must use an unlit shader (standard 0 light = physically correct black):\n *   const world = new World();\n *   // ... spawn cube + camera, no light ...\n *   await renderer.ready;\n *   renderer.draw(world); // standard material renders black; switch to an unlit shader (Materials.unlit(...)) for an unlit display\n */\nexport const DirectionalLight = defineComponent('DirectionalLight', {\n  // direction is the ONLY field with no default (D-5): omitting it lands the\n  // array layer-3 all-zero [0,0,0], which the renderer owner rejects -- there is no\n  // universal default direction, so \"default is illegal\" forces an explicit\n  // non-zero value. color carries an explicit layer-2 default [1,1,1] (white);\n  // the array layer-3 fallback is all-zero, so the default MUST be explicit.\n  direction: { type: 'array<f32, 3>' },\n  color: { type: 'array<f32, 3>', default: new Float32Array([1, 1, 1]) },\n  intensity: { type: 'f32', default: 1 },\n  // Shadow opt-out gate: defaults to true so zero-config spawns get shadows.\n  castShadow: { type: 'bool', default: true },\n  // 9 shadow fields migrated from DirectionalLightShadow (feat-20260621 M1).\n  cascadeCount: { type: 'f32', default: 4 },\n  splitLambda: { type: 'f32', default: 0.75 },\n  cascadeBlend: { type: 'f32', default: 0.2 },\n  mapSize: { type: 'f32', default: 2048 },\n  depthBias: { type: 'f32', default: 0.005 },\n  normalBias: { type: 'f32', default: 0.05 },\n  // Sole shadow coverage knob (feat replaces nearPlane/farPlane). The PSSM\n  // near end derives from the active camera near; shadowDistance is the far\n  // reach. Default 200 world units (matches UE-style \"dynamic shadow\n  // distance\"; the old farPlane default was 50).\n  shadowDistance: { type: 'f32', default: 200 },\n  pcfKernelSize: { type: 'f32', default: 3 },\n});\n","// @forgeax/engine-render - Instances component (per-entity instanced-draw transforms).\n//\n// Two sources, one component (feat-20260622-chunk-gpu-instancing-sprite-tilemap\n// / AC-09; charter P4 consistent abstraction + charter P1 progressive disclosure).\n// The `Instances` ECS component has exactly TWO sources of `transforms` data, and\n// AI users should hold the boundary explicitly to avoid misreading the ECS view:\n//\n//   Source 1 (EXPLICIT, the only source that lands in ECS) — AI user opt-in.\n//     The AI user hand-attaches `Instances { transforms }` onto an entity at\n//     spawn / set time for high-performance instanced draw. `world.get(e,\n//     Instances)` returns the AI user's payload verbatim (a `Float32Array`\n//     snapshot of column-major mat4 instances; stride = 16). This is the sole\n//     code path through which `Instances` ever appears on an entity.\n//\n//   Source 2 (TRANSPARENT, never written back into ECS) — engine record-stage\n//     fold. When the AI user spawns N independent sprite / tilemap-cell\n//     entities sharing the same (Layer.value, posZ, materialHandle) sort\n//     equivalence class, the engine record stage transparently folds the\n//     equivalent run into ONE `drawIndexed(indexCount, count)` using an\n//     INTERNAL transient buffer (see `render-system-record.ts` fold operator\n//     + `render.instancing.foldedDraws` metric, and the `RhiError\n//     'instancing-exceeds-uniform-cap'` fallback). The fold operator does\n//     NOT auto-inject `Instances` onto those entities — `world.get(e,\n//     Instances)` on a folded entity returns `Result.err` exactly as before.\n//     The ECS view is preserved bit-for-bit (per-cell / per-sprite entity\n//     retained, query / despawn / picking unchanged); the optimisation is\n//     invisible at the component layer (charter P4: consistent abstraction —\n//     the high-performance path is opt-in via Source 1, the default spawn\n//     shape stays untouched).\n//\n// AI user reading this header: do NOT expect engine-side fold to materialise\n// as an `Instances` row on your entity. Read the metric (foldedDraws) or the\n// RhiError code to observe fold behaviour; never gate logic on a runtime\n// `world.get(e, Instances)` lookup after spawn.\n//\n// Schema: 1 array<f32> field `transforms` carrying packed column-major mat4\n// instance transforms (16 f32 per instance, stride = 16). Stride is enforced\n// through a TWO-LAYER contract:\n//\n//   1. AI user set-site: spawn / `world.set` / `world.push` callers pass a\n//      `Float32Array` (or numeric array) whose `length` is a non-zero\n//      multiple of 16. The set site is the AI user's responsibility -- the\n//      engine cannot prove the column-major mat4 packing without the\n//      caller's intent.\n//   2. RenderSystem extract entry: `render-system-extract.ts` performs a\n//      defensive `transforms.length % 16 === 0` check on every\n//      `world.get(e, Instances).transforms` snapshot at frame extract time;\n//      violations route a structured `InstanceTransformsStrideMismatchError`\n//      (`code: 'instance-transforms-stride-mismatch'`,\n//      `detail: { actualLength, expectedStride: 16 }`) through the World\n//      Layer-3 ErrorHandler and the renderable is skipped (fail-fast: the\n//      malformed length never reaches the GPU upload path).\n//\n// feat-20260515-buffer-array-vocab-collapse M3 / w16 (decision §2.3 stride\n// responsibility migration): the legacy component-level\n// stride-declaration option (`{ transforms: 16 }` keyed on the retired\n// per-component stride defineComponent option key) was retired because:\n//   - The ECS layer no longer carries a per-component stride schema (M2 /\n//     w9 dropped the option from `DefineComponentOptions` -- the SSOT\n//     moved to the RenderSystem entry + AI user set site).\n//   - Centralising the check at the consumer (RenderSystem extract) rather\n//     than the producer (ECS write paths) lets the GPU upload path stay\n//     trust-the-snapshot; AI users get one structured error per offending\n//     frame rather than one per write.\n//\n// feat-20260514-ecs-children-instances-managed-buffer-array M3 / w14:\n// migrated from the legacy `{ buffer: 'ref', count: 'u32' }` pair (which\n// cross-coupled with the now-deleted `AssetRegistry.createInstancedBuffer`\n// pipeline + the `InstancedBufferAsset` POD) to the ECS-managed array path.\n// Resize is a `world.push(e, Instances, 'transforms', value)` away (one f32\n// at a time) plus a future `world.grow` if a bulk-resize affordance is\n// added.\n//\n// Storage buffer cap-gate (D-5 OOS-08 follow-up):\n//   - The runtime RenderSystem consumer (`render-system-record.ts`) checks\n//     `device.caps.storageBuffer` before binding the per-entity transforms;\n//     `caps.storageBuffer === false` (backend lacking storage buffer support,\n//     e.g. rhi-wgpu webgl backend) routes a `RhiError` ('feature-not-enabled').\n//     A future loop owns the per-draw fallback path.\n//\n// Group transform chained semantics (charter proposition 5 mental migration):\n//   - When the same entity carries both `Transform` (entity_world) and\n//     `Instances` (per-instance local transforms), the vertex shader\n//     composes per instance:\n//\n//       world_position[i] = entity_world * instances_local[i] * vertex_position\n//\n//   - `Instances.transforms[i*16..i*16+15]` is interpreted as a local-space\n//     transform under the entity, exactly like a child entity's `Transform`\n//     under `ChildOf { parent }` in the hierarchy system. AI users reuse\n//     the `parent x local` intuition without a new concept. Set the\n//     entity's `Transform` to identity to make `instances_local[i]`\n//     directly world-space.\n//\n// 4-segment minimum contract (read this header before reaching for\n// the source body):\n//\n// ===== (a) single-component import + spawn example =====\n//\n//   import {\n//     createRenderer, HANDLE_CUBE,\n//     MeshFilter, MeshRenderer, Transform,\n//     Instances, type InstancesData,\n//   } from '@forgeax/engine-render';\n//\n//   // 1 entity rendering N instanced cubes (16N packed f32, column-major mat4):\n//   const transforms = new Float32Array(N * 16);\n//   // ... fill column-major mat4 columns per instance ...\n//   world.spawn(\n//     { component: MeshFilter,    data: { assetHandle: HANDLE_CUBE } },\n//     { component: MeshRenderer,  data: {} },\n//     { component: Instances,     data: { transforms } },\n//   );\n//\n// ===== (b) packed mat4 layout =====\n//\n//   const transforms = new Float32Array(N * 16); // column-major mat4 per instance\n//   // instance i occupies floats [i*16 .. i*16+15]:\n//   //   [m00 m10 m20 m30   <- column 0\n//   //    m01 m11 m21 m31   <- column 1\n//   //    m02 m12 m22 m32   <- column 2\n//   //    m03 m13 m23 m33]  <- column 3 (translation in m03/m13/m23)\n//\n// `transforms.length` MUST be a non-zero multiple of 16. AI users gate at\n// the set / push site; the RenderSystem extract entry holds the second\n// defensive (AC-06: detail carries `{ expectedStride: 16, actualLength }`).\n// The instance count is the live snapshot length / 16.\n//\n// ===== (c) error code consumption (typed property access, no message regex) =====\n//\n//   // Stride violation surfaces through the engine-ecs Layer-3 ErrorHandler\n//   // when extract reads a malformed snapshot:\n//   //   on('error', (err) => {\n//   //     if (err.code === 'instance-transforms-stride-mismatch') {\n//   //       // err.detail.expectedStride === 16\n//   //       // err.detail.actualLength === <user-supplied length>\n//   //     }\n//   //   });\n//   //\n//   // RenderSystem cap-gate (D-5) -> RhiError 'feature-not-enabled' on the\n//   // RhiErrorListenerRegistry channel:\n//   //   on('error', (err) => {\n//   //     if (err.code === 'feature-not-enabled') {\n//   //       console.warn(err.expected, err.hint);\n//   //     }\n//   //   });\n//\n// charter mapping: proposition 1 (single import surface\n// `import { Instances, type InstancesData } from '@forgeax/engine-render'`);\n// proposition 3 (machine-readable schema > prose:\n// `{ transforms: 'array<f32>' }` is the SSOT, stride 16 documented here +\n// enforced at the RenderSystem entry);\n// proposition 4 (explicit failure: stride violation routes a structured\n// EcsError, not a silent half-row); proposition 5 (consistent abstraction:\n// Instances mirrors Children -- both ride the array-vocab path).\n//\n// Anchors: requirements §AC-06 (stride 16 + RenderSystem upload path);\n// plan-strategy §2.3 (stride responsibility migration to RenderSystem entry\n// defensive + AI user set site) + §3.3 stride error path; plan-decisions\n// D-1 / D-5.\n// OOS-09 (no addChild Commands API) does not apply here; OOS-01 (no\n// dangling-entity sweep) does not apply (Instances stores f32 not entity).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Per-entity instanced-draw transforms (ECS component).\n *\n * Carries a variable-length `array<f32>` of column-major mat4 instance\n * transforms (16 f32 per instance, stride = 16; documented above and\n * enforced at the RenderSystem extract entry, NOT at the ECS write paths).\n *\n * The runtime RenderSystem consumer materialises a fresh `Float32Array`\n * snapshot on every `world.get(e, Instances).transforms` access (D-4\n * no-cache), reads the live count from the snapshot's `length`, and\n * uploads the bytes to a per-entity GPU storage buffer in the record stage\n * (`render-system-record.ts`).\n *\n * @example Spawn an entity rendering 10000 instanced cubes:\n *   const transforms = new Float32Array(10000 * 16);\n *   // ... fill column-major mat4 columns ...\n *   world.spawn(\n *     { component: MeshFilter,   data: { assetHandle: HANDLE_CUBE } },\n *     { component: MeshRenderer, data: { ... } },\n *     { component: Instances,    data: { transforms } },\n *   );\n */\nexport const Instances = defineComponent('Instances', {\n  transforms: { type: 'array<f32>' },\n});\n\n/**\n * Type-level hint for `data` at the `Instances` spawn site.\n *\n * The runtime ECS column shape for `array<f32>` accepts a `Float32Array`\n * payload at spawn / set time (the bytes are copied into the BufferPool\n * slot). The `transforms` field is documented as `Float32Array` here so\n * AI-user IDE autocomplete picks up the typed-array shape.\n *\n * @example\n *   import type { InstancesData } from '@forgeax/engine-render';\n *   const data: InstancesData = { transforms: new Float32Array(N * 16) };\n */\nexport type InstancesData = {\n  readonly transforms: Float32Array;\n};\n","// @forgeax/engine-render - Layer (render-order layer index, signed 32-bit).\n//\n// Schema: 1 i32 column (value). Signed two's complement so negatives travel\n// through the spawn payload unchanged — background sprites live at negative\n// values (e.g. -100), the default game layer at 0, foreground at 100, UI at\n// 1000. Layer is consumed at sort time by `transparent-sort.ts` (M-3 w23)\n// as the primary key in the (layer asc, sortValue asc) composite ordering.\n//\n// Naming convention: bare entity name (no Component suffix; single-semantic\n// component idiom aligned with Bevy ECS conventions — Transform / Camera /\n// DirectionalLight follow the same shape, see AGENTS.md §Component naming).\n//\n// Layer is a generic ECS renderer component — NOT a 2D-only special. 3D\n// entities may also carry Layer to bias their bucket placement (charter\n// P4 consistent abstraction: same component drives both pipelines).\n//\n// AC-18 path (1): an entity spawned without an explicit Layer reads back\n// 0 via the existing 4-layer spawn fallback chain\n// (feat-20260517-spawn-default-fallback). This feat does NOT introduce a\n// fifth fallback layer; the silent default flows through layer-3\n// `typeDefault('i32') === 0`.\n//\n// @derives defineComponent factory (packages/ecs/src/component.ts) — i32\n//   is a legacy scalar type; its intrinsic properties (byteSize / viewCtor\n//   / storage) live in TYPE_METADATA['i32'] (feat-20260602 M1).\n// @reuses spawn 4-layer fallback chain (feat-20260517-spawn-default-fallback)\n//   — layer-3 typeDefault('i32') returns 0, no fifth layer.\n//\n// charter mapping: F1 (single-import barrel discovery — Layer joins\n// Transform / MeshFilter / MeshRenderer / Camera / DirectionalLight)\n// + P3 (explicit default — 0 surfaces as a read-back value, not undefined)\n// + P4 (consistent abstraction — Layer is a generic render component, not\n// a 2D-only special).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Render-order layer index.\n *\n * Convention (non-binding; conveys intent, not enforced):\n *   - negative (e.g. -100): background layers (sky / parallax tiles).\n *   - 0: default game layer.\n *   - positive (e.g. 100): foreground layers (overlays, FX).\n *   - 1000+: UI / HUD.\n *\n * Signed i32 (two's complement, range \\u00b12\\u00b3\\u00b9). Negatives round-trip\n * through the spawn payload unchanged — no schema-layer mutate. i32 lives in\n * the CPU sort path (transparent-sort.ts M-3 w23); no GPU-side stride\n * compatibility risk.\n *\n * @example Minimal spawn (defaults to game layer 0):\n *   world.spawn({ component: Layer, data: {} }); // yields value=0\n *\n * @example Spawn 4 sprites across the conventional layer band:\n *   world.spawn({ component: Layer, data: { value: -100 } }); // background\n *   world.spawn({ component: Layer, data: { value: 0 } });    // default\n *   world.spawn({ component: Layer, data: { value: 100 } });  // foreground\n *   world.spawn({ component: Layer, data: { value: 1000 } }); // UI\n *\n * @example Spawn payload omitting Layer — the 4-layer fallback fills 0:\n *   const e = world.spawn(\n *     { component: Transform, data: { pos: [0, 0, 0],\n *       quat: [0, 0, 0, 1], scale: [1, 1, 1] } },\n *   );\n *   // Layer is not on the entity; query joins must check membership.\n */\nexport const Layer = defineComponent('Layer', {\n  value: { type: 'i32', default: 0 },\n});\n","import { defineComponent } from '@forgeax/engine-ecs';\n\n/** Screen-space independent line segment style. */\nexport const Lines = defineComponent(\n  'Lines',\n  {\n    widthPx: { type: 'f32', default: 1 },\n  },\n  {\n    meta: {\n      quickStart: 'Attach Lines to render line-list MeshAsset pairs in screen pixels.',\n      diagnostics: 'Inspect widthPx at the points-lines admission boundary.',\n      recovery: 'Use points-lines-invalid-style for non-finite or non-positive widthPx values.',\n      boundaries:\n        'Lines owns raster width only; MeshFilter and MeshRenderer own geometry and material.',\n    },\n  },\n);\n","// @forgeax/engine-render - MeshFilter (mesh asset reference).\n//\n// Schema: `{ assetHandle: 'shared<MeshAsset>' }`. The schema-vocab\n// `'shared<T>'` keyword stores a u32 column and type-derives to\n// `Handle<'MeshAsset', 'shared'>` (engine-ecs Handle<T,M> twoParam\n// phantom; `'shared'` mode = ref-counted retain on set / release on\n// clear, lifecycle owned by `SharedRefStore` per feat-20260614).\n// The brand prevents cross-asset assignment at compile time (e.g.\n// `Handle<'TextureAsset','shared'>` is not assignable to `assetHandle`).\n//\n// AI users spawn with the assets-runtime constants `HANDLE_CUBE` /\n// `HANDLE_TRIANGLE` (now branded `Handle<'MeshAsset','shared'>` to\n// match the schema-derived shape); custom mesh registration is owned by\n// feat-future-asset-system (this MVP only exposes builtin handles).\n//\n// Naming flavor: unity-style \"MeshFilter / MeshRenderer\" pair, but the forgeax\n// pair does NOT mirror Unity's filter-toggle semantics - MeshFilter only\n// carries the geometry ref, MeshRenderer only carries the material handle;\n// the pair is independently composable. D-Q7 default-material policy\n// (feat-20260517-merge-mesh-renderer-material-renderer plan-strategy §2.2):\n// case A (entity carries MeshFilter without MeshRenderer) -> archetype\n// query never matches -> entity is silently absent from the\n// RenderableSnapshot[] (NO default-material fallback, NO onError fire);\n// case B (MeshRenderer.material omitted at spawn) -> mid-grey\n// defaultMaterialSnapshot fallback (no onError); case C (material handle\n// unresolved) -> RhiError 'asset-not-registered' (mirrors the\n// MeshFilter.assetHandle dangling-ref path).\n//\n// charter mapping: proposition 1 (single import) + proposition 4 (explicit\n// failure: missing or unregistered handle fires onError 'asset-not-registered'\n// with .detail = { assetHandle } + cross-asset brand mismatch is a TS\n// compile-time error) + proposition 5 (consistent abstraction: the schema\n// vocab `'shared<T>'` is the SSOT for AssetRegistry-owned handles across\n// the engine).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Mesh filter (geometry asset reference).\n *\n * `assetHandle` carries a `Handle<'MeshAsset', 'shared'>` (u32-stored)\n * pointing into `engine.assets: AssetRegistry`. Use the predefined\n * constants `HANDLE_CUBE` / `HANDLE_TRIANGLE` exported from\n * `@forgeax/engine-render`; custom-mesh registration is OOS in MVP (see\n * feat-future-asset-system).\n *\n * Error path: if the handle is not registered at draw time, RenderSystem\n * fires `Renderer.onError` with\n * `RhiError({ code: 'asset-not-registered', detail: { assetHandle } })`\n * and skips this entity (other entities continue rendering; charter\n * proposition 9 graceful degradation).\n *\n * @example Spawn an entity referencing the builtin cube mesh:\n *   import { MeshFilter } from '@forgeax/engine-render';\n *   import { HANDLE_CUBE } from '@forgeax/engine-assets-runtime';\n *   world.spawn({ component: MeshFilter, data: { assetHandle: HANDLE_CUBE } });\n */\nexport const MeshFilter = defineComponent('MeshFilter', {\n  assetHandle: { type: 'shared<MeshAsset>' },\n});\n","// @forgeax/engine-render - MeshRenderer (multi-material array slot).\n//\n// feat-20260608-mesh-multi-section-primitive-multi-material-slot M2 / w7:\n// the single `material` field is replaced with `materials` — an\n// `array<shared<MaterialAsset>>` indexed by MeshAsset.materialSlots. Entries\n// are sparse positional overrides: a missing/zero entry inherits the Mesh\n// slot default, while a defaultless slot inherits the neutral engine material.\n//\n// The schema-vocab keyword `'array<shared<MaterialAsset>>'` (feat-20260614\n// M5 -- migrated from `'array<handle<MaterialAsset>>'`) stores as a u32\n// column slot array; the brand prevents cross-asset assignment at compile\n// time. The `'shared<T>'` arm routes element retain/release through\n// SharedRefStore (M4 / w13) on overwrite / archetype migration.\n//\n// charter mapping: proposition 1 (single import — `MeshRenderer` is the\n// only material-binding component AI users see); proposition 3\n// (machine-readable schema > prose); proposition 4 (explicit failure: the\n// TS brand on `Handle<'MaterialAsset','shared'>` rejects cross-variant\n// assignment at compile time); proposition 5 (consistent abstraction:\n// shading model classification (`'unlit'` / `'standard'`) lives ONLY on\n// the asset discriminant, NOT on the component name).\n//\n// RenderSystem consumption: `render-system-extract.ts` runs ONE archetype\n// query (`world.query(MeshRenderer)`) and routes per entity by\n// `mat.materialShaderId` (shader identity) to the unlit.wgsl or pbr.wgsl\n// pipeline tag.\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Mesh renderer (ECS component, multi-material array).\n *\n * Stores `materials: readonly Handle<'MaterialAsset','shared'>[]`\n * (u32-stored array, indexed by MeshAsset.materialSlots). Submeshes point to\n * those stable slots through `Submesh.materialSlot`. The asset's `passes[].shader`\n * identity is the SSOT for which pipeline RenderSystem routes the entity\n * to (record stage dispatches on `materialShaderId`).\n *\n * Defaults map carries `materials: []`: every slot inherits its Mesh-owned\n * default, or the neutral engine material when that slot is intentionally\n * defaultless.\n *\n * @example Spawn while inheriting every Mesh slot default:\n *   world.spawn({ component: MeshRenderer, data: {} });\n *\n * @example Spawn an unlit-targeted entity:\n *   import { MeshRenderer, Materials } from '@forgeax/engine-render';\n *   const matPayload = engine.assets.catalog(matGuid, Materials.unlit([1, 0, 0, 1])).value;\n *   const matHandle = world.allocSharedRef('MaterialAsset', matPayload);\n *   world.spawn({ component: MeshRenderer, data: { materials: [matHandle] } });\n *\n * @example Spawn a standard (PBR) entity:\n *   const matPayload = engine.assets.catalog(matGuid, Materials.standard({\n *     baseColor: [0.5, 0.5, 0.5, 1], metallic: 0, roughness: 0.4,\n *   })).value;\n *   const matHandle = world.allocSharedRef('MaterialAsset', matPayload);\n *   world.spawn({ component: MeshRenderer, data: { materials: [matHandle] } });\n */\nexport const MeshRenderer = defineComponent('MeshRenderer', {\n  materials: { type: 'array<shared<MaterialAsset>>', default: [] },\n});\n","// @forgeax/engine-render - PointLight (omnidirectional point-light parameters).\n//\n// Schema: color array<f32,3> + intensity f32 + range f32 (feat-20260709 M2:\n// color collapsed from 3 per-axis scalar columns to one inline array<f32,3>).\n// `position` comes from the Transform component; PointLight requires a\n// companion Transform on the same entity (ECS query: `[Transform, PointLight]`).\n// `range` units are meters; defaults to `10.0`. Runtime finite-range\n// attenuation is the Three r184 squared window; the KHR unsquared curve is an\n// import/reference boundary only. See `light-helpers.ts` for the host-side\n// range projection.\n//\n// 0 light + standard material -> physically correct black render\n// (feat-20260518-pbr-direct-lighting-mvp). The runtime once-warn channel\n// (M5 / w25) collapses to \"directionalCount + pointCount + spotCount === 0\";\n// see packages/runtime/README.md section Common pitfalls for the AI-user\n// guidance after the M5 docs land.\n//\n// Naming convention: bare entity name aligned with Bevy ECS conventions\n// (feat-20260513-component-naming-bevy-align). DirectionalLight / SpotLight\n// follow the same single-semantic-entity rule (charter proposition 5).\n//\n// charter mapping: proposition 1 (single import + IDE autocomplete on\n// payload.range) + proposition 3 (silent failure -> explicit failure;\n// spawn-time fail-fast on range<0 / NaN with structured EcsError) +\n// proposition 5 (consistent abstraction: shared payload shape with\n// SpotLight; `range` semantics aligned with KHR_lights_punctual).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Omnidirectional point light (KHR_lights_punctual `point` type).\n *\n * `position` source: the companion `Transform` component on the same entity.\n * Spawn via `world.spawn({ component: Transform, data: ... }, { component: PointLight, data: ... })`\n * so the render system extract path can join the two via the\n * `[Transform, PointLight]` ECS query.\n *\n * `color` is linear-space rgb in `[0, 1]` per channel; `intensity` is candela;\n * `range` is in meters and defaults to `10.0`\n * (KHR convention; `+Infinity` is the KHR no-truncation value, retained\n * for KHR_lights_punctual `range: 0` bridging via `light-helpers.ts`).\n * The runtime window is `clamp(1 - (d / range)^4, 0, 1)^2`; its no-cutoff\n * boundary uses inverse-square decay with the shader safety floor. Exposure is\n * applied after lighting and never multiplied into intensity.\n *\n * @example Spawn a single point light at (5, 3, 5):\n *   world.spawn(\n *     { component: Transform, data: { pos: [5, 3, 5] } },\n *     { component: PointLight, data: { intensity: 8, range: 25 } },\n *   );\n *\n * @example Minimal spawn -- defaults give neutral white at full strength, range 10m:\n *   world.spawn(\n *     { component: Transform, data: { pos: [0, 1, 0] } },\n *     { component: PointLight, data: {} },\n *   );\n *   // resolves to color=[1, 1, 1], intensity=1, range=10.0.\n */\nexport const PointLight = defineComponent('PointLight', {\n  // color carries an explicit layer-2 default [1,1,1] (white); the array\n  // layer-3 fallback is all-zero, so the default MUST be explicit (D-5).\n  color: { type: 'array<f32, 3>', default: new Float32Array([1, 1, 1]) },\n  intensity: { type: 'f32', default: 1 },\n  range: { type: 'f32', default: 10.0 },\n});\n","// @forgeax/engine-runtime — PointLightShadow (omnidirectional point-light\n// shadow mapping parameters; cube-array atlas variant).\n//\n// Schema: 6 f32 columns — mapSize (u32, stored as f32), depthBias, normalBias,\n// nearPlane, farPlane, pcfKernelSize (u32, stored as f32). No fixed-extent\n// field — cube map uses fov=90 perspective, not ortho.\n//\n// Atlas capacity is a renderer policy; ECS does not enforce a component\n// cardinality bound.\n// Co-located with DirectionalLight in components/ (research L1.2).\n//\n// Naming convention: bare entity name (AGENTS.md §Component naming), no\n// Component suffix. Same defineComponent pattern and ShadowInvalidConfigError\n// surface as the shadow fields merged into DirectionalLight (feat-20260621 M1).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Omnidirectional point-light shadow mapping parameters.\n *\n * The renderer may batch this component into a bounded atlas, but the ECS\n * component remains a plain storage schema and carries no cardinality policy.\n *\n * @example Spawn a point light with default shadow config:\n *   world.spawn(\n *     { component: Transform, data: { pos: [0, 4, 0] } },\n *     { component: PointLight, data: { range: 25 } },\n *     { component: PointLightShadow, data: {} }, // 6 fields filled from defaults\n *   );\n *\n * @example Spawn with explicit map size and bias:\n *   world.spawn(\n *     { component: PointLightShadow, data: { mapSize: 1024, depthBias: 0.01 } },\n *   );\n */\nexport const PointLightShadow = defineComponent('PointLightShadow', {\n  mapSize: { type: 'f32', default: 512 },\n  depthBias: { type: 'f32', default: 0.005 },\n  normalBias: { type: 'f32', default: 0.05 },\n  nearPlane: { type: 'f32', default: 0.1 },\n  farPlane: { type: 'f32', default: 25 },\n  pcfKernelSize: { type: 'f32', default: 3 },\n});\n","import { defineComponent } from '@forgeax/engine-ecs';\n\n/** Public point raster shapes backed by the ECS enum column. */\nexport type PointShape = keyof typeof PointShapeValue;\n\n/** Numeric labels stored by the public Points shape enum field. */\nexport const PointShapeValue = Object.freeze({\n  square: 0,\n  circle: 1,\n} as const);\n\n/** Decode the Points shape column without treating an unknown value as valid. */\nexport function pointShapeFromU32(value: number): PointShape | undefined {\n  switch (value) {\n    case PointShapeValue.square:\n      return 'square';\n    case PointShapeValue.circle:\n      return 'circle';\n    default:\n      return undefined;\n  }\n}\n\n/** Screen-space point style. Geometry and material remain on their own owners. */\nexport const Points = defineComponent(\n  'Points',\n  {\n    sizePx: { type: 'f32', default: 4 },\n    shape: { type: 'enum', default: PointShapeValue.square, labels: PointShapeValue },\n  },\n  {\n    meta: {\n      quickStart: 'Attach Points to render point-list MeshAsset vertices in screen pixels.',\n      diagnostics: 'Inspect sizePx and decode shape with pointShapeFromU32.',\n      recovery: 'Use points-lines-invalid-style for non-finite or non-positive sizePx values.',\n      boundaries:\n        'Points owns raster size and shape only; MeshFilter and MeshRenderer own geometry and material.',\n    },\n  },\n);\n","// @forgeax/engine-render - PostProcessParams component.\n//\n// Schema: { shader: 'string', data: 'buffer' }.\n//\n// `shader` identifies the fullscreen post-process shader (the same id as passed to\n// the feature host registers for `id`). `data` carries the per-frame params\n// bytes as a variable-byte ECS managed buffer slot. The write side (world.spawn /\n// world.set) accepts every AllowSharedBufferSource (Float32Array / ArrayBuffer /\n// Uint8Array / typed array) and the ECS normalizes it to Uint8Array bytes\n// (feat-20260621 V2 / AC-A4); the read side (world.get) returns Uint8Array, which\n// satisfies AllowSharedBufferSource for GPU queue.writeBuffer ingestion.\n//\n// Single-semantic component — drops the `Component` suffix\n// (AGENTS.md §Component naming rule #1). The `data` field uses the ECS 'buffer'\n// vocab keyword (plan-strategy D-7) for variable-byte storage.\n//\n// Data flow (plan-strategy D-1):\n//   extract -> iterate PostProcessParams-bearing entities ->\n//   collect into Map<shaderId, AllowSharedBufferSource> snapshot ->\n//   dispatchFullscreenPass picks up per-shader data -> writeBuffer to eager UBO.\n//\n// Decision anchors:\n//   - requirements AC-A2 (data-driven, no imperative renderer.setParams mutator)\n//   - requirements AC-A4 (AllowSharedBufferSource type on the data field)\n//   - plan-strategy D-1 (new single-semantic ECS component for params)\n//   - plan-strategy D-7 (ECS 'buffer' vocab keyword for variable-byte storage)\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\nconst schema = {\n  shader: 'string',\n  data: 'buffer',\n} as const;\n\nexport const PostProcessParams = defineComponent('PostProcessParams', schema);\n","// @forgeax/engine-runtime - SceneInstance component (feat-20260608-\n// scene-nesting-ecs-fication M2 / w16).\n//\n// Single ECS fat component carrying everything that used to live on the\n// old `SceneInstance` + `SceneInstanceContainer` pair (deleted\n// in M3). Schema fits the ECS schema vocab (3 single-identifier fields):\n//\n//   { source:  'shared<SceneAsset>',\n//     mapping: 'array<entity>',\n//     state:   'unique<SceneInstanceState>' }\n//\n// `source` carries the SceneAsset handle the synthetic root entity was\n// instantiated from (Tier-A AssetUnion handle, AGENTS.md §Assets submodule).\n// `mapping` is the LocalEntityId -> Entity table indexed positionally\n// (mapping[localId] = spawned Entity); the ECS variable-array column gives\n// us a SoA-friendly read path for query<SceneInstance> scans without\n// touching the dynamic Map/Set state.\n// `state` is a `ref<SceneInstanceState>` slot — World holds the live\n// SceneInstanceState payload in its UniqueRefStore and World despawn\n// auto-releases the ref u32 (the same path used by audio / physics\n// payloads, plan-strategy §D-2). Each instantiateScene call calls\n// `world.allocUniqueRef('SceneInstanceState', state)` once and stores the\n// returned u32 in this column.\n//\n// Decision anchors:\n//   - plan-strategy §D-2 (single ref wraps SceneInstanceState dynamic\n//     structure; ECS schema vocab `\\w+` rejects `ref<Map<...>>`)\n//   - plan-strategy §3.2 sequence (sequence diagram step 'set ... state:\n//     {entityToLocalId, detached, overrides, rootEntities}')\n//   - AGENTS.md §Component naming rule #1 (single-semantic component drops\n//     `Component` suffix)\n//   - charter F1 (single-import barrel: SceneInstance lives in\n//     `@forgeax/engine-render` next to Transform / Camera / DirectionalLight)\n//   - charter P3 (machine-readable schema: 3 closed fields)\n//   - charter P4 (consistent abstraction: instance == entity carrying\n//     SceneInstance — same `world.query({ read: [SceneInstance] })` /\n//     `world.get(root, SceneInstance)` path as another component)\n\nimport { defineComponent, type EntityHandle } from '@forgeax/engine-ecs';\nimport type { LocalEntityId, MountOverride } from '@forgeax/engine-types';\n\n/**\n * Per-component, per-field override record carried in `SceneInstanceState`.\n *\n * Composite key `<componentName>:<fieldName>` keeps the override map flat\n * (single Map nesting level) so AI users walking `state.overrides` see one\n * iteration depth — D-2 prefers a single SSOT over multi-Map nesting that\n * would make iteration order ambiguous (charter F1: single mental model).\n *\n * The value is `unknown` because the per-component schema vocab lives in the\n * ECS layer; runtime fail-fast via `EcsErrorCode = 'scene-override-type-\n * mismatch'` (plan-strategy §D-9) catches type drift on the apply path.\n *\n * @internal Surface from `state.overrides` only; AI users never construct a\n *   record directly. Use `world.setSceneOverride(root, member, comp,\n *   field, value)` to write and `world.removeSceneOverride(root, member,\n *   comp, field)` to roll back to the source SceneAsset value.\n */\nexport interface SceneInstanceOverrideRecord {\n  readonly comp: string;\n  /**\n   * Component-granular add-or-patch discriminant (feat-20260713 M1 / w4):\n   * present -> this record patches a single field; absent -> it adds/upserts\n   * the whole `comp` (M2 apply semantics). Mirrors `MountOverride.field`.\n   */\n  readonly field?: string;\n  readonly value: unknown;\n}\n\n/**\n * Dynamic state payload for one SceneInstance — held in the World's\n * UniqueRefStore behind a `ref<SceneInstanceState>` slot on the synthetic\n * root entity. Mirrors the old class-based layout (plan-strategy §D-2 +\n * design doc §11.2 internal-state-table) but flattened into plain JS Maps/Sets so\n * AI users can iterate without indirection.\n *\n * Lifecycle:\n *   - allocated by `world.instantiateScene(handle, parent?)` — the W in\n *     `world.allocUniqueRef('SceneInstanceState', state)` returns the u32\n *     slot id stored in the SceneInstance.state column;\n *   - released by `world.despawn(root)` (the standard `ref<T>` release loop)\n *     or explicitly via `world.despawnScene(root)` / `world.despawnDescendants(root)`.\n *\n * AI users typically reach this struct only through the read path\n * `world.get(root, SceneInstance).state.overrides.get(<comp>:<field>)` for\n * inspection; mutation happens through the 8 World methods.\n */\nexport interface SceneInstanceState {\n  /**\n   * SceneAsset handle the instance was instantiated from. Mirrors the\n   * SceneInstance.source column for AI users who already have a\n   * SceneInstanceState in hand and want the source handle without a second\n   * `world.get` round-trip.\n   */\n  readonly source: import('@forgeax/engine-types').Handle<'SceneAsset', 'shared'>;\n\n  /**\n   * Reverse mapping (live `Entity` -> source `LocalEntityId`). Used by\n   * `world.setSceneOverride` to validate the member entity belongs to this\n   * instance + by `world.detachSceneMember` / `world.reattachSceneMember`\n   * to translate caller-side Entity values back to their authored localId.\n   */\n  readonly entityToLocalId: Map<EntityHandle, LocalEntityId>;\n\n  /**\n   * LocalEntityIds of members the AI user marked detached via\n   * `world.detachSceneMember(root, member)`. The member entities stay\n   * alive in the World; only the bookkeeping marker moves so\n   * `world.despawnDescendants(root, { keepDetached: true })` can skip them.\n   * Detach is idempotent (set semantics).\n   */\n  readonly detachedLocalIds: Set<LocalEntityId>;\n\n  /**\n   * Per-member runtime overrides keyed by `<localId>` -> `<comp>:<field>`\n   * -> override record. mount-time overrides (authored on the SceneAsset's\n   * `mounts[].overrides`) populate this map at instantiate-time so AI\n   * users see them via the same read path as runtime\n   * `setSceneOverride` writes (single SSOT).\n   */\n  readonly overrides: Map<LocalEntityId, Map<string, SceneInstanceOverrideRecord>>;\n\n  /**\n   * Top-level root entities of the materialised tree (members without a\n   * ChildOf parent at instantiate time). The synthetic root entity that\n   * carries the SceneInstance component itself is NOT in this list — it is\n   * the parent of every member entity (plan-strategy §3.2 sequence step 7).\n   */\n  readonly rootEntities: EntityHandle[];\n\n  /** Synthetic roots of recursively mounted SceneAssets owned by this instance. */\n  readonly mountRoots: EntityHandle[];\n\n  /**\n   * Total slot count `entities.length + sum(mounts[].memberCount)` —\n   * captured at instantiate-time so cycle / count consistency checks\n   * (e.g. `world.getSceneAssetForInstance(root)` symmetry) can compare\n   * against the live SceneInstance.mapping column without re-reading the\n   * SceneAsset.\n   */\n  readonly totalSlots: number;\n\n  /**\n   * Mount-time override authored on the parent SceneAsset's `mounts[]`\n   * record. Captured at instantiate-time so `world.removeSceneOverride`\n   * can fall back to the mount-time value before going to the source\n   * SceneAsset value (plan-strategy §D-2).\n   */\n  readonly mountTimeOverrides: readonly MountOverride[];\n}\n\n/**\n * SceneInstance ECS component — synthetic root entity payload for one\n * materialised SceneAsset (instance == entity carrying SceneInstance,\n * charter P4).\n *\n * AI users discover the component via IDE autocomplete on\n * `@forgeax/engine-render` (single-import barrel; AGENTS.md §Components):\n *\n * ```ts\n * import { SceneInstance } from '@forgeax/engine-render';\n * for (const row of world.query({ read: [SceneInstance] }).unwrap()) {\n *   console.log(`root=${row.entity} source=${row.get(SceneInstance).source}`);\n * }\n *\n * const inst = world.get(root, SceneInstance).value;\n * const memberEntity = inst.mapping[localId]; // Uint32Array snapshot\n * for (const detached of inst.state.detachedLocalIds) { /* ... *\\/ }\n * ```\n *\n * The component does not register a relationship — synthetic root +\n * members are wired through the standard `ChildOf` (member -> root) so\n * the existing `world.iterDescendants(root)` / Children mirror code paths\n * apply unchanged (plan-strategy §D-5).\n *\n * @example Materialise + inspect a SceneAsset:\n *   const { root, diagnostics } = world.instantiateScene(handle).value;\n *   const inst = world.get(root, SceneInstance).value;\n *   // inst.source === handle, inst.mapping is Uint32Array(totalSlots)\n *   // inst.state holds entityToLocalId / detachedLocalIds / overrides /\n *   // rootEntities / mountRoots / totalSlots / mountTimeOverrides.\n */\nexport const SceneInstance = defineComponent(\n  'SceneInstance',\n  {\n    source: { type: 'shared<SceneAsset>' },\n    mapping: { type: 'array<entity>' },\n    // The unique slot is the ECS storage seam for the instance's structured\n    // runtime payload; keep the nested semantic visible to schema consumers.\n    state: { type: 'unique<SceneInstanceState>', shape: 'nested' },\n  },\n  { transient: true },\n);\n","// @forgeax/engine-runtime - SkyboxBackground (environment cubemap render background).\n//\n// Schema: 3 fields -- equirect (Handle<EquirectAsset>, u32-stored handle)\n// + mode (f32 enum column, discriminator) + rotation (quaternion xyzw,\n// default identity). Naming convention follows the\n// single-semantic component rule: no Component suffix (AGENTS.md rule #1).\n//\n// feat-20260630-equirect-kind-internalized-ibl-declarative-skyligh M3 / w16:\n// the field is `equirect: shared<EquirectAsset>` (the retired\n// `cubemap: shared<CubeTextureAsset>` is gone). The skybox reuses the same\n// equirect handle as the Skylight; the cubemap projection is internal and\n// driven by the render-system record arm (no user upload call).\n//\n// Plan-strategy D-5: mode is a f32 enum column (ECS columns are POD, no\n// string unions in archetype storage). Consumer-facing type safety is\n// provided by the `SkyboxMode` literal union + `skyboxModeFromF32` mapper\n// (same pattern as cameraProjectionFromF32 in camera.ts:51,105,145,221-237).\n//\n// OOS-1: `mode: 'atmosphere'` implementation is deferred -- the union\n// shape leaves room for additive growth without breaking the f32 enum\n// encoding.\n//\n// AI user minimum spawn (charter P4):\n//   world.spawn({ component: SkyboxBackground, data: { equirect, mode: 0 } });\n//\n// Single component activates the skybox render pass transparently when a\n// Skylight + tonemap active camera is present (skybox reuses the same\n// equirect handle as Skylight).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Skybox mode literal union (AC-02 narrowing surface).\n * Currently only 'cubemap' -- future 'atmosphere' deferred per OOS-1.\n */\nexport type SkyboxMode = 'cubemap';\n\n/** Numeric encoding of cubemap skybox mode (schema value for `mode`). */\nexport const SKYBOX_MODE_CUBEMAP = 0;\n\n/**\n * Map a `SkyboxBackground.mode` numeric value to the closed `SkyboxMode`\n * string-literal union. Only member currently is 'cubemap'; the exhaustive\n * switch is ready for future mode additions (e.g. 'atmosphere', OOS-1).\n */\nexport function skyboxModeFromF32(value: number): SkyboxMode {\n  switch (value) {\n    case SKYBOX_MODE_CUBEMAP:\n      return 'cubemap';\n    // Future: case SKYBOX_MODE_ATMOSPHERE: return 'atmosphere';\n  }\n  // Unrecognised value: fall back to 'cubemap' (charter P3 -- no silent\n  // exception; the fallback preserves rendering on stale numerics while\n  // the exhaustive switch shape ensures AI users catch new members at\n  // compile time when a mode is added).\n  return 'cubemap';\n}\n\n/**\n * SkyboxBackground: full-screen environment cubemap background.\n *\n * Renders a fullscreen triangle that reconstructs world-space view\n * direction from the camera's inverseViewProj matrix (View UBO),\n * samples a cubemap with the view direction, and writes an HDR color\n * to the hdrColor render target (before the main geometry pass).\n *\n * The skybox pass is automatically activated when a SkyboxBackground\n * entity exists, a Skylight entity provides the equirect source, and the\n * active Camera has tonemap active. The skybox reuses the same equirect\n * handle as the Skylight entity -- two independent components sharing the\n * same GPU resource (the internally-projected cubemap).\n *\n * `equirect` is a `Handle<EquirectAsset>` resolved from a vite pack-index\n * GUID via `engine.assets.loadByGuid<EquirectAsset>(guid)`. The cubemap\n * projection is internal and driven by the render-system record arm; there\n * is no user upload call.\n *\n * `mode` is a numeric discriminator column (`'f32'`). Use\n * `SKYBOX_MODE_CUBEMAP` for the cubemap render path.\n *\n * `rotation` is an environment-space quaternion in `[x, y, z, w]` order.\n * It rotates the sampled cubemap without changing the camera or rebaking the\n * source equirectangular asset.\n *\n * @example Minimum spawn (defaults mode=0):\n *   // equirectHandle resolved from loadByGuid<EquirectAsset> (same handle as\n *   // the Skylight).\n *   world.spawn({ component: SkyboxBackground, data: { equirect: equirectHandle } });\n *\n * @example Single handle shared between Skylight (IBL) and SkyboxBackground:\n *   const hdrRes = await engine.assets.loadByGuid<EquirectAsset>(guid);\n *   if (!hdrRes.ok) throw hdrRes.error;\n *   world.spawn({ component: Skylight,     data: { equirect: hdrRes.value } });\n *   world.spawn({ component: SkyboxBackground, data: { equirect: hdrRes.value } });\n */\nexport const SkyboxBackground = defineComponent('SkyboxBackground', {\n  // The GPU skybox projection is render-owned presentation state; restore\n  // keeps the portable mode/rotation controls and lets the owner re-resolve\n  // the environment asset on the target world.\n  equirect: { type: 'shared<EquirectAsset>', simulationTransient: true },\n  mode: { type: 'f32', default: SKYBOX_MODE_CUBEMAP },\n  rotation: { type: 'array<f32, 4>', default: new Float32Array([0, 0, 0, 1]) },\n});\n","// @forgeax/engine-runtime - Skylight (ambient environment light).\n//\n// Schema: 4 fields -- equirect (Handle<EquirectAsset>, u32-stored handle,\n// OPTIONAL) + color (array<f32,3>, default [1,1,1] = white) + intensity (f32,\n// default 1.0) + rotation (quaternion xyzw, default identity). feat-20260709 M2 collapsed colorR/G/B into one inline\n// array<f32,3> column. Naming convention follows the DirectionalLight / PointLight /\n// SpotLight family: no Component suffix (AGENTS.md rule #1).\n//\n// Plan-strategy D-6: Skylight component schema is registered but no\n// independent ECS system is created. All Skylight processing happens inside\n// RenderSystem's extract/record phases.\n//\n// AI user minimum spawn (AC-13, charter P4):\n//   world.spawn({ component: Skylight, data: {} });  // instant white ambient\n//\n// A single Skylight activates ambient lighting transparently. The `equirect`\n// field is OPTIONAL: omit it for a constant solid-color ambient that needs NO\n// async GPU precompute -- the engine binds a 1x1 white irradiance cube, so\n// ambient = color * intensity * albedo is live on the very first frame (this\n// is the fix for the downstream \"scene is black until the async IBL cubemap\n// finishes uploading\" gap). Supply an equirect to upgrade to full image-based\n// lighting (diffuse irradiance + specular prefilter); `color` * `intensity`\n// still scales the IBL result, so both are live dynamic dials either way.\n//\n// feat-20260630-equirect-kind-internalized-ibl-declarative-skyligh M3 / w16:\n// the field is `equirect: shared<EquirectAsset>` (the retired\n// `cubemap: shared<CubeTextureAsset>` is gone). AI users declare the equirect\n// source directly; the render-system record arm projects the cubemap + IBL\n// chain internally and lazily (no user upload call) -- there is no\n// uploadCubemapFromEquirect on the public surface.\n//\n// Edge cases handled by w18 / w19:\n//   - Multi-Skylight: first archetype hit wins, console.warn in dev+prod\n//   - intensity=0: ambient term = 0, mathematically valid, no warn\n//   - No equirect: solid-color ambient via the white fallback cube (no async)\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Skylight ambient environment light.\n *\n * A single Skylight entity provides ambient lighting for all StandardMaterial\n * surfaces. Two modes share one component:\n *\n * - **Solid-color ambient (no equirect).** Omit `equirect` for a constant\n *   ambient = `color` * `intensity` applied immediately, with no async GPU\n *   precompute. The engine samples a built-in 1x1 white irradiance cube, so a\n *   freshly-loaded scene is lit on its first frame instead of being black\n *   until an IBL upload finishes.\n * - **Image-based lighting (with equirect).** Supply `equirect` to upgrade to\n *   diffuse irradiance + specular prefilter IBL. The engine runs the full\n *   precompute (equirect->cubemap, irradiance convolution, prefilter mip\n *   chain, BRDF LUT) transparently inside the render-system record arm;\n *   `color` * `intensity` then scale the IBL ambient.\n *\n * `equirect` is an OPTIONAL `Handle<EquirectAsset>` resolved from a vite\n * pack-index GUID via `engine.assets.loadByGuid<EquirectAsset>(guid)`. The\n * cubemap projection is internal and idempotent: the same equirect source\n * always resolves to the same GPU cubemap (no user upload call).\n *\n * `color` is the linear-space ambient tint (default white [1, 1, 1]).\n * `intensity` is a linear multiplier (default 1.0; 0 disables ambient). Both\n * are read every frame, so they are live dynamic dials.\n *\n * `rotation` is an environment-space quaternion in `[x, y, z, w]` order.\n * The default identity quaternion leaves the source orientation unchanged;\n * changing it rotates the IBL at sample time without rebaking the source.\n *\n * @example Instant white ambient (no asset, no async):\n *   world.spawn({ component: Skylight, data: {} });\n *\n * @example Dim warm ambient:\n *   world.spawn({ component: Skylight, data: { color: [1, 0.9, 0.8], intensity: 0.3 } }); // color is [r, g, b]\n *\n * @example Full IBL from an HDR equirect (declarative -- no upload call):\n *   // 1. resolve GUID from vite pack-index (see forgeax-engine-vite-plugin-pack)\n *   import { AssetGuid } from '@forgeax/engine-pack/guid';\n *   const guidRes = AssetGuid.parse('019e4a26-3c29-7420-af5d-20f2724a16b0');\n *   if (!guidRes.ok) throw guidRes.error;\n *   // 2. load the HDR equirect via the GUID-addressed pack route\n *   const hdrRes = await engine.assets.loadByGuid<EquirectAsset>(guidRes.value);\n *   if (!hdrRes.ok) throw hdrRes.error;\n *   // 3. spawn the Skylight — the equirect handle activates the full IBL path;\n *   //    the cubemap + IBL precompute happen lazily inside the record arm.\n *   world.spawn({ component: Skylight, data: { equirect: hdrRes.value } });\n */\nexport const Skylight = defineComponent('Skylight', {\n  // The GPU equirect-to-cubemap projection is render-owned presentation\n  // state. Record/restore preserves the portable lighting controls while the\n  // render owner resolves this asset again on the target world.\n  equirect: { type: 'shared<EquirectAsset>', simulationTransient: true },\n  // color carries an explicit layer-2 default [1,1,1] (white); the array\n  // layer-3 fallback is all-zero, so the default MUST be explicit (D-5).\n  color: { type: 'array<f32, 3>', default: new Float32Array([1, 1, 1]) },\n  intensity: { type: 'f32', default: 1.0 },\n  rotation: { type: 'array<f32, 4>', default: new Float32Array([0, 0, 0, 1]) },\n});\n","// @forgeax/engine-render - SortKey (per-entity transparent sort override, f32).\n//\n// Schema: 1 f32 column (value). Entity-level sort override consumed by\n// `transparent-sort.ts` (M-3 w23): when present, SortKey.value REPLACES\n// the mode-formula result for this entity in the (layer, sortValue)\n// composite ordering. Override priority is higher than every\n// TransparentSortConfig mode computation (horizontal-z / Y-sort /\n// Y-Z-blend) so AI users can pin a single entity above / below the\n// procedural ordering without reshaping the entire scene.\n//\n// Like Layer, SortKey is a generic ECS renderer component — NOT a\n// 2D-only special. 3D entities may also carry SortKey to bias their\n// position inside the transparent bucket (charter P4 consistent\n// abstraction: same component drives both pipelines).\n//\n// AC-19 derivation audit row (4) names this file as the\n// `defineComponent` factory derivation. JSDoc surfaces the override\n// priority via @derives (ECS factory) annotation; the consumer side\n// of the override behaviour is implemented + verified in M-3 w16 +\n// w23, not here.\n//\n// @derives defineComponent factory (packages/ecs/src/component.ts) —\n//   f32 is a legacy scalar type; its intrinsic properties (byteSize / viewCtor\n//   / storage) live in TYPE_METADATA['f32'] (feat-20260602 M1).\n//\n// charter mapping: F1 (single-import barrel - joins Layer / Transform\n// / MeshFilter / MeshRenderer / Camera / DirectionalLight) +\n// P3 (explicit default 0.0 surfaces via the 4-layer fallback chain) +\n// P4 (consistent abstraction — generic render component, not 2D-only).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Per-entity transparent-sort override.\n *\n * When attached to an entity inside the transparent bucket (M-3 w22),\n * `SortKey.value` REPLACES the result of `TransparentSortConfig.mode`\n * formula evaluation for this entity. Sort key range is the host's\n * choice — typical use is small (e.g. -10 ... +10) to keep the\n * composite (layer asc, sortValue asc) ordering predictable; large\n * magnitudes work but cross-layer biasing should usually go through\n * `Layer` instead.\n *\n * Override priority (M-3 w23 transparent-sort algorithm):\n *\n *   if (world.has(entity, SortKey)) {\n *     sortValue = world.get(entity, SortKey).value;\n *   } else {\n *     sortValue = modeFormula(mode, transform, sprite);\n *   }\n *\n * SortKey lives alongside Layer in the (layer, sortValue) composite\n * key — Layer remains the primary key, SortKey replaces the secondary\n * key. This means a `Layer { value: 100 }` foreground entity with\n * `SortKey { value: -99 }` still draws AFTER a `Layer { value: 0 }`\n * background entity; SortKey biases WITHIN a layer, not ACROSS layers.\n *\n * @example Minimal spawn (no override, use mode formula):\n *   world.spawn({ component: SortKey, data: {} }); // yields value=0\n *\n * @example Bias one sprite above the JRPG Y-sort formula:\n *   world.spawn(\n *     { component: Transform, data: { pos: [0, 1, 0],\n *       quat: [0, 0, 0, 1], scale: [1, 1, 1] } },\n *     { component: Layer, data: { value: 0 } },\n *     { component: SortKey, data: { value: -100 } },\n *   );\n *\n * @example Spawn payload omitting SortKey — the 4-layer fallback fills 0:\n *   // entity reads back SortKey only if explicitly attached;\n *   // otherwise the mode-formula path is taken by transparent-sort.ts.\n */\nexport const SortKey = defineComponent('SortKey', {\n  value: { type: 'f32', default: 0 },\n});\n","// @forgeax/engine-render - SpotLight (cone-restricted spot-light parameters).\n//\n// Schema: direction array<f32,3> + color array<f32,3> + intensity + range +\n// innerConeDeg + outerConeDeg (feat-20260709 M2: direction/color collapsed from\n// 6 per-axis scalar columns to two inline array<f32,3> columns). `position`\n// comes from the\n// Transform component; SpotLight requires a companion Transform on the same\n// entity (ECS query: `[Transform, SpotLight]`). Cone units are degrees on\n// the Component API surface (charter F1 prior-knowledge alignment with\n// Three.js); the host-side extract step pre-converts to `cosInner` /\n// `cosOuter` before GPU upload (plan-strategy section 8.2 naming convention\n// + D-3 host-side cone conversion).\n//\n// `range` units are meters; defaults to `10.0`. Runtime finite-range\n// attenuation is the Three r184 squared window; the KHR unsquared curve is an\n// import/reference boundary only. The cone falloff is layered on top with\n// `smoothstep(cosOuter, cosInner, dot(L, -direction))` (plan-strategy D-S4).\n//\n// 0 light + standard material -> physically correct black render. The\n// once-warn channel collapses to \"directionalCount + pointCount +\n// spotCount === 0\" (M5 / w25).\n//\n// feat-20260625-spot-light-shadow-mapping M1 w4: embedded castShadow (default true)\n// + 6 shadow fields (mapSize / depthBias / normalBias / nearPlane / farPlane /\n// pcfKernelSize) aligned with DirectionalLight vocabulary (plan-strategy D-6;\n// charter P4 consistent abstraction). Zero-config spawns cast spot shadows;\n// set castShadow:false to opt out (validate short-circuits on false, AC-03).\n// Shadow atlas cap of 4 is enforced at extract stage, not component layer (OOS-5).\n//\n// charter mapping: proposition 1 (single import + IDE autocomplete on\n// payload.outerConeDeg with no `as` cast) + proposition 3 (silent failure\n// -> explicit failure; spawn-time fail-fast on three bound violations) +\n// proposition 5 (consistent abstraction: outgoing direction semantics\n// shared with DirectionalLight; cone deg API + cos shader uniform\n// pre-conversion mirrors directional path's host-side `lightDir x intensity`\n// pre-multiplication).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Cone-restricted spot light (KHR_lights_punctual `spot` type).  Casts shadows\n * by default (castShadow defaults to true) — zero-config spawns project hard\n * PCF shadows through an independent spot depth atlas.\n *\n * `direction` @semantics outgoing -- points FROM light source TO the\n * scene (consistent with `DirectionalLight`; the shader internally negates\n * this vector to obtain the L vector for BRDF evaluation:\n * `let l = normalize(-light.direction)`). Extract owns the single\n * normalization step for the snapshot; URP and HDRP consume that normalized\n * value without re-normalizing. `position` source: the companion\n * `Transform` component on the same entity.\n *\n * `innerConeDeg` is the half-angle of the saturated bright region (cone\n * fully bright at the axis); `outerConeDeg` is the half-angle of the\n * falloff edge (cone fully dark beyond). Unit is **degrees**;\n * `outerConeDeg in (innerConeDeg, 90]` (KHR upper bound; spawn-time\n * validation rejects `outer > 90` and `outer <= inner`). The host-side\n * extract step converts both to `cos*` before GPU upload so the shader\n * only sees pre-computed cosines (plan-strategy D-S2 byte freeze; charter\n * P4 host pre-multiplication parity).\n *\n * `color` is linear-space rgb in `[0, 1]` per channel; `intensity` is candela;\n * `range` is in meters and defaults to `10.0`. Exposure is a camera output\n * operation and does not change the stored intensity.\n *\n * Shadow fields (embedded, aligned with DirectionalLight):\n *   castShadow    ∈ {true, false}    — shadow opt-out gate (default true)\n *   mapSize       >= 1               — shadow map resolution per tile (default 2048)\n *   depthBias                        — shadow acne bias (default 0.005)\n *   normalBias                       — shadow acne normal offset (default 0.05)\n *   nearPlane                        — shadow-camera near (default 0.1)\n *   farPlane                         — shadow-camera far (default 50)\n *   pcfKernelSize odd >= 1           — PCF kernel width (default 3)\n *\n * Atlas capacity is capped at 4 castShadow spot lights by the extract stage;\n * the 5th light onward keeps direct illumination but shadowAtlasTile = -1\n * (AC-05: clip is programmatically detectable, light stays visible).\n *\n * @example Spawn a single spot light casting shadows (zero-config):\n *   world.spawn(\n *     { component: Transform, data: { pos: [0, 5, 0] } },\n *     { component: SpotLight, data: { direction: [0, -1, 0] } }, // [x, y, z]\n *   );\n *\n * @example Opt out of shadows:\n *   world.spawn(\n *     { component: Transform, data: { pos: [0, 5, 0] } },\n *     { component: SpotLight, data: { direction: [0, -1, 0], castShadow: false } },\n *   );\n *\n * @example Explicit shadow config:\n *   world.spawn(\n *     { component: Transform, data: { pos: [0, 5, 0] } },\n *     { component: SpotLight, data: { direction: [0, -1, 0], depthBias: 0.01, normalBias: 0.08, mapSize: 1024 } },\n *   );\n *\n * @example Minimal spawn -- defaults give neutral white at full strength, range 10m, KHR pi/4 cone:\n *   world.spawn(\n *     { component: Transform, data: { pos: [0, 5, 0] } },\n *     { component: SpotLight, data: { direction: [0, -1, 0] } }, // [x, y, z]\n *   );\n *   // resolves to color=[1,1,1], intensity=1, range=10.0,\n *   // innerConeDeg=0, outerConeDeg=45 (KHR pi/4 equivalent).\n */\nexport const SpotLight = defineComponent('SpotLight', {\n  // direction has no default (D-5): omitting it lands the array layer-3\n  // all-zero, which validate() rejects. color carries an explicit layer-2\n  // default [1,1,1] (white); the array layer-3 fallback is all-zero.\n  direction: { type: 'array<f32, 3>' },\n  color: { type: 'array<f32, 3>', default: new Float32Array([1, 1, 1]) },\n  intensity: { type: 'f32', default: 1 },\n  range: { type: 'f32', default: 10.0 },\n  innerConeDeg: { type: 'f32', default: 0 },\n  outerConeDeg: { type: 'f32', default: 45 },\n  // Shadow opt-out gate: defaults to true so zero-config spawns cast shadows.\n  castShadow: { type: 'bool', default: true },\n  // 6 shadow fields aligned with DirectionalLight (plan-strategy D-6).\n  mapSize: { type: 'f32', default: 2048 },\n  depthBias: { type: 'f32', default: 0.005 },\n  normalBias: { type: 'f32', default: 0.05 },\n  nearPlane: { type: 'f32', default: 0.1 },\n  farPlane: { type: 'f32', default: 50 },\n  pcfKernelSize: { type: 'f32', default: 3 },\n});\n","import { defineComponent } from '@forgeax/engine-ecs';\n\n/** Numeric labels stored by the public Visibility enum field. */\nexport const VisibilityStateValue = Object.freeze({\n  inherited: 0,\n  hidden: 1,\n  visible: 2,\n} as const);\n\n/** Author visibility intent accepted by the Visibility component. */\nexport type VisibilityState = keyof typeof VisibilityStateValue;\n\n/**\n * Decode the stored u32 without treating an unknown value as a valid state.\n * Invalid values are rejected at ECS write boundaries; undefined remains an\n * explicit signal for readers that inspect externally corrupted columns.\n */\nexport function visibilityStateFromU32(value: number): VisibilityState | undefined {\n  switch (value) {\n    case VisibilityStateValue.inherited:\n      return 'inherited';\n    case VisibilityStateValue.hidden:\n      return 'hidden';\n    case VisibilityStateValue.visible:\n      return 'visible';\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Author intent for render participation. Omitted state is inherited and is\n * therefore visible when no valid parent intent is available.\n */\nexport const Visibility = defineComponent(\n  'Visibility',\n  {\n    state: {\n      type: 'enum',\n      default: VisibilityStateValue.inherited,\n      labels: VisibilityStateValue,\n    },\n  },\n  {\n    meta: {\n      quickStart: 'Attach Visibility to author render participation intent.',\n      diagnostics: 'Compare the ECS state with resolveVisibility and renderer.visibilityStats.',\n      recovery: 'Use structured ECS write errors and repair the owning scene relation.',\n      boundaries:\n        'Visibility does not own camera, picking, lifecycle, assets, or VFX shadow policy.',\n    },\n  },\n);\n","export const STANDARD_PIPELINE_ID = 'forgeax::standard' as const;\nexport const STANDARD_LIGHT_COUNTS = [1, 32, 256] as const;\n/** Shared clustered-lighting facts consumed by pipeline, record, and buffers. */\nexport const DEFAULT_CLUSTER_GRID = { x: 16, y: 9, z: 24 } as const;\nexport const CLUSTER_GRID_STRIDE_U32 = 2;\nexport const LIGHT_INDEX_LIST_CAPACITY = 1048576;\nexport const MAX_LIGHTS = 256;\n\nexport type StandardLightCount = (typeof STANDARD_LIGHT_COUNTS)[number];\nexport type StandardLightingLane = 'direct' | 'clustered';\nexport type StandardFallbackLane = 'native' | 'cpu-webgl2';\nexport type StandardShadowMode = 'off' | 'hard' | 'filtered';\nexport type StandardTone =\n  | 'none'\n  | 'aces-filmic'\n  | 'agx'\n  | 'cineon'\n  | 'linear'\n  | 'neutral'\n  | 'reinhard'\n  | 'reinhard-extended';\nexport type StandardAntialias = 'none' | 'fxaa' | 'msaa';\nexport type StandardPostStage = 'transparent-blend' | 'bloom' | 'tone' | 'fxaa' | 'output';\n\nexport interface StandardProfile {\n  readonly pipelineId: typeof STANDARD_PIPELINE_ID;\n  readonly lightCount: StandardLightCount;\n  readonly lighting: StandardLightingLane;\n  readonly shadows: StandardShadowMode;\n  readonly pbr: boolean;\n  readonly ibl: boolean;\n  readonly ssao: boolean;\n  readonly bloom: boolean;\n  readonly tone: StandardTone;\n  readonly antialias: StandardAntialias;\n  readonly sky: boolean;\n  readonly fallback: StandardFallbackLane;\n  readonly postStages: readonly ['transparent-blend', 'bloom', 'tone', 'fxaa', 'output'];\n}\n\nexport const DEFAULT_STANDARD_PROFILE: StandardProfile = Object.freeze({\n  pipelineId: STANDARD_PIPELINE_ID,\n  lightCount: 32,\n  lighting: 'direct',\n  shadows: 'filtered',\n  pbr: true,\n  ibl: true,\n  ssao: false,\n  bloom: true,\n  tone: 'aces-filmic',\n  antialias: 'fxaa',\n  sky: true,\n  fallback: 'native',\n  postStages: ['transparent-blend', 'bloom', 'tone', 'fxaa', 'output'] as const,\n});\n\nexport type StandardLane = StandardLightingLane | 'cpu-webgl2';\n\nexport function resolveStandardLane(\n  profile: Pick<StandardProfile, 'lighting'>,\n  capabilities: { readonly compute: boolean; readonly storageBuffer: boolean },\n): StandardLane {\n  if (!capabilities.compute || !capabilities.storageBuffer) return 'cpu-webgl2';\n  return profile.lighting;\n}\n","import type { AssetRuntimeError } from '@forgeax/engine-assets-runtime';\nimport type { World } from '@forgeax/engine-ecs';\nimport type { RenderReadLease } from '@forgeax/engine-ecs/projection';\nimport type { Vec3 } from '@forgeax/engine-math';\nimport type { ProfileFrameToken, Profiler } from '@forgeax/engine-profiler';\nimport type { RenderGraphError } from '@forgeax/engine-render-graph';\nimport type {\n  BindGroupLayout,\n  Buffer,\n  Result,\n  RhiCaps,\n  RhiCommandEncoder,\n  RhiDevice,\n  RhiError,\n  RhiInstance,\n  RhiRenderPassEncoder,\n  RenderPipeline as RhiRenderPipeline,\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 { RenderError } from './errors/render';\nimport type { RenderFeature, RenderFeatureDiagnostics } from './features/types';\nimport type { PostProcessShaderEntry } from './fullscreen-post-process-pass';\nimport type { RenderSceneInspection } from './inspection-types';\n\nexport type { PointsLinesInspection } from './points-lines/inspection';\n\nimport type { MeshMaterialBindingObservation } from './mesh-material-bindings';\nimport type { StandardProfile } from './pipeline/standard-profile';\nimport type { PostProcessError } from './post-process-errors';\n\nexport type RenderResult<T, E> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/** The only World data boundary accepted by the M6 renderer contract. */\nexport type RenderWorldLease = RenderReadLease;\n\n/**\n * Camera facts shared by extract, record, and scene owners.\n *\n * The extract stage resolves ECS camera state once and publishes this closed\n * POD contract. Keeping it beside the render lifecycle contracts prevents\n * extract from depending on the record implementation owner.\n */\nexport interface CameraSnapshot {\n  /** Stable ECS identity used by the frame plan's camera authority fact. */\n  readonly entityKey?: number;\n  /** World-space camera translation (mat4.getTranslation of Transform.world). */\n  readonly position: Vec3;\n  /** Resolved world-space camera mat4, copied from Transform.world. */\n  readonly world: Float32Array;\n  readonly fov: number;\n  readonly aspect: number;\n  readonly near: number;\n  readonly far: number;\n  /** Camera projection variant used by view and shadow matrix builders. */\n  readonly projection: 'perspective' | 'orthographic';\n  readonly orthoLeft: number;\n  readonly orthoRight: number;\n  readonly orthoBottom: number;\n  readonly orthoTop: number;\n  readonly tonemap: Tonemap;\n  readonly exposure: number;\n  readonly whitePoint: number;\n  readonly antialias: Antialias;\n  readonly bloom: BloomEnabled;\n  readonly bloomThreshold: number;\n  readonly bloomIntensity: number;\n  readonly bloomBlurRadius: number;\n  readonly clearColor: readonly [number, number, number, number];\n}\n\n/** Stable identity owned by the Standard feature host for built-in tonemap. */\nexport const STANDARD_TONEMAP_FEATURE_ID = 'forgeax::standard::tonemap';\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}\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  readonly errorRegistry: { fire(error: RendererError): void };\n  readonly debugOverlay?: RenderDebugOverlay | undefined;\n  readonly lookupPostProcess?: (id: string) => PostProcessShaderEntry | undefined;\n  readonly getPostProcessParamsBuffer?: (id: string) => Buffer | undefined;\n  readonly getPostProcessPipeline?: (\n    id: string,\n    bgl: BindGroupLayout,\n    colorFormat: GPUTextureFormat,\n  ) => RhiRenderPipeline | null;\n}\n\n/**\n * Render-owned declaration for an app-provided debug overlay. App owns the\n * concrete DebugDraw instance and its GPU lifecycle; Render only records this\n * capability in the typed graph.\n */\nexport interface RenderDebugOverlay {\n  encode(\n    pass: RhiRenderPassEncoder,\n    viewProj: import('@forgeax/engine-math').Mat4,\n  ): Result<void, unknown>;\n}\n\n/**\n * The leaf frame context consumed by RenderPipeline and graph primitives.\n * Concrete assembly data is added only by the internal record extension in\n * render-system.ts, so this contract never imports the RenderSystem owner.\n */\nexport interface RenderPipelineContext {\n  readonly pipelineState: RenderPipelineStateView;\n  readonly runtime: RenderPipelineRuntime;\n  readonly encoder: RhiCommandEncoder;\n  readonly view: TextureView;\n  readonly clear: readonly [number, number, number, number] | number[];\n  readonly targetW: number;\n  readonly targetH: number;\n  readonly currentTexture: Texture;\n  readonly camera: CameraSnapshot;\n  /** Per-frame post-process parameter bytes keyed by shader id. */\n  readonly postProcessParams: ReadonlyMap<string, Uint8Array>;\n  readonly msaaActive: boolean;\n  readonly geometryColorResolveView: TextureView | null;\n  readonly ldrSpriteColorView: TextureView | null;\n}\n\n/**\n * The sole public renderer contract. Concrete assembly stays behind the host;\n * callers retain only leases, receipts, inspection PODs, and recovery Result.\n */\nexport interface Renderer {\n  attach(world: World): RenderResult<RenderWorldLease, RenderError>;\n  draw(input: RenderFrameInput): RenderResult<FrameReceipt, RenderError>;\n  setProfile(profile: RenderProfile): RenderResult<void, RenderError>;\n  state(): RendererState;\n  inspect(): RenderInspection;\n  observe(\n    receipt: FrameReceipt,\n    request: FrameObservationRequest,\n  ): Promise<RenderResult<FrameReceiptObservation, RenderError>>;\n  subscribe(listener: (event: RendererEvent) => void): () => void;\n  releaseSurface(): RenderResult<void, RenderError>;\n  restoreSurface(): RenderResult<void, RenderError>;\n  recover(): Promise<RenderResult<void, RenderError>>;\n  dispose(): Promise<RenderResult<void, RenderError>>;\n}\n\n/** The single public renderer lifecycle authority. */\nexport type RendererState = 'alive' | 'device-lost' | 'recovering' | 'faulted' | 'disposed';\n\n/** Immutable, inspectable quality and budget policy for the Standard pipeline. */\nexport type RenderProfile = StandardProfile;\n\n/** Ordered events projected from renderer state and expected-operation failures. */\nexport type RendererEvent =\n  | {\n      readonly kind: 'state-changed';\n      readonly previous: RendererState;\n      readonly current: RendererState;\n    }\n  | { readonly kind: 'error'; readonly error: RenderError }\n  /** Emitted only after the renderer's sole submit path returns a receipt. */\n  | {\n      readonly kind: 'frame-submitted';\n      readonly frameId: number;\n      readonly deviceGeneration: number;\n    };\n\n/** Package-local listener alias used by the renderer assembly implementation. */\nexport type RendererEventListener = (event: RendererEvent) => void;\n\n/**\n * Camera authority supplied for one frame; Render owns the lease contract and\n * the host releases it with the frame lifecycle. It is intentionally bound to\n * the attached scene lease and never accepts a backend object.\n */\nexport interface FrameCamera {\n  readonly lease: RenderWorldLease;\n  readonly entityKey?: number;\n}\n\n/**\n * Environment authority supplied for one frame. The scene/environment owner\n * supplies the identity; the host validates it against the attached lease.\n */\nexport interface FrameEnvironment {\n  readonly lease: RenderWorldLease;\n  readonly identity?: string;\n}\n\n/**\n * Receipt-bound observation selection. The request is consumed by `observe`\n * only with the matching FrameReceipt and returns a structured Result error\n * when the generation or frame identity is stale.\n */\nexport interface FrameObservationRequest {\n  readonly include: readonly ('timings' | 'draws' | 'bindings')[];\n}\n\n/**\n * Immutable synchronous proof that the sole host-owned submit reached the\n * queue. It is the only successful synchronous draw signal and is required by\n * every observation request.\n */\nexport interface FrameReceipt {\n  readonly frameId: number;\n  readonly deviceGeneration: number;\n  readonly completed: Promise<RenderResult<void, RenderError>>;\n}\n\n/**\n * The sole public draw input; World objects never cross this boundary. Render\n * owns extraction and graph interpretation, while the host owns encoding,\n * finish, submit, and recovery of the attached lease generation.\n */\nexport interface RenderFrameInput {\n  readonly leases: readonly RenderWorldLease[];\n  readonly camera: FrameCamera;\n  readonly environment: FrameEnvironment;\n  /** Optional profiler correlation token owned by App and consumed by Render. */\n  readonly profileFrame?: ProfileFrameToken;\n}\n\n/** Detached, bounded observation metadata tied to one FrameReceipt and request. */\nexport interface FrameReceiptObservation {\n  readonly frameId: number;\n  readonly deviceGeneration: number;\n  readonly include: readonly ('timings' | 'draws' | 'bindings')[];\n}\n\n/**\n * Detached renderer facts for host diagnostics and capability selection.\n *\n * The snapshot contains only POD values. It never exposes a device, queue,\n * registry, encoder, or live renderer-owned collection.\n */\nexport interface RenderInspection {\n  readonly state: RendererState;\n  readonly surface: 'available' | 'released';\n  readonly profile: RenderProfile;\n  readonly capabilities: Readonly<RhiCaps>;\n  readonly frame: {\n    readonly frameId: number;\n    readonly deviceGeneration: number;\n  };\n  readonly features: readonly string[];\n  /** Truthful lifecycle facts for every registered declarative feature. */\n  readonly featureDiagnostics: readonly RenderFeatureDiagnostics[];\n  readonly frustumStats: { readonly culled: number; readonly total: number };\n  readonly visibilityStats: { readonly explicitlyHidden: number };\n  readonly renderScene: RenderSceneInspection;\n  readonly meshMaterialBindings: readonly MeshMaterialBindingObservation[];\n  readonly perFramePassNames: readonly string[];\n  readonly bindGroupCounts: {\n    readonly createBindGroup: number;\n    readonly keys: readonly string[];\n  };\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/tonemap',\n  'record/graph-execute/debug-overlay',\n  'record/graph-execute/shadow',\n  'record/graph-execute/spot-shadow',\n  'record/graph-execute/skybox',\n  'record/graph-execute/main',\n  'record/graph-execute/fxaa',\n  'record/graph-execute/bloom-bright',\n  'record/graph-execute/bloom-blur-h',\n  'record/graph-execute/bloom-blur-v',\n  'record/graph-execute/bloom-composite',\n  'record/graph-execute/other',\n] as const;\n\nexport type RenderGraphExecutionPhase = (typeof RENDER_GRAPH_EXECUTION_PHASE_CATALOG)[number];\n\n/** Bounded producer-owned children of the scene-state record owner. */\nexport const RENDER_HDRP_BINNER_PHASE_CATALOG = [\n  'record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy',\n  'record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/light-aabb',\n  'record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/cluster-occupancy',\n  'record/scene-state/hdrp-cluster/binner/cluster-reserve',\n  'record/scene-state/hdrp-cluster/binner/input-preparation',\n  'record/scene-state/hdrp-cluster/binner/bin-core',\n  'record/scene-state/hdrp-cluster/binner/light-index-write',\n  'record/scene-state/hdrp-cluster/binner/light-index-write/bounds-read',\n  'record/scene-state/hdrp-cluster/binner/light-index-write/cluster-write',\n] as const;\n\nexport const RENDER_HDRP_CLUSTER_PHASE_CATALOG = [\n  'record/scene-state/hdrp-cluster/binner',\n  ...RENDER_HDRP_BINNER_PHASE_CATALOG,\n  'record/scene-state/hdrp-cluster/payload-packing',\n  'record/scene-state/hdrp-cluster/buffer-upload',\n] as const;\n\nexport type RenderHdrpClusterPhase = (typeof RENDER_HDRP_CLUSTER_PHASE_CATALOG)[number];\n\nexport const RENDER_SCENE_STATE_PHASE_CATALOG = [\n  'record/scene-state/fold-buckets',\n  'record/scene-state/lighting-prep',\n  'record/scene-state/ambient-resolution',\n  'record/scene-state/directional-shadow-cache',\n  'record/scene-state/hdrp-cluster',\n  ...RENDER_HDRP_CLUSTER_PHASE_CATALOG,\n] as const;\n\n/**\n * Opt-in boundaries inside one `Renderer.draw` call. The observer is a\n * diagnostics seam only: it receives wall-time boundaries and must never be\n * required for rendering correctness. The stage names mirror the existing\n * engine-owned Extract / Prepare / Record orchestration so a host can measure\n * attribution without guessing from RHI command counts.\n */\nexport const RENDER_RECORD_PHASE_CATALOG = [\n  'record/scene-state',\n  ...RENDER_SCENE_STATE_PHASE_CATALOG,\n  'record/swapchain',\n  'record/render-graph',\n  'record/target-views',\n  'record/validation',\n  'record/dispatch-plan',\n  'record/uploads',\n  'record/bind-groups',\n  'record/graph-execute',\n  ...RENDER_GRAPH_EXECUTION_PHASE_CATALOG,\n] as const;\n\nexport type RenderRecordPhase = (typeof RENDER_RECORD_PHASE_CATALOG)[number];\n\nexport const RENDER_PHASE_CATALOG = [\n  'extract',\n  'bind-groups',\n  'features',\n  'sort',\n  'record',\n  ...RENDER_RECORD_PHASE_CATALOG,\n] as const;\n\nexport type RenderPhase = (typeof RENDER_PHASE_CATALOG)[number];\n\nexport type RenderPhaseSkipReason =\n  | 'feature-host-unavailable'\n  | 'feature-host-empty'\n  | 'pipeline-state-unavailable'\n  | 'camera-unavailable';\n\n/** First-version options bag (intentionally empty; reserved for v0.1). */\nexport interface RendererOptions {\n  /** Producer-owned features installed by the renderer host. */\n  readonly features?: readonly RenderFeature<unknown>[] | undefined;\n  /** Standard profile consumed by the single renderer-owned pipeline. */\n  readonly standardProfile?: RenderProfile | undefined;\n  /** Explicit profiler capability shared by App and Render. */\n  readonly profiler?: Profiler | undefined;\n  /** Optional host-owned RHI lifecycle instrumentation, such as recording. */\n  readonly rhiInstrumentation?: RhiBackendInstrumentation | undefined;\n  // feat-20260608-create-app-param-surface-trim / M1 / AC-02: `clearColor`\n  // was deleted as a one-cut breaking change (AGENTS.md Change stance +\n  // requirements constraint #1: no deprecation window, no shim). Scene\n  // clear color now lives on the Camera entity (`clearColor`, an inline\n  // array<f32,4> column as of feat-20260709 M3); zero-Camera fallback uses\n  // `ZERO_CAMERA_CLEAR_FALLBACK = [0, 0, 0, 1]` from\n  // `render-system-record`. AI users that pass `{ clearColor: [...] }` on\n  // RendererOptions still get a TS2353 excess-property error at compile time.\n  //\n  // feat-20260608-create-app-param-surface-trim / M2 / AC-06 + D-3:\n  // `shaderManifestUrl` was deleted from RendererOptions and moved to\n  // the third-arg `BundlerOptions` (build-tool injection channel). The\n  // fallback literal '/shaders/manifest.json' stays at the createRenderer\n  // body site (D-2 q5-A) so the LO 1.1 zero-config takeoff path keeps\n  // working without explicit injection. AI users that pass\n  // `{ shaderManifestUrl: '...' }` to RendererOptions get a TS2353\n  // excess-property error at compile time pointing them to the third\n  // arg (charter P1 progressive disclosure -- the message names\n  // BundlerOptions, not a free-form string).\n  /**\n   * M3 D-P4 escape hatch (feat-20260511-rhi-wgpu-impl): explicit\n   * `RhiInstance` injection bypasses the dynamic-import auto-select\n   * facade. When set, `createRenderer` uses this instance verbatim and\n   * neither concrete backend adapter is imported dynamically (charter\n   * proposition 5 discoverable opt-in /\n   * plan-strategy §6 M3 + §7.4 escape hatch + Bevy\n   * `RenderCreation::Manual` partial equivalent).\n   *\n   * Typical use cases:\n   *   - Testing / debugging — inject a deterministic stub.\n   *   - Pinning a specific backend even when the browser adapter is present,\n   *     for cross-shim regression tests.\n   *   - Advanced AI users implementing their own `RhiInstance` shim.\n   *\n   * AI users who want the default behaviour leave this field omitted;\n   * `navigator.gpu` presence/absence drives the dynamic import (see the\n   * `createRenderer` JSDoc for the full auto-select decision tree).\n   */\n  readonly rhi?: RhiInstance | undefined;\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// Renderer health / recover surface (feat-20260621-renderer-health-recover-skeleton M1)\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Closed union of renderer health states.\n *\n * 3 members per plan-strategy D-1:\n *   - `'alive'` — healthy baseline (registry not yet fired)\n *   - `'device-lost'` — device loss detected\n *   - `'internal-fault'` — internal renderer fault\n *\n * AI users exhaustively switch on `HealthReason` without default; TS guards\n * completeness.\n */\nexport type HealthReason = 'alive' | 'device-lost' | 'internal-fault';\n\n/** Detail for `HealthReason 'device-lost'`. */\nexport interface HealthDetailDeviceLost {\n  readonly lostReason: 'unknown' | 'destroyed';\n  readonly message: string;\n}\n\n/** Detail for `HealthReason 'internal-fault'`. */\nexport interface HealthDetailInternalFault {\n  readonly message: string;\n}\n\n/**\n * Pull-style health snapshot — discriminated union by `reason`.\n *\n * Per plan-strategy D-2: `switch(snap.reason)` narrows `snap.detail` to the\n * per-reason detail type automatically, with zero `as` casts. `alive` has no\n * `.detail` field; `device-lost` / `internal-fault` have a required `.detail`\n * of the respective variant.\n *\n *   - `recoverable` — explicit snapshot data owned by the lifecycle authority\n */\nexport type HealthSnapshot =\n  | { readonly reason: 'alive'; readonly recoverable: boolean }\n  | {\n      readonly reason: 'device-lost';\n      readonly detail: HealthDetailDeviceLost;\n      readonly recoverable: boolean;\n    }\n  | {\n      readonly reason: 'internal-fault';\n      readonly detail: HealthDetailInternalFault;\n      readonly recoverable: boolean;\n    };\n\n/**\n * Maps `HealthReason` to recoverable boolean per the derive table\n * (requirements section \"range\"):\n *\n *   | reason         | recoverable |\n *   |:---------------|:-----------|\n *   | `'alive'`      | false       |\n *   | `'device-lost'`| true        |\n *   | `'internal-fault'` | false   |\n */\n/** Callback type for `Renderer.onHealthChange`. */\nexport type HealthChangeListener = (snapshot: HealthSnapshot) => void;\n","import { err, type MaterialAsset, type MeshAsset, ok, type Result } from '@forgeax/engine-types';\nimport { type PointShape, PointShapeValue, pointShapeFromU32 } from '../components/points';\nimport type {\n  PointsLinesBudgetExceededError,\n  PointsLinesInvalidStyleError,\n  PointsLinesMaterialUnsupportedError,\n  PointsLinesStyleUnsupportedError,\n  PointsLinesTopologyMismatchError,\n} from '../errors/render';\nimport {\n  PointsLinesBudgetExceededError as BudgetError,\n  PointsLinesInvalidStyleError as InvalidStyleError,\n  PointsLinesMaterialUnsupportedError as MaterialError,\n  PointsLinesStyleUnsupportedError as StyleError,\n  PointsLinesTopologyMismatchError as TopologyError,\n} from '../errors/render';\n\nexport interface PointsStyleInput {\n  readonly sizePx?: number;\n  readonly shape?: number;\n}\n\nexport interface LinesStyleInput {\n  readonly widthPx?: number;\n}\n\nexport interface PointsLinesAdmissionLimits {\n  readonly maxPoints?: number;\n  readonly maxSegments?: number;\n}\n\nexport interface PointsLinesAdmissionInput {\n  readonly entity: number;\n  readonly points?: PointsStyleInput;\n  readonly lines?: LinesStyleInput;\n  readonly mesh: MeshAsset;\n  readonly material: MaterialAsset;\n  readonly limits?: PointsLinesAdmissionLimits;\n  readonly materialId?: string;\n}\n\nexport interface PointsLinesAdmission {\n  readonly component: 'Points' | 'Lines';\n  readonly shape?: PointShape;\n  readonly sizePx?: number;\n  readonly widthPx?: number;\n  readonly pointCount: number;\n  readonly segmentCount: number;\n  readonly submeshes: readonly number[];\n}\n\nexport type PointsLinesAdmissionError =\n  | PointsLinesInvalidStyleError\n  | PointsLinesTopologyMismatchError\n  | PointsLinesStyleUnsupportedError\n  | PointsLinesMaterialUnsupportedError\n  | PointsLinesBudgetExceededError;\n\nfunction invalidStyle(\n  input: PointsLinesAdmissionInput,\n  component: 'Points' | 'Lines' | 'Points/Lines',\n  field: string,\n  value: number | string | undefined,\n  expected: string,\n): Result<never, PointsLinesAdmissionError> {\n  return err(new InvalidStyleError({ entity: input.entity, component, field, value, expected }));\n}\n\nfunction topologyMismatch(\n  input: PointsLinesAdmissionInput,\n  submesh: number,\n  expected: string,\n  actual: string,\n): Result<never, PointsLinesAdmissionError> {\n  return err(new TopologyError({ entity: input.entity, submesh, expected, actual }));\n}\n\nfunction checkStyle(\n  input: PointsLinesAdmissionInput,\n): Result<\n  { component: 'Points' | 'Lines'; shape?: PointShape; sizePx?: number; widthPx?: number },\n  PointsLinesAdmissionError\n> {\n  const hasPoints = input.points !== undefined;\n  const hasLines = input.lines !== undefined;\n  if (hasPoints && hasLines) {\n    return invalidStyle(\n      input,\n      'Points/Lines',\n      'components',\n      'Points + Lines',\n      'exactly one style component',\n    );\n  }\n  if (!hasPoints && !hasLines) {\n    return invalidStyle(input, 'Points/Lines', 'components', undefined, 'one style component');\n  }\n\n  if (hasPoints) {\n    const sizePx = input.points?.sizePx ?? 4;\n    const shapeValue = input.points?.shape ?? PointShapeValue.square;\n    const shape = pointShapeFromU32(shapeValue);\n    if (!Number.isFinite(sizePx) || sizePx <= 0) {\n      return invalidStyle(input, 'Points', 'sizePx', sizePx, 'finite sizePx > 0');\n    }\n    if (shape === undefined) {\n      return invalidStyle(input, 'Points', 'shape', shapeValue, \"shape is 'square' or 'circle'\");\n    }\n    return ok({ component: 'Points', shape, sizePx });\n  }\n\n  const widthPx = input.lines?.widthPx ?? 1;\n  if (!Number.isFinite(widthPx) || widthPx <= 0) {\n    return invalidStyle(input, 'Lines', 'widthPx', widthPx, 'finite widthPx > 0');\n  }\n  return ok({ component: 'Lines', widthPx });\n}\n\nfunction checkTopology(\n  input: PointsLinesAdmissionInput,\n  component: 'Points' | 'Lines',\n): Result<\n  { pointCount: number; segmentCount: number; submeshes: readonly number[] },\n  PointsLinesAdmissionError\n> {\n  const expected = component === 'Points' ? 'point-list' : 'line-list';\n  let pointCount = 0;\n  let segmentCount = 0;\n  const acceptedSubmeshes: number[] = [];\n  let sawNonEmpty = false;\n\n  for (const [submeshIndex, submesh] of input.mesh.submeshes.entries()) {\n    const indexed = input.mesh.indices !== undefined && submesh.indexCount > 0;\n    const elementCount = indexed ? submesh.indexCount : submesh.vertexCount;\n    if (elementCount === 0) continue;\n    sawNonEmpty = true;\n\n    if (component === 'Lines' && submesh.topology === 'line-strip') {\n      return err(\n        new StyleError({\n          lane: 'admission',\n          field: 'topology',\n          member: 'line-strip',\n          supported: ['line-list'],\n        }),\n      );\n    }\n    if (submesh.topology !== expected) {\n      return topologyMismatch(input, submeshIndex, expected, submesh.topology);\n    }\n    if (component === 'Lines' && elementCount % 2 !== 0) {\n      return topologyMismatch(input, submeshIndex, 'line-list pairs', 'line-list odd tail');\n    }\n    acceptedSubmeshes.push(submeshIndex);\n    if (component === 'Points') pointCount += elementCount;\n    else segmentCount += elementCount / 2;\n  }\n\n  if (!sawNonEmpty) return topologyMismatch(input, 0, expected, 'empty-range');\n  return ok({ pointCount, segmentCount, submeshes: acceptedSubmeshes });\n}\n\nfunction checkMaterial(input: PointsLinesAdmissionInput): Result<void, PointsLinesAdmissionError> {\n  const passes = input.material.passes ?? [];\n  const unlitModules = new Set(['forgeax_material::unlit', 'forgeax::default-unlit']);\n  if (passes.length !== 1 || passes[0] === undefined) {\n    const pass =\n      passes.find(\n        (candidate) => candidate.name === 'deferred' || candidate.name === 'shadow-caster',\n      ) ?? passes[0];\n    return err(\n      new MaterialError({\n        entity: input.entity,\n        material: input.materialId ?? '<anonymous>',\n        pass: pass?.name ?? '<empty>',\n        module: pass?.program.module ?? '<empty>',\n        reason: 'points-lines admission requires one unlit forward pass',\n      }),\n    );\n  }\n  const pass = passes[0];\n  const lightMode = (pass.renderState?.tags as Record<string, unknown> | undefined)?.LightMode;\n  if (\n    !unlitModules.has(pass.program.module) ||\n    pass.name !== 'forward' ||\n    lightMode === 'ShadowCaster'\n  ) {\n    return err(\n      new MaterialError({\n        entity: input.entity,\n        material: input.materialId ?? '<anonymous>',\n        pass: pass.name,\n        module: pass.program.module,\n        reason: 'points-lines admission requires an engine-owned unlit forward pass',\n      }),\n    );\n  }\n  return ok(undefined);\n}\n\n/** Validate one complete Points/Lines candidate before any renderer publication. */\nexport function admitPointsLines(\n  input: PointsLinesAdmissionInput,\n): Result<PointsLinesAdmission, PointsLinesAdmissionError> {\n  const style = checkStyle(input);\n  if (!style.ok) return style;\n  const topology = checkTopology(input, style.value.component);\n  if (!topology.ok) return topology;\n  const material = checkMaterial(input);\n  if (!material.ok) return material;\n\n  if (style.value.component === 'Points' && input.limits?.maxPoints !== undefined) {\n    if (topology.value.pointCount > input.limits.maxPoints) {\n      return err(\n        new BudgetError({\n          lane: 'admission',\n          requested: topology.value.pointCount,\n          limit: input.limits.maxPoints,\n          unit: 'points',\n        }),\n      );\n    }\n  }\n  if (style.value.component === 'Lines' && input.limits?.maxSegments !== undefined) {\n    if (topology.value.segmentCount > input.limits.maxSegments) {\n      return err(\n        new BudgetError({\n          lane: 'admission',\n          requested: topology.value.segmentCount,\n          limit: input.limits.maxSegments,\n          unit: 'segments',\n        }),\n      );\n    }\n  }\n\n  return ok({ ...style.value, ...topology.value });\n}\n","import { Entity, type EntityHandle, type World } from '@forgeax/engine-ecs';\nimport {\n  projectHierarchy,\n  type SceneHierarchyDiagnostic,\n  type SceneHierarchySnapshot,\n} from '@forgeax/engine-scene';\nimport {\n  Visibility,\n  type VisibilityState,\n  VisibilityStateValue,\n  visibilityStateFromU32,\n} from '../components/visibility';\n\nexport type VisibilitySource = 'default' | 'self' | 'parent';\n\nexport interface VisibilityResolution {\n  /** The component value authored on this entity before inheritance. */\n  readonly intent: VisibilityState;\n  /** The state consumed by render candidates after parent resolution. */\n  readonly effective: 'hidden' | 'visible';\n  /** Explains whether the effective state came from self, parent, or default. */\n  readonly source: VisibilitySource;\n}\n\nexport interface VisibilitySnapshot {\n  readonly diagnostics: readonly SceneHierarchyDiagnostic[];\n  readonly hasAnyIntent: boolean;\n  readonly hasAnyHiddenIntent: boolean;\n  get(entity: EntityHandle): VisibilityResolution | undefined;\n  /** Resolve effective visibility for a render candidate, including inherited defaults. */\n  effective(entity: EntityHandle): 'hidden' | 'visible';\n}\n\ninterface ResolutionState {\n  readonly intent: VisibilityState;\n  readonly effective: 'hidden' | 'visible';\n  readonly source: VisibilitySource;\n}\n\n/**\n * Resolve author intent against the scene-owned valid parent projection.\n * Diagnostics are preserved for callers to repair hierarchy input before retry.\n */\nexport function resolveVisibility(\n  world: World,\n  hierarchy: SceneHierarchySnapshot = projectHierarchy(world),\n): VisibilitySnapshot {\n  const query = world.query({ read: [Entity], optional: [Visibility] });\n  let intentCount = 0;\n  let hasAnyHiddenIntent = false;\n  if (query.ok) {\n    for (const row of query.value) {\n      const visibility = row.get(Visibility);\n      if (visibility === undefined) continue;\n      intentCount += 1;\n      if (visibility.state === VisibilityStateValue.hidden) {\n        hasAnyHiddenIntent = true;\n      }\n    }\n  }\n\n  let resolveEntity: ((entity: EntityHandle) => ResolutionState | undefined) | undefined;\n  let hasIntent: ((entity: EntityHandle) => boolean) | undefined;\n  const ensureResolver = (): void => {\n    if (resolveEntity !== undefined) return;\n    const intentByEntity = new Map<EntityHandle, VisibilityState>();\n    if (query.ok) {\n      for (const row of query.value) {\n        const raw = row.get(Visibility);\n        const intent = raw === undefined ? undefined : visibilityStateFromU32(raw.state);\n        if (intent !== undefined) {\n          intentByEntity.set(row.entity, intent);\n        }\n      }\n    }\n    hasIntent = (entity: EntityHandle): boolean => intentByEntity.has(entity);\n    const resolved = new Map<EntityHandle, ResolutionState>();\n    const resolving = new Set<EntityHandle>();\n    resolveEntity = (entity: EntityHandle): ResolutionState | undefined => {\n      const existing = resolved.get(entity);\n      if (existing !== undefined) return existing;\n      if (resolving.has(entity)) return undefined;\n\n      const intent = intentByEntity.get(entity) ?? 'inherited';\n      resolving.add(entity);\n\n      let result: ResolutionState;\n      if (intent === 'hidden') {\n        result = { intent, effective: 'hidden', source: 'self' };\n      } else if (intent === 'visible') {\n        result = { intent, effective: 'visible', source: 'self' };\n      } else {\n        const parent = hierarchy.getParent(entity);\n        const parentResult = parent === undefined ? undefined : resolveEntity?.(parent);\n        result =\n          parentResult === undefined\n            ? { intent, effective: 'visible', source: 'default' }\n            : { intent, effective: parentResult.effective, source: 'parent' };\n      }\n\n      resolving.delete(entity);\n      resolved.set(entity, result);\n      return result;\n    };\n  };\n\n  return {\n    diagnostics: hierarchy.diagnostics,\n    hasAnyIntent: intentCount > 0,\n    hasAnyHiddenIntent,\n    get(entity: EntityHandle): VisibilityResolution | undefined {\n      ensureResolver();\n      return hasIntent?.(entity) ? resolveEntity?.(entity) : undefined;\n    },\n    effective(entity: EntityHandle): 'hidden' | 'visible' {\n      ensureResolver();\n      return resolveEntity?.(entity)?.effective ?? 'visible';\n    },\n  };\n}\n"]}

package/dist/components/__tests__/points-lines-admission.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=points-lines-admission.unit.test.d.ts.map

package/dist/components/__tests__/points-lines-admission.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"points-lines-admission.unit.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/points-lines-admission.unit.test.ts"],"names":[],"mappings":""}

package/dist/components/__tests__/points-lines-schema.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=points-lines-schema.unit.test.d.ts.map

package/dist/components/__tests__/points-lines-schema.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"points-lines-schema.unit.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/points-lines-schema.unit.test.ts"],"names":[],"mappings":""}

package/dist/components/__tests__/schema-contract.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-contract.unit.test.d.ts.map

package/dist/components/__tests__/schema-contract.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-contract.unit.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/schema-contract.unit.test.ts"],"names":[],"mappings":""}

package/dist/components/glyph-text.d.ts

@@ -10,7 +10,7 @@
  *
  * @example Spawn a world-space label:
  *   import { GlyphText } from '@forgeax/engine-render/authoring';
- *   const font = (await assets.load(fontGuid, fontAssetKind)).unwrap();
+ *   const font = (await assets.loadByGuid(fontGuid)).unwrap();
  *   world.spawn({
  *     component: GlyphText,
  *     data: { fontHandle: font, text: 'Hello', fontSize: 32,

package/dist/components/glyph-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glyph-text.d.ts","sourceRoot":"","sources":["../../src/components/glyph-text.ts"],"names":[],"mappings":"AA+BA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS;;;;;EAYpB,CAAC"}
+{"version":3,"file":"glyph-text.d.ts","sourceRoot":"","sources":["../../src/components/glyph-text.ts"],"names":[],"mappings":"AA+BA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS;;;;;EAapB,CAAC"}