@dcl/ecs 7.21.1-22918726402.commit-ee210ee → 7.21.1-23252789519.commit-9f806e1

package/dist/components/index.d.ts

@@ -19,7 +19,6 @@ import { InputModifierComponentDefinitionExtended } from './extended/InputModifi
 import { LightSourceComponentDefinitionExtended } from './extended/LightSource';
 import { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';
 import { TagsComponentDefinitionExtended } from './manual/Tags';
-import { ICreatedByType } from './manual/CreatedBy';
 export * from './generated/index.gen';
 export type { GrowOnlyValueSetComponentDefinition, LastWriteWinElementSetComponentDefinition, LwwComponentGetter, GSetComponentGetter };
 export declare const Transform: LwwComponentGetter<TransformComponentExtended>;
@@ -51,8 +50,4 @@ export declare const NetworkEntity: (engine: Pick<IEngine, 'defineComponent'>) =
  * @alpha
  */
 export declare const NetworkParent: (engine: Pick<IEngine, 'defineComponent'>) => LastWriteWinElementSetComponentDefinition<INetowrkParentType>;
-/**
- * @public
- */
-export declare const CreatedBy: (engine: Pick<IEngine, 'defineComponent'>) => LastWriteWinElementSetComponentDefinition<ICreatedByType>;
 export { MediaState };

package/dist/components/index.js

@@ -16,7 +16,6 @@ import { defineInputModifierComponent } from './extended/InputModifier';
 import { defineLightSourceComponent } from './extended/LightSource';
 import { defineTriggerAreaComponent } from './extended/TriggerArea';
 import defineTagsComponent from './manual/Tags';
-import defineCreatedBy from './manual/CreatedBy';
 export * from './generated/index.gen';
 /* @__PURE__ */
 export const Transform = (engine) => defineTransformComponent(engine);
@@ -57,13 +56,11 @@ export const SyncComponents = (engine) => defineSyncComponent(engine);
 /**
  * @alpha
  */
+/* @__PURE__ */
 export const NetworkEntity = (engine) => defineNetworkEntity(engine);
 /**
  * @alpha
  */
+/* @__PURE__ */
 export const NetworkParent = (engine) => defineNetworkParent(engine);
-/**
- * @public
- */
-export const CreatedBy = (engine) => defineCreatedBy(engine);
 export { MediaState };

package/dist/components/manual/Transform.d.ts

@@ -1,6 +1,6 @@
 import { LastWriteWinElementSetComponentDefinition, IEngine } from '../../engine';
 import { Entity } from '../../engine/entity';
-import type { ISchema } from '../../schemas/ISchema';
+import type { Vector3Type } from '../../schemas/custom/Vector3';
 /**
  * @public
  */
@@ -11,11 +11,19 @@ export type TransformComponent = LastWriteWinElementSetComponentDefinition<Trans
 export interface TransformComponentExtended extends TransformComponent {
     create(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
     createOrReplace(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
+    /**
+     * Transforms a direction vector from an entity's local coordinate space
+     * to world space, accounting for the full parent hierarchy.
+     *
+     * This applies only rotation (not translation or scale) — suitable for
+     * direction vectors like force/impulse directions.
+     *
+     * @param entity - The source entity whose local space defines the direction
+     * @param localDirection - Direction vector in the entity's local coordinates
+     * @returns The direction vector in world coordinates
+     */
+    localToWorldDirection(entity: Entity, localDirection: Vector3Type): Vector3Type;
 }
-/**
- * @public
- */
-export declare const COMPONENT_ID = 1;
 /**
  * @public
  */
@@ -38,10 +46,6 @@ export type TransformType = {
     };
     parent?: Entity;
 };
-/** @public */
-export declare const TRANSFORM_LENGTH = 44;
-/** @public */
-export declare const TransformSchema: ISchema<TransformType>;
 /**
  * @public
  */

package/dist/components/manual/Transform.js

@@ -1,10 +1,14 @@
+// Use import * to safely handle circular dependency (tree.ts → components → Transform.ts → tree.ts).
+// With import *, the namespace object's properties are resolved at access time (live bindings in ESM,
+// getters via __importStar in CJS), so by the time methods are called all exports are available.
+import * as treeHelpers from '../../runtime/helpers/tree';
 /**
- * @public
+ * @internal
  */
 export const COMPONENT_ID = 1;
-/** @public */
+/** @internal */
 export const TRANSFORM_LENGTH = 44;
-/** @public */
+/** @internal */
 export const TransformSchema = {
     serialize(value, builder) {
         const ptr = builder.incrementWriteOffset(TRANSFORM_LENGTH);
@@ -101,6 +105,10 @@ export function defineTransformComponent(engine) {
         },
         createOrReplace(entity, val) {
             return transformDef.createOrReplace(entity, TransformSchema.extend(val));
+        },
+        localToWorldDirection(entity, localDirection) {
+            const worldRotation = treeHelpers.getWorldRotation(engine, entity);
+            return treeHelpers.rotateVectorByQuaternion(localDirection, worldRotation);
         }
     };
 }

package/dist/components/types.d.ts

@@ -12,7 +12,6 @@ export type { TagsComponentDefinitionExtended, TagsType } from './manual/Tags';
 export type { ISyncComponents, ISyncComponentsType } from './manual/SyncComponents';
 export type { INetowrkEntity, INetowrkEntityType } from './manual/NetworkEntity';
 export type { INetowrkParent, INetowrkParentType } from './manual/NetworkParent';
-export type { ICreatedBy, ICreatedByType } from './manual/CreatedBy';
 export type { InputModifierHelper, InputModifierComponentDefinitionExtended } from './extended/InputModifier';
 export type { LightSourceHelper, LightSourceComponentDefinitionExtended } from './extended/LightSource';
 export type { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';

package/dist/engine/component.d.ts

@@ -1,6 +1,6 @@
 import { ISchema } from '../schemas';
 import { ByteBuffer } from '../serialization/ByteBuffer';
-import { CrdtMessageBody, DeleteComponentMessageBody, ProcessMessageResultType, PutComponentMessageBody } from '../serialization/crdt';
+import { CrdtMessageBody, DeleteComponentMessageBody, PutComponentMessageBody } from '../serialization/crdt';
 import { Entity } from './entity';
 import { DeepReadonly, DeepReadonlySet } from './readonly';
 /**
@@ -70,58 +70,7 @@ export interface BaseComponent<T> {
      * If the value is undefined, the component was deleted.
      */
     onChange(entity: Entity, cb: (value: T | undefined) => void): void;
-    /**
-     * @public
-     *
-     */
-    validateBeforeChange(entity: Entity, cb: ValidateCallback<T>): void;
-    validateBeforeChange(cb: ValidateCallback<T>): void;
-    /**
-     * Get the CRDT state for an entity (serialized data and timestamp)
-     * @param entity - Entity to get the CRDT state for
-     * @returns Object with serialized data and timestamp, or null if entity doesn't have the component
-     * @public
-     */
-    getCrdtState(entity: Entity): {
-        data: Uint8Array;
-        timestamp: number;
-    } | null;
-}
-/**
- * Internal component interface that exposes all internal methods for SDK use
- * This is not exposed to users, only for internal SDK operations
- */
-export interface InternalBaseComponent<T> extends BaseComponent<T> {
-    /**
-     * @public
-     * Dry run update to check if a CRDT message would be accepted without actually applying it
-     */
-    __dry_run_updateFromCrdt(body: CrdtMessageBody): ProcessMessageResultType;
-    /**
-     * @public
-     * Get the iterator to every entity has the component
-     */
-    iterator(): Iterable<[Entity, any]>;
-    /**
-     * @public
-     */
-    dirtyIterator(): Iterable<Entity>;
-    /**
-     * @public
-     */
-    __onChangeCallbacks(entity: Entity, value: T): void;
-    /**
-     * @public
-     */
-    __run_validateBeforeChange(entity: Entity, newValue: T | undefined, senderAddress: string, createdBy: string): boolean;
 }
-export type ValidateCallback<T> = (value: {
-    entity: Entity;
-    currentValue: T | undefined;
-    newValue: T | undefined;
-    senderAddress: string;
-    createdBy: string;
-}) => boolean;
 /**
  * @public
  */

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

@@ -1,8 +1,7 @@
 import { ReadWriteByteBuffer } from '../serialization/ByteBuffer';
-import { AppendValueOperation, CrdtMessageType, ProcessMessageResultType } from '../serialization/crdt';
+import { AppendValueOperation, CrdtMessageType } from '../serialization/crdt';
 import { __DEV__ } from '../runtime/invariant';
 const emptyReadonlySet = freezeSet(new Set());
-const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
 function frozenError() {
     throw new Error('The set is frozen');
 }
@@ -23,7 +22,6 @@ export function createValueSetComponentDefinitionFromSchema(componentName, compo
     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;
@@ -82,11 +80,8 @@ export function createValueSetComponentDefinitionFromSchema(componentName, compo
         has(entity) {
             return data.has(entity);
         },
-        entityDeleted(entity, markAsDirty) {
+        entityDeleted(entity) {
             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);
@@ -157,44 +152,6 @@ export function createValueSetComponentDefinitionFromSchema(componentName, compo
             for (const cb of cbs) {
                 cb(value);
             }
-        },
-        __dry_run_updateFromCrdt(_body) {
-            return 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/engine/lww-element-set-component-definition.d.ts

@@ -1,10 +1,8 @@
 import { ISchema } from '../schemas';
 import { ByteBuffer } from '../serialization/ByteBuffer';
-import { PutComponentMessageBody, DeleteComponentMessageBody, ProcessMessageResultType, CrdtMessageBody, PutNetworkComponentMessageBody, DeleteComponentNetworkMessageBody, AuthoritativePutComponentMessageBody } from '../serialization/crdt';
+import { PutComponentMessageBody, DeleteComponentMessageBody, CrdtMessageBody } 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 createCrdtRuleValidator(timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (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>): (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>;

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

@@ -30,12 +30,16 @@ export function createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, d
         }
     };
 }
-const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
-export function createCrdtRuleValidator(timestamps, schema, data) {
+export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
     /**
-     * Shared CRDT conflict resolution logic
-     * @public
-     */
+     * 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
+      */
     function crdtRuleForCurrentState(message) {
         const { entityId, timestamp } = message;
         const currentTimestamp = timestamps.get(entityId);
@@ -45,6 +49,7 @@ export function createCrdtRuleValidator(timestamps, schema, data) {
         }
         // Outdated Message. Resend our state message through the wire.
         if (currentTimestamp > timestamp) {
+            // console.log('2', currentTimestamp, timestamp)
             return ProcessMessageResultType.StateOutdatedTimestamp;
         }
         // Deletes are idempotent
@@ -61,6 +66,7 @@ export function createCrdtRuleValidator(timestamps, schema, data) {
             currentDataGreater = 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 ProcessMessageResultType.NoChanges;
         }
@@ -69,35 +75,10 @@ export function createCrdtRuleValidator(timestamps, schema, data) {
             return ProcessMessageResultType.StateOutdatedData;
         }
         else {
-            // Current data is lower
+            // Curent data is lower
             return ProcessMessageResultType.StateUpdatedData;
         }
     }
-    return crdtRuleForCurrentState;
-}
-export function createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
-    /**
-     * Force update component state regardless of timestamp - used for server authoritative messages
-     */
-    return (msg) => {
-        const buffer = new ReadWriteByteBuffer(msg.data);
-        const deserializedValue = schema.deserialize(buffer);
-        data.set(msg.entityId, deserializedValue);
-        timestamps.set(msg.entityId, msg.timestamp);
-        return [null, deserializedValue];
-    };
-}
-export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
-    /**
-     * 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);
     return (msg) => {
         /* istanbul ignore next */
         if (msg.type !== CrdtMessageType.PUT_COMPONENT &&
@@ -190,7 +171,6 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
     const dirtyIterator = new Set();
     const timestamps = new Map();
     const onChangeCallbacks = new Map();
-    const validateCallbacks = new Map();
     return {
         get componentId() {
             return componentId;
@@ -282,39 +262,7 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
         },
         getCrdtUpdates: createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data),
         updateFromCrdt: createUpdateLwwFromCrdt(componentId, timestamps, schema, data),
-        __forceUpdateFromCrdt: createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data),
-        __dry_run_updateFromCrdt: createCrdtRuleValidator(timestamps, schema, data),
         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 ReadWriteByteBuffer();
-                schema.serialize(deepReadonly(componentData), buffer);
-                return { data: buffer.toBinary(), timestamp };
-            }
-            return null;
-        },
         onChange(entity, cb) {
             const cbs = onChangeCallbacks.get(entity) ?? [];
             cbs.push(cb);

package/dist/index.d.ts

@@ -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, ICreatedBy } from './components/types';
+import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended } from './components/types';
 import { NameComponent } from './components/manual/Name';
 import { TagsComponentDefinitionExtended } from './components/manual/Tags';
 export declare const Transform: TransformComponentExtended;
@@ -47,7 +48,6 @@ 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/index.js

@@ -13,6 +13,7 @@ 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';
 // @internal
@@ -51,7 +52,6 @@ export const NetworkEntity = /* @__PURE__*/ components.NetworkEntity(engine);
  * Tag a entity to be syncronized through comms
  */
 export const NetworkParent = /* @__PURE__*/ components.NetworkParent(engine);
-export const CreatedBy = /* @__PURE__*/ components.CreatedBy(engine);
 // export components for global engine
 export * from './components/generated/global.gen';
 export * from './components/generated/types.gen';

package/dist/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/runtime/helpers/index.js

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

package/dist/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/runtime/helpers/tree.js

@@ -35,11 +35,11 @@ function multiplyQuaternions(q1, q2) {
     };
 }
 /**
- * @internal
+ * @public
  * Rotate a vector by a quaternion
  * Uses the formula: v' = q * v * q^(-1), optimized version
  */
-function rotateVectorByQuaternion(v, q) {
+export function rotateVectorByQuaternion(v, q) {
     // Extract quaternion components
     const qx = q.x, qy = q.y, qz = q.z, qw = q.w;
     // Calculate cross product terms (q.xyz × v) * 2

package/dist/runtime/helpers/vectors.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runtime/helpers/vectors.js

@@ -0,0 +1,36 @@
+/**
+ * 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
+ */
+export const 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 = 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/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/runtime/initialization/index.js

@@ -14,6 +14,7 @@ import { pointerEventColliderChecker } from '../../systems/pointer-event-collide
 import { createTriggerAreaEventsSystem } from '../../systems/triggerArea';
 import { createTimers } from '../helpers/timers';
 import { setGlobalPolyfill } from '../globals';
+import { createPhysicsSystem } 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,11 @@ setGlobalPolyfill('setTimeout', timers.setTimeout);
 setGlobalPolyfill('clearTimeout', timers.clearTimeout);
 setGlobalPolyfill('setInterval', timers.setInterval);
 setGlobalPolyfill('clearInterval', timers.clearInterval);
+/**
+ * @public
+ * Physics helpers for applying impulses and forces to the player.
+ */
+export const Physics = /* @__PURE__ */ createPhysicsSystem(engine);
 /**
  * Adds pointer event collider system only in DEV env
  */

package/dist/serialization/crdt/index.d.ts

@@ -7,4 +7,3 @@ export * from './network/deleteComponentNetwork';
 export * from './network/deleteEntityNetwork';
 export * from './types';
 export * from './crdtMessageProtocol';
-export * from './authoritativePutComponent';

package/dist/serialization/crdt/index.js

@@ -7,4 +7,3 @@ export * from './network/deleteComponentNetwork';
 export * from './network/deleteEntityNetwork';
 export * from './types';
 export * from './crdtMessageProtocol';
-export * from './authoritativePutComponent';

package/dist/serialization/crdt/network/utils.d.ts

@@ -0,0 +1,9 @@
+import { Entity } from '../../../engine';
+import { ReceiveMessage, TransformType } from '../../../runtime/types';
+import { ReceiveNetworkMessage } from '../../../systems/crdt/types';
+import { ByteBuffer } from '../../ByteBuffer';
+import { INetowrkEntityType } from '../../../components/types';
+export declare function isNetworkMessage(message: ReceiveMessage): message is ReceiveNetworkMessage;
+export declare function networkMessageToLocal(message: ReceiveNetworkMessage, localEntityId: Entity, buffer: ByteBuffer, destinationBuffer: ByteBuffer): void;
+export declare function localMessageToNetwork(message: ReceiveMessage, network: INetowrkEntityType, buffer: ByteBuffer, destinationBuffer: ByteBuffer): void;
+export declare function fixTransformParent(message: ReceiveMessage, transformValue?: TransformType, parent?: Entity): Uint8Array;

package/dist/serialization/crdt/network/utils.js

@@ -0,0 +1,60 @@
+import { ReadWriteByteBuffer } from '../../ByteBuffer';
+import { PutComponentOperation } from '../putComponent';
+import { CrdtMessageType } from '../types';
+import { DeleteComponent } from '../deleteComponent';
+import { DeleteEntity } from '../deleteEntity';
+import { PutNetworkComponentOperation } from './putComponentNetwork';
+import { DeleteComponentNetwork } from './deleteComponentNetwork';
+import { DeleteEntityNetwork } from './deleteEntityNetwork';
+import { TransformSchema } from '../../../components/manual/Transform';
+/* istanbul ignore next */
+export function isNetworkMessage(message) {
+    return [
+        CrdtMessageType.DELETE_COMPONENT_NETWORK,
+        CrdtMessageType.DELETE_ENTITY_NETWORK,
+        CrdtMessageType.PUT_COMPONENT_NETWORK
+    ].includes(message.type);
+}
+/* istanbul ignore next */
+export function networkMessageToLocal(message, localEntityId, buffer, destinationBuffer) {
+    const offset = buffer.currentWriteOffset();
+    if (message.type === CrdtMessageType.PUT_COMPONENT_NETWORK) {
+        PutComponentOperation.write(localEntityId, message.timestamp, message.componentId, message.data, buffer);
+    }
+    else if (message.type === CrdtMessageType.DELETE_COMPONENT_NETWORK) {
+        DeleteComponent.write(localEntityId, message.componentId, message.timestamp, buffer);
+    }
+    else if (message.type === CrdtMessageType.DELETE_ENTITY_NETWORK) {
+        DeleteEntity.write(localEntityId, buffer);
+    }
+    destinationBuffer.writeBuffer(buffer.buffer().subarray(offset, buffer.currentWriteOffset()), false);
+}
+/* istanbul ignore next */
+export function localMessageToNetwork(message, network, buffer, destinationBuffer) {
+    const offset = buffer.currentWriteOffset();
+    if (message.type === CrdtMessageType.PUT_COMPONENT) {
+        PutNetworkComponentOperation.write(network.entityId, message.timestamp, message.componentId, network.networkId, message.data, buffer);
+    }
+    else if (message.type === CrdtMessageType.DELETE_COMPONENT) {
+        DeleteComponentNetwork.write(network.entityId, message.componentId, message.timestamp, network.networkId, buffer);
+    }
+    else if (message.type === CrdtMessageType.DELETE_ENTITY) {
+        DeleteEntityNetwork.write(network.entityId, network.networkId, buffer);
+    }
+    destinationBuffer.writeBuffer(buffer.buffer().subarray(offset, buffer.currentWriteOffset()), false);
+}
+const buffer = new ReadWriteByteBuffer();
+/* istanbul ignore next */
+export function fixTransformParent(message, transformValue, parent) {
+    buffer.resetBuffer();
+    let transform = transformValue;
+    if (!transform && 'data' in message) {
+        transform = TransformSchema.deserialize(new ReadWriteByteBuffer(message.data));
+    }
+    if (!transform)
+        throw new Error('Invalid parent transform');
+    // Generate new transform raw data with the parent
+    const newTransform = { ...transform, parent };
+    TransformSchema.serialize(newTransform, buffer);
+    return buffer.toBinary();
+}