Audit template V2 and align Audio SFX Playground styling - PR_26144_003-audit-template-v2-and-align-audio-sfx-css

Author: ToolboxAid

docs/dev/reports/playwright_audio_sfx_template_css_alignment.md

@@ -0,0 +1,57 @@
+# Audio / SFX Template CSS Alignment Playwright Report
+
+PR: `PR_26144_003-audit-template-v2-and-align-audio-sfx-css`
+
+## Playwright Impact
+
+Playwright impacted: Yes.
+
+Behavior intended for Playwright validation:
+
+- Audio / SFX Playground V2 launches directly without console errors.
+- Audio / SFX Playground V2 renders using `tools/_templates-v2/styles/toolStarter.css`.
+- Workspace V2 still shows the Audio / SFX Playground V2 tile.
+- Workspace V2 tile launch still opens Audio / SFX Playground V2 in workspace launch mode.
+
+Expected pass behavior:
+
+- `npm run test:workspace-v2` passes.
+- The tool page has `body[data-tool-id="audio-sfx-playground-v2"]`.
+- The tool page loads the shared template stylesheet and does not load `audioSfxPlaygroundV2.css`.
+- Workspace launch shows the workspace NAV and no console errors.
+
+Expected fail behavior:
+
+- Missing tile, failed launch, console error, broken stylesheet load, or hidden/incorrect workspace NAV should fail the impacted Workspace V2 checks.
+
+## Local Result
+
+Blocked in this environment.
+
+- `npm run test:workspace-v2` failed because PowerShell blocked `npm.ps1` by execution policy.
+- `npm.cmd run test:workspace-v2` reached the package script but failed because `playwright` is not installed or available on PATH.
+- `npm.cmd ci` failed with `UNABLE_TO_VERIFY_LEAF_SIGNATURE` while fetching `ws-8.20.0.tgz` from npm, so the missing Playwright binary could not be installed locally.
+
+## Completed Static Validation
+
+- Changed HTML, CSS, JS, and JSON static validation passed:
+  - JS/MJS checked with `node --check`.
+  - JSON parsed.
+  - HTML checked for inline script blocks, style blocks, and inline event handlers.
+  - CSS checked for balanced braces.
+- `tools/_templates-v2/starter-project-template/config/starter.game.manifest.json` passed Workspace Manager V2 `validateGameManifest`.
+- `git diff --check -- tools/_templates-v2 tools/audio-sfx-playground-v2 docs/dev/reports` passed.
+
+## Manual Validation Steps
+
+1. Install dependencies in an environment with a trusted npm certificate chain.
+2. Run `npm run test:workspace-v2`.
+3. Open `/tools/audio-sfx-playground-v2/index.html`.
+4. Confirm the page renders with the Tool Template V2 visual pattern.
+5. Confirm browser devtools shows no console errors.
+6. Open `/tools/workspace-manager-v2/index.html?workspace=uat`.
+7. Seed the UAT manifest, launch the Audio / SFX Playground V2 tile, and confirm workspace mode opens with no console errors.
+
+## Full Samples Smoke Test
+
+Skipped. This change is limited to template/tool CSS alignment and does not broadly impact samples.

docs/dev/reports/template_v2_audit.md

@@ -0,0 +1,36 @@
+# Template V2 Audit
+
+PR: `PR_26144_003-audit-template-v2-and-align-audio-sfx-css`
+
+## Target Resolution
+
+The request named `tools/_template_v2`. The repo contains `tools/_templates-v2`, so this audit used `tools/_templates-v2` as the intended Tool Template V2 folder.
+
+## Findings Before
+
+- `tools/_templates-v2/starter-project-template/config/starter.project.json` used an old project/workspace-shaped payload instead of the current game manifest contract.
+- The old starter project JSON embedded Asteroids-specific sprite IDs and `games/Asteroids/game.manifest.json` references.
+- `tools/_templates-v2/vector-native-arcade/config/template.project.json` pointed at `games/Asteroids/main.js#bootAsteroids`.
+- `tools/_templates-v2/vector-native-arcade/runtime/bootstrap.runtime.json` pointed at `games/Asteroids/main.js` and `bootAsteroids`.
+- `tools/audio-sfx-playground-v2` still contained copied template support files that were not used by the SFX tool runtime.
+- `tools/audio-sfx-playground-v2/index.html` used a custom `audioSfxPlaygroundV2.css` stylesheet.
+
+## Changes Made
+
+- Replaced the old starter project JSON with `tools/_templates-v2/starter-project-template/config/starter.game.manifest.json`.
+- Removed Asteroids references from `tools/_templates-v2`.
+- Removed `tools/_templates-v2/vector-native-arcade/runtime/bootstrap.runtime.json` because it was game-specific and not usable as a neutral template runtime contract.
+- Updated template docs to describe the current minimal game manifest starter.
+- Added reusable range, toggle, meter, and preview tag styling to `tools/_templates-v2/styles/toolStarter.css`.
+- Updated Audio / SFX Playground V2 to load `../_templates-v2/styles/toolStarter.css`.
+- Removed the audio tool's custom CSS file and unused copied starter/template support files.
+
+## Findings After
+
+- `rg "Asteroids|asteroids|games/Asteroids|bootAsteroids" tools/_templates-v2 tools/audio-sfx-playground-v2` returned no matches.
+- `tools/_templates-v2/starter-project-template/config/starter.game.manifest.json` validates through Workspace Manager V2 `validateGameManifest`.
+- Audio / SFX Playground V2 now renders on the Tool Template V2 CSS class pattern while preserving Workspace V2 launch aliases used by existing Playwright coverage.
+
+## Full Samples Smoke Test
+
+Skipped. This change is limited to template/tool CSS alignment and does not broadly impact samples.

