@dcl/ecs 7.23.2-25521226778.commit-1828100 → 7.23.2-25802088407.commit-15e8697

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/dist/components/index.d.ts +0 -5
  2. package/dist/components/index.js +2 -5
  3. package/dist/components/manual/Transform.d.ts +0 -9
  4. package/dist/components/manual/Transform.js +3 -3
  5. package/dist/components/types.d.ts +0 -1
  6. package/dist/engine/component.d.ts +1 -52
  7. package/dist/engine/grow-only-value-set-component-definition.js +2 -45
  8. package/dist/engine/lww-element-set-component-definition.d.ts +1 -3
  9. package/dist/engine/lww-element-set-component-definition.js +12 -64
  10. package/dist/index.d.ts +1 -2
  11. package/dist/index.js +0 -1
  12. package/dist/serialization/crdt/index.d.ts +0 -1
  13. package/dist/serialization/crdt/index.js +0 -1
  14. package/dist/serialization/crdt/network/utils.d.ts +9 -0
  15. package/dist/serialization/crdt/network/utils.js +60 -0
  16. package/dist/serialization/crdt/types.d.ts +3 -25
  17. package/dist/serialization/crdt/types.js +1 -3
  18. package/dist/systems/crdt/index.d.ts +1 -0
  19. package/dist/systems/crdt/index.js +146 -55
  20. package/dist/systems/triggerArea.d.ts +5 -0
  21. package/dist/systems/triggerArea.js +129 -42
  22. package/dist-cjs/components/index.d.ts +0 -5
  23. package/dist-cjs/components/index.js +3 -7
  24. package/dist-cjs/components/manual/Transform.d.ts +0 -9
  25. package/dist-cjs/components/manual/Transform.js +3 -3
  26. package/dist-cjs/components/types.d.ts +0 -1
  27. package/dist-cjs/engine/component.d.ts +1 -52
  28. package/dist-cjs/engine/grow-only-value-set-component-definition.js +1 -44
  29. package/dist-cjs/engine/lww-element-set-component-definition.d.ts +1 -3
  30. package/dist-cjs/engine/lww-element-set-component-definition.js +13 -67
  31. package/dist-cjs/index.d.ts +1 -2
  32. package/dist-cjs/index.js +1 -2
  33. package/dist-cjs/serialization/crdt/index.d.ts +0 -1
  34. package/dist-cjs/serialization/crdt/index.js +0 -1
  35. package/dist-cjs/serialization/crdt/network/utils.d.ts +9 -0
  36. package/dist-cjs/serialization/crdt/network/utils.js +67 -0
  37. package/dist-cjs/serialization/crdt/types.d.ts +3 -25
  38. package/dist-cjs/serialization/crdt/types.js +1 -3
  39. package/dist-cjs/systems/crdt/index.d.ts +1 -0
  40. package/dist-cjs/systems/crdt/index.js +169 -55
  41. package/dist-cjs/systems/triggerArea.d.ts +5 -0
  42. package/dist-cjs/systems/triggerArea.js +129 -42
  43. package/package.json +2 -2
  44. package/dist/components/manual/CreatedBy.d.ts +0 -9
  45. package/dist/components/manual/CreatedBy.js +0 -8
  46. package/dist/serialization/crdt/authoritativePutComponent.d.ts +0 -15
  47. package/dist/serialization/crdt/authoritativePutComponent.js +0 -47
  48. package/dist-cjs/components/manual/CreatedBy.d.ts +0 -9
  49. package/dist-cjs/components/manual/CreatedBy.js +0 -10
  50. package/dist-cjs/serialization/crdt/authoritativePutComponent.d.ts +0 -15
  51. package/dist-cjs/serialization/crdt/authoritativePutComponent.js +0 -50
@@ -1,17 +1,24 @@
1
1
  import { EntityState } from '../../engine/entity';
2
2
  import { ReadWriteByteBuffer } from '../../serialization/ByteBuffer';
3
- import { AppendValueOperation, CrdtMessageProtocol } from '../../serialization/crdt';
3
+ import { AppendValueOperation, CrdtMessageProtocol, DeleteComponentNetwork, DeleteEntityNetwork } from '../../serialization/crdt';
4
4
  import { DeleteComponent } from '../../serialization/crdt/deleteComponent';
5
5
  import { DeleteEntity } from '../../serialization/crdt/deleteEntity';
6
6
  import { PutComponentOperation } from '../../serialization/crdt/putComponent';
7
- import { AuthoritativePutComponentOperation } from '../../serialization/crdt/authoritativePutComponent';
8
7
  import { CrdtMessageType } from '../../serialization/crdt/types';
8
+ import { PutNetworkComponentOperation } from '../../serialization/crdt/network/putComponentNetwork';
9
+ import { NetworkEntity as defineNetworkEntity, NetworkParent as defineNetworkParent, Transform as defineTransform } from '../../components';
10
+ import * as networkUtils from '../../serialization/crdt/network/utils';
11
+ // NetworkMessages can only have a MAX_SIZE of 12kb. So we need to send it in chunks.
12
+ export const LIVEKIT_MAX_SIZE = 12;
9
13
  /**
10
14
  * @internal
11
15
  */
12
16
  export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
13
17
  const transports = [];
14
- // No network components needed - pure CRDT processing only
18
+ // Components that we used on this system
19
+ const NetworkEntity = defineNetworkEntity(engine);
20
+ const NetworkParent = defineNetworkParent(engine);
21
+ const Transform = defineTransform(engine);
15
22
  // Messages that we received at transport.onMessage waiting to be processed
16
23
  const receivedMessages = [];
17
24
  // Messages already processed by the engine but that we need to broadcast to other transports.
@@ -36,20 +43,27 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
36
43
  if (header.type === CrdtMessageType.DELETE_COMPONENT) {
37
44
  message = DeleteComponent.read(buffer);
38
45
  }
46
+ else if (header.type === CrdtMessageType.DELETE_COMPONENT_NETWORK) {
47
+ message = DeleteComponentNetwork.read(buffer);
48
+ }
39
49
  else if (header.type === CrdtMessageType.PUT_COMPONENT) {
40
50
  message = PutComponentOperation.read(buffer);
41
51
  }
42
- else if (header.type === CrdtMessageType.AUTHORITATIVE_PUT_COMPONENT) {
43
- message = AuthoritativePutComponentOperation.read(buffer);
52
+ else if (header.type === CrdtMessageType.PUT_COMPONENT_NETWORK) {
53
+ message = PutNetworkComponentOperation.read(buffer);
44
54
  }
45
55
  else if (header.type === CrdtMessageType.DELETE_ENTITY) {
46
56
  message = DeleteEntity.read(buffer);
47
57
  }
58
+ else if (header.type === CrdtMessageType.DELETE_ENTITY_NETWORK) {
59
+ message = DeleteEntityNetwork.read(buffer);
60
+ }
48
61
  else if (header.type === CrdtMessageType.APPEND_VALUE) {
49
62
  message = AppendValueOperation.read(buffer);
63
+ // Unknown message, we skip it
50
64
  }
51
65
  else {
52
- // Unknown message, we skip it (including NETWORK messages)
66
+ // consume the message
53
67
  buffer.incrementReadOffset(header.length);
54
68
  }
55
69
  if (message) {
@@ -70,6 +84,22 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
70
84
  const messagesToProcess = value.splice(0, value.length);
71
85
  return messagesToProcess;
72
86
  }
87
+ /**
88
+ * Find the local entityId associated to the network component message.
89
+ * It's a mapping Network -> to Local
90
+ * If it's not a network message, return the entityId received by the message
91
+ */
92
+ function findNetworkId(msg) {
93
+ const hasNetworkId = 'networkId' in msg;
94
+ if (hasNetworkId) {
95
+ for (const [entityId, network] of engine.getEntitiesWith(NetworkEntity)) {
96
+ if (network.networkId === msg.networkId && network.entityId === msg.entityId) {
97
+ return { entityId, network };
98
+ }
99
+ }
100
+ }
101
+ return { entityId: msg.entityId };
102
+ }
73
103
  /**
74
104
  * This fn will be called on every tick.
75
105
  * Process all the messages queue received by the transport
@@ -78,52 +108,46 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
78
108
  const messagesToProcess = getMessages(receivedMessages);
79
109
  const entitiesShouldBeCleaned = [];
80
110
  for (const msg of messagesToProcess) {
81
- // Simple CRDT processing - no network logic
82
- if (msg.type === CrdtMessageType.DELETE_ENTITY) {
83
- entitiesShouldBeCleaned.push(msg.entityId);
111
+ let { entityId, network } = findNetworkId(msg);
112
+ // We receive a new Entity. Create the localEntity and map it to the NetworkEntity component
113
+ if (networkUtils.isNetworkMessage(msg) && !network) {
114
+ entityId = engine.addEntity();
115
+ network = { entityId: msg.entityId, networkId: msg.networkId };
116
+ NetworkEntity.createOrReplace(entityId, network);
117
+ }
118
+ if (msg.type === CrdtMessageType.DELETE_ENTITY || msg.type === CrdtMessageType.DELETE_ENTITY_NETWORK) {
119
+ entitiesShouldBeCleaned.push(entityId);
84
120
  broadcastMessages.push(msg);
85
121
  }
86
122
  else {
87
- const entityState = engine.entityContainer.getEntityState(msg.entityId);
88
- // Skip updates from removed entities
123
+ const entityState = engine.entityContainer.getEntityState(entityId);
124
+ // Skip updates from removed entityes
89
125
  if (entityState === EntityState.Removed)
90
126
  continue;
91
- // Entities with unknown state should update its entity state
127
+ // Entities with unknown entities should update its entity state
92
128
  if (entityState === EntityState.Unknown) {
93
- engine.entityContainer.updateUsedEntity(msg.entityId);
94
- }
95
- // Only process component-related messages (not DELETE_ENTITY)
96
- if ('componentId' in msg) {
97
- const component = engine.getComponentOrNull(msg.componentId);
98
- if (component) {
99
- // Handle authoritative messages differently - they force the state regardless of timestamp
100
- const tryUpdate = () => {
101
- try {
102
- return msg.type === CrdtMessageType.AUTHORITATIVE_PUT_COMPONENT
103
- ? component.__forceUpdateFromCrdt(msg)
104
- : component.updateFromCrdt(msg);
105
- }
106
- catch (e) {
107
- console.error('[receiveMessages] ERROR processing message', msg, e);
108
- return null;
109
- }
110
- };
111
- const result = tryUpdate();
112
- if (!result)
113
- continue;
114
- const [conflictMessage, value] = result;
115
- if (!conflictMessage) {
116
- // Add message to broadcast queue when no conflict
117
- broadcastMessages.push(msg);
118
- onProcessEntityComponentChange && onProcessEntityComponentChange(msg.entityId, msg.type, component, value);
119
- }
129
+ engine.entityContainer.updateUsedEntity(entityId);
130
+ }
131
+ const component = engine.getComponentOrNull(msg.componentId);
132
+ /* istanbul ignore else */
133
+ if (component) {
134
+ if (msg.type === CrdtMessageType.PUT_COMPONENT &&
135
+ component.componentId === Transform.componentId &&
136
+ NetworkEntity.has(entityId) &&
137
+ NetworkParent.has(entityId)) {
138
+ msg.data = networkUtils.fixTransformParent(msg);
120
139
  }
121
- else {
122
- // Component not found - still broadcast for editor compatibility
123
- /* istanbul ignore next */
140
+ const [conflictMessage, value] = component.updateFromCrdt({ ...msg, entityId });
141
+ if (!conflictMessage) {
142
+ // Add message to transport queue to be processed by others transports
124
143
  broadcastMessages.push(msg);
144
+ onProcessEntityComponentChange && onProcessEntityComponentChange(entityId, msg.type, component, value);
125
145
  }
126
146
  }
147
+ else {
148
+ // TODO: test this line, it is fundammental to make the editor work
149
+ broadcastMessages.push(msg);
150
+ }
127
151
  }
128
152
  }
129
153
  // the last stage of the syncrhonization is to delete the entities
@@ -137,17 +161,16 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
137
161
  }
138
162
  }
139
163
  /**
140
- * Simple CRDT message broadcasting - no network-specific logic
164
+ * Iterates the dirty map and generates crdt messages to be send
141
165
  */
142
166
  async function sendMessages(entitiesDeletedThisTick) {
143
- // Get messages from broadcast queue and component updates
167
+ // CRDT Messages will be the merge between the recieved transport messages and the new crdt messages
144
168
  const crdtMessages = getMessages(broadcastMessages);
145
169
  const buffer = new ReadWriteByteBuffer();
146
- // Generate CRDT messages from component updates
147
170
  for (const component of engine.componentsIter()) {
148
171
  for (const message of component.getCrdtUpdates()) {
149
172
  const offset = buffer.currentWriteOffset();
150
- // Only create messages if there's a transport that will handle it
173
+ // Avoid creating messages if there is no transport that will handle it
151
174
  if (transports.some((t) => t.filter(message))) {
152
175
  if (message.type === CrdtMessageType.PUT_COMPONENT) {
153
176
  PutComponentOperation.write(message.entityId, message.timestamp, message.componentId, message.data, buffer);
@@ -171,7 +194,7 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
171
194
  }
172
195
  }
173
196
  }
174
- // Handle deleted entities
197
+ // After all updates, I execute the DeletedEntity messages
175
198
  for (const entityId of entitiesDeletedThisTick) {
176
199
  const offset = buffer.currentWriteOffset();
177
200
  DeleteEntity.write(entityId, buffer);
@@ -182,19 +205,87 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
182
205
  });
183
206
  onProcessEntityComponentChange && onProcessEntityComponentChange(entityId, CrdtMessageType.DELETE_ENTITY);
184
207
  }
185
- // Simple transport broadcasting - no network-specific transforms
186
- for (const transport of transports) {
187
- const transportBuffer = new ReadWriteByteBuffer();
208
+ // Send CRDT messages to transports
209
+ const transportBuffer = new ReadWriteByteBuffer();
210
+ for (const index in transports) {
211
+ const __NetworkMessagesBuffer = [];
212
+ const transportIndex = Number(index);
213
+ const transport = transports[transportIndex];
214
+ const isRendererTransport = transport.type === 'renderer';
215
+ const isNetworkTransport = transport.type === 'network';
216
+ // Reset Buffer for each Transport
217
+ transportBuffer.resetBuffer();
218
+ const buffer = new ReadWriteByteBuffer();
219
+ // Then we send all the new crdtMessages that the transport needs to process
188
220
  for (const message of crdtMessages) {
189
221
  // Avoid echo messages
190
- if (message.transportId === transports.indexOf(transport))
222
+ if (message.transportId === transportIndex)
191
223
  continue;
192
- // Check if transport wants this message
193
- if (transport.filter(message)) {
194
- transportBuffer.writeBuffer(message.messageBuffer, false);
224
+ // Redundant message for the transport
225
+ if (!transport.filter(message))
226
+ continue;
227
+ // Check if adding this message would exceed the size limit
228
+ const currentBufferSize = transportBuffer.toBinary().byteLength;
229
+ const messageSize = message.messageBuffer.byteLength;
230
+ if (isNetworkTransport && (currentBufferSize + messageSize) / 1024 > LIVEKIT_MAX_SIZE) {
231
+ // If the current buffer has content, save it as a chunk
232
+ if (currentBufferSize > 0) {
233
+ __NetworkMessagesBuffer.push(transportBuffer.toCopiedBinary());
234
+ transportBuffer.resetBuffer();
235
+ }
236
+ // If the message itself is larger than the limit, we need to handle it specially
237
+ // For now, we'll skip it to prevent infinite loops
238
+ if (messageSize / 1024 > LIVEKIT_MAX_SIZE) {
239
+ console.error(`Message too large (${messageSize} bytes), skipping message for entity ${message.entityId}`);
240
+ continue;
241
+ }
195
242
  }
243
+ const { entityId } = findNetworkId(message);
244
+ const transformNeedsFix = 'componentId' in message &&
245
+ message.componentId === Transform.componentId &&
246
+ Transform.has(entityId) &&
247
+ NetworkParent.has(entityId) &&
248
+ NetworkEntity.has(entityId);
249
+ // If there was a LOCAL change in the transform. Add the parent to that transform
250
+ if (isRendererTransport && message.type === CrdtMessageType.PUT_COMPONENT && transformNeedsFix) {
251
+ const parent = findNetworkId(NetworkParent.get(entityId));
252
+ const transformData = networkUtils.fixTransformParent(message, Transform.get(entityId), parent.entityId);
253
+ const offset = buffer.currentWriteOffset();
254
+ PutComponentOperation.write(entityId, message.timestamp, message.componentId, transformData, buffer);
255
+ transportBuffer.writeBuffer(buffer.buffer().subarray(offset, buffer.currentWriteOffset()), false);
256
+ continue;
257
+ }
258
+ if (isRendererTransport && networkUtils.isNetworkMessage(message)) {
259
+ // If it's the renderer transport and its a NetworkMessage, we need to fix the entityId field and convert it to a known Message.
260
+ // PUT_NETWORK_COMPONENT -> PUT_COMPONENT
261
+ let transformData = 'data' in message ? message.data : new Uint8Array();
262
+ if (transformNeedsFix) {
263
+ const parent = findNetworkId(NetworkParent.get(entityId));
264
+ transformData = networkUtils.fixTransformParent(message, Transform.get(entityId), parent.entityId);
265
+ }
266
+ networkUtils.networkMessageToLocal({ ...message, data: transformData }, entityId, buffer, transportBuffer);
267
+ // Iterate the next message
268
+ continue;
269
+ }
270
+ // If its a network transport and its a PUT_COMPONENT that has a NetworkEntity component, we need to send this message
271
+ // through comms with the EntityID and NetworkID from ther NetworkEntity so everyone can recieve this message and map to their custom entityID.
272
+ if (isNetworkTransport && !networkUtils.isNetworkMessage(message)) {
273
+ const networkData = NetworkEntity.getOrNull(message.entityId);
274
+ // If it has networkData convert the message to PUT_NETWORK_COMPONENT.
275
+ if (networkData) {
276
+ networkUtils.localMessageToNetwork(message, networkData, buffer, transportBuffer);
277
+ // Iterate the next message
278
+ continue;
279
+ }
280
+ }
281
+ // Common message
282
+ transportBuffer.writeBuffer(message.messageBuffer, false);
283
+ }
284
+ if (isNetworkTransport && transportBuffer.currentWriteOffset()) {
285
+ __NetworkMessagesBuffer.push(transportBuffer.toBinary());
196
286
  }
197
- await transport.send(transportBuffer.toBinary());
287
+ const message = isNetworkTransport ? __NetworkMessagesBuffer : transportBuffer.toBinary();
288
+ await transport.send(message);
198
289
  }
199
290
  }
200
291
  /**
@@ -26,6 +26,11 @@ export interface TriggerAreaEventsSystem {
26
26
  * Execute callback when an entity stays in the Trigger Area
27
27
  * @param entity - The entity that already has the TriggerArea component
28
28
  * @param cb - Function to execute the 'Stay' type of result is detected
29
+ *
30
+ * Note: stay callbacks are synthesized by the SDK on every tick between a wire ENTER and a wire EXIT.
31
+ * Wire-level TAET_STAY events (still emitted by legacy Explorers) are ignored entirely — they neither
32
+ * fire callbacks nor mutate state. The SDK is the sole source of onTriggerStay dispatches, driven
33
+ * from the ENTER/EXIT state machine.
29
34
  */
30
35
  onTriggerStay(entity: Entity, cb: TriggerAreaEventSystemCallback): void;
31
36
  /**
@@ -1,10 +1,57 @@
1
1
  import * as components from '../components';
2
2
  import { EntityState } from '../engine/entity';
3
+ /**
4
+ * Builds a synthetic PBTriggerAreaResult for a per-tick onStay callback.
5
+ *
6
+ * Transform components are resolved at call time so that scene-owned entities report
7
+ * up-to-date position/rotation/scale. For player-avatar triggerers (reserved entities
8
+ * without a scene-side Transform), there is no scene Transform component, so the cached
9
+ * values from the last ENTER or wire-STAY event are used as-is. These cached values may
10
+ * be slightly stale for the current frame — this is expected and acceptable for the
11
+ * avatar case.
12
+ */
13
+ function buildSyntheticStayResult(cached, triggerAreaEntity, triggererEntity, currentTimestamp, Transform) {
14
+ // Shallow-clone the trigger sub-object so we can mutate it.
15
+ const trigger = cached.trigger
16
+ ? {
17
+ entity: cached.trigger.entity,
18
+ layers: cached.trigger.layers,
19
+ position: cached.trigger.position ? { ...cached.trigger.position } : undefined,
20
+ rotation: cached.trigger.rotation ? { ...cached.trigger.rotation } : undefined,
21
+ scale: cached.trigger.scale ? { ...cached.trigger.scale } : undefined
22
+ }
23
+ : undefined;
24
+ // Build the cloned result with a forced TAET_STAY eventType and refreshed timestamp.
25
+ const result = {
26
+ triggeredEntity: cached.triggeredEntity,
27
+ triggeredEntityPosition: cached.triggeredEntityPosition ? { ...cached.triggeredEntityPosition } : undefined,
28
+ triggeredEntityRotation: cached.triggeredEntityRotation ? { ...cached.triggeredEntityRotation } : undefined,
29
+ eventType: 1 /* TriggerAreaEventType.TAET_STAY */,
30
+ timestamp: currentTimestamp,
31
+ trigger
32
+ };
33
+ // Refresh trigger-area entity transform when it is scene-owned.
34
+ const triggerAreaTransform = Transform.getOrNull(triggerAreaEntity);
35
+ if (triggerAreaTransform !== null) {
36
+ result.triggeredEntityPosition = { ...triggerAreaTransform.position };
37
+ result.triggeredEntityRotation = { ...triggerAreaTransform.rotation };
38
+ }
39
+ // Refresh triggerer transform when it is scene-owned.
40
+ // For player-avatar entities (reserved, no scene-side Transform) the cached values are kept.
41
+ const triggererTransform = Transform.getOrNull(triggererEntity);
42
+ if (triggererTransform !== null && result.trigger) {
43
+ result.trigger.position = { ...triggererTransform.position };
44
+ result.trigger.rotation = { ...triggererTransform.rotation };
45
+ result.trigger.scale = { ...triggererTransform.scale };
46
+ }
47
+ return result;
48
+ }
3
49
  /**
4
50
  * @internal
5
51
  */
6
52
  export function createTriggerAreaEventsSystem(engine) {
7
53
  const triggerAreaResultComponent = components.TriggerAreaResult(engine);
54
+ const Transform = components.Transform(engine);
8
55
  const entitiesMap = new Map();
9
56
  function hasCallbacksMap(entity) {
10
57
  return entitiesMap.has(entity) && entitiesMap.get(entity) !== undefined;
@@ -16,7 +63,8 @@ export function createTriggerAreaEventsSystem(engine) {
16
63
  else {
17
64
  entitiesMap.set(entity, {
18
65
  triggerCallbackMap: new Map([[triggerType, callback]]),
19
- lastConsumedTimestamp: -1
66
+ lastConsumedTimestamp: -1,
67
+ insideTriggerers: new Map()
20
68
  });
21
69
  }
22
70
  }
@@ -25,7 +73,9 @@ export function createTriggerAreaEventsSystem(engine) {
25
73
  return;
26
74
  const triggerCallbackMap = entitiesMap.get(entity).triggerCallbackMap;
27
75
  triggerCallbackMap.delete(triggerType);
28
- // Remove entity if no more trigger callbacks are registered
76
+ // Remove entity if no more trigger callbacks are registered.
77
+ // insideTriggerers is intentionally left populated so that re-subscription picks up
78
+ // in-flight sessions without missing the first synthesized onStay.
29
79
  if (triggerCallbackMap.size === 0)
30
80
  entitiesMap.delete(entity);
31
81
  }
@@ -55,51 +105,88 @@ export function createTriggerAreaEventsSystem(engine) {
55
105
  continue;
56
106
  }
57
107
  const result = triggerAreaResultComponent.get(entity);
58
- // The Explorer may be taking time before the result component is put
59
- if (result.size === 0)
60
- continue;
61
- const values = Array.from(result.values());
62
- // determine starting index for new values (more than one could be added between System updates)
63
- // search backwards to find the anchor at lastConsumedTimestamp
64
- let startIndex = 0;
65
- if (data.lastConsumedTimestamp >= 0) {
66
- const newestTimestamp = values[values.length - 1].timestamp;
67
- // if nothing new, skip processing
68
- if (newestTimestamp <= data.lastConsumedTimestamp) {
69
- continue;
108
+ // -----------------------------------------------------------------------
109
+ // Pass 1: drain new GOVS events
110
+ // -----------------------------------------------------------------------
111
+ // The Explorer may be taking time before the result component is put.
112
+ if (result.size > 0) {
113
+ const values = Array.from(result.values());
114
+ // Determine starting index for new values (more than one could be added between System updates).
115
+ // Search backwards to find the anchor at lastConsumedTimestamp.
116
+ let startIndex = 0;
117
+ if (data.lastConsumedTimestamp >= 0) {
118
+ const newestTimestamp = values[values.length - 1].timestamp;
119
+ // If nothing new, skip processing.
120
+ if (newestTimestamp > data.lastConsumedTimestamp) {
121
+ // Find index of value with the lastConsumedTimestamp.
122
+ let i = values.length - 2;
123
+ while (i >= 0 && values[i].timestamp > data.lastConsumedTimestamp)
124
+ i--;
125
+ // Mark the following value index as the starting point to trigger all the new value callbacks.
126
+ startIndex = i + 1;
127
+ }
128
+ else {
129
+ // No new events — skip to Pass 2.
130
+ startIndex = values.length;
131
+ }
132
+ }
133
+ if (startIndex < values.length) {
134
+ // Process new wire events in chronological order.
135
+ for (let i = startIndex; i < values.length; i++) {
136
+ const event = values[i];
137
+ switch (event.eventType) {
138
+ case 0 /* TriggerAreaEventType.TAET_ENTER */:
139
+ // Update in-flight tracking before firing the callback.
140
+ data.insideTriggerers.set(event.trigger.entity, {
141
+ triggeredEntity: event.triggeredEntity,
142
+ triggeredEntityPosition: event.triggeredEntityPosition
143
+ ? { ...event.triggeredEntityPosition }
144
+ : undefined,
145
+ triggeredEntityRotation: event.triggeredEntityRotation
146
+ ? { ...event.triggeredEntityRotation }
147
+ : undefined,
148
+ eventType: event.eventType,
149
+ timestamp: event.timestamp,
150
+ trigger: event.trigger
151
+ ? {
152
+ entity: event.trigger.entity,
153
+ layers: event.trigger.layers,
154
+ position: event.trigger.position ? { ...event.trigger.position } : undefined,
155
+ rotation: event.trigger.rotation ? { ...event.trigger.rotation } : undefined,
156
+ scale: event.trigger.scale ? { ...event.trigger.scale } : undefined
157
+ }
158
+ : undefined
159
+ });
160
+ if (data.triggerCallbackMap.has(0 /* TriggerAreaEventType.TAET_ENTER */)) {
161
+ data.triggerCallbackMap.get(0 /* TriggerAreaEventType.TAET_ENTER */)(event);
162
+ }
163
+ break;
164
+ case 2 /* TriggerAreaEventType.TAET_EXIT */:
165
+ data.insideTriggerers.delete(event.trigger.entity);
166
+ if (data.triggerCallbackMap.has(2 /* TriggerAreaEventType.TAET_EXIT */)) {
167
+ data.triggerCallbackMap.get(2 /* TriggerAreaEventType.TAET_EXIT */)(event);
168
+ }
169
+ break;
170
+ // Wire-level TAET_STAY and any unknown event types are ignored — no callback, no state mutation.
171
+ }
172
+ }
173
+ data.lastConsumedTimestamp = values[values.length - 1].timestamp;
70
174
  }
71
- // Find index of value with the lastConsumedTimestamp
72
- let i = values.length - 2;
73
- while (i >= 0 && values[i].timestamp > data.lastConsumedTimestamp)
74
- i--;
75
- // Mark the following value index as the starting point to trigger all the new value callbacks
76
- startIndex = i + 1;
77
175
  }
78
- if (startIndex >= values.length)
79
- continue;
80
- // Trigger callbacks for all the new values
81
- for (let i = startIndex; i < values.length; i++) {
82
- switch (values[i].eventType) {
83
- case 0 /* TriggerAreaEventType.TAET_ENTER */:
84
- if (!data.triggerCallbackMap.has(0 /* TriggerAreaEventType.TAET_ENTER */))
85
- continue;
86
- data.triggerCallbackMap.get(0 /* TriggerAreaEventType.TAET_ENTER */)(values[i]);
87
- break;
88
- case 1 /* TriggerAreaEventType.TAET_STAY */:
89
- if (!data.triggerCallbackMap.has(1 /* TriggerAreaEventType.TAET_STAY */))
90
- continue;
91
- data.triggerCallbackMap.get(1 /* TriggerAreaEventType.TAET_STAY */)(values[i]);
92
- break;
93
- case 2 /* TriggerAreaEventType.TAET_EXIT */:
94
- if (!data.triggerCallbackMap.has(2 /* TriggerAreaEventType.TAET_EXIT */))
95
- continue;
96
- data.triggerCallbackMap.get(2 /* TriggerAreaEventType.TAET_EXIT */)(values[i]);
97
- break;
176
+ // -----------------------------------------------------------------------
177
+ // Pass 2: synthesize per-tick onStay callbacks
178
+ // -----------------------------------------------------------------------
179
+ // Only run if an onStay callback is registered and there are tracked triggerers.
180
+ if (data.triggerCallbackMap.has(1 /* TriggerAreaEventType.TAET_STAY */) &&
181
+ data.insideTriggerers.size > 0) {
182
+ const onStay = data.triggerCallbackMap.get(1 /* TriggerAreaEventType.TAET_STAY */);
183
+ const currentTimestamp = Date.now();
184
+ for (const [triggererEntity, cachedResult] of data.insideTriggerers) {
185
+ onStay(buildSyntheticStayResult(cachedResult, entity, triggererEntity, currentTimestamp, Transform));
98
186
  }
99
187
  }
100
- data.lastConsumedTimestamp = values[values.length - 1].timestamp;
101
188
  }
102
- // Clean up garbage entries
189
+ // Clean up garbage entries.
103
190
  garbageEntries.forEach((garbageEntity) => entitiesMap.delete(garbageEntity));
104
191
  });
105
192
  return {
@@ -22,7 +22,6 @@ import { LightSourceComponentDefinitionExtended } from './extended/LightSource';
22
22
  import { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';
23
23
  import { ParticleSystemComponentDefinitionExtended } from './extended/ParticleSystem';
24
24
  import { TagsComponentDefinitionExtended } from './manual/Tags';
25
- import { ICreatedByType } from './manual/CreatedBy';
26
25
  export * from './generated/index.gen';
27
26
  export type { GrowOnlyValueSetComponentDefinition, LastWriteWinElementSetComponentDefinition, LwwComponentGetter, GSetComponentGetter };
28
27
  export declare const Transform: LwwComponentGetter<TransformComponentExtended>;
@@ -56,9 +55,5 @@ export declare const NetworkEntity: (engine: Pick<IEngine, 'defineComponent'>) =
56
55
  * @alpha
57
56
  */
58
57
  export declare const NetworkParent: (engine: Pick<IEngine, 'defineComponent'>) => LastWriteWinElementSetComponentDefinition<INetowrkParentType>;
59
- /**
60
- * @public
61
- */
62
- export declare const CreatedBy: (engine: Pick<IEngine, 'defineComponent'>) => LastWriteWinElementSetComponentDefinition<ICreatedByType>;
63
58
  export { MediaState };
64
59
  export type { AudioAnalysisView };
@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
17
17
  return (mod && mod.__esModule) ? mod : { "default": mod };
18
18
  };
19
19
  Object.defineProperty(exports, "__esModule", { value: true });
20
- exports.MediaState = exports.CreatedBy = exports.NetworkParent = exports.NetworkEntity = exports.SyncComponents = exports.Tags = exports.Name = exports.ParticleSystem = exports.TriggerArea = exports.LightSource = exports.InputModifier = exports.VirtualCamera = exports.Tween = exports.MeshCollider = exports.MeshRenderer = exports.AudioStream = exports.AudioAnalysis = exports.AudioSource = exports.Animator = exports.Material = exports.Transform = void 0;
20
+ exports.MediaState = exports.NetworkParent = exports.NetworkEntity = exports.SyncComponents = exports.Tags = exports.Name = exports.ParticleSystem = exports.TriggerArea = exports.LightSource = exports.InputModifier = exports.VirtualCamera = exports.Tween = exports.MeshCollider = exports.MeshRenderer = exports.AudioStream = exports.AudioAnalysis = exports.AudioSource = exports.Animator = exports.Material = exports.Transform = void 0;
21
21
  const Animator_1 = require("./extended/Animator");
22
22
  const AudioSource_1 = require("./extended/AudioSource");
23
23
  const AudioAnalysis_1 = require("./extended/AudioAnalysis");
@@ -39,7 +39,6 @@ const LightSource_1 = require("./extended/LightSource");
39
39
  const TriggerArea_1 = require("./extended/TriggerArea");
40
40
  const ParticleSystem_1 = require("./extended/ParticleSystem");
41
41
  const Tags_1 = __importDefault(require("./manual/Tags"));
42
- const CreatedBy_1 = __importDefault(require("./manual/CreatedBy"));
43
42
  __exportStar(require("./generated/index.gen"), exports);
44
43
  /* @__PURE__ */
45
44
  const Transform = (engine) => (0, Transform_1.defineTransformComponent)(engine);
@@ -101,15 +100,12 @@ exports.SyncComponents = SyncComponents;
101
100
  /**
102
101
  * @alpha
103
102
  */
103
+ /* @__PURE__ */
104
104
  const NetworkEntity = (engine) => (0, NetworkEntity_1.default)(engine);
105
105
  exports.NetworkEntity = NetworkEntity;
106
106
  /**
107
107
  * @alpha
108
108
  */
109
+ /* @__PURE__ */
109
110
  const NetworkParent = (engine) => (0, NetworkParent_1.default)(engine);
110
111
  exports.NetworkParent = NetworkParent;
111
- /**
112
- * @public
113
- */
114
- const CreatedBy = (engine) => (0, CreatedBy_1.default)(engine);
115
- exports.CreatedBy = CreatedBy;
@@ -1,6 +1,5 @@
1
1
  import { LastWriteWinElementSetComponentDefinition, IEngine } from '../../engine';
2
2
  import { Entity } from '../../engine/entity';
3
- import type { ISchema } from '../../schemas/ISchema';
4
3
  import type { Vector3Type } from '../../schemas/custom/Vector3';
5
4
  /**
6
5
  * @public
@@ -25,10 +24,6 @@ export interface TransformComponentExtended extends TransformComponent {
25
24
  */
26
25
  localToWorldDirection(entity: Entity, localDirection: Vector3Type): Vector3Type;
27
26
  }
28
- /**
29
- * @public
30
- */
31
- export declare const COMPONENT_ID = 1;
32
27
  /**
33
28
  * @public
34
29
  */
@@ -51,10 +46,6 @@ export type TransformType = {
51
46
  };
52
47
  parent?: Entity;
53
48
  };
54
- /** @public */
55
- export declare const TRANSFORM_LENGTH = 44;
56
- /** @public */
57
- export declare const TransformSchema: ISchema<TransformType>;
58
49
  /**
59
50
  * @public
60
51
  */
@@ -29,12 +29,12 @@ exports.defineTransformComponent = exports.TransformSchema = exports.TRANSFORM_L
29
29
  // getters via __importStar in CJS), so by the time methods are called all exports are available.
30
30
  const treeHelpers = __importStar(require("../../runtime/helpers/tree"));
31
31
  /**
32
- * @public
32
+ * @internal
33
33
  */
34
34
  exports.COMPONENT_ID = 1;
35
- /** @public */
35
+ /** @internal */
36
36
  exports.TRANSFORM_LENGTH = 44;
37
- /** @public */
37
+ /** @internal */
38
38
  exports.TransformSchema = {
39
39
  serialize(value, builder) {
40
40
  const ptr = builder.incrementWriteOffset(exports.TRANSFORM_LENGTH);
@@ -13,7 +13,6 @@ export type { TagsComponentDefinitionExtended, TagsType } from './manual/Tags';
13
13
  export type { ISyncComponents, ISyncComponentsType } from './manual/SyncComponents';
14
14
  export type { INetowrkEntity, INetowrkEntityType } from './manual/NetworkEntity';
15
15
  export type { INetowrkParent, INetowrkParentType } from './manual/NetworkParent';
16
- export type { ICreatedBy, ICreatedByType } from './manual/CreatedBy';
17
16
  export type { InputModifierHelper, InputModifierComponentDefinitionExtended } from './extended/InputModifier';
18
17
  export type { LightSourceHelper, LightSourceComponentDefinitionExtended } from './extended/LightSource';
19
18
  export type { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';