@benjos/create-boilerplate 1.3.5 → 1.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@benjos/create-boilerplate",
-    "version": "1.3.5",
+    "version": "1.4.1",
     "description": "CLI to scaffold Three.js projects with framework support",
     "type": "module",
     "bin": {

package/template-react/package-lock.json

@@ -1,12 +1,12 @@
 {
     "name": "template-react",
-    "version": "1.3.5",
+    "version": "1.4.1",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "template-react",
-            "version": "1.3.5",
+            "version": "1.4.1",
             "dependencies": {
                 "@dimforge/rapier3d": "^0.19.3",
                 "gsap": "^3.14.2",

package/template-react/package.json

@@ -1,7 +1,7 @@
 {
     "name": "template-react",
     "private": true,
-    "version": "1.3.5",
+    "version": "1.4.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

package/template-react/src/App.css

@@ -1,42 +1,42 @@
 #root {
-  max-width: 1280px;
-  margin: 0 auto;
-  padding: 2rem;
-  text-align: center;
+    max-width: 1280px;
+    margin: 0 auto;
+    padding: 2rem;
+    text-align: center;
 }
 
 .logo {
-  height: 6em;
-  padding: 1.5em;
-  will-change: filter;
-  transition: filter 300ms;
+    height: 6em;
+    padding: 1.5em;
+    will-change: filter;
+    transition: filter 300ms;
 }
 .logo:hover {
-  filter: drop-shadow(0 0 2em #646cffaa);
+    filter: drop-shadow(0 0 2em #646cffaa);
 }
 .logo.react:hover {
-  filter: drop-shadow(0 0 2em #61dafbaa);
+    filter: drop-shadow(0 0 2em #61dafbaa);
 }
 
 @keyframes logo-spin {
-  from {
-    transform: rotate(0deg);
-  }
-  to {
-    transform: rotate(360deg);
-  }
+    from {
+        transform: rotate(0deg);
+    }
+    to {
+        transform: rotate(360deg);
+    }
 }
 
 @media (prefers-reduced-motion: no-preference) {
-  a:nth-of-type(2) .logo {
-    animation: logo-spin infinite 20s linear;
-  }
+    a:nth-of-type(2) .logo {
+        animation: logo-spin infinite 20s linear;
+    }
 }
 
 .card {
-  padding: 2em;
+    padding: 2em;
 }
 
 .read-the-docs {
-  color: #888;
+    color: #888;
 }

package/template-react/src/App.tsx

@@ -1,14 +1,10 @@
-import { useState } from 'react'
-import './App.css'
+import { useState } from 'react';
+import './App.css';
 
 function App() {
-  const [count, setCount] = useState(0)
+    const [count, setCount] = useState(0);
 
-  return (
-    <>
-      Hello boilerplate react!
-    </>
-  )
+    return <>Hello boilerplate react!</>;
 }
 
-export default App
+export default App;

package/template-react/src/index.css

@@ -1,68 +1,68 @@
 :root {
-  font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
-  line-height: 1.5;
-  font-weight: 400;
+    font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
+    line-height: 1.5;
+    font-weight: 400;
 
-  color-scheme: light dark;
-  color: rgba(255, 255, 255, 0.87);
-  background-color: #242424;
+    color-scheme: light dark;
+    color: rgba(255, 255, 255, 0.87);
+    background-color: #242424;
 
-  font-synthesis: none;
-  text-rendering: optimizeLegibility;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
+    font-synthesis: none;
+    text-rendering: optimizeLegibility;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
 }
 
 a {
-  font-weight: 500;
-  color: #646cff;
-  text-decoration: inherit;
+    font-weight: 500;
+    color: #646cff;
+    text-decoration: inherit;
 }
 a:hover {
-  color: #535bf2;
+    color: #535bf2;
 }
 
 body {
-  margin: 0;
-  display: flex;
-  place-items: center;
-  min-width: 320px;
-  min-height: 100vh;
+    margin: 0;
+    display: flex;
+    place-items: center;
+    min-width: 320px;
+    min-height: 100vh;
 }
 
 h1 {
-  font-size: 3.2em;
-  line-height: 1.1;
+    font-size: 3.2em;
+    line-height: 1.1;
 }
 
 button {
-  border-radius: 8px;
-  border: 1px solid transparent;
-  padding: 0.6em 1.2em;
-  font-size: 1em;
-  font-weight: 500;
-  font-family: inherit;
-  background-color: #1a1a1a;
-  cursor: pointer;
-  transition: border-color 0.25s;
+    border-radius: 8px;
+    border: 1px solid transparent;
+    padding: 0.6em 1.2em;
+    font-size: 1em;
+    font-weight: 500;
+    font-family: inherit;
+    background-color: #1a1a1a;
+    cursor: pointer;
+    transition: border-color 0.25s;
 }
 button:hover {
-  border-color: #646cff;
+    border-color: #646cff;
 }
 button:focus,
 button:focus-visible {
-  outline: 4px auto -webkit-focus-ring-color;
+    outline: 4px auto -webkit-focus-ring-color;
 }
 
 @media (prefers-color-scheme: light) {
-  :root {
-    color: #213547;
-    background-color: #ffffff;
-  }
-  a:hover {
-    color: #747bff;
-  }
-  button {
-    background-color: #f9f9f9;
-  }
+    :root {
+        color: #213547;
+        background-color: #ffffff;
+    }
+    a:hover {
+        color: #747bff;
+    }
+    button {
+        background-color: #f9f9f9;
+    }
 }

package/template-react/src/main.tsx

@@ -1,10 +1,10 @@
-import { StrictMode } from 'react'
-import { createRoot } from 'react-dom/client'
-import './index.css'
-import App from './App.tsx'
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import './index.css';
+import App from './App.tsx';
 
 createRoot(document.getElementById('root')!).render(
-  <StrictMode>
-    <App />
-  </StrictMode>,
-)
+    <StrictMode>
+        <App />
+    </StrictMode>
+);

package/template-vanilla/index.html

@@ -1,17 +1,26 @@
 <!doctype html>
 <html lang="en">
-    <head>
-        <meta charset="UTF-8" />
-        <link rel="icon" type="image/svg+xml" href="./assets/icons/benjosLogoBlack.svg" />
-        <meta
-            name="viewport"
-            content="width=device-width, initial-scale=1.0, maximum-scale=1, minimum-scale=1, height=device-height, user-scalable=no, viewport-fit=cover, shrink-to-fit=no, minimal-ui"
-        />
-        <title>Boilerplate</title>
-    </head>
 
-    <body>
-        <div id="app"></div>
-        <script type="module" src="/src/main.ts"></script>
-    </body>
-</html>
+<head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="./assets/icons/benjosLogoBlack.svg" />
+    <meta name="viewport"
+        content="width=device-width, initial-scale=1.0, maximum-scale=1, minimum-scale=1, height=device-height, user-scalable=no, viewport-fit=cover, shrink-to-fit=no, minimal-ui" />
+    <title>Boilerplate</title>
+</head>
+
+<body>
+    <div id="app">
+        <div id="loader">
+            <div id="loading-screen" class="html-view loading-screen">
+                <div class="loading-progress">
+                    <span class="loading-number">0</span><span>%</span>
+                </div>
+                <div class="loading-bar"></div>
+            </div>
+        </div>
+    </div>
+    <script type="module" src="/src/main.ts"></script>
+</body>
+
+</html>

package/template-vanilla/package-lock.json

@@ -1,14 +1,14 @@
 {
     "name": "template-vanilla",
-    "version": "1.3.5",
+    "version": "1.4.1",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "template-vanilla",
-            "version": "1.3.5",
+            "version": "1.4.1",
             "dependencies": {
-                "@benjos/cookware": "^1.0.0",
+                "@benjos/cookware": "^1.0.4",
                 "@benjos/spices": "^1.0.1",
                 "@dimforge/rapier3d": "^0.19.3",
                 "gsap": "^3.14.2",
@@ -33,11 +33,12 @@
             }
         },
         "node_modules/@benjos/cookware": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/@benjos/cookware/-/cookware-1.0.0.tgz",
-            "integrity": "sha512-7l0EOcJ9WlaOxWaCkqHXB685u6zJyzjHOqOH87k6UIBpqi+LlJcg4d8qRaLFIJ9bxD74bxox52uAD7bvg2j1fA==",
+            "version": "1.0.4",
+            "resolved": "https://registry.npmjs.org/@benjos/cookware/-/cookware-1.0.4.tgz",
+            "integrity": "sha512-JlhZD6p2mgIbyq4S9syqrPAYkCDuRazA2EEd+WYVlfzo13/2M5awlPaD7kuT+yXdkpWniqQBQyVjD/uFZXxPkA==",
             "license": "ISC",
             "peerDependencies": {
+                "@benjos/spices": "^1.0.1",
                 "typescript": ">=5.0.0"
             }
         },
@@ -46,6 +47,7 @@
             "resolved": "https://registry.npmjs.org/@benjos/spices/-/spices-1.0.1.tgz",
             "integrity": "sha512-vAdmCm5xmoG9iaS4S4hHe7eyQTeKOkWIUa6RaXzk3SUW12G5hecgnPnSeBT1CWdR5hk2E0cgNAvvwG45ctpyrQ==",
             "license": "ISC",
+            "peer": true,
             "peerDependencies": {
                 "typescript": ">=5.0.0"
             }

package/template-vanilla/package.json

@@ -1,7 +1,7 @@
 {
     "name": "template-vanilla",
     "private": true,
-    "version": "1.3.5",
+    "version": "1.4.1",
     "type": "module",
     "scripts": {
         "dev": "vite",
@@ -28,7 +28,7 @@
         "vite-plugin-glsl": "^1.5.5"
     },
     "dependencies": {
-        "@benjos/cookware": "^1.0.0",
+        "@benjos/cookware": "^1.0.4",
         "@benjos/spices": "^1.0.1",
         "@dimforge/rapier3d": "^0.19.3",
         "gsap": "^3.14.2",

package/template-vanilla/src/experiences/Experience.ts

@@ -5,18 +5,18 @@ import MainHTML from './engines/htmls/MainHTML';
 import MainThree from './engines/threes/MainThree';
 import LoaderManager from './managers/LoaderManager';
 
-export default class Experience {
-    private static _isInitialized = false;
+class Experience {
+    private _isInitialized: boolean = false;
 
-    public static Init(): void {
-        if (Experience._isInitialized) {
-            return;
-        }
-        Experience._isInitialized = true;
+    public init(): void {
+        if (this._isInitialized) return;
+        this._isInitialized = true;
 
-        InitCommand.Init();
-        MainHTML.Init();
-        MainThree.Init();
-        void LoaderManager.LoadAllAssets();
+        InitCommand.init();
+        MainHTML.init();
+        MainThree.init();
+        LoaderManager.loadAllAssets();
     }
 }
+
+export default new Experience();

package/template-vanilla/src/experiences/cameras/threes/DebugThreeCameraController.ts

@@ -1,19 +1,16 @@
+import { DomKeyboardManager, DomPointerManager } from '@benjos/cookware';
 import { KeyboardConstant } from '@benjos/spices';
 import { Vector3 } from 'three';
 import { OrbitControls } from 'three/examples/jsm/Addons.js';
 import { CameraId } from '../../constants/experiences/CameraId';
-import { CameraType } from '../../constants/experiences/CameraType';
-import MainThree from '../../engines/threes/MainThree';
-import { KeyboardManager } from '../../managers/KeyboardManager';
-import MouseManager from '../../managers/MouseManager';
+import MainThreeApp from '../../engines/threes/app/MainThreeApp';
 import ThreeRaycasterManager from '../../managers/threes/ThreeRaycasterManager';
-import ThreeCameraControllerBase, { type IThreeCameraOptions } from './bases/ThreeCameraControllerBase';
+import { ThreeCameraOptions, ThreeCameraType } from '../../types/cameraTypes';
+import ThreeCameraControllerBase from './bases/ThreeCameraControllerBase';
 
 export default class DebugThreeCameraController extends ThreeCameraControllerBase<OrbitControls> {
-    //#region Constants
-    //
-    private static readonly _DEBUG_CAMERA_OPTIONS: IThreeCameraOptions = {
-        type: CameraType.PERSPECTIVE,
+    private static readonly _DEBUG_CAMERA_OPTIONS: ThreeCameraOptions = {
+        type: ThreeCameraType.PERSPECTIVE,
         fov: 75,
         aspect: window.innerWidth / window.innerHeight,
         near: 0.1,
@@ -22,11 +19,9 @@ export default class DebugThreeCameraController extends ThreeCameraControllerBas
     private static readonly _DEFAULT_CAMERA_POSITION: Vector3 = new Vector3(0, 1.5, 3);
     private static readonly _CONTROLS_DAMPING_FACTOR: number = 0.05;
     private static readonly _CONTROLS_CENTER_KEY: string = KeyboardConstant.CODES.CONTROL_LEFT;
-    //
-    //#endregion
 
-    constructor(cameraOption: IThreeCameraOptions = DebugThreeCameraController._DEBUG_CAMERA_OPTIONS) {
-        super(CameraId.THREE_DEBUG, cameraOption);
+    constructor() {
+        super(CameraId.THREE_DEBUG, DebugThreeCameraController._DEBUG_CAMERA_OPTIONS);
         this._camera.position.copy(DebugThreeCameraController._DEFAULT_CAMERA_POSITION);
         this._setControls();
         this.disable();
@@ -34,23 +29,23 @@ export default class DebugThreeCameraController extends ThreeCameraControllerBas
 
     public override enable(): void {
         super.enable();
-        MouseManager.OnMouseDown.add(this._onMouseDown);
+        DomPointerManager.onPointerDown.add(this._onMouseDown);
     }
 
     public override disable(): void {
         super.disable();
-        MouseManager.OnMouseDown.remove(this._onMouseDown);
+        DomPointerManager.onPointerDown.remove(this._onMouseDown);
     }
 
     private _setControls(): void {
-        this._controls = new OrbitControls(this._camera, MainThree.DomElementContainer);
+        this._controls = new OrbitControls(this._camera, MainThreeApp.domElementContainer);
         this._controls.enableDamping = true;
         this._controls.dampingFactor = DebugThreeCameraController._CONTROLS_DAMPING_FACTOR;
     }
 
     private readonly _onMouseDown = (): void => {
-        if (KeyboardManager.IsKeyDown(DebugThreeCameraController._CONTROLS_CENTER_KEY)) {
-            const intersect = ThreeRaycasterManager.CastFromCameraToMouse(MainThree.Scene.children);
+        if (DomKeyboardManager.isKeyDown(DebugThreeCameraController._CONTROLS_CENTER_KEY)) {
+            const intersect = ThreeRaycasterManager.castFromCameraToPointer(MainThreeApp.scene.children);
             if (intersect.length > 0) {
                 this._controls.target.copy(intersect[0].point);
                 this._controls.update();

package/template-vanilla/src/experiences/cameras/threes/LoaderThreeCameraController.ts

@@ -1,24 +1,21 @@
 import { Vector3 } from 'three';
 import { CameraId } from '../../constants/experiences/CameraId';
-import { CameraType } from '../../constants/experiences/CameraType';
-import ThreeCameraControllerBase, { type IThreeCameraOptions } from './bases/ThreeCameraControllerBase';
+import LoaderThreeApp from '../../engines/threes/app/LoaderThreeApp';
+import { ThreeCameraOptions, ThreeCameraType } from '../../types/cameraTypes';
+import ThreeCameraControllerBase from './bases/ThreeCameraControllerBase';
 
 export default class LoaderThreeCameraController extends ThreeCameraControllerBase {
-    //#region Constants
-    //
-    private static readonly _LOADER_CAMERA_OPTIONS: IThreeCameraOptions = {
-        type: CameraType.PERSPECTIVE,
+    private static readonly _LOADER_CAMERA_OPTIONS: ThreeCameraOptions = {
+        type: ThreeCameraType.PERSPECTIVE,
         fov: 75,
         aspect: window.innerWidth / window.innerHeight,
         near: 0.1,
         far: 1,
     };
     private static readonly _DEFAULT_CONTAINER_POSITION: Vector3 = new Vector3(0, 0, 0);
-    //
-    //#endregion
 
-    constructor(cameraOption: IThreeCameraOptions = LoaderThreeCameraController._LOADER_CAMERA_OPTIONS) {
-        super(CameraId.THREE_LOADER, cameraOption);
+    constructor() {
+        super(CameraId.THREE_LOADER, LoaderThreeCameraController._LOADER_CAMERA_OPTIONS, LoaderThreeApp.scene);
         this._container.position.copy(LoaderThreeCameraController._DEFAULT_CONTAINER_POSITION);
     }
 

package/template-vanilla/src/experiences/cameras/threes/MainThreeCameraController.ts

@@ -1,24 +1,20 @@
 import { Vector3 } from 'three';
 import { CameraId } from '../../constants/experiences/CameraId';
-import { CameraType } from '../../constants/experiences/CameraType';
-import ThreeCameraControllerBase, { type IThreeCameraOptions } from './bases/ThreeCameraControllerBase';
+import { ThreeCameraOptions, ThreeCameraType } from '../../types/cameraTypes';
+import ThreeCameraControllerBase from './bases/ThreeCameraControllerBase';
 
 export default class MainThreeCameraController extends ThreeCameraControllerBase {
-    //#region Constants
-    //
-    private static readonly _MAIN_CAMERA_OPTIONS: IThreeCameraOptions = {
-        type: CameraType.PERSPECTIVE,
+    private static readonly _MAIN_CAMERA_OPTIONS: ThreeCameraOptions = {
+        type: ThreeCameraType.PERSPECTIVE,
         fov: 75,
         aspect: window.innerWidth / window.innerHeight,
         near: 0.1,
         far: 1000,
     };
     private static readonly _DEFAULT_CONTAINER_POSITION: Vector3 = new Vector3(0, 1.5, 3);
-    //
-    //#endregion
 
-    constructor(cameraOption: IThreeCameraOptions = MainThreeCameraController._MAIN_CAMERA_OPTIONS) {
-        super(CameraId.THREE_MAIN, cameraOption);
+    constructor() {
+        super(CameraId.THREE_MAIN, MainThreeCameraController._MAIN_CAMERA_OPTIONS);
         this._container.position.copy(MainThreeCameraController._DEFAULT_CONTAINER_POSITION);
     }
 

package/template-vanilla/src/experiences/cameras/threes/bases/ThreeCameraControllerBase.ts

@@ -1,48 +1,27 @@
-import { Object3D, OrthographicCamera, PerspectiveCamera } from 'three';
+import { DomResizeManager } from '@benjos/cookware';
+import { Object3D, OrthographicCamera, PerspectiveCamera, Scene } from 'three';
 import type { CameraId } from '../../../constants/experiences/CameraId';
-import { CameraType } from '../../../constants/experiences/CameraType';
-import MainThree from '../../../engines/threes/MainThree';
-import { ResizeManager } from '../../../managers/ResizeManager';
+import MainThreeApp from '../../../engines/threes/app/MainThreeApp';
+import { ThreeCameraOptions, ThreeCameraType, ThreeControls } from '../../../types/cameraTypes';
 
-export interface IThreeCameraOptions {
-    type: CameraType;
-    fov?: number;
-    aspect?: number;
-    near?: number;
-    far?: number;
-    left?: number;
-    right?: number;
-    top?: number;
-    bottom?: number;
-}
-
-export interface IThreeControls {
-    update(delta?: number): void;
-    enabled: boolean;
-    dispose(): void;
-}
-
-export default abstract class ThreeCameraControllerBase<T extends IThreeControls = IThreeControls> extends Object3D {
-    protected readonly _cameraId: CameraId;
-    declare protected _camera: PerspectiveCamera | OrthographicCamera;
-    declare protected _container: Object3D;
-    declare protected _controls: T;
-
-    //#region Constants
-    //
-    private static readonly _DEFAULT_CAMERA_OPTIONS: IThreeCameraOptions = {
-        type: CameraType.PERSPECTIVE,
+export default abstract class ThreeCameraControllerBase<T extends ThreeControls = ThreeControls> extends Object3D {
+    private static readonly _DEFAULT_CAMERA_OPTIONS: ThreeCameraOptions = {
+        type: ThreeCameraType.PERSPECTIVE,
         fov: 75,
         aspect: window.innerWidth / window.innerHeight,
         near: 0.1,
         far: 1000,
     };
-    //
-    //#endregion
+
+    protected readonly _cameraId: CameraId;
+    declare protected _camera: PerspectiveCamera | OrthographicCamera;
+    declare protected _container: Object3D;
+    declare protected _controls: T;
 
     constructor(
         cameraId: CameraId,
-        cameraOptions: IThreeCameraOptions = ThreeCameraControllerBase._DEFAULT_CAMERA_OPTIONS
+        cameraOptions: ThreeCameraOptions = ThreeCameraControllerBase._DEFAULT_CAMERA_OPTIONS,
+        scene: Scene = MainThreeApp.scene
     ) {
         super();
         this._cameraId = cameraId;
@@ -50,7 +29,7 @@ export default abstract class ThreeCameraControllerBase<T extends IThreeControls
         this._generateContainer();
         this._generateCamera(cameraOptions);
 
-        MainThree.Scene.add(this);
+        scene.add(this);
     }
 
     private _generateContainer(): void {
@@ -58,8 +37,8 @@ export default abstract class ThreeCameraControllerBase<T extends IThreeControls
         this.add(this._container);
     }
 
-    private _generateCamera(cameraOptions: IThreeCameraOptions): void {
-        if (cameraOptions.type === CameraType.PERSPECTIVE) {
+    private _generateCamera(cameraOptions: ThreeCameraOptions): void {
+        if (cameraOptions.type === ThreeCameraType.PERSPECTIVE) {
             this._camera = new PerspectiveCamera(
                 cameraOptions.fov,
                 cameraOptions.aspect,
@@ -88,7 +67,9 @@ export default abstract class ThreeCameraControllerBase<T extends IThreeControls
     }
 
     public resize(): void {
-        if (this._camera instanceof PerspectiveCamera) this._camera.aspect = ResizeManager.Width / ResizeManager.Height;
+        if (this._camera instanceof PerspectiveCamera) {
+            this._camera.aspect = DomResizeManager.width / DomResizeManager.height;
+        }
         this._camera.updateProjectionMatrix();
     }