Add Phase 20 numbered tool presets and sample-to-tool launch integration

<BUILD_PR_LEVEL_20_1_PHASE20_TOOL_PRESET_INTEGRATION>

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,43 +1,48 @@
+# Codex Commands
+
 MODEL: GPT-5.4
 REASONING: high
 
-COMMAND:
-Implement BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION as a one-pass, testable PR in the HTML-JavaScript-Gaming repo.
+## Command
+Implement `BUILD_PR_LEVEL_20_1_PHASE20_TOOL_PRESET_INTEGRATION` in `HTML-JavaScript-Gaming` as one small executable PR.
+
+Requirements:
+- use numbered sample folders only
+- use `samples/phase-20/2001` through `samples/phase-20/2051`
+- allocate exactly 3 Phase 20 samples per listed tool
+- do not create `samples/phase-20/<tool>` folders
+- when a Phase 20 sample is clicked, open the matching tool with that sample's preset data already applied
+- fullscreen is already complete; do not modify it
+- preserve repo conventions for sample folder contents and sample discovery
+- keep the change surgical; do not scan or rewrite unrelated areas
+- update roadmap status only if execution-backed and only with marker transitions
 
-Constraints:
-- fullscreen is complete; do not modify fullscreen behavior
-- docs-first repo workflow
-- one PR purpose only: sample packs + dropdown loading
-- active tools only:
-  - tools/Tile Map Editor
-  - tools/Parallax Editor
-  - tools/Vector Map Editor
-  - tools/Vector Asset Studio
-- 3 shipped samples per active tool
-- sample data must live in each tool's local samples structure
-- each tool must expose a Sample dropdown and be able to load all 3 samples
-- preserve manual editing flows
-- no repo-wide scanning unless required
-- no destructive cleanup
-- do not modify start_of_day folders
-- keep legacy preserved paths intact unless strictly required
-- update roadmap status only in docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md
-- no roadmap rewrites; status-only changes unless explicit additive line is required
+Listed tools:
+- 3D Asset Viewer
+- 3D Camera Path Editor
+- 3D Map Editor
+- Asset Browser
+- Asset Pipeline Tool
+- Palette Browser
+- Parallax Scene Studio
+- Performance Profiler
+- Physics Sandbox
+- Replay Visualizer
+- Sprite Editor
+- State Inspector
+- Tile Model Converter
+- Tilemap Studio
+- Vector Asset Studio
+- Vector Map Editor
+- Workspace Manager
 
-Required outputs:
-- implementation changes for dropdown sample loading in all 4 active tools
-- tool-local sample files/assets/manifests as needed
-- docs/pr/BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION.md aligned to delivered work
-- docs/dev/reports/change_summary.txt
-- docs/dev/reports/file_tree.txt
-- docs/dev/reports/validation_checklist.txt
-- docs/dev/commit_comment.txt
-- package final artifact to:
-  <project folder>/tmp/BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION.zip
+Implementation target:
+- executable sample lane under `samples/phase-20`
+- clickable sample-to-tool launch path
+- preset data applied at open
 
-Validation target:
-- open each tool
-- verify dropdown visible
-- verify exactly 3 samples per tool
-- verify each sample loads and visibly changes content
-- verify no fullscreen regression
+Validation:
+- prove all 51 Phase 20 samples are mapped
+- prove each sample opens the correct tool
+- prove preset data is visible/applied after open
+- place findings in `docs/dev/reports`

docs/dev/commit_comment.txt

@@ -1,7 +1,3 @@
-BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION
+Add Phase 20 numbered tool presets and sample-to-tool launch integration
 
-- Add Sample dropdown + explicit Load Sample action to Vector Map Editor.
-- Add Vector Map Editor local sample manifest with exactly 3 shipped sample JSON files.
-- Preserve manual editing flow and avoid fullscreen behavior changes.
-- Confirm all 4 active tool manifests expose exactly 3 local samples.
-- Update roadmap with status-only additive marker for tool sample packs + dropdown loading.
+<BUILD_PR_LEVEL_20_1_PHASE20_TOOL_PRESET_INTEGRATION>

docs/dev/reports/change_summary.md

@@ -0,0 +1,14 @@
+# Change Summary
+
+This PR creates the executable Phase 20 lane for numbered tool presets.
+
+Core shape:
+- numbered sample folders under `samples/phase-20`
+- 51 total sample entries
+- 3 entries per listed tool
+- click a sample -> open owning tool -> apply that sample's preset data
+
+This PR intentionally avoids:
+- fullscreen changes
+- per-tool sample directory trees
+- unrelated tool refactors

docs/dev/reports/phase20_tool_preset_integration_validation.txt

@@ -0,0 +1,32 @@
+BUILD_PR_LEVEL_20_1_PHASE20_TOOL_PRESET_INTEGRATION validation findings
+
+Phase 20 metadata entries: 51
+Missing IDs (2001-2051): 0
+Unexpected extra IDs: 0
+Launch mapping checks: 51/51 passed
+Preset payload checks: 51/51 passed
+Combined sample->tool mapping checks: 51/51 passed
+
+Per listed-tool sample allocations (must be 3 each):
+- 3D Asset Viewer (3d-asset-viewer): 3
+- 3D Camera Path Editor (3d-camera-path-editor): 3
+- 3D Map Editor (3d-map-editor): 3
+- Asset Browser (asset-browser): 3
+- Asset Pipeline Tool (asset-pipeline-tool): 3
+- Palette Browser (palette-browser): 3
+- Parallax Scene Studio (parallax-editor): 3
+- Performance Profiler (performance-profiler): 3
+- Physics Sandbox (physics-sandbox): 3
+- Replay Visualizer (replay-visualizer): 3
+- Sprite Editor (sprite-editor): 3
+- State Inspector (state-inspector): 3
+- Tile Model Converter (tile-model-converter): 3
+- Tilemap Studio (tile-map-editor): 3
+- Vector Asset Studio (vector-asset-studio): 3
+- Vector Map Editor (vector-map-editor): 3
+- Workspace Manager (workspace-manager): 3
+
+Preset visibility/apply evidence in runtime code:
+- tools/shared/platformShell.js decodes `samplePreset` query and calls workspaceController.applyExternalToolState(...) when toolId matches current tool.
+- tools/shared/projectSystem.js applyExternalToolState() stores incoming preset state and applies it through available adapters, with status emission.
+- tools/Workspace Manager/main.js decodes `samplePreset` and forwards state into hosted tool mount config.

docs/dev/reports/phase20_tool_preset_mapping.txt

@@ -0,0 +1,53 @@
+Phase 20 sample mapping (2001-2051)
+id | title | href
+2001 | 3D Asset Viewer Preset 1 | ./phase-20/2001/index.html
+2002 | 3D Asset Viewer Preset 2 | ./phase-20/2002/index.html
+2003 | 3D Asset Viewer Preset 3 | ./phase-20/2003/index.html
+2004 | 3D Camera Path Editor Preset 1 | ./phase-20/2004/index.html
+2005 | 3D Camera Path Editor Preset 2 | ./phase-20/2005/index.html
+2006 | 3D Camera Path Editor Preset 3 | ./phase-20/2006/index.html
+2007 | 3D Map Editor Preset 1 | ./phase-20/2007/index.html
+2008 | 3D Map Editor Preset 2 | ./phase-20/2008/index.html
+2009 | 3D Map Editor Preset 3 | ./phase-20/2009/index.html
+2010 | Asset Browser Preset 1 | ./phase-20/2010/index.html
+2011 | Asset Browser Preset 2 | ./phase-20/2011/index.html
+2012 | Asset Browser Preset 3 | ./phase-20/2012/index.html
+2013 | Asset Pipeline Tool Preset 1 | ./phase-20/2013/index.html
+2014 | Asset Pipeline Tool Preset 2 | ./phase-20/2014/index.html
+2015 | Asset Pipeline Tool Preset 3 | ./phase-20/2015/index.html
+2016 | Palette Browser Preset 1 | ./phase-20/2016/index.html
+2017 | Palette Browser Preset 2 | ./phase-20/2017/index.html
+2018 | Palette Browser Preset 3 | ./phase-20/2018/index.html
+2019 | Parallax Scene Studio Preset 1 | ./phase-20/2019/index.html
+2020 | Parallax Scene Studio Preset 2 | ./phase-20/2020/index.html
+2021 | Parallax Scene Studio Preset 3 | ./phase-20/2021/index.html
+2022 | Performance Profiler Preset 1 | ./phase-20/2022/index.html
+2023 | Performance Profiler Preset 2 | ./phase-20/2023/index.html
+2024 | Performance Profiler Preset 3 | ./phase-20/2024/index.html
+2025 | Physics Sandbox Preset 1 | ./phase-20/2025/index.html
+2026 | Physics Sandbox Preset 2 | ./phase-20/2026/index.html
+2027 | Physics Sandbox Preset 3 | ./phase-20/2027/index.html
+2028 | Replay Visualizer Preset 1 | ./phase-20/2028/index.html
+2029 | Replay Visualizer Preset 2 | ./phase-20/2029/index.html
+2030 | Replay Visualizer Preset 3 | ./phase-20/2030/index.html
+2031 | Sprite Editor Preset 1 | ./phase-20/2031/index.html
+2032 | Sprite Editor Preset 2 | ./phase-20/2032/index.html
+2033 | Sprite Editor Preset 3 | ./phase-20/2033/index.html
+2034 | State Inspector Preset 1 | ./phase-20/2034/index.html
+2035 | State Inspector Preset 2 | ./phase-20/2035/index.html
+2036 | State Inspector Preset 3 | ./phase-20/2036/index.html
+2037 | Tile Model Converter Preset 1 | ./phase-20/2037/index.html
+2038 | Tile Model Converter Preset 2 | ./phase-20/2038/index.html
+2039 | Tile Model Converter Preset 3 | ./phase-20/2039/index.html
+2040 | Tilemap Studio Preset 1 | ./phase-20/2040/index.html
+2041 | Tilemap Studio Preset 2 | ./phase-20/2041/index.html
+2042 | Tilemap Studio Preset 3 | ./phase-20/2042/index.html
+2043 | Vector Asset Studio Preset 1 | ./phase-20/2043/index.html
+2044 | Vector Asset Studio Preset 2 | ./phase-20/2044/index.html
+2045 | Vector Asset Studio Preset 3 | ./phase-20/2045/index.html
+2046 | Vector Map Editor Preset 1 | ./phase-20/2046/index.html
+2047 | Vector Map Editor Preset 2 | ./phase-20/2047/index.html
+2048 | Vector Map Editor Preset 3 | ./phase-20/2048/index.html
+2049 | Workspace Manager Preset 1 | ./phase-20/2049/index.html
+2050 | Workspace Manager Preset 2 | ./phase-20/2050/index.html
+2051 | Workspace Manager Preset 3 | ./phase-20/2051/index.html