Add Phase 20 tool sample dropdown foundation across active tools

- ship 3 local samples per active tool
- add sample dropdown loading to Tile Map Editor, Parallax Editor, Vector Map Editor, and Vector Asset Studio
- preserve fullscreen behavior as complete
- keep roadmap updates status-only

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,33 +1,43 @@
-MODEL: GPT-5.3-codex
-REASONING: medium
+MODEL: GPT-5.4
+REASONING: high
 
 COMMAND:
-Create BUILD_PR_TOOL_HOST_SEAMLESS_IFRAME_PARITY.
+Implement BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION as a one-pass, testable PR in the HTML-JavaScript-Gaming repo.
 
-Refactor Tool Host so opening a tool in host feels visually equivalent to opening the tool directly, except for compact host controls/help inside the collapsible imported section.
+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
 
-Requirements:
-- iframe-hosted tool should use the available workspace as if opened directly
-- remove obvious host chrome/wrappers that make hosted mode visibly different
-- keep Tool Host HTML minimal
-- host-specific UI should live only in the collapsible imported section
-- collapsing that section should make the hosted tool appear nearly identical to direct launch
-- optional small fullscreen button is allowed, but do not depend on browser fullscreen as the main solution
-- preserve Open In Host behavior
-- preserve direct launch behavior
-- no inline styles
-- no embedded style blocks
-- no JS style-string injection
-- no color/token changes
-- no unnecessary per-tool hacks
-
-Outputs:
-- repo-structured ZIP at <project folder>/tmp/BUILD_PR_TOOL_HOST_SEAMLESS_IFRAME_PARITY.zip
-- docs/pr/BUILD_PR_TOOL_HOST_SEAMLESS_IFRAME_PARITY.md
-- docs/dev/codex_commands.md
-- docs/dev/commit_comment.txt
+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
 
-Roadmap:
-- update status only if execution-backed
-- status-only roadmap edits only
+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

docs/dev/commit_comment.txt

@@ -1,2 +1,7 @@
-Refactor Tool Host iframe presentation for near direct-launch parity by removing host chrome wrappers,
-keeping host controls inside the collapsible imported section, and eliminating JS/inline style injection.
+BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION
+
+- 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.

docs/dev/reports/change_summary.txt

@@ -1,15 +1,10 @@
-Scope summary
-- Single-purpose style PR
-- Header + Intro overlay only
-- Transparent overlay background
-- Foreground #ed9700
-- Collapsed header background #7a00df
-- Header border radius removed
-- page-shell excluded
+BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION
 
-Validation checklist
-- Visual overlay confirmed on targeted shared entry pages
-- Collapsed state color confirmed
-- No page-shell edits
-- No layout regressions
-- No console errors
+Summary:
+- Completed sample-pack + dropdown foundation for active tools with single PR purpose.
+- Added missing Vector Map Editor sample dropdown/load support.
+- Added 3 shipped local samples for Vector Map Editor.
+- Verified all 4 active tools now have exactly 3 local manifest samples.
+- Updated roadmap with execution-backed status line only.
+
+No fullscreen behavior changes were made.

docs/dev/reports/file_tree.txt

@@ -1,124 +1,12 @@
-Repo-Structured Delta File Tree (git status --porcelain)
-
- M README.md
- M docs/README.md
- M docs/dev/reports/BUILD_PR_LEVEL_18_19_TRACK_G_REPO_HYGIENE_COMPLETION_VALIDATION.md
- M docs/dev/reports/BUILD_PR_LEVEL_20_2_TRACK_C_DOCUMENTATION_COMPLETENESS_RESIDUE_CLOSEOUT_DUPLICATE_DOC_SURFACES.md
- M docs/dev/reports/BUILD_PR_LEVEL_20_2_TRACK_C_DOCUMENTATION_COMPLETENESS_RESIDUE_CLOSEOUT_ONBOARDING_FLOW_CHECK.md
- M docs/dev/reports/change_summary.txt
- M docs/dev/reports/validation_checklist.txt
- M docs/operations/dev/PROJECT_INSTRUCTIONS.md
- M docs/operations/dev/README.md
- M docs/operations/dev/ROADMAP_GUARDRAILS.md
- M docs/operations/dev/paths.md
- M docs/operations/dev/run_commands.ps1
- M docs/operations/dev/run_commands.txt
- M docs/pr/APPLY_PR_LEVEL_12_6_REMOTE_DEPLOYMENT_CANDIDATE.md
- M docs/pr/APPLY_PR_LEVEL_12_7_REAL_NETWORK_COMPLETION_GATE.md
- M docs/pr/APPLY_PR_LEVEL_12_8_NETWORK_DIRECTORY_NORMALIZATION.md
- M docs/pr/BUILD_PR_ENGINE_IMPORT_BASELINE_AND_CONTRACT.md
- M docs/pr/BUILD_PR_FINAL_NON_3D_ACTIVE_LANES_AND_STATUS_CLOSEOUT.md
- M docs/pr/BUILD_PR_LEVEL_02_2D_CAPABILITY_COMBINED_FOUNDATION.md
- M docs/pr/BUILD_PR_LEVEL_02_ENGINE_CORE_BASELINE_AND_BOUNDARY_PASS.md
- M docs/pr/BUILD_PR_LEVEL_03_SHARED_FOUNDATION_COMBINED_PASS.md
- M docs/pr/BUILD_PR_LEVEL_04_STATE_REPLAY_TIMELINE_COMBINED_PASS.md
- M docs/pr/BUILD_PR_LEVEL_06_SAMPLES_PROGRAM_COMBINED_PASS.md
- M docs/pr/BUILD_PR_LEVEL_07_NETWORK_DEBUG_AND_SERVER_DASHBOARD_COMBINED_CLOSEOUT.md
- M docs/pr/BUILD_PR_LEVEL_09_TOOLS_NORMALIZATION_AND_REQUIRED_TOOLS_COMBINED_PASS.md
- M docs/pr/BUILD_PR_LEVEL_10_23_RESTORE_MASTER_ROADMAP_STATUS_ONLY.md
- M docs/pr/BUILD_PR_LEVEL_10_26_LEVEL_10_CLOSEOUT_SAMPLE_TOOL_NORMALIZATION_AND_SHARED_STRATEGY.md
- M docs/pr/BUILD_PR_LEVEL_12_10_REAL_NETWORK_SAMPLE_AND_DASHBOARD.md
- M docs/pr/BUILD_PR_LEVEL_12_13_SAMPLE_1319_ROOT_TESTS_AND_PS_RUNBOOK.md
- M docs/pr/BUILD_PR_LEVEL_12_15_SAMPLE_1319_RUNTIME_RETURN_TO_SERVER.md
- M docs/pr/BUILD_PR_LEVEL_12_2D_CAPABILITY_TRACK_RESIDUE_ONLY.md
- M docs/pr/BUILD_PR_LEVEL_12_7_REAL_NETWORK_COMPLETION_GATE.md
- M docs/pr/BUILD_PR_LEVEL_12_8_NETWORK_DIRECTORY_NORMALIZATION.md
- M docs/pr/BUILD_PR_LEVEL_12_9_NETWORK_USAGE_SAMPLE_STANDARDIZATION.md
- M docs/pr/BUILD_PR_LEVEL_14_TESTS_VALIDATION_RESIDUE_ONLY.md
- M docs/pr/BUILD_PR_LEVEL_16_1_PHASE16_NETWORK_GATE_COMPLETION.md
- M docs/pr/BUILD_PR_LEVEL_17_17_MASTER_ROADMAP_STATUS_SYNC.md
- M docs/pr/BUILD_PR_LEVEL_17_21_TRACK_H_3D_DEBUG_SUPPORT_CLOSEOUT.md
- M docs/pr/BUILD_PR_LEVEL_17_22_PHASE16_3D_DEBUG_AND_ROADMAP_REBASELINE.md
- M docs/pr/BUILD_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE.md
- M docs/pr/BUILD_PR_LEVEL_18_10_REMOVE_SAMPLE_SPECIFIC_LOGIC_FROM_ENGINE_PATHS.md
- M docs/pr/BUILD_PR_LEVEL_18_13_TRACK_E_CSS_UI_NORMALIZATION_FOUNDATION.md
- M docs/pr/BUILD_PR_LEVEL_18_18_TRACK_F_DOCS_SYSTEM_COMPLETION.md
- M docs/pr/BUILD_PR_LEVEL_18_1_NEXT_PHASE_BOOTSTRAP.md
- M docs/pr/BUILD_PR_LEVEL_18_2_PHASE18_FOUNDATION.md
- M docs/pr/BUILD_PR_LEVEL_18_3_GAME_TO_SAMPLE_RECLASSIFICATION_RECOMMENDATIONS.md
- M docs/pr/BUILD_PR_LEVEL_18_4_GAME_TO_SAMPLE_RECLASSIFICATION_EXECUTION.md
- M docs/pr/BUILD_PR_LEVEL_19_1_NEXT_PHASE_BOOTSTRAP.md
- M docs/pr/BUILD_PR_LEVEL_19_4_PERFORMANCE_SCALING_ROADMAP_PROMOTION.md
- M docs/pr/BUILD_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE.md
- M docs/pr/BUILD_PR_ROADMAP_REPAIR_ADDITIVE_MOVE_ONLY.md
- M docs/pr/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_1.md
- M docs/pr/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_3_ARCHIVED_NOTES_POLICY.md
- M docs/pr/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST.md
- M docs/pr/BUILD_PR_TEMPLATES_POLICY_CLASSIFICATION.md
- M docs/pr/LEVEL_12_4_PLAYABLE_MULTIPLAYER_VALIDATION_PREP.md
- M docs/pr/PLAN_PR_LEVEL_12_10_REAL_NETWORK_SAMPLE_AND_DASHBOARD.md
- M docs/pr/PLAN_PR_LEVEL_12_4_PLAYABLE_MULTIPLAYER_VALIDATION.md
- M docs/pr/PLAN_PR_LEVEL_17_38_REAL_GAMEPLAY_SAMPLE.md
- M docs/pr/PLAN_PR_LEVEL_18_1_NEXT_PHASE_BOOTSTRAP.md
- M docs/pr/PLAN_PR_LEVEL_19_1_NEXT_PHASE_BOOTSTRAP.md
- M docs/pr/PLAN_PR_LEVEL_19_2_PHASE19_FOUNDATION.md
- M docs/reference/features/docs-system/README.md
- M docs/reference/features/docs-system/move-history-preserved.md
- M docs/reference/root/README.md
- M docs/reports/BUILD_PR_ENGINE_IMPORT_BASELINE_AND_CONTRACT_report.md
- M docs/reports/BUILD_PR_LEVEL_03_EXACT_CLUSTER_NUMBER_STRING_ID_CLOSEOUT_report.md
- M docs/reports/BUILD_PR_LEVEL_06_SAMPLE_PHASE_TRACKS_AND_2D_SAMPLE_BUILDS_INSPECT_FIRST_report.md
- M docs/reports/BUILD_PR_LEVEL_15_16_LEGACY_REDUCTION_AND_DOCUMENTATION_SYSTEM_COMBINED_CLOSEOUT_report.md
- M docs/reports/BUILD_PR_LEVEL_16_1_PHASE16_NETWORK_GATE_COMPLETION_summary.md
- M docs/reports/BUILD_PR_LEVEL_16_PHASE_DESCRIPTIONS_REPO_WIDE_NORMALIZATION_report.md
- M docs/reports/BUILD_PR_LEVEL_18_10_REMOVE_SAMPLE_SPECIFIC_LOGIC_FROM_ENGINE_PATHS_report.md
- M docs/reports/BUILD_PR_LEVEL_18_11_TRACK_A_FINAL_CONFIRMATION_report.md
- M docs/reports/BUILD_PR_LEVEL_18_13_TRACK_E_CSS_UI_NORMALIZATION_COMPLETION_VALIDATION.md
- M docs/reports/BUILD_PR_LEVEL_18_13_TRACK_E_CSS_UI_NORMALIZATION_FOUNDATION_roadmap_status_reasoning.md
- M docs/reports/BUILD_PR_LEVEL_18_13_TRACK_E_CSS_UI_NORMALIZATION_FOUNDATION_touched_files.md
- M docs/reports/BUILD_PR_LEVEL_18_1_ENGINE_USAGE_ENFORCEMENT_COMPLETION_report.md
- M docs/reports/BUILD_PR_LEVEL_18_2_BOUNDARY_HARDENING_ENFORCEMENT_report.md
- M docs/reports/BUILD_PR_LEVEL_18_4_GAME_TO_SAMPLE_RECLASSIFICATION_EXECUTION_summary.md
- M docs/reports/BUILD_PR_LEVEL_18_5_CONTRACT_STABILIZATION_PROGRESS_report.md
- M docs/reports/BUILD_PR_LEVEL_18_6_SELECTOR_PROVIDER_STABILITY_ENFORCEMENT_report.md
- M docs/reports/BUILD_PR_LEVEL_18_9_TRACK_C_FINALIZATION_report.md
- M docs/reports/BUILD_PR_LEVEL_19_13_RUNTIME_LIFECYCLE_VALIDATION_summary.md
- M docs/reports/BUILD_PR_LEVEL_19_15_DEBUG_OBSERVABILITY_VALIDATION_summary.md
- M docs/reports/BUILD_PR_LEVEL_19_17_TOOLCHAIN_PIPELINE_VALIDATION_summary.md
- M docs/reports/BUILD_PR_LEVEL_19_19_TOOLCHAIN_EDITOR_RUNTIME_CONSISTENCY_VALIDATION_summary.md
- M docs/reports/BUILD_PR_LEVEL_19_20_TOOLCHAIN_ROADMAP_GUARD_ENFORCEMENT_coverage.md
- M docs/reports/BUILD_PR_LEVEL_19_20_TOOLCHAIN_ROADMAP_GUARD_ENFORCEMENT_results.md
- M docs/reports/BUILD_PR_LEVEL_19_22_TOOLCHAIN_VALIDATION_SUMMARY_GATE_summary.md
- M docs/reports/BUILD_PR_LEVEL_19_24_ENGINE_TOOL_LEAK_REMEDIATION_GATE_report.md
- M docs/reports/BUILD_PR_LEVEL_19_25_ENGINE_TOOL_BOUNDARY_FINAL_CONFIRMATION_report.md
- M docs/reports/BUILD_PR_REMAINING_ROADMAP_VALIDATE_OR_CLOSEOUT_COMBINED_report.md
- M docs/reports/BUILD_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE_report.md
- M docs/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_1_report.md
- M docs/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_3_ARCHIVED_NOTES_POLICY_report.md
- M docs/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION_report.md
- M docs/reports/BUILD_PR_TEMPLATES_POLICY_CLASSIFICATION_report.md
- M docs/reports/BUILD_PR_TRACK_G_NETWORK_MULTIPLAYER_DEBUG_CLOSEOUT_report.md
- M docs/reports/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE_report.md
- M docs/reports/archived_notes_validation_guard.md
- M docs/reports/classes_old_keep_normalization_report.md
- M docs/reports/classes_old_keep_policy_inventory.md
- M docs/reports/classes_old_keep_removal_change_log.md
- M docs/reports/classes_old_keep_validation_guard.md
- M docs/reports/cleanup_execution_guard.md
- M docs/reports/cleanup_live_reference_inventory.txt
- M docs/reports/cleanup_target_enforcement_map.md
- M docs/reports/cleanup_target_normalization_report.md
- M docs/reports/docs_classification_matrix.md
- M docs/reports/docs_inventory_tree.txt
- M docs/reports/docs_move_map_proposed.md
- M docs/reports/overlay/level-17/BUILD_PR_LEVEL_17_59_DEBUG_OVERLAY_PROMOTE_BASELINE_report.md
- M docs/reports/overlay/level-19/BUILD_PR_LEVEL_19_6_OVERLAY_MULTI_LAYER_COMPOSITION_report.md
- M docs/reports/roadmap_status_update_instructions.txt
- M docs/reports/templates_live_usage_inventory.md
- M docs/reports/templates_validation_guard.md
- D docs/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md
- D docs/roadmaps/README.md
- D docs/roadmaps/phases.txt
-?? docs/dev/reports/file_tree.txt
-?? docs/dev/roadmaps/
-?? docs/pr/BUILD_PR_FINAL_REPO_CLEANUP_AND_ROADMAP_RENAME_V2.md
+docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md
+docs/pr/BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION.md
+docs/dev/reports/change_summary.txt
+docs/dev/reports/file_tree.txt
+docs/dev/reports/validation_checklist.txt
+docs/dev/commit_comment.txt
+tools/Vector Map Editor/index.html
+tools/Vector Map Editor/editor/VectorMapEditorApp.js
+tools/Vector Map Editor/samples/sample-manifest.json
+tools/Vector Map Editor/samples/overworld_route_map.editor.json
+tools/Vector Map Editor/samples/dungeon_layout_map.editor.json
+tools/Vector Map Editor/samples/arena_zone_map.editor.json

docs/dev/reports/validation_checklist.txt

@@ -1,11 +1,16 @@
-# Validation Checklist
+BUILD_PR_LEVEL_20_1_TOOL_SAMPLE_DROPDOWN_FOUNDATION Validation Checklist
 
-- [x] Hosted tool workspace feels near-identical to direct launch
-- [x] Tool Host does not present obvious extra page chrome around the iframe
-- [x] Host-specific controls/help exist only in the collapsible imported section
-- [x] Collapsing host controls leaves the hosted tool visually close to direct-open mode
-- [x] Open In Host still loads tools correctly (selector and runtime mount flow preserved)
-- [x] Direct tool launch still works (manifest launchPath behavior unchanged)
-- [x] Any fullscreen button is optional and non-essential (none added)
-- [x] No inline styles or embedded style blocks added
-- [x] No JS style-string injection in Tool Host runtime/main
+Execution-backed checks completed:
+[x] Verified sample dropdown (`#sampleSelect`) exists in all active tool index pages.
+[x] Verified load sample action (`#loadSampleButton`) exists in all active tool index pages.
+[x] Verified each active tool local sample manifest has exactly 3 samples.
+[x] Verified every sample manifest path resolves to an existing local file.
+[x] Verified fullscreen path references remain present and were not altered as feature work.
+
+Manual browser checks required to fully close acceptance:
+[ ] Open Tilemap Studio and load all 3 samples; confirm visible content changes.
+[ ] Open Parallax Scene Studio and load all 3 samples; confirm visible content changes.
+[ ] Open Vector Map Editor and load all 3 samples; confirm visible content changes.
+[ ] Open Vector Asset Studio and load all 3 samples; confirm visible content changes.
+[ ] Confirm manual editing flows remain functional after sample loading in each tool.
+[ ] Confirm no fullscreen regression in each tool.

docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md

@@ -421,6 +421,7 @@
 - [x] ParallaxEditor normalized
 - [x] VectorMapEditor normalized
 - [x] VectorAssetStudio normalized
+- [x] Tool sample packs + dropdown loading (3 samples per active tool)
 
 ### New Required Tools (By Dependency)
 - [x] 3DMapEditor