@benjos/create-boilerplate 1.3.5 → 1.4.1

package/template-vanilla/src/experiences/views/threes/worlds/components/actors/TemplateMesh.ts

@@ -4,12 +4,6 @@ import ThreeAssetsManager from '../../../../../managers/threes/ThreeAssetsManage
 import ActorBase from './bases/ActorBase';
 
 export default class TemplateMesh extends ActorBase {
-    declare private _geometry: SphereGeometry;
-    declare private _material: MeshStandardMaterial;
-    declare private _mesh: Mesh;
-
-    //#region Constants
-    //
     private static readonly _DEFAULT_GEOMETRY_RADIUS = 1;
     private static readonly _DEFAULT_GEOMETRY_WIDTH_SEGMENTS = 64;
     private static readonly _DEFAULT_GEOMETRY_HEIGHT_SEGMENTS = 64;
@@ -21,8 +15,10 @@ export default class TemplateMesh extends ActorBase {
         envMapIntensity: 0,
     };
     private static readonly _MESH_ROTATION_Y = 0.25;
-    //
-    //#endregion
+
+    declare private _geometry: SphereGeometry;
+    declare private _material: MeshStandardMaterial;
+    declare private _mesh: Mesh;
 
     constructor() {
         super();
@@ -41,7 +37,7 @@ export default class TemplateMesh extends ActorBase {
     }
 
     private _generateMaterial(): void {
-        const normalMat = ThreeAssetsManager.GetTexture(AssetId.THREE_TEXTURE_TEMPLATE);
+        const normalMat = ThreeAssetsManager.getTexture(AssetId.THREE_TEXTURE_TEMPLATE);
         normalMat.repeat.set(TemplateMesh._DEFAULT_MATERIAL_REPEAT, TemplateMesh._DEFAULT_MATERIAL_REPEAT);
         normalMat.wrapS = normalMat.wrapT = RepeatWrapping;
 
@@ -58,6 +54,12 @@ export default class TemplateMesh extends ActorBase {
         this.add(this._mesh);
     }
 
+    public override dispose(): void {
+        super.dispose();
+        this._geometry.dispose();
+        this._material.dispose();
+    }
+
     public update(dt: number): void {
         super.update(dt);
         this._mesh.rotation.y += dt * TemplateMesh._MESH_ROTATION_Y;

package/template-vanilla/src/experiences/views/threes/worlds/components/actors/TemplateModel.ts

@@ -4,12 +4,8 @@ import DebugManager from '../../../../../managers/DebugManager';
 import ModelBase from './bases/ModelBase';
 
 export default class TemplateModel extends ModelBase {
-    //#region Constants
-    //
     private static readonly _DEFAULT_POSITION: Vector3 = new Vector3(0, 1, 0);
     private static readonly _ROTATION_Y = 0.25;
-    //
-    //#endregion
 
     constructor() {
         super(AssetId.THREE_GLTF_TEMPLATE, {
@@ -18,8 +14,8 @@ export default class TemplateModel extends ModelBase {
         });
         this.position.copy(TemplateModel._DEFAULT_POSITION);
 
-        if (DebugManager.IsActive) {
-            const templateModelFolder = DebugManager.Gui.addFolder('Template Model');
+        if (DebugManager.isActive) {
+            const templateModelFolder = DebugManager.gui.addFolder('Template Model');
             templateModelFolder.add(this.position, 'y', -1, 1, 0.01);
         }
     }

package/template-vanilla/src/experiences/views/threes/worlds/components/actors/bases/ActorBase.ts

@@ -5,5 +5,17 @@ export default abstract class ActorBase extends Object3D {
         super();
     }
 
-    public update(_dt: number): void {}
+    public init(): void {
+        this.reset();
+    }
+
+    public reset(): void {
+        //
+    }
+
+    public dispose(): void {
+        //
+    }
+
+    public update(_dt: number): void { }
 }

package/template-vanilla/src/experiences/views/threes/worlds/components/actors/bases/AnimatedModelBase.ts

@@ -2,27 +2,23 @@ import { AnimationAction, AnimationMixer } from 'three';
 import type { AnimationId } from '../../../../../../constants/experiences/AnimationId';
 import type { AssetId } from '../../../../../../constants/experiences/AssetId';
 import ThreeAssetsManager from '../../../../../../managers/threes/ThreeAssetsManager';
-import ModelBase, { type IModelBaseParams } from './ModelBase';
+import ModelBase, { type ModelBaseParams } from './ModelBase';
 
 export default abstract class AnimatedModelBase extends ModelBase {
+    private static readonly _DEFAULT_ANIMATION_FADE_DURATION: number = 1;
+
     declare private _mixer: AnimationMixer;
     declare private _actions: AnimationAction[];
     declare private _currentAction: AnimationAction | null;
 
-    //#region Constants
-    //
-    private static readonly _DEFAULT_ANIMATION_FADE_DURATION: number = 1;
-    //
-    //#endregion
-
-    constructor(assetId: AssetId, params: IModelBaseParams = {}) {
+    constructor(assetId: AssetId, params: ModelBaseParams = {}) {
         super(assetId, params);
 
         this._generateAnimations();
     }
 
     protected _generateAnimations(): void {
-        const animations = ThreeAssetsManager.GetModel(this._assetId).animations;
+        const animations = ThreeAssetsManager.getModel(this._assetId).animations;
         this._mixer = new AnimationMixer(this._model);
         this._actions = [];
         this._currentAction = null;

package/template-vanilla/src/experiences/views/threes/worlds/components/actors/bases/ModelBase.ts

@@ -5,7 +5,7 @@ import type { Object3DId } from '../../../../../../constants/experiences/Object3
 import ThreeAssetsManager from '../../../../../../managers/threes/ThreeAssetsManager';
 import ActorBase from './ActorBase';
 
-export interface IModelBaseParams {
+export interface ModelBaseParams {
     object3DId?: Object3DId;
     castShadow?: boolean;
     receiveShadow?: boolean;
@@ -13,10 +13,10 @@ export interface IModelBaseParams {
 
 export default abstract class ModelBase extends ActorBase {
     protected _assetId: AssetId;
-    protected _parameters: IModelBaseParams;
+    protected _parameters: ModelBaseParams;
     declare protected _model: Group | Object3D | Mesh;
 
-    constructor(assetId: AssetId, params: IModelBaseParams = {}) {
+    constructor(assetId: AssetId, params: ModelBaseParams = {}) {
         super();
         this._assetId = assetId;
         this._parameters = params || {};
@@ -25,7 +25,7 @@ export default abstract class ModelBase extends ActorBase {
     }
 
     protected _generateModel(): void {
-        const originalModel = ThreeAssetsManager.GetModel(this._assetId).scene;
+        const originalModel = ThreeAssetsManager.getModel(this._assetId).scene;
         const model = SkeletonUtils.clone(originalModel);
 
         this._model = this._parameters.object3DId
@@ -42,6 +42,20 @@ export default abstract class ModelBase extends ActorBase {
         this.add(this._model);
     }
 
+    public override dispose(): void {
+        super.dispose();
+        this._model.traverse((child) => {
+            if (child instanceof Mesh) {
+                child.geometry.dispose();
+                if (Array.isArray(child.material)) {
+                    child.material.forEach((material) => material.dispose());
+                } else {
+                    child.material.dispose();
+                }
+            }
+        });
+    }
+
     public update(dt: number): void {
         super.update(dt);
     }

package/template-vanilla/src/main.ts

@@ -1,3 +1,3 @@
 import Experience from './experiences/Experience';
 
-Experience.Init();
+Experience.init();

package/template-vanilla/tsconfig.json

@@ -0,0 +1,17 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "ESNext",
+        "moduleResolution": "Node",
+        "strict": true,
+        "lib": [
+            "DOM",
+            "ES2020"
+        ],
+        "skipLibCheck": true,
+        "noEmit": true
+    },
+    "include": [
+        "src"
+    ]
+}

package/template-vanilla/src/experiences/constants/experiences/CameraType.ts

@@ -1,6 +0,0 @@
-export const CameraType = {
-    PERSPECTIVE: 'PERSPECTIVE',
-    ORTHOGRAPHIC: 'ORTHOGRAPHIC',
-} as const;
-
-export type CameraType = (typeof CameraType)[keyof typeof CameraType];

package/template-vanilla/src/experiences/managers/KeyboardManager.ts

@@ -1,65 +0,0 @@
-import { Action } from '@benjos/cookware';
-import { DomEvent } from '@benjos/spices';
-
-export class KeyboardManager {
-    private static readonly _KeyDownsMap = new Map<string, boolean>();
-    private static readonly _CodeDownsMap = new Map<string, boolean>();
-
-    public static readonly OnKeyDown = new Action<[KeyboardEvent]>();
-    public static readonly OnKeyUp = new Action<[KeyboardEvent]>();
-
-    public static Init(): void {
-        KeyboardManager._KeyDownsMap.clear();
-        KeyboardManager._CodeDownsMap.clear();
-        KeyboardManager._AddCallbacks();
-    }
-
-    private static _AddCallbacks(): void {
-        KeyboardManager._RemoveCallbacks();
-        window.addEventListener(DomEvent.KEY_DOWN, KeyboardManager._OnKeyDown);
-        window.addEventListener(DomEvent.KEY_UP, KeyboardManager._OnKeyUp);
-    }
-
-    private static _RemoveCallbacks(): void {
-        window.removeEventListener(DomEvent.KEY_DOWN, KeyboardManager._OnKeyDown);
-        window.removeEventListener(DomEvent.KEY_UP, KeyboardManager._OnKeyUp);
-    }
-
-    private static readonly _OnKeyDown = (e: KeyboardEvent): void => {
-        KeyboardManager._KeyDownsMap.set(e.key, true);
-        KeyboardManager._CodeDownsMap.set(e.code, true);
-        KeyboardManager.OnKeyDown.execute(e);
-    };
-
-    private static readonly _OnKeyUp = (e: KeyboardEvent): void => {
-        KeyboardManager.OnKeyUp.execute(e);
-        KeyboardManager._KeyDownsMap.set(e.key, false);
-        KeyboardManager._CodeDownsMap.set(e.code, false);
-    };
-
-    public static IsKeyDown(name: string): boolean {
-        if (!KeyboardManager.IsAvailableForControl()) return false;
-        if (KeyboardManager._CodeDownsMap.get(name)) return true;
-        if (KeyboardManager._KeyDownsMap.get(name)) return true;
-        return false;
-    }
-
-    public static IsAnyKeyDown(names: string[]): boolean {
-        if (!KeyboardManager.IsAvailableForControl()) return false;
-        return names.some((name) => KeyboardManager.IsKeyDown(name));
-    }
-
-    public static AreAllKeysDown(names: string[]): boolean {
-        if (!KeyboardManager.IsAvailableForControl()) return false;
-        return names.every((name) => KeyboardManager.IsKeyDown(name));
-    }
-
-    public static IsAvailableForControl(): boolean {
-        const active: HTMLElement = document.activeElement as HTMLElement;
-        return !(
-            active instanceof HTMLInputElement ||
-            active instanceof HTMLTextAreaElement ||
-            active?.isContentEditable
-        );
-    }
-}

package/template-vanilla/src/experiences/managers/MouseManager.ts

@@ -1,100 +0,0 @@
-import { Action } from '@benjos/cookware';
-import { DomEvent } from '@benjos/spices';
-
-export default class MouseManager {
-    private static _X = 0;
-    private static _Y = 0;
-    private static _NormalizedX = 0;
-    private static _NormalizedY = 0;
-    private static _CentralX = 0;
-    private static _CentralY = 0;
-
-    public static readonly OnMouseDown = new Action();
-    public static readonly OnMouseUp = new Action();
-    public static readonly OnMouseMove = new Action();
-
-    public static Init(): void {
-        this._AddCallbacks();
-    }
-
-    private static _AddCallbacks(): void {
-        this._RemoveCallbacks();
-        window.addEventListener(DomEvent.TOUCH_START, this._OnMouseDown);
-        window.addEventListener(DomEvent.TOUCH_END, this._OnMouseUp);
-        window.addEventListener(DomEvent.TOUCH_MOVE, this._OnMouseMove);
-        window.addEventListener(DomEvent.MOUSE_DOWN, this._OnMouseDown);
-        window.addEventListener(DomEvent.MOUSE_UP, this._OnMouseUp);
-        window.addEventListener(DomEvent.MOUSE_MOVE, this._OnMouseMove);
-    }
-
-    private static _RemoveCallbacks(): void {
-        window.removeEventListener(DomEvent.TOUCH_START, this._OnMouseDown);
-        window.removeEventListener(DomEvent.TOUCH_END, this._OnMouseUp);
-        window.removeEventListener(DomEvent.TOUCH_MOVE, this._OnMouseMove);
-        window.removeEventListener(DomEvent.MOUSE_DOWN, this._OnMouseDown);
-        window.removeEventListener(DomEvent.MOUSE_UP, this._OnMouseUp);
-        window.removeEventListener(DomEvent.MOUSE_MOVE, this._OnMouseMove);
-    }
-
-    private static readonly _OnMouseDown = (event: MouseEvent | TouchEvent): void => {
-        this._OnMouseMove(event);
-        this.OnMouseDown.execute();
-    };
-
-    private static readonly _OnMouseUp = (_event: MouseEvent | TouchEvent): void => {
-        this.OnMouseUp.execute();
-    };
-
-    private static readonly _OnMouseMove = (event: MouseEvent | TouchEvent): void => {
-        this._UpdateMousePosition(event);
-        this.OnMouseMove.execute();
-    };
-
-    private static _UpdateMousePosition(event: Event): void {
-        const { x, y } = this._GetMousePosition(event);
-        this._X = x;
-        this._Y = y;
-        this._NormalizedX = this._X / window.innerWidth;
-        this._NormalizedY = 1 - this._Y / window.innerHeight;
-        this._CentralX = this._NormalizedX * 2 - 1;
-        this._CentralY = this._NormalizedY * 2 - 1;
-        this.OnMouseMove.execute();
-    }
-
-    private static _GetMousePosition(e: Event): { x: number; y: number } {
-        if (e instanceof MouseEvent) {
-            return { x: e.clientX, y: e.clientY };
-        }
-
-        if (window.TouchEvent && e instanceof TouchEvent) {
-            if (e.touches.length > 0) {
-                return { x: e.touches[0].clientX, y: e.touches[0].clientY };
-            }
-        }
-
-        return { x: 0, y: 0 };
-    }
-
-    //#region Getters
-    //
-    public static get X(): number {
-        return this._X;
-    }
-    public static get Y(): number {
-        return this._Y;
-    }
-    public static get NormalizedX(): number {
-        return this._NormalizedX;
-    }
-    public static get NormalizedY(): number {
-        return this._NormalizedY;
-    }
-    public static get CentralX(): number {
-        return this._CentralX;
-    }
-    public static get CentralY(): number {
-        return this._CentralY;
-    }
-    //
-    //#endregion
-}

package/template-vanilla/src/experiences/managers/ResizeManager.ts

@@ -1,53 +0,0 @@
-import { Action } from '@benjos/cookware';
-import TickerManager from './TickerManager';
-
-export class ResizeManager {
-    private static _Width: number;
-    private static _Height: number;
-    private static _PixelRatio: number;
-
-    public static readonly OnResize = new Action();
-
-    //#region Constants
-    //
-    private static readonly _MAX_PIXEL_RATIO: number = 2;
-    //
-    //#endregion
-
-    public static Init(): void {
-        ResizeManager.Reset();
-        ResizeManager._Resize();
-        TickerManager.Add(ResizeManager.Update);
-    }
-
-    public static Reset(): void {
-        TickerManager.Remove(ResizeManager.Update);
-    }
-
-    private static readonly _Resize = (): void => {
-        ResizeManager._Width = window.innerWidth;
-        ResizeManager._Height = window.innerHeight;
-        ResizeManager._PixelRatio = Math.min(window.devicePixelRatio, ResizeManager._MAX_PIXEL_RATIO);
-
-        ResizeManager.OnResize.execute();
-    };
-
-    public static readonly Update = (_dt: number): void => {
-        if (ResizeManager._Width !== window.innerWidth || ResizeManager._Height !== window.innerHeight)
-            ResizeManager._Resize();
-    };
-
-    //#region Getters
-    //
-    public static get Width(): number {
-        return ResizeManager._Width;
-    }
-    public static get Height(): number {
-        return ResizeManager._Height;
-    }
-    public static get PixelRatio(): number {
-        return ResizeManager._PixelRatio;
-    }
-    //
-    //#endregion
-}

package/template-vanilla/src/experiences/managers/TickerManager.ts

@@ -1,86 +0,0 @@
-export type Tickable = (dt: number) => void;
-
-export default class TickerManager {
-    private static _IsRunning = false;
-    private static readonly _Tickables = new Set<Tickable>();
-    private static _StartTime: number = performance.now();
-    private static _CurrentTime: number = TickerManager._StartTime;
-    private static _ElapsedTime: number;
-    private static _DeltaTime: number;
-
-    //#region Constants
-    //
-    private static readonly _TIME_SCALE: number = 0.001;
-    private static readonly _MAX_DELTA: number = 0.1;
-    //
-    //#endregion
-
-    public static Init(): void {
-        TickerManager.Start();
-        TickerManager._ElapsedTime = 0;
-        TickerManager._DeltaTime = 0.016;
-        TickerManager._Update();
-    }
-
-    public static Start(): void {
-        TickerManager.Stop();
-        TickerManager._IsRunning = true;
-        TickerManager._StartTime = performance.now();
-        TickerManager._CurrentTime = TickerManager._StartTime;
-    }
-
-    public static Stop(): void {
-        TickerManager._IsRunning = false;
-    }
-
-    public static Play(): void {
-        TickerManager.Pause();
-        TickerManager._IsRunning = true;
-        TickerManager._CurrentTime = performance.now();
-    }
-
-    public static Pause(): void {
-        TickerManager._IsRunning = false;
-    }
-
-    public static Add(tickable: Tickable): void {
-        TickerManager._Tickables.add(tickable);
-    }
-
-    public static Remove(tickable: Tickable): void {
-        TickerManager._Tickables.delete(tickable);
-    }
-
-    private static readonly _Update = (): void => {
-        if (TickerManager._IsRunning) {
-            const now = performance.now();
-            TickerManager._DeltaTime = Math.min(
-                (now - TickerManager._CurrentTime) * TickerManager._TIME_SCALE,
-                TickerManager._MAX_DELTA
-            );
-            TickerManager._ElapsedTime += TickerManager._DeltaTime;
-            TickerManager._CurrentTime = now;
-
-            for (const tickable of TickerManager._Tickables) tickable(TickerManager._DeltaTime);
-        }
-
-        requestAnimationFrame(TickerManager._Update);
-    };
-
-    //#region Getters
-    //
-    public static get StartTime(): number {
-        return this._StartTime;
-    }
-    public static get CurrentTime(): number {
-        return this._CurrentTime;
-    }
-    public static get ElapsedTime(): number {
-        return this._ElapsedTime;
-    }
-    public static get DeltaTime(): number {
-        return this._DeltaTime;
-    }
-    //
-    //#endregion
-}

package/template-vanilla/src/experiences/proxies/ViewProxy.ts

@@ -1,45 +0,0 @@
-import type { ViewId } from '../constants/experiences/ViewId';
-import { ViewType } from '../constants/experiences/ViewType';
-import type ViewBase from '../views/bases/ViewBase';
-
-type ViewConstructor<T extends ViewBase> = new (id: ViewId) => T;
-
-export default class ViewProxy {
-    private static _Views = new Map<ViewId, ViewBase>();
-
-    public static Init(): void {
-        //
-    }
-
-    public static Add(viewId: ViewId, ViewClass: ViewConstructor<ViewBase>): void {
-        if (ViewProxy._Views.has(viewId)) {
-            throw new Error(`ViewProxy: View with id "${viewId}" already exists.`);
-        }
-
-        ViewProxy._Views.set(viewId, new ViewClass(viewId));
-    }
-
-    public static GetById<T extends ViewBase = ViewBase>(viewId: ViewId): T {
-        const view = ViewProxy._Views.get(viewId);
-        if (!view) throw new Error(`ViewProxy: View with id "${viewId}" not found.`);
-        return view as T;
-    }
-
-    public static Has(viewId: ViewId): boolean {
-        return ViewProxy._Views.has(viewId);
-    }
-
-    public static GetAll<T extends ViewBase>(type?: ViewType): T[] {
-        const views: T[] = [];
-
-        ViewProxy._Views.forEach((view) => {
-            if (type && type === view.type) {
-                views.push(view as T);
-            } else {
-                views.push(view as T);
-            }
-        });
-
-        return views;
-    }
-}

package/template-vanilla/src/experiences/views/bases/ViewBase.ts

@@ -1,36 +0,0 @@
-import type { ViewId } from '../../constants/experiences/ViewId';
-import type { ViewType } from '../../constants/experiences/ViewType';
-
-export default class ViewBase {
-    private readonly _id: ViewId;
-    private readonly _type: ViewType;
-    protected _isVisible: boolean;
-
-    constructor(id: ViewId, type: ViewType) {
-        this._id = id;
-        this._type = type;
-        this._isVisible = false;
-    }
-
-    protected _show(): void {
-        this._isVisible = true;
-    }
-
-    protected _hide(): void {
-        this._isVisible = false;
-    }
-
-    //#region Getters
-    //
-    public get id(): ViewId {
-        return this._id;
-    }
-    public get type(): ViewType {
-        return this._type;
-    }
-    public get isVisible(): boolean {
-        return this._isVisible;
-    }
-    //
-    //#endregion
-}

package/template-vanilla/src/experiences/views/htmls/loaders/components/HTMLTemplateLoader.ts

@@ -1,57 +0,0 @@
-import LoaderManager from '../../../../managers/LoaderManager';
-
-export default class HTMLTemplateLoader {
-    declare private _htmlElement: HTMLDivElement;
-    declare private _loadingBar: HTMLDivElement;
-    declare private _loadingProgress: HTMLDivElement;
-    declare private _loadingNumber: HTMLSpanElement;
-
-    constructor() {
-        this._generateElement();
-
-        LoaderManager.OnProgress.add(this._onProgress);
-    }
-
-    private _generateElement(): void {
-        const wrapper = document.createElement('div');
-        wrapper.innerHTML = `
-            <div id="loading-screen" class="loading-screen">
-                <div class="loading-progress">
-                    <span class="loading-number">0</span><span>%</span>
-                </div>
-                <div class="loading-bar"></div>
-            </div>
-        `.trim();
-
-        this._htmlElement = wrapper.querySelector('#loading-screen')!;
-        this._loadingProgress = this._htmlElement.querySelector('.loading-progress')!;
-        this._loadingNumber = this._loadingProgress.querySelector('.loading-number')!;
-        this._loadingBar = this._htmlElement.querySelector('.loading-bar')!;
-    }
-
-    private readonly _onProgress = (): void => {
-        const progress = (LoaderManager.LoadedSize / LoaderManager.TotalSize) * 100;
-        this._loadingBar.style.transform = `translateY(-50%) scaleX(${progress / 100})`;
-        this._loadingNumber.textContent = Math.round(progress).toString();
-    };
-
-    public show(): void {
-        this._loadingNumber.textContent = '0';
-        this._loadingBar.style.transform = '';
-        this._loadingBar.classList.remove('ended');
-    }
-
-    public hide(): void {
-        this._loadingNumber.textContent = '100';
-        this._loadingBar.style.transform = '';
-        this._loadingBar.classList.add('ended');
-    }
-
-    //#region
-    //
-    public get htmlElement(): HTMLDivElement {
-        return this._htmlElement;
-    }
-    //
-    //#endregion
-}