@dcl/ecs 7.24.5-29247185020.commit-e92dfe6 → 7.24.5-29264961047.commit-77493c3

package/dist-cjs/composite/index.d.ts

@@ -6,6 +6,7 @@ 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
@@ -31,14 +32,16 @@ export declare namespace Composite {
     /** @public */
     function toBinary(composite: Composite.Definition): Uint8Array;
     /**
-     * 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
+     * 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
      *
      * @public
      */
-    function instance(engine: IEngine, compositeData: Composite.Resource, compositeProvider: CompositeProvider, options?: InstanceCompositeOptions): void;
+    function instance(engine: IEngine, compositeData: Composite.Resource, compositeProvider: CompositeProvider, options?: InstanceCompositeOptions): import("../engine").Entity;
     /**
      * Resolve and normalize a composite path
      * @param src - the source path

package/dist-cjs/composite/index.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Composite = exports.getCompositeRootComponent = exports.EntityMappingMode = void 0;
+exports.Composite = exports.getCompositeProvider = exports.setCompositeProvider = exports.getCompositeRootComponent = exports.EntityMappingMode = void 0;
 const components_1 = require("./components");
 Object.defineProperty(exports, "getCompositeRootComponent", { enumerable: true, get: function () { return components_1.getCompositeRootComponent; } });
 const instance_1 = require("./instance");
 Object.defineProperty(exports, "EntityMappingMode", { enumerable: true, get: function () { return instance_1.EntityMappingMode; } });
 const path_1 = require("./path");
 const composite_gen_1 = require("./proto/gen/composite.gen");
+var provider_registry_1 = require("./provider-registry");
+Object.defineProperty(exports, "setCompositeProvider", { enumerable: true, get: function () { return provider_registry_1.setCompositeProvider; } });
+Object.defineProperty(exports, "getCompositeProvider", { enumerable: true, get: function () { return provider_registry_1.getCompositeProvider; } });
 /**
  * @public
  * @deprecated composite is not being supported so far, please do not use this feature
@@ -34,15 +37,17 @@ var Composite;
     }
     Composite.toBinary = toBinary;
     /**
-     * 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
+     * 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
      *
      * @public
      */
     /*#__PURE__*/ function instance(engine, compositeData, compositeProvider, options = {}) {
-        (0, instance_1.instanceComposite)(engine, compositeData, compositeProvider, options);
+        return (0, instance_1.instanceComposite)(engine, compositeData, compositeProvider, options);
     }
     Composite.instance = instance;
     /**

package/dist-cjs/composite/instance.d.ts

@@ -13,6 +13,11 @@ 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-cjs/composite/instance.js

@@ -70,7 +70,7 @@ function getComponentDefinition(engine, component) {
             return engine.defineComponentFromSchema(component.name, schemas_1.Schemas.fromJson(component.jsonSchema));
         }
         else {
-            throw new Error(`${component.name} is not defined and there is no schema to define it.`);
+            throw new Error(`Composite references undefined component "${component.name}". Ensure provider.schemas was registered pre-seal via setCompositeProvider().`);
         }
     }
     else {
@@ -113,6 +113,7 @@ function instanceComposite(engine, compositeResource, compositeProvider, options
     const compositeDirectoryPath = path.dirname(path.resolve(compositeResource.src));
     const TransformComponentNumber = (0, component_number_1.componentNumberFromName)('core::Transform');
     const CompositeRootComponent = (0, components_2.getCompositeRootComponent)(engine);
+    let hadNestedComposite = false;
     // Key => EntityNumber from the composite
     // Value => EntityNumber in current engine
     const mappedEntities = new Map();
@@ -128,23 +129,29 @@ function instanceComposite(engine, compositeResource, compositeProvider, options
     // 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)
-    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()}`);
+    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.`);
                 }
-                instanceComposite(engine, childCompositeResource, compositeProvider, {
-                    rootEntity: targetEntity,
-                    alreadyRequestedSrc: new Set(alreadyRequestedSrc).add(childCompositeResource.src),
-                    entityMapping: entityMapping?.type === EntityMappingMode.EMM_NEXT_AVAILABLE ? entityMapping : undefined
-                });
             }
         }
     }
@@ -152,7 +159,7 @@ function instanceComposite(engine, compositeResource, compositeProvider, options
     // 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 (component.name === CompositeRootComponent.componentName)
+        if (CompositeRootComponent && component.name === CompositeRootComponent.componentName)
             continue;
         // ## 3a ##
         // We find the component definition
@@ -188,14 +195,16 @@ function instanceComposite(engine, compositeResource, compositeProvider, options
             }
         }
     }
-    const composite = CompositeRootComponent.getMutableOrNull(compositeRootEntity) || CompositeRootComponent.create(compositeRootEntity);
-    for (const [entitySource, targetEntity] of mappedEntities) {
-        composite.entities.push({
-            src: entitySource,
-            dest: targetEntity
-        });
+    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;
     }
-    composite.src = compositeResource.src;
     return compositeRootEntity;
 }
 exports.instanceComposite = instanceComposite;

package/dist-cjs/composite/provider-registry.d.ts

@@ -0,0 +1,15 @@
+import type { IEngine } from '../engine';
+import type { CompositeProvider } from './instance';
+/**
+ * Register the composite provider used to resolve composite files. Also registers
+ * any `provider.schemas` on the engine pre-seal so composites that reference those
+ * components can be instanced without further setup.
+ * @public
+ */
+export declare function setCompositeProvider(engine: IEngine, provider: CompositeProvider): void;
+/**
+ * Get the composite provider registered via setCompositeProvider. Returns null if
+ * no provider has been set.
+ * @public
+ */
+export declare function getCompositeProvider(): CompositeProvider | null;

package/dist-cjs/composite/provider-registry.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCompositeProvider = exports.setCompositeProvider = void 0;
+const schemas_1 = require("../schemas");
+const components_1 = require("./components");
+let currentProvider = null;
+/**
+ * Register the composite provider used to resolve composite files. Also registers
+ * any `provider.schemas` on the engine pre-seal so composites that reference those
+ * components can be instanced without further setup.
+ * @public
+ */
+function setCompositeProvider(engine, provider) {
+    currentProvider = provider;
+    // Define composite::root pre-seal. setCompositeProvider runs at module-load,
+    // so this guarantees the component exists before the engine seals — composites
+    // instanced at runtime (post-seal) would otherwise trip the seal when
+    // instanceComposite looks it up via getCompositeRootComponent.
+    (0, components_1.getCompositeRootComponent)(engine);
+    if (!provider.schemas)
+        return;
+    for (const { name, jsonSchema } of provider.schemas) {
+        if (engine.getComponentOrNull(name))
+            continue;
+        engine.defineComponentFromSchema(name, schemas_1.Schemas.fromJson(jsonSchema));
+    }
+}
+exports.setCompositeProvider = setCompositeProvider;
+/**
+ * Get the composite provider registered via setCompositeProvider. Returns null if
+ * no provider has been set.
+ * @public
+ */
+function getCompositeProvider() {
+    return currentProvider;
+}
+exports.getCompositeProvider = getCompositeProvider;

package/dist-cjs/engine/entity.js

@@ -64,8 +64,10 @@ var EntityState;
  */
 function createEntityContainer(opts) {
     const reservedStaticEntities = opts?.reservedStaticEntities ?? exports.RESERVED_STATIC_ENTITIES;
-    // Local entities counter
-    let entityCounter = reservedStaticEntities;
+    // 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);
     const usedEntities = new Set();
     let toRemoveEntities = [];
     const removedEntities = (0, gset_1.createVersionGSet)();

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

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

package/dist-cjs/engine/index.js

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

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

@@ -38,7 +38,8 @@ const InputCommands = [
     10 /* InputAction.IA_ACTION_3 */,
     11 /* InputAction.IA_ACTION_4 */,
     12 /* InputAction.IA_ACTION_5 */,
-    13 /* InputAction.IA_ACTION_6 */
+    13 /* InputAction.IA_ACTION_6 */,
+    14 /* InputAction.IA_MODIFIER */
 ];
 const InputStateUpdateSystemPriority = 1 << 20;
 /**
@@ -144,8 +145,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 +213,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

@@ -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>): (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 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

@@ -35,7 +35,7 @@ function createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, data) {
     };
 }
 exports.createDumpLwwFunctionFromCrdt = createDumpLwwFunctionFromCrdt;
-function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
+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.
@@ -101,9 +101,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 +142,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,6 +190,7 @@ 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();
     return {
         get componentId() {
@@ -198,12 +212,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 +246,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,8 +284,8 @@ 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),
         dumpCrdtStateToBuffer: createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, data),
         onChange(entity, cb) {
             const cbs = onChangeCallbacks.get(entity) ?? [];

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,14 +12,16 @@ 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, AudioAnalysisComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended, ParticleSystemComponentDefinitionExtended } 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;
@@ -31,6 +33,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.

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.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.AudioAnalysis = 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
@@ -53,6 +54,7 @@ const initialization_1 = require("./runtime/initialization");
 exports.Transform = components.Transform(initialization_1.engine);
 exports.Animator = components.Animator(initialization_1.engine);
 exports.AudioSource = components.AudioSource(initialization_1.engine);
+exports.AudioAnalysis = components.AudioAnalysis(initialization_1.engine);
 exports.AudioStream = components.AudioStream(initialization_1.engine);
 exports.Material = components.Material(initialization_1.engine);
 exports.MeshRenderer = components.MeshRenderer(initialization_1.engine);
@@ -64,6 +66,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.

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/coordinates.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isEqual = exports.areConnected = void 0;
+/** 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
  */
@@ -8,8 +12,8 @@ function areConnected(parcels) {
     if (parcels.length === 0) {
         return false;
     }
-    const visited = visitParcel(parcels[0], parcels);
-    return visited.length === parcels.length;
+    const visited = visitConnectedParcels(parcels[0], parcels);
+    return visited.size === parcels.length;
 }
 exports.areConnected = areConnected;
 /**
@@ -19,19 +23,38 @@ function isEqual(p1, p2) {
     return p1.x === p2.x && p1.y === p2.y;
 }
 exports.isEqual = isEqual;
-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));
+/**
+ * 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);
+            }
+        }
     }
-    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));
+    return visitedSet;
 }
 function getNeighbours(x, y, parcels) {
-    return parcels.filter(getIsNeighbourMatcher(x, y));
+    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)));
 }

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; } });