@gg-web-engine/core 0.0.57 → 0.0.59

package/dist/3d/components/rendering/{i-camera.component.d.ts → i-camera-3d.component.d.ts}

@@ -1,6 +1,6 @@
 import { IDisplayObject3dComponent } from './i-display-object-3d.component';
 import { VisualTypeDocRepo3D } from '../../gg-3d-world';
-export interface ICameraComponent<TypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IDisplayObject3dComponent<TypeDoc> {
+export interface ICamera3dComponent<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IDisplayObject3dComponent<VTypeDoc> {
     get supportsFov(): boolean;
     get fov(): number;
     set fov(f: number);

package/dist/3d/components/rendering/i-camera-3d.component.js

@@ -0,0 +1 @@
+export {};

package/dist/3d/components/rendering/i-display-object-3d.component.d.ts

@@ -1,4 +1,4 @@
 import { IDisplayObjectComponent, Point3, Point4 } from '../../../base';
 import { VisualTypeDocRepo3D } from '../../gg-3d-world';
-export interface IDisplayObject3dComponent<TypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IDisplayObjectComponent<Point3, Point4, TypeDoc> {
+export interface IDisplayObject3dComponent<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IDisplayObjectComponent<Point3, Point4, VTypeDoc> {
 }

package/dist/3d/components/rendering/i-renderer-3d.component.d.ts

@@ -1,5 +1,4 @@
 import { IRendererComponent, Point3, Point4 } from '../../../base';
 import { VisualTypeDocRepo3D } from '../../gg-3d-world';
-export declare abstract class IRenderer3dComponent<TypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IRendererComponent<Point3, Point4, TypeDoc> {
-    abstract camera: TypeDoc['camera'];
+export declare abstract class IRenderer3dComponent<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IRendererComponent<Point3, Point4, VTypeDoc> {
 }

package/dist/3d/components/rendering/i-visual-scene-3d.component.d.ts

@@ -1,6 +1,5 @@
-import { IVisualSceneComponent, Point3, Point4, RendererOptions } from '../../../base';
+import { IVisualSceneComponent, Point3, Point4 } from '../../../base';
 import { VisualTypeDocRepo3D } from '../../gg-3d-world';
-export interface IVisualScene3dComponent<TypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IVisualSceneComponent<Point3, Point4, TypeDoc> {
-    readonly loader: TypeDoc['loader'];
-    createRenderer(camera: TypeDoc['camera'], canvas?: HTMLCanvasElement, rendererOptions?: Partial<RendererOptions & TypeDoc['rendererExtraOpts']>): TypeDoc['renderer'];
+export interface IVisualScene3dComponent<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IVisualSceneComponent<Point3, Point4, VTypeDoc> {
+    readonly loader: VTypeDoc['loader'];
 }

package/dist/3d/entities/camera-3d.entity.d.ts

@@ -0,0 +1,24 @@
+import { IPositionable3d } from '../interfaces/i-positionable-3d';
+import { IEntity, Point3, Point4, TickOrder } from '../../base';
+import { Gg3dWorldTypeDocVPatch, VisualTypeDocRepo3D } from '../gg-3d-world';
+/**
+ * A positioned entity wrapping a camera component (`VTypeDoc['camera']`, e.g. the adapter-specific
+ * camera type an app's `TypedGg3dWorld` uses) - not attached to any renderer/canvas itself (pass
+ * `.camera` to `Gg3dWorld.addRenderer` for that), but addressable in the world/entity trees like
+ * any other entity: `world.addEntity`/`getEntityByName`, `IEntity.getChildEntityByName`,
+ * `removeEntity`.
+ * @template VTypeDoc - The visual type document repository (parametrize this the same way an
+ * app's world type is, e.g. `Camera3dEntity<ThreeVisualTypeDocRepo>`, so `.camera` comes back as
+ * the adapter-specific camera type rather than the unbound base `ICamera3dComponent`)
+ */
+export declare class Camera3dEntity<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IEntity<Point3, Point4, Gg3dWorldTypeDocVPatch<VTypeDoc>> implements IPositionable3d {
+    readonly camera: VTypeDoc['camera'];
+    readonly tickOrder = TickOrder.OBJECTS_BINDING;
+    private _position;
+    get position(): Point3;
+    set position(value: Point3);
+    private _rotation;
+    get rotation(): Point4;
+    set rotation(value: Point4);
+    constructor(camera: VTypeDoc['camera']);
+}

package/dist/3d/entities/camera-3d.entity.js

@@ -0,0 +1,35 @@
+import { IEntity, Pnt3, Qtrn, TickOrder } from '../../base';
+/**
+ * A positioned entity wrapping a camera component (`VTypeDoc['camera']`, e.g. the adapter-specific
+ * camera type an app's `TypedGg3dWorld` uses) - not attached to any renderer/canvas itself (pass
+ * `.camera` to `Gg3dWorld.addRenderer` for that), but addressable in the world/entity trees like
+ * any other entity: `world.addEntity`/`getEntityByName`, `IEntity.getChildEntityByName`,
+ * `removeEntity`.
+ * @template VTypeDoc - The visual type document repository (parametrize this the same way an
+ * app's world type is, e.g. `Camera3dEntity<ThreeVisualTypeDocRepo>`, so `.camera` comes back as
+ * the adapter-specific camera type rather than the unbound base `ICamera3dComponent`)
+ */
+export class Camera3dEntity extends IEntity {
+    get position() {
+        return this._position;
+    }
+    set position(value) {
+        this.camera.position = value;
+        this._position = value;
+    }
+    get rotation() {
+        return this._rotation;
+    }
+    set rotation(value) {
+        this.camera.rotation = value;
+        this._rotation = value;
+    }
+    constructor(camera) {
+        super();
+        this.camera = camera;
+        this.tickOrder = TickOrder.OBJECTS_BINDING;
+        this._position = Pnt3.O;
+        this._rotation = Qtrn.O;
+        this.addComponents(this.camera);
+    }
+}

package/dist/3d/entities/controllers/animators/camera-3d.animator.d.ts

@@ -1,5 +1,5 @@
 import { AnimationFunction, AnimationMixer, Point3, Point4 } from '../../../../base';
-import { Gg3dWorld, VisualTypeDocRepo3D } from '../../../gg-3d-world';
+import { Gg3dWorld, Gg3dWorldTypeDocVPatch, VisualTypeDocRepo3D } from '../../../gg-3d-world';
 import { Renderer3dEntity } from '../../renderer-3d.entity';
 export type Camera3dAnimationArgs = {
     position: Point3;
@@ -7,10 +7,10 @@ export type Camera3dAnimationArgs = {
     up?: Point3;
     fov?: number;
 };
-export declare class Camera3dAnimator<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends AnimationMixer<Camera3dAnimationArgs, Point3, Point4, VTypeDoc> {
+export declare class Camera3dAnimator<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends AnimationMixer<Camera3dAnimationArgs, Point3, Point4, Gg3dWorldTypeDocVPatch<VTypeDoc>> {
     entity: Renderer3dEntity<VTypeDoc>;
     protected _animationFunction: AnimationFunction<Camera3dAnimationArgs>;
     constructor(entity: Renderer3dEntity<VTypeDoc>, _animationFunction: AnimationFunction<Camera3dAnimationArgs>);
-    onSpawned(world: Gg3dWorld<VTypeDoc>): void;
+    onSpawned(world: Gg3dWorld<Gg3dWorldTypeDocVPatch<VTypeDoc>>): void;
     protected applyPositioning(value: Camera3dAnimationArgs): void;
 }

package/dist/3d/entities/controllers/animators/entity-3d-positioning.animator.d.ts

@@ -1,11 +1,11 @@
 import { AnimationFunction, AnimationMixer, Point3, Point4 } from '../../../../base';
-import { Gg3dWorld, PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../../../gg-3d-world';
+import { Gg3dWorld, Gg3dWorldTypeDocRepo } from '../../../gg-3d-world';
 import { IPositionable3d } from '../../../interfaces/i-positionable-3d';
 type Positioning3d = {
     position: Point3;
     rotation: Point4;
 };
-export declare class Entity3dPositioningAnimator<T extends IPositionable3d = IPositionable3d> extends AnimationMixer<Positioning3d, Point3, Point4, VisualTypeDocRepo3D, PhysicsTypeDocRepo3D> {
+export declare class Entity3dPositioningAnimator<T extends IPositionable3d = IPositionable3d> extends AnimationMixer<Positioning3d, Point3, Point4, Gg3dWorldTypeDocRepo> {
     entity: T;
     protected _animationFunction: AnimationFunction<Positioning3d>;
     constructor(entity: T, _animationFunction: AnimationFunction<Positioning3d>);

package/dist/3d/entities/entity-3d.d.ts

@@ -3,8 +3,8 @@ import { IRigidBody3dComponent } from '../components/physics/i-rigid-body-3d.com
 import { IDisplayObject3dComponent } from '../components/rendering/i-display-object-3d.component';
 import { IPositionable3d } from '../interfaces/i-positionable-3d';
 import { IRenderable3dEntity } from './i-renderable-3d.entity';
-import { PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../gg-3d-world';
-export declare class Entity3d<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D, PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends IRenderable3dEntity<VTypeDoc, PTypeDoc> implements IPositionable3d {
+import { Gg3dWorldTypeDocRepo } from '../gg-3d-world';
+export declare class Entity3d<TypeDoc extends Gg3dWorldTypeDocRepo = Gg3dWorldTypeDocRepo> extends IRenderable3dEntity<TypeDoc> implements IPositionable3d {
     readonly tickOrder = TickOrder.OBJECTS_BINDING;
     private _position;
     get position(): Point3;
@@ -12,15 +12,15 @@ export declare class Entity3d<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeD
     private _rotation;
     get rotation(): Point4;
     set rotation(value: Point4);
-    readonly object3D: VTypeDoc['displayObject'] | null;
-    readonly objectBody: PTypeDoc['rigidBody'] | null;
+    readonly object3D: TypeDoc['vTypeDoc']['displayObject'] | null;
+    readonly objectBody: TypeDoc['pTypeDoc']['rigidBody'] | null;
     updateVisibility(): void;
     /**
      * Synchronize physics body transform with entity (and mesh if defined)
      * */
     protected runTransformBinding(objectBody: IRigidBody3dComponent, object3D: IDisplayObject3dComponent | null): void;
     constructor(options: {
-        object3D?: VTypeDoc['displayObject'] | null;
-        objectBody?: PTypeDoc['rigidBody'] | null;
+        object3D?: TypeDoc['vTypeDoc']['displayObject'] | null;
+        objectBody?: TypeDoc['pTypeDoc']['rigidBody'] | null;
     });
 }

package/dist/3d/entities/gg-car/gg-car.entity.d.ts

@@ -1,5 +1,5 @@
 import { RaycastVehicle3dEntity, RVEntityProperties } from '../raycast-vehicle-3d.entity';
-import { Gg3dWorld, PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../../gg-3d-world';
+import { Gg3dWorld, Gg3dWorldTypeDocRepo } from '../../gg-3d-world';
 import { IRenderable3dEntity } from '../i-renderable-3d.entity';
 import { IPositionable3d } from '../../interfaces/i-positionable-3d';
 import { Point3, Point4 } from '../../../base';
@@ -32,7 +32,7 @@ export type GgCarProperties = RVEntityProperties & {
     };
     maxSteerAngle: number;
 };
-export declare class GgCarEntity<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D, PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D, RVEntity extends RaycastVehicle3dEntity<VTypeDoc, PTypeDoc> = RaycastVehicle3dEntity<VTypeDoc, PTypeDoc>> extends IRenderable3dEntity<VTypeDoc, PTypeDoc> implements IPositionable3d {
+export declare class GgCarEntity<TypeDoc extends Gg3dWorldTypeDocRepo = Gg3dWorldTypeDocRepo, RVEntity extends RaycastVehicle3dEntity<TypeDoc> = RaycastVehicle3dEntity<TypeDoc>> extends IRenderable3dEntity<TypeDoc> implements IPositionable3d {
     readonly carProperties: GgCarProperties;
     readonly tickOrder: number;
     get position(): Point3;
@@ -69,9 +69,9 @@ export declare class GgCarEntity<VTypeDoc extends VisualTypeDocRepo3D = VisualTy
     set gear(value: number);
     set isHonking(value: boolean);
     readonly raycastVehicle: RVEntity;
-    constructor(carProperties: GgCarProperties, chassis3D: VTypeDoc['displayObject'] | null, chassisBody: PTypeDoc['raycastVehicle']);
-    protected createRaycastVehicle(carProperties: GgCarProperties, chassis3D: VTypeDoc['displayObject'] | null, chassisBody: PTypeDoc['raycastVehicle']): RVEntity;
-    onSpawned(world: Gg3dWorld<VTypeDoc, PTypeDoc>): void;
+    constructor(carProperties: GgCarProperties, chassis3D: TypeDoc['vTypeDoc']['displayObject'] | null, chassisBody: TypeDoc['pTypeDoc']['raycastVehicle']);
+    protected createRaycastVehicle(carProperties: GgCarProperties, chassis3D: TypeDoc['vTypeDoc']['displayObject'] | null, chassisBody: TypeDoc['pTypeDoc']['raycastVehicle']): RVEntity;
+    onSpawned(world: Gg3dWorld<TypeDoc>): void;
     protected updateEngine(delta: number): void;
     resetTo(options?: {
         position?: Point3;

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

@@ -1,6 +1,6 @@
 import { IRenderableEntity, Point3, Point4 } from '../../base';
-import { Gg3dWorld, PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../gg-3d-world';
-export declare abstract class IRenderable3dEntity<TypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D, PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends IRenderableEntity<Point3, Point4, TypeDoc, PTypeDoc> {
-    protected _world: Gg3dWorld<TypeDoc, PTypeDoc> | null;
-    get world(): Gg3dWorld<TypeDoc, PTypeDoc> | null;
+import { Gg3dWorld, Gg3dWorldTypeDocRepo } from '../gg-3d-world';
+export declare abstract class IRenderable3dEntity<TypeDoc extends Gg3dWorldTypeDocRepo = Gg3dWorldTypeDocRepo> extends IRenderableEntity<Point3, Point4, TypeDoc> {
+    protected _world: Gg3dWorld<TypeDoc> | null;
+    get world(): Gg3dWorld<TypeDoc> | null;
 }

package/dist/3d/entities/map-graph-3d.entity.d.ts

@@ -1,6 +1,6 @@
 import { BehaviorSubject, Observable, Subject } from 'rxjs';
 import { Graph, IEntity, PausableClock, Point3, Point4, TickOrder } from '../../base';
-import { Gg3dWorld, PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../gg-3d-world';
+import { Gg3dWorld, Gg3dWorldTypeDocRepo } from '../gg-3d-world';
 import { Entity3d } from './entity-3d';
 import { LoadOptions, LoadResultWithProps } from '../loader';
 import { IPositionable3d } from '../interfaces/i-positionable-3d';
@@ -38,7 +38,7 @@ export type Gg3dMapGraphEntityOptions = {
     inertia: number;
     maxNodesLoadingPerTick: number;
 };
-export declare class MapGraph3dEntity<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D, PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends IRenderable3dEntity<VTypeDoc, PTypeDoc> {
+export declare class MapGraph3dEntity<TypeDoc extends Gg3dWorldTypeDocRepo = Gg3dWorldTypeDocRepo> extends IRenderable3dEntity<TypeDoc> {
     readonly mapGraph: MapGraph;
     readonly tickOrder = TickOrder.POST_RENDERING;
     readonly loaderCursor$: BehaviorSubject<Point3>;
@@ -48,14 +48,14 @@ export declare class MapGraph3dEntity<VTypeDoc extends VisualTypeDocRepo3D = Vis
     private _nearestDummy$;
     get nearestDummy(): Graph<MapGraphNodeType> | null;
     protected _chunkLoaded$: Subject<[
-        LoadResultWithProps<VTypeDoc, PTypeDoc>,
+        LoadResultWithProps<TypeDoc>,
         {
             position: Point3;
             rotation: Point4;
         }
     ]>;
     get chunkLoaded$(): Observable<[
-        LoadResultWithProps<VTypeDoc, PTypeDoc>,
+        LoadResultWithProps<TypeDoc>,
         {
             position: Point3;
             rotation: Point4;
@@ -68,8 +68,8 @@ export declare class MapGraph3dEntity<VTypeDoc extends VisualTypeDocRepo3D = Vis
     get loadRateLimit(): number;
     set loadRateLimit(value: number);
     constructor(mapGraph: MapGraph, options?: Partial<Gg3dMapGraphEntityOptions>);
-    onSpawned(world: Gg3dWorld<VTypeDoc, PTypeDoc>): void;
+    onSpawned(world: Gg3dWorld<TypeDoc>): void;
     onRemoved(): void;
-    protected loadChunk(node: MapGraphNodeType): Promise<[Entity3d<VTypeDoc, PTypeDoc>[], LoadResultWithProps<VTypeDoc, PTypeDoc>]>;
+    protected loadChunk(node: MapGraphNodeType): Promise<[Entity3d<TypeDoc>[], LoadResultWithProps<TypeDoc>]>;
     protected disposeChunk(node: MapGraphNodeType): void;
 }

package/dist/3d/entities/raycast-vehicle-3d.entity.d.ts

@@ -3,7 +3,7 @@ import { Entity3d } from './entity-3d';
 import { IDisplayObject3dComponent } from '../components/rendering/i-display-object-3d.component';
 import { IRaycastVehicleComponent, SuspensionOptions } from '../components/physics/i-raycast-vehicle.component';
 import { IRigidBody3dComponent } from '../components/physics/i-rigid-body-3d.component';
-import { PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../gg-3d-world';
+import { Gg3dWorldTypeDocRepo } from '../gg-3d-world';
 export type WheelDisplayOptions = {
     displayObject?: IDisplayObject3dComponent;
     wheelObjectDirection?: AxisDirection3;
@@ -43,11 +43,11 @@ export type RVEntityProperties = {
     })[];
     sharedWheelOptions?: RVEntitySharedWheelOptions;
 });
-export declare class RaycastVehicle3dEntity<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D, PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends Entity3d<VTypeDoc, PTypeDoc> {
+export declare class RaycastVehicle3dEntity<TypeDoc extends Gg3dWorldTypeDocRepo = Gg3dWorldTypeDocRepo> extends Entity3d<TypeDoc> {
     readonly carProperties: RVEntityProperties;
     readonly chassis3D: IDisplayObject3dComponent | null;
     readonly vehicleComponent: IRaycastVehicleComponent;
-    protected readonly wheels: (Entity3d<VTypeDoc, PTypeDoc> | null)[];
+    protected readonly wheels: (Entity3d<TypeDoc> | null)[];
     protected readonly wheelLocalRotation: (Point4 | null)[];
     protected readonly frontWheelsIndices: number[];
     protected readonly rearWheelsIndices: number[];

package/dist/3d/entities/renderer-3d.entity.d.ts

@@ -1,10 +1,5 @@
 import { IRendererEntity, Point3, Point4 } from '../../base';
 import { IPositionable3d } from '../interfaces/i-positionable-3d';
 import { VisualTypeDocRepo3D } from '../gg-3d-world';
-export declare class Renderer3dEntity<TypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IRendererEntity<Point3, Point4, TypeDoc> implements IPositionable3d {
-    get position(): Point3;
-    set position(value: Point3);
-    get rotation(): Point4;
-    set rotation(value: Point4);
-    get camera(): TypeDoc['camera'];
+export declare class Renderer3dEntity<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> extends IRendererEntity<Point3, Point4, VTypeDoc> implements IPositionable3d {
 }

package/dist/3d/entities/renderer-3d.entity.js

@@ -1,18 +1,3 @@
 import { IRendererEntity } from '../../base';
 export class Renderer3dEntity extends IRendererEntity {
-    get position() {
-        return this.renderer.camera.position;
-    }
-    set position(value) {
-        this.renderer.camera.position = value;
-    }
-    get rotation() {
-        return this.renderer.camera.rotation;
-    }
-    set rotation(value) {
-        this.renderer.camera.rotation = value;
-    }
-    get camera() {
-        return this.renderer.camera;
-    }
 }

package/dist/3d/entities/surface-following.entity.d.ts

@@ -1,5 +1,5 @@
 import { BodyOptions, IEntity, Point3, Point4 } from '../../base';
-import { Gg3dWorld, PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../gg-3d-world';
+import { Gg3dWorld, Gg3dWorldTypeDocPPatch, PhysicsTypeDocRepo3D } from '../gg-3d-world';
 import { Shape3DDescriptor } from '../models/shapes';
 /**
  * Represents a function that calculates the surface position and normal
@@ -15,7 +15,7 @@ export type SurfaceFollowFunc = (p: Point3) => {
  *
  * @template PTypeDoc - The physics type document repository.
  */
-export declare class SurfaceFollowingEntity<PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends IEntity<Point3, Point4, VisualTypeDocRepo3D, PTypeDoc> {
+export declare class SurfaceFollowingEntity<PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends IEntity<Point3, Point4, Gg3dWorldTypeDocPPatch<PTypeDoc>> {
     /** Function that determines surface position and normal. */
     followFunc: SurfaceFollowFunc;
     /** Optional body configuration. */
@@ -61,7 +61,7 @@ export declare class SurfaceFollowingEntity<PTypeDoc extends PhysicsTypeDocRepo3
      *
      * @param world - The game world instance.
      */
-    onSpawned(world: Gg3dWorld<VisualTypeDocRepo3D, PTypeDoc>): void;
+    onSpawned(world: Gg3dWorld<Gg3dWorldTypeDocPPatch<PTypeDoc>>): void;
     private customGlobalDebugDummyBody;
     /**
      * Updates debug visualization if active.

package/dist/3d/entities/surface-following.entity.js

@@ -93,6 +93,9 @@ export class SurfaceFollowingEntity extends IEntity {
      * @param world - The game world instance.
      */
     onSpawned(world) {
+        if (!world.physicsWorld) {
+            throw new Error('Cannot add surface following entity to the world without physics');
+        }
         super.onSpawned(world);
         for (const [collider] of this.colliders.entries()) {
             this.setupCollider(collider);

package/dist/3d/entities/trigger-3d.entity.d.ts

@@ -2,12 +2,16 @@ import { Observable } from 'rxjs';
 import { ITrigger3dComponent } from '../components/physics/i-trigger-3d.component';
 import { IPositionable3d } from '../interfaces/i-positionable-3d';
 import { IEntity, Point3, Point4, TickOrder } from '../../base';
-import { PhysicsTypeDocRepo3D, VisualTypeDocRepo3D } from '../gg-3d-world';
-export declare class Trigger3dEntity<TypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends IEntity<Point3, Point4, VisualTypeDocRepo3D, TypeDoc> implements IPositionable3d {
+import { Gg3dWorldTypeDocPPatch, Gg3dWorldTypeDocRepo, PhysicsTypeDocRepo3D } from '../gg-3d-world';
+export declare class Trigger3dEntity<PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> extends IEntity<Point3, Point4, Gg3dWorldTypeDocPPatch<PTypeDoc>> implements IPositionable3d {
     readonly objectBody: ITrigger3dComponent;
     readonly tickOrder = TickOrder.OBJECTS_BINDING;
-    get onEntityEntered(): Observable<IEntity<Point3, Point4, VisualTypeDocRepo3D, TypeDoc> & IPositionable3d>;
-    get onEntityLeft(): Observable<(IEntity<Point3, Point4, VisualTypeDocRepo3D, TypeDoc> & IPositionable3d) | null>;
+    get onEntityEntered(): Observable<IEntity<Point3, Point4, Gg3dWorldTypeDocRepo & {
+        pTypeDoc: PTypeDoc;
+    }> & IPositionable3d>;
+    get onEntityLeft(): Observable<(IEntity<Point3, Point4, Gg3dWorldTypeDocRepo & {
+        pTypeDoc: PTypeDoc;
+    }> & IPositionable3d) | null>;
     private _position;
     get position(): Point3;
     set position(value: Point3);

package/dist/3d/factories.d.ts

@@ -8,32 +8,32 @@ export type DisplayObject3dOpts<Tex> = {
     castShadow?: boolean;
     receiveShadow?: boolean;
 };
-export declare abstract class IDisplayObject3dComponentFactory<TypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> {
-    abstract createPrimitive(descriptor: Shape3DMeshDescriptor, material?: DisplayObject3dOpts<TypeDoc['texture']>): TypeDoc['displayObject'];
-    abstract createPerspectiveCamera(settings: {
+export declare abstract class IDisplayObject3dComponentFactory<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D> {
+    abstract createPrimitive(descriptor: Shape3DMeshDescriptor, material?: DisplayObject3dOpts<VTypeDoc['texture']>): VTypeDoc['displayObject'];
+    abstract createPerspectiveCamera(settings?: {
         fov?: number;
         aspectRatio?: number;
         frustrum?: {
             near: number;
             far: number;
         };
-    }): TypeDoc['camera'];
+    }): VTypeDoc['camera'];
     randomColor(): number;
-    createPlane(material?: DisplayObject3dOpts<TypeDoc['texture']>): TypeDoc['displayObject'];
-    createBox(dimensions: Point3, material?: DisplayObject3dOpts<TypeDoc['texture']>): TypeDoc['displayObject'];
-    createCapsule(radius: number, centersDistance: number, material?: DisplayObject3dOpts<TypeDoc['texture']>): TypeDoc['displayObject'];
-    createCylinder(radius: number, height: number, material?: DisplayObject3dOpts<TypeDoc['texture']>): TypeDoc['displayObject'];
-    createCone(radius: number, height: number, material?: DisplayObject3dOpts<TypeDoc['texture']>): TypeDoc['displayObject'];
-    createSphere(radius: number, material?: DisplayObject3dOpts<TypeDoc['texture']>): TypeDoc['displayObject'];
+    createPlane(material?: DisplayObject3dOpts<VTypeDoc['texture']>): VTypeDoc['displayObject'];
+    createBox(dimensions: Point3, material?: DisplayObject3dOpts<VTypeDoc['texture']>): VTypeDoc['displayObject'];
+    createCapsule(radius: number, centersDistance: number, material?: DisplayObject3dOpts<VTypeDoc['texture']>): VTypeDoc['displayObject'];
+    createCylinder(radius: number, height: number, material?: DisplayObject3dOpts<VTypeDoc['texture']>): VTypeDoc['displayObject'];
+    createCone(radius: number, height: number, material?: DisplayObject3dOpts<VTypeDoc['texture']>): VTypeDoc['displayObject'];
+    createSphere(radius: number, material?: DisplayObject3dOpts<VTypeDoc['texture']>): VTypeDoc['displayObject'];
 }
-export interface IPhysicsBody3dComponentFactory<TypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> {
+export interface IPhysicsBody3dComponentFactory<PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D> {
     createRigidBody(descriptor: BodyShape3DDescriptor, transform?: {
         position?: Point3;
         rotation?: Point4;
-    }): TypeDoc['rigidBody'];
+    }): PTypeDoc['rigidBody'];
     createTrigger(descriptor: Shape3DDescriptor, transform?: {
         position?: Point3;
         rotation?: Point4;
-    }): TypeDoc['trigger'];
-    createRaycastVehicle(chassis: TypeDoc['rigidBody']): TypeDoc['raycastVehicle'];
+    }): PTypeDoc['trigger'];
+    createRaycastVehicle(chassis: PTypeDoc['rigidBody']): PTypeDoc['raycastVehicle'];
 }

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

@@ -4,7 +4,7 @@ import { Entity3d } from './entities/entity-3d';
 import { BodyShape3DDescriptor } from './models/shapes';
 import { IVisualScene3dComponent } from './components/rendering/i-visual-scene-3d.component';
 import { Renderer3dEntity } from './entities/renderer-3d.entity';
-import { ICameraComponent } from './components/rendering/i-camera.component';
+import { ICamera3dComponent } from './components/rendering/i-camera-3d.component';
 import { IRenderer3dComponent } from './components/rendering/i-renderer-3d.component';
 import { IPhysicsWorld3dComponent } from './components/physics/i-physics-world-3d.component';
 import { DisplayObject3dOpts, IDisplayObject3dComponentFactory, IPhysicsBody3dComponentFactory } from './factories';
@@ -19,7 +19,7 @@ export type VisualTypeDocRepo3D = {
     displayObject: IDisplayObject3dComponent;
     renderer: IRenderer3dComponent;
     rendererExtraOpts: {};
-    camera: ICameraComponent;
+    camera: ICamera3dComponent;
     texture: unknown;
 };
 export type PhysicsTypeDocRepo3D = {
@@ -29,13 +29,41 @@ export type PhysicsTypeDocRepo3D = {
     trigger: ITrigger3dComponent;
     raycastVehicle: IRaycastVehicleComponent;
 };
-export declare class Gg3dWorld<VTypeDoc extends VisualTypeDocRepo3D = VisualTypeDocRepo3D, PTypeDoc extends PhysicsTypeDocRepo3D = PhysicsTypeDocRepo3D, VS extends IVisualScene3dComponent<VTypeDoc> = IVisualScene3dComponent<VTypeDoc>, PW extends IPhysicsWorld3dComponent<PTypeDoc> = IPhysicsWorld3dComponent<PTypeDoc>> extends GgWorld<Point3, Point4, VTypeDoc, PTypeDoc, VS, PW> {
-    readonly visualScene: VS;
-    readonly physicsWorld: PW;
-    readonly loader: Gg3dLoader<VTypeDoc, PTypeDoc>;
-    constructor(visualScene: VS, physicsWorld: PW);
-    addPrimitiveRigidBody(descr: BodyShape3DDescriptor, position?: Point3, rotation?: Point4, material?: DisplayObject3dOpts<VTypeDoc['texture']>): Entity3d<VTypeDoc, PTypeDoc>;
-    addRenderer(camera: VTypeDoc['camera'], canvas?: HTMLCanvasElement, rendererOptions?: Partial<RendererOptions & VTypeDoc['rendererExtraOpts']>): Renderer3dEntity<VTypeDoc>;
+export type Gg3dWorldTypeDocRepo = {
+    vTypeDoc: VisualTypeDocRepo3D;
+    pTypeDoc: PhysicsTypeDocRepo3D;
+};
+export type Gg3dWorldTypeDocVPatch<VTypeDoc extends VisualTypeDocRepo3D> = Omit<Gg3dWorldTypeDocRepo, 'vTypeDoc'> & {
+    vTypeDoc: VTypeDoc;
+};
+export type Gg3dWorldTypeDocPPatch<PTypeDoc extends PhysicsTypeDocRepo3D> = Omit<Gg3dWorldTypeDocRepo, 'pTypeDoc'> & {
+    pTypeDoc: PTypeDoc;
+};
+export type Gg3dWorldSceneTypeRepo<TypeDoc extends Gg3dWorldTypeDocRepo = Gg3dWorldTypeDocRepo> = {
+    visualScene: IVisualScene3dComponent<TypeDoc['vTypeDoc']> | null;
+    physicsWorld: IPhysicsWorld3dComponent<TypeDoc['pTypeDoc']> | null;
+};
+export type Gg3dWorldSceneTypeDocVPatch<VTypeDoc extends VisualTypeDocRepo3D, VS extends IVisualScene3dComponent<VTypeDoc> | null> = Omit<Gg3dWorldSceneTypeRepo, 'visualScene'> & {
+    visualScene: VS;
+};
+export type Gg3dWorldSceneTypeDocPPatch<PTypeDoc extends PhysicsTypeDocRepo3D, PW extends IPhysicsWorld3dComponent<PTypeDoc> | null> = Omit<Gg3dWorldSceneTypeRepo, 'physicsWorld'> & {
+    physicsWorld: PW;
+};
+export type TypedGg3dWorld<VW extends Gg3dWorld<any> | null, PW extends Gg3dWorld<any> | null> = VW extends Gg3dWorld<infer VTD, infer VSTD> | null ? PW extends Gg3dWorld<infer PTD, infer PSTD> | null ? Gg3dWorld<{
+    vTypeDoc: VTD['vTypeDoc'];
+    pTypeDoc: PTD['pTypeDoc'];
+}, {
+    visualScene: VSTD['visualScene'];
+    physicsWorld: PSTD['physicsWorld'];
+}> : never : never;
+export declare class Gg3dWorld<TypeDoc extends Gg3dWorldTypeDocRepo = Gg3dWorldTypeDocRepo, SceneTypeDoc extends Gg3dWorldSceneTypeRepo<TypeDoc> = Gg3dWorldSceneTypeRepo<TypeDoc>> extends GgWorld<Point3, Point4, TypeDoc, SceneTypeDoc> {
+    readonly loader: Gg3dLoader<TypeDoc>;
+    constructor(args: {
+        visualScene?: SceneTypeDoc['visualScene'];
+        physicsWorld?: SceneTypeDoc['physicsWorld'];
+    });
+    addPrimitiveRigidBody(descr: BodyShape3DDescriptor, position?: Point3, rotation?: Point4, material?: DisplayObject3dOpts<TypeDoc['vTypeDoc']['texture']>): Entity3d<TypeDoc>;
+    addRenderer(camera: TypeDoc['vTypeDoc']['camera'], canvas?: HTMLCanvasElement, rendererOptions?: Partial<RendererOptions & TypeDoc['vTypeDoc']['rendererExtraOpts']>): Renderer3dEntity<TypeDoc['vTypeDoc']>;
     protected registerConsoleCommands(ggstatic: {
         registerConsoleCommand: (world: GgWorld<any, any> | null, command: string, handler: (...args: string[]) => Promise<string>, doc?: string) => void;
     }): void;

package/dist/3d/gg-3d-world.js

@@ -12,16 +12,15 @@ import { Gg3dLoader } from './loader';
 import { Entity3d } from './entities/entity-3d';
 import { Renderer3dEntity } from './entities/renderer-3d.entity';
 export class Gg3dWorld extends GgWorld {
-    constructor(visualScene, physicsWorld) {
-        super(visualScene, physicsWorld);
-        this.visualScene = visualScene;
-        this.physicsWorld = physicsWorld;
+    constructor(args) {
+        super(args);
         this.loader = new Gg3dLoader(this);
     }
     addPrimitiveRigidBody(descr, position = Pnt3.O, rotation = Qtrn.O, material = {}) {
+        var _a, _b;
         const entity = new Entity3d({
-            object3D: this.visualScene.factory.createPrimitive(descr.shape, material),
-            objectBody: this.physicsWorld.factory.createRigidBody(descr),
+            object3D: (_a = this.visualScene) === null || _a === void 0 ? void 0 : _a.factory.createPrimitive(descr.shape, material),
+            objectBody: (_b = this.physicsWorld) === null || _b === void 0 ? void 0 : _b.factory.createRigidBody(descr),
         });
         entity.position = position;
         entity.rotation = rotation;
@@ -29,25 +28,30 @@ export class Gg3dWorld extends GgWorld {
         return entity;
     }
     addRenderer(camera, canvas, rendererOptions) {
+        if (!this.visualScene) {
+            throw new Error('Cannot add renderer to the world without visual scene');
+        }
         const entity = new Renderer3dEntity(this.visualScene.createRenderer(camera, canvas, rendererOptions));
         this.addEntity(entity);
         return entity;
     }
     registerConsoleCommands(ggstatic) {
         super.registerConsoleCommands(ggstatic);
-        ggstatic.registerConsoleCommand(this, 'gravity', (...args) => __awaiter(this, void 0, void 0, function* () {
-            if (args.length == 1) {
-                args = ['0', '0', '' + -+args[0]]; // mean -Z axis
-            }
-            if (args.length > 0) {
-                if (isNaN(+args[0]) || isNaN(+args[1]) || isNaN(+args[2])) {
-                    throw new Error('Wrong arguments');
+        if (this.physicsWorld) {
+            ggstatic.registerConsoleCommand(this, 'gravity', (...args) => __awaiter(this, void 0, void 0, function* () {
+                if (args.length == 1) {
+                    args = ['0', '0', '' + -+args[0]]; // mean -Z axis
                 }
-                this.physicsWorld.gravity = { x: +args[0], y: +args[1], z: +args[2] };
-            }
-            return JSON.stringify(this.physicsWorld.gravity);
-        }), 'args: [ ?float, ?float, ?float ]; Get or set 3D world gravity vector. 1 argument sets ' +
-            'vector {x: 0, y: 0, z: -value}, 3 arguments set the whole vector.' +
-            ' Default value is "9.82" or "0 0 -9.82"');
+                if (args.length > 0) {
+                    if (isNaN(+args[0]) || isNaN(+args[1]) || isNaN(+args[2])) {
+                        throw new Error('Wrong arguments');
+                    }
+                    this.physicsWorld.gravity = { x: +args[0], y: +args[1], z: +args[2] };
+                }
+                return JSON.stringify(this.physicsWorld.gravity);
+            }), 'args: [ ?float, ?float, ?float ]; Get or set 3D world gravity vector. 1 argument sets ' +
+                'vector {x: 0, y: 0, z: -value}, 3 arguments set the whole vector.' +
+                ' Default value is "9.82" or "0 0 -9.82"');
+        }
     }
 }

package/dist/3d/index.d.ts

@@ -3,10 +3,11 @@ export * from './components/physics/i-rigid-body-3d.component';
 export * from './components/physics/i-trigger-3d.component';
 export * from './components/physics/i-physics-world-3d.component';
 export * from './components/rendering/i-display-object-3d.component';
-export * from './components/rendering/i-camera.component';
+export * from './components/rendering/i-camera-3d.component';
 export * from './components/rendering/i-renderer-3d.component';
 export * from './components/rendering/i-visual-scene-3d.component';
 export * from './entities/gg-car/gg-car.entity';
+export * from './entities/camera-3d.entity';
 export * from './entities/controllers/animators/camera-3d.animator';
 export * from './entities/controllers/animators/entity-3d-positioning.animator';
 export * from './entities/entity-3d';
@@ -28,3 +29,4 @@ export * from './loaders';
 export * from './factories';
 export * from './gg-3d-world';
 export * from './loader';
+export * from './level-loader';

package/dist/3d/index.js

@@ -3,10 +3,11 @@ export * from './components/physics/i-rigid-body-3d.component';
 export * from './components/physics/i-trigger-3d.component';
 export * from './components/physics/i-physics-world-3d.component';
 export * from './components/rendering/i-display-object-3d.component';
-export * from './components/rendering/i-camera.component';
+export * from './components/rendering/i-camera-3d.component';
 export * from './components/rendering/i-renderer-3d.component';
 export * from './components/rendering/i-visual-scene-3d.component';
 export * from './entities/gg-car/gg-car.entity';
+export * from './entities/camera-3d.entity';
 export * from './entities/controllers/animators/camera-3d.animator';
 export * from './entities/controllers/animators/entity-3d-positioning.animator';
 export * from './entities/entity-3d';
@@ -28,3 +29,4 @@ export * from './loaders';
 export * from './factories';
 export * from './gg-3d-world';
 export * from './loader';
+export * from './level-loader';