mani-game-engine 1.0.0-pre.4 → 1.0.0-pre.41

package/src/gameEngine.ts

@@ -1,350 +1,463 @@
-import {Action, Class, GameEnginePlugin, OnFixedUpdateParams, OnUpdateParams, Service, System} from './types';
-import {Signal, SignalBinding} from 'mani-signal';
-import {Entity} from './entity';
-import {ID, putIfAbsent} from 'mani-injector';
-import {EcsInjector, signalHandlers, staticSignalHandlers} from './ecsInjector';
-import {Clock} from './clock';
-
-type AddEntry = [Entity[], () => void];
-type RemoveEntry = [Entity[], () => void];
-
-const defaultOptions = {
-    fixedDeltaTime: 1 / 60,
-    plugins: [] as GameEnginePlugin[],
-};
-
-export type GameEngineOptions = Partial<typeof defaultOptions>;
-declare global {
-    interface GameEngineActions {
-        'testAction': string
-    }
-}
-
-type GameEngineActionParams<K extends keyof GameEngineActions> = GameEngineActions[K];
-type GameAction<K extends keyof GameEngineActions> = (engine: GameEngine, params: GameEngineActionParams<K>) => Promise<any> | any;
-
-export class GameEngine {
-    readonly onStart = new Signal();
-    readonly onRender = new Signal();
-    readonly onUpdate = new Signal<OnUpdateParams>();
-    readonly onPostPhysics = new Signal<OnFixedUpdateParams>();
-
-    private readonly onEarlyUpdateSet = new Set<System>();
-    private readonly onUpdateSet = new Set<System>();
-    private readonly onFixedUpdateSet = new Set<System>();
-    private readonly onPreFixedUpdateSet = new Set<System>();
-    private readonly onPhysicsUpdateSet = new Set<System>();
-    private readonly onPostPhysicsUpdateSet = new Set<System>();
-    private readonly onLateUpdateSet = new Set<System>();
-    private readonly onRenderUpdateSet = new Set<System>();
-
-    private readonly entitySystemMap = new Map<Object, System[]>();
-
-    private readonly serviceClasses = new Set<Class<Service>>();
-
-    private framePromise!: Promise<any>;
-    private resolveFrame: () => void = () => undefined;
-
-    private addQueue: AddEntry[] = [];
-    private removeQueue: RemoveEntry[] = [];
-
-    private _started = false;
-    get started(): boolean { return this._started; }
-
-    private _frameCount = 0;
-    get frameCount(): number { return this._frameCount; }
-
-// TODO inject clock into game engine
-// TODO inject space into game engine
-
-    static createDefault(options?: GameEngineOptions) {
-        const opts = {...defaultOptions, ...options};
-        const clock = new Clock({
-            fixedDeltaTime: opts.fixedDeltaTime,
-            autoStart: false
-        });
-        const injector = new EcsInjector<Class<System>>();
-        const engine = new GameEngine(injector, clock);
-        engine.installPlugins(opts.plugins);
-        return engine;
-    }
-
-    constructor(
-        readonly injector: EcsInjector<Class<System>>,
-        readonly clock: Clock,
-    ) {
-        this.injector.map(GameEngine).toValue(this);
-        this.setupClock();
-        this.prepareFrame();
-    }
-
-    private setupClock() {
-        this.clock.onPrepare.add(this.prepareFrame, this);
-
-        this.clock.onEarlyUpdate.add(({time, deltaTime}) => {
-            for (const system of this.onEarlyUpdateSet) {
-                system.onEarlyUpdate!(time, deltaTime);
-            }
-        });
-
-        this.clock.onFixedUpdate.add(({time, deltaTime}) => {
-            for (const system of this.onPreFixedUpdateSet) {
-                system.onPreFixedUpdate!();
-            }
-            for (const system of this.onFixedUpdateSet) {
-                system.onFixedUpdate!(time, deltaTime);
-            }
-            for (const system of this.onPhysicsUpdateSet) {
-                system.onPhysicsUpdate!(time, deltaTime);
-            }
-            this.onPostPhysics.dispatch({time, deltaTime});
-            for (const system of this.onPostPhysicsUpdateSet) {
-                system.onPostPhysicsUpdate!(time, deltaTime);
-            }
-        });
-
-        // TODO: update from outside
-        this.clock.onUpdate.add(({time, deltaTime, alpha}) => {
-            for (const system of this.onUpdateSet) {
-
-                system.onUpdate!(time, deltaTime, alpha);
-            }
-            //TODO: merge with framerate to single signal?
-            this.onUpdate.dispatch({time, deltaTime, alpha});
-            for (const system of this.onLateUpdateSet) {
-                system.onLateUpdate!(time, deltaTime, alpha);
-            }
-
-            //
-            // const drawTime = 1 / 30;
-            // while (performance.now() < ts + drawTime * 1000) {
-            //
-            // }
-            for (const system of this.onRenderUpdateSet) {
-                system.onRender!();
-            }
-            this.onRender.dispatch();
-            this._frameCount++;
-        });
-    }
-
-    private installPlugins(plugins: GameEnginePlugin[]) {
-        plugins.forEach(plugin => {
-            plugin.onPrepare && plugin.onPrepare(this);
-        });
-        plugins.forEach(plugin => {
-            plugin.onStart && plugin.onStart(this);
-        });
-    }
-
-    registerSystem(systemClass: Class<System>): void {
-        this.mapStaticAnnotatedSignals(systemClass);
-        if (this._started) throw new Error('Register Systems before engine is started');
-        this.injector.registerSystem(systemClass);
-    }
-
-    registerService(serviceClass: Class<Service>): void {
-        this.mapStaticAnnotatedSignals(serviceClass);
-        if (this._started) throw new Error('Register Services before engine is started');
-        this.injector.map(serviceClass).toSingleton();
-        this.serviceClasses.add(serviceClass);
-    }
-
-    getService<T extends Class<Service>>(serviceClass: T): InstanceType<T> {
-        return this.injector.get(serviceClass);
-    }
-
-    start() {
-        this._started = true;
-        //TODO: throw when registering services or systems when engine is running
-        for (const serviceClass of this.serviceClasses) {
-            const service = this.injector.get(serviceClass);
-            this.addService(service);
-        }
-        this.clock.start();
-        this.onStart.dispatch();
-    }
-
-    addService(service: Service): void {
-        this.mapAnnotatedSignals(service);
-        service.onStart && service.onStart();
-        service.onPreFixedUpdate && this.onPreFixedUpdateSet.add(service);
-        service.onFixedUpdate && this.onFixedUpdateSet.add(service);
-        service.onUpdate && this.onUpdateSet.add(service);
-        service.onLateUpdate && this.onLateUpdateSet.add(service);
-        service.onPhysicsUpdate && this.onPhysicsUpdateSet.add(service);
-        service.onPostPhysicsUpdate && this.onPostPhysicsUpdateSet.add(service);
-        service.onRender && this.onRenderUpdateSet.add(service);
-    }
-
-    addEntity(entity: Entity) {
-        return new Promise(resolve => this.addQueue.push([entity.getAllChildren(), resolve]));
-    }
-
-    waitFrame() {
-        return this.framePromise;
-    }
-
-    async removeEntity(entity: Entity) {
-        if ((<any>entity).markRemoval) return;
-        (<any>entity).markRemoval = true;
-        return new Promise(resolve => this.removeQueue.push([entity.getAllChildren(), resolve]));
-    }
-
-    private prepareFrame() {
-
-        for (const [entities, resolve] of this.removeQueue) {
-            for (const entity of entities) {
-                (<any>entity).markRemoval = false;
-                if (!(<any>entity).gameEngine) throw new Error('Entity not active');
-                (<any>entity).gameEngine = undefined;
-
-                const systems = this.entitySystemMap.get(entity);
-                this.entitySystemMap.delete(entity);
-                if (systems) {
-                    for (const system of systems) {
-                        this.unmapAnnotatedSignals(system);
-                        system.onEnd && system.onEnd();
-                        system.onPreFixedUpdate && this.onPreFixedUpdateSet.delete(system);
-                        system.onFixedUpdate && this.onFixedUpdateSet.delete(system);
-                        system.onEarlyUpdate && this.onEarlyUpdateSet.delete(system);
-                        system.onUpdate && this.onUpdateSet.delete(system);
-                        system.onLateUpdate && this.onLateUpdateSet.delete(system);
-                        system.onPhysicsUpdate && this.onPhysicsUpdateSet.delete(system);
-                        system.onPostPhysicsUpdate && this.onPostPhysicsUpdateSet.delete(system);
-                        system.onRender && this.onRenderUpdateSet.delete(system);
-                    }
-                }
-                entity.onRemove.dispatch();
-            }
-
-            resolve();
-        }
-        this.removeQueue = [];
-
-        for (const [entities, resolve] of this.addQueue) {
-            const preparePromises = [];
-            const newSystems: System[] = [];
-            for (const entity of entities) {
-                if ((<any>entity).gameEngine) throw new Error('Entity already added to a gameEngine');
-                (<any>entity).gameEngine = this;
-                const systems = this.injector.createSystems(entity);
-                for (const system of systems) {
-                    system.onPrepare && preparePromises.push(system.onPrepare());
-                    newSystems.push(system);
-                }
-                this.entitySystemMap.set(entity, systems);
-            }
-
-            const startSystems = () => {
-                // TODO: check if a "global" method is faster than this inner method
-                for (const system of newSystems) {
-                    this.mapAnnotatedSignals(system);
-                    system.onStart && system.onStart();
-                    system.onPreFixedUpdate && this.onPreFixedUpdateSet.add(system);
-                    system.onFixedUpdate && this.onFixedUpdateSet.add(system);
-                    system.onEarlyUpdate && this.onEarlyUpdateSet.add(system);
-                    system.onUpdate && this.onUpdateSet.add(system);
-                    system.onLateUpdate && this.onLateUpdateSet.add(system);
-                    system.onPhysicsUpdate && this.onPhysicsUpdateSet.add(system);
-                    system.onPostPhysicsUpdate && this.onPostPhysicsUpdateSet.add(system);
-                    system.onRender && this.onRenderUpdateSet.add(system);
-                }
-                resolve();
-            };
-
-            // Promise.all doesnt resolve immediately when there are no promises bu
-            if (preparePromises.length === 0) {
-                startSystems();
-            } else {
-                Promise.all(preparePromises).then(startSystems);
-            }
-        }
-        this.addQueue = [];
-        // create promise for next frame
-        this.resolveFrame();
-        this.framePromise = new Promise<any>(resolve => {
-            this.resolveFrame = resolve;
-        });
-    }
-
-    runAction<T extends Action>(action: T): ReturnType<T> {
-        return action(this);
-    }
-
-    getSignal<T>(signalId: ID): Signal<T> {
-        return this.injector.getSignal<T>(signalId);
-    }
-
-    private signalMappings = new Map<Class, [string, Signal][]>();
-    private staticSignalMappings = new Map<Class, [string, Signal][]>();
-    private signalMapBindings = new Map<Object, SignalBinding[]>();
-    // TODO: staticSignalMapBindings needed if we want to unregister Services or Systems
-
-    private mapStaticAnnotatedSignals(target: Class) {
-        let staticSignalMap = this.getStaticSignalMap(target);
-        if (staticSignalMap.length === 0) return;
-
-        const bindings = [];
-        for (const [key, signal] of staticSignalMap) {
-            bindings.push(signal.add((<any>target)[key], target));
-        }
-        // TODO: ignore bindings for now (store them if we implement unregister Service or Systems
-    }
-
-    private mapAnnotatedSignals(target: Object) {
-        const signalMap = this.getSignalMap(target.constructor);
-        if (signalMap.length === 0) return;
-
-        const bindings = [];
-        for (const [key, signal] of signalMap) {
-            bindings.push(signal.add((<any>target)[key], target));
-        }
-        this.signalMapBindings.set(target, bindings);
-    }
-
-    private unmapAnnotatedSignals(target: Object) {
-        const signalBindings = this.signalMapBindings.get(target);
-        if (!signalBindings) return;
-        for (const binding of signalBindings) {
-            binding.detach();
-        }
-    }
-
-    private getSignalMap(target: Function) {
-        // TODO: we could speed thinks up by introducing "invisible" flags on the systems/services to avoid a map check
-        return putIfAbsent(this.signalMappings, target, (): [string, Signal][] => {
-            const handlers = signalHandlers.get(target);
-            if (!handlers) return [];
-            const result: [string, Signal][] = [];
-            for (const [key, signalId] of handlers) {
-                result.push([key, this.getSignal(signalId)]);
-            }
-            return result;
-        });
-    }
-
-    private getStaticSignalMap(target: Class) {
-        // TODO: we could speed thinks up by introducing "invisible" flags on the systems/services to avoid a map check
-        return putIfAbsent(this.staticSignalMappings, target, (): [string, Signal][] => {
-            const handlers = staticSignalHandlers.get(target);
-            if (!handlers) return [];
-            const result: [string, Signal][] = [];
-            for (const [key, signalId] of handlers) {
-                result.push([key, this.getSignal(signalId)]);
-            }
-            return result;
-        });
-    }
-}
-//
-// type RunSpread<T> = T extends undefined
-//     ? []
-//     : [T];
-//
-// export type GameActionMapping = { id: string, action: GameAction<any> }
-//
-// export function createGameAction<K extends keyof GameEngineActions>(id: K, action: GameAction<K>): GameActionMapping {
-//     return {id, action};
-// }
-//
+import {Action, Class, EngineSignals, GameEnginePlugin, OnFixedUpdateParams, OnUpdateParams, Service, System} from './types';
+import {Signal, SignalBinding} from 'mani-signal';
+import {Entity} from './entity';
+import {EcsInjector, signalHandlers, staticSignalHandlers} from './ecsInjector';
+import {Clock, GameClock} from './clock';
+import {SystemContext} from './systemContext';
+import {ID, putIfAbsent} from './injector';
+
+type AddEntry = [Entity, () => void];
+type RemoveEntry = [Entity, () => void];
+
+const defaultOptions = {
+    fixedDeltaTime: 1 / 60,
+    plugins: [] as GameEnginePlugin[],
+};
+
+export type GameEngineOptions = Partial<typeof defaultOptions>;
+declare global {
+    interface GameEngineActions {
+        'testAction': string;
+    }
+}
+
+type GameEngineActionParams<K extends keyof GameEngineActions> = GameEngineActions[K];
+type GameAction<K extends keyof GameEngineActions> = (engine: GameEngine, params: GameEngineActionParams<K>) => Promise<any> | any;
+
+let id = 0;
+export class GameEngine {
+    readonly id = id++;
+    readonly onPrepare: Signal;
+    readonly onStart: Signal;
+    readonly onEnd: Signal;
+    readonly onRender: Signal<OnUpdateParams>;
+    readonly onUpdate: Signal<OnUpdateParams>;
+    readonly onFixedUpdate: Signal<OnFixedUpdateParams>;
+    readonly onPrePhysicsUpdate: Signal<OnFixedUpdateParams>;
+    readonly onPhysicsUpdate: Signal<OnFixedUpdateParams>;
+    readonly onPostPhysicsUpdate: Signal<OnFixedUpdateParams>;
+    readonly onLateFixedUpdate: Signal<OnFixedUpdateParams>;
+    readonly onLateUpdate: Signal<OnUpdateParams>;
+    readonly onAddEntity: Signal<Entity>;
+    readonly onRemoveEntity: Signal<Entity>;
+
+
+    private readonly onEarlyUpdateSet = new Set<System>();
+    private readonly onUpdateSet = new Set<System>();
+    private readonly onFixedUpdateSet = new Set<System>();
+    private readonly onPreFixedUpdateSet = new Set<System>();
+    private readonly onPhysicsUpdateSet = new Set<System>();
+    private readonly onPrePhysicsUpdateSet = new Set<System>();
+    private readonly onPostPhysicsUpdateSet = new Set<System>();
+    private readonly onLateFixedUpdateSet = new Set<System>();
+    private readonly onLateUpdateSet = new Set<System>();
+    private readonly onRenderUpdateSet = new Set<System>();
+    private readonly onAddEntitySet = new Set<System>();
+    private readonly onRemoveEntitySet = new Set<System>();
+
+
+    // TODO: for performance, we could store the systems directly in the entity
+    private readonly entitySystemMap = new Map<Entity, Set<SystemContext>>();
+
+    private readonly serviceClasses = new Set<Class<Service>>();
+    private readonly services: Service[] = [];
+
+    private framePromise!: Promise<any>;
+    private resolveFrame: () => void = () => undefined;
+
+    private addQueue: AddEntry[] = [];
+    private removeQueue: RemoveEntry[] = [];
+
+    private _started = false;
+
+
+    get started(): boolean { return this._started; }
+
+    private _frameCount = 0;
+    get frameCount(): number { return this._frameCount; }
+
+    private _fixedFrameCount = 0;
+    get fixedFrameCount(): number { return this._fixedFrameCount; }
+
+    get numEntities(): number { return this.entitySystemMap.size;}
+
+// TODO inject clock into game engine
+// TODO inject space into game engine
+
+    constructor(
+        readonly injector: EcsInjector<Class<System>>,
+        readonly clock: Clock,
+    ) {
+        this.injector.map(GameEngine).toValue(this);
+
+        this.onPrepare = this.injector.getSignal(EngineSignals.OnPrepare);
+        this.onStart = this.injector.getSignal(EngineSignals.OnStart);
+        this.onEnd = this.injector.getSignal(EngineSignals.OnEnd);
+        this.onRender = this.injector.getSignal(EngineSignals.OnRender);
+        this.onFixedUpdate = this.injector.getSignal(EngineSignals.OnFixedUpdate);
+        this.onUpdate = this.injector.getSignal(EngineSignals.OnUpdate);
+        this.onLateUpdate = this.injector.getSignal(EngineSignals.OnLateUpdate);
+        this.onPrePhysicsUpdate = this.injector.getSignal(EngineSignals.OnPrePhysicsUpdate);
+        this.onPhysicsUpdate = this.injector.getSignal(EngineSignals.OnPhysicsUpdate);
+        this.onPostPhysicsUpdate = this.injector.getSignal(EngineSignals.OnPostPhysicsUpdate);
+        this.onLateFixedUpdate = this.injector.getSignal(EngineSignals.onLateFixedUpdate);
+
+        this.onAddEntity = this.injector.getSignal(EngineSignals.OnAddEntity);
+        this.onRemoveEntity = this.injector.getSignal(EngineSignals.OnRemoveEntity);
+
+        this.setupClock();
+        this.prepareFrame();
+    }
+
+    static createDefault(options?: GameEngineOptions) {
+        const opts = {...defaultOptions, ...options};
+        const clock = new GameClock({
+            fixedDeltaTime: opts.fixedDeltaTime,
+            autoStart: false,
+        });
+        const injector = new EcsInjector<Class<System>>();
+        const engine = new GameEngine(injector, clock);
+        engine.installPlugins(opts.plugins);
+        return engine;
+    }
+
+    static createDefaultWithInjector(injector: EcsInjector<Class<System>>, options?: GameEngineOptions) {
+        const opts = {...defaultOptions, ...options};
+        const clock = new GameClock({
+            fixedDeltaTime: opts.fixedDeltaTime,
+            autoStart: false,
+        });
+        const engine = new GameEngine(injector, clock);
+        engine.installPlugins(opts.plugins);
+        return engine;
+    }
+
+    addService(service: Service): void {
+        this.mapAnnotatedSignals(service);
+        service.onStart && service.onStart();
+        service.onPreFixedUpdate && this.onPreFixedUpdateSet.add(service);
+        service.onFixedUpdate && this.onFixedUpdateSet.add(service);
+        service.onUpdate && this.onUpdateSet.add(service);
+        service.onLateUpdate && this.onLateUpdateSet.add(service);
+        service.onPrePhysicsUpdate && this.onPrePhysicsUpdateSet.add(service);
+        service.onPhysicsUpdate && this.onPhysicsUpdateSet.add(service);
+        service.onPostPhysicsUpdate && this.onPostPhysicsUpdateSet.add(service);
+        service.onLateFixedUpdate && this.onLateFixedUpdateSet.add(service);
+        service.onRender && this.onRenderUpdateSet.add(service);
+        service.onAddEntity && this.onAddEntitySet.add(service);
+        service.onRemoveEntity && this.onRemoveEntitySet.add(service);
+        this.services.push(service);
+    }
+
+    installPlugins(plugins: GameEnginePlugin[]) {
+        plugins.forEach(plugin => {
+            plugin.onPrepare && plugin.onPrepare(this);
+        });
+        plugins.forEach(plugin => {
+            plugin.onStart && plugin.onStart(this);
+        });
+    }
+
+    registerSystem(systemClass: Class<System>): void {
+        this.mapStaticAnnotatedSignals(systemClass);
+        if (this._started) throw new Error('Register Systems before engine is started');
+        this.injector.registerSystem(systemClass);
+    }
+
+    registerService(serviceClass: Class<Service>): void {
+        this.mapStaticAnnotatedSignals(serviceClass);
+        if (this._started) throw new Error('Register Services before engine is started');
+        this.injector.map(serviceClass).toSingleton();
+        this.serviceClasses.add(serviceClass);
+    }
+
+    getService<T extends Class<Service>>(serviceClass: T): InstanceType<T> {
+        return this.injector.get(serviceClass);
+    }
+
+    start() {
+        this._started = true;
+        //TODO: throw when registering services or systems when engine is running
+        for (const serviceClass of this.serviceClasses) {
+            const service = this.injector.get(serviceClass);
+            this.addService(service);
+        }
+        this.clock.start();
+        this.onStart.dispatch();
+    }
+
+    private setupClock() {
+        this.clock.onPrepare.add(this.prepareFrame, this);
+
+        this.clock.onEarlyUpdate.add(({time, deltaTime}) => {
+            for (const system of this.onEarlyUpdateSet) {
+                system.onEarlyUpdate!(time, deltaTime);
+            }
+        });
+
+        this.clock.onFixedUpdate.add((params) => {
+            const {time, deltaTime} = params;
+            for (const system of this.onPreFixedUpdateSet) {
+                system.onPreFixedUpdate!(time, deltaTime);
+            }
+            for (const system of this.onFixedUpdateSet) {
+                system.onFixedUpdate!(time, deltaTime);
+            }
+            this.onFixedUpdate.dispatch(params);
+            for (const system of this.onPhysicsUpdateSet) {
+                system.onPhysicsUpdate!(time, deltaTime);
+            }
+            this.onPhysicsUpdate.dispatch(params);
+            this.onPostPhysicsUpdate.dispatch(params);
+            for (const system of this.onPostPhysicsUpdateSet) {
+                system.onPostPhysicsUpdate!(time, deltaTime);
+            }
+            this.onLateFixedUpdate.dispatch(params);
+            for (const system of this.onLateFixedUpdateSet) {
+                system.onLateFixedUpdate!(time, deltaTime);
+            }
+            this._fixedFrameCount++;
+        });
+
+        // TODO: update from outside
+        this.clock.onUpdate.add(onUpdateParams => {
+            const {time, deltaTime, alpha} = onUpdateParams;
+            for (const system of this.onUpdateSet) {
+                system.onUpdate!(time, deltaTime, alpha);
+            }
+            //TODO: merge with framerate to single signal?
+
+            this.onUpdate.dispatch(onUpdateParams);
+            for (const system of this.onLateUpdateSet) {
+                system.onLateUpdate!(time, deltaTime, alpha);
+            }
+            this.onLateUpdate.dispatch(onUpdateParams);
+
+            for (const system of this.onRenderUpdateSet) {
+                system.onRender!(time, deltaTime, alpha);
+            }
+            this.onRender.dispatch(onUpdateParams);
+            this._frameCount++;
+        });
+    }
+
+    add(entity: Entity) {
+        return new Promise<void>(resolve => this.addQueue.push([entity, resolve]));
+    }
+
+    waitFrame() {
+        return this.framePromise;
+    }
+
+    async remove(entity: Entity) {
+        if ((<any>entity).markRemoval) return;
+        (<any>entity).markRemoval = true;
+        return new Promise<void>(resolve => this.removeQueue.push([entity, resolve]));
+    }
+
+    stop() {
+        // this.injector.dispose();
+        this.clock.stop();
+    }
+
+    runAction<T extends Action>(action: T): ReturnType<T> {
+        return action(this);
+    }
+
+    getSignal<T>(signalId: ID): Signal<T> {
+        return this.injector.getSignal<T>(signalId);
+    }
+
+    private signalMappings = new Map<Class, [string, Signal][]>();
+    private staticSignalMappings = new Map<Class, [string, Signal][]>();
+    private signalMapBindings = new Map<Object, SignalBinding[]>();
+
+    // TODO: staticSignalMapBindings needed if we want to unregister Services or Systems
+
+    private mapStaticAnnotatedSignals(target: Class) {
+        let staticSignalMap = this.getStaticSignalMap(target);
+        if (staticSignalMap.length === 0) return;
+
+        const bindings = [];
+        for (const [key, signal] of staticSignalMap) {
+            bindings.push(signal.add((<any>target)[key], target));
+        }
+        // TODO: ignore bindings for now (store them if we implement unregister Service or Systems
+    }
+
+    private mapAnnotatedSignals(target: Object) {
+        const signalMap = this.getSignalMap(target.constructor);
+        if (signalMap.length === 0) return;
+
+        const bindings = [];
+        for (const [key, signal] of signalMap) {
+            bindings.push(signal.add((<any>target)[key], target));
+        }
+        this.signalMapBindings.set(target, bindings);
+    }
+
+    private unmapAnnotatedSignals(target: Object) {
+        const signalBindings = this.signalMapBindings.get(target);
+        if (!signalBindings) return;
+        for (const binding of signalBindings) {
+            binding.detach();
+        }
+    }
+
+    private getSignalMap(target: Function) {
+        // TODO: we could speed thinks up by introducing "invisible" flags on the systems/services to avoid a map check
+        return putIfAbsent(this.signalMappings, target, (): [string, Signal][] => {
+            const handlers = signalHandlers.get(target);
+            if (!handlers) return [];
+            const result: [string, Signal][] = [];
+            for (const [key, signalId] of handlers) {
+                result.push([key, this.getSignal(signalId)]);
+            }
+            return result;
+        });
+    }
+
+    private getStaticSignalMap(target: Class) {
+        // TODO: we could speed thinks up by introducing "invisible" flags on the systems/services to avoid a map check
+        return putIfAbsent(this.staticSignalMappings, target, (): [string, Signal][] => {
+            const handlers = staticSignalHandlers.get(target);
+            if (!handlers) return [];
+            const result: [string, Signal][] = [];
+            for (const [key, signalId] of handlers) {
+                result.push([key, this.getSignal(signalId)]);
+            }
+            return result;
+        });
+    }
+
+    dispose() {
+        this.clock.stop();
+        this.clock.dispose();
+        for (const systems of this.entitySystemMap.values()) {
+            for (const system of systems) {
+                system.system.onEnd && system.system.onEnd();
+            }
+        }
+        for (const service of this.services) {
+            service.onEnd && service.onEnd();
+        }
+        this.onEnd.dispatch();
+    }
+
+    private prepareFrame() {
+        for (const [entity, resolve] of this.removeQueue) {
+            const entities = entity.getAllEntities();
+            for (const entity of entities) {
+                (<any>entity).markRemoval = false;
+                if (!(<any>entity).gameEngine) {
+                    console.log(entity);
+                    // throw new Error('Entity not active');
+                }
+                (<any>entity).gameEngine = undefined;
+
+                const systemContexts = this.entitySystemMap.get(entity);
+                this.entitySystemMap.delete(entity);
+                if (systemContexts) {
+                    for (const context of systemContexts) {
+                        this.disposeContext(context);
+                    }
+                }
+                entity.onRemove.dispatch();
+                entity.onRemove.detachAll();
+
+                for (const system of this.onRemoveEntitySet) {
+                    system.onRemoveEntity!(entity);
+                }
+            }
+
+            resolve();
+        }
+        this.removeQueue = [];
+
+        for (const [entity, resolve] of this.addQueue) {
+
+            const preparePromises = [];
+            const nextSystemContexts: SystemContext[] = [];
+            const entities = entity.getAllEntities();
+            for (const entity of entities) {
+                if ((<any>entity).gameEngine) throw new Error('Entity already added to a gameEngine');
+                (<any>entity).gameEngine = this;
+                const systemContexts = this.injector.createSystemsForEntity(entity);
+                for (const context of systemContexts) {
+                    // TODO: implement synced mode where async onPrepares aren't allowed
+                    context.system.onPrepare && preparePromises.push(context.system.onPrepare());
+                    nextSystemContexts.push(context);
+                }
+                this.entitySystemMap.set(entity, systemContexts);
+            }
+
+            const entityWasAdded = ()=> {
+                for (const system of this.onAddEntitySet) {
+                    system.onAddEntity!(entity);
+                }
+                resolve();
+            }
+
+            // Promise.all doesnt resolve immediately when there are no promises bu
+            if (preparePromises.length === 0) {
+                this.startSystems(nextSystemContexts, entityWasAdded);
+            } else {
+                Promise.all(preparePromises).then(() => this.startSystems(nextSystemContexts, entityWasAdded));
+            }
+        }
+        this.addQueue = [];
+        // create promise for next frame
+        this.resolveFrame();
+        this.framePromise = new Promise<void>(resolve => {
+            this.resolveFrame = resolve;
+        });
+        this.onPrepare.dispatch();
+    }
+
+    private startSystems(contexts: Iterable<SystemContext>, then?: () => void) {
+        for (const context of contexts) {
+            const system = context.system;
+            this.mapAnnotatedSignals(system);
+            system.onStart && system.onStart();
+            system.onPreFixedUpdate && this.onPreFixedUpdateSet.add(system);
+            system.onFixedUpdate && this.onFixedUpdateSet.add(system);
+            system.onUpdate && this.onUpdateSet.add(system);
+            system.onLateUpdate && this.onLateUpdateSet.add(system);
+            system.onPhysicsUpdate && this.onPhysicsUpdateSet.add(system);
+            system.onPrePhysicsUpdate && this.onPrePhysicsUpdateSet.add(system);
+            system.onPostPhysicsUpdate && this.onPostPhysicsUpdateSet.add(system);
+            system.onLateFixedUpdate && this.onLateFixedUpdateSet.add(system);
+            system.onRender && this.onRenderUpdateSet.add(system);
+            system.onAddEntity && this.onAddEntitySet.add(system);
+            system.onRemoveEntity && this.onRemoveEntitySet.add(system);
+        }
+        then?.();
+    };
+
+    private disposeContext(context: SystemContext<System>) {
+        context.dispose();
+        const system = context.system;
+        this.unmapAnnotatedSignals(system);
+        system.onEnd && system.onEnd();
+        system.onPreFixedUpdate && this.onPreFixedUpdateSet.delete(system);
+        system.onFixedUpdate && this.onFixedUpdateSet.delete(system);
+        system.onUpdate && this.onUpdateSet.delete(system);
+        system.onLateUpdate && this.onLateUpdateSet.delete(system);
+        system.onPhysicsUpdate && this.onPhysicsUpdateSet.delete(system);
+        system.onPrePhysicsUpdate && this.onPrePhysicsUpdateSet.delete(system);
+        system.onPostPhysicsUpdate && this.onPostPhysicsUpdateSet.delete(system);
+        system.onLateFixedUpdate && this.onLateFixedUpdateSet.delete(system);
+        system.onRender && this.onRenderUpdateSet.delete(system);
+    }
+}
+//
+// type RunSpread<T> = T extends undefined
+//     ? []
+//     : [T];
+//
+// export type GameActionMapping = { id: string, action: GameAction<any> }
+//
+// export function createGameAction<K extends keyof GameEngineActions>(id: K, action: GameAction<K>): GameActionMapping {
+//     return {id, action};
+// }
+//