@vulfram/engine 0.17.1-alpha → 0.19.3-alpha

package/src/engine/systems/resource-upload.ts

@@ -6,6 +6,15 @@ import { enqueueCommand } from '../bridge/dispatch';
 import type { GeometryProps, System } from '../ecs';
 import { normalizeMaterialOptions, normalizePrimitiveOptions } from './utils';
 
+const RESOURCE_INTENT_TYPES = [
+  'create-material',
+  'dispose-material',
+  'create-geometry',
+  'dispose-geometry',
+  'create-texture',
+  'dispose-texture',
+] as const;
+
 function buildPrimitiveOptions(
   primitiveProps: Extract<GeometryProps, { type: 'primitive' }>,
 ): PrimitiveOptions {
@@ -77,10 +86,10 @@ function buildPrimitiveOptions(
  * - texture (from buffer or solid color)
  */
 export const ResourceUploadSystem: System = (world, context) => {
-  const intentsToRemove: number[] = [];
+  const intents = world.intentStore.takeMany(RESOURCE_INTENT_TYPES);
 
-  for (let i = 0; i < world.pendingIntents.length; i++) {
-    const intent = world.pendingIntents[i];
+  for (let i = 0; i < intents.length; i++) {
+    const intent = intents[i];
     if (!intent) continue;
 
     if (intent.type === 'create-material') {
@@ -99,12 +108,10 @@ export const ResourceUploadSystem: System = (world, context) => {
         kind: intent.props.kind ?? 'standard',
         options: options,
       });
-      intentsToRemove.push(i);
     } else if (intent.type === 'dispose-material') {
       enqueueCommand(context.worldId, 'cmd-material-dispose', {
         materialId: intent.resourceId,
       });
-      intentsToRemove.push(i);
     } else if (intent.type === 'create-geometry') {
       if (intent.props.type === 'primitive') {
         const options = normalizePrimitiveOptions(
@@ -124,12 +131,10 @@ export const ResourceUploadSystem: System = (world, context) => {
           entries: intent.props.entries,
         });
       }
-      intentsToRemove.push(i);
     } else if (intent.type === 'dispose-geometry') {
       enqueueCommand(context.worldId, 'cmd-geometry-dispose', {
         geometryId: intent.resourceId,
       });
-      intentsToRemove.push(i);
     } else if (intent.type === 'create-texture') {
       if (intent.props.source.type === 'color') {
         const cmd: {
@@ -179,17 +184,10 @@ export const ResourceUploadSystem: System = (world, context) => {
         }
         enqueueCommand(context.worldId, 'cmd-texture-create-from-buffer', cmd);
       }
-      intentsToRemove.push(i);
     } else if (intent.type === 'dispose-texture') {
       enqueueCommand(context.worldId, 'cmd-texture-dispose', {
         textureId: intent.resourceId,
       });
-      intentsToRemove.push(i);
     }
   }
-
-  for (let i = intentsToRemove.length - 1; i >= 0; i--) {
-    const idx = intentsToRemove[i];
-    if (idx !== undefined) world.pendingIntents.splice(idx, 1);
-  }
 };

package/src/engine/systems/response-decode.ts

@@ -5,6 +5,21 @@ import { engineState } from '../state';
 const MAX_REALM_CREATE_RETRIES = 8;
 const BASE_REALM_RETRY_DELAY_MS = 32;
 
+function flushPendingTargetLayerBinds(world: Parameters<System>[0], worldId: number): void {
+  const realmId = world.coreRealmId;
+  if (realmId === undefined) return;
+
+  for (const binding of world.targetLayerBindings.values()) {
+    enqueueCommand(worldId, 'cmd-target-layer-upsert', {
+      realmId,
+      targetId: binding.targetId,
+      layout: binding.layout,
+      cameraId: binding.cameraId,
+      environmentId: binding.environmentId,
+    });
+  }
+}
+
 /**
  * Decodes and applies command responses routed to a world.
  *
@@ -57,6 +72,7 @@ export const ResponseDecodeSystem: System = (world, context) => {
         world.realmCreateRetryCount = 0;
         world.nextRealmCreateRetryAtMs = 0;
         markRoutingIndexDirty();
+        flushPendingTargetLayerBinds(world, context.worldId);
       }
     } else if (res.type === 'window-create') {
       const created = res.content as {
@@ -69,6 +85,7 @@ export const ResponseDecodeSystem: System = (world, context) => {
         world.realmCreateRetryCount = 0;
         world.nextRealmCreateRetryAtMs = 0;
         markRoutingIndexDirty();
+        flushPendingTargetLayerBinds(world, context.worldId);
       }
       if (typeof created.surfaceId === 'number') {
         world.coreSurfaceId = created.surfaceId;

package/src/engine/systems/scene-sync.ts

@@ -15,6 +15,15 @@ import {
   toVec4,
 } from './utils';
 
+const SCENE_SYNC_INTENT_TYPES = [
+  'attach-model',
+  'attach-camera',
+  'attach-light',
+  'detach-component',
+  'gizmo-draw-line',
+  'gizmo-draw-aabb',
+] as const;
+
 function copyMatrixToScratch(
   world: Parameters<System>[0],
   entityId: number,
@@ -39,12 +48,12 @@ function copyMatrixToScratch(
  * constraint matrix changed in the current tick.
  */
 export const SceneSyncSystem: System = (world, context) => {
-  const intentsToRemove: number[] = [];
   const realmId = world.coreRealmId;
   if (realmId === undefined) return;
+  const intents = world.intentStore.takeMany(SCENE_SYNC_INTENT_TYPES);
 
-  for (let i = 0; i < world.pendingIntents.length; i++) {
-    const intent = world.pendingIntents[i];
+  for (let i = 0; i < intents.length; i++) {
+    const intent = intents[i];
     if (!intent) continue;
 
     if (intent.type === 'attach-model') {
@@ -85,7 +94,6 @@ export const SceneSyncSystem: System = (world, context) => {
         skipUpdate: true,
       });
 
-      intentsToRemove.push(i);
     } else if (intent.type === 'attach-camera') {
       const cameraId = world.nextCoreId++;
       const transform = getResolvedEntityTransformMatrix(world, intent.entityId);
@@ -133,7 +141,6 @@ export const SceneSyncSystem: System = (world, context) => {
         binding.cameraId = cameraId;
       }
 
-      intentsToRemove.push(i);
     } else if (intent.type === 'attach-light') {
       const lightId = world.nextCoreId++;
       const transform = getResolvedEntityTransformMatrix(world, intent.entityId);
@@ -199,7 +206,6 @@ export const SceneSyncSystem: System = (world, context) => {
         skipUpdate: true,
       });
 
-      intentsToRemove.push(i);
     } else if (intent.type === 'detach-component') {
       const store = world.components.get(intent.entityId);
       if (store) {
@@ -227,21 +233,18 @@ export const SceneSyncSystem: System = (world, context) => {
         }
         store.delete(intent.componentType);
       }
-      intentsToRemove.push(i);
     } else if (intent.type === 'gizmo-draw-line') {
       enqueueCommand(context.worldId, 'cmd-gizmo-draw-line', {
         start: toVec3(intent.start),
         end: toVec3(intent.end),
         color: toVec4(intent.color),
       });
-      intentsToRemove.push(i);
     } else if (intent.type === 'gizmo-draw-aabb') {
       enqueueCommand(context.worldId, 'cmd-gizmo-draw-aabb', {
         min: toVec3(intent.min),
         max: toVec3(intent.max),
         color: toVec4(intent.color),
       });
-      intentsToRemove.push(i);
     }
   }
 
@@ -296,10 +299,6 @@ export const SceneSyncSystem: System = (world, context) => {
     }
   }
 
-  for (let i = intentsToRemove.length - 1; i >= 0; i--) {
-    const idx = intentsToRemove[i];
-    if (idx !== undefined) world.pendingIntents.splice(idx, 1);
-  }
 };
 
 /** Backward-compatible alias while migrating existing integrations. */

package/src/engine/systems/ui-bridge.ts

@@ -11,6 +11,33 @@ import type {
 } from '../ecs';
 
 const WORLD_ENTITY_ID = 0;
+const UI_INTENT_TYPES = [
+  'ui-theme-define',
+  'ui-theme-dispose',
+  'ui-document-create',
+  'ui-document-dispose',
+  'ui-document-set-rect',
+  'ui-document-set-theme',
+  'ui-document-get-tree',
+  'ui-document-get-layout-rects',
+  'ui-apply-ops',
+  'ui-debug-set',
+  'ui-focus-set',
+  'ui-focus-get',
+  'ui-event-trace-set',
+  'ui-image-create-from-buffer',
+  'ui-image-dispose',
+  'ui-clipboard-paste',
+  'ui-screenshot-reply',
+  'ui-access-kit-action-request',
+  'ui-form-upsert',
+  'ui-form-dispose',
+  'ui-fieldset-upsert',
+  'ui-fieldset-dispose',
+  'ui-focusable-upsert',
+  'ui-focusable-dispose',
+  'ui-focus-next',
+] as const;
 
 function ensureUiState(world: Parameters<System>[0]): UiStateComponent {
   let worldStore = world.components.get(WORLD_ENTITY_ID);
@@ -315,20 +342,18 @@ function processUiIntent(
  */
 export const UiBridgeSystem: System = (world, context) => {
   const uiState = ensureUiState(world);
-  const intentsToRemove: number[] = [];
   let explicitFocusNavigation = false;
+  const intents = world.intentStore.takeMany(UI_INTENT_TYPES);
 
-  for (let i = 0; i < world.pendingIntents.length; i++) {
-    const intent = world.pendingIntents[i];
+  for (let i = 0; i < intents.length; i++) {
+    const intent = intents[i];
     if (!intent) continue;
 
     if (intent.type === 'ui-focus-next') {
       explicitFocusNavigation = true;
     }
 
-    if (processUiIntent(context.worldId, uiState, intent)) {
-      intentsToRemove.push(i);
-    }
+    processUiIntent(context.worldId, uiState, intent);
   }
 
   if (!explicitFocusNavigation) {
@@ -353,8 +378,4 @@ export const UiBridgeSystem: System = (world, context) => {
     }
   }
 
-  for (let i = intentsToRemove.length - 1; i >= 0; i--) {
-    const idx = intentsToRemove[i];
-    if (idx !== undefined) world.pendingIntents.splice(idx, 1);
-  }
 };

package/src/engine/systems/utils.ts

@@ -168,10 +168,53 @@ export function getResolvedEntityTransformMatrix(
   entityId: number,
 ): mat4 {
   const resolved = world.resolvedEntityTransforms.get(entityId);
-  if (!resolved) {
-    return getEntityLocalTransformMatrix(world, entityId);
+  if (resolved && !hasDirtyConstraintPath(world, entityId)) {
+    return mat4.clone(resolved);
   }
-  return mat4.clone(resolved);
+
+  // Fallback for same-frame reads before ConstraintSolve runs:
+  // recompute parent-chain world transform directly from local components.
+  return resolveEntityWorldTransformImmediate(world, entityId);
+}
+
+function hasDirtyConstraintPath(world: WorldState, entityId: number): boolean {
+  let current: number | undefined = entityId;
+  while (current !== undefined) {
+    if (world.constraintDirtyEntities.has(current)) {
+      return true;
+    }
+    current = world.constraintParentByChild.get(current);
+  }
+  return false;
+}
+
+function resolveEntityWorldTransformImmediate(
+  world: WorldState,
+  entityId: number,
+): mat4 {
+  const visiting = new Set<number>();
+
+  const resolveRecursive = (currentId: number): mat4 => {
+    if (visiting.has(currentId)) {
+      return getEntityLocalTransformMatrix(world, currentId);
+    }
+    visiting.add(currentId);
+
+    const local = getEntityLocalTransformMatrix(world, currentId);
+    const parentId = world.constraintParentByChild.get(currentId);
+    if (parentId === undefined) {
+      visiting.delete(currentId);
+      return local;
+    }
+
+    const parentWorld = resolveRecursive(parentId);
+    const out = mat4.create();
+    mat4.multiply(out, parentWorld, local);
+    visiting.delete(currentId);
+    return out;
+  };
+
+  return resolveRecursive(entityId);
 }
 
 /** Compares 4x4 matrices using an absolute epsilon per component. */

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

@@ -4,6 +4,12 @@ import { enqueueCommand } from '../bridge/dispatch';
 import type { System } from '../ecs';
 import { toVec3, toVec4 } from './utils';
 
+const WORLD_LIFECYCLE_INTENT_TYPES = [
+  'configure-environment',
+  'configure-shadows',
+  'send-notification',
+] as const;
+
 /**
  * Applies world-scoped lifecycle/configuration intents.
  *
@@ -13,10 +19,10 @@ import { toVec3, toVec4 } from './utils';
  * - notification dispatch
  */
 export const WorldLifecycleSystem: System = (world, context) => {
-  const intentsToRemove: number[] = [];
+  const intents = world.intentStore.takeMany(WORLD_LIFECYCLE_INTENT_TYPES);
 
-  for (let i = 0; i < world.pendingIntents.length; i++) {
-    const intent = world.pendingIntents[i];
+  for (let i = 0; i < intents.length; i++) {
+    const intent = intents[i];
     if (!intent) continue;
 
     if (intent.type === 'configure-environment') {
@@ -85,7 +91,6 @@ export const WorldLifecycleSystem: System = (world, context) => {
           environmentId: context.worldId,
         });
       }
-      intentsToRemove.push(i);
     } else if (intent.type === 'configure-shadows') {
       let windowId = world.primaryWindowId;
       if (windowId === undefined) {
@@ -94,9 +99,6 @@ export const WorldLifecycleSystem: System = (world, context) => {
           break;
         }
       }
-      if (windowId === undefined) {
-        windowId = world.realmCreateArgs.hostWindowId;
-      }
       if (windowId === undefined) continue;
       const c = intent.config || {};
       const config: ShadowConfig = {
@@ -112,7 +114,6 @@ export const WorldLifecycleSystem: System = (world, context) => {
         windowId,
         config,
       });
-      intentsToRemove.push(i);
     } else if (intent.type === 'send-notification') {
       enqueueCommand(context.worldId, 'cmd-notification-send', {
         id: `notif-${Date.now()}`,
@@ -121,13 +122,6 @@ export const WorldLifecycleSystem: System = (world, context) => {
         body: intent.message,
         timeout: 5000,
       });
-      intentsToRemove.push(i);
     }
   }
-
-  for (let i = intentsToRemove.length - 1; i >= 0; i--) {
-    const idx = intentsToRemove[i];
-    if (idx !== undefined) world.pendingIntents.splice(idx, 1);
-  }
-
 };