@dcl/ecs 7.22.6-25007982108.commit-83012ab → 7.22.6-25321038582.commit-63ddb3f

package/dist-cjs/engine/grow-only-value-set-component-definition.js

@@ -5,6 +5,7 @@ const ByteBuffer_1 = require("../serialization/ByteBuffer");
 const crdt_1 = require("../serialization/crdt");
 const invariant_1 = require("../runtime/invariant");
 const emptyReadonlySet = freezeSet(new Set());
+const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
 function frozenError() {
     throw new Error('The set is frozen');
 }
@@ -15,7 +16,7 @@ function freezeSet(set) {
     return set;
 }
 function sortByTimestamp(a, b) {
-    return a.timestamp > b.timestamp ? 1 : -1;
+    return a.timestamp - b.timestamp;
 }
 /**
  * @internal
@@ -25,6 +26,7 @@ function createValueSetComponentDefinitionFromSchema(componentName, componentId,
     const dirtyIterator = new Set();
     const queuedCommands = [];
     const onChangeCallbacks = new Map();
+    const validateCallbacks = new Map();
     // only sort the array if the latest (N) element has a timestamp <= N-1
     function shouldSort(row) {
         const len = row.raw.length;
@@ -83,8 +85,11 @@ function createValueSetComponentDefinitionFromSchema(componentName, componentId,
         has(entity) {
             return data.has(entity);
         },
-        entityDeleted(entity) {
+        entityDeleted(entity, markAsDirty) {
             data.delete(entity);
+            if (markAsDirty) {
+                // For grow-only sets, we don't need to mark as dirty since deletion doesn't generate CRDT messages
+            }
         },
         get(entity) {
             const values = data.get(entity);
@@ -155,6 +160,44 @@ function createValueSetComponentDefinitionFromSchema(componentName, componentId,
             for (const cb of cbs) {
                 cb(value);
             }
+        },
+        __dry_run_updateFromCrdt(_body) {
+            return crdt_1.ProcessMessageResultType.StateUpdatedData;
+        },
+        validateBeforeChange(entityOrCb, cb) {
+            if (arguments.length === 1) {
+                // Second overload: just callback (global validation)
+                validateCallbacks.set(__GLOBAL_ENTITY, entityOrCb);
+            }
+            else {
+                if (cb) {
+                    validateCallbacks.set(entityOrCb, cb);
+                }
+            }
+        },
+        __run_validateBeforeChange(entity, newValue, senderAddress, createdBy) {
+            const cb = entity && validateCallbacks.get(entity);
+            const globalCb = validateCallbacks.get(__GLOBAL_ENTITY);
+            const currentValue = [...this.get(entity).values()];
+            const value = { entity, currentValue: currentValue, newValue, senderAddress, createdBy };
+            const globalResult = globalCb?.(value) ?? true;
+            const entityResult = (globalResult && cb?.(value)) ?? true;
+            return globalResult && entityResult;
+        },
+        getCrdtState(entity) {
+            const row = data.get(entity);
+            if (!row || row.raw.length === 0) {
+                return null;
+            }
+            // For GrowOnlySet, we need to return the complete CRDT messages for all values
+            // This is complex because GrowOnlySet uses APPEND messages, not a single PUT
+            // For now, return null to indicate this component type doesn't support simple corrections
+            return null;
+        },
+        __forceUpdateFromCrdt(_msg) {
+            // GrowOnlySet doesn't support authoritative corrections in the same way as LWW
+            // since it uses APPEND_VALUE messages instead of PUT_COMPONENT messages
+            return [null, undefined];
         }
     };
     return ret;

package/dist-cjs/engine/input.d.ts

@@ -32,12 +32,6 @@ export type IInputSystem = {
      * @returns the input command info or undefined if there is no command in the last tick-update
      */
     getInputCommand: (inputAction: InputAction, pointerEventType: PointerEventType, entity?: Entity) => PBPointerEventsResult | null;
