@benjos/create-boilerplate 1.0.1 → 1.3.2

package/template-vanilla/package.json

@@ -1,7 +1,7 @@
 {
     "name": "boilerplate",
     "private": true,
-    "version": "1.0.22",
+    "version": "1.3.2",
     "type": "module",
     "scripts": {
         "dev": "vite",
@@ -35,4 +35,4 @@
         "lil-gui": "^0.21.0",
         "three": "^0.181.2"
     }
-}
+}

package/template-vanilla/readme.md

@@ -1,13 +1,31 @@
-# Introduction
+# 🎨 Three.js Boilerplate
 
-Welcome to this boilerplate for **Three.js projects**.  
-I’m building this boilerplate for myself, but I’m sharing it so others can use and improve it!  
-This boilerplate will evolve after each project I create with it. I’ll update the version number in the `package.json` file accordingly.
+Custom boilerplate for Three.js projects with CLI scaffolding.
 
-## Debug Mode
+## 🚀 Quick Start
 
-To activate **debug mode**, add `#debug` to your **URL**, like this: `http://localhost:5173/#debug`  
-Toggle Debug UI : `ShiftLeft + KeyH`  
-Switch to debug camera: `ShiftLeft + KeyC`  
-In debug camera `Ctrl + Click` on an object **to center the camera** on it.  
-Toggle wireframe : `ShiftLeft + KeyW`
+```bash
+npm i
+npm run dev
+```
+
+## ✨ Features
+
+- Three.js + Vite + TypeScript
+- GLSL shaders support
+- Debug mode with lil-gui
+- Manager-based architecture
+- ESLint + Prettier
+
+## 🐛 Debug Mode
+
+Add `#debug` to URL: `http://localhost:5173/#debug`
+
+- `Shift + H` → Toggle UI
+- `Shift + C` → Debug Camera
+- `Shift + W` → Wireframe
+- `Ctrl + Click` → Center on object
+
+## 📄 License
+
+MIT

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

@@ -6,7 +6,14 @@ import MainThree from './engines/threes/MainThree';
 import LoaderManager from './managers/LoaderManager';
 
 export default class Experience {
+    private static _isInitialized = false;
+
     public static Init(): void {
+        if (Experience._isInitialized) {
+            return;
+        }
+        Experience._isInitialized = true;
+
         InitCommand.Init();
         MainHTML.Init();
         MainThree.Init();

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

@@ -0,0 +1,6 @@
+export const ViewType = {
+    HTML: 'HTML',
+    THREE: 'THREE',
+} as const;
+
+export type ViewType = (typeof ViewType)[keyof typeof ViewType];

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

@@ -1,4 +1,5 @@
 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;
@@ -27,4 +28,18 @@ export default class ViewProxy {
     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,18 +1,23 @@
 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) {
+    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
@@ -20,6 +25,12 @@ export default class ViewBase {
     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/bases/HTMLViewBase.ts

@@ -1,5 +1,6 @@
 import { DomEvent } from '../../../constants/doms/DomEvent';
 import type { ViewId } from '../../../constants/experiences/ViewId';
+import { ViewType } from '../../../constants/experiences/ViewType';
 import DomUtils from '../../../utils/DomUtils';
 import ViewBase from '../../bases/ViewBase';
 
@@ -8,7 +9,7 @@ export default abstract class HTMLViewBase extends ViewBase {
     protected readonly _htmlContainer: HTMLDivElement;
 
     constructor(id: ViewId, parentElement: HTMLElement = DomUtils.GetApp()) {
-        super(id);
+        super(id, ViewType.HTML);
         this._parentElement = parentElement;
         this._htmlContainer = document.createElement('div');
         this._htmlContainer.classList.add('view-html-container');

package/template-vanilla/src/experiences/views/threes/bases/ThreeViewBase.ts

@@ -1,5 +1,6 @@
 import { Object3D, Scene } from 'three';
 import type { ViewId } from '../../../constants/experiences/ViewId';
+import { ViewType } from '../../../constants/experiences/ViewType';
 import MainThree from '../../../engines/threes/MainThree';
 import ViewBase from '../../bases/ViewBase';
 
@@ -8,7 +9,7 @@ export default abstract class ThreeViewBase extends ViewBase {
     protected _container: Object3D;
 
     constructor(id: ViewId, scene: Scene = MainThree.Scene) {
-        super(id);
+        super(id, ViewType.THREE);
 
         this._scene = scene;
         this._container = new Object3D();

package/template-vanilla/src/experiences/views/threes/loaders/LoaderThreeView.ts

@@ -10,6 +10,7 @@ export default class LoaderThreeView extends ThreeViewBase {
     constructor(id: ViewId) {
         super(id, MainThree.LoaderScene);
 
+        this._isVisible = true;
         this._generateLoader();
 
         LoaderManager.OnBeginLoad.add(this._onBeginLoad);

package/template-vanilla/tsconfig.json

@@ -1,24 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2022",
-        "useDefineForClassFields": true,
-        "module": "ESNext",
-        "lib": ["ES2022", "DOM", "DOM.Iterable"],
-        "types": ["vite/client", "vite-plugin-glsl/ext"],
-        "skipLibCheck": true,
-        /* Bundler mode */
-        "moduleResolution": "bundler",
-        "allowImportingTsExtensions": true,
-        "verbatimModuleSyntax": true,
-        "moduleDetection": "force",
-        "noEmit": true,
-        /* Linting */
-        "strict": true,
-        // "noUnusedLocals": true,
-        // "noUnusedParameters": true,
-        "erasableSyntaxOnly": true,
-        "noFallthroughCasesInSwitch": true,
-        "noUncheckedSideEffectImports": true
-    },
-    "include": ["src", "src/**/*.ts", "src/**/*.d.ts"]
-}