excalibur 0.25.2 → 0.25.3

package/build/dist/EntityComponentSystem/Entity.js

@@ -0,0 +1,452 @@
+import { Component, TagComponent } from './Component';
+import { Observable } from '../Util/Observable';
+import { Class } from '../Class';
+import { InitializeEvent, PreUpdateEvent, PostUpdateEvent } from '../Events';
+import { Util } from '..';
+/**
+ * AddedComponent message
+ */
+export class AddedComponent {
+    constructor(data) {
+        this.data = data;
+        this.type = 'Component Added';
+    }
+}
+/**
+ * Type guard to know if message is f an Added Component
+ */
+export function isAddedComponent(x) {
+    return !!x && x.type === 'Component Added';
+}
+/**
+ * RemovedComponent message
+ */
+export class RemovedComponent {
+    constructor(data) {
+        this.data = data;
+        this.type = 'Component Removed';
+    }
+}
+/**
+ * Type guard to know if message is for a Removed Component
+ */
+export function isRemovedComponent(x) {
+    return !!x && x.type === 'Component Removed';
+}
+/**
+ * An Entity is the base type of anything that can have behavior in Excalibur, they are part of the built in entity component system
+ *
+ * Entities can be strongly typed with the components they contain
+ *
+ * ```typescript
+ * const entity = new Entity<ComponentA | ComponentB>();
+ * entity.components.a; // Type ComponentA
+ * entity.components.b; // Type ComponentB
+ * ```
+ */
+export class Entity extends Class {
+    constructor(components, name) {
+        super();
+        /**
+         * The unique identifier for the entity
+         */
+        this.id = Entity._ID++;
+        this._name = 'anonymous';
+        /**
+         * Whether this entity is active, if set to false it will be reclaimed
+         */
+        this.active = true;
+        /**
+         * Bucket to hold on to deferred removals
+         */
+        this._componentsToRemove = [];
+        this._componentTypeToInstance = new Map();
+        this._componentStringToInstance = new Map();
+        this._tagsMemo = [];
+        this._typesMemo = [];
+        /**
+         * Observable that keeps track of component add or remove changes on the entity
+         */
+        this.componentAdded$ = new Observable();
+        this.componentRemoved$ = new Observable();
+        this._parent = null;
+        this.childrenAdded$ = new Observable();
+        this.childrenRemoved$ = new Observable();
+        this._children = [];
+        this._isInitialized = false;
+        this._setName(name);
+        if (components) {
+            for (const component of components) {
+                this.addComponent(component);
+            }
+        }
+    }
+    _setName(name) {
+        if (name) {
+            this._name = name;
+        }
+    }
+    get name() {
+        return this._name;
+    }
+    get events() {
+        return this.eventDispatcher;
+    }
+    /**
+     * Kill the entity, means it will no longer be updated. Kills are deferred to the end of the update.
+     */
+    kill() {
+        this.active = false;
+    }
+    isKilled() {
+        return !this.active;
+    }
+    /**
+     * Specifically get the tags on the entity from [[TagComponent]]
+     */
+    get tags() {
+        return this._tagsMemo;
+    }
+    /**
+     * Check if a tag exists on the entity
+     * @param tag name to check for
+     */
+    hasTag(tag) {
+        return this.tags.includes(tag);
+    }
+    /**
+     * Adds a tag to an entity
+     * @param tag
+     * @returns Entity
+     */
+    addTag(tag) {
+        return this.addComponent(new TagComponent(tag));
+    }
+    /**
+     * Removes a tag on the entity
+     *
+     * Removals are deferred until the end of update
+     * @param tag
+     * @param force Remove component immediately, no deferred
+     */
+    removeTag(tag, force = false) {
+        return this.removeComponent(tag, force);
+    }
+    /**
+     * The types of the components on the Entity
+     */
+    get types() {
+        return this._typesMemo;
+    }
+    _rebuildMemos() {
+        this._tagsMemo = Array.from(this._componentStringToInstance.values())
+            .filter((c) => c instanceof TagComponent)
+            .map((c) => c.type);
+        this._typesMemo = Array.from(this._componentStringToInstance.keys());
+    }
+    getComponents() {
+        return Array.from(this._componentStringToInstance.values());
+    }
+    _notifyAddComponent(component) {
+        this._rebuildMemos();
+        const added = new AddedComponent({
+            component,
+            entity: this
+        });
+        this.componentAdded$.notifyAll(added);
+    }
+    _notifyRemoveComponent(component) {
+        const removed = new RemovedComponent({
+            component,
+            entity: this
+        });
+        this.componentRemoved$.notifyAll(removed);
+        this._rebuildMemos();
+    }
+    get parent() {
+        return this._parent;
+    }
+    /**
+     * Get the direct children of this entity
+     */
+    get children() {
+        return this._children;
+    }
+    /**
+     * Unparents this entity, if there is a parent. Otherwise it does nothing.
+     */
+    unparent() {
+        if (this._parent) {
+            this._parent.removeChild(this);
+            this._parent = null;
+        }
+    }
+    /**
+     * Adds an entity to be a child of this entity
+     * @param entity
+     */
+    addChild(entity) {
+        if (entity.parent === null) {
+            if (this.getAncestors().includes(entity)) {
+                throw new Error('Cycle detected, cannot add entity');
+            }
+            this._children.push(entity);
+            entity._parent = this;
+            this.childrenAdded$.notifyAll(entity);
+        }
+        else {
+            throw new Error('Entity already has a parent, cannot add without unparenting');
+        }
+        return this;
+    }
+    /**
+     * Remove an entity from children if it exists
+     * @param entity
+     */
+    removeChild(entity) {
+        if (entity.parent === this) {
+            Util.removeItemFromArray(entity, this._children);
+            entity._parent = null;
+            this.childrenRemoved$.notifyAll(entity);
+        }
+        return this;
+    }
+    /**
+     * Removes all children from this entity
+     */
+    removeAllChildren() {
+        this.children.forEach((c) => {
+            this.removeChild(c);
+        });
+        return this;
+    }
+    /**
+     * Returns a list of parent entities starting with the topmost parent. Includes the current entity.
+     */
+    getAncestors() {
+        const result = [this];
+        let current = this.parent;
+        while (current) {
+            result.push(current);
+            current = current.parent;
+        }
+        return result.reverse();
+    }
+    /**
+     * Returns a list of all the entities that descend from this entity. Includes the current entity.
+     */
+    getDescendants() {
+        let result = [this];
+        let queue = [this];
+        while (queue.length > 0) {
+            const curr = queue.pop();
+            queue = queue.concat(curr.children);
+            result = result.concat(curr.children);
+        }
+        return result;
+    }
+    /**
+     * Creates a deep copy of the entity and a copy of all its components
+     */
+    clone() {
+        const newEntity = new Entity();
+        for (const c of this.types) {
+            newEntity.addComponent(this.get(c).clone());
+        }
+        for (const child of this.children) {
+            newEntity.addChild(child.clone());
+        }
+        return newEntity;
+    }
+    /**
+     * Adds a copy of all the components from another template entity as a "prefab"
+     * @param templateEntity Entity to use as a template
+     * @param force Force component replacement if it already exists on the target entity
+     */
+    addTemplate(templateEntity, force = false) {
+        for (const c of templateEntity.getComponents()) {
+            this.addComponent(c.clone(), force);
+        }
+        for (const child of templateEntity.children) {
+            this.addChild(child.clone().addTemplate(child));
+        }
+        return this;
+    }
+    /**
+     * Adds a component to the entity
+     * @param component Component or Entity to add copy of components from
+     * @param force Optionally overwrite any existing components of the same type
+     */
+    addComponent(component, force = false) {
+        // if component already exists, skip if not forced
+        if (this.has(component.type)) {
+            if (force) {
+                // Remove existing component type if exists when forced
+                this.removeComponent(component);
+            }
+            else {
+                // early exit component exits
+                return this;
+            }
+        }
+        // TODO circular dependencies will be a problem
+        if (component.dependencies && component.dependencies.length) {
+            for (const ctor of component.dependencies) {
+                this.addComponent(new ctor());
+            }
+        }
+        component.owner = this;
+        const constuctorType = component.constructor;
+        this._componentTypeToInstance.set(constuctorType, component);
+        this._componentStringToInstance.set(component.type, component);
+        if (component.onAdd) {
+            component.onAdd(this);
+        }
+        this._notifyAddComponent(component);
+        return this;
+    }
+    /**
+     * Removes a component from the entity, by default removals are deferred to the end of entity update to avoid consistency issues
+     *
+     * Components can be force removed with the `force` flag, the removal is not deferred and happens immediately
+     * @param componentOrType
+     * @param force
+     */
+    removeComponent(componentOrType, force = false) {
+        if (force) {
+            if (typeof componentOrType === 'string') {
+                this._removeComponentByType(componentOrType);
+            }
+            else if (componentOrType instanceof Component) {
+                this._removeComponentByType(componentOrType.type);
+            }
+        }
+        else {
+            this._componentsToRemove.push(componentOrType);
+        }
+        return this;
+    }
+    _removeComponentByType(type) {
+        if (this.has(type)) {
+            const component = this.get(type);
+            component.owner = null;
+            if (component.onRemove) {
+                component.onRemove(this);
+            }
+            const ctor = component.constructor;
+            this._componentTypeToInstance.delete(ctor);
+            this._componentStringToInstance.delete(component.type);
+            this._notifyRemoveComponent(component);
+        }
+    }
+    /**
+     * @hidden
+     * @internal
+     */
+    processComponentRemoval() {
+        for (const componentOrType of this._componentsToRemove) {
+            const type = typeof componentOrType === 'string' ? componentOrType : componentOrType.type;
+            this._removeComponentByType(type);
+        }
+        this._componentsToRemove.length = 0;
+    }
+    has(type) {
+        if (typeof type === 'string') {
+            return this._componentStringToInstance.has(type);
+        }
+        else {
+            return this._componentTypeToInstance.has(type);
+        }
+    }
+    get(type) {
+        if (typeof type === 'string') {
+            return this._componentStringToInstance.get(type);
+        }
+        else {
+            return this._componentTypeToInstance.get(type);
+        }
+    }
+    /**
+     * Gets whether the actor is Initialized
+     */
+    get isInitialized() {
+        return this._isInitialized;
+    }
+    /**
+     * Initializes this entity, meant to be called by the Scene before first update not by users of Excalibur.
+     *
+     * It is not recommended that internal excalibur methods be overridden, do so at your own risk.
+     *
+     * @internal
+     */
+    _initialize(engine) {
+        if (!this.isInitialized) {
+            this.onInitialize(engine);
+            super.emit('initialize', new InitializeEvent(engine, this));
+            this._isInitialized = true;
+        }
+    }
+    /**
+     * It is not recommended that internal excalibur methods be overridden, do so at your own risk.
+     *
+     * Internal _preupdate handler for [[onPreUpdate]] lifecycle event
+     * @internal
+     */
+    _preupdate(engine, delta) {
+        this.emit('preupdate', new PreUpdateEvent(engine, delta, this));
+        this.onPreUpdate(engine, delta);
+    }
+    /**
+     * It is not recommended that internal excalibur methods be overridden, do so at your own risk.
+     *
+     * Internal _preupdate handler for [[onPostUpdate]] lifecycle event
+     * @internal
+     */
+    _postupdate(engine, delta) {
+        this.emit('postupdate', new PostUpdateEvent(engine, delta, this));
+        this.onPostUpdate(engine, delta);
+    }
+    /**
+     * `onInitialize` is called before the first update of the entity. This method is meant to be
+     * overridden.
+     *
+     * Synonymous with the event handler `.on('initialize', (evt) => {...})`
+     */
+    onInitialize(_engine) {
+        // Override me
+    }
+    /**
+     * Safe to override onPreUpdate lifecycle event handler. Synonymous with `.on('preupdate', (evt) =>{...})`
+     *
+     * `onPreUpdate` is called directly before an entity is updated.
+     */
+    onPreUpdate(_engine, _delta) {
+        // Override me
+    }
+    /**
+     * Safe to override onPostUpdate lifecycle event handler. Synonymous with `.on('postupdate', (evt) =>{...})`
+     *
+     * `onPostUpdate` is called directly after an entity is updated.
+     */
+    onPostUpdate(_engine, _delta) {
+        // Override me
+    }
+    /**
+     *
+     * Entity update lifecycle, called internally
+     *
+     * @internal
+     * @param engine
+     * @param delta
+     */
+    update(engine, delta) {
+        this._initialize(engine);
+        this._preupdate(engine, delta);
+        for (const child of this.children) {
+            child.update(engine, delta);
+        }
+        this._postupdate(engine, delta);
+    }
+}
+Entity._ID = 0;
+//# sourceMappingURL=Entity.js.map

package/build/dist/EntityComponentSystem/Entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../../../src/engine/EntityComponentSystem/Entity.ts"],"names":[],"mappings":"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"}

package/build/dist/EntityComponentSystem/EntityManager.js

@@ -0,0 +1,128 @@
+import { Entity, isAddedComponent, isRemovedComponent } from './Entity';
+import { Util } from '..';
+// Add/Remove entities and components
+export class EntityManager {
+    constructor(_world) {
+        this._world = _world;
+        this.entities = [];
+        this._entityIndex = {};
+        this._entitiesToRemove = [];
+    }
+    /**
+     * Runs the entity lifecycle
+     * @param _context
+     */
+    updateEntities(_context, elapsed) {
+        for (const entity of this.entities) {
+            // TODO is this right?
+            entity.update(_context.engine, elapsed);
+            if (!entity.active) {
+                this.removeEntity(entity);
+            }
+        }
+    }
+    findEntitiesForRemoval() {
+        for (const entity of this.entities) {
+            if (!entity.active) {
+                this.removeEntity(entity);
+            }
+        }
+    }
+    /**
+     * EntityManager observes changes on entities
+     * @param message
+     */
+    notify(message) {
+        if (isAddedComponent(message)) {
+            // we don't need the component, it's already on the entity
+            this._world.queryManager.addEntity(message.data.entity);
+        }
+        if (isRemovedComponent(message)) {
+            this._world.queryManager.removeComponent(message.data.entity, message.data.component);
+        }
+    }
+    /**
+     * Adds an entity to be tracked by the EntityManager
+     * @param entity
+     */
+    addEntity(entity) {
+        entity.active = true;
+        if (entity && !this._entityIndex[entity.id]) {
+            this._entityIndex[entity.id] = entity;
+            this.entities.push(entity);
+            this._world.queryManager.addEntity(entity);
+            entity.componentAdded$.register(this);
+            entity.componentRemoved$.register(this);
+            // if entity has children
+            entity.children.forEach((c) => this.addEntity(c));
+            entity.childrenAdded$.register({
+                notify: (e) => {
+                    this.addEntity(e);
+                }
+            });
+            entity.childrenRemoved$.register({
+                notify: (e) => {
+                    this.removeEntity(e, false);
+                }
+            });
+        }
+    }
+    removeEntity(idOrEntity, deferred = true) {
+        var _a;
+        let id = 0;
+        if (idOrEntity instanceof Entity) {
+            id = idOrEntity.id;
+        }
+        else {
+            id = idOrEntity;
+        }
+        const entity = this._entityIndex[id];
+        if (entity && entity.active) {
+            entity.kill();
+        }
+        if (entity && deferred) {
+            this._entitiesToRemove.push(entity);
+            return;
+        }
+        delete this._entityIndex[id];
+        if (entity) {
+            Util.removeItemFromArray(entity, this.entities);
+            this._world.queryManager.removeEntity(entity);
+            entity.componentAdded$.unregister(this);
+            entity.componentRemoved$.unregister(this);
+            // if entity has children
+            entity.children.forEach((c) => this.removeEntity(c, deferred));
+            entity.childrenAdded$.clear();
+            entity.childrenRemoved$.clear();
+            // stats
+            if ((_a = this._world.context) === null || _a === void 0 ? void 0 : _a.engine) {
+                this._world.context.engine.stats.currFrame.actors.killed++;
+            }
+        }
+    }
+    processEntityRemovals() {
+        for (const entity of this._entitiesToRemove) {
+            if (entity.active) {
+                continue;
+            }
+            this.removeEntity(entity, false);
+        }
+    }
+    processComponentRemovals() {
+        for (const entity of this.entities) {
+            entity.processComponentRemoval();
+        }
+    }
+    getById(id) {
+        return this._entityIndex[id];
+    }
+    getByName(name) {
+        return this.entities.filter(e => e.name === name);
+    }
+    clear() {
+        for (const entity of this.entities) {
+            this.removeEntity(entity);
+        }
+    }
+}
+//# sourceMappingURL=EntityManager.js.map

package/build/dist/EntityComponentSystem/EntityManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityManager.js","sourceRoot":"","sources":["../../../src/engine/EntityComponentSystem/EntityManager.ts"],"names":[],"mappings":"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"}

package/build/dist/EntityComponentSystem/Query.js

@@ -0,0 +1,91 @@
+import { Entity } from './Entity';
+import { buildTypeKey } from './Util';
+import { Observable } from '../Util/Observable';
+import { Util } from '..';
+import { AddedEntity, RemovedEntity } from './System';
+/**
+ * Represents query for entities that match a list of types that is cached and observable
+ *
+ * Queries can be strongly typed by supplying a type union in the optional type parameter
+ * ```typescript
+ * const queryAB = new ex.Query<ComponentTypeA | ComponentTypeB>(['A', 'B']);
+ * ```
+ */
+export class Query extends Observable {
+    constructor(types) {
+        super();
+        this._entities = [];
+        if (types[0] instanceof Function) {
+            this.types = types.map(T => (new T).type);
+        }
+        else {
+            this.types = types;
+        }
+    }
+    get key() {
+        if (this._key) {
+            return this._key;
+        }
+        return (this._key = buildTypeKey(this.types));
+    }
+    /**
+     * Returns a list of entities that match the query
+     *
+     * @param sort Optional sorting function to sort entities returned from the query
+     */
+    getEntities(sort) {
+        if (sort) {
+            this._entities.sort(sort);
+        }
+        return this._entities;
+    }
+    /**
+     * Add an entity to the query, will only be added if the entity matches the query types
+     * @param entity
+     */
+    addEntity(entity) {
+        if (!Util.contains(this._entities, entity) && this.matches(entity)) {
+            this._entities.push(entity);
+            this.notifyAll(new AddedEntity(entity));
+        }
+    }
+    /**
+     * If the entity is part of the query it will be removed regardless of types
+     * @param entity
+     */
+    removeEntity(entity) {
+        if (Util.removeItemFromArray(entity, this._entities)) {
+            this.notifyAll(new RemovedEntity(entity));
+        }
+    }
+    /**
+     * Removes all entities and observers from the query
+     */
+    clear() {
+        this._entities.length = 0;
+        for (const observer of this.observers) {
+            this.unregister(observer);
+        }
+    }
+    matches(typesOrEntity) {
+        let types = [];
+        if (typesOrEntity instanceof Entity) {
+            types = typesOrEntity.types;
+        }
+        else {
+            types = typesOrEntity;
+        }
+        let matches = true;
+        for (const type of this.types) {
+            matches = matches && types.indexOf(type) > -1;
+            if (!matches) {
+                return false;
+            }
+        }
+        return matches;
+    }
+    contain(type) {
+        return this.types.indexOf(type) > -1;
+    }
+}
+//# sourceMappingURL=Query.js.map