@gg-web-engine/core 0.0.2 → 0.0.4

package/dist/3d/inputs/free-camera.input.d.ts

@@ -0,0 +1,22 @@
+import { Input } from '../../base/inputs/input';
+import { MouseControllerOptions, MouseInput } from '../../base/inputs/mouse.input';
+import { Gg3dCameraEntity } from '../entities/gg-3d-camera.entity';
+import { KeyboardInput } from '../../base/inputs/keyboard.input';
+import { DirectionKeyboardInput, DirectionKeyboardKeymap } from '../../base/inputs/direction.keyboard-input';
+export declare type FreeCameraControllerOptions = {
+    keymap: DirectionKeyboardKeymap;
+    movementOptions: {
+        speed: number;
+    };
+    mouseOptions: MouseControllerOptions;
+};
+export declare class FreeCameraInput extends Input<[], [unlockPointer?: boolean]> {
+    protected readonly keyboard: KeyboardInput;
+    protected readonly camera: Gg3dCameraEntity;
+    protected readonly options: FreeCameraControllerOptions;
+    protected readonly mouseInput: MouseInput;
+    protected readonly directionsInput: DirectionKeyboardInput;
+    constructor(keyboard: KeyboardInput, camera: Gg3dCameraEntity, options?: FreeCameraControllerOptions);
+    protected startInternal(): Promise<void>;
+    protected stopInternal(unlockPointer?: boolean): Promise<void>;
+}

package/dist/3d/inputs/free-camera.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.FreeCameraInput = void 0;
+const input_1 = require("../../base/inputs/input");
+const rxjs_1 = require("rxjs");
+const mouse_input_1 = require("../../base/inputs/mouse.input");
+const point3_1 = require("../../base/math/point3");
+const point2_1 = require("../../base/math/point2");
+const quaternion_1 = require("../../base/math/quaternion");
+const direction_keyboard_input_1 = require("../../base/inputs/direction.keyboard-input");
+class FreeCameraInput extends input_1.Input {
+    constructor(keyboard, camera, options = {
+        keymap: 'wasd',
+        movementOptions: { speed: 0.5 },
+        mouseOptions: {},
+    }) {
+        super();
+        this.keyboard = keyboard;
+        this.camera = camera;
+        this.options = options;
+        this.mouseInput = new mouse_input_1.MouseInput(options.mouseOptions);
+        this.directionsInput = new direction_keyboard_input_1.DirectionKeyboardInput(keyboard, options.keymap);
+    }
+    startInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let controls = { direction: {}, rest: [] };
+            const keys = ['KeyE', 'KeyQ'];
+            if (this.camera.object3D.supportsFov) {
+                keys.push('KeyZ', 'KeyC');
+            }
+            this.directionsInput.output$.pipe((0, rxjs_1.takeUntil)(this.stop$)).subscribe(d => {
+                controls.direction = d;
+            });
+            (0, rxjs_1.combineLatest)(keys.map(c => this.keyboard.bind(c)))
+                .pipe((0, rxjs_1.takeUntil)(this.stop$))
+                .subscribe((d) => {
+                controls.rest = d;
+            });
+            let rotationDelta = { x: 0, y: 0 };
+            this.mouseInput.delta$.pipe((0, rxjs_1.takeUntil)(this.stop$)).subscribe(delta => {
+                rotationDelta = point2_1.Pnt2.add(rotationDelta, delta);
+            });
+            this.camera.tick$.pipe((0, rxjs_1.takeUntil)(this.stop$)).subscribe(() => {
+                let translateVector = { x: 0, y: 0, z: 0 };
+                const [u, d, zo, zi] = controls.rest;
+                if (controls.direction.upDown !== undefined)
+                    translateVector.z = controls.direction.upDown ? -1 : 1;
+                if (controls.direction.leftRight !== undefined)
+                    translateVector.x = controls.direction.leftRight ? -1 : 1;
+                if (u != d)
+                    translateVector.y = d ? -1 : 1;
+                if (zo != zi)
+                    this.camera.object3D.fov += zo ? 1 : -1;
+                this.camera.position = point3_1.Pnt3.add(this.camera.position, point3_1.Pnt3.rot(point3_1.Pnt3.scalarMult(point3_1.Pnt3.norm(translateVector), this.options.movementOptions.speed), this.camera.rotation));
+                if (rotationDelta.x != 0 || rotationDelta.y != 0) {
+                    this.camera.rotation = quaternion_1.Qtrn.combineRotations(quaternion_1.Qtrn.fromAngle({ x: 0, y: 0, z: 1 }, -rotationDelta.x / 300), this.camera.rotation, quaternion_1.Qtrn.fromAngle({ x: 1, y: 0, z: 0 }, -rotationDelta.y / 300));
+                    rotationDelta = { x: 0, y: 0 };
+                }
+            });
+            yield this.mouseInput.start();
+            yield this.directionsInput.start();
+        });
+    }
+    stopInternal(unlockPointer = true) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.mouseInput.stop(unlockPointer);
+            yield this.directionsInput.stop();
+        });
+    }
+}
+exports.FreeCameraInput = FreeCameraInput;

package/dist/base/clock/clock.d.ts

@@ -0,0 +1,25 @@
+import { Observable } from 'rxjs';
+import { GgGlobalClock } from './global-clock';
+/**
+ * A class, providing ability to track time, fire ticks, provide time elapsed + tick delta with ability to suspend/resume it.
+ */
+export declare class Clock {
+    protected readonly parentClock: Clock | GgGlobalClock;
+    private tickSub;
+    private readonly _tick$;
+    get tick$(): Observable<[number, number]>;
+    get isRunning(): boolean;
+    get isPaused(): boolean;
+    get elapsedTime(): number;
+    private startedAt;
+    private oldRelativeTime;
+    private pausedAt;
+    constructor(autoStart?: boolean, parentClock?: Clock | GgGlobalClock);
+    createChildClock(autoStart: boolean): Clock;
+    start(): void;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    protected startListeningTicks(): void;
+    protected stopListeningTicks(): void;
+}

package/dist/base/clock/clock.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Clock = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const global_clock_1 = require("./global-clock");
+/**
+ * A class, providing ability to track time, fire ticks, provide time elapsed + tick delta with ability to suspend/resume it.
+ */
+class Clock {
+    constructor(autoStart = false, parentClock = global_clock_1.GgGlobalClock.instance) {
+        this.parentClock = parentClock;
+        this.tickSub = null;
+        this._tick$ = new rxjs_1.Subject();
+        // state
+        this.startedAt = -1;
+        this.oldRelativeTime = 0; // "elapsed", emitted on last tick
+        this.pausedAt = -1;
+        if (autoStart) {
+            this.start();
+        }
+    }
+    get tick$() {
+        return this._tick$.pipe((0, operators_1.map)(([oldTime, newTime]) => [newTime, newTime - oldTime]));
+    }
+    get isRunning() {
+        return !!this.tickSub;
+    }
+    get isPaused() {
+        return this.pausedAt !== -1;
+    }
+    get elapsedTime() {
+        if (this.isPaused) {
+            return this.pausedAt - this.startedAt;
+        }
+        return this.parentClock.elapsedTime - this.startedAt;
+    }
+    createChildClock(autoStart) {
+        return new Clock(autoStart, this);
+    }
+    start() {
+        if (this.isRunning) {
+            return;
+        }
+        this.oldRelativeTime = 0;
+        this.startedAt = this.parentClock.elapsedTime;
+        this.startListeningTicks();
+    }
+    stop() {
+        this.stopListeningTicks();
+        this.startedAt = this.pausedAt = -1;
+    }
+    pause() {
+        this.stopListeningTicks();
+        this.pausedAt = this.parentClock.elapsedTime;
+    }
+    resume() {
+        if (this.isRunning || this.pausedAt == -1) {
+            return;
+        }
+        this.startedAt += this.parentClock.elapsedTime - this.pausedAt;
+        this.pausedAt = -1;
+        this.startListeningTicks();
+    }
+    startListeningTicks() {
+        if (this.tickSub) {
+            throw new Error('Clock is already ticking!');
+        }
+        this.tickSub = this.parentClock.tick$
+            .pipe((0, operators_1.map)(([parentElapsed, _]) => [this.oldRelativeTime, parentElapsed - this.startedAt]), (0, operators_1.tap)(([_, cur]) => (this.oldRelativeTime = cur)))
+            .subscribe(this._tick$);
+    }
+    stopListeningTicks() {
+        var _a;
+        (_a = this.tickSub) === null || _a === void 0 ? void 0 : _a.unsubscribe();
+        this.tickSub = null;
+    }
+}
+exports.Clock = Clock;

package/dist/base/clock/global-clock.d.ts

@@ -0,0 +1,16 @@
+import { Observable } from 'rxjs';
+import { PausableClock } from './pausable-clock';
+import { IClock } from './i-clock';
+/**
+ * A singleton class, providing ability to track time, fire ticks, provide time elapsed + tick delta.
+ * Starts as soon as accessed and counts time from 01/01/1970
+ */
+export declare class GgGlobalClock implements IClock {
+    private static _instance;
+    static get instance(): GgGlobalClock;
+    private readonly _tick$;
+    get tick$(): Observable<[number, number]>;
+    get elapsedTime(): number;
+    createChildClock(autoStart: boolean): PausableClock;
+    private constructor();
+}

package/dist/base/clock/global-clock.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GgGlobalClock = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const pausable_clock_1 = require("./pausable-clock");
+/**
+ * A singleton class, providing ability to track time, fire ticks, provide time elapsed + tick delta.
+ * Starts as soon as accessed and counts time from 01/01/1970
+ */
+class GgGlobalClock {
+    constructor() {
+        this._tick$ = new rxjs_1.Subject();
+        let oldRelativeTime = this.elapsedTime;
+        (0, rxjs_1.of)(undefined, rxjs_1.animationFrameScheduler)
+            .pipe((0, operators_1.repeat)())
+            .pipe((0, operators_1.map)(() => [oldRelativeTime, this.elapsedTime]), (0, operators_1.tap)(([_, cur]) => (oldRelativeTime = cur)))
+            .subscribe(this._tick$);
+    }
+    static get instance() {
+        if (!GgGlobalClock._instance) {
+            GgGlobalClock._instance = new GgGlobalClock();
+        }
+        return GgGlobalClock._instance;
+    }
+    get tick$() {
+        return this._tick$.pipe((0, operators_1.map)(([oldTime, newTime]) => [newTime, newTime - oldTime]));
+    }
+    get elapsedTime() {
+        return (typeof performance === 'undefined' ? Date : performance).now();
+    }
+    createChildClock(autoStart) {
+        return new pausable_clock_1.PausableClock(autoStart, this);
+    }
+}
+exports.GgGlobalClock = GgGlobalClock;

package/dist/base/clock/i-clock.d.ts

@@ -0,0 +1,7 @@
+import { Observable } from 'rxjs';
+import { PausableClock } from './pausable-clock';
+export interface IClock {
+    get tick$(): Observable<[number, number]>;
+    get elapsedTime(): number;
+    createChildClock(autoStart: boolean): PausableClock;
+}

package/dist/base/clock/i-clock.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/base/clock/pausable-clock.d.ts

@@ -0,0 +1,25 @@
+import { Observable } from 'rxjs';
+import { IClock } from './i-clock';
+/**
+ * A class, providing ability to track time, fire ticks, provide time elapsed + tick delta with ability to suspend/resume it.
+ */
+export declare class PausableClock implements IClock {
+    protected readonly parentClock: IClock;
+    private tickSub;
+    private readonly _tick$;
+    get tick$(): Observable<[number, number]>;
+    get isRunning(): boolean;
+    get isPaused(): boolean;
+    get elapsedTime(): number;
+    private startedAt;
+    private oldRelativeTime;
+    private pausedAt;
+    constructor(autoStart?: boolean, parentClock?: IClock);
+    createChildClock(autoStart: boolean): PausableClock;
+    start(): void;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    protected startListeningTicks(): void;
+    protected stopListeningTicks(): void;
+}

package/dist/base/clock/pausable-clock.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PausableClock = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const global_clock_1 = require("./global-clock");
+/**
+ * A class, providing ability to track time, fire ticks, provide time elapsed + tick delta with ability to suspend/resume it.
+ */
+class PausableClock {
+    constructor(autoStart = false, parentClock = global_clock_1.GgGlobalClock.instance) {
+        this.parentClock = parentClock;
+        this.tickSub = null;
+        this._tick$ = new rxjs_1.Subject();
+        // state
+        this.startedAt = -1;
+        this.oldRelativeTime = 0; // "elapsed", emitted on last tick
+        this.pausedAt = -1;
+        if (autoStart) {
+            this.start();
+        }
+    }
+    get tick$() {
+        return this._tick$.pipe((0, operators_1.map)(([oldTime, newTime]) => [newTime, newTime - oldTime]));
+    }
+    get isRunning() {
+        return !!this.tickSub;
+    }
+    get isPaused() {
+        return this.pausedAt !== -1;
+    }
+    get elapsedTime() {
+        if (this.isPaused) {
+            return this.pausedAt - this.startedAt;
+        }
+        return this.parentClock.elapsedTime - this.startedAt;
+    }
+    createChildClock(autoStart) {
+        return new PausableClock(autoStart, this);
+    }
+    start() {
+        if (this.isRunning) {
+            return;
+        }
+        this.oldRelativeTime = 0;
+        this.startedAt = this.parentClock.elapsedTime;
+        this.startListeningTicks();
+    }
+    stop() {
+        this.stopListeningTicks();
+        this.startedAt = this.pausedAt = -1;
+    }
+    pause() {
+        this.stopListeningTicks();
+        this.pausedAt = this.parentClock.elapsedTime;
+    }
+    resume() {
+        if (this.isRunning || this.pausedAt == -1) {
+            return;
+        }
+        this.startedAt += this.parentClock.elapsedTime - this.pausedAt;
+        this.pausedAt = -1;
+        this.startListeningTicks();
+    }
+    startListeningTicks() {
+        if (this.tickSub) {
+            throw new Error('Clock is already ticking!');
+        }
+        this.tickSub = this.parentClock.tick$
+            .pipe((0, operators_1.map)(([parentElapsed, _]) => [this.oldRelativeTime, parentElapsed - this.startedAt]), (0, operators_1.tap)(([_, cur]) => (this.oldRelativeTime = cur)))
+            .subscribe(this._tick$);
+    }
+    stopListeningTicks() {
+        var _a;
+        (_a = this.tickSub) === null || _a === void 0 ? void 0 : _a.unsubscribe();
+        this.tickSub = null;
+    }
+}
+exports.PausableClock = PausableClock;

package/dist/base/entities/base-gg-renderer.d.ts

@@ -1,6 +1,4 @@
-import { ITickListener } from './interfaces/i-tick-listener';
-import { Subject, Subscription } from 'rxjs';
-import { GgEntity } from './gg-entity';
+import { GgEntity, GGTickOrder } from './gg-entity';
 import { Point2 } from '../models/points';
 export declare type RendererOptions = {
     transparent: boolean;
@@ -9,20 +7,10 @@ export declare type RendererOptions = {
     forceResolution?: number;
     antialias: boolean;
 };
-export declare abstract class BaseGgRenderer extends GgEntity implements ITickListener {
-    protected _permanentRenderMethods: Map<number, Function>;
-    protected _singularRenderMethods: Map<number, Function>;
-    private initialized;
-    readonly tick$: Subject<[number, number]>;
-    readonly tickOrder = 1000;
-    protected tickListener: Subscription | null;
+export declare abstract class BaseGgRenderer extends GgEntity {
+    readonly tickOrder = GGTickOrder.RENDERING;
     readonly rendererOptions: RendererOptions;
     protected constructor(canvas?: HTMLCanvasElement, options?: Partial<RendererOptions>);
-    get isActive(): boolean;
-    activate(): void;
-    deactivate(): void;
-    init(): void;
     abstract render(): void;
     abstract resize(newSize: Point2): void;
-    abstract dispose(): void;
 }

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

@@ -1,49 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseGgRenderer = void 0;
-const rxjs_1 = require("rxjs");
 const gg_entity_1 = require("./gg-entity");
 const gg_viewport_manager_1 = require("../gg-viewport-manager");
 class BaseGgRenderer extends gg_entity_1.GgEntity {
     constructor(canvas, options = {}) {
         super();
-        this.initialized = false;
-        this.tickOrder = 1000;
-        this.tickListener = null;
+        this.tickOrder = gg_entity_1.GGTickOrder.RENDERING;
         this.rendererOptions = Object.assign({ transparent: false, background: 0x000000, antialias: true }, (options || {}));
-        this._permanentRenderMethods = new Map();
-        this._singularRenderMethods = new Map();
-        this.tick$ = new rxjs_1.Subject();
         if (canvas) {
             setTimeout(() => {
                 gg_viewport_manager_1.GgViewportManager.instance.assignRendererToCanvas(this, canvas).then();
             }, 0);
         }
-    }
-    get isActive() {
-        return !!this.tickListener;
-    }
-    activate() {
-        if (this.isActive) {
-            return;
-        }
-        if (!this.initialized) {
-            this.init();
-        }
-        this.tickListener = this.tick$.subscribe(() => {
+        this.tick$.subscribe(() => {
             this.render();
         });
     }
-    deactivate() {
-        var _a;
-        if (!this.isActive) {
-            return;
-        }
-        (_a = this.tickListener) === null || _a === void 0 ? void 0 : _a.unsubscribe();
-        this.tickListener = null;
-    }
-    init() {
-        this.initialized = true;
-    }
 }
 exports.BaseGgRenderer = BaseGgRenderer;

package/dist/base/entities/controllers/animation-mixer.d.ts

@@ -0,0 +1,76 @@
+import { GgEntity } from '../gg-entity';
+import { Observable, Subject } from 'rxjs';
+import { GgWorld } from '../../gg-world';
+export declare type AnimationFunction<T> = (elapsed: number, delta: number) => T;
+/**
+ * A class that performs property animations for a specific type `T` by using provided animation function.
+ * Supports smooth transition between animation function by interpolating between values over time.
+ * The current value of the animation can be subscribed to using the `subscribeToValue` property.
+ * The animation function can be changed with `transitAnimationFunction` or `transitFromStaticState`.
+ */
+export declare class AnimationMixer<T> extends GgEntity {
+    protected _animationFunction: AnimationFunction<T>;
+    protected _lerp: (a: T, b: T, t: number) => T;
+    readonly tickOrder: number;
+    /**
+     * A subject that emits the current value of the animation on every tick.
+     */
+    protected readonly _value$: Subject<T>;
+    /**
+     * The current transition time reference `[elapsed, delta]` that interpolates between the old and new functions.
+     */
+    private _currentTransitionK;
+    /**
+     * The current transition subscription, which is null if no transition is currently active.
+     */
+    private _currentTransition;
+    /**
+     * A behavior subject that emits whether the animator is currently in a transition.
+     */
+    private _isInTransition$;
+    /**
+     * Gets an observable of the current value of the animation.
+     */
+    get value$(): Observable<T>;
+    /**
+     * Gets the current motion control function that determines the animation.
+     */
+    get animationFunction(): AnimationFunction<T>;
+    /**
+     * Sets the current motion control function that determines the animation.
+     * @param value The new motion control function.
+     */
+    set animationFunction(value: AnimationFunction<T>);
+    /**
+     * Gets a flag whether the animator is currently in a transition.
+     */
+    get isInTransition(): boolean;
+    /**
+     * Gets an observable that emits whether the animator is currently in a transition.
+     */
+    get isInTransition$(): Observable<boolean>;
+    protected get currentTransition(): ((a: [number, number]) => void) | null;
+    protected set currentTransition(value: ((a: [number, number]) => void) | null);
+    /**
+     * Creates a new `AnimationMixer` entity.
+     * @param _animationFunction The initial motion control function that determines the animation.
+     * @param _lerp The linear interpolation between two values of type `T`.
+     */
+    constructor(_animationFunction: AnimationFunction<T>, _lerp?: (a: T, b: T, t: number) => T);
+    /**
+     * Set output to static value and smoothly transit to new control function
+     * @param newFunc a new function
+     * @param transitionDuration a duration, after which new function will be fully controlling the output
+     * @param easing an easing function for transition
+     */
+    transitFromStaticState(state: T, newFunc: AnimationFunction<T>, transitionDuration: number, easing?: (t: number) => number): void;
+    /**
+     * Smoothly transit to new control function
+     * @param newFunc a new function
+     * @param transitionDuration a duration, after which new function will be fully controlling the output
+     * @param easing an easing function for transition
+     */
+    transitAnimationFunction(newFunc: AnimationFunction<T>, transitionDuration: number, easing?: (t: number) => number): void;
+    onSpawned(world: GgWorld<any, any>): void;
+    dispose(): void;
+}