@gg-web-engine/core 0.0.28 → 0.0.30

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

@@ -1,6 +1,6 @@
 import { IEntity } from '../i-entity';
 import { Observable, Subject } from 'rxjs';
-import { GgWorld } from '../../gg-world';
+import { GgWorld, PhysicsTypeDocRepo, VisualTypeDocRepo } 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.
@@ -8,7 +8,7 @@ export declare type AnimationFunction<T> = (elapsed: number, delta: number) => T
  * 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 IEntity {
+export declare class AnimationMixer<T, D = any, R = any, VTypeDoc extends VisualTypeDocRepo<D, R> = VisualTypeDocRepo<D, R>, PTypeDoc extends PhysicsTypeDocRepo<D, R> = PhysicsTypeDocRepo<D, R>> extends IEntity<D, R, VTypeDoc, PTypeDoc> {
     protected _animationFunction: AnimationFunction<T>;
     protected _lerp: (a: T, b: T, t: number) => T;
     readonly tickOrder: number;
@@ -71,6 +71,6 @@ export declare class AnimationMixer<T> extends IEntity {
      * @param easing an easing function for transition
      */
     transitAnimationFunction(newFunc: AnimationFunction<T>, transitionDuration: number, easing?: (t: number) => number): void;
-    onSpawned(world: GgWorld<any, any>): void;
+    onSpawned(world: GgWorld<D, R, VTypeDoc, PTypeDoc>): void;
     dispose(): void;
 }

package/dist/base/entities/i-entity.d.ts

@@ -1,7 +1,5 @@
-import { GgWorld } from '../gg-world';
+import { GgWorld, PhysicsTypeDocRepo, VisualTypeDocRepo } from '../gg-world';
 import { Subject } from 'rxjs';
-import { IVisualSceneComponent } from '../components/rendering/i-visual-scene.component';
-import { IPhysicsWorldComponent } from '../components/physics/i-physics-world.component';
 import { IWorldComponent } from '../components/i-world-component';
 /**
  * Engine's default tick orders: the less value, the earlier tick will be run.
@@ -15,7 +13,7 @@ export declare enum TickOrder {
     RENDERING = 1000,
     POST_RENDERING = 1200
 }
-export declare abstract class IEntity<D = any, R = any, V extends IVisualSceneComponent<D, R> = IVisualSceneComponent<D, R>, P extends IPhysicsWorldComponent<D, R> = IPhysicsWorldComponent<D, R>> {
+export declare abstract class IEntity<D = any, R = any, VTypeDoc extends VisualTypeDocRepo<D, R> = VisualTypeDocRepo<D, R>, PTypeDoc extends PhysicsTypeDocRepo<D, R> = PhysicsTypeDocRepo<D, R>> {
     private static default_name_counter;
     /**
      * will receive [elapsed time, delta] of each world clock tick
@@ -28,8 +26,8 @@ export declare abstract class IEntity<D = any, R = any, V extends IVisualSceneCo
     /**
      * a world reference, where this entity was added to
      */
-    protected _world: GgWorld<D, R, V, P> | null;
-    get world(): GgWorld<D, R, V, P> | null;
+    protected _world: GgWorld<D, R, VTypeDoc, PTypeDoc> | null;
+    get world(): GgWorld<D, R, VTypeDoc, PTypeDoc> | null;
     protected _name: string;
     get name(): string;
     set name(value: string);
@@ -45,12 +43,12 @@ export declare abstract class IEntity<D = any, R = any, V extends IVisualSceneCo
     addChildren(...entities: IEntity[]): void;
     removeChildren(entities: IEntity[], dispose?: boolean): void;
     private _components;
-    get components(): IWorldComponent<D, R, V, P>[];
-    addComponents(...components: IWorldComponent<D, R, V, P>[]): void;
-    removeComponents(components: IWorldComponent<D, R, V, P>[], dispose?: boolean): void;
+    get components(): IWorldComponent<D, R, VTypeDoc, PTypeDoc>[];
+    addComponents(...components: IWorldComponent<D, R, VTypeDoc, PTypeDoc>[]): void;
+    removeComponents(components: IWorldComponent<D, R, VTypeDoc, PTypeDoc>[], dispose?: boolean): void;
     protected _onSpawned$: Subject<void>;
     protected _onRemoved$: Subject<void>;
-    onSpawned(world: GgWorld<D, R, V, P>): void;
+    onSpawned(world: GgWorld<D, R, VTypeDoc, PTypeDoc>): void;
     onRemoved(): void;
     dispose(): void;
 }

package/dist/base/entities/i-renderable.entity.d.ts

@@ -1,7 +1,6 @@
 import { IEntity } from './i-entity';
-import { IVisualSceneComponent } from '../components/rendering/i-visual-scene.component';
-import { IPhysicsWorldComponent } from '../components/physics/i-physics-world.component';
-export declare abstract class IRenderableEntity<D = any, R = any, V extends IVisualSceneComponent<D, R> = IVisualSceneComponent<D, R>, P extends IPhysicsWorldComponent<D, R> = IPhysicsWorldComponent<D, R>> extends IEntity<D, R, V, P> {
+import { PhysicsTypeDocRepo, VisualTypeDocRepo } from '../gg-world';
+export declare abstract class IRenderableEntity<D = any, R = any, TypeDoc extends VisualTypeDocRepo<D, R> = VisualTypeDocRepo<D, R>, PTypeDoc extends PhysicsTypeDocRepo<D, R> = PhysicsTypeDocRepo<D, R>> extends IEntity<D, R, TypeDoc, PTypeDoc> {
     private _visible;
     get visible(): boolean;
     get worldVisible(): boolean;

package/dist/base/entities/i-renderer.entity.d.ts

@@ -1,15 +1,14 @@
 import { IEntity, TickOrder } from './i-entity';
-import { GgWorld } from '../gg-world';
+import { GgWorld, VisualTypeDocRepo } from '../gg-world';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { Point2 } from '../models/points';
-import { IRendererComponent, RendererOptions } from '../components/rendering/i-renderer.component';
-import { IVisualSceneComponent } from '../components/rendering/i-visual-scene.component';
+import { RendererOptions } from '../components/rendering/i-renderer.component';
 /**
  * Represents a base class for a renderer entity.
  * @class
  */
-export declare abstract class IRendererEntity<D, R, VS extends IVisualSceneComponent<D, R> = IVisualSceneComponent<D, R>, RC extends IRendererComponent<D, R, VS> = IRendererComponent<D, R, VS>> extends IEntity<D, R, VS> {
-    readonly renderer: RC;
+export declare abstract class IRendererEntity<D, R, TypeDoc extends VisualTypeDocRepo<D, R> = VisualTypeDocRepo<D, R>> extends IEntity<D, R, TypeDoc> {
+    readonly renderer: TypeDoc['renderer'];
     readonly tickOrder = TickOrder.RENDERING;
     /** Represents the current size of the renderer. */
     protected _rendererSize$: BehaviorSubject<Point2 | null>;
@@ -28,7 +27,7 @@ export declare abstract class IRendererEntity<D, R, VS extends IVisualSceneCompo
      Initializes a new instance of the BaseGgRenderer class.
      * @param renderer
      */
-    constructor(renderer: RC);
-    onSpawned(world: GgWorld<D, R, VS, any>): void;
+    constructor(renderer: TypeDoc['renderer']);
+    onSpawned(world: GgWorld<D, R, TypeDoc>): void;
     dispose(): void;
 }

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

@@ -1,7 +1,17 @@
-import { IEntity, IPhysicsWorldComponent, IPositionable, IRenderableEntity, IVisualSceneComponent, KeyboardInput, PausableClock } from '../base';
-export declare abstract class GgWorld<D, R, V extends IVisualSceneComponent<D, R> = IVisualSceneComponent<D, R>, P extends IPhysicsWorldComponent<D, R> = IPhysicsWorldComponent<D, R>> {
-    readonly visualScene: V;
-    readonly physicsWorld: P;
+import { IDisplayObjectComponent, IEntity, IPhysicsWorldComponent, IPositionable, IRenderableEntity, IRendererComponent, IRigidBodyComponent, ITriggerComponent, IVisualSceneComponent, KeyboardInput, PausableClock } from '../base';
+export declare type VisualTypeDocRepo<D, R> = {
+    factory: unknown;
+    displayObject: IDisplayObjectComponent<D, R>;
+    renderer: IRendererComponent<D, R>;
+};
+export declare type PhysicsTypeDocRepo<D, R> = {
+    factory: unknown;
+    rigidBody: IRigidBodyComponent<D, R>;
+    trigger: ITriggerComponent<D, R>;
+};
+export declare abstract class GgWorld<D, R, VTypeDoc extends VisualTypeDocRepo<D, R> = VisualTypeDocRepo<D, R>, PTypeDoc extends PhysicsTypeDocRepo<D, R> = PhysicsTypeDocRepo<D, R>, VS extends IVisualSceneComponent<D, R, VTypeDoc> = IVisualSceneComponent<D, R, VTypeDoc>, PW extends IPhysicsWorldComponent<D, R, PTypeDoc> = IPhysicsWorldComponent<D, R, PTypeDoc>> {
+    readonly visualScene: VS;
+    readonly physicsWorld: PW;
     readonly worldClock: PausableClock;
     readonly keyboardInput: KeyboardInput;
     private static default_name_counter;
@@ -10,7 +20,7 @@ export declare abstract class GgWorld<D, R, V extends IVisualSceneComponent<D, R
     protected readonly tickListeners: IEntity[];
     private static _documentWorlds;
     static get documentWorlds(): GgWorld<any, any>[];
-    protected constructor(visualScene: V, physicsWorld: P);
+    protected constructor(visualScene: VS, physicsWorld: PW);
     init(): Promise<void>;
     start(): void;
     pauseWorld(): void;
@@ -20,7 +30,8 @@ export declare abstract class GgWorld<D, R, V extends IVisualSceneComponent<D, R
     get worldTime(): number;
     createClock(autoStart: boolean): PausableClock;
     dispose(): void;
-    abstract addPrimitiveRigidBody(descr: any, position?: D, rotation?: R): IPositionable<D, R> & IRenderableEntity<D, R, V, P>;
+    abstract addPrimitiveRigidBody(descr: unknown, // type defined in subclasses
+    position?: D, rotation?: R, material?: unknown): IPositionable<D, R> & IRenderableEntity<D, R, VTypeDoc>;
     addEntity(entity: IEntity): void;
     removeEntity(entity: IEntity, dispose?: boolean): void;
     get physicsDebugViewActive(): boolean;

package/dist/base/index.d.ts

@@ -10,6 +10,7 @@ export * from './components/rendering/i-renderer.component';
 export * from './components/rendering/i-visual-scene.component';
 export * from './components/i-component';
 export * from './components/i-world-component';
+export * from './data-structures/bitmask';
 export * from './data-structures/graph';
 export * from './entities/controllers/animation-mixer';
 export * from './entities/controllers/inline-controller';

package/dist/base/index.js

@@ -10,6 +10,7 @@ export * from './components/rendering/i-renderer.component';
 export * from './components/rendering/i-visual-scene.component';
 export * from './components/i-component';
 export * from './components/i-world-component';
+export * from './data-structures/bitmask';
 export * from './data-structures/graph';
 export * from './entities/controllers/animation-mixer';
 export * from './entities/controllers/inline-controller';

package/dist/base/interfaces/i-debug-physics-drawer.d.ts

@@ -1,7 +1,7 @@
 import { IDisplayObjectComponent } from '../components/rendering/i-display-object.component';
 import { Point3 } from '../models/points';
-import { IVisualSceneComponent } from '../components/rendering/i-visual-scene.component';
-export interface IDebugPhysicsDrawer<D, R, VS extends IVisualSceneComponent<D, R> = IVisualSceneComponent<D, R>> extends IDisplayObjectComponent<D, R, VS> {
+import { VisualTypeDocRepo } from '../gg-world';
+export interface IDebugPhysicsDrawer<D, R, TypeDoc extends VisualTypeDocRepo<D, R> = VisualTypeDocRepo<D, R>> extends IDisplayObjectComponent<D, R, TypeDoc> {
     drawContactPoint(point: D, normal: D, color?: Point3): void;
     drawLine(from: D, to: D, color?: Point3): void;
     update(): void;

package/dist/base/math/quaternion.d.ts

@@ -32,6 +32,20 @@ export declare class Qtrn {
      * @returns The product of the two Point4 objects.
      */
     static mult(a: Point4, b: Point4): Point4;
+    /**
+     * Calculates and returns the conjugate of a quaternion.
+     * The conjugate of a quaternion is obtained by changing the sign of its vector components.
+     * @param q The Point4 (quaternion) object.
+     * @returns The conjugate of the quaternion passed as argument.
+     */
+    static conjugate(q: Point4): Point4;
+    /**
+     * Returns the opposite of a quaternion.
+     * It's obtained by negating all quaternion elements(x, y, z and w).
+     * @param q The Point4 (quaternion) object.
+     * @returns The opposite of the quaternion passed as argument.
+     */
+    static opposite(q: Point4): Point4;
     /**
      * Combines an arbitrary number of quaternions by multiplying them together in order.
      * @param quaternions The quaternions to combine.

package/dist/base/math/quaternion.js

@@ -51,6 +51,24 @@ export class Qtrn {
             z: a.w * b.z + a.x * b.y - a.y * b.x + a.z * b.w,
         };
     }
+    /**
+     * Calculates and returns the conjugate of a quaternion.
+     * The conjugate of a quaternion is obtained by changing the sign of its vector components.
+     * @param q The Point4 (quaternion) object.
+     * @returns The conjugate of the quaternion passed as argument.
+     */
+    static conjugate(q) {
+        return { x: -q.x, y: -q.y, z: -q.z, w: q.w };
+    }
+    /**
+     * Returns the opposite of a quaternion.
+     * It's obtained by negating all quaternion elements(x, y, z and w).
+     * @param q The Point4 (quaternion) object.
+     * @returns The opposite of the quaternion passed as argument.
+     */
+    static opposite(q) {
+        return { x: -q.x, y: -q.y, z: -q.z, w: -q.w };
+    }
     /**
      * Combines an arbitrary number of quaternions by multiplying them together in order.
      * @param quaternions The quaternions to combine.

package/dist/base/models/body-options.d.ts

@@ -1,6 +1,9 @@
+export declare type CollisionGroup = number;
 export interface BodyOptions {
     dynamic: boolean;
     mass: number;
     restitution: number;
     friction: number;
+    ownCollisionGroups: CollisionGroup[] | 'all';
+    interactWithCollisionGroups: CollisionGroup[] | 'all';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gg-web-engine/core",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "description": "An attempt to create open source game engine for browser",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",