-    /**
-     * @public
-     * Get an ordered iterator over events received within the current frame.
-     * @returns the iterator
-     */
-    getInputCommands: () => Generator<PBPointerEventsResult>;
 };
 /**
  * @public

package/dist-cjs/engine/input.js

@@ -144,8 +144,9 @@ function createInputSystem(engine) {
         }
         if (!up || !down)
             return null;
-        // If the DOWN command has happen before the UP commands, it means that that a clicked has happen
-        if (down.timestamp < up.timestamp && timestampIsCurrentFrame(up.timestamp)) {
+        // If the DOWN command has happened before or at the same time as the UP command, a click has happened.
+        // Same-timestamp is possible when both events are produced within the same renderer tick.
+        if (down.timestamp <= up.timestamp && timestampIsCurrentFrame(up.timestamp)) {
             return { up, down };
         }
         return null;
@@ -211,18 +212,12 @@ function createInputSystem(engine) {
     function isPressed(inputAction) {
         return globalState.buttonState.get(inputAction)?.state === 1 /* PointerEventType.PET_DOWN */;
     }
-    function* getInputCommands() {
-        for (let i = globalState.thisFrameCommands.length - 1; i >= 0; i--) {
-            yield globalState.thisFrameCommands[i];
-        }
-    }
     return {
         isPressed,
         getClick,
         getInputCommand,
         isClicked,
-        isTriggered,
-        getInputCommands
+        isTriggered
     };
 }
 exports.createInputSystem = createInputSystem;

package/dist-cjs/engine/lww-element-set-component-definition.d.ts

@@ -1,8 +1,10 @@
 import { ISchema } from '../schemas';
 import { ByteBuffer } from '../serialization/ByteBuffer';
-import { PutComponentMessageBody, DeleteComponentMessageBody, CrdtMessageBody } from '../serialization/crdt';
+import { PutComponentMessageBody, DeleteComponentMessageBody, ProcessMessageResultType, CrdtMessageBody, PutNetworkComponentMessageBody, DeleteComponentNetworkMessageBody, AuthoritativePutComponentMessageBody } from '../serialization/crdt';
 import { Entity } from './entity';
 export declare function incrementTimestamp(entity: Entity, timestamps: Map<Entity, number>): number;
 export declare function createDumpLwwFunctionFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (buffer: ByteBuffer, filterEntity?: ((entity: Entity) => boolean) | undefined) => void;
-export declare function createUpdateLwwFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (msg: CrdtMessageBody) => [null | PutComponentMessageBody | DeleteComponentMessageBody, any];
-export declare function createGetCrdtMessagesForLww(componentId: number, timestamps: Map<Entity, number>, dirtyIterator: Set<Entity>, schema: Pick<ISchema<any>, 'serialize'>, data: Map<Entity, unknown>): () => Generator<PutComponentMessageBody | DeleteComponentMessageBody, void, unknown>;
+export declare function createCrdtRuleValidator(timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>, lastSentData: Map<Entity, Uint8Array>): (message: PutComponentMessageBody | DeleteComponentMessageBody | PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody) => ProcessMessageResultType;
+export declare function createForceUpdateLwwFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (msg: AuthoritativePutComponentMessageBody) => [null, any];
+export declare function createUpdateLwwFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>, lastSentData: Map<Entity, Uint8Array>): (msg: CrdtMessageBody) => [null | PutComponentMessageBody | DeleteComponentMessageBody, any];
+export declare function createGetCrdtMessagesForLww(componentId: number, timestamps: Map<Entity, number>, dirtyIterator: Set<Entity>, schema: Pick<ISchema<any>, 'serialize'>, data: Map<Entity, unknown>, lastSentData: Map<Entity, Uint8Array>): () => Generator<PutComponentMessageBody | DeleteComponentMessageBody, void, unknown>;

package/dist-cjs/engine/lww-element-set-component-definition.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createComponentDefinitionFromSchema = exports.createGetCrdtMessagesForLww = exports.createUpdateLwwFromCrdt = exports.createDumpLwwFunctionFromCrdt = exports.incrementTimestamp = void 0;
+exports.createComponentDefinitionFromSchema = exports.createGetCrdtMessagesForLww = exports.createUpdateLwwFromCrdt = exports.createForceUpdateLwwFromCrdt = exports.createCrdtRuleValidator = exports.createDumpLwwFunctionFromCrdt = exports.incrementTimestamp = void 0;
 const ByteBuffer_1 = require("../serialization/ByteBuffer");
 const crdt_1 = require("../serialization/crdt");
 const utils_1 = require("../systems/crdt/utils");
@@ -35,16 +35,12 @@ function createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, data) {
     };
 }
 exports.createDumpLwwFunctionFromCrdt = createDumpLwwFunctionFromCrdt;
