feat(samples2tools): apply sample 1208 palette + paint/stroke in Vector Asset Studio

- read `vectorAssetEditorOptions` from sample preset payload
- register preset-provided palette entries at load time
- apply preset palette selection and default paint/stroke after SVG load
- add `sample1208-parallax` palette (SVG-derived colors) to `vector-asset-studio-sample-1208.json

Author: DavidQ

docs/dev/reports/samples2tools_batch_1_summary.txt

@@ -0,0 +1,14 @@
+Samples2Tools Batch 1 Summary
+Generated: 2026-04-23T17:05:53.817Z
+Scope: non-Phase-20 sample->tool mappings via metadata toolHints
+
+Mapped tools: 1
+Mapped sample links: 4
+
+parallax-editor: 4 sample(s)
+
+Mapped links:
+- parallax-editor <= Phase 03 Sample 0306 | Nes Style Zones Parallax | ./phase-03/0306/index.html
+- parallax-editor <= Phase 12 Sample 1204 | Tilemap Parallax Hero | ./phase-12/1204/index.html
+- parallax-editor <= Phase 12 Sample 1205 | Multi-System Demo | ./phase-12/1205/index.html
+- parallax-editor <= Phase 12 Sample 1208 | Tool Formatted Tiles Parallax | ./phase-12/1208/index.html

docs/dev/reports/samples2tools_batch_1_validation.txt

@@ -0,0 +1,14 @@
+Samples2Tools Batch 1 Validation
+Generated: 2026-04-23T17:05:53.818Z
+
+[x] samples/index.render.js syntax check
+[x] tools/renderToolsIndex.js syntax check
+[x] samples index has Tool filter control
+[x] samples index supports ?tool=<toolId> preselect
+[x] tools cards can render Samples (x) links from metadata toolHints
+[x] workspace-manager excluded from tool return-path filter
+
+Execution evidence:
+- mapped tools: 1
+- mapped sample links: 4
+- tool ids: parallax-editor

docs/dev/reports/samples2tools_link_map_1.json

@@ -0,0 +1,34 @@
+{
+  "generatedAt": "2026-04-23T17:05:53.819Z",
+  "scope": "non-phase-20",
+  "links": [
+    {
+      "toolId": "parallax-editor",
+      "sampleId": "0306",
+      "phase": "03",
+      "title": "Nes Style Zones Parallax",
+      "href": "./phase-03/0306/index.html"
+    },
+    {
+      "toolId": "parallax-editor",
+      "sampleId": "1204",
+      "phase": "12",
+      "title": "Tilemap Parallax Hero",
+      "href": "./phase-12/1204/index.html"
+    },
+    {
+      "toolId": "parallax-editor",
+      "sampleId": "1205",
+      "phase": "12",
+      "title": "Multi-System Demo",
+      "href": "./phase-12/1205/index.html"
+    },
+    {
+      "toolId": "parallax-editor",
+      "sampleId": "1208",
+      "phase": "12",
+      "title": "Tool Formatted Tiles Parallax",
+      "href": "./phase-12/1208/index.html"
+    }
+  ]
+}

docs/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md

@@ -134,11 +134,11 @@
 - [ ] No regressions to direct tool launch without sample params.
 
 ## Reporting Outputs (per execution batch)
-- [ ] `docs/dev/reports/samples2tools_batch_<n>_summary.txt`
-- [ ] `docs/dev/reports/samples2tools_batch_<n>_validation.txt`
-- [ ] `docs/dev/reports/samples2tools_link_map_<n>.json`
+- [x] `docs/dev/reports/samples2tools_batch_<n>_summary.txt`
+- [x] `docs/dev/reports/samples2tools_batch_<n>_validation.txt`
+- [x] `docs/dev/reports/samples2tools_link_map_<n>.json`
 
 ## Current Snapshot (from tools_used.txt)
-- [x] Current tagged samples across active tools: `1` (excluding Phase 20)
+- [x] Current tagged samples across active tools: `4` (excluding Phase 20)
 - [x] Candidate coverage inventory exists for all active tools
 - [.] Convert candidates into curated, validated sample-to-tool links

samples/index.css

@@ -63,6 +63,30 @@
   gap: 4px;
 }
 
+.sample-tool-roundtrip {
+  margin-top: 10px;
+}
+
+.sample-tool-roundtrip h4,
+.sample-tool-roundtrip p,
+.sample-tool-roundtrip li,
+.sample-tool-roundtrip a {
+  color: #ffffff;
+}
+
+.sample-tool-roundtrip h4 {
+  margin: 0 0 6px;
+}
+
+.sample-tool-roundtrip p {
+  margin: 0 0 6px;
+}
+
+.sample-tool-roundtrip ul {
+  margin: 0;
+  padding-left: 18px;
+}
+
 body.hub-page-samples .samples-phase-accordion {
   margin: 0 0 12px;
   border: 1px solid var(--line, rgba(221, 214, 254, 0.26));

samples/index.html

@@ -47,18 +47,18 @@ <h2>Filter Samples</h2>
             <option value="">All classes</option>
           </select>
         </div>
-        <div class="samples-filter-field">
-          <label for="samples-filter-tool">Tool</label>
-          <select id="samples-filter-tool">
-            <option value="">All tools</option>
-          </select>
-        </div>
         <div class="samples-filter-field">
           <label for="samples-filter-tag">Tag</label>
           <select id="samples-filter-tag">
             <option value="">All tags</option>
           </select>
         </div>
+        <div class="samples-filter-field">
+          <label for="samples-filter-tool">Tool</label>
+          <select id="samples-filter-tool">
+            <option value="">All tools</option>
+          </select>
+        </div>
         <div class="samples-filter-field">
           <label for="samples-phase-filter-input">Search</label>
           <input id="samples-phase-filter-input" type="text" placeholder="Phase 17, rendering, runtime..." autocomplete="off" />

samples/index.render.js

@@ -32,6 +32,61 @@ function escapeHtml(value) {
     .replaceAll("'", "'");
 }
 
+function toStandaloneToolHref(entryPoint) {
+  const normalized = String(entryPoint || "").replace(/^\.?\/*/, "");
+  return normalized ? `/tools/${encodeURI(normalized)}` : "";
+}
+
+function shouldUsePresetRoundtrip(sample, toolId) {
+  const sampleId = normalize(sample?.id);
+  const samplePhase = normalize(sample?.phase);
+  if (!sampleId || !samplePhase) {
+    return false;
+  }
+  if (sampleId === "1208" && samplePhase === "12") {
+    return toolId === "tile-map-editor"
+      || toolId === "parallax-editor"
+      || toolId === "vector-asset-studio";
+  }
+  if (toolId !== "parallax-editor") {
+    return false;
+  }
+  return (sampleId === "0306" && samplePhase === "03")
+    || (sampleId === "1204" && samplePhase === "12")
+    || (sampleId === "1205" && samplePhase === "12");
+}
+
+function buildRoundtripLinks(sample, toolRegistryMap) {
+  const orderedToolHints = asArray(sample?.toolHints)
+    .map((entry) => normalizeToken(entry))
+    .filter(Boolean)
+    .filter((toolId) => toolId !== "workspace-manager");
+  const dedupedToolHints = [...new Set(orderedToolHints)];
+  const links = [];
+
+  dedupedToolHints.forEach((toolId) => {
+    const tool = toolRegistryMap.get(toolId);
+    if (!tool) {
+      return;
+    }
+    const baseHref = toStandaloneToolHref(tool.entryPoint);
+    if (!baseHref) {
+      return;
+    }
+
+    let href = baseHref;
+    let label = `Open ${normalize(tool.displayName) || normalize(tool.name) || toolId}`;
+    if (shouldUsePresetRoundtrip(sample, toolId)) {
+      const presetPath = `/samples/phase-${sample.phase}/${sample.id}/${toolId}-sample-${sample.id}.json`;
+      href = `${baseHref}?sampleId=${encodeURIComponent(sample.id)}&samplePresetPath=${encodeURIComponent(presetPath)}`;
+    }
+
+    links.push({ toolId, href, label });
+  });
+
+  return links;
+}
+
 function readPinnedSet() {
   try {
     const raw = window.localStorage.getItem(PINNED_KEY);
@@ -82,7 +137,7 @@ function buildToolTokens(toolHints, toolLabelMap) {
     .sort((a, b) => a.label.localeCompare(b.label, undefined, { sensitivity: "base" }));
 }
 
-function buildSampleRows(metadata, pinnedSet, toolLabelMap) {
+function buildSampleRows(metadata, pinnedSet, toolLabelMap, toolRegistryMap) {
   const phaseInfoMap = new Map(
     asArray(metadata?.phases)
       .map((phase) => {
@@ -116,6 +171,7 @@ function buildSampleRows(metadata, pinnedSet, toolLabelMap) {
       const tags = asArray(sample?.tags).map((tag) => normalizeTag(tag)).filter(Boolean);
       const classTokens = buildClassTokens(sample?.classValues, sample?.engineClassesUsed);
       const toolTokens = buildToolTokens(sample?.toolHints, toolLabelMap);
+      const roundtripLinks = buildRoundtripLinks({ id, phase, toolHints: sample?.toolHints }, toolRegistryMap);
       const previewSrc = normalize(sample?.thumbnail) || normalize(sample?.preview) || "";
       return {
         id,
@@ -128,6 +184,7 @@ function buildSampleRows(metadata, pinnedSet, toolLabelMap) {
         tags,
         classTokens,
         toolTokens,
+        roundtripLinks,
         previewSrc,
         pinned: pinnedSet.has(id)
       };
@@ -253,6 +310,18 @@ function buildSampleCard(sample) {
   card.appendChild(title);
   card.appendChild(previewWrap);
   card.appendChild(description);
+  if (Array.isArray(sample.roundtripLinks) && sample.roundtripLinks.length > 0) {
+    const roundtripSection = document.createElement("section");
+    roundtripSection.className = "sample-tool-roundtrip";
+    roundtripSection.innerHTML = `
+      <h4>Tool Roundtrip Links</h4>
+      <p>Use these to validate tool to sample and sample back to tool workflows.</p>
+      <ul>
+        ${sample.roundtripLinks.map((entry) => `<li><a href="${escapeHtml(entry.href)}">${escapeHtml(entry.label)}</a></li>`).join("")}
+      </ul>
+    `;
+    card.appendChild(roundtripSection);
+  }
   return card;
 }
 
@@ -339,14 +408,21 @@ export async function initSamplesIndex() {
   }
   const metadata = await response.json();
   let pinnedSet = readPinnedSet();
+  const toolRegistry = getToolRegistry();
   const toolLabelMap = new Map(
-    getToolRegistry()
+    toolRegistry
       .filter((tool) => tool.id !== "workspace-manager")
       .map((tool) => [normalizeToken(tool.id), normalize(tool.displayName) || normalize(tool.name) || normalize(tool.id)])
       .filter((entry) => entry[0] && entry[1])
   );
+  const toolRegistryMap = new Map(
+    toolRegistry
+      .filter((tool) => tool.id !== "workspace-manager")
+      .map((tool) => [normalizeToken(tool.id), tool])
+      .filter((entry) => entry[0] && entry[1])
+  );
 
-  const model = buildSampleRows(metadata, pinnedSet, toolLabelMap);
+  const model = buildSampleRows(metadata, pinnedSet, toolLabelMap, toolRegistryMap);
   setSelectOptions(phaseSelect, model.phaseOptions.map((entry) => entry.value), (value) => {
     const found = model.phaseOptions.find((entry) => entry.value === value);
     return found?.label || `Phase ${value}`;
@@ -366,7 +442,7 @@ export async function initSamplesIndex() {
   }
 
   const render = () => {
-    const nextModel = buildSampleRows(metadata, pinnedSet, toolLabelMap);
+    const nextModel = buildSampleRows(metadata, pinnedSet, toolLabelMap, toolRegistryMap);
     const filterState = {
       phase: normalize(phaseSelect.value),
       className: normalize(classSelect.value),

samples/metadata/samples.index.metadata.json

@@ -2358,6 +2358,9 @@
         "engine/theme/index/ThemeTokens",
         "engine/tilemap/index/renderTilemap",
         "engine/tilemap/index/Tilemap"
+      ],
+      "toolHints": [
+        "parallax-editor"
       ]
     },
     {
@@ -6200,6 +6203,9 @@
         "engine/tilemap/index/resolveRectVsTilemap",
         "engine/tilemap/index/Tilemap",
         "engine/utils/index/clamp"
+      ],
+      "toolHints": [
+        "parallax-editor"
       ]
     },
     {
@@ -6247,6 +6253,9 @@
         "engine/tilemap/index/resolveRectVsTilemap",
         "engine/tilemap/index/Tilemap",
         "engine/utils/index/clamp"
+      ],
+      "toolHints": [
+        "parallax-editor"
       ]
     },
     {
@@ -6384,7 +6393,9 @@
         "engine/utils/index/clamp"
       ],
       "toolHints": [
-        "parallax-editor"
+        "tile-map-editor",
+        "parallax-editor",
+        "vector-asset-studio"
       ]
     },
     {