@gg-web-engine/core 0.0.3 → 0.0.5

package/dist/base/entities/gg-entity.js

@@ -1,11 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GgEntity = void 0;
+exports.GgEntity = exports.GGTickOrder = void 0;
 const rxjs_1 = require("rxjs");
+/**
+ * Engine's default tick orders: the less value, the earlier tick will be run.
+ */
+var GGTickOrder;
+(function (GGTickOrder) {
+    GGTickOrder[GGTickOrder["INPUT_CONTROLLERS"] = 0] = "INPUT_CONTROLLERS";
+    GGTickOrder[GGTickOrder["PHYSICS_SIMULATION"] = 200] = "PHYSICS_SIMULATION";
+    GGTickOrder[GGTickOrder["OBJECTS_BINDING"] = 400] = "OBJECTS_BINDING";
+    GGTickOrder[GGTickOrder["ANIMATION_MIXERS"] = 600] = "ANIMATION_MIXERS";
+    GGTickOrder[GGTickOrder["CONTROLLERS"] = 800] = "CONTROLLERS";
+    GGTickOrder[GGTickOrder["RENDERING"] = 1000] = "RENDERING";
+    GGTickOrder[GGTickOrder["POST_RENDERING"] = 1200] = "POST_RENDERING";
+})(GGTickOrder = exports.GGTickOrder || (exports.GGTickOrder = {}));
 class GgEntity {
     constructor() {
+        /**
+         * will receive [elapsed time, delta] of each world clock tick
+         */
+        this.tick$ = new rxjs_1.Subject();
+        /**
+         * a world reference, where this entity was added to
+         */
         this._world = null;
-        this._name = '';
+        this._name = '0x' + (GgEntity.default_name_counter++).toString(16);
+        /**
+         * The flag whether entity should listen to ticks. If set to false, ticks will not be propagated to this entity
+         * */
+        this._active = true;
         this._children = [];
         this._onSpawned$ = new rxjs_1.Subject();
         this._onRemoved$ = new rxjs_1.Subject();
@@ -19,6 +43,12 @@ class GgEntity {
     set name(value) {
         this._name = value;
     }
+    get active() {
+        return this._active;
+    }
+    set active(value) {
+        this._active = value;
+    }
     addChildren(...entities) {
         this._children.push(...entities);
         if (this._world) {
@@ -52,11 +82,16 @@ class GgEntity {
     }
     // TODO add some flag to entity that it is disposed, and throw a normal error when trying to add such entity to world again
     dispose() {
+        if (this.world) {
+            this.world.removeEntity(this);
+        }
         this._onSpawned$.complete();
         this._onRemoved$.complete();
+        this.tick$.complete();
         for (const c of this._children) {
             c.dispose();
         }
     }
 }
 exports.GgEntity = GgEntity;
+GgEntity.default_name_counter = 0;

package/dist/base/entities/inline-controller.js

@@ -7,14 +7,9 @@ class InlineTickController extends gg_entity_1.GgEntity {
     constructor(tickOrder) {
         super();
         this.tickOrder = tickOrder;
-        this.tick$ = new rxjs_1.Subject();
-    }
-    dispose() {
-        super.dispose();
-        this.tick$.complete();
     }
 }
-function createInlineTickController(world, tickOrder = 750) {
+function createInlineTickController(world, tickOrder = gg_entity_1.GGTickOrder.CONTROLLERS) {
     const controller = new InlineTickController(tickOrder);
     world.addEntity(controller);
     return controller.tick$.pipe((0, rxjs_1.finalize)(() => {

package/dist/base/entities/interfaces/i-tick-listener.d.ts

@@ -1,7 +1,31 @@
 import { Subject } from 'rxjs';
 import { GgEntity } from '../gg-entity';
+/**
+ * Engine's default tick orders: the less value, the earlier tick will be run.
+ */
+export declare enum GGTickOrder {
+    INPUT_CONTROLLERS = 0,
+    PHYSICS_SIMULATION = 200,
+    OBJECTS_BINDING = 400,
+    ANIMATION_MIXERS = 600,
+    CONTROLLERS = 800,
+    RENDERING = 1000,
+    POST_RENDERING = 1200
+}
+/**
+ * An interface for world entities, which need to do some routine on each world clock tick
+ */
 export interface ITickListener {
+    /**
+     * will receive [elapsed time, delta] of each world clock tick
+     */
     tick$: Subject<[number, number]>;
-    readonly tickOrder: number;
+    /**
+     * the priority of ticker: the less value, the earlier tick will be run.
+     */
+    readonly tickOrder: GGTickOrder | number;
 }
+/**
+ * A function which determines whether entity implements ITickListener interface
+ */
 export declare const isITickListener: (entity: GgEntity) => boolean;

package/dist/base/entities/interfaces/i-tick-listener.js

@@ -1,6 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isITickListener = void 0;
+exports.isITickListener = exports.GGTickOrder = void 0;
 const rxjs_1 = require("rxjs");
+/**
+ * Engine's default tick orders: the less value, the earlier tick will be run.
+ */
+var GGTickOrder;
+(function (GGTickOrder) {
+    GGTickOrder[GGTickOrder["INPUT_CONTROLLERS"] = 0] = "INPUT_CONTROLLERS";
+    GGTickOrder[GGTickOrder["PHYSICS_SIMULATION"] = 200] = "PHYSICS_SIMULATION";
+    GGTickOrder[GGTickOrder["OBJECTS_BINDING"] = 400] = "OBJECTS_BINDING";
+    GGTickOrder[GGTickOrder["ANIMATION_MIXERS"] = 600] = "ANIMATION_MIXERS";
+    GGTickOrder[GGTickOrder["CONTROLLERS"] = 800] = "CONTROLLERS";
+    GGTickOrder[GGTickOrder["RENDERING"] = 1000] = "RENDERING";
+    GGTickOrder[GGTickOrder["POST_RENDERING"] = 1200] = "POST_RENDERING";
+})(GGTickOrder = exports.GGTickOrder || (exports.GGTickOrder = {}));
+/**
+ * A function which determines whether entity implements ITickListener interface
+ */
 const isITickListener = entity => (entity === null || entity === void 0 ? void 0 : entity.tick$) instanceof rxjs_1.Subject;
 exports.isITickListener = isITickListener;

package/dist/base/gg-viewport-manager.d.ts

@@ -14,5 +14,6 @@ export declare class GgViewportManager {
     private getStageAsync;
     createCanvas(zIndex: number): Promise<HTMLCanvasElement>;
     registerCanvas(canvas: HTMLCanvasElement, zIndex: number): Promise<void>;
+    deregisterCanvas(canvas: HTMLCanvasElement): Promise<void>;
     assignRendererToCanvas(renderer: BaseGgRenderer, canvas: HTMLCanvasElement): Promise<void>;
 }

package/dist/base/gg-viewport-manager.js

@@ -97,6 +97,16 @@ class GgViewportManager {
             canvas.height = size.y;
         });
     }
+    deregisterCanvas(canvas) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (const index in this.canvases) {
+                if (this.canvases[index].canvas === canvas) {
+                    delete this.canvases[index];
+                    break;
+                }
+            }
+        });
+    }
     assignRendererToCanvas(renderer, canvas) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!gg_viewport_1.GgViewport.instance.isActive) {

package/dist/base/gg-world.d.ts

@@ -1,23 +1,26 @@
+import { PausableClock } from './clock/pausable-clock';
 import { GgEntity } from './entities/gg-entity';
-import { ITickListener } from './entities/interfaces/i-tick-listener';
 import { GgPhysicsWorld } from './interfaces/gg-physics-world';
 import { GgVisualScene } from './interfaces/gg-visual-scene';
-import { KeyboardController } from './controllers/keyboard.controller';
+import { KeyboardInput } from './inputs/keyboard.input';
 import { GgPositionableEntity } from './entities/gg-positionable-entity';
 export declare abstract class GgWorld<D, R, V extends GgVisualScene<D, R> = GgVisualScene<D, R>, P extends GgPhysicsWorld<D, R> = GgPhysicsWorld<D, R>> {
     readonly visualScene: V;
     readonly physicsWorld: P;
     protected readonly consoleEnabled: boolean;
-    private readonly worldClock;
-    readonly keyboardController: KeyboardController;
-    get worldTime(): number;
+    readonly worldClock: PausableClock;
+    readonly keyboardInput: KeyboardInput;
     readonly children: GgEntity[];
-    protected readonly tickListeners: ITickListener[];
+    protected readonly tickListeners: GgEntity[];
     constructor(visualScene: V, physicsWorld: P, consoleEnabled?: boolean);
     init(): Promise<void>;
     start(): void;
     pauseWorld(): void;
     resumeWorld(): void;
+    get isRunning(): boolean;
+    get isPaused(): boolean;
+    get worldTime(): number;
+    createClock(autoStart: boolean): PausableClock;
     dispose(): void;
     abstract addPrimitiveRigidBody(descr: any, position?: D, rotation?: R): GgPositionableEntity<D, R>;
     addEntity(entity: GgEntity): void;

package/dist/base/gg-world.js

@@ -10,9 +10,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GgWorld = void 0;
-const i_tick_listener_1 = require("./entities/interfaces/i-tick-listener");
+const gg_entity_1 = require("./entities/gg-entity");
 const gg_static_1 = require("./gg-static");
-const keyboard_controller_1 = require("./controllers/keyboard.controller");
+const keyboard_input_1 = require("./inputs/keyboard.input");
 const rxjs_1 = require("rxjs");
 const gg_console_ui_1 = require("./ui/gg-console.ui");
 const gg_debugger_ui_1 = require("./ui/gg-debugger.ui");
@@ -22,18 +22,17 @@ class GgWorld {
         this.visualScene = visualScene;
         this.physicsWorld = physicsWorld;
         this.consoleEnabled = consoleEnabled;
-        // world clock, can be paused/resumed. Stops when disposing world
         this.worldClock = global_clock_1.GgGlobalClock.instance.createChildClock(false);
-        // TODO consider adding mouse controller
-        this.keyboardController = new keyboard_controller_1.KeyboardController();
+        this.keyboardInput = new keyboard_input_1.KeyboardInput();
         this.children = [];
+        // the same as children, but sorted by tick order
         this.tickListeners = [];
         this.commands = {};
         gg_static_1.GgStatic.instance.worlds.push(this);
         gg_static_1.GgStatic.instance.selectedWorld = this;
-        this.keyboardController.start().then();
+        this.keyboardInput.start().then();
         if (consoleEnabled) {
-            this.keyboardController
+            this.keyboardInput
                 .bind('Backquote')
                 .pipe((0, rxjs_1.filter)(x => x))
                 .subscribe(() => {
@@ -76,23 +75,27 @@ class GgWorld {
             }), 'args: [0 or 1]; turn on/off physics debug view. Default value is 0');
         }
     }
-    get worldTime() {
-        return this.worldClock.elapsedTime;
-    }
     init() {
         return __awaiter(this, void 0, void 0, function* () {
             yield Promise.all([this.physicsWorld.init(), this.visualScene.init()]);
             this.worldClock.tick$.subscribe(([elapsed, delta]) => {
-                let physicsTickPerformed = false;
-                for (let i = 0; i < this.tickListeners.length; i++) {
-                    if (!physicsTickPerformed && this.tickListeners[i].tickOrder >= 500) {
-                        this.physicsWorld.simulate(delta);
-                        physicsTickPerformed = true;
+                let i = 0;
+                // emit tick to all entities with tick order < GGTickOrder.PHYSICS_SIMULATION
+                for (i; i < this.tickListeners.length; i++) {
+                    if (this.tickListeners[i].tickOrder >= gg_entity_1.GGTickOrder.PHYSICS_SIMULATION) {
+                        break;
+                    }
+                    if (this.tickListeners[i].active) {
+                        this.tickListeners[i].tick$.next([elapsed, delta]);
                     }
-                    this.tickListeners[i].tick$.next([elapsed, delta]);
                 }
-                if (!physicsTickPerformed) {
-                    this.physicsWorld.simulate(delta);
+                // run phycics simulation
+                this.physicsWorld.simulate(delta);
+                // emit tick to all remained entities
+                for (i; i < this.tickListeners.length; i++) {
+                    if (this.tickListeners[i].active) {
+                        this.tickListeners[i].tick$.next([elapsed, delta]);
+                    }
                 }
             });
         });
@@ -106,9 +109,23 @@ class GgWorld {
     resumeWorld() {
         this.worldClock.resume();
     }
+    get isRunning() {
+        return this.worldClock.isRunning;
+    }
+    get isPaused() {
+        return this.worldClock.isPaused;
+    }
+    get worldTime() {
+        return this.worldClock.elapsedTime;
+    }
+    createClock(autoStart) {
+        return this.worldClock.createChildClock(autoStart);
+    }
     dispose() {
         this.worldClock.stop();
+        this.keyboardInput.stop().then();
         for (let i = 0; i < this.children.length; i++) {
+            this.children[i].onRemoved();
             this.children[i].dispose();
         }
         this.children.splice(0, this.children.length);
@@ -118,24 +135,23 @@ class GgWorld {
     }
     addEntity(entity) {
         if (!!entity.world) {
-            throw new Error('Entity already spawned');
+            console.warn('Trying to spawn entity, which is already spawned');
+            return;
         }
         this.children.push(entity);
-        if ((0, i_tick_listener_1.isITickListener)(entity)) {
-            this.tickListeners.push(entity);
-            this.tickListeners.sort((l1, l2) => l1.tickOrder - l2.tickOrder);
-        }
+        this.tickListeners.push(entity);
+        this.tickListeners.sort((l1, l2) => l1.tickOrder - l2.tickOrder);
         entity.onSpawned(this);
     }
     removeEntity(entity, dispose = true) {
-        if (entity.world !== this) {
-            throw new Error('Entity is not a part of this world');
-        }
-        this.children.splice(this.children.findIndex(x => x === entity), 1);
-        if ((0, i_tick_listener_1.isITickListener)(entity)) {
+        if (entity.world) {
+            if (entity.world !== this) {
+                throw new Error('Entity is not a part of this world');
+            }
+            this.children.splice(this.children.findIndex(x => x === entity), 1);
             this.tickListeners.splice(this.tickListeners.findIndex(x => x === entity), 1);
+            entity.onRemoved();
         }
-        entity.onRemoved();
         if (dispose) {
             entity.dispose();
         }

package/dist/base/inputs/direction.keyboard-input.d.ts

@@ -0,0 +1,41 @@
+import { Observable } from 'rxjs';
+import { KeyboardInput } from './keyboard.input';
+import { Input } from './input';
+/**
+ * The type representing desired keymap for DirectionKeyboardInput
+ */
+export declare type DirectionKeyboardKeymap = 'arrows' | 'wasd' | 'wasd+arrows';
+/**
+ * The type of DirectionKeyboardInput output value
+ */
+export declare type DirectionKeyboardOutput = {
+    upDown?: boolean;
+    leftRight?: boolean;
+};
+/**
+ * An input class, responsible for handling direction keys and providing simple current direction observable.
+ * Supports two the most popular keyboard layouts: WASD and arrows.
+ */
+export declare class DirectionKeyboardInput extends Input {
+    protected readonly keyboard: KeyboardInput;
+    protected readonly keymap: DirectionKeyboardKeymap;
+    /**
+     * A subject that emits `DirectionKeyboardOutput` objects whenever the input changes.
+     */
+    private _output$;
+    /**
+     * Returns an observable that emits `DirectionKeyboardOutput` objects whenever the input changes.
+     */
+    get output$(): Observable<DirectionKeyboardOutput>;
+    /**
+     * Creates a new instance of the `DirectionKeyboardInput` class.
+     *
+     * @param keyboard The `KeyboardInput` instance to use for input handling. You should probably use one from the World instance
+     * @param keymap The `DirectionKeyboardKeymap` defining which keys to listen for.
+     */
+    constructor(keyboard: KeyboardInput, keymap: DirectionKeyboardKeymap);
+    /**
+     * Called when the input handling should start.
+     */
+    protected startInternal(): Promise<void>;
+}

package/dist/base/inputs/direction.keyboard-input.js

@@ -0,0 +1,85 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectionKeyboardInput = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const input_1 = require("./input");
+/**
+ * An input class, responsible for handling direction keys and providing simple current direction observable.
+ * Supports two the most popular keyboard layouts: WASD and arrows.
+ */
+class DirectionKeyboardInput extends input_1.Input {
+    /**
+     * Creates a new instance of the `DirectionKeyboardInput` class.
+     *
+     * @param keyboard The `KeyboardInput` instance to use for input handling. You should probably use one from the World instance
+     * @param keymap The `DirectionKeyboardKeymap` defining which keys to listen for.
+     */
+    constructor(keyboard, keymap) {
+        super();
+        this.keyboard = keyboard;
+        this.keymap = keymap;
+        /**
+         * A subject that emits `DirectionKeyboardOutput` objects whenever the input changes.
+         */
+        this._output$ = new rxjs_1.Subject();
+    }
+    /**
+     * Returns an observable that emits `DirectionKeyboardOutput` objects whenever the input changes.
+     */
+    get output$() {
+        return this._output$.asObservable();
+    }
+    /**
+     * Called when the input handling should start.
+     */
+    startInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Initialize an array to hold the keys to listen for
+            const keys = [[], [], [], []];
+            // Add the "wasd" keys to the array if specified in the keymap
+            if (this.keymap.includes('wasd')) {
+                keys[0].push('KeyW');
+                keys[1].push('KeyA');
+                keys[2].push('KeyS');
+                keys[3].push('KeyD');
+            }
+            // Add the arrow keys to the array if specified in the keymap
+            if (this.keymap.includes('arrows')) {
+                keys[0].push('ArrowUp');
+                keys[1].push('ArrowLeft');
+                keys[2].push('ArrowDown');
+                keys[3].push('ArrowRight');
+            }
+            // Bind to the keyboard events for the specified keys
+            (0, rxjs_1.combineLatest)(keys.map(x => this.keyboard.bindMany(...x)))
+                .pipe(
+            // Stop listening when the `stop$` signal is received
+            (0, rxjs_1.takeUntil)(this.stop$), 
+            // Map the key states to a `DirectionKeyboardOutput` object
+            (0, operators_1.map)(moveDirection => {
+                const result = {};
+                if (moveDirection.includes(true)) {
+                    const [f, l, b, r] = moveDirection;
+                    if (f != b)
+                        result.upDown = f;
+                    if (l != r)
+                        result.leftRight = l;
+                }
+                return result;
+            }))
+                // Emit the resulting `DirectionKeyboardOutput` object through the `_output$` subject
+                .subscribe(this._output$);
+        });
+    }
+}
+exports.DirectionKeyboardInput = DirectionKeyboardInput;

package/dist/base/inputs/input.d.ts

@@ -0,0 +1,50 @@
+import { Subject } from 'rxjs';
+/**
+ * An abstract class that provides basic implementation for Input class.
+ * Input is an entity for handling input from user, such as mouse movements, key presses etc.
+ * Inputs are not bound to World-s and working independently by design.
+ *
+ * TStartParams - A type representing an array of input arguments for the start method. Items are recommended to be named.
+ *
+ * TStopParams - A type representing an array of input arguments for the stop method. Items are recommended to be named.
+ */
+export declare abstract class Input<TStartParams extends any[] = [], TStopParams extends any[] = []> {
+    /**
+     * A private boolean that represents the running state of the process.
+     */
+    private _running;
+    /**
+     * A protected subject that emits a void value when the process is stopped.
+     * Subclasses, when subscribing to something using rxjs, have to add pipe takeUntil(this.stop$),
+     * so everything will be unsubscribed when stopping input
+     */
+    protected readonly stop$: Subject<void>;
+    /**
+     * A public getter that returns the running state of the Input.
+     */
+    get running(): boolean;
+    /**
+     * An asynchronous method that starts the input. Do not override it
+     * @param args - An array of input arguments for the start method.
+     * @returns A Promise that resolves when the input is started.
+     */
+    start(...args: TStartParams): Promise<void>;
+    /**
+     * An asynchronous method that stops the input. Do not override it
+     * @param args - An array of input arguments for the stop method.
+     * @returns A Promise that resolves when the input is stopped.
+     */
+    stop(...args: TStopParams): Promise<void>;
+    /**
+     * An abstract asynchronous method that starts the input.
+     * @param args - An array of input arguments for the start method.
+     * @returns A Promise that resolves when the process is started.
+     */
+    protected abstract startInternal(...args: TStartParams): Promise<void>;
+    /**
+     * An asynchronous method that stops the input.
+     * @param args - An array of input arguments for the stop method.
+     * @returns A Promise that resolves when the process is stopped.
+     */
+    protected stopInternal(...args: TStopParams): Promise<void>;
+}

package/dist/base/inputs/input.js

@@ -0,0 +1,80 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Input = void 0;
+const rxjs_1 = require("rxjs");
+/**
+ * An abstract class that provides basic implementation for Input class.
+ * Input is an entity for handling input from user, such as mouse movements, key presses etc.
+ * Inputs are not bound to World-s and working independently by design.
+ *
+ * TStartParams - A type representing an array of input arguments for the start method. Items are recommended to be named.
+ *
+ * TStopParams - A type representing an array of input arguments for the stop method. Items are recommended to be named.
+ */
+class Input {
+    constructor() {
+        /**
+         * A private boolean that represents the running state of the process.
+         */
+        this._running = false;
+        /**
+         * A protected subject that emits a void value when the process is stopped.
+         * Subclasses, when subscribing to something using rxjs, have to add pipe takeUntil(this.stop$),
+         * so everything will be unsubscribed when stopping input
+         */
+        this.stop$ = new rxjs_1.Subject();
+    }
+    /**
+     * A public getter that returns the running state of the Input.
+     */
+    get running() {
+        return this._running;
+    }
+    /**
+     * An asynchronous method that starts the input. Do not override it
+     * @param args - An array of input arguments for the start method.
+     * @returns A Promise that resolves when the input is started.
+     */
+    start(...args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.running) {
+                return;
+            }
+            yield this.startInternal(...args);
+            this._running = true;
+        });
+    }
+    /**
+     * An asynchronous method that stops the input. Do not override it
+     * @param args - An array of input arguments for the stop method.
+     * @returns A Promise that resolves when the input is stopped.
+     */
+    stop(...args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.running) {
+                return;
+            }
+            this.stop$.next();
+            yield this.stopInternal(...args);
+            this._running = false;
+        });
+    }
+    /**
+     * An asynchronous method that stops the input.
+     * @param args - An array of input arguments for the stop method.
+     * @returns A Promise that resolves when the process is stopped.
+     */
+    stopInternal(...args) {
+        return __awaiter(this, void 0, void 0, function* () { });
+    }
+}
+exports.Input = Input;

package/dist/base/inputs/keyboard.input.d.ts

@@ -0,0 +1,45 @@
+import { Input } from './input';
+import { Observable } from 'rxjs';
+/**
+ * A main keyboard input: it does not have own key bindings, but provides an API to bind keys.
+ * It is responsible for listening key up/down events (when running!) and emit the events to subscribers.
+ * Every World entity has its own dedicated instance of Keyboard input, which is running only when the world is running
+ */
+export declare class KeyboardInput extends Input {
+    private bindings;
+    /**
+     * Creates a new instance of the `KeyboardInput` class.
+     */
+    constructor();
+    protected startInternal(): Promise<void>;
+    protected stopInternal(): Promise<void>;
+    /**
+     * Creates an observable that emits a boolean whenever a key with the given code is pressed or released
+     * @param code The key code to bind the observable to
+     * @returns An observable that emits true when the key is pressed and false when it's released
+     */
+    bind(code: string): Observable<boolean>;
+    /**
+     * Creates an observable that emits a boolean indicating whether any of the keys with the given codes are pressed or released.
+     * Should be used when you have more than one keys, responsible for the same action.
+     * @param codes The key codes to bind the observable to
+     * @returns An observable that emits true when any of the keys are pressed and false when they're all released
+     */
+    bindMany(...codes: string[]): Observable<boolean>;
+    /**
+     * Emulates a key down event for the given key code
+     * @param code The key code to emulate
+     */
+    emulateKeyDown(code: string): void;
+    /**
+     * Emulates a key up event for the given key code
+     * @param code The key code to emulate
+     */
+    emulateKeyUp(code: string): void;
+    /**
+     * Emulates a key press event (down and up) for the given key code
+     * @param code The key code to emulate
+     */
+    emulateKeyPress(code: string): void;
+    private handleKeys;
+}