valence-cli 1.2.8 → 1.3.1

package/README.md

@@ -35,12 +35,16 @@ valence start
 ## 🛠 Commands
 
 ### `valence new <name>`
-Scaffolds a new project with:
+Scaffolds a new high-performance project. You will be prompted to select your engine:
+
+*   **3D (Babylon.js)**: Full 3D capabilities with Havok Physics, XR, and Inspector support.
+*   **2D (Phaser)**: Fast 2D game engine with configured scenes and arcade physics.
+
+**Both environments include:**
 -   **Angular**: Latest CLI, SCSS, Routing.
 -   **Electron**: TypeScript Main/Preload processes, securely configured.
--   **Babylon.js**: Core dependencies pre-installed.
--   **Forge**: configured for building `.exe` / `.zip` / installers.
--   **Pro Template**: Includes a rotating wireframe plane, FPS counter, and real-time Camera Rotation (XYZ) tracker with a premium glassmorphic UI.
+-   **Forge**: Configured for building `.exe` / `.zip` / installers.
+-   **Valence UI**: Premium glassmorphic HUD with FPS and status tracking.
 
 ### `valence start`
 Runs the application in **Development Mode**:
@@ -55,6 +59,9 @@ Compiles the application for **Production**:
 -   Optimizes assets.
 -   Enforces relative paths (`baseHref="./"`) for Electron compatibility.
 
+### `valence test`
+Runs the project's automated test suite (if configured).
+
 ### `valence package`
 Packages the application for distribution:
 -   Runs `valence build`.
@@ -63,60 +70,67 @@ Packages the application for distribution:
 
 ### `valence publish`
 Automates the release pipeline:
-1.  Bumps project version (patch).
-2.  Updates `README.md` version badges.
-3.  Builds & Packages.
-4.  Generates `RELEASES_README.md` entry.
-5.  Publishes via Electron Forge (e.g., to GitHub Releases).
+-   Bumps project version (patch).
+-   Updates `README.md` version badges.
+-   Builds & Packages.
+-   Generates `RELEASES_README.md` entry.
+-   Publishes via Electron Forge.
 
-### `valence generate scene <name>`
-*Alias: `valence g scene <name>`*
-Scaffolds a new **Babylon.js Scene component** in `src/app/scenes/<name>`:
-- Pre-wired `Engine` and `Scene` creation.
-- Includes Camera, Light, and Resize event handling.
-- Ready for 3D logic immediately.
+---
 
-### `valence generate bridge <name>`
+## 🎮 Gameplay Services
 
-*Alias: `valence g bridge <name>`*
+Valence can automatically inject core game systems into your project.
 
-Generates a type-safe IPC communication channel:
+### `valence add <feature>`
 
-- Main Process: Registers `ipcMain.handle` listener.
-- Preload: Exposes `contextBridge` API safe for Renderer.
-- Service: Creates an Angular service wrapper to call the API.
+#### Core Systems
+*   **`input`**: Unified Action Mapping (Keyboard/Gamepad) via Angular Signals.
+*   **`audio`**: Channel-based audio manager (Master/Music/SFX) using Howler.js.
+*   **`storage`**: Secure, atomic file I/O for save games (Write-Temp-Rename pattern) via Electron IPC.
+*   **`settings`**: Centralized configuration manager (Audio/Graphics) persisted to storage.
+*   **`state`**: Strict Game State Machine (Boot, Menu, Gameplay, Paused) via Signals.
 
-### `valence add <feature>`
+#### 3D Features (Babylon.js)
+*   **`physics`**: Installs Havok engine (WASM) & initializes physics.
+*   **`inspector`**: Installs & binds Babylon Inspector to `Ctrl+I`.
+*   **`gui`**: Installs `lil-gui` debug panel.
+*   **`materials`**: Installs `@babylonjs/materials`.
+*   **`skybox`**: Creates environmental skybox.
+*   **`xr`**: Initializes WebXR (VR/AR) experience.
 
-Injects advanced capabilities into an existing project.
+#### Universal Features
+*   **`tailwind`**: Configures TailwindCSS with Angular.
+*   **`multiplayer`**: Scaffolds Colyseus server & client.
+*   **`pipeline`**: Enables Asset Optimization Pipeline (sharp).
+*   **`native`**: Scaffolds Rust (Neon) native module.
 
