pelican-engine 0.3.17 → 0.3.19

package/docs/api/index.json

@@ -1,14 +1,14 @@
 {
   "format": "pelican.api-index",
   "version": 1,
-  "engineVersion": "0.3.17",
+  "engineVersion": "0.3.19",
   "entry": "pelican-engine",
   "source": "packages/sdk/src/index.ts",
   "symbols": [
     {
       "name": "SDK_VERSION",
       "kind": "constant",
-      "signature": "SDK_VERSION = \"0.3.17\"",
+      "signature": "SDK_VERSION = \"0.3.19\"",
       "line": 2
     },
     {
@@ -171,7 +171,7 @@
     {
       "name": "SystemContext",
       "kind": "InterfaceDeclaration",
-      "signature": "export interface SystemContext extends EngineFacade {\n  readonly time: {\n    readonly tick: number;\n    readonly elapsed: number;\n    readonly fixedDt: number;\n  };\n  readonly entities: EntityCommands;\n  random(): number;\n  emit(type: string, payload: unknown): void;\n  events(type?: string): readonly GameEvent[];\n  readonly input: InputService;\n  readonly physics: PhysicsService;\n  readonly animation: AnimationService;\n  readonly camera: CameraService;\n  readonly ui: UIService;\n  readonly audio: AudioService;\n  readonly storage: StorageService;\n  readonly scenes: SceneService;\n  readonly render: RenderService;\n  readonly compute: ComputeService;\n  readonly navigation: NavigationService;\n  readonly ropes: RopeService;\n}",
+      "signature": "export interface SystemContext extends EngineFacade {\n  readonly time: {\n    readonly tick: number;\n    readonly elapsed: number;\n    readonly fixedDt: number;\n  };\n  readonly entities: EntityCommands;\n  random(): number;\n  emit(type: string, payload: unknown): void;\n  events(type?: string): readonly GameEvent[];\n  readonly input: InputService;\n  readonly physics: PhysicsService;\n  readonly animation: AnimationService;\n  readonly camera: CameraService;\n  readonly ui: UIService;\n  readonly audio: AudioService;\n  readonly storage: StorageService;\n  readonly scenes: SceneService;\n  readonly render: RenderService;\n  readonly compute: ComputeService;\n  readonly navigation: NavigationService;\n  readonly ropes: RopeService;\n  readonly cloth: ClothService;\n}",
       "line": 98,
       "fields": [
         "time",
@@ -190,20 +190,21 @@
         "render",
         "compute",
         "navigation",
-        "ropes"
+        "ropes",
+        "cloth"
       ]
     },
     {
       "name": "RopeCollider",
       "kind": "TypeAliasDeclaration",
       "signature": "export type RopeCollider =\n  | { kind: \"sphere\"; id: string; center: Vec3; radius: number }\n  | { kind: \"plane\"; id: string; normal: Vec3; offset: number };",
-      "line": 123
+      "line": 124
     },
     {
       "name": "RopeBodyCollider",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeBodyCollider { readonly id: string; readonly entity: string }",
-      "line": 127,
+      "line": 128,
       "fields": [
         "id",
         "entity"
@@ -213,7 +214,7 @@
       "name": "RopeVisualOptions",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeVisualOptions {\n  material: string;\n  radius?: number;\n  radialSegments?: number;\n  castShadow?: boolean;\n  receiveShadow?: boolean;\n}",
-      "line": 129,
+      "line": 130,
       "fields": [
         "material",
         "radius",
@@ -226,7 +227,7 @@
       "name": "RopeVisualState",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeVisualState {\n  id: string;\n  material: string;\n  radius: number;\n  radialSegments: number;\n  castShadow: boolean;\n  receiveShadow: boolean;\n  positions: Vec3[];\n}",
-      "line": 137,
+      "line": 138,
       "fields": [
         "id",
         "material",
@@ -241,7 +242,7 @@
       "name": "RopeDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeDefinition {\n  id: string;\n  points: readonly Vec3[];\n  /** Kilograms per particle, positive and at most 1e6. */\n  mass: number;\n  radius?: number;\n  /** Defaults to the host interval; an explicit value must exactly match it. */\n  fixedDt?: number;\n  /** When true, step once after each physics phase; defaults to false (manual stepping). */\n  autoStep?: boolean;\n  /** Automatically sample and react to existing dynamic, non-trigger sphere bodies. Requires autoStep. */\n  bodyColliders?: readonly RopeBodyCollider[];\n  /** Resolve sphere contacts on segment interiors; defaults to true for new ropes. */\n  segmentCollisions?: boolean;\n  /** Resolve discrete non-adjacent segment self contacts; defaults to true for new ropes. */\n  selfCollisions?: boolean;\n  /** Optional segmented presentation using an already-declared material id. */\n  visual?: RopeVisualOptions;\n  substeps?: number;\n  iterations?: number;\n  damping?: number;\n  gravity?: Vec3;\n  anchors?: readonly { index: number; position: Vec3 }[];\n}",
-      "line": 146,
+      "line": 147,
       "fields": [
         "id",
         "points",
@@ -264,7 +265,7 @@
       "name": "RopeContact",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeContact {\n  tick: number; particle: number; colliderId: string; penetration: number;\n  /** Opposite of particle contact impulses, N·s; absent in older snapshots. */\n  reactionImpulse?: Vec3;\n  /** Angular impulse about the world origin; absent in older snapshots. */\n  reactionAngularImpulse?: Vec3;\n}",
-      "line": 171,
+      "line": 172,
       "fields": [
         "tick",
         "particle",
@@ -278,7 +279,7 @@
       "name": "RopeSegmentContact",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeSegmentContact {\n  tick: number;\n  /** Zero-based index of the first endpoint; the second is segment + 1. */\n  segment: number;\n  colliderId: string;\n  /** Last closest-point fraction from the first endpoint toward the second. */\n  fraction: number;\n  penetration: number;\n  reactionImpulse?: Vec3;\n  reactionAngularImpulse?: Vec3;\n}",
-      "line": 179,
+      "line": 180,
       "fields": [
         "tick",
         "segment",
@@ -293,7 +294,7 @@
       "name": "RopeSelfContact",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeSelfContact {\n  tick: number;\n  /** Zero-based first endpoint of each non-adjacent segment, ordered ascending. */\n  firstSegment: number; secondSegment: number;\n  /** Last closest-point fractions along the respective segments. */\n  firstFraction: number; secondFraction: number;\n  /** Maximum observed overlap in metres during this tick. */\n  penetration: number;\n}",
-      "line": 191,
+      "line": 192,
       "fields": [
         "tick",
         "firstSegment",
@@ -307,7 +308,7 @@
       "name": "RopeState",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeState {\n  tick: number; simulatedSeconds: number; disposed: boolean;\n  segmentCollisions: boolean;\n  selfCollisions: boolean;\n  positions: Vec3[]; velocities: Vec3[];\n  anchors: { index: number; position: Vec3 }[];\n  contacts: RopeContact[];\n  segmentContacts: RopeSegmentContact[];\n  selfContacts: RopeSelfContact[];\n  maxDistanceError: number;\n  resources: { particles: number; constraints: number; anchors: number; colliders: number };\n}",
-      "line": 200,
+      "line": 201,
       "fields": [
         "tick",
         "simulatedSeconds",
@@ -328,7 +329,131 @@
       "name": "RopeService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RopeService {\n  create(definition: RopeDefinition): void;\n  /** Explicit ticks for manual ropes only. Auto-stepped ropes reject this call. A failed batch leaves the rope unchanged. */\n  step(id: string, ticks?: number): RopeState;\n  inspect(id: string): RopeState;\n  /** Detached visual descriptions, sorted by rope id; empty when no visuals are requested. */\n  visuals(): readonly RopeVisualState[];\n  setColliders(id: string, colliders: readonly RopeCollider[]): void;\n  setAnchor(id: string, index: number, position: Vec3): void;\n  releaseAnchor(id: string, index: number): void;\n  applyForce(id: string, index: number, force: Vec3): void;\n  applyImpulse(id: string, index: number, impulse: Vec3): void;\n  destroy(id: string): void;\n}",
-      "line": 212,
+      "line": 213,
+      "fields": [
+        "create",
+        "step",
+        "inspect",
+        "visuals",
+        "setColliders",
+        "setAnchor",
+        "releaseAnchor",
+        "applyForce",
+        "applyImpulse",
+        "destroy"
+      ]
+    },
+    {
+      "name": "ClothCollider",
+      "kind": "TypeAliasDeclaration",
+      "signature": "export type ClothCollider = RopeCollider;",
+      "line": 228
+    },
+    {
+      "name": "ClothTriangle",
+      "kind": "TypeAliasDeclaration",
+      "signature": "export type ClothTriangle = readonly [number, number, number];",
+      "line": 229
+    },
+    {
+      "name": "ClothVisualOptions",
+      "kind": "InterfaceDeclaration",
+      "signature": "export interface ClothVisualOptions {\n  material: string;\n  /** Optional per-particle UV coordinates; defaults to a planar projection. */\n  uvs?: readonly Vec2[];\n  castShadow?: boolean;\n  receiveShadow?: boolean;\n}",
+      "line": 230,
+      "fields": [
+        "material",
+        "uvs",
+        "castShadow",
+        "receiveShadow"
+      ]
+    },
+    {
+      "name": "ClothDefinition",
+      "kind": "InterfaceDeclaration",
+      "signature": "export interface ClothDefinition {\n  id: string;\n  points: readonly Vec3[];\n  triangles: readonly ClothTriangle[];\n  /** Kilograms per movable particle. */\n  mass: number;\n  radius?: number;\n  fixedDt?: number;\n  autoStep?: boolean;\n  substeps?: number;\n  iterations?: number;\n  damping?: number;\n  gravity?: Vec3;\n  /** Distance-based bending approximation across shared triangle edges; defaults to true. */\n  bending?: boolean;\n  anchors?: readonly { index: number; position: Vec3 }[];\n  visual?: ClothVisualOptions;\n  /** Discrete non-adjacent particle self-contact; defaults to true for new cloth. */\n  selfCollisions?: boolean;\n}",
+      "line": 237,
+      "fields": [
+        "id",
+        "points",
+        "triangles",
+        "mass",
+        "radius",
+        "fixedDt",
+        "autoStep",
+        "substeps",
+        "iterations",
+        "damping",
+        "gravity",
+        "bending",
+        "anchors",
+        "visual",
+        "selfCollisions"
+      ]
+    },
+    {
+      "name": "ClothContact",
+      "kind": "InterfaceDeclaration",
+      "signature": "export interface ClothContact { tick: number; particle: number; colliderId: string; penetration: number }",
+      "line": 257,
+      "fields": [
+        "tick",
+        "particle",
+        "colliderId",
+        "penetration"
+      ]
+    },
+    {
+      "name": "ClothSelfContact",
+      "kind": "InterfaceDeclaration",
+      "signature": "export interface ClothSelfContact { tick: number; firstParticle: number; secondParticle: number; penetration: number }",
+      "line": 258,
+      "fields": [
+        "tick",
+        "firstParticle",
+        "secondParticle",
+        "penetration"
+      ]
+    },
+    {
+      "name": "ClothState",
+      "kind": "InterfaceDeclaration",
+      "signature": "export interface ClothState {\n  tick: number; simulatedSeconds: number; disposed: boolean; selfCollisions: boolean;\n  positions: Vec3[]; velocities: Vec3[]; triangles: ClothTriangle[];\n  anchors: { index: number; position: Vec3 }[];\n  contacts: ClothContact[]; selfContacts: ClothSelfContact[];\n  maxDistanceError: number;\n  resources: { particles: number; triangles: number; constraints: number; anchors: number; colliders: number };\n}",
+      "line": 259,
+      "fields": [
+        "tick",
+        "simulatedSeconds",
+        "disposed",
+        "selfCollisions",
+        "positions",
+        "velocities",
+        "triangles",
+        "anchors",
+        "contacts",
+        "selfContacts",
+        "maxDistanceError",
+        "resources"
+      ]
+    },
+    {
+      "name": "ClothVisualState",
+      "kind": "InterfaceDeclaration",
+      "signature": "export interface ClothVisualState {\n  id: string; material: string; positions: Vec3[]; triangles: ClothTriangle[];\n  uvs: Vec2[]; castShadow: boolean; receiveShadow: boolean;\n}",
+      "line": 267,
+      "fields": [
+        "id",
+        "material",
+        "positions",
+        "triangles",
+        "uvs",
+        "castShadow",
+        "receiveShadow"
+      ]
+    },
+    {
+      "name": "ClothService",
+      "kind": "InterfaceDeclaration",
+      "signature": "export interface ClothService {\n  create(definition: ClothDefinition): void;\n  /** Explicit ticks for manual cloth only; automatic cloth rejects this call. */\n  step(id: string, ticks?: number): ClothState;\n  inspect(id: string): ClothState;\n  visuals(): readonly ClothVisualState[];\n  setColliders(id: string, colliders: readonly ClothCollider[]): void;\n  setAnchor(id: string, index: number, position: Vec3): void;\n  releaseAnchor(id: string, index: number): void;\n  applyForce(id: string, index: number, force: Vec3): void;\n  applyImpulse(id: string, index: number, impulse: Vec3): void;\n  destroy(id: string): void;\n}",
+      "line": 271,
       "fields": [
         "create",
         "step",
@@ -346,7 +471,7 @@
       "name": "NavigationCell",
       "kind": "InterfaceDeclaration",
       "signature": "export interface NavigationCell { readonly x: number; readonly y: number }",
-      "line": 229,
+      "line": 287,
       "fields": [
         "x",
         "y"
@@ -356,7 +481,7 @@
       "name": "NavigationObstacleUpdate",
       "kind": "InterfaceDeclaration",
       "signature": "export interface NavigationObstacleUpdate { readonly cell: NavigationCell; readonly blocked: boolean }",
-      "line": 231,
+      "line": 289,
       "fields": [
         "cell",
         "blocked"
@@ -366,7 +491,7 @@
       "name": "NavigationGrid",
       "kind": "InterfaceDeclaration",
       "signature": "export interface NavigationGrid {\n  readonly id: string;\n  readonly owner: string;\n  readonly width: number;\n  readonly height: number;\n  readonly blocked?: readonly NavigationCell[];\n  /** Maximum distinct search cells, including endpoints; defaults to 65536. Raising it increases memory and CPU use. */\n  readonly searchCellBudget?: number;\n}",
-      "line": 232,
+      "line": 290,
       "fields": [
         "id",
         "owner",
@@ -380,7 +505,7 @@
       "name": "NavigationService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface NavigationService {\n  createGrid(grid: NavigationGrid): void;\n  /** Returns a detached description, including the current blocked cells. */\n  getGrid(id: string): NavigationGrid;\n  isBlocked(id: string, cell: NavigationCell): boolean;\n  setBlocked(id: string, cell: NavigationCell, blocked: boolean): void;\n  /** Validates the entire batch before committing; the last change for a repeated cell wins. */\n  setBlockedBatch(id: string, updates: readonly NavigationObstacleUpdate[]): void;\n  findPath(id: string, start: NavigationCell, end: NavigationCell): readonly NavigationCell[];\n  destroyGrid(id: string): void;\n  destroyOwner(owner: string): void;\n}",
-      "line": 241,
+      "line": 299,
       "fields": [
         "createGrid",
         "getGrid",
@@ -396,13 +521,13 @@
       "name": "RenderMode",
       "kind": "TypeAliasDeclaration",
       "signature": "export type RenderMode = \"raster\" | \"hybrid\" | \"path\";",
-      "line": 253
+      "line": 311
     },
     {
       "name": "RenderCapabilities",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RenderCapabilities {\n  backend: \"webgpu\" | \"webgl2\" | \"uninitialized\";\n  compute: boolean;\n  availableModes: readonly RenderMode[];\n}",
-      "line": 254,
+      "line": 312,
       "fields": [
         "backend",
         "compute",
@@ -413,7 +538,7 @@
       "name": "RenderSettings",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RenderSettings {\n  mode: RenderMode;\n  samplesPerFrame: number;\n  maxBounces: number;\n  denoise: boolean;\n  denoiseIterations: number;\n  exposure: number;\n  directLighting: boolean;\n  indirectLighting: boolean;\n  debug: \"beauty\" | \"albedo\" | \"normal\" | \"depth\" | \"samples\";\n}",
-      "line": 259,
+      "line": 317,
       "fields": [
         "mode",
         "samplesPerFrame",
@@ -430,7 +555,7 @@
       "name": "RenderService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RenderService {\n  configure(settings: Partial<RenderSettings>): void;\n  state(): Readonly<RenderSettings>;\n  capabilities(): Readonly<RenderCapabilities>;\n  setMaterialParameter(material: string, name: string, value: GraphValue): void;\n  materialParameters(material: string): Readonly<Record<string, GraphValue>>;\n  readonly effects: PostProcessService;\n  readonly buffers: RenderBufferBindings;\n  readonly textures: RenderTextureBindings;\n}",
-      "line": 270,
+      "line": 328,
       "fields": [
         "configure",
         "state",
@@ -446,7 +571,7 @@
       "name": "MaterialBufferInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface MaterialBufferInput {\n  /** Shared slot declaration for material and postprocess graphs. */\n  name: string;\n  type: GraphType;\n  /** Optional initial logical compute-buffer ID. */\n  buffer?: string;\n  /** Optional exact element count required by this slot. */\n  count?: number;\n}",
-      "line": 280,
+      "line": 338,
       "fields": [
         "name",
         "type",
@@ -458,7 +583,7 @@
       "name": "RenderBufferReference",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RenderBufferReference {\n  id: string;\n  type: GraphType;\n  count: number;\n}",
-      "line": 289,
+      "line": 347,
       "fields": [
         "id",
         "type",
@@ -469,7 +594,7 @@
       "name": "RenderBufferBindings",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RenderBufferBindings {\n  bind(target: string, name: string, buffer: ComputeBufferHandle): void;\n  unbind(target: string, name: string): void;\n  state(target: string): Readonly<Record<string, RenderBufferReference>>;\n}",
-      "line": 294,
+      "line": 352,
       "fields": [
         "bind",
         "unbind",
@@ -480,7 +605,7 @@
       "name": "MaterialTextureInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface MaterialTextureInput extends ComputeTextureBinding {\n  /** Initial managed texture ID; asset import uses computeTextures/createTexture. */\n  texture?: string;\n  width?: number;\n  height?: number;\n}",
-      "line": 299,
+      "line": 357,
       "fields": [
         "texture",
         "width",
@@ -491,7 +616,7 @@
       "name": "RenderTextureReference",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RenderTextureReference extends ComputeTextureSize {\n  id: string;\n  format: \"rgba32float\";\n}",
-      "line": 305,
+      "line": 363,
       "fields": [
         "id",
         "format"
@@ -501,7 +626,7 @@
       "name": "RenderTextureBindings",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RenderTextureBindings {\n  bind(target: string, name: string, texture: ComputeTextureHandle): void;\n  unbind(target: string, name: string): void;\n  state(target: string): Readonly<Record<string, RenderTextureReference>>;\n}",
-      "line": 309,
+      "line": 367,
       "fields": [
         "bind",
         "unbind",
@@ -512,7 +637,7 @@
       "name": "PostProcessState",
       "kind": "InterfaceDeclaration",
       "signature": "export interface PostProcessState {\n  id: string;\n  enabled: boolean;\n  parameters: Readonly<Record<string, GraphValue>>;\n}",
-      "line": 314,
+      "line": 372,
       "fields": [
         "id",
         "enabled",
@@ -523,7 +648,7 @@
       "name": "PostProcessService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface PostProcessService {\n  /** Compute-buffer slots declared by definePostProcess, addressed by pass ID. */\n  readonly buffers: RenderBufferBindings;\n  readonly textures: RenderTextureBindings;\n  configure(id: string, settings: { enabled: boolean }): void;\n  state(id: string): Readonly<PostProcessState>;\n  setParameter(id: string, name: string, value: GraphValue): void;\n  /** Clears temporal effect images; it does not modify game or trace accumulation state. */\n  resetHistory(id?: string): void;\n}",
-      "line": 319,
+      "line": 377,
       "fields": [
         "buffers",
         "textures",
@@ -537,7 +662,7 @@
       "name": "ComputeBufferHandle",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeBufferHandle {\n  readonly owner: number;\n  readonly index: number;\n  readonly generation: number;\n}",
-      "line": 329,
+      "line": 387,
       "fields": [
         "owner",
         "index",
@@ -548,7 +673,7 @@
       "name": "ComputeTaskHandle",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeTaskHandle {\n  readonly owner: number;\n  readonly id: number;\n}",
-      "line": 334,
+      "line": 392,
       "fields": [
         "owner",
         "id"
@@ -558,7 +683,7 @@
       "name": "ComputeBufferInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeBufferInput {\n  id: string;\n  type: GraphType;\n  count: number;\n  data?: readonly GraphValue[];\n}",
-      "line": 338,
+      "line": 396,
       "fields": [
         "id",
         "type",
@@ -570,7 +695,7 @@
       "name": "ComputeTextureHandle",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeTextureHandle {\n  readonly owner: number;\n  readonly index: number;\n  readonly generation: number;\n  readonly kind: \"texture\";\n}",
-      "line": 344,
+      "line": 402,
       "fields": [
         "owner",
         "index",
@@ -582,7 +707,7 @@
       "name": "ComputeTextureSize",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeTextureSize {\n  width: number;\n  height: number;\n}",
-      "line": 350,
+      "line": 408,
       "fields": [
         "width",
         "height"
@@ -592,7 +717,7 @@
       "name": "ComputeTextureDataInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeTextureDataInput extends ComputeTextureSize {\n  id: string;\n  /** Linear rgba32float texels in row-major order, without color-space conversion. */\n  data?: readonly Vec4[];\n  asset?: never;\n}",
-      "line": 354,
+      "line": 412,
       "fields": [
         "id",
         "data",
@@ -603,7 +728,7 @@
       "name": "ComputeTextureAssetInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeTextureAssetInput {\n  id: string;\n  asset: AssetDefinition | string;\n  width?: never;\n  height?: never;\n  data?: never;\n}",
-      "line": 360,
+      "line": 418,
       "fields": [
         "id",
         "asset",
@@ -616,13 +741,13 @@
       "name": "ComputeTextureInput",
       "kind": "TypeAliasDeclaration",
       "signature": "export type ComputeTextureInput = ComputeTextureDataInput | ComputeTextureAssetInput;",
-      "line": 367
+      "line": 425
     },
     {
       "name": "ComputeTextureBinding",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeTextureBinding {\n  name: string;\n  filter?: \"nearest\" | \"linear\";\n  wrapU?: \"clamp\" | \"repeat\" | \"mirror\";\n  wrapV?: \"clamp\" | \"repeat\" | \"mirror\";\n}",
-      "line": 368,
+      "line": 426,
       "fields": [
         "name",
         "filter",
@@ -634,7 +759,7 @@
       "name": "ComputeDispatchInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeDispatchInput {\n  output: ComputeBufferHandle | ComputeTextureHandle;\n  /** Handles capture dispatch-time data; task bindings consume that exact successful output revision. */\n  bindings?: Readonly<Record<string, ComputeBufferHandle | { task: ComputeTaskHandle }>>;\n  /** Named sampled rgba32float textures; task bindings capture that exact texture result. */\n  textures?: Readonly<Record<string, ComputeTextureHandle | { task: ComputeTaskHandle }>>;\n  /** Ordering only. It never silently refreshes ordinary handle bindings. */\n  after?: readonly ComputeTaskHandle[];\n  parameters?: Readonly<Record<string, GraphValue>>;\n  /** Fixed simulation time by default, not wall-clock time. */\n  time?: number;\n}",
-      "line": 374,
+      "line": 432,
       "fields": [
         "output",
         "bindings",
@@ -648,7 +773,7 @@
       "name": "ComputeTaskState",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeTaskState {\n  status: \"queued\" | \"running\" | \"succeeded\" | \"failed\" | \"cancelled\";\n  error?: { code: string; message: string; remediation: string };\n}",
-      "line": 386,
+      "line": 444,
       "fields": [
         "status",
         "error"
@@ -658,7 +783,7 @@
       "name": "ComputeService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeService {\n  createTexture(input: ComputeTextureInput): ComputeTextureHandle;\n  resolveTexture(id: string): ComputeTextureHandle;\n  describeTexture(texture: ComputeTextureHandle): Readonly<ComputeTextureSize & { id: string; format: \"rgba32float\"; revision: number }>;\n  readTexture(texture: ComputeTextureHandle): readonly Vec4[];\n  writeTexture(texture: ComputeTextureHandle, data: readonly Vec4[], region?: ComputeTextureSize & { x: number; y: number }): void;\n  releaseTexture(texture: ComputeTextureHandle): void;\n  createBuffer(input: ComputeBufferInput): ComputeBufferHandle;\n  resolve(id: string): ComputeBufferHandle;\n  describeBuffer(buffer: ComputeBufferHandle): Readonly<{ id: string; type: GraphType; count: number; revision: number }>;\n  /** Last committed GPU result; detached CPU data, never a GPU object. */\n  readBuffer(buffer: ComputeBufferHandle): readonly GraphValue[];\n  writeBuffer(buffer: ComputeBufferHandle, values: readonly GraphValue[], offset?: number): void;\n  releaseBuffer(buffer: ComputeBufferHandle): void;\n  dispatch(kernel: ComputeDefinition | string, input: ComputeDispatchInput): ComputeTaskHandle;\n  task(task: ComputeTaskHandle): Readonly<ComputeTaskState>;\n  tasks(): readonly { handle: ComputeTaskHandle; state: ComputeTaskState }[];\n  cancel(task: ComputeTaskHandle): void;\n  releaseTask(task: ComputeTaskHandle): void;\n}",
-      "line": 390,
+      "line": 448,
       "fields": [
         "createTexture",
         "resolveTexture",
@@ -683,7 +808,7 @@
       "name": "InputService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface InputService {\n  held(action: string): boolean;\n  pressed(action: string): boolean;\n  released(action: string): boolean;\n  axis(negative: string, positive: string): number;\n}",
-      "line": 410,
+      "line": 468,
       "fields": [
         "held",
         "pressed",
@@ -695,7 +820,7 @@
       "name": "PhysicsService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface PhysicsService {\n  moveCharacter(entity: string, displacement: Vec3): void;\n  grounded(entity: string): boolean;\n  velocity(entity: string): Vec3;\n  /** World-space rigid-body center of mass, including collider offsets. */\n  centerOfMass(entity: string): Vec3;\n  setVelocity(entity: string, velocity: Vec3): void;\n  impulse(entity: string, impulse: Vec3): void;\n  /** Angular velocity in world-space radians per second. */\n  angularVelocity(entity: string): Vec3;\n  setAngularVelocity(entity: string, velocity: Vec3): void;\n  /** Instantaneous world-space angular impulse, in angular-momentum units. */\n  torqueImpulse(entity: string, impulse: Vec3): void;\n  /** Apply world-space impulse at a world-space point, changing linear and angular motion. */\n  impulseAtPoint(entity: string, impulse: Vec3, point: Vec3): void;\n  raycast(\n    origin: Vec3,\n    direction: Vec3,\n    maxDistance: number,\n    options?: { exclude?: readonly string[]; includeTriggers?: boolean },\n  ): { entity: string; distance: number; point: Vec3; normal: Vec3 } | null;\n}",
-      "line": 416,
+      "line": 474,
       "fields": [
         "moveCharacter",
         "grounded",
@@ -714,7 +839,7 @@
       "name": "AnimationService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface AnimationService {\n  play(\n    entity: string,\n    clip: string,\n    options?: { fade?: number; speed?: number; loop?: boolean },\n  ): void;\n  state(entity: string): {\n    clip: string | null;\n    time: number;\n    playing: boolean;\n  };\n}",
-      "line": 438,
+      "line": 496,
       "fields": [
         "play",
         "state"
@@ -724,7 +849,7 @@
       "name": "CameraService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface CameraService {\n  follow(\n    entity: string,\n    options?: {\n      distance?: number;\n      height?: number;\n      lookHeight?: number;\n      yaw?: number;\n      smoothing?: number;\n    },\n  ): void;\n  orbit(yaw: number): void;\n}",
-      "line": 450,
+      "line": 508,
       "fields": [
         "follow",
         "orbit"
@@ -734,7 +859,7 @@
       "name": "UIService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface UIService {\n  setText(id: string, text: string): void;\n  setProgress(id: string, value: number): void;\n  setVisible(id: string, visible: boolean): void;\n}",
-      "line": 463,
+      "line": 521,
       "fields": [
         "setText",
         "setProgress",
@@ -745,7 +870,7 @@
       "name": "AudioService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface AudioService {\n  play(\n    id: string,\n    options?: { volume?: number; loop?: boolean; entity?: string; bus?: string; priority?: number },\n  ): string;\n  stop(voice: string): void;\n  /** Pause/resume are idempotent; an unknown valid voice id is a no-op. Playback time follows fixed simulation ticks, even while audio is locked. */\n  pause(voice: string): void;\n  resume(voice: string): void;\n  volume(value: number): void;\n  /** Set a declared bus gain, independently of master and voice gain. */\n  busVolume(id: string, value: number): void;\n  /** Fade a declared bus over fixed-tick seconds; busVolume or another fade replaces it. */\n  fadeBus(id: string, target: number, duration: number): void;\n}",
-      "line": 468,
+      "line": 526,
       "fields": [
         "play",
         "stop",
@@ -760,7 +885,7 @@
       "name": "StorageService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface StorageService {\n  save(slot: string): void;\n  load(slot: string): void;\n  status(): {\n    state: \"idle\" | \"saving\" | \"loading\" | \"saved\" | \"loaded\" | \"failed\";\n    slot: string | null;\n    error: string | null;\n  };\n}",
-      "line": 483,
+      "line": 541,
       "fields": [
         "save",
         "load",
@@ -771,7 +896,7 @@
       "name": "SceneService",
       "kind": "InterfaceDeclaration",
       "signature": "export interface SceneService {\n  current(): string;\n  load(id: string): void;\n}",
-      "line": 492,
+      "line": 550,
       "fields": [
         "current",
         "load"
@@ -781,7 +906,7 @@
       "name": "ModelDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ModelDefinition {\n  /** Optional whole-model material override; omitted keeps the asset's original materials. */\n  material?: MaterialDefinition | string;\n  /** Replace all asset material slots with the given exact material name. Mutually exclusive with material. */\n  materialSlots?: Record<string, MaterialDefinition | string>;\n  castShadow?: boolean;\n  receiveShadow?: boolean;\n  asset: AssetDefinition | string;\n  scale?: number;\n  offset?: Vec3;\n  rotation?: Vec3;\n  animation?: { clip: string; speed?: number; loop?: boolean };\n}",
-      "line": 496,
+      "line": 554,
       "fields": [
         "material",
         "materialSlots",
@@ -798,7 +923,7 @@
       "name": "RigidBodyDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface RigidBodyDefinition {\n  type: \"fixed\" | \"dynamic\" | \"kinematic\";\n  collider: {\n    shape: \"box\" | \"sphere\" | \"capsule\";\n    size?: Vec3;\n    radius?: number;\n    halfHeight?: number;\n    offset?: Vec3;\n  };\n  mass?: number;\n  friction?: number;\n  restitution?: number;\n  trigger?: boolean;\n}",
-      "line": 509,
+      "line": 567,
       "fields": [
         "type",
         "collider",
@@ -812,7 +937,7 @@
       "name": "CharacterDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface CharacterDefinition {\n  radius: number;\n  height: number;\n  speed: number;\n  jumpSpeed?: number;\n  /** Downward acceleration magnitude in world units/s^2; defaults to 9.81. Scene.gravity is a signed vector. */\n  gravity?: number;\n}",
-      "line": 523,
+      "line": 581,
       "fields": [
         "radius",
         "height",
@@ -825,7 +950,7 @@
       "name": "UIElementDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface UIElementDefinition {\n  id: string;\n  kind: \"text\" | \"bar\" | \"button\" | \"input\";\n  text?: string;\n  value?: number;\n  visible?: boolean;\n  anchor?: \"top-left\" | \"top-right\" | \"bottom-left\" | \"bottom-right\" | \"center\";\n  x?: number;\n  y?: number;\n  width?: number;\n  color?: string;\n  world?: { entity: string; offset?: Vec3; occlude?: boolean };\n}",
-      "line": 531,
+      "line": 589,
       "fields": [
         "id",
         "kind",
@@ -844,7 +969,7 @@
       "name": "SoundDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface SoundDefinition {\n  id: string;\n  asset: AssetDefinition | string;\n  volume?: number;\n  loop?: boolean;\n  bus?: string;\n}",
-      "line": 544,
+      "line": 602,
       "fields": [
         "id",
         "asset",
@@ -857,7 +982,7 @@
       "name": "AudioBusDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface AudioBusDefinition {\n  id: string;\n  volume?: number;\n}",
-      "line": 551,
+      "line": 609,
       "fields": [
         "id",
         "volume"
@@ -867,43 +992,43 @@
       "name": "SYSTEM_PHASES",
       "kind": "constant",
       "signature": "SYSTEM_PHASES = [\n  \"input\",\n  \"prePhysics\",\n  \"physics\",\n  \"postPhysics\",\n  \"update\",\n  \"presentation\",\n] as const",
-      "line": 555
+      "line": 613
     },
     {
       "name": "SystemPhase",
       "kind": "TypeAliasDeclaration",
       "signature": "export type SystemPhase = (typeof SYSTEM_PHASES)[number];",
-      "line": 563
+      "line": 621
     },
     {
       "name": "Geometry",
       "kind": "TypeAliasDeclaration",
       "signature": "export type Geometry =\n  | { kind: \"box\"; size?: Vec3 }\n  | { kind: \"sphere\"; radius?: number; segments?: number }\n  | { kind: \"plane\"; size?: readonly [number, number] };",
-      "line": 564
+      "line": 622
     },
     {
       "name": "GRAPH_TYPES",
       "kind": "constant",
       "signature": "GRAPH_TYPES = [\"float\", \"vec2\", \"vec3\", \"vec4\", \"bool\"] as const",
-      "line": 568
+      "line": 626
     },
     {
       "name": "GraphType",
       "kind": "TypeAliasDeclaration",
       "signature": "export type GraphType = typeof GRAPH_TYPES[number];",
-      "line": 569
+      "line": 627
     },
     {
       "name": "GraphValue",
       "kind": "TypeAliasDeclaration",
       "signature": "export type GraphValue = number | boolean | Vec2 | Vec3 | Vec4;",
-      "line": 570
+      "line": 628
     },
     {
       "name": "GraphParameter",
       "kind": "InterfaceDeclaration",
       "signature": "export interface GraphParameter {\n  name: string;\n  type: GraphType;\n  default: GraphValue;\n}",
-      "line": 571,
+      "line": 629,
       "fields": [
         "name",
         "type",
@@ -914,31 +1039,31 @@
       "name": "GRAPH_INPUT_TYPES",
       "kind": "constant",
       "signature": "GRAPH_INPUT_TYPES = {\n  uv: \"vec2\", uv1: \"vec2\", positionWorld: \"vec3\", normalWorld: \"vec3\",\n  viewDirectionWorld: \"vec3\", vertexColor: \"vec4\", index: \"float\",\n  screenSize: \"vec2\", texelSize: \"vec2\",\n  pixelCoord: \"vec2\", outputSize: \"vec2\",\n  positionLocal: \"vec3\", normalLocal: \"vec3\", vertexIndex: \"float\", instanceIndex: \"float\",\n} as const",
-      "line": 576
+      "line": 634
     },
     {
       "name": "GraphInputName",
       "kind": "TypeAliasDeclaration",
       "signature": "export type GraphInputName = keyof typeof GRAPH_INPUT_TYPES;",
-      "line": 583
+      "line": 641
     },
     {
       "name": "GRAPH_OPERATIONS",
       "kind": "constant",
       "signature": "GRAPH_OPERATIONS = {\n  unary: [\"sin\", \"cos\", \"abs\", \"floor\", \"ceil\", \"fract\", \"negate\", \"saturate\", \"normalize\", \"length\", \"safeSqrt\"] as const,\n  binary: [\"add\", \"subtract\", \"multiply\", \"safeDivide\", \"min\", \"max\", \"dot\", \"cross\", \"step\", \"lessThan\", \"lessEqual\", \"greaterThan\", \"greaterEqual\", \"equal\", \"and\", \"or\"] as const,\n  ternary: [\"mix\", \"clamp\", \"smoothstep\", \"select\"] as const,\n} as const",
-      "line": 584
+      "line": 642
     },
     {
       "name": "GraphNode",
       "kind": "TypeAliasDeclaration",
       "signature": "export type GraphNode =\n  | { id: string; op: \"float\"; value: number }\n  | { id: string; op: \"bool\"; value: boolean }\n  | { id: string; op: \"vec2\"; value: Vec2 }\n  | { id: string; op: \"vec3\"; value: Vec3 }\n  | { id: string; op: \"vec4\"; value: Vec4 }\n  | { id: string; op: \"time\" }\n  | { id: string; op: \"input\"; name: GraphInputName }\n  | { id: string; op: \"parameter\"; name: string }\n  | { id: string; op: typeof GRAPH_OPERATIONS.unary[number] | \"not\"; inputs: readonly [string] }\n  | { id: string; op: typeof GRAPH_OPERATIONS.binary[number]; inputs: readonly [string, string] }\n  | { id: string; op: typeof GRAPH_OPERATIONS.ternary[number]; inputs: readonly [string, string, string] }\n  | { id: string; op: \"compose2\"; inputs: readonly [string, string] }\n  | { id: string; op: \"compose3\"; inputs: readonly [string, string, string] }\n  | { id: string; op: \"compose4\"; inputs: readonly [string, string, string, string] }\n  | { id: string; op: \"swizzle\"; inputs: readonly [string]; components: string }\n  | { id: string; op: \"sampleTexture\"; inputs: readonly [string]; texture: AssetDefinition | string }\n  | { id: string; op: \"readBuffer\"; inputs: readonly [string]; buffer: string }\n  | { id: string; op: \"sampleFrame\"; inputs: readonly [string]; channel: string }\n  | { id: string; op: \"sampleHistory\"; inputs: readonly [string]; channel: string };",
-      "line": 589
+      "line": 647
     },
     {
       "name": "Graph",
       "kind": "InterfaceDeclaration",
       "signature": "export interface Graph {\n  nodes: readonly GraphNode[];\n  output: string;\n  parameters?: readonly GraphParameter[];\n}",
-      "line": 609,
+      "line": 667,
       "fields": [
         "nodes",
         "output",
@@ -949,7 +1074,7 @@
       "name": "MaterialGraphs",
       "kind": "InterfaceDeclaration",
       "signature": "export interface MaterialGraphs {\n  baseColor?: Graph;\n  emissive?: Graph;\n  roughness?: Graph;\n  metalness?: Graph;\n  opacity?: Graph;\n  /** Absolute, unsided world-space normal; engine applies material boundary orientation. */\n  normalWorld?: Graph;\n}",
-      "line": 614,
+      "line": 672,
       "fields": [
         "baseColor",
         "emissive",
@@ -963,7 +1088,7 @@
       "name": "VertexGraphs",
       "kind": "InterfaceDeclaration",
       "signature": "export interface VertexGraphs {\n  /** Absolute object-local position after built-in morph, skin and instance transforms. */\n  position?: Graph;\n  /** Unsided object-local normal in the same domain; zero keeps the normalized input normal. */\n  normal?: Graph;\n}",
-      "line": 623,
+      "line": 681,
       "fields": [
         "position",
         "normal"
@@ -973,7 +1098,7 @@
       "name": "MaterialInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface MaterialInput {\n  id: string;\n  color?: string;\n  roughness?: number;\n  metalness?: number;\n  texture?: AssetDefinition | string;\n  graph?: Graph;\n  graphs?: MaterialGraphs;\n  vertex?: VertexGraphs;\n  buffers?: readonly MaterialBufferInput[];\n  textures?: readonly MaterialTextureInput[];\n  emissive?: string;\n  emissiveIntensity?: number;\n  opacity?: number;\n  alphaTest?: number;\n  side?: \"front\" | \"back\" | \"double\";\n  /** Closed-volume dielectric fraction; opacity remains independent stochastic coverage. */\n  transmission?: number;\n  ior?: number;\n  /** Nontransmissive dielectric specular strength in [0,1]. Defaults to 1. */\n  specularIntensity?: number;\n  /** Nontransmissive dielectric specular color, a hex or named sRGB color. Defaults to white. */\n  specularColor?: string;\n  attenuationColor?: string;\n  /** World-space distance for Beer absorption; omitted means no absorption. */\n  attenuationDistance?: number;\n}",
-      "line": 629,
+      "line": 687,
       "fields": [
         "id",
         "color",
@@ -1002,7 +1127,7 @@
       "name": "MaterialDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface MaterialDefinition extends MaterialInput {\n  readonly kind: \"material\";\n}",
-      "line": 656,
+      "line": 714,
       "fields": [
         "kind"
       ]
@@ -1011,7 +1136,7 @@
       "name": "PostProcessInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface PostProcessInput {\n  id: string;\n  buffers?: readonly MaterialBufferInput[];\n  textures?: readonly MaterialTextureInput[];\n  /** Linear HDR vec4 output. Frame channels: scene.color, scene.normal, scene.depth, or an earlier pass ID. */\n  graph: Graph;\n  enabled?: boolean;\n}",
-      "line": 659,
+      "line": 717,
       "fields": [
         "id",
         "buffers",
@@ -1024,7 +1149,7 @@
       "name": "PostProcessDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface PostProcessDefinition extends PostProcessInput {\n  readonly kind: \"postprocess\";\n}",
-      "line": 667,
+      "line": 725,
       "fields": [
         "kind"
       ]
@@ -1033,7 +1158,7 @@
       "name": "ComputeInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeInput {\n  id: string;\n  graph: Graph;\n  outputType: GraphType;\n  count: number;\n  workgroupSize?: number;\n  buffers?: readonly { name: string; type: GraphType }[];\n  textures?: readonly ComputeTextureBinding[];\n}",
-      "line": 670,
+      "line": 728,
       "fields": [
         "id",
         "graph",
@@ -1048,7 +1173,7 @@
       "name": "ComputeDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface ComputeDefinition extends ComputeInput {\n  readonly kind: \"compute\";\n}",
-      "line": 679,
+      "line": 737,
       "fields": [
         "kind"
       ]
@@ -1057,7 +1182,7 @@
       "name": "AssetInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface AssetInput {\n  id: string;\n  path: string;\n  type: \"texture\" | \"binary\" | \"model\" | \"audio\";\n  source?: string;\n  license?: string;\n  attribution?: string;\n  /** Texture imports only; defaults to sRGB color. Data/normal/ORM textures use linear. */\n  colorSpace?: \"srgb\" | \"linear\";\n}",
-      "line": 682,
+      "line": 740,
       "fields": [
         "id",
         "path",
@@ -1072,7 +1197,7 @@
       "name": "AssetDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface AssetDefinition extends AssetInput {\n  readonly kind: \"asset\";\n}",
-      "line": 692,
+      "line": 750,
       "fields": [
         "kind"
       ]
@@ -1081,7 +1206,7 @@
       "name": "MeshDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface MeshDefinition {\n  geometry: Geometry;\n  material: MaterialDefinition | string;\n  castShadow?: boolean;\n  receiveShadow?: boolean;\n}",
-      "line": 695,
+      "line": 753,
       "fields": [
         "geometry",
         "material",
@@ -1093,7 +1218,7 @@
       "name": "LightDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface LightDefinition {\n  kind: \"directional\" | \"point\";\n  color?: string;\n  intensity?: number;\n  castShadow?: boolean;\n  target?: Vec3;\n  shadow?: {\n    mapSize?: number;\n    extent?: number;\n    bias?: number;\n    normalBias?: number;\n    near?: number;\n    far?: number;\n  };\n}",
-      "line": 701,
+      "line": 759,
       "fields": [
         "kind",
         "color",
@@ -1107,7 +1232,7 @@
       "name": "EntityInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface EntityInput {\n  id: string;\n  prefab?: PrefabDefinition | string;\n  parent?: string;\n  transform?: TransformPatch;\n  mesh?: MeshDefinition;\n  light?: LightDefinition;\n  model?: ModelDefinition;\n  rigidBody?: RigidBodyDefinition;\n  character?: CharacterDefinition;\n  components?: readonly ComponentInstance[];\n}",
-      "line": 716,
+      "line": 774,
       "fields": [
         "id",
         "prefab",
@@ -1125,7 +1250,7 @@
       "name": "PrefabInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface PrefabInput extends Omit<EntityInput, \"prefab\" | \"parent\"> {\n  extends?: PrefabDefinition | string;\n}",
-      "line": 728,
+      "line": 786,
       "fields": [
         "extends"
       ]
@@ -1134,7 +1259,7 @@
       "name": "PrefabDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface PrefabDefinition extends PrefabInput {\n  readonly kind: \"prefab\";\n}",
-      "line": 731,
+      "line": 789,
       "fields": [
         "kind"
       ]
@@ -1143,7 +1268,7 @@
       "name": "SceneInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface SceneInput {\n  id: string;\n  camera?: {\n    position: Vec3;\n    target: Vec3;\n    fov?: number;\n    near?: number;\n    far?: number;\n  };\n  environment?: {\n    background?: string;\n    ambientIntensity?: number;\n    lighting?: \"none\" | \"studio\";\n  };\n  follow?: {\n    entity: string;\n    distance?: number;\n    height?: number;\n    lookHeight?: number;\n    yaw?: number;\n    smoothing?: number;\n  };\n  gravity?: Vec3;\n  entities: readonly EntityInput[];\n}",
-      "line": 734,
+      "line": 792,
       "fields": [
         "id",
         "camera",
@@ -1157,7 +1282,7 @@
       "name": "SceneDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface SceneDefinition extends SceneInput {\n  readonly kind: \"scene\";\n}",
-      "line": 759,
+      "line": 817,
       "fields": [
         "kind"
       ]
@@ -1166,7 +1291,7 @@
       "name": "SystemInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface SystemInput {\n  id: string;\n  phase?: SystemPhase;\n  before?: readonly string[];\n  after?: readonly string[];\n  reads?: readonly string[];\n  writes?: readonly string[];\n  structural?: boolean;\n  run: (engine: SystemContext, dt: number) => void;\n}",
-      "line": 762,
+      "line": 820,
       "fields": [
         "id",
         "phase",
@@ -1182,7 +1307,7 @@
       "name": "SystemDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface SystemDefinition extends SystemInput {\n  readonly kind: \"system\";\n}",
-      "line": 772,
+      "line": 830,
       "fields": [
         "kind"
       ]
@@ -1191,7 +1316,7 @@
       "name": "GameInput",
       "kind": "InterfaceDeclaration",
       "signature": "export interface GameInput {\n  id: string;\n  scene: SceneDefinition;\n  systems?: readonly SystemDefinition[];\n  components?: readonly ComponentDefinition[];\n  prefabs?: readonly PrefabDefinition[];\n  materials?: readonly MaterialDefinition[];\n  computes?: readonly ComputeDefinition[];\n  computeBuffers?: readonly ComputeBufferInput[];\n  computeTextures?: readonly ComputeTextureInput[];\n  assets?: readonly AssetDefinition[];\n  scenes?: readonly SceneDefinition[];\n  input?: Readonly<Record<string, readonly string[]>>;\n  ui?: readonly UIElementDefinition[];\n  sounds?: readonly SoundDefinition[];\n  audioBuses?: readonly AudioBusDefinition[];\n  render?: Partial<RenderSettings>;\n  postProcesses?: readonly PostProcessDefinition[];\n}",
-      "line": 775,
+      "line": 833,
       "fields": [
         "id",
         "scene",
@@ -1216,7 +1341,7 @@
       "name": "GameDefinition",
       "kind": "InterfaceDeclaration",
       "signature": "export interface GameDefinition extends GameInput {\n  readonly kind: \"game\";\n}",
-      "line": 794,
+      "line": 852,
       "fields": [
         "kind"
       ]
@@ -1225,7 +1350,7 @@
       "name": "GameInstance",
       "kind": "InterfaceDeclaration",
       "signature": "export interface GameInstance {\n  update(dt: number): void;\n  dispose(): void;\n}",
-      "line": 797,
+      "line": 855,
       "fields": [
         "update",
         "dispose"
@@ -1235,61 +1360,61 @@
       "name": "defineComponent",
       "kind": "FunctionDeclaration",
       "signature": "export function defineComponent<const S extends ComponentSchema>(input: {\n  id: string;\n  schema: S;\n}): ComponentDefinition<S>;",
-      "line": 801
+      "line": 859
     },
     {
       "name": "defineMaterial",
       "kind": "FunctionDeclaration",
       "signature": "export function defineMaterial(input: MaterialInput): MaterialDefinition;",
-      "line": 807
+      "line": 865
     },
     {
       "name": "definePostProcess",
       "kind": "FunctionDeclaration",
       "signature": "export function definePostProcess(input: PostProcessInput): PostProcessDefinition;",
-      "line": 810
+      "line": 868
     },
     {
       "name": "defineCompute",
       "kind": "FunctionDeclaration",
       "signature": "export function defineCompute(input: ComputeInput): ComputeDefinition;",
-      "line": 813
+      "line": 871
     },
     {
       "name": "defineAsset",
       "kind": "FunctionDeclaration",
       "signature": "export function defineAsset(input: AssetInput): AssetDefinition;",
-      "line": 816
+      "line": 874
     },
     {
       "name": "definePrefab",
       "kind": "FunctionDeclaration",
       "signature": "export function definePrefab(input: PrefabInput): PrefabDefinition;",
-      "line": 819
+      "line": 877
     },
     {
       "name": "defineScene",
       "kind": "FunctionDeclaration",
       "signature": "export function defineScene(input: SceneInput): SceneDefinition;",
-      "line": 822
+      "line": 880
     },
     {
       "name": "defineSystem",
       "kind": "FunctionDeclaration",
       "signature": "export function defineSystem(input: SystemInput): SystemDefinition;",
-      "line": 825
+      "line": 883
     },
     {
       "name": "defineGame",
       "kind": "FunctionDeclaration",
       "signature": "export function defineGame(input: GameInput): GameDefinition;",
-      "line": 828
+      "line": 886
     },
     {
       "name": "instantiateGame",
       "kind": "FunctionDeclaration",
       "signature": "export function instantiateGame(\n  game: GameDefinition,\n  engine: EngineFacade,\n): GameInstance;",
-      "line": 832
+      "line": 890
     }
   ],
   "installedDeclarations": "lib/sdk/index.d.ts",