tools/_templates-v2/README.md

@@ -33,6 +33,7 @@ tools/_templates-v2/
     playwright/
       FirstClassToolStarter.spec.mjs
   starter-project-template/
+    config/starter.game.manifest.json
   vector-native-arcade/
 ```
 
@@ -52,7 +53,7 @@ tools/_templates-v2/
 
 ## Additional Template Folders
 
-- `starter-project-template/`: existing shared project manifest starter.
+- `starter-project-template/`: current minimal game manifest starter.
 - `vector-native-arcade/`: existing vector-native arcade project/game starter.
 
 These folders remain under `tools/_templates-v2/` as support/reference template assets. They are not the active First-Class Tool V2 starter shell.

tools/_templates-v2/starter-project-template/README.md

@@ -1,26 +1,22 @@
-# Starter Project Template
+# Starter Game Manifest Template
 
-This template is a single reusable project manifest for the shared tools project system.
+This template is a minimal reusable game manifest for Workspace Manager V2 and First-Class Tool V2 launch validation.
 
 ## Purpose
-- prove cross-tool open/save/reload compatibility
-- keep assets and palettes referenced by shared ids and paths
-- avoid introducing gameplay systems or sample cards
+- provide the current `html-js-gaming.game-manifest` structure
+- keep tool payloads under root `tools`
+- avoid gameplay-specific runtime or sample dependencies
 
 ## Open flow
-1. Open any active first-class tool.
-2. Use the shared shell `Open Project` action.
-3. Select `tools/_templates-v2/starter-project-template/config/starter.project.json`.
+1. Open Workspace Manager V2.
+2. Import or load `tools/_templates-v2/starter-project-template/config/starter.game.manifest.json`.
+3. Use the generated toolState context to validate starter tool wiring.
 
 ## Shared references used
-- vector: `tools/_templates-v2/vector-native-arcade/assets/vectors/template-player.vector.json`
-- tilemap: `tools/_templates-v2/vector-native-arcade/assets/tilemaps/template-arena.tilemap.json`
-- parallax: `tools/_templates-v2/vector-native-arcade/assets/parallax/template-backdrop.parallax.json`
-- sprite: `games/Asteroids/game.manifest.json#tools.sprite-editor.sprites.sprite.asteroids.demo.runtime`
-- palette: `tools/_templates-v2/vector-native-arcade/assets/palettes/vector-native-primary.palette.json`
+- manifest: `tools/_templates-v2/starter-project-template/config/starter.game.manifest.json`
+- palette source: `tools/_templates-v2`
 
 ## Notes
-- `Sprite Editor` remains first-class.
-- `SpriteEditor_old_keep` remains legacy and hidden.
-- `tools/index.html` remains tool-only and sample-free.
-
+- The template manifest intentionally has an empty Asset Manager V2 registry.
+- The template manifest contains no game-specific runtime references.
+- Sample launch validation remains out of scope until sample JSON alignment is complete.

tools/_templates-v2/starter-project-template/config/starter.game.manifest.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "tools/schemas/game.manifest.schema.json",
+  "schema": "html-js-gaming.game-manifest",
+  "version": 1,
+  "game": {
+    "id": "starter-template",
+    "name": "Starter Template",
+    "folder": "_starter-template"
+  },
+  "screen": {
+    "width": 1280,
+    "height": 720
+  },
+  "launch": {
+    "directPath": "/games/_starter-template/index.html",
+    "workspaceManagerPath": "/tools/workspace-manager-v2/index.html",
+    "workspaceManagerOptional": true
+  },
+  "tools": {
+    "asset-manager-v2": {
+      "$schema": "tools/schemas/tools/asset-manager-v2.schema.json",
+      "schema": "html-js-gaming.asset-manager-v2",
+      "version": 1,
+      "id": "starter-template.assets",
+      "name": "Starter Template Assets",
+      "source": "manifest",
+      "assets": {}
+    },
+    "palette-manager-v2": {
+      "$schema": "tools/schemas/tools/palette-manager-v2.schema.json",
+      "schema": "html-js-gaming.palette",
+      "version": 1,
+      "id": "starter-template.palette",
+      "name": "Starter Template Palette",
+      "source": "tools/_templates-v2",
+      "sourceId": "tools/_templates-v2/starter-project-template/config/starter.game.manifest.json",
+      "locked": true,
+      "swatches": [
+        {
+          "symbol": "B",
+          "hex": "#05070D",
+          "name": "Template Background",
+          "source": "Tool Template V2",
+          "tags": ["background"]
+        },
+        {
+          "symbol": "L",
+          "hex": "#6FD3FF",
+          "name": "Template Line",
+          "source": "Tool Template V2",
+          "tags": ["line", "accent"]
+        },
+        {
+          "symbol": "F",
+          "hex": "#E8F0FF",
+          "name": "Template Fill",
+          "source": "Tool Template V2",
+          "tags": ["fill", "ui"]
+        }
+      ]
+    },
+    "input-mapping-v2": {
+      "$schema": "tools/schemas/tools/input-mapping-v2.schema.json",
+      "toolId": "input-mapping-v2",
+      "version": 1,
+      "engineInputModel": "src/engine/input/InputMap",
+      "actions": [
+        {
+          "action": "confirm",
+          "label": "Confirm",
+          "inputs": [
+            {
+              "source": "keyboard",
+              "binding": "Enter",
+              "label": "Enter",
+              "engine": "Keyboard"
+            }
+          ]
+        }
+      ]
+    }
+  }
+}