Implement the initial vector geometry runtime aligned to the vector asset contract, with clean parsing, transform, bounds, and render-prep support for vector-native sample games.

Author: ToolboxAid

docs/dev/CODEX_COMMANDS.md

@@ -2,121 +2,87 @@ MODEL: GPT-5.4
 REASONING: high
 
 TASK:
-Create BUILD_PR_TOOLS_AND_VECTOR_CONTRACT_COMBINED in the HTML-JavaScript-Gaming repo.
+Create BUILD_PR_VECTOR_GEOMETRY_RUNTIME in the HTML-JavaScript-Gaming repo.
 
 GOAL:
-In one pass:
-1. Consolidate duplicated/renamed tool folders under tools/
-2. Repair all affected references and loading paths
-3. Validate tool/sample/asset loading
-4. Produce the vector asset contract planning docs
+Implement the first production-ready vector geometry runtime that follows docs/specs/vector_asset_contract.md and is suitable for vector-native sample games.
 
 IMPORTANT SCOPE:
-- Ignore old SpriteEditor as legacy/out-of-scope
-- Do not spend effort preserving old SpriteEditor
-- Only touch old SpriteEditor if an active reference must be removed or redirected
-- Do not introduce unrelated feature work
-- Do not perform broad refactors outside tool-folder consolidation, path repair, validation, and vector contract planning
+- Build only the geometry/runtime layer needed to support vector-native rendering and geometry operations
+- Do not introduce unrelated gameplay work
+- Do not do broad engine refactors
+- Do not revive or depend on old SpriteEditor
+- Keep public boundaries clean and surgical
+- Respect docs-first repo workflow
+- Use approved/public selectors and contracts only
 
 REPO TARGET:
 C:\Users\DavidQ\Documents\GitHub\HTML-JavaScript-Gaming
 
-PHASE 1 — TOOLS FOLDER CONSOLIDATION
-- Inspect all folders directly under tools/
-- Identify duplicate/rename-drift tool folders
-- Select one canonical folder per active tool using the newer approved naming
-- Consolidate files into canonical folders
-- Merge subfolders too, including:
-  - html
-  - js
-  - css
-  - samples
-  - assets
-  - docs
-  - config/json
-  - shared helpers
-- Prefer git-aware moves where practical
-- When duplicate files exist in both locations:
-  - keep the better/current version
-  - manually merge if both contain meaningful changes
-  - do not blindly overwrite
+PRIMARY OBJECTIVE:
+Create a geometry runtime that can support vector asset consumption and runtime operations for sample games and future vector-native tooling.
 
-PHASE 2 — PATH / REFERENCE REPAIR
-Update all references across the repo to canonical tool paths, including:
-- imports
-- fetch/load paths
-- sample JSON paths
-- asset references
-- README references
-- launcher/index links
-- internal tool-to-tool references
+REQUIRED CAPABILITIES:
+1. Vector asset ingestion from the agreed vector asset contract
+2. Shape normalization / parsing
+3. Transform support:
+   - translate
+   - rotate
+   - scale
+4. Geometry helpers:
+   - bounds / bounding box
+   - center/origin handling
+   - point transformation
+5. Runtime-ready renderable output for supported primitives
+6. Collision-ready geometry primitives where appropriate
+7. Clear separation between:
+   - asset contract parsing
+   - geometry math
+   - render preparation
+   - runtime helpers
 
-Pay special attention to:
-- Tile Map Editor
-- Parallax Editor
-- SVG Editor
-- vector/json loaders
-- sample asset paths
-- case consistency in folder names
+NON-GOALS:
+- no broad gameplay systems
+- no AI systems
+- no collaboration/multiplayer systems
+- no large engine rewrite
+- no unrelated tool redesign
+- no legacy SpriteEditor preservation
 
-PHASE 3 — VALIDATION
-Validate all of the following:
-- launcher/index links resolve
-- Tile Map Editor loads
-- Parallax Editor loads
-- SVG Editor loads
-- sample loading works
-- assets render/load correctly
-- no required references remain to deprecated duplicate folders
-- no required runtime references remain to old SpriteEditor
-- no obvious broken paths remain after consolidation
-
-PHASE 4 — VECTOR ASSET CONTRACT PLAN
-Create planning/spec documentation for the vector asset contract.
-
-Required new spec target:
-docs/specs/vector_asset_contract.md
-
-The spec must define at minimum:
-- purpose and scope
-- canonical vector asset file role
-- coordinate system
-- origin conventions
-- transform expectations
-- stroke behavior
-- fill/color rules
-- palette strategy
-- shape primitives supported
-- layering expectations
-- naming conventions
-- runtime expectations
-- what the future geometry runtime must support
-- explicit non-goals / out-of-scope items
-
-REQUIRED DELIVERABLES:
-1. docs/pr/BUILD_PR_TOOLS_AND_VECTOR_CONTRACT_COMBINED.md
+REQUIRED FILES / DELIVERABLES:
+1. docs/pr/BUILD_PR_VECTOR_GEOMETRY_RUNTIME.md
 2. docs/dev/codex_commands.md
 3. docs/dev/commit_comment.txt
 4. docs/dev/reports/file_tree.txt
 5. docs/dev/reports/change_summary.txt
 6. docs/dev/reports/validation_checklist.txt
-7. docs/specs/vector_asset_contract.md
+
+IMPLEMENTATION EXPECTATIONS:
+- follow vector_asset_contract.md exactly
+- keep modules small and composable
+- prefer pure geometry utilities where possible
+- keep boundaries clean between parsing/math/runtime usage
+- expose only what sample games need now
+- avoid premature abstraction beyond this runtime slice
+
+VALIDATION MUST COVER:
+- vector assets parse successfully
+- transforms behave correctly
+- bounds compute correctly
+- supported primitives produce usable runtime output
+- sample-game integration path is clear
+- no broken imports/paths introduced
 
 BUILD PR DOC MUST INCLUDE:
-- canonical tool folders selected
-- duplicate folders discovered
-- files/folders moved or merged
-- references updated
-- obsolete folders removed
-- explicit note that old SpriteEditor was intentionally excluded except for active reference cleanup
-- summary of validation performed
-- summary of vector asset contract outputs
+- runtime scope
+- modules created or changed
+- public/runtime boundaries
+- validation performed
+- follow-up recommendations for next PR
 
-OUTPUT RULES:
-- Docs-first repo workflow
-- Keep changes surgical
-- No unrelated implementation work
-- Preserve exact repo-relative structure
-- Package result as a repo-structured ZIP at:
+ZIP REQUIREMENT:
+Package as a repo-structured ZIP at:
+<project folder>/tmp/BUILD_PR_VECTOR_GEOMETRY_RUNTIME.zip
 
-<project folder>/tmp/BUILD_PR_TOOLS_AND_VECTOR_CONTRACT_COMBINED.zip
+COMMIT COMMENT:
+Implement the initial vector geometry runtime aligned to the vector asset contract, with clean parsing, transform, bounds, and render-prep support for vector-native sample games.

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-build(tools): complete combined tools consolidation and vector contract docs
+Implement the initial vector geometry runtime aligned to the vector asset contract, with clean parsing, transform, bounds, and render-prep support for vector-native sample games.

docs/dev/reports/change_summary.txt

@@ -1,35 +1,35 @@
 Change Summary
 ==============
 
-Combined build outcome
-----------------------
-- finalized the canonical active tool folders under `tools/`
-- repaired active path and reference drift caused by prior rename/consolidation work
-- validated canonical loading surfaces and syntax
-- produced the vector asset contract spec in `docs/specs/vector_asset_contract.md`
+Build outcome
+-------------
+- implemented the initial shared vector geometry runtime aligned to `docs/specs/vector_asset_contract.md`
+- kept the runtime split across contract parsing, pure geometry math, render preparation, and the public runtime facade
+- integrated vector runtime preparation into packaged runtime loading without changing engine core APIs
 
-Canonical active tool folders
------------------------------
-- `tools/Sprite Editor V3/`
-- `tools/Tilemap Studio/`
-- `tools/Parallax Scene Studio/`
-- `tools/Vector Asset Studio/`
-- `tools/Vector Map Editor/`
+Runtime modules
+---------------
+- added `tools/shared/vector/vectorGeometryMath.js`
+- added `tools/shared/vector/vectorAssetContract.js`
+- added `tools/shared/vector/vectorRenderPrep.js`
+- added `tools/shared/vectorGeometryRuntime.js`
 
-Legacy and exclusions
----------------------
-- `tools/SpriteEditor_old_keep/` remains parked as legacy
-- old SpriteEditor stayed out of scope except for active reference cleanup
+Compatibility and integration updates
+-------------------------------------
+- updated `tools/shared/vector/vectorAssetBridge.js` to emit contract-aligned vector assets while preserving legacy bridge fields
+- updated `tools/shared/projectAssetValidation.js` to validate vectors against the contract through stable finding families
+- updated `tools/shared/runtimeAssetLoader.js` to promote packaged vector assets into `runtimeKind: "vector-geometry"` output
+- updated vector-native template, sample-game, and Asteroids demo runtime fixtures to provide real vector asset documents to the runtime
 
-Validation and repair highlights
---------------------------------
-- launcher/index links verified
-- canonical sample-manifest paths verified
-- canonical JS entry files validated with `node --check`
-- no required refs remain to deprecated duplicate folders in active surfaces
-- no required refs remain to legacy old SpriteEditor in active surfaces
+Validation highlights
+---------------------
+- syntax checks passed for all new and touched shared runtime files
+- targeted vector/runtime tests passed
+- Asteroids platform demo runtime integration passed after vector fixture repair
+- full node test runner passed with `110/110` explicit `run()` tests passing
 
-Vector contract output
-----------------------
-- created `docs/specs/vector_asset_contract.md`
-- defined purpose, scope, coordinate rules, origin/transform rules, stroke/fill/palette strategy, primitives, layering, naming, runtime expectations, future geometry runtime support, and non-goals
+Next-slice recommendations
+--------------------------
+- migrate checked-in vector asset files from legacy bridge shape to canonical contract documents
+- extend supported path commands only when a consumer requires them
+- add geometry-runtime-specific debug and profiler surfacing when dynamic vector transforms become active

docs/dev/reports/file_tree.txt

@@ -1,35 +1,25 @@
+docs/
+  pr/
+    BUILD_PR_VECTOR_GEOMETRY_RUNTIME.md
+  specs/
+    vector_asset_contract.md
 tools/
-  Parallax Scene Studio/
-    index.html
-    main.js
-    parallaxEditor.css
-    README.md
-    samples/
-  Sprite Editor V3/
-    index.html
-    main.js
-    spriteEditor.css
-    README.md
-    modules/
-  Tilemap Studio/
-    index.html
-    main.js
-    tileMapEditor.css
-    README.md
-    samples/
-  Vector Asset Studio/
-    index.html
-    main.js
-    svgBackgroundEditor.css
-    README.md
-    samples/
-  Vector Map Editor/
-    index.html
-    main.js
-    vectorMapEditor.css
-    README.md
-    how_to_use.html
-    assets/
-    editor/
   shared/
-  SpriteEditor_old_keep/
+    asteroidsPlatformDemo.js
+    projectAssetValidation.js
+    runtimeAssetLoader.js
+    vectorGeometryRuntime.js
+    vectorNativeTemplate.js
+    vectorTemplateSampleGame.js
+    vector/
+      vectorAssetBridge.js
+      vectorAssetContract.js
+      vectorGeometryMath.js
+      vectorRenderPrep.js
+tests/
+  run-tests.mjs
+  tools/
+    VectorAssetSystem.test.mjs
+    VectorGeometryRuntime.test.mjs
+    VectorNativeTemplate.test.mjs
+    VectorTemplateSampleGame.test.mjs