-function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
+const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
+function createCrdtRuleValidator(timestamps, schema, data, lastSentData) {
     /**
-     * Process the received message only if the lamport number recieved is higher
-     * than the stored one. If its lower, we spread it to the network to correct the peer.
-     * If they are equal, the bigger raw data wins.
-  
-      * Returns the recieved data if the lamport number was bigger than ours.
-      * If it was an outdated message, then we return void
-      * @public
-      */
+     * Shared CRDT conflict resolution logic
+     * @public
+     */
     function crdtRuleForCurrentState(message) {
         const { entityId, timestamp } = message;
         const currentTimestamp = timestamps.get(entityId);
@@ -54,7 +50,6 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
         }
         // Outdated Message. Resend our state message through the wire.
         if (currentTimestamp > timestamp) {
-            // console.log('2', currentTimestamp, timestamp)
             return crdt_1.ProcessMessageResultType.StateOutdatedTimestamp;
         }
         // Deletes are idempotent
@@ -71,7 +66,6 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
             currentDataGreater = (0, utils_1.dataCompare)(null, message.data);
         }
         // Same data, same timestamp. Weirdo echo message.
-        // console.log('3', currentDataGreater, writeBuffer.toBinary(), (message as any).data || null)
         if (currentDataGreater === 0) {
             return crdt_1.ProcessMessageResultType.NoChanges;
         }
@@ -80,10 +74,37 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
             return crdt_1.ProcessMessageResultType.StateOutdatedData;
         }
         else {
-            // Curent data is lower
+            // Current data is lower
             return crdt_1.ProcessMessageResultType.StateUpdatedData;
         }
     }
+    return crdtRuleForCurrentState;
+}
+exports.createCrdtRuleValidator = createCrdtRuleValidator;
+function createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
+    /**
+     * Force update component state regardless of timestamp - used for server authoritative messages
+     */
+    return (msg) => {
+        const buffer = new ByteBuffer_1.ReadWriteByteBuffer(msg.data);
+        const deserializedValue = schema.deserialize(buffer);
+        data.set(msg.entityId, deserializedValue);
+        timestamps.set(msg.entityId, msg.timestamp);
+        return [null, deserializedValue];
+    };
+}
+exports.createForceUpdateLwwFromCrdt = createForceUpdateLwwFromCrdt;
+function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, lastSentData) {
+    /**
+     * Process the received message only if the lamport number recieved is higher
+     * than the stored one. If its lower, we spread it to the network to correct the peer.
+     * If they are equal, the bigger raw data wins.
+  
+      * Returns the recieved data if the lamport number was bigger than ours.
+      * If it was an outdated message, then we return void
+      * @public
+      */
+    const crdtRuleForCurrentState = createCrdtRuleValidator(timestamps, schema, data, lastSentData);
     return (msg) => {
         /* istanbul ignore next */
         if (msg.type !== crdt_1.CrdtMessageType.PUT_COMPONENT &&
@@ -101,9 +122,11 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
                 if (msg.type === crdt_1.CrdtMessageType.PUT_COMPONENT || msg.type === crdt_1.CrdtMessageType.PUT_COMPONENT_NETWORK) {
                     const buf = new ByteBuffer_1.ReadWriteByteBuffer(msg.data);
                     data.set(entity, schema.deserialize(buf));
+                    lastSentData.set(entity, new Uint8Array(msg.data));
                 }
                 else {
                     data.delete(entity);
+                    lastSentData.delete(entity);
                 }
                 return [null, data.get(entity)];
             }
@@ -140,23 +163,34 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
     };
 }
 exports.createUpdateLwwFromCrdt = createUpdateLwwFromCrdt;
-function createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data) {
+function createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data, lastSentData) {
     return function* () {
+        const writeBuffer = new ByteBuffer_1.ReadWriteByteBuffer();
         for (const entity of dirtyIterator) {
-            const newTimestamp = incrementTimestamp(entity, timestamps);
             if (data.has(entity)) {
-                const writeBuffer = new ByteBuffer_1.ReadWriteByteBuffer();
+                writeBuffer.resetBuffer();
                 schema.serialize(data.get(entity), writeBuffer);
+                // Compare against last-sent snapshot using the zero-copy subarray view.
+                // Only allocate a copy when bytes actually differ.
+                const previousBytes = lastSentData.get(entity);
+                if (previousBytes && (0, utils_1.dataCompare)(writeBuffer.toBinary(), previousBytes) === 0) {
+                    continue;
+                }
+                const currentBytes = writeBuffer.toCopiedBinary();
+                const newTimestamp = incrementTimestamp(entity, timestamps);
+                lastSentData.set(entity, currentBytes);
                 const msg = {
                     type: crdt_1.CrdtMessageType.PUT_COMPONENT,
                     componentId,
                     entityId: entity,
-                    data: writeBuffer.toBinary(),
+                    data: currentBytes,
                     timestamp: newTimestamp
                 };
                 yield msg;
             }
             else {
+                lastSentData.delete(entity);
+                const newTimestamp = incrementTimestamp(entity, timestamps);
                 const msg = {
                     type: crdt_1.CrdtMessageType.DELETE_COMPONENT,
                     componentId,
@@ -177,7 +211,9 @@ function createComponentDefinitionFromSchema(componentName, componentId, schema)
     const data = new Map();
     const dirtyIterator = new Set();
     const timestamps = new Map();
+    const lastSentData = new Map();
     const onChangeCallbacks = new Map();
+    const validateCallbacks = new Map();
     return {
         get componentId() {
             return componentId;
@@ -198,12 +234,14 @@ function createComponentDefinitionFromSchema(componentName, componentId, schema)
             if (data.delete(entity) && markAsDirty) {
                 dirtyIterator.add(entity);
             }
+            lastSentData.delete(entity);
             return component || null;
         },
         entityDeleted(entity, markAsDirty) {
             if (data.delete(entity) && markAsDirty) {
                 dirtyIterator.add(entity);
             }
+            lastSentData.delete(entity);
         },
         getOrNull(entity) {
             const component = data.get(entity);
@@ -230,6 +268,7 @@ function createComponentDefinitionFromSchema(componentName, componentId, schema)
             const usedValue = value === undefined ? schema.create() : schema.extend ? schema.extend(value) : value;
             data.set(entity, usedValue);
             dirtyIterator.add(entity);
+            lastSentData.delete(entity);
             return usedValue;
         },
         getMutableOrNull(entity) {
@@ -267,9 +306,41 @@ function createComponentDefinitionFromSchema(componentName, componentId, schema)
                 yield entity;
             }
         },
-        getCrdtUpdates: createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data),
-        updateFromCrdt: createUpdateLwwFromCrdt(componentId, timestamps, schema, data),
+        getCrdtUpdates: createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data, lastSentData),
+        updateFromCrdt: createUpdateLwwFromCrdt(componentId, timestamps, schema, data, lastSentData),
+        __forceUpdateFromCrdt: createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data),
+        __dry_run_updateFromCrdt: createCrdtRuleValidator(timestamps, schema, data, lastSentData),
         dumpCrdtStateToBuffer: createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, data),
+        validateBeforeChange(entityOrCb, cb) {
+            if (arguments.length === 1) {
+                // Second overload: just callback (global validation)
+                validateCallbacks.set(__GLOBAL_ENTITY, entityOrCb);
+            }
+            else {
+                if (cb) {
+                    validateCallbacks.set(entityOrCb, cb);
+                }
+            }
+        },
+        __run_validateBeforeChange(entity, newValue, senderAddress, createdBy) {
+            const cb = entity && validateCallbacks.get(entity);
+            const globalCb = validateCallbacks.get(__GLOBAL_ENTITY);
+            const currentValue = data.get(entity);
+            const value = { entity, currentValue, newValue, senderAddress, createdBy };
+            const globalResult = globalCb?.(value) ?? true;
+            const entityResult = (globalResult && cb?.(value)) ?? true;
+            return globalResult && entityResult;
+        },
+        getCrdtState(entity) {
+            const componentData = data.get(entity);
+            const timestamp = timestamps.get(entity);
+            if (componentData && timestamp !== undefined) {
+                const buffer = new ByteBuffer_1.ReadWriteByteBuffer();
+                schema.serialize((0, readonly_1.deepReadonly)(componentData), buffer);
+                return { data: buffer.toBinary(), timestamp };
+            }
+            return null;
+        },
         onChange(entity, cb) {
             const cbs = onChangeCallbacks.get(entity) ?? [];
             cbs.push(cb);

package/dist-cjs/index.d.ts

@@ -1,9 +1,9 @@
 export * from './engine';
 export * from './schemas';
+export * from './runtime/globals';
 export * from './runtime/initialization';
 export * from './runtime/types';
 export * from './runtime/helpers';
-export * from './runtime/globals';
 export { cyclicParentingChecker } from './systems/cyclicParentingChecker';
 export * from './systems/events';
 export * from './systems/raycast';
@@ -12,9 +12,10 @@ export * from './systems/assetLoad';
 export * from './systems/async-task';
 export * from './systems/tween';
 export * from './systems/triggerArea';
+export * from './systems/physics';
 export * from './engine/entity';
 export * from './components/types';
-import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended } from './components/types';
+import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended, ParticleSystemComponentDefinitionExtended, ICreatedBy } from './components/types';
 import { NameComponent } from './components/manual/Name';
 import { TagsComponentDefinitionExtended } from './components/manual/Tags';
 export declare const Transform: TransformComponentExtended;
@@ -31,6 +32,7 @@ export declare const VirtualCamera: VirtualCameraComponentDefinitionExtended;
 export declare const InputModifier: InputModifierComponentDefinitionExtended;
 export declare const LightSource: LightSourceComponentDefinitionExtended;
 export declare const TriggerArea: TriggerAreaComponentDefinitionExtended;
+export declare const ParticleSystem: ParticleSystemComponentDefinitionExtended;
 /**
  * @alpha
  * This is going to be used for sync components through a server.
@@ -47,6 +49,7 @@ export declare const NetworkEntity: INetowrkEntity;
  * Tag a entity to be syncronized through comms
  */
 export declare const NetworkParent: INetowrkParent;
+export declare const CreatedBy: ICreatedBy;
 export * from './components/generated/global.gen';
 export * from './components/generated/types.gen';
 export * from './serialization/crdt';

package/dist-cjs/index.js

@@ -26,14 +26,14 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkParent = exports.NetworkEntity = exports.SyncComponents = exports.TriggerArea = exports.LightSource = exports.InputModifier = exports.VirtualCamera = exports.Tween = exports.Tags = exports.Name = exports.MeshCollider = exports.MeshRenderer = exports.Material = exports.AudioStream = exports.AudioSource = exports.Animator = exports.Transform = exports.components = exports.cyclicParentingChecker = void 0;
+exports.CreatedBy = exports.NetworkParent = exports.NetworkEntity = exports.SyncComponents = exports.ParticleSystem = exports.TriggerArea = exports.LightSource = exports.InputModifier = exports.VirtualCamera = exports.Tween = exports.Tags = exports.Name = exports.MeshCollider = exports.MeshRenderer = exports.Material = exports.AudioStream = exports.AudioSource = exports.Animator = exports.Transform = exports.components = exports.cyclicParentingChecker = void 0;
 // The order of the following imports matters. Please do not auto-sort
 __exportStar(require("./engine"), exports);
 __exportStar(require("./schemas"), exports);
+__exportStar(require("./runtime/globals"), exports);
 __exportStar(require("./runtime/initialization"), exports);
 __exportStar(require("./runtime/types"), exports);
 __exportStar(require("./runtime/helpers"), exports);
-__exportStar(require("./runtime/globals"), exports);
 var cyclicParentingChecker_1 = require("./systems/cyclicParentingChecker");
 Object.defineProperty(exports, "cyclicParentingChecker", { enumerable: true, get: function () { return cyclicParentingChecker_1.cyclicParentingChecker; } });
 __exportStar(require("./systems/events"), exports);
@@ -43,6 +43,7 @@ __exportStar(require("./systems/assetLoad"), exports);
 __exportStar(require("./systems/async-task"), exports);
 __exportStar(require("./systems/tween"), exports);
 __exportStar(require("./systems/triggerArea"), exports);
+__exportStar(require("./systems/physics"), exports);
 __exportStar(require("./engine/entity"), exports);
 __exportStar(require("./components/types"), exports);
 // @internal
@@ -64,6 +65,8 @@ exports.VirtualCamera = components.VirtualCamera(initialization_1.engine);
 exports.InputModifier = components.InputModifier(initialization_1.engine);
 exports.LightSource = components.LightSource(initialization_1.engine);
 exports.TriggerArea = components.TriggerArea(initialization_1.engine);
+exports.ParticleSystem = 
+/* @__PURE__*/ components.ParticleSystem(initialization_1.engine);
 /**
  * @alpha
  * This is going to be used for sync components through a server.
@@ -80,6 +83,7 @@ exports.NetworkEntity = components.NetworkEntity(initialization_1.engine);
  * Tag a entity to be syncronized through comms
  */
 exports.NetworkParent = components.NetworkParent(initialization_1.engine);
+exports.CreatedBy = components.CreatedBy(initialization_1.engine);
 // export components for global engine
 __exportStar(require("./components/generated/global.gen"), exports);
 __exportStar(require("./components/generated/types.gen"), exports);

package/dist-cjs/runtime/globals.d.ts

@@ -1,6 +1,5 @@
 /**
- * Utilities for standardized globalThis access.
- * @public
+ * Internal utilities for standardized globalThis access.
  */
 /**
  * Type-safe globalThis property access.

package/dist-cjs/runtime/globals.js

@@ -1,7 +1,6 @@
 "use strict";
 /**
- * Utilities for standardized globalThis access.
- * @public
+ * Internal utilities for standardized globalThis access.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setGlobalPolyfill = exports.getGlobal = void 0;

package/dist-cjs/runtime/helpers/index.d.ts

@@ -1,3 +1,4 @@
 export * from './coordinates';
 export * from './tree';
+export * from './vectors';
 export { createTimers, Timers, TimerId, TimerCallback } from './timers';

package/dist-cjs/runtime/helpers/index.js

@@ -17,5 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTimers = void 0;
 __exportStar(require("./coordinates"), exports);
 __exportStar(require("./tree"), exports);
+__exportStar(require("./vectors"), exports);
 var timers_1 = require("./timers");
 Object.defineProperty(exports, "createTimers", { enumerable: true, get: function () { return timers_1.createTimers; } });

package/dist-cjs/runtime/helpers/tree.d.ts

@@ -2,6 +2,12 @@ import { Entity } from '../../engine/entity';
 import { ComponentDefinition, IEngine } from '../../engine';
 import { Vector3Type } from '../../schemas/custom/Vector3';
 import { QuaternionType } from '../../schemas/custom/Quaternion';
+/**
+ * @public
+ * Rotate a vector by a quaternion
+ * Uses the formula: v' = q * v * q^(-1), optimized version
+ */
+export declare function rotateVectorByQuaternion(v: Vector3Type, q: QuaternionType): Vector3Type;
 /**
  * Get an iterator of entities that follow a tree structure for a component
  * @public

package/dist-cjs/runtime/helpers/tree.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWorldRotation = exports.getWorldPosition = exports.getEntitiesWithParent = exports.removeEntityWithChildren = exports.getComponentEntityTree = void 0;
+exports.getWorldRotation = exports.getWorldPosition = exports.getEntitiesWithParent = exports.removeEntityWithChildren = exports.getComponentEntityTree = exports.rotateVectorByQuaternion = void 0;
 const components = __importStar(require("../../components"));
 /**
  * @internal
@@ -61,7 +61,7 @@ function multiplyQuaternions(q1, q2) {
     };
 }
 /**
- * @internal
+ * @public
  * Rotate a vector by a quaternion
  * Uses the formula: v' = q * v * q^(-1), optimized version
  */
@@ -80,6 +80,7 @@ function rotateVectorByQuaternion(v, q) {
         z: iz * qw + iw * -qz + ix * -qy - iy * -qx
     };
 }
+exports.rotateVectorByQuaternion = rotateVectorByQuaternion;
 /** @internal Identity transform values */
 const IDENTITY_POSITION = { x: 0, y: 0, z: 0 };
 const IDENTITY_ROTATION = { x: 0, y: 0, z: 0, w: 1 };

package/dist-cjs/runtime/helpers/vectors.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Vector3 = void 0;
+/**
+ * Lightweight Vector3 math utilities for internal use.
+ * Mirrors the subset of @dcl/ecs-math Vector3 API used by the physics helpers.
+ *
+ * TEMPORARY WORKAROUND: @dcl/ecs-math ships ESM-only, which breaks the dist-cjs build.
+ * The proper fix is to add a CJS build to @dcl/ecs-math upstream, then replace this
+ * file with `import { Vector3 } from '@dcl/ecs-math'`.
+ *
+ * @internal
+ */
+exports.Vector3 = {
+    add(a, b) {
+        return { x: a.x + b.x, y: a.y + b.y, z: a.z + b.z };
+    },
+    subtract(a, b) {
+        return { x: a.x - b.x, y: a.y - b.y, z: a.z - b.z };
+    },
+    scale(v, s) {
+        return { x: v.x * s, y: v.y * s, z: v.z * s };
+    },
+    length(v) {
+        return Math.sqrt(v.x * v.x + v.y * v.y + v.z * v.z);
+    },
+    normalize(v) {
+        const len = exports.Vector3.length(v);
+        if (len === 0)
+            return { x: 0, y: 0, z: 0 };
+        return { x: v.x / len, y: v.y / len, z: v.z / len };
+    },
+    equals(a, b) {
+        return a.x === b.x && a.y === b.y && a.z === b.z;
+    },
+    equalsToFloats(v, x, y, z) {
+        return v.x === x && v.y === y && v.z === z;
+    }
+};

package/dist-cjs/runtime/initialization/index.d.ts

@@ -12,6 +12,7 @@ import { AssetLoadLoadingStateSystem } from '../../systems/assetLoad';
 import { TweenSystem } from '../../systems/tween';
 import { TriggerAreaEventsSystem } from '../../systems/triggerArea';
 import { createTimers, Timers } from '../helpers/timers';
+import { PhysicsSystem } from '../../systems/physics';
 /**
  * @public
  * The engine is the part of the scene that sits in the middle and manages all of the other parts.
@@ -77,6 +78,12 @@ export { TriggerAreaEventsSystem };
  */
 export declare const timers: Timers;
 export { Timers, createTimers };
+/**
+ * @public
+ * Physics helpers for applying impulses and forces to the player.
+ */
+export declare const Physics: PhysicsSystem;
+export { PhysicsSystem };
 /**
  * @public
  * Runs an async function

package/dist-cjs/runtime/initialization/index.js

@@ -4,7 +4,7 @@
  * init and it'll be changing.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeTask = exports.createTimers = exports.timers = exports.triggerAreaEventsSystem = exports.tweenSystem = exports.assetLoadLoadingStateSystem = exports.videoEventsSystem = exports.raycastSystem = exports.pointerEventsSystem = exports.inputSystem = exports.engine = void 0;
+exports.executeTask = exports.Physics = exports.createTimers = exports.timers = exports.triggerAreaEventsSystem = exports.tweenSystem = exports.assetLoadLoadingStateSystem = exports.videoEventsSystem = exports.raycastSystem = exports.pointerEventsSystem = exports.inputSystem = exports.engine = void 0;
 const engine_1 = require("../../engine");
 const async_task_1 = require("../../systems/async-task");
 const events_1 = require("../../systems/events");
@@ -18,6 +18,7 @@ const triggerArea_1 = require("../../systems/triggerArea");
 const timers_1 = require("../helpers/timers");
 Object.defineProperty(exports, "createTimers", { enumerable: true, get: function () { return timers_1.createTimers; } });
 const globals_1 = require("../globals");
+const physics_1 = require("../../systems/physics");
 /**
  * @public
  * The engine is the part of the scene that sits in the middle and manages all of the other parts.
@@ -80,6 +81,11 @@ exports.timers = (0, timers_1.createTimers)(exports.engine);
 (0, globals_1.setGlobalPolyfill)('clearTimeout', exports.timers.clearTimeout);
 (0, globals_1.setGlobalPolyfill)('setInterval', exports.timers.setInterval);
 (0, globals_1.setGlobalPolyfill)('clearInterval', exports.timers.clearInterval);
+/**
+ * @public
+ * Physics helpers for applying impulses and forces to the player.
+ */
+exports.Physics = (0, physics_1.createPhysicsSystem)(exports.engine);
 /**
  * Adds pointer event collider system only in DEV env
  */

package/dist-cjs/serialization/crdt/authoritativePutComponent.d.ts

@@ -0,0 +1,15 @@
+import { Entity } from '../../engine/entity';
+import { ByteBuffer } from '../ByteBuffer';
+import { AuthoritativePutComponentMessage } from './types';
+/**
+ * @public
+ */
+export declare namespace AuthoritativePutComponentOperation {
+    const MESSAGE_HEADER_LENGTH = 16;
+    /**
+     * Call this function for an optimal writing data passing the ByteBuffer
+     *  already allocated
+     */
+    function write(entity: Entity, timestamp: number, componentId: number, data: Uint8Array, buf: ByteBuffer): void;
+    function read(buf: ByteBuffer): AuthoritativePutComponentMessage | null;
+}