@vulfram/engine 0.14.8-alpha → 0.19.2-alpha

package/src/types/cmds/camera.ts

@@ -15,6 +15,7 @@ export interface ViewPosition {
 
 /** Command payload for creating a camera. */
 export interface CmdCameraCreateArgs {
+  realmId: number;
   cameraId: number;
   label?: string;
   transform: number[]; // Mat4 (16 elements)
@@ -27,14 +28,9 @@ export interface CmdCameraCreateArgs {
   orthoScale: number;
 }
 
-/** Result payload for camera create. */
-export interface CmdResultCameraCreate {
-  success: boolean;
-  message: string;
-}
-
 /** Command payload for updating a camera. */
 export interface CmdCameraUpdateArgs {
+  realmId: number;
   cameraId: number;
   label?: string;
   transform?: number[];
@@ -47,14 +43,22 @@ export interface CmdCameraUpdateArgs {
   orthoScale?: number;
 }
 
-/** Result payload for camera update. */
-export interface CmdResultCameraUpdate {
+/** Result payload for camera upsert. */
+export interface CmdResultCameraUpsert {
   success: boolean;
   message: string;
 }
 
+/** Upsert payload accepted by the core (`create` or `update`). */
+export type CmdCameraUpsertArgs = CmdCameraCreateArgs | CmdCameraUpdateArgs;
+
+/** Backward-compatible aliases. */
+export type CmdResultCameraCreate = CmdResultCameraUpsert;
+export type CmdResultCameraUpdate = CmdResultCameraUpsert;
+
 /** Command payload for disposing a camera. */
 export interface CmdCameraDisposeArgs {
+  realmId: number;
   cameraId: number;
 }
 

package/src/types/cmds/environment.ts

@@ -55,24 +55,30 @@ export interface PostProcessConfig {
 export interface EnvironmentConfig {
   msaa: MsaaConfig;
   skybox: SkyboxConfig;
+  clearColor: [number, number, number, number];
   post: PostProcessConfig;
 }
 
 /** Command payload for creating environment settings. */
 export interface CmdEnvironmentCreateArgs {
-  windowId: number;
+  environmentId: number;
   config: EnvironmentConfig;
 }
 
 /** Command payload for updating environment settings. */
 export interface CmdEnvironmentUpdateArgs {
-  windowId: number;
+  environmentId: number;
   config: EnvironmentConfig;
 }
 
+/** Upsert payload accepted by the core (`create` or `update`). */
+export type CmdEnvironmentUpsertArgs =
+  | CmdEnvironmentCreateArgs
+  | CmdEnvironmentUpdateArgs;
+
 /** Command payload for disposing environment settings. */
 export interface CmdEnvironmentDisposeArgs {
-  windowId: number;
+  environmentId: number;
 }
 
 /** Result payload for environment commands. */

package/src/types/cmds/geometry.ts

@@ -8,7 +8,7 @@ export type GeometryPrimitiveType =
   | 'normal'
   | 'tangent'
   | 'color'
-  | 'uv'
+  | 'u-v'
   | 'skin-joints'
   | 'skin-weights';
 
@@ -19,7 +19,7 @@ export const GeometryPrimitiveType = {
   Normal: 'normal' as const,
   Tangent: 'tangent' as const,
   Color: 'color' as const,
-  UV: 'uv' as const,
+  UV: 'u-v' as const,
   SkinJoints: 'skin-joints' as const,
   SkinWeights: 'skin-weights' as const,
 };
@@ -32,35 +32,35 @@ export interface GeometryPrimitiveEntry {
 
 /** Command payload for creating geometry from buffers. */
 export interface CmdGeometryCreateArgs {
-  windowId: number;
   geometryId: number;
   label?: string;
   entries: GeometryPrimitiveEntry[];
 }
 
-/** Result payload for geometry create. */
-export interface CmdResultGeometryCreate {
-  success: boolean;
-  message: string;
-}
-
 /** Command payload for updating geometry buffers or label. */
 export interface CmdGeometryUpdateArgs {
-  windowId: number;
   geometryId: number;
   label?: string;
-  entries: GeometryPrimitiveEntry[];
+  entries?: GeometryPrimitiveEntry[];
 }
 
-/** Result payload for geometry update. */
-export interface CmdResultGeometryUpdate {
+/** Result payload for geometry upsert. */
+export interface CmdResultGeometryUpsert {
   success: boolean;
   message: string;
 }
 
+/** Upsert payload accepted by the core (`create` or `update`). */
+export type CmdGeometryUpsertArgs =
+  | CmdGeometryCreateArgs
+  | CmdGeometryUpdateArgs;
+
+/** Backward-compatible aliases. */
+export type CmdResultGeometryCreate = CmdResultGeometryUpsert;
+export type CmdResultGeometryUpdate = CmdResultGeometryUpsert;
+
 /** Command payload for disposing geometry. */
 export interface CmdGeometryDisposeArgs {
-  windowId: number;
   geometryId: number;
 }
 
@@ -121,11 +121,10 @@ export type PrimitiveOptions =
 
 /** Command payload for creating a primitive geometry. */
 export interface CmdPrimitiveGeometryCreateArgs {
-  windowId: number;
   geometryId: number;
   label?: string;
   shape: PrimitiveShape;
-  options: PrimitiveOptions;
+  options?: PrimitiveOptions;
 }
 
 /** Result payload for primitive geometry create. */

package/src/types/cmds/index.ts

@@ -1,108 +1,84 @@
-import * as Sys from './system';
-import * as Win from './window';
+import * as Audio from './audio';
 import * as Cam from './camera';
-import * as Mod from './model';
+import * as Env from './environment';
+import * as Geo from './geometry';
+import * as Giz from './gizmo';
+import * as Input from './input';
 import * as Lite from './light';
 import * as Mat from './material';
+import * as Mod from './model';
+import * as Realm from './realm';
+import * as Sys from './system';
+import * as Target from './target';
 import * as Tex from './texture';
-import * as Geo from './geometry';
-import * as Shad from './shadow';
-import * as Giz from './gizmo';
-import * as Env from './environment';
-import * as Audio from './audio';
-import * as RenderGraph from './render-graph';
+import * as Ui from './ui';
+import * as Win from './window';
 
-export * from './system';
-export * from './window';
+export * from './audio';
 export * from './camera';
-export * from './model';
-export * from './light';
-export * from './material';
-export * from './texture';
+export * from './environment';
 export * from './geometry';
-export * from './shadow';
 export * from './gizmo';
-export * from './environment';
-export * from './audio';
+export * from './input';
+export * from './light';
+export * from './material';
+export * from './model';
+export * from './realm';
 export * from './render-graph';
 export * from './resources';
+export * from './shadow';
+export * from './system';
+export * from './target';
+export * from './texture';
+export * from './ui';
+export * from './window';
 
-/** Discriminated union of all core commands. */
+/**
+ * Discriminated union of all commands accepted by core.
+ *
+ * Routing convention:
+ * - world-scoped commands are dispatched through the world command queue
+ * - global commands are dispatched through the global command queue
+ */
 export type EngineCmd =
   | { type: 'cmd-notification-send'; content: Sys.CmdNotificationSendArgs }
   | {
-      type: 'cmd-upload-buffer-discard-all';
-      content: Sys.CmdUploadBufferDiscardAllArgs;
+      type: 'cmd-system-diagnostics-set';
+      content: Sys.CmdSystemDiagnosticsSetArgs;
     }
-  | { type: 'cmd-window-create'; content: Win.CmdWindowCreateArgs }
-  | { type: 'cmd-window-close'; content: Win.CmdWindowCloseArgs }
-  | { type: 'cmd-window-set-title'; content: Win.CmdWindowSetTitleArgs }
-  | { type: 'cmd-window-set-position'; content: Win.CmdWindowSetPositionArgs }
-  | { type: 'cmd-window-get-position'; content: Win.CmdWindowGetPositionArgs }
-  | { type: 'cmd-window-set-size'; content: Win.CmdWindowSetSizeArgs }
-  | { type: 'cmd-window-get-size'; content: Win.CmdWindowGetSizeArgs }
   | {
-      type: 'cmd-window-get-outer-size';
-      content: Win.CmdWindowGetOuterSizeArgs;
+      type: 'cmd-system-build-version-get';
+      content: Sys.CmdSystemBuildVersionGetArgs;
     }
+  | { type: 'cmd-window-create'; content: Win.CmdWindowCreateArgs }
+  | { type: 'cmd-window-close'; content: Win.CmdWindowCloseArgs }
+  | { type: 'cmd-window-measurement'; content: Win.CmdWindowMeasurementArgs }
+  | { type: 'cmd-window-cursor'; content: Win.CmdWindowCursorArgs }
+  | { type: 'cmd-window-state'; content: Win.CmdWindowStateArgs }
   | {
-      type: 'cmd-window-get-surface-size';
-      content: Win.CmdWindowGetSurfaceSizeArgs;
-    }
-  | { type: 'cmd-window-set-state'; content: Win.CmdWindowSetStateArgs }
-  | { type: 'cmd-window-get-state'; content: Win.CmdWindowGetStateArgs }
-  | { type: 'cmd-window-set-icon'; content: Win.CmdWindowSetIconArgs }
-  | {
-      type: 'cmd-window-set-decorations';
-      content: Win.CmdWindowSetDecorationsArgs;
-    }
-  | {
-      type: 'cmd-window-has-decorations';
-      content: Win.CmdWindowHasDecorationsArgs;
-    }
-  | { type: 'cmd-window-set-resizable'; content: Win.CmdWindowSetResizableArgs }
-  | { type: 'cmd-window-is-resizable'; content: Win.CmdWindowIsResizableArgs }
-  | {
-      type: 'cmd-window-request-attention';
-      content: Win.CmdWindowRequestAttentionArgs;
+      type: 'cmd-input-target-listener-upsert';
+      content: Input.CmdInputTargetListenerUpsertArgs;
     }
-  | { type: 'cmd-window-focus'; content: Win.CmdWindowFocusArgs }
   | {
-      type: 'cmd-window-set-cursor-visible';
-      content: Win.CmdWindowSetCursorVisibleArgs;
+      type: 'cmd-input-target-listener-dispose';
+      content: Input.CmdInputTargetListenerDisposeArgs;
     }
   | {
-      type: 'cmd-window-set-cursor-grab';
-      content: Win.CmdWindowSetCursorGrabArgs;
+      type: 'cmd-input-target-listener-list';
+      content: Input.CmdInputTargetListenerListArgs;
     }
   | {
-      type: 'cmd-window-set-cursor-icon';
-      content: Win.CmdWindowSetCursorIconArgs;
+      type: 'cmd-upload-buffer-discard-all';
+      content: Sys.CmdUploadBufferDiscardAllArgs;
     }
-  | { type: 'cmd-camera-create'; content: Cam.CmdCameraCreateArgs }
-  | { type: 'cmd-camera-update'; content: Cam.CmdCameraUpdateArgs }
+  | { type: 'cmd-camera-upsert'; content: Cam.CmdCameraUpsertArgs }
   | { type: 'cmd-camera-dispose'; content: Cam.CmdCameraDisposeArgs }
+  | { type: 'cmd-model-upsert'; content: Mod.CmdModelUpsertArgs }
   | { type: 'cmd-pose-update'; content: Mod.CmdPoseUpdateArgs }
-  | { type: 'cmd-audio-listener-update'; content: Audio.CmdAudioListenerUpdateArgs }
-  | { type: 'cmd-audio-listener-create'; content: Audio.CmdAudioListenerCreateArgs }
-  | { type: 'cmd-audio-listener-dispose'; content: Audio.CmdAudioListenerDisposeArgs }
-  | { type: 'cmd-audio-resource-create'; content: Audio.CmdAudioResourceCreateArgs }
-  | { type: 'cmd-audio-resource-push'; content: Audio.CmdAudioResourcePushArgs }
-  | { type: 'cmd-audio-resource-dispose'; content: Audio.CmdAudioResourceDisposeArgs }
-  | { type: 'cmd-audio-source-create'; content: Audio.CmdAudioSourceCreateArgs }
-  | { type: 'cmd-audio-source-update'; content: Audio.CmdAudioSourceUpdateArgs }
-  | { type: 'cmd-audio-source-play'; content: Audio.CmdAudioSourcePlayArgs }
-  | { type: 'cmd-audio-source-pause'; content: Audio.CmdAudioSourcePauseArgs }
-  | { type: 'cmd-audio-source-stop'; content: Audio.CmdAudioSourceStopArgs }
-  | { type: 'cmd-audio-source-dispose'; content: Audio.CmdAudioSourceDisposeArgs }
-  | { type: 'cmd-model-create'; content: Mod.CmdModelCreateArgs }
-  | { type: 'cmd-model-update'; content: Mod.CmdModelUpdateArgs }
   | { type: 'cmd-model-dispose'; content: Mod.CmdModelDisposeArgs }
-  | { type: 'cmd-light-create'; content: Lite.CmdLightCreateArgs }
-  | { type: 'cmd-light-update'; content: Lite.CmdLightUpdateArgs }
+  | { type: 'cmd-light-upsert'; content: Lite.CmdLightUpsertArgs }
   | { type: 'cmd-light-dispose'; content: Lite.CmdLightDisposeArgs }
-  | { type: 'cmd-material-create'; content: Mat.CmdMaterialCreateArgs }
-  | { type: 'cmd-material-update'; content: Mat.CmdMaterialUpdateArgs }
+  | { type: 'cmd-material-upsert'; content: Mat.CmdMaterialUpsertArgs }
   | { type: 'cmd-material-dispose'; content: Mat.CmdMaterialDisposeArgs }
   | {
       type: 'cmd-texture-create-from-buffer';
@@ -113,18 +89,91 @@ export type EngineCmd =
       content: Tex.CmdTextureCreateSolidColorArgs;
     }
   | { type: 'cmd-texture-dispose'; content: Tex.CmdTextureDisposeArgs }
-  | { type: 'cmd-geometry-create'; content: Geo.CmdGeometryCreateArgs }
-  | { type: 'cmd-geometry-update'; content: Geo.CmdGeometryUpdateArgs }
+  | { type: 'cmd-texture-bind-target'; content: Tex.CmdTextureBindTargetArgs }
+  | {
+      type: 'cmd-audio-listener-upsert';
+      content: Audio.CmdAudioListenerUpsertArgs;
+    }
+  | {
+      type: 'cmd-audio-listener-dispose';
+      content: Audio.CmdAudioListenerDisposeArgs;
+    }
+  | {
+      type: 'cmd-audio-source-upsert';
+      content: Audio.CmdAudioSourceUpsertArgs;
+    }
+  | {
+      type: 'cmd-audio-resource-upsert';
+      content: Audio.CmdAudioResourceUpsertArgs;
+    }
+  | {
+      type: 'cmd-audio-source-transport';
+      content: Audio.CmdAudioSourceTransportArgs;
+    }
+  | { type: 'cmd-audio-state-get'; content: Audio.CmdAudioStateGetArgs }
+  | {
+      type: 'cmd-audio-source-dispose';
+      content: Audio.CmdAudioSourceDisposeArgs;
+    }
+  | {
+      type: 'cmd-audio-resource-dispose';
+      content: Audio.CmdAudioResourceDisposeArgs;
+    }
+  | { type: 'cmd-geometry-upsert'; content: Geo.CmdGeometryUpsertArgs }
   | { type: 'cmd-geometry-dispose'; content: Geo.CmdGeometryDisposeArgs }
   | {
       type: 'cmd-primitive-geometry-create';
       content: Geo.CmdPrimitiveGeometryCreateArgs;
     }
-  | { type: 'cmd-environment-create'; content: Env.CmdEnvironmentCreateArgs }
-  | { type: 'cmd-environment-update'; content: Env.CmdEnvironmentUpdateArgs }
-  | { type: 'cmd-environment-dispose'; content: Env.CmdEnvironmentDisposeArgs }
-  | { type: 'cmd-shadow-configure'; content: Shad.CmdShadowConfigureArgs }
-  | { type: 'cmd-render-graph-set'; content: RenderGraph.CmdRenderGraphSetArgs }
+  | { type: 'cmd-environment-upsert'; content: Env.CmdEnvironmentUpsertArgs }
+  | {
+      type: 'cmd-environment-dispose';
+      content: Env.CmdEnvironmentDisposeArgs;
+    }
+  | { type: 'cmd-shadow-configure'; content: import('./shadow').CmdShadowConfigureArgs }
+  | { type: 'cmd-realm-create'; content: Realm.CmdRealmCreateArgs }
+  | { type: 'cmd-realm-dispose'; content: Realm.CmdRealmDisposeArgs }
+  | { type: 'cmd-target-upsert'; content: Target.CmdTargetUpsertArgs }
+  | {
+      type: 'cmd-target-measurement';
+      content: Target.CmdTargetMeasurementArgs;
+    }
+  | { type: 'cmd-target-dispose'; content: Target.CmdTargetDisposeArgs }
+  | {
+      type: 'cmd-target-layer-upsert';
+      content: Target.CmdTargetLayerUpsertArgs;
+    }
+  | {
+      type: 'cmd-target-layer-dispose';
+      content: Target.CmdTargetLayerDisposeArgs;
+    }
+  | { type: 'cmd-ui-theme-define'; content: Ui.CmdUiThemeDefineArgs }
+  | { type: 'cmd-ui-theme-dispose'; content: Ui.CmdUiThemeDisposeArgs }
+  | { type: 'cmd-ui-document-create'; content: Ui.CmdUiDocumentCreateArgs }
+  | { type: 'cmd-ui-document-dispose'; content: Ui.CmdUiDocumentDisposeArgs }
+  | { type: 'cmd-ui-document-set-rect'; content: Ui.CmdUiDocumentSetRectArgs }
+  | { type: 'cmd-ui-document-set-theme'; content: Ui.CmdUiDocumentSetThemeArgs }
+  | { type: 'cmd-ui-document-get-tree'; content: Ui.CmdUiDocumentGetTreeArgs }
+  | {
+      type: 'cmd-ui-document-get-layout-rects';
+      content: Ui.CmdUiDocumentGetLayoutRectsArgs;
+    }
+  | { type: 'cmd-ui-apply-ops'; content: Ui.CmdUiApplyOpsArgs }
+  | { type: 'cmd-ui-debug-set'; content: Ui.CmdUiDebugSetArgs }
+  | { type: 'cmd-ui-focus-set'; content: Ui.CmdUiFocusSetArgs }
+  | { type: 'cmd-ui-focus-get'; content: Ui.CmdUiFocusGetArgs }
+  | { type: 'cmd-ui-event-trace-set'; content: Ui.CmdUiEventTraceSetArgs }
+  | {
+      type: 'cmd-ui-image-create-from-buffer';
+      content: Ui.CmdUiImageCreateFromBufferArgs;
+    }
+  | { type: 'cmd-ui-image-dispose'; content: Ui.CmdUiImageDisposeArgs }
+  | { type: 'cmd-ui-clipboard-paste'; content: Ui.CmdUiClipboardPasteArgs }
+  | { type: 'cmd-ui-screenshot-reply'; content: Ui.CmdUiScreenshotReplyArgs }
+  | {
+      type: 'cmd-ui-access-kit-action-request';
+      content: Ui.CmdUiAccessKitActionRequestArgs;
+    }
   | { type: 'cmd-model-list'; content: Mod.CmdModelListArgs }
   | { type: 'cmd-material-list'; content: Mat.CmdMaterialListArgs }
   | { type: 'cmd-texture-list'; content: Tex.CmdTextureListArgs }
@@ -134,79 +183,46 @@ export type EngineCmd =
   | { type: 'cmd-gizmo-draw-line'; content: Giz.CmdGizmoDrawLineArgs }
   | { type: 'cmd-gizmo-draw-aabb'; content: Giz.CmdGizmoDrawAabbArgs };
 
-/** Discriminated union of all core command responses. */
+/** Discriminated union of all command responses returned by core. */
 export type CommandResponse =
   | { type: 'notification-send'; content: Sys.CmdResultNotificationSend }
   | {
-      type: 'upload-buffer-discard-all';
-      content: Sys.CmdResultUploadBufferDiscardAll;
-    }
-  | { type: 'window-create'; content: Win.CmdResultWindowCreate }
-  | { type: 'window-close'; content: Win.CmdResultWindowClose }
-  | { type: 'window-set-title'; content: Win.CmdResultWindowSetTitle }
-  | { type: 'window-set-position'; content: Win.CmdResultWindowSetPosition }
-  | { type: 'window-get-position'; content: Win.CmdResultWindowGetPosition }
-  | { type: 'window-set-size'; content: Win.CmdResultWindowSetSize }
-  | { type: 'window-get-size'; content: Win.CmdResultWindowGetSize }
-  | { type: 'window-get-outer-size'; content: Win.CmdResultWindowGetOuterSize }
-  | {
-      type: 'window-get-surface-size';
-      content: Win.CmdResultWindowGetSurfaceSize;
+      type: 'system-diagnostics-set';
+      content: Sys.CmdResultSystemDiagnosticsSet;
     }
-  | { type: 'window-set-state'; content: Win.CmdResultWindowSetState }
-  | { type: 'window-get-state'; content: Win.CmdResultWindowGetState }
-  | { type: 'window-set-icon'; content: Win.CmdResultWindowSetIcon }
   | {
-      type: 'window-set-decorations';
-      content: Win.CmdResultWindowSetDecorations;
+      type: 'system-build-version-get';
+      content: Sys.CmdResultSystemBuildVersionGet;
     }
+  | { type: 'window-create'; content: Win.CmdResultWindowCreate }
+  | { type: 'window-close'; content: Win.CmdResultWindowClose }
+  | { type: 'window-measurement'; content: Win.CmdResultWindowMeasurement }
+  | { type: 'window-cursor'; content: Win.CmdResultWindowCursor }
+  | { type: 'window-state'; content: Win.CmdResultWindowState }
   | {
-      type: 'window-has-decorations';
-      content: Win.CmdResultWindowHasDecorations;
-    }
-  | { type: 'window-set-resizable'; content: Win.CmdResultWindowSetResizable }
-  | { type: 'window-is-resizable'; content: Win.CmdResultWindowIsResizable }
-  | {
-      type: 'window-request-attention';
-      content: Win.CmdResultWindowRequestAttention;
+      type: 'input-target-listener-upsert';
+      content: Input.CmdResultInputTargetListenerUpsert;
     }
-  | { type: 'window-focus'; content: Win.CmdResultWindowFocus }
   | {
-      type: 'window-set-cursor-visible';
-      content: Win.CmdResultWindowSetCursorVisible;
+      type: 'input-target-listener-dispose';
+      content: Input.CmdResultInputTargetListenerDispose;
     }
   | {
-      type: 'window-set-cursor-grab';
-      content: Win.CmdResultWindowSetCursorGrab;
+      type: 'input-target-listener-list';
+      content: Input.CmdResultInputTargetListenerList;
     }
   | {
-      type: 'window-set-cursor-icon';
-      content: Win.CmdResultWindowSetCursorIcon;
+      type: 'upload-buffer-discard-all';
+      content: Sys.CmdResultUploadBufferDiscardAll;
     }
-  | { type: 'camera-create'; content: Cam.CmdResultCameraCreate }
-  | { type: 'camera-update'; content: Cam.CmdResultCameraUpdate }
+  | { type: 'camera-upsert'; content: Cam.CmdResultCameraUpsert }
   | { type: 'camera-dispose'; content: Cam.CmdResultCameraDispose }
+  | { type: 'model-upsert'; content: Mod.CmdResultModelUpsert }
   | { type: 'pose-update'; content: Mod.CmdResultPoseUpdate }
-  | { type: 'audio-listener-update'; content: Audio.CmdResultAudioListenerUpdate }
-  | { type: 'audio-listener-create'; content: Audio.CmdResultAudioListenerCreate }
-  | { type: 'audio-listener-dispose'; content: Audio.CmdResultAudioListenerDispose }
-  | { type: 'audio-resource-create'; content: Audio.CmdResultAudioResourceCreate }
-  | { type: 'audio-resource-push'; content: Audio.CmdResultAudioResourcePush }
-  | { type: 'audio-resource-dispose'; content: Audio.CmdResultAudioResourceDispose }
-  | { type: 'audio-source-create'; content: Audio.CmdResultAudioSourceCreate }
-  | { type: 'audio-source-update'; content: Audio.CmdResultAudioSourceUpdate }
-  | { type: 'audio-source-play'; content: Audio.CmdResultAudioSourcePlay }
-  | { type: 'audio-source-pause'; content: Audio.CmdResultAudioSourcePause }
-  | { type: 'audio-source-stop'; content: Audio.CmdResultAudioSourceStop }
-  | { type: 'audio-source-dispose'; content: Audio.CmdResultAudioSourceDispose }
-  | { type: 'model-create'; content: Mod.CmdResultModelCreate }
-  | { type: 'model-update'; content: Mod.CmdResultModelUpdate }
   | { type: 'model-dispose'; content: Mod.CmdResultModelDispose }
-  | { type: 'light-create'; content: Lite.CmdResultLightCreate }
-  | { type: 'light-update'; content: Lite.CmdResultLightUpdate }
+  | { type: 'light-upsert'; content: Lite.CmdResultLightUpsert }
   | { type: 'light-dispose'; content: Lite.CmdResultLightDispose }
-  | { type: 'material-create'; content: Mat.CmdResultMaterialCreate }
-  | { type: 'material-update'; content: Mat.CmdResultMaterialUpdate }
+  | { type: 'material-upsert'; content: Mat.CmdResultMaterialUpsert }
   | { type: 'material-dispose'; content: Mat.CmdResultMaterialDispose }
   | {
       type: 'texture-create-from-buffer';
@@ -217,18 +233,88 @@ export type CommandResponse =
       content: Tex.CmdResultTextureCreateSolidColor;
     }
   | { type: 'texture-dispose'; content: Tex.CmdResultTextureDispose }
-  | { type: 'geometry-create'; content: Geo.CmdResultGeometryCreate }
-  | { type: 'geometry-update'; content: Geo.CmdResultGeometryUpdate }
+  | { type: 'texture-bind-target'; content: Tex.CmdResultTextureBindTarget }
+  | {
+      type: 'audio-listener-upsert';
+      content: Audio.CmdResultAudioListenerUpsert;
+    }
+  | {
+      type: 'audio-listener-dispose';
+      content: Audio.CmdResultAudioListenerDispose;
+    }
+  | {
+      type: 'audio-source-upsert';
+      content: Audio.CmdResultAudioSourceUpsert;
+    }
+  | {
+      type: 'audio-resource-upsert';
+      content: Audio.CmdResultAudioResourceUpsert;
+    }
+  | {
+      type: 'audio-source-transport';
+      content: Audio.CmdResultAudioSourceTransport;
+    }
+  | { type: 'audio-state-get'; content: Audio.CmdResultAudioStateGet }
+  | {
+      type: 'audio-source-dispose';
+      content: Audio.CmdResultAudioSourceDispose;
+    }
+  | {
+      type: 'audio-resource-dispose';
+      content: Audio.CmdResultAudioResourceDispose;
+    }
+  | { type: 'geometry-upsert'; content: Geo.CmdResultGeometryUpsert }
   | { type: 'geometry-dispose'; content: Geo.CmdResultGeometryDispose }
   | {
       type: 'primitive-geometry-create';
       content: Geo.CmdResultPrimitiveGeometryCreate;
     }
-  | { type: 'environment-create'; content: Env.CmdResultEnvironment }
-  | { type: 'environment-update'; content: Env.CmdResultEnvironment }
+  | { type: 'environment-upsert'; content: Env.CmdResultEnvironment }
   | { type: 'environment-dispose'; content: Env.CmdResultEnvironment }
-  | { type: 'shadow-configure'; content: Shad.CmdResultShadowConfigure }
-  | { type: 'render-graph-set'; content: RenderGraph.CmdResultRenderGraphSet }
+  | {
+      type: 'shadow-configure';
+      content: import('./shadow').CmdResultShadowConfigure;
+    }
+  | { type: 'realm-create'; content: Realm.CmdResultRealmCreate }
+  | { type: 'realm-dispose'; content: Realm.CmdResultRealmDispose }
+  | { type: 'target-upsert'; content: Target.CmdResultTargetUpsert }
+  | {
+      type: 'target-measurement';
+      content: Target.CmdResultTargetMeasurement;
+    }
+  | { type: 'target-dispose'; content: Target.CmdResultTargetDispose }
+  | {
+      type: 'target-layer-upsert';
+      content: Target.CmdResultTargetLayerUpsert;
+    }
+  | {
+      type: 'target-layer-dispose';
+      content: Target.CmdResultTargetLayerDispose;
+    }
+  | { type: 'ui-theme-define'; content: Ui.CmdResultUiThemeDefine }
+  | { type: 'ui-theme-dispose'; content: Ui.CmdResultUiThemeDispose }
+  | { type: 'ui-document-create'; content: Ui.CmdResultUiDocumentCreate }
+  | { type: 'ui-document-dispose'; content: Ui.CmdResultUiDocumentDispose }
+  | { type: 'ui-document-set-rect'; content: Ui.CmdResultUiDocumentSetRect }
+  | { type: 'ui-document-set-theme'; content: Ui.CmdResultUiDocumentSetTheme }
+  | { type: 'ui-document-get-tree'; content: Ui.CmdResultUiDocumentGetTree }
+  | {
+      type: 'ui-document-get-layout-rects';
+      content: Ui.CmdResultUiDocumentGetLayoutRects;
+    }
+  | { type: 'ui-apply-ops'; content: Ui.CmdResultUiApplyOps }
+  | { type: 'ui-debug-set'; content: Ui.CmdResultUiDebugSet }
+  | { type: 'ui-focus-set'; content: Ui.CmdResultUiFocusSet }
+  | { type: 'ui-focus-get'; content: Ui.CmdResultUiFocusGet }
+  | { type: 'ui-event-trace-set'; content: Ui.CmdResultUiEventTraceSet }
+  | {
+      type: 'ui-image-create-from-buffer';
+      content: Ui.CmdResultUiImageCreateFromBuffer;
+    }
+  | { type: 'ui-image-dispose'; content: Ui.CmdResultUiImageDispose }
+  | { type: 'ui-clipboard-paste'; content: Ui.CmdResultUiInputEvent }
+  | { type: 'ui-screenshot-reply'; content: Ui.CmdResultUiInputEvent }
+  | { type: 'ui-access-kit-action-request'; content: Ui.CmdResultUiInputEvent }
   | { type: 'model-list'; content: Mod.CmdResultModelList }
   | { type: 'material-list'; content: Mat.CmdResultMaterialList }
   | { type: 'texture-list'; content: Tex.CmdResultTextureList }
@@ -238,35 +324,21 @@ export type CommandResponse =
   | { type: 'gizmo-draw-line'; content: Giz.CmdResultGizmoDraw }
   | { type: 'gizmo-draw-aabb'; content: Giz.CmdResultGizmoDraw };
 
-/** Envelope used when batching commands to the core. */
+/** Command envelope used in batched transport payloads. */
 export interface EngineCmdEnvelope {
   id: number;
   type: EngineCmd['type'];
   content: EngineCmd['content'];
 }
 
-/** Envelope used when decoding responses from the core. */
+/** Response envelope returned by queue polling and routed by command id. */
 export interface CommandResponseEnvelope {
   id: number;
   type: CommandResponse['type'];
   content: CommandResponse['content'];
 }
 
-/** Batch of commands sent in a single tick. */
+/** Batched commands payload sent to transport. */
 export type EngineBatchCmds = EngineCmdEnvelope[];
-
-/** Batch of responses received from the core. */
+/** Batched responses payload decoded from transport. */
 export type EngineBatchResponses = CommandResponseEnvelope[];
-
-/** Result codes returned by core entrypoints. */
-export enum VulframResult {
-  Success = 0,
-  UnknownError = 1,
-  NotInitialized = 2,
-  AlreadyInitialized = 3,
-  WrongThread = 4,
-  CmdInvalidMessagePackError = 5,
-  BufferNotFound = 6,
-  BufferIdCollision = 7,
-  InvalidUploadType = 8,
-}