-- `physics`: Installs Havok engine, configures WASM assets, and initializes physics in the global scene.
-- `inspector`: Installs `@babylonjs/inspector` and binds `Ctrl+I` to toggle the dedicated 3D debugger overlay.
-- `gui`: Installs `lil-gui` and creates a debug panel for tweaking parameters at runtime.
-- `materials`: Installs `@babylonjs/materials`, enabling Grid, Gradient, and other advanced materials.
-- `skybox`: Automatically creates a large skybox mesh to provide environmental context.
-- `xr`: Initializes WebXR default experience (Teleportation + Controller support) for VR/AR.
-- `tailwind`: Configures TailwindCSS with Angular (PostCSS, Config, Styles).
+---
 
-### `valence template <type>`
+## 🎲 Generators
 
-Swaps the default 3D scene logic for a genre-specific starter.
+### `valence generate scene <name>`
+*Alias: `valence g scene <name>`*
+Scaffolds a new Scene component:
+*   **3D**: Pre-wired Babylon.js `Scene` with Camera/Light/Resize handling.
+*   **2D**: Pre-wired Phaser `Scene` class with lifecycle methods.
 
-- `fps`: First Person Shooter setup (WASD + Mouse Look + Gravity + Collisions).
-- `orbit`: Product/Model Viewer setup (ArcRotateCamera + Studio Lighting).
-- `platformer`: Third-person follow camera with a capsule character controller.
-- `iso`: Isometric orthographic view (RTS/Strategy style) with tile grid,
-- `gallery`: First-person interactive walkthrough with raycast-based highlighting.
+### `valence generate bridge <name>`
+*Alias: `valence g bridge <name>`*
+Generates a type-safe IPC communication channel:
+*   **Main Process**: Registers `ipcMain.handle`.
+*   **Preload**: Exposes `contextBridge` API.
+*   **Service**: Creates Angular service wrapper.
 
 ### `valence codegen assets`
+Scans `src/assets` and generates typed constants in `core/asset-keys.ts` for IntelliSense.
 
-Scans your `src/assets` folder and generates a TypeScript file (`core/asset-keys.ts`) with typed constants for every file path.
+---
 
-- Usage: `scene.createTexture(AssetKeys.TEXTURES_GRASS_PNG)`
+## 🩺 Diagnostics
 
 ### `valence doctor`
+Diagnoses your development environment (Node, NPM, Git).
 
-Diagnoses your development environment:
-- Checks Node.js & NPM versions.
-- Verifies Git installation.
-- Checks for global Angular CLI (optional).
+### `valence verify`
+Performs deep health check of project structure and configuration.

package/README.original.md

@@ -35,12 +35,16 @@ valence start
 ## 🛠 Commands
 
 ### `valence new <name>`
-Scaffolds a new project with:
+Scaffolds a new high-performance project. You will be prompted to select your engine:
+
+*   **3D (Babylon.js)**: Full 3D capabilities with Havok Physics, XR, and Inspector support.
+*   **2D (Phaser)**: Fast 2D game engine with configured scenes and arcade physics.
+
+**Both environments include:**
 -   **Angular**: Latest CLI, SCSS, Routing.
 -   **Electron**: TypeScript Main/Preload processes, securely configured.
--   **Babylon.js**: Core dependencies pre-installed.
--   **Forge**: configured for building `.exe` / `.zip` / installers.
--   **Pro Template**: Includes a rotating wireframe plane, FPS counter, and real-time Camera Rotation (XYZ) tracker with a premium glassmorphic UI.
+-   **Forge**: Configured for building `.exe` / `.zip` / installers.
+-   **Valence UI**: Premium glassmorphic HUD with FPS and status tracking.
 
 ### `valence start`
 Runs the application in **Development Mode**:
@@ -55,6 +59,9 @@ Compiles the application for **Production**:
 -   Optimizes assets.
 -   Enforces relative paths (`baseHref="./"`) for Electron compatibility.
 
+### `valence test`
+Runs the project's automated test suite (if configured).
+
 ### `valence package`
 Packages the application for distribution:
 -   Runs `valence build`.
@@ -63,60 +70,67 @@ Packages the application for distribution:
 
 ### `valence publish`
 Automates the release pipeline:
-1.  Bumps project version (patch).
-2.  Updates `README.md` version badges.
-3.  Builds & Packages.
-4.  Generates `RELEASES_README.md` entry.
-5.  Publishes via Electron Forge (e.g., to GitHub Releases).
+-   Bumps project version (patch).
+-   Updates `README.md` version badges.
+-   Builds & Packages.
+-   Generates `RELEASES_README.md` entry.
+-   Publishes via Electron Forge.
 
-### `valence generate scene <name>`
-*Alias: `valence g scene <name>`*
-Scaffolds a new **Babylon.js Scene component** in `src/app/scenes/<name>`:
-- Pre-wired `Engine` and `Scene` creation.
-- Includes Camera, Light, and Resize event handling.
-- Ready for 3D logic immediately.
+---
 
-### `valence generate bridge <name>`
+## 🎮 Gameplay Services
 
-*Alias: `valence g bridge <name>`*
+Valence can automatically inject core game systems into your project.
 
-Generates a type-safe IPC communication channel:
+### `valence add <feature>`
 
-- Main Process: Registers `ipcMain.handle` listener.
-- Preload: Exposes `contextBridge` API safe for Renderer.
-- Service: Creates an Angular service wrapper to call the API.
+#### Core Systems
+*   **`input`**: Unified Action Mapping (Keyboard/Gamepad) via Angular Signals.
+*   **`audio`**: Channel-based audio manager (Master/Music/SFX) using Howler.js.
+*   **`storage`**: Secure, atomic file I/O for save games (Write-Temp-Rename pattern) via Electron IPC.
+*   **`settings`**: Centralized configuration manager (Audio/Graphics) persisted to storage.
+*   **`state`**: Strict Game State Machine (Boot, Menu, Gameplay, Paused) via Signals.
 
-### `valence add <feature>`
+#### 3D Features (Babylon.js)
+*   **`physics`**: Installs Havok engine (WASM) & initializes physics.
+*   **`inspector`**: Installs & binds Babylon Inspector to `Ctrl+I`.
+*   **`gui`**: Installs `lil-gui` debug panel.
+*   **`materials`**: Installs `@babylonjs/materials`.
+*   **`skybox`**: Creates environmental skybox.
+*   **`xr`**: Initializes WebXR (VR/AR) experience.
 
-Injects advanced capabilities into an existing project.
+#### Universal Features
+*   **`tailwind`**: Configures TailwindCSS with Angular.
+*   **`multiplayer`**: Scaffolds Colyseus server & client.
+*   **`pipeline`**: Enables Asset Optimization Pipeline (sharp).
+*   **`native`**: Scaffolds Rust (Neon) native module.
 
-- `physics`: Installs Havok engine, configures WASM assets, and initializes physics in the global scene.
-- `inspector`: Installs `@babylonjs/inspector` and binds `Ctrl+I` to toggle the dedicated 3D debugger overlay.
-- `gui`: Installs `lil-gui` and creates a debug panel for tweaking parameters at runtime.
-- `materials`: Installs `@babylonjs/materials`, enabling Grid, Gradient, and other advanced materials.
-- `skybox`: Automatically creates a large skybox mesh to provide environmental context.
-- `xr`: Initializes WebXR default experience (Teleportation + Controller support) for VR/AR.
-- `tailwind`: Configures TailwindCSS with Angular (PostCSS, Config, Styles).
+---
 
-### `valence template <type>`
+## 🎲 Generators
 
-Swaps the default 3D scene logic for a genre-specific starter.
+### `valence generate scene <name>`
+*Alias: `valence g scene <name>`*
+Scaffolds a new Scene component:
+*   **3D**: Pre-wired Babylon.js `Scene` with Camera/Light/Resize handling.
+*   **2D**: Pre-wired Phaser `Scene` class with lifecycle methods.
 
-- `fps`: First Person Shooter setup (WASD + Mouse Look + Gravity + Collisions).
-- `orbit`: Product/Model Viewer setup (ArcRotateCamera + Studio Lighting).
-- `platformer`: Third-person follow camera with a capsule character controller.
-- `iso`: Isometric orthographic view (RTS/Strategy style) with tile grid,
-- `gallery`: First-person interactive walkthrough with raycast-based highlighting.
+### `valence generate bridge <name>`
+*Alias: `valence g bridge <name>`*
+Generates a type-safe IPC communication channel:
+*   **Main Process**: Registers `ipcMain.handle`.
+*   **Preload**: Exposes `contextBridge` API.
+*   **Service**: Creates Angular service wrapper.
 
 ### `valence codegen assets`
+Scans `src/assets` and generates typed constants in `core/asset-keys.ts` for IntelliSense.
 
-Scans your `src/assets` folder and generates a TypeScript file (`core/asset-keys.ts`) with typed constants for every file path.
+---
 
-- Usage: `scene.createTexture(AssetKeys.TEXTURES_GRASS_PNG)`
+## 🩺 Diagnostics
 
 ### `valence doctor`
+Diagnoses your development environment (Node, NPM, Git).
 
-Diagnoses your development environment:
-- Checks Node.js & NPM versions.
-- Verifies Git installation.
-- Checks for global Angular CLI (optional).
+### `valence verify`
+Performs deep health check of project structure and configuration.

package/dist/README.md

@@ -35,12 +35,16 @@ valence start
 ## 🛠 Commands
 
 ### `valence new <name>`
-Scaffolds a new project with:
+Scaffolds a new high-performance project. You will be prompted to select your engine:
+
+*   **3D (Babylon.js)**: Full 3D capabilities with Havok Physics, XR, and Inspector support.
+*   **2D (Phaser)**: Fast 2D game engine with configured scenes and arcade physics.
+
+**Both environments include:**
 -   **Angular**: Latest CLI, SCSS, Routing.
 -   **Electron**: TypeScript Main/Preload processes, securely configured.
--   **Babylon.js**: Core dependencies pre-installed.
--   **Forge**: configured for building `.exe` / `.zip` / installers.
--   **Pro Template**: Includes a rotating wireframe plane, FPS counter, and real-time Camera Rotation (XYZ) tracker with a premium glassmorphic UI.
+-   **Forge**: Configured for building `.exe` / `.zip` / installers.
+-   **Valence UI**: Premium glassmorphic HUD with FPS and status tracking.
 
 ### `valence start`
 Runs the application in **Development Mode**:
@@ -55,6 +59,9 @@ Compiles the application for **Production**:
 -   Optimizes assets.
 -   Enforces relative paths (`baseHref="./"`) for Electron compatibility.
 
+### `valence test`
+Runs the project's automated test suite (if configured).
+
 ### `valence package`
 Packages the application for distribution:
 -   Runs `valence build`.
@@ -63,60 +70,67 @@ Packages the application for distribution:
 
 ### `valence publish`
 Automates the release pipeline:
-1.  Bumps project version (patch).
-2.  Updates `README.md` version badges.
-3.  Builds & Packages.
-4.  Generates `RELEASES_README.md` entry.
-5.  Publishes via Electron Forge (e.g., to GitHub Releases).
+-   Bumps project version (patch).
+-   Updates `README.md` version badges.
+-   Builds & Packages.
+-   Generates `RELEASES_README.md` entry.
+-   Publishes via Electron Forge.
 
-### `valence generate scene <name>`
-*Alias: `valence g scene <name>`*
-Scaffolds a new **Babylon.js Scene component** in `src/app/scenes/<name>`:
-- Pre-wired `Engine` and `Scene` creation.
-- Includes Camera, Light, and Resize event handling.
-- Ready for 3D logic immediately.
+---
 
-### `valence generate bridge <name>`
+## 🎮 Gameplay Services
 
-*Alias: `valence g bridge <name>`*
+Valence can automatically inject core game systems into your project.
 
-Generates a type-safe IPC communication channel:
+### `valence add <feature>`
 
-- Main Process: Registers `ipcMain.handle` listener.
-- Preload: Exposes `contextBridge` API safe for Renderer.
-- Service: Creates an Angular service wrapper to call the API.
+#### Core Systems
+*   **`input`**: Unified Action Mapping (Keyboard/Gamepad) via Angular Signals.
+*   **`audio`**: Channel-based audio manager (Master/Music/SFX) using Howler.js.
+*   **`storage`**: Secure, atomic file I/O for save games (Write-Temp-Rename pattern) via Electron IPC.
+*   **`settings`**: Centralized configuration manager (Audio/Graphics) persisted to storage.
+*   **`state`**: Strict Game State Machine (Boot, Menu, Gameplay, Paused) via Signals.
 
-### `valence add <feature>`
+#### 3D Features (Babylon.js)
+*   **`physics`**: Installs Havok engine (WASM) & initializes physics.
+*   **`inspector`**: Installs & binds Babylon Inspector to `Ctrl+I`.
+*   **`gui`**: Installs `lil-gui` debug panel.
+*   **`materials`**: Installs `@babylonjs/materials`.
+*   **`skybox`**: Creates environmental skybox.
+*   **`xr`**: Initializes WebXR (VR/AR) experience.
 
-Injects advanced capabilities into an existing project.
+#### Universal Features
+*   **`tailwind`**: Configures TailwindCSS with Angular.
+*   **`multiplayer`**: Scaffolds Colyseus server & client.
+*   **`pipeline`**: Enables Asset Optimization Pipeline (sharp).
+*   **`native`**: Scaffolds Rust (Neon) native module.
 
-- `physics`: Installs Havok engine, configures WASM assets, and initializes physics in the global scene.
-- `inspector`: Installs `@babylonjs/inspector` and binds `Ctrl+I` to toggle the dedicated 3D debugger overlay.
-- `gui`: Installs `lil-gui` and creates a debug panel for tweaking parameters at runtime.
-- `materials`: Installs `@babylonjs/materials`, enabling Grid, Gradient, and other advanced materials.
-- `skybox`: Automatically creates a large skybox mesh to provide environmental context.
-- `xr`: Initializes WebXR default experience (Teleportation + Controller support) for VR/AR.
-- `tailwind`: Configures TailwindCSS with Angular (PostCSS, Config, Styles).
+---
 
-### `valence template <type>`
+## 🎲 Generators
 
-Swaps the default 3D scene logic for a genre-specific starter.
+### `valence generate scene <name>`
+*Alias: `valence g scene <name>`*
+Scaffolds a new Scene component:
+*   **3D**: Pre-wired Babylon.js `Scene` with Camera/Light/Resize handling.
+*   **2D**: Pre-wired Phaser `Scene` class with lifecycle methods.
 
-- `fps`: First Person Shooter setup (WASD + Mouse Look + Gravity + Collisions).
-- `orbit`: Product/Model Viewer setup (ArcRotateCamera + Studio Lighting).
-- `platformer`: Third-person follow camera with a capsule character controller.
-- `iso`: Isometric orthographic view (RTS/Strategy style) with tile grid,
-- `gallery`: First-person interactive walkthrough with raycast-based highlighting.
+### `valence generate bridge <name>`
+*Alias: `valence g bridge <name>`*
+Generates a type-safe IPC communication channel:
+*   **Main Process**: Registers `ipcMain.handle`.
+*   **Preload**: Exposes `contextBridge` API.
+*   **Service**: Creates Angular service wrapper.
 
 ### `valence codegen assets`
+Scans `src/assets` and generates typed constants in `core/asset-keys.ts` for IntelliSense.
 
-Scans your `src/assets` folder and generates a TypeScript file (`core/asset-keys.ts`) with typed constants for every file path.
+---
 
-- Usage: `scene.createTexture(AssetKeys.TEXTURES_GRASS_PNG)`
+## 🩺 Diagnostics
 
 ### `valence doctor`
+Diagnoses your development environment (Node, NPM, Git).
 
-Diagnoses your development environment:
-- Checks Node.js & NPM versions.
-- Verifies Git installation.
-- Checks for global Angular CLI (optional).
+### `valence verify`
+Performs deep health check of project structure and configuration.

package/dist/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,kBAsB/C,CAAA"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,kBAmD/C,CAAA"}