@vulfram/engine 0.5.6-alpha → 0.14.8-alpha

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@vulfram/engine",
-  "version": "0.5.6-alpha",
+  "version": "0.14.8-alpha",
   "module": "src/index.ts",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "type": "module",
   "dependencies": {
-    "@vulfram/transport-types": "^0.2.1",
+    "@vulfram/transport-types": "^0.2.3",
     "gl-matrix": "^3.4.4",
     "glob": "^13.0.0",
     "msgpackr": "^1.11.8"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.6"
+    "@types/bun": "^1.3.8"
   }
 }

package/src/engine/api.ts

@@ -131,15 +131,14 @@ function uploadTypeToId(type: UploadType): number {
 export function uploadBuffer(
   bufferId: number,
   type: UploadType,
-  data: Uint8Array | Buffer,
+  data: Uint8Array,
 ): void {
   requireInitialized();
   const transport = engineState.transport!;
-  const bufferData = data instanceof Uint8Array ? Buffer.from(data) : data;
   const result = transport.vulframUploadBuffer(
     bufferId,
     uploadTypeToId(type),
-    bufferData,
+    data,
   );
   if (result !== 0) {
     throw new EngineError(

package/src/engine/bridge/protocol.ts

@@ -1,4 +1,5 @@
 import { Packr, Unpackr } from 'msgpackr';
+import type { TransportBuffer } from '@vulfram/transport-types';
 import type {
   CommandResponseEnvelope,
   EngineCmdEnvelope,
@@ -47,17 +48,18 @@ const unpackr = new Unpackr({ useRecords: false });
 
 /**
  * Minimal Command Payload Requirement:
- * Commands that interact with the scene or windows MUST include a `windowId`.
- * This allows the Core to route the command to the correct world/surface.
+ * Most scene/window commands include a `windowId` so the Core can route them
+ * to the correct world/surface. Some commands (e.g. camera update or global
+ * maintenance commands) are window-agnostic.
  */
 export interface BaseCommandArgs {
   windowId: number;
 }
 
 /**
- * Serializes a batch of commands into a Buffer ready for vulframSendQueue.
+ * Serializes a batch of commands into a byte buffer ready for vulframSendQueue.
  */
-export function serializeBatch(batch: CoreCommandBatch): Buffer {
+export function serializeBatch(batch: CoreCommandBatch): TransportBuffer {
   if (engineState.flags.debugEnabled) {
     const types = batch.map((cmd) => cmd.type);
     const hasModel =
@@ -115,7 +117,7 @@ export function serializeBatch(batch: CoreCommandBatch): Buffer {
  * Deserializes responses from vulframReceiveQueue.
  */
 export function deserializeResponses(
-  buffer: Buffer,
+  buffer: TransportBuffer,
 ): CommandResponseEnvelope[] {
   if (buffer.length === 0) return [];
   return unpackr.unpack(buffer);
@@ -124,7 +126,7 @@ export function deserializeResponses(
 /**
  * Deserializes events from vulframReceiveEvents.
  */
-export function deserializeEvents(buffer: Buffer): EngineEvent[] {
+export function deserializeEvents(buffer: TransportBuffer): EngineEvent[] {
   if (buffer.length === 0) return [];
   return unpackr.unpack(buffer);
 }

package/src/engine/ecs/index.ts

@@ -114,6 +114,8 @@ export interface ModelProps {
   materialId?: number;
   castShadow?: boolean;
   receiveShadow?: boolean;
+  castOutline?: boolean;
+  outlineColor?: [number, number, number, number];
 }
 
 /**
@@ -356,7 +358,7 @@ export interface WindowProps {
   decorations?: boolean;
   cursorVisible?: boolean;
   cursorGrab?: CursorGrabMode;
-  icon?: string;
+  icon?: number;
   cursorIcon?: CursorIcon;
 }
 

package/src/engine/systems/core-command-builder.ts

@@ -23,6 +23,8 @@ export const CoreCommandBuilderSystem: System = (world, context) => {
       const transform = getEntityTransformMatrix(world, intent.entityId);
       const castShadow = intent.props.castShadow ?? true;
       const receiveShadow = intent.props.receiveShadow ?? true;
+      const castOutline = intent.props.castOutline ?? false;
+      const outlineColor = intent.props.outlineColor ?? ([0, 0, 0, 0] as const);
 
       enqueueCommand(context.worldId, 'cmd-model-create', {
         windowId: context.worldId,
@@ -33,6 +35,8 @@ export const CoreCommandBuilderSystem: System = (world, context) => {
         layerMask: 0x7fffffff,
         castShadow,
         receiveShadow,
+        castOutline,
+        outlineColor: [...outlineColor] as [number, number, number, number],
       });
 
       let store = world.components.get(intent.entityId);
@@ -47,6 +51,8 @@ export const CoreCommandBuilderSystem: System = (world, context) => {
         materialId: intent.props.materialId,
         castShadow: intent.props.castShadow ?? true,
         receiveShadow: intent.props.receiveShadow ?? true,
+        castOutline,
+        outlineColor: [...outlineColor] as [number, number, number, number],
         skipUpdate: true,
       });
 
@@ -56,7 +62,6 @@ export const CoreCommandBuilderSystem: System = (world, context) => {
       const transform = getEntityTransformMatrix(world, intent.entityId);
 
       enqueueCommand(context.worldId, 'cmd-camera-create', {
-        windowId: context.worldId,
         cameraId,
         label: `Cam ${cameraId}`,
         kind: intent.props.kind ?? ('perspective' as CameraKind),
@@ -190,7 +195,6 @@ export const CoreCommandBuilderSystem: System = (world, context) => {
               camera.skipUpdate = false;
             } else {
               enqueueCommand(context.worldId, 'cmd-camera-update', {
-                windowId: context.worldId,
                 cameraId: camera.id,
                 transform: matrixArray,
               });
@@ -227,7 +231,6 @@ export const CoreCommandBuilderSystem: System = (world, context) => {
           } else if (intent.componentType === 'Camera') {
             const cameraComp = comp as CameraComponent;
             enqueueCommand(context.worldId, 'cmd-camera-dispose', {
-              windowId: context.worldId,
               cameraId: cameraComp.id,
             });
           } else if (intent.componentType === 'Light') {

package/src/engine/systems/world-lifecycle.ts

@@ -87,7 +87,7 @@ export const WorldLifecycleSystem: System = (world, context) => {
       if (p.icon !== undefined) {
         enqueueCommand(context.worldId, 'cmd-window-set-icon', {
           windowId: context.worldId,
-          icon: p.icon,
+          bufferId: p.icon,
         });
       }
       if (p.cursorIcon !== undefined) {
@@ -119,9 +119,43 @@ export const WorldLifecycleSystem: System = (world, context) => {
           mode: config.skybox.mode,
           intensity: config.skybox.intensity,
           rotation: config.skybox.rotation,
-          tint: toVec3(config.skybox.tint),
+          groundColor: toVec3(config.skybox.groundColor),
+          horizonColor: toVec3(config.skybox.horizonColor),
+          skyColor: toVec3(config.skybox.skyColor),
           cubemapTextureId: config.skybox.cubemapTextureId ?? null,
         },
+        post: {
+          filterEnabled: config.post.filterEnabled,
+          filterExposure: config.post.filterExposure,
+          filterGamma: config.post.filterGamma,
+          filterSaturation: config.post.filterSaturation,
+          filterContrast: config.post.filterContrast,
+          filterVignette: config.post.filterVignette,
+          filterGrain: config.post.filterGrain,
+          filterChromaticAberration: config.post.filterChromaticAberration,
+          filterBlur: config.post.filterBlur,
+          filterSharpen: config.post.filterSharpen,
+          filterTonemapMode: config.post.filterTonemapMode,
+          outlineEnabled: config.post.outlineEnabled,
+          outlineStrength: config.post.outlineStrength,
+          outlineThreshold: config.post.outlineThreshold,
+          outlineWidth: config.post.outlineWidth,
+          outlineQuality: config.post.outlineQuality,
+          filterPosterizeSteps: config.post.filterPosterizeSteps,
+          cellShading: config.post.cellShading,
+          ssaoEnabled: config.post.ssaoEnabled,
+          ssaoStrength: config.post.ssaoStrength,
+          ssaoRadius: config.post.ssaoRadius,
+          ssaoBias: config.post.ssaoBias,
+          ssaoPower: config.post.ssaoPower,
+          ssaoBlurRadius: config.post.ssaoBlurRadius,
+          ssaoBlurDepthThreshold: config.post.ssaoBlurDepthThreshold,
+          bloomEnabled: config.post.bloomEnabled,
+          bloomThreshold: config.post.bloomThreshold,
+          bloomKnee: config.post.bloomKnee,
+          bloomIntensity: config.post.bloomIntensity,
+          bloomScatter: config.post.bloomScatter,
+        },
       };
       enqueueCommand(context.worldId, 'cmd-environment-update', {
         windowId: context.worldId,

package/src/engine/world/entities.ts

@@ -1,7 +1,23 @@
 import type { ShadowConfig } from '../../types/cmds/shadow';
 import type { EnvironmentConfig } from '../../types/cmds/environment';
+import type {
+  CmdAudioListenerCreateArgs,
+  CmdAudioListenerDisposeArgs,
+  CmdAudioListenerUpdateArgs,
+  CmdAudioResourceCreateArgs,
+  CmdAudioResourceDisposeArgs,
+  CmdAudioResourcePushArgs,
+  CmdAudioSourceCreateArgs,
+  CmdAudioSourceDisposeArgs,
+  CmdAudioSourcePauseArgs,
+  CmdAudioSourcePlayArgs,
+  CmdAudioSourceStopArgs,
+  CmdAudioSourceUpdateArgs,
+} from '../../types/cmds/audio';
+import type { CmdPoseUpdateArgs } from '../../types/cmds/model';
 import type { NotificationLevel, UserAttentionType } from '../../types/kinds';
 import { getWorldOrThrow, requireInitialized } from '../bridge/guards';
+import { enqueueCommand } from '../bridge/dispatch';
 import type {
   CameraProps,
   CreateWindowProps,
@@ -29,6 +45,145 @@ export function emitIntent(worldId: number, intent: Intent): void {
   world.pendingIntents.push(intent);
 }
 
+/**
+ * Returns the core model ID for an entity, if available.
+ */
+export function getModelId(worldId: number, entityId: number): number | null {
+  requireInitialized();
+  const world = getWorldOrThrow(worldId);
+  const store = world.components.get(entityId);
+  if (!store) return null;
+  const model = store.get('Model') as { id: number } | undefined;
+  return model?.id ?? null;
+}
+
+/**
+ * Sends an audio listener update command.
+ */
+export function audioListenerUpdate(
+  worldId: number,
+  args: CmdAudioListenerUpdateArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-listener-update', args);
+}
+
+/**
+ * Binds the audio listener to a model.
+ */
+export function audioListenerCreate(
+  worldId: number,
+  args: CmdAudioListenerCreateArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-listener-create', args);
+}
+
+/**
+ * Disposes the audio listener binding.
+ */
+export function audioListenerDispose(
+  worldId: number,
+  args: CmdAudioListenerDisposeArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-listener-dispose', args);
+}
+
+/**
+ * Creates an audio resource from an uploaded buffer.
+ */
+export function audioResourceCreate(
+  worldId: number,
+  args: CmdAudioResourceCreateArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-resource-create', args);
+}
+
+/**
+ * Pushes a chunk into a streaming audio resource.
+ */
+export function audioResourcePush(
+  worldId: number,
+  args: CmdAudioResourcePushArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-resource-push', args);
+}
+
+/**
+ * Disposes an audio resource.
+ */
+export function audioResourceDispose(
+  worldId: number,
+  args: CmdAudioResourceDisposeArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-resource-dispose', args);
+}
+
+/**
+ * Creates an audio source bound to a model.
+ */
+export function audioSourceCreate(
+  worldId: number,
+  args: CmdAudioSourceCreateArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-source-create', args);
+}
+
+/**
+ * Updates an audio source.
+ */
+export function audioSourceUpdate(
+  worldId: number,
+  args: CmdAudioSourceUpdateArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-source-update', args);
+}
+
+/**
+ * Starts playback for an audio source.
+ */
+export function audioSourcePlay(
+  worldId: number,
+  args: CmdAudioSourcePlayArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-source-play', args);
+}
+
+/**
+ * Pauses playback for an audio source.
+ */
+export function audioSourcePause(
+  worldId: number,
+  args: CmdAudioSourcePauseArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-source-pause', args);
+}
+
+/**
+ * Stops playback for an audio source.
+ */
+export function audioSourceStop(
+  worldId: number,
+  args: CmdAudioSourceStopArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-source-stop', args);
+}
+
+/**
+ * Disposes an audio source.
+ */
+export function audioSourceDispose(
+  worldId: number,
+  args: CmdAudioSourceDisposeArgs,
+): number {
+  return enqueueCommand(worldId, 'cmd-audio-source-dispose', args);
+}
+
+/**
+ * Updates a model pose (skinning) using an uploaded matrices buffer.
+ */
+export function poseUpdate(worldId: number, args: CmdPoseUpdateArgs): number {
+  return enqueueCommand(worldId, 'cmd-pose-update', args);
+}
+
 /**
  * Emits an intent to create a window in the core.
  */

package/src/types/cmds/audio.ts

@@ -0,0 +1,164 @@
+import type { AudioPlayMode } from '../kinds';
+
+export interface AudioSpatialParams {
+  minDistance: number;
+  maxDistance: number;
+  rolloff: number;
+  coneInner: number;
+  coneOuter: number;
+  coneOuterGain: number;
+}
+
+/** Command payload for updating the listener transform explicitly. */
+export interface CmdAudioListenerUpdateArgs {
+  position: [number, number, number];
+  velocity: [number, number, number];
+  forward: [number, number, number];
+  up: [number, number, number];
+}
+
+/** Command payload for binding the listener to a model. */
+export interface CmdAudioListenerCreateArgs {
+  windowId: number;
+  modelId: number;
+}
+
+/** Command payload for disposing the listener binding. */
+export interface CmdAudioListenerDisposeArgs {
+  windowId: number;
+}
+
+export interface CmdResultAudioListenerCreate {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdResultAudioListenerDispose {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdResultAudioListenerUpdate {
+  success: boolean;
+  message: string;
+}
+
+/** Command payload for creating an audio resource from uploaded bytes. */
+export interface CmdAudioResourceCreateArgs {
+  resourceId: number;
+  bufferId: number;
+  totalBytes?: number;
+  offsetBytes?: number;
+}
+
+export interface CmdResultAudioResourceCreate {
+  success: boolean;
+  message: string;
+  pending: boolean;
+}
+
+/** Command payload for pushing a stream chunk. */
+export interface CmdAudioResourcePushArgs {
+  resourceId: number;
+  bufferId: number;
+  offsetBytes: number;
+}
+
+export interface CmdResultAudioResourcePush {
+  success: boolean;
+  message: string;
+  receivedBytes: number;
+  totalBytes: number;
+  complete: boolean;
+}
+
+/** Command payload for creating a source bound to a model. */
+export interface CmdAudioSourceCreateArgs {
+  windowId: number;
+  sourceId: number;
+  modelId: number;
+  position: [number, number, number];
+  velocity: [number, number, number];
+  orientation: [number, number, number, number];
+  gain: number;
+  pitch: number;
+  spatial: AudioSpatialParams;
+}
+
+export interface CmdResultAudioSourceCreate {
+  success: boolean;
+  message: string;
+}
+
+/** Command payload for updating source params. */
+export interface CmdAudioSourceUpdateArgs {
+  sourceId: number;
+  position: [number, number, number];
+  velocity: [number, number, number];
+  orientation: [number, number, number, number];
+  gain: number;
+  pitch: number;
+  spatial: AudioSpatialParams;
+}
+
+export interface CmdResultAudioSourceUpdate {
+  success: boolean;
+  message: string;
+}
+
+/** Command payload for starting playback. */
+export interface CmdAudioSourcePlayArgs {
+  sourceId: number;
+  resourceId: number;
+  timelineId?: number;
+  intensity: number;
+  delayMs?: number;
+  mode: AudioPlayMode;
+}
+
+export interface CmdResultAudioSourcePlay {
+  success: boolean;
+  message: string;
+}
+
+/** Command payload for pausing playback. */
+export interface CmdAudioSourcePauseArgs {
+  sourceId: number;
+  timelineId?: number;
+}
+
+export interface CmdResultAudioSourcePause {
+  success: boolean;
+  message: string;
+}
+
+/** Command payload for stopping playback. */
+export interface CmdAudioSourceStopArgs {
+  sourceId: number;
+  timelineId?: number;
+}
+
+export interface CmdResultAudioSourceStop {
+  success: boolean;
+  message: string;
+}
+
+/** Command payload for disposing a source. */
+export interface CmdAudioSourceDisposeArgs {
+  sourceId: number;
+}
+
+export interface CmdResultAudioSourceDispose {
+  success: boolean;
+  message: string;
+}
+
+/** Command payload for disposing an audio resource. */
+export interface CmdAudioResourceDisposeArgs {
+  resourceId: number;
+}
+
+export interface CmdResultAudioResourceDispose {
+  success: boolean;
+  message: string;
+}

package/src/types/cmds/camera.ts

@@ -1,4 +1,5 @@
 import type { CameraKind } from '../kinds';
+import type { ResourceEntry } from './resources';
 
 /** Viewport value expressed as relative (0..1) or absolute pixels. */
 export interface ViewValue {
@@ -14,7 +15,6 @@ export interface ViewPosition {
 
 /** Command payload for creating a camera. */
 export interface CmdCameraCreateArgs {
-  windowId: number;
   cameraId: number;
   label?: string;
   transform: number[]; // Mat4 (16 elements)
@@ -35,8 +35,8 @@ export interface CmdResultCameraCreate {
 
 /** Command payload for updating a camera. */
 export interface CmdCameraUpdateArgs {
-  windowId: number;
   cameraId: number;
+  label?: string;
   transform?: number[];
   kind?: CameraKind;
   flags?: number;
@@ -55,7 +55,6 @@ export interface CmdResultCameraUpdate {
 
 /** Command payload for disposing a camera. */
 export interface CmdCameraDisposeArgs {
-  windowId: number;
   cameraId: number;
 }
 
@@ -66,11 +65,13 @@ export interface CmdResultCameraDispose {
 }
 
 /** Command payload for listing cameras. */
-export interface CmdCameraListArgs {}
+export interface CmdCameraListArgs {
+  windowId: number;
+}
 
 /** Result payload for camera list. */
 export interface CmdResultCameraList {
   success: boolean;
   message: string;
-  content: number[]; // List of camera IDs
+  cameras: ResourceEntry[];
 }

package/src/types/cmds/environment.ts

@@ -11,14 +11,51 @@ export interface SkyboxConfig {
   mode: SkyboxMode;
   intensity: number;
   rotation: number;
-  tint: [number, number, number];
+  groundColor: [number, number, number];
+  horizonColor: [number, number, number];
+  skyColor: [number, number, number];
   cubemapTextureId?: number | null;
 }
 
+/** Post-processing configuration. */
+export interface PostProcessConfig {
+  filterEnabled: boolean;
+  filterExposure: number;
+  filterGamma: number;
+  filterSaturation: number;
+  filterContrast: number;
+  filterVignette: number;
+  filterGrain: number;
+  filterChromaticAberration: number;
+  filterBlur: number;
+  filterSharpen: number;
+  filterTonemapMode: number;
+  outlineEnabled: boolean;
+  outlineStrength: number;
+  outlineThreshold: number;
+  outlineWidth: number;
+  outlineQuality: number;
+  filterPosterizeSteps: number;
+  cellShading: boolean;
+  ssaoEnabled: boolean;
+  ssaoStrength: number;
+  ssaoRadius: number;
+  ssaoBias: number;
+  ssaoPower: number;
+  ssaoBlurRadius: number;
+  ssaoBlurDepthThreshold: number;
+  bloomEnabled: boolean;
+  bloomThreshold: number;
+  bloomKnee: number;
+  bloomIntensity: number;
+  bloomScatter: number;
+}
+
 /** Environment configuration for a window. */
 export interface EnvironmentConfig {
   msaa: MsaaConfig;
   skybox: SkyboxConfig;
+  post: PostProcessConfig;
 }
 
 /** Command payload for creating environment settings. */

package/src/types/cmds/geometry.ts

@@ -1,4 +1,5 @@
 import type { PrimitiveShape } from '../kinds';
+import type { ResourceEntry } from './resources';
 
 /** Primitive attribute semantic identifiers. */
 export type GeometryPrimitiveType =
@@ -134,11 +135,13 @@ export interface CmdResultPrimitiveGeometryCreate {
 }
 
 /** Command payload for listing geometry resources. */
-export interface CmdGeometryListArgs {}
+export interface CmdGeometryListArgs {
+  windowId: number;
+}
 
 /** Result payload for geometry list. */
 export interface CmdResultGeometryList {
   success: boolean;
   message: string;
-  content: number[]; // List of geometry IDs
+  geometries: ResourceEntry[];
 }

package/src/types/cmds/index.ts

@@ -9,6 +9,8 @@ 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';
 
 export * from './system';
 export * from './window';
@@ -21,10 +23,17 @@ export * from './geometry';
 export * from './shadow';
 export * from './gizmo';
 export * from './environment';
+export * from './audio';
+export * from './render-graph';
+export * from './resources';
 
 /** Discriminated union of all core commands. */
 export type EngineCmd =
   | { type: 'cmd-notification-send'; content: Sys.CmdNotificationSendArgs }
+  | {
+      type: 'cmd-upload-buffer-discard-all';
+      content: Sys.CmdUploadBufferDiscardAllArgs;
+    }
   | { type: 'cmd-window-create'; content: Win.CmdWindowCreateArgs }
   | { type: 'cmd-window-close'; content: Win.CmdWindowCloseArgs }
   | { type: 'cmd-window-set-title'; content: Win.CmdWindowSetTitleArgs }
@@ -73,6 +82,19 @@ export type EngineCmd =
   | { type: 'cmd-camera-create'; content: Cam.CmdCameraCreateArgs }
   | { type: 'cmd-camera-update'; content: Cam.CmdCameraUpdateArgs }
   | { type: 'cmd-camera-dispose'; content: Cam.CmdCameraDisposeArgs }
+  | { 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 }
@@ -102,6 +124,7 @@ export type EngineCmd =
   | { 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-model-list'; content: Mod.CmdModelListArgs }
   | { type: 'cmd-material-list'; content: Mat.CmdMaterialListArgs }
   | { type: 'cmd-texture-list'; content: Tex.CmdTextureListArgs }
@@ -114,6 +137,10 @@ export type EngineCmd =
 /** Discriminated union of all core command responses. */
 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 }
@@ -159,6 +186,19 @@ export type CommandResponse =
   | { type: 'camera-create'; content: Cam.CmdResultCameraCreate }
   | { type: 'camera-update'; content: Cam.CmdResultCameraUpdate }
   | { type: 'camera-dispose'; content: Cam.CmdResultCameraDispose }
+  | { 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 }
@@ -188,6 +228,7 @@ export type CommandResponse =
   | { type: 'environment-update'; content: Env.CmdResultEnvironment }
   | { type: 'environment-dispose'; content: Env.CmdResultEnvironment }
   | { type: 'shadow-configure'; content: Shad.CmdResultShadowConfigure }
+  | { type: 'render-graph-set'; content: RenderGraph.CmdResultRenderGraphSet }
   | { type: 'model-list'; content: Mod.CmdResultModelList }
   | { type: 'material-list'; content: Mat.CmdResultMaterialList }
   | { type: 'texture-list'; content: Tex.CmdResultTextureList }

package/src/types/cmds/light.ts

@@ -1,4 +1,5 @@
 import type { LightKind } from '../kinds';
+import type { ResourceEntry } from './resources';
 
 /** Command payload for creating a light. */
 export interface CmdLightCreateArgs {
@@ -59,11 +60,13 @@ export interface CmdResultLightDispose {
 }
 
 /** Command payload for listing lights. */
-export interface CmdLightListArgs {}
+export interface CmdLightListArgs {
+  windowId: number;
+}
 
 /** Result payload for light list. */
 export interface CmdResultLightList {
   success: boolean;
   message: string;
-  content: number[]; // List of light IDs
+  lights: ResourceEntry[];
 }

package/src/types/cmds/material.ts

@@ -1,4 +1,5 @@
 import type { MaterialKind, TransparencyMode, SamplerMode } from '../kinds';
+import type { ResourceEntry } from './resources';
 
 /** Standard material options. */
 export interface StandardOptions {
@@ -88,11 +89,13 @@ export interface CmdResultMaterialDispose {
 }
 
 /** Command payload for listing materials. */
-export interface CmdMaterialListArgs {}
+export interface CmdMaterialListArgs {
+  windowId: number;
+}
 
 /** Result payload for material list. */
 export interface CmdResultMaterialList {
   success: boolean;
   message: string;
-  content: number[]; // List of material IDs
+  materials: ResourceEntry[];
 }

package/src/types/cmds/model.ts

@@ -1,3 +1,5 @@
+import type { ResourceEntry } from './resources';
+
 /** Command payload for creating a model. */
 export interface CmdModelCreateArgs {
   windowId: number ;
@@ -9,6 +11,8 @@ export interface CmdModelCreateArgs {
   layerMask: number;
   castShadow: boolean;
   receiveShadow: boolean;
+  castOutline: boolean;
+  outlineColor: [number, number, number, number];
 }
 
 /** Result payload for model create. */
@@ -28,6 +32,8 @@ export interface CmdModelUpdateArgs {
   layerMask?: number;
   castShadow?: boolean;
   receiveShadow?: boolean;
+  castOutline?: boolean;
+  outlineColor?: [number, number, number, number];
 }
 
 /** Result payload for model update. */
@@ -36,6 +42,20 @@ export interface CmdResultModelUpdate {
   message: string;
 }
 
+/** Command payload for updating a model pose (skinning). */
+export interface CmdPoseUpdateArgs {
+  windowId: number;
+  modelId: number;
+  boneCount: number;
+  matricesBufferId: number;
+}
+
+/** Result payload for pose update. */
+export interface CmdResultPoseUpdate {
+  success: boolean;
+  message: string;
+}
+
 /** Command payload for disposing a model. */
 export interface CmdModelDisposeArgs {
   windowId: number ;
@@ -49,11 +69,13 @@ export interface CmdResultModelDispose {
 }
 
 /** Command payload for listing models. */
-export interface CmdModelListArgs {}
+export interface CmdModelListArgs {
+  windowId: number;
+}
 
 /** Result payload for model list. */
 export interface CmdResultModelList {
   success: boolean;
   message: string;
-  content: number[]; // List of model IDs
+  models: ResourceEntry[];
 }

package/src/types/cmds/render-graph.ts

@@ -0,0 +1,49 @@
+export type LogicalId = string | number;
+
+export type RenderGraphResourceKind = 'texture' | 'buffer' | 'attachment';
+
+export type RenderGraphLifetime = 'frame' | 'persistent';
+
+export type RenderGraphEdgeReason = 'read-after-write' | 'write-after-read';
+
+export type RenderGraphValue = boolean | number | string;
+
+export interface RenderGraphResource {
+  resId: LogicalId;
+  kind?: RenderGraphResourceKind;
+  lifetime?: RenderGraphLifetime;
+  aliasGroup?: LogicalId | null;
+}
+
+export interface RenderGraphNode {
+  nodeId: LogicalId;
+  passId: string;
+  inputs?: LogicalId[];
+  outputs?: LogicalId[];
+  params?: Record<string, RenderGraphValue>;
+}
+
+export interface RenderGraphEdge {
+  fromNodeId: LogicalId;
+  toNodeId: LogicalId;
+  reason?: RenderGraphEdgeReason;
+}
+
+export interface RenderGraphDesc {
+  graphId: LogicalId;
+  nodes: RenderGraphNode[];
+  edges: RenderGraphEdge[];
+  resources?: RenderGraphResource[];
+  fallback?: boolean;
+}
+
+export interface CmdRenderGraphSetArgs {
+  windowId: number;
+  graph: RenderGraphDesc;
+}
+
+export interface CmdResultRenderGraphSet {
+  success: boolean;
+  fallbackUsed: boolean;
+  message: string;
+}

package/src/types/cmds/resources.ts

@@ -0,0 +1,4 @@
+export interface ResourceEntry {
+  id: number;
+  label: string | null;
+}

package/src/types/cmds/shadow.ts

@@ -1,12 +1,12 @@
 /** Shadow rendering configuration. */
 export interface ShadowConfig {
-  tileResolution: number;
-  atlasTilesW: number;
-  atlasTilesH: number;
-  atlasLayers: number;
-  virtualGridSize: number;
-  smoothing: number;
-  normalBias: number;
+  tileResolution?: number;
+  atlasTilesW?: number;
+  atlasTilesH?: number;
+  atlasLayers?: number;
+  virtualGridSize?: number;
+  smoothing?: number;
+  normalBias?: number;
 }
 
 /** Command payload for shadow configuration. */

package/src/types/cmds/system.ts

@@ -13,3 +13,13 @@ export interface CmdNotificationSendArgs {
 export interface CmdResultNotificationSend {
   success: boolean;
 }
+
+/** Command payload for discarding all pending upload buffers. */
+export interface CmdUploadBufferDiscardAllArgs {}
+
+/** Result payload for upload discard all. */
+export interface CmdResultUploadBufferDiscardAll {
+  success: boolean;
+  discardedCount: number;
+  message: string;
+}

package/src/types/cmds/texture.ts

@@ -1,4 +1,5 @@
 import type { TextureCreateMode } from '../kinds';
+import type { ResourceEntry } from './resources';
 
 /** Options for forward atlas texture packing. */
 export interface ForwardAtlasOptions {
@@ -21,6 +22,7 @@ export interface CmdTextureCreateFromBufferArgs {
 export interface CmdResultTextureCreateFromBuffer {
   success: boolean;
   message: string;
+  pending: boolean;
 }
 
 /** Command payload for creating a solid color texture. */
@@ -53,11 +55,13 @@ export interface CmdResultTextureDispose {
 }
 
 /** Command payload for listing textures. */
-export interface CmdTextureListArgs {}
+export interface CmdTextureListArgs {
+  windowId: number;
+}
 
 /** Result payload for texture list. */
 export interface CmdResultTextureList {
   success: boolean;
   message: string;
-  content: number[]; // List of texture IDs
+  textures: ResourceEntry[];
 }

package/src/types/cmds/window.ts

@@ -146,7 +146,7 @@ export interface CmdResultWindowGetState {
 /** Command payload for setting window icon. */
 export interface CmdWindowSetIconArgs {
   windowId: number;
-  icon: string; // Buffer ID pointing to an image
+  bufferId: number; // Buffer ID pointing to an image
 }
 
 /** Result payload for window icon update. */

package/src/types/events/system.ts

@@ -3,6 +3,29 @@ export interface SystemEventOnNotificationData {
   id: string;
 }
 
+/** Payload for async texture decode completion. */
+export interface SystemEventTextureReadyData {
+  window_id: number;
+  texture_id: number;
+  success: boolean;
+  message: string;
+}
+
+/** Payload for async audio decode completion. */
+export interface SystemEventAudioReadyData {
+  resource_id: number;
+  success: boolean;
+  message: string;
+}
+
+/** Payload for audio stream progress. */
+export interface SystemEventAudioStreamProgressData {
+  resource_id: number;
+  received_bytes: number;
+  total_bytes: number;
+  complete: boolean;
+}
+
 /** Discriminated union of system-level events. */
 export type SystemEvent =
   | { event: 'on-resume' }
@@ -10,4 +33,10 @@ export type SystemEvent =
   | { event: 'on-memory-warning' }
   | { event: 'on-exit' }
   | { event: 'on-notification-clicked'; data: SystemEventOnNotificationData }
-  | { event: 'on-notification-dismissed'; data: SystemEventOnNotificationData };
+  | { event: 'on-notification-dismissed'; data: SystemEventOnNotificationData }
+  | { event: 'texture-ready'; data: SystemEventTextureReadyData }
+  | { event: 'audio-ready'; data: SystemEventAudioReadyData }
+  | {
+      event: 'audio-stream-progress';
+      data: SystemEventAudioStreamProgressData;
+    };

package/src/types/kinds.ts

@@ -1,6 +1,9 @@
 /** Camera projection mode. */
 export type CameraKind = 'perspective' | 'orthographic';
 
+/** Audio playback mode. */
+export type AudioPlayMode = 'once' | 'loop';
+
 /** Standard cursor icons. */
 export type CursorIcon =
   | 'default'