@dcl/ecs 7.24.5-28985931443.commit-4a0bcfc → 7.24.5-29247185020.commit-e92dfe6

package/dist/composite/index.d.ts

@@ -6,7 +6,6 @@ import { CompositeDefinition } from './proto/gen/composite.gen';
 export type { CompositeDefinition, ComponentData, CompositeComponent, CompositeComponent_DataEntry, InstanceCompositeOptions, CompositeProvider, CompositeRootType, CompositeResource };
 export { EntityMappingMode };
 export { getCompositeRootComponent };
-export { setCompositeProvider, getCompositeProvider } from './provider-registry';
 /**
  * @public
  * @deprecated composite is not being supported so far, please do not use this feature
@@ -32,16 +31,14 @@ export declare namespace Composite {
     /** @public */
     function toBinary(composite: Composite.Definition): Uint8Array;
     /**
-     * Instance a composite and return its root entity.
-     * @param engine - the engine that will own the new entities
-     * @param compositeData - the composite resource to instance
-     * @param compositeProvider - provider used to resolve nested composite references
-     * @param options - instancing options (`rootEntity`, `entityMapping`, `alreadyRequestedSrc`)
-     * @returns the root entity of the instanced composite
+     * Instance a composite and returns its root entity
+     * @param compositeData - state serialized by the CRDT protocol
+     * @param getNextAvailableEntity - function that gives unused entities
+     * @param rootEntity - (optional) suggested mapped rootEntity for the composite
      *
      * @public
      */
-    function instance(engine: IEngine, compositeData: Composite.Resource, compositeProvider: CompositeProvider, options?: InstanceCompositeOptions): import("../engine").Entity;
+    function instance(engine: IEngine, compositeData: Composite.Resource, compositeProvider: CompositeProvider, options?: InstanceCompositeOptions): void;
     /**
      * Resolve and normalize a composite path
      * @param src - the source path

package/dist/composite/index.js

@@ -4,7 +4,6 @@ import { resolveComposite } from './path';
 import { CompositeDefinition } from './proto/gen/composite.gen';
 export { EntityMappingMode };
 export { getCompositeRootComponent };
-export { setCompositeProvider, getCompositeProvider } from './provider-registry';
 /**
  * @public
  * @deprecated composite is not being supported so far, please do not use this feature
@@ -32,17 +31,15 @@ export var Composite;
     }
     Composite.toBinary = toBinary;
     /**
-     * Instance a composite and return its root entity.
-     * @param engine - the engine that will own the new entities
-     * @param compositeData - the composite resource to instance
-     * @param compositeProvider - provider used to resolve nested composite references
-     * @param options - instancing options (`rootEntity`, `entityMapping`, `alreadyRequestedSrc`)
-     * @returns the root entity of the instanced composite
+     * Instance a composite and returns its root entity
+     * @param compositeData - state serialized by the CRDT protocol
+     * @param getNextAvailableEntity - function that gives unused entities
+     * @param rootEntity - (optional) suggested mapped rootEntity for the composite
      *
      * @public
      */
     /*#__PURE__*/ function instance(engine, compositeData, compositeProvider, options = {}) {
-        return instanceComposite(engine, compositeData, compositeProvider, options);
+        instanceComposite(engine, compositeData, compositeProvider, options);
     }
     Composite.instance = instance;
     /**

package/dist/composite/instance.d.ts

@@ -13,11 +13,6 @@ export type CompositeResource = {
  */
 export type CompositeProvider = {
     getCompositeOrNull(src: string): CompositeResource | null;
-    loadComposite?: (src: string) => Promise<CompositeResource>;
-    schemas?: Iterable<{
-        name: string;
-        jsonSchema: any;
-    }>;
 };
 /** @public */
 export declare enum EntityMappingMode {

package/dist/composite/instance.js

@@ -43,7 +43,7 @@ export function getComponentDefinition(engine, component) {
             return engine.defineComponentFromSchema(component.name, Schemas.fromJson(component.jsonSchema));
         }
         else {
-            throw new Error(`Composite references undefined component "${component.name}". Ensure provider.schemas was registered pre-seal via setCompositeProvider().`);
+            throw new Error(`${component.name} is not defined and there is no schema to define it.`);
         }
     }
     else {
@@ -84,7 +84,6 @@ export function instanceComposite(engine, compositeResource, compositeProvider,
     const compositeDirectoryPath = path.dirname(path.resolve(compositeResource.src));
     const TransformComponentNumber = componentNumberFromName('core::Transform');
     const CompositeRootComponent = getCompositeRootComponent(engine);
-    let hadNestedComposite = false;
     // Key => EntityNumber from the composite
     // Value => EntityNumber in current engine
     const mappedEntities = new Map();
@@ -100,29 +99,23 @@ export function instanceComposite(engine, compositeResource, compositeProvider,
     // If there are more composite inside this one, we instance first.
     // => This is not only a copy, we need to instance. Otherwise, we'd be missing that branches
     // => TODO: in the future, the instanciation is first, then the overides (to parameterize Composite, e.g. house with different wall colors)
-    if (CompositeRootComponent) {
-        const childrenComposite = compositeResource.composite.components.find((item) => item.name === CompositeRootComponent.componentName);
-        if (childrenComposite) {
-            for (const [childCompositeEntity, compositeRawData] of childrenComposite.data) {
-                const childComposite = getComponentValue(CompositeRootComponent, compositeRawData);
-                const childCompositePath = path.resolveComposite(childComposite.src, compositeDirectoryPath);
-                const childCompositeResource = compositeProvider.getCompositeOrNull(childCompositePath);
-                const targetEntity = getCompositeEntity(childCompositeEntity);
-                if (childCompositeResource) {
-                    if (alreadyRequestedSrc.has(childCompositeResource.src) ||
-                        childCompositeResource.src === compositeResource.src) {
-                        throw new Error(`Composite ${compositeResource.src} has a recursive instanciation while try to instance ${childCompositeResource.src}. Previous instances: ${alreadyRequestedSrc.toString()}`);
-                    }
-                    hadNestedComposite = true;
-                    instanceComposite(engine, childCompositeResource, compositeProvider, {
-                        rootEntity: targetEntity,
-                        alreadyRequestedSrc: new Set(alreadyRequestedSrc).add(childCompositeResource.src),
-                        entityMapping: entityMapping?.type === EntityMappingMode.EMM_NEXT_AVAILABLE ? entityMapping : undefined
-                    });
-                }
-                else {
-                    console.warn(`Composite "${compositeResource.src}" references missing nested composite "${childCompositePath}". Skipping; the spawned subtree will be incomplete.`);
+    const childrenComposite = compositeResource.composite.components.find((item) => item.name === CompositeRootComponent.componentName);
+    if (childrenComposite) {
+        for (const [childCompositeEntity, compositeRawData] of childrenComposite.data) {
+            const childComposite = getComponentValue(CompositeRootComponent, compositeRawData);
+            const childCompositePath = path.resolveComposite(childComposite.src, compositeDirectoryPath);
+            const childCompositeResource = compositeProvider.getCompositeOrNull(childCompositePath);
+            const targetEntity = getCompositeEntity(childCompositeEntity);
+            if (childCompositeResource) {
+                if (alreadyRequestedSrc.has(childCompositeResource.src) ||
+                    childCompositeResource.src === compositeResource.src) {
+                    throw new Error(`Composite ${compositeResource.src} has a recursive instanciation while try to instance ${childCompositeResource.src}. Previous instances: ${alreadyRequestedSrc.toString()}`);
                 }
+                instanceComposite(engine, childCompositeResource, compositeProvider, {
+                    rootEntity: targetEntity,
+                    alreadyRequestedSrc: new Set(alreadyRequestedSrc).add(childCompositeResource.src),
+                    entityMapping: entityMapping?.type === EntityMappingMode.EMM_NEXT_AVAILABLE ? entityMapping : undefined
+                });
             }
         }
     }
@@ -130,7 +123,7 @@ export function instanceComposite(engine, compositeResource, compositeProvider,
     // Then, we copy the all rest of the components (skipping the Composite ones)
     for (const component of compositeResource.composite.components) {
         // We already instanced the composite
-        if (CompositeRootComponent && component.name === CompositeRootComponent.componentName)
+        if (component.name === CompositeRootComponent.componentName)
             continue;
         // ## 3a ##
         // We find the component definition
@@ -166,15 +159,13 @@ export function instanceComposite(engine, compositeResource, compositeProvider,
             }
         }
     }
-    if (hadNestedComposite) {
-        const composite = CompositeRootComponent.getMutableOrNull(compositeRootEntity) || CompositeRootComponent.create(compositeRootEntity);
-        for (const [entitySource, targetEntity] of mappedEntities) {
-            composite.entities.push({
-                src: entitySource,
-                dest: targetEntity
-            });
-        }
-        composite.src = compositeResource.src;
+    const composite = CompositeRootComponent.getMutableOrNull(compositeRootEntity) || CompositeRootComponent.create(compositeRootEntity);
+    for (const [entitySource, targetEntity] of mappedEntities) {
+        composite.entities.push({
+            src: entitySource,
+            dest: targetEntity
+        });
     }
+    composite.src = compositeResource.src;
     return compositeRootEntity;
 }

package/dist/engine/entity.js

@@ -61,10 +61,8 @@ export var EntityState;
  */
 export function createEntityContainer(opts) {
     const reservedStaticEntities = opts?.reservedStaticEntities ?? RESERVED_STATIC_ENTITIES;
-    // If a build tool has set DCL_MAX_COMPOSITE_ENTITY (via esbuild define),
-    // start the counter past composite entities to prevent ID collisions.
-    const maxCompositeEntity = typeof DCL_MAX_COMPOSITE_ENTITY !== 'undefined' ? DCL_MAX_COMPOSITE_ENTITY : 0;
-    let entityCounter = Math.max(reservedStaticEntities, maxCompositeEntity > 0 ? maxCompositeEntity + 1 : 0);
+    // Local entities counter
+    let entityCounter = reservedStaticEntities;
     const usedEntities = new Set();
     let toRemoveEntities = [];
     const removedEntities = createVersionGSet();

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

@@ -12,7 +12,7 @@ function freezeSet(set) {
     return set;
 }
 function sortByTimestamp(a, b) {
-    return a.timestamp - b.timestamp;
+    return a.timestamp > b.timestamp ? 1 : -1;
 }
 /**
  * @internal

package/dist/engine/index.js

@@ -236,7 +236,7 @@ export function Engine(options) {
         const deletedEntites = partialEngine.entityContainer.releaseRemovedEntities();
         await crdtSystem.sendMessages(deletedEntites);
     }
-    const engineInstance = {
+    return {
         _id: Date.now(),
         addEntity: partialEngine.addEntity,
         removeEntity: partialEngine.removeEntity,
@@ -264,5 +264,4 @@ export function Engine(options) {
         addTransport: crdtSystem.addTransport,
         entityContainer: partialEngine.entityContainer
     };
-    return engineInstance;
 }

package/dist/engine/input.d.ts

@@ -32,6 +32,12 @@ 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/engine/input.js

@@ -12,8 +12,7 @@ const InputCommands = [
     10 /* InputAction.IA_ACTION_3 */,
     11 /* InputAction.IA_ACTION_4 */,
     12 /* InputAction.IA_ACTION_5 */,
-    13 /* InputAction.IA_ACTION_6 */,
-    14 /* InputAction.IA_MODIFIER */
+    13 /* InputAction.IA_ACTION_6 */
 ];
 const InputStateUpdateSystemPriority = 1 << 20;
 /**
@@ -119,9 +118,8 @@ export function createInputSystem(engine) {
         }
         if (!up || !down)
             return null;
-        // 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)) {
+        // 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)) {
             return { up, down };
         }
         return null;
@@ -187,11 +185,17 @@ export 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
+        isTriggered,
+        getInputCommands
     };
 }

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

@@ -4,5 +4,5 @@ import { PutComponentMessageBody, DeleteComponentMessageBody, CrdtMessageBody }
 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>, 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>;
+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,7 +30,7 @@ export function createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, d
         }
     };
 }
-export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, lastSentData) {
+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.
@@ -96,11 +96,9 @@ export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, l
                 if (msg.type === CrdtMessageType.PUT_COMPONENT || msg.type === CrdtMessageType.PUT_COMPONENT_NETWORK) {
                     const buf = new 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)];
             }
@@ -136,34 +134,23 @@ export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, l
         return [null, data.get(entity)];
     };
 }
-export function createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data, lastSentData) {
+export function createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data) {
     return function* () {
-        const writeBuffer = new ReadWriteByteBuffer();
         for (const entity of dirtyIterator) {
+            const newTimestamp = incrementTimestamp(entity, timestamps);
             if (data.has(entity)) {
-                writeBuffer.resetBuffer();
+                const writeBuffer = new ReadWriteByteBuffer();
                 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 && dataCompare(writeBuffer.toBinary(), previousBytes) === 0) {
-                    continue;
-                }
-                const currentBytes = writeBuffer.toCopiedBinary();
-                const newTimestamp = incrementTimestamp(entity, timestamps);
-                lastSentData.set(entity, currentBytes);
                 const msg = {
                     type: CrdtMessageType.PUT_COMPONENT,
                     componentId,
                     entityId: entity,
-                    data: currentBytes,
+                    data: writeBuffer.toBinary(),
                     timestamp: newTimestamp
                 };
                 yield msg;
             }
             else {
-                lastSentData.delete(entity);
-                const newTimestamp = incrementTimestamp(entity, timestamps);
                 const msg = {
                     type: CrdtMessageType.DELETE_COMPONENT,
                     componentId,
@@ -183,7 +170,6 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
     const data = new Map();
     const dirtyIterator = new Set();
     const timestamps = new Map();
-    const lastSentData = new Map();
     const onChangeCallbacks = new Map();
     return {
         get componentId() {
@@ -205,14 +191,12 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
             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);
@@ -239,7 +223,6 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
             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) {
@@ -277,8 +260,8 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
                 yield entity;
             }
         },
-        getCrdtUpdates: createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data, lastSentData),
-        updateFromCrdt: createUpdateLwwFromCrdt(componentId, timestamps, schema, data, lastSentData),
+        getCrdtUpdates: createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data),
+        updateFromCrdt: createUpdateLwwFromCrdt(componentId, timestamps, schema, data),
         dumpCrdtStateToBuffer: createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, data),
         onChange(entity, cb) {
             const cbs = onChangeCallbacks.get(entity) ?? [];

package/dist/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,16 +12,14 @@ 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, AudioAnalysisComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended, ParticleSystemComponentDefinitionExtended } 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;
 export declare const Animator: AnimatorComponentDefinitionExtended;
 export declare const AudioSource: AudioSourceComponentDefinitionExtended;
-export declare const AudioAnalysis: AudioAnalysisComponentDefinitionExtended;
 export declare const AudioStream: AudioStreamComponentDefinitionExtended;
 export declare const Material: MaterialComponentDefinitionExtended;
 export declare const MeshRenderer: MeshRendererComponentDefinitionExtended;
@@ -33,7 +31,6 @@ 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.

package/dist/index.js

@@ -1,10 +1,10 @@
 // The order of the following imports matters. Please do not auto-sort
 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';
@@ -13,7 +13,6 @@ 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
@@ -25,7 +24,6 @@ import { engine } from './runtime/initialization';
 export const Transform = /* @__PURE__*/ components.Transform(engine);
 export const Animator = /* @__PURE__*/ components.Animator(engine);
 export const AudioSource = /* @__PURE__*/ components.AudioSource(engine);
-export const AudioAnalysis = /* @__PURE__*/ components.AudioAnalysis(engine);
 export const AudioStream = /* @__PURE__*/ components.AudioStream(engine);
 export const Material = /* @__PURE__*/ components.Material(engine);
 export const MeshRenderer = /* @__PURE__*/ components.MeshRenderer(engine);
@@ -37,8 +35,6 @@ export const VirtualCamera = /* @__PURE__*/ components.VirtualCamera(engine);
 export const InputModifier = /* @__PURE__*/ components.InputModifier(engine);
 export const LightSource = /* @__PURE__*/ components.LightSource(engine);
 export const TriggerArea = /* @__PURE__*/ components.TriggerArea(engine);
-export const ParticleSystem = 
-/* @__PURE__*/ components.ParticleSystem(engine);
 /**
  * @alpha
  * This is going to be used for sync components through a server.

package/dist/runtime/globals.d.ts

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

package/dist/runtime/globals.js

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

package/dist/runtime/helpers/coordinates.js

@@ -1,7 +1,3 @@
-/** Returns a string representation of the given coordinates in the format "x,y" */
-function formatCoord(coord) {
-    return `${coord.x},${coord.y}`;
-}
 /**
  * Returns true if the given parcels array are connected
  */
@@ -9,8 +5,8 @@ export function areConnected(parcels) {
     if (parcels.length === 0) {
         return false;
     }
-    const visited = visitConnectedParcels(parcels[0], parcels);
-    return visited.size === parcels.length;
+    const visited = visitParcel(parcels[0], parcels);
+    return visited.length === parcels.length;
 }
 /**
  * Returns true if the given coords are equal
@@ -18,38 +14,19 @@ export function areConnected(parcels) {
 export function isEqual(p1, p2) {
     return p1.x === p2.x && p1.y === p2.y;
 }
-/**
- * Returns the list of connected parcels starting from the given parcel.
- * @param parcel - The starting parcel to visit
- * @param allParcels - The list of all parcels to consider for connectivity
- * @returns The list of connected parcels starting from the given parcel
- * @remarks This function uses an iterative depth-first search (DFS) approach to avoid blowing the call stack on large connected parcel sets.
- */
-function visitConnectedParcels(parcel, allParcels) {
-    const allParcelsSet = new Set(allParcels.map(formatCoord));
-    const visitedSet = new Set();
-    const stackToVisit = [parcel];
-    while (stackToVisit.length > 0) {
-        const currentParcel = stackToVisit.pop();
-        const key = formatCoord(currentParcel);
-        const isVisited = visitedSet.has(key);
-        if (!isVisited) {
-            visitedSet.add(key);
-            const neighbours = getNeighbours(currentParcel.x, currentParcel.y, allParcelsSet);
-            for (const n of neighbours) {
-                if (!visitedSet.has(formatCoord(n)))
-                    stackToVisit.push(n);
-            }
-        }
+function visitParcel(parcel, allParcels, visited = []) {
+    const isVisited = visited.some((visitedParcel) => isEqual(visitedParcel, parcel));
+    if (!isVisited) {
+        visited.push(parcel);
+        const neighbours = getNeighbours(parcel.x, parcel.y, allParcels);
+        neighbours.forEach((neighbours) => visitParcel(neighbours, allParcels, visited));
     }
-    return visitedSet;
+    return visited;
+}
+function getIsNeighbourMatcher(x, y) {
+    return (coords) => (coords.x === x && (coords.y + 1 === y || coords.y - 1 === y)) ||
+        (coords.y === y && (coords.x + 1 === x || coords.x - 1 === x));
 }
 function getNeighbours(x, y, parcels) {
-    const neighbourCandidates = [
-        { x: x + 1, y },
-        { x: x - 1, y },
-        { x, y: y + 1 },
-        { x, y: y - 1 }
-    ];
-    return neighbourCandidates.filter((c) => parcels.has(formatCoord(c)));
+    return parcels.filter(getIsNeighbourMatcher(x, y));
 }

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

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

package/dist/runtime/helpers/index.js

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

package/dist/runtime/helpers/timers.js

@@ -20,59 +20,47 @@
 export function createTimers(targetEngine) {
     const timers = new Map();
     let timerIdCounter = 0;
-    // While a timer's callback is running this holds the time already consumed this
-    // frame before that timer's logical fire instant (`elapsedMs - residualMs`);
-    // `null` otherwise. A timer armed from within the callback is seeded with the
-    // negative of this, so its delay is measured from the parent's fire instant
-    // rather than from the start of the frame.
-    let armContext = null;
     function system(dt) {
-        const elapsedMs = 1000 * dt;
         for (const [timerId, timerData] of timers) {
-            timerData.accumulatedTime += elapsedMs;
+            timerData.accumulatedTime += 1000 * dt;
             if (timerData.accumulatedTime < timerData.interval) {
                 continue;
             }
-            // Time elapsed past this timer's logical fire instant this frame.
-            const residualMs = timerData.recurrent
-                ? timerData.accumulatedTime % timerData.interval
-                : timerData.accumulatedTime - timerData.interval;
             if (timerData.recurrent) {
-                // Collapse any missed periods into a single callback, keep the remainder.
-                timerData.accumulatedTime = residualMs;
+                // For intervals, subtract full interval periods to handle accumulated time
+                const fullIntervals = Math.floor(timerData.accumulatedTime / timerData.interval);
+                timerData.accumulatedTime -= fullIntervals * timerData.interval;
             }
             else {
                 timers.delete(timerId);
             }
-            armContext = { accruedMs: elapsedMs - residualMs };
             timerData.callback();
-            armContext = null;
         }
     }
     targetEngine.addSystem(system, Number.MAX_SAFE_INTEGER, '@dcl/ecs/timers');
-    function addTimer(callback, interval, recurrent) {
-        const timerId = timerIdCounter++;
-        let accumulatedTime = 0;
-        if (armContext) {
-            // Armed from inside a firing callback: this timer is appended to the map
-            // being iterated, so the loop will still add this frame's elapsed to it.
-            // Inherit the residual so that `+= elapsedMs` nets to the true time
-            // elapsed since the parent fired (phase-accurate). Each successive arming
-            // starts one interval lower, so a re-arming chain terminates this frame.
-            accumulatedTime = -armContext.accruedMs;
-        }
-        timers.set(timerId, { callback, interval, recurrent, accumulatedTime });
-        return timerId;
-    }
     return {
         setTimeout(callback, ms) {
-            return addTimer(callback, ms, false);
+            const timerId = timerIdCounter++;
+            timers.set(timerId, {
+                callback,
+                interval: ms,
+                recurrent: false,
+                accumulatedTime: 0
+            });
+            return timerId;
         },
         clearTimeout(timerId) {
             timers.delete(timerId);
         },
         setInterval(callback, ms) {
-            return addTimer(callback, ms, true);
+            const timerId = timerIdCounter++;
+            timers.set(timerId, {
+                callback,
+                interval: ms,
+                recurrent: true,
+                accumulatedTime: 0
+            });
+            return timerId;
         },
         clearInterval(timerId) {
             timers.delete(timerId);