refactor(tools): remove non-source default payloads/replays and enforce strict workspace state application across asset/tile/parallax/vector editors

Author: DavidQ

tools/Asset Pipeline Tool/main.js

@@ -185,34 +185,6 @@ function runPipeline() {
   setStatus(`Pipeline ${result.status || "unknown"}; records=${recordCount}.`);
 }
 
-function createDefaultPayload() {
-  return {
-    gameId: "asteroids",
-    domainInputs: {
-      sprites: [
-        {
-          assetId: "ship-main",
-          runtimeFileName: "ship-main.runtime.json",
-          toolDataFileName: "ship-main.tool.json",
-          sourceToolId: "sprite-editor"
-        }
-      ]
-    },
-    toolStates: {
-      "sprite-editor": {
-        schema: "html-js-gaming.tool-state",
-        version: 1,
-        toolId: "sprite-editor",
-        projectId: "asteroids",
-        savedAtIso: "2026-01-01T00:00:00.000Z",
-        state: {
-          activeLayerId: "base"
-        }
-      }
-    }
-  };
-}
-
 function extractPipelinePayloadFromPreset(rawPreset) {
   if (!rawPreset || typeof rawPreset !== "object") {
     return null;
@@ -270,14 +242,11 @@ async function tryLoadPresetFromQuery() {
 }
 
 function bootAssetPipelineTool() {
-  const launchContext = readLaunchContextFromQuery();
   if (refs.runButton instanceof HTMLButtonElement) {
     refs.runButton.addEventListener("click", runPipeline);
   }
   if (refs.input instanceof HTMLTextAreaElement && !refs.input.value.trim()) {
-    const defaultPayload = createDefaultPayload();
-    const adapted = applyLaunchContextToPayload(defaultPayload, launchContext);
-    refs.input.value = toPrettyJson(adapted.payload);
+    setStatus("Awaiting source pipeline JSON. No default payload is applied.");
   }
   void tryLoadPresetFromQuery();
   return { runPipeline };

tools/Parallax Scene Studio/main.js

@@ -2139,6 +2139,30 @@ class ParallaxEditorApp {
 
 let parallaxSceneStudioApp = null;
 
+function isStrictWorkspaceParallaxSnapshot(snapshot) {
+  if (!snapshot || typeof snapshot !== "object") {
+    return false;
+  }
+  const documentModel = snapshot.documentModel;
+  const assetRegistry = snapshot.assetRegistry;
+  if (!documentModel || typeof documentModel !== "object") {
+    return false;
+  }
+  if (documentModel.schema !== "toolbox.parallax/1") {
+    return false;
+  }
+  if (!documentModel.map || typeof documentModel.map !== "object") {
+    return false;
+  }
+  if (!Array.isArray(documentModel.layers)) {
+    return false;
+  }
+  if (!assetRegistry || typeof assetRegistry !== "object") {
+    return false;
+  }
+  return true;
+}
+
 function bootParallaxSceneStudio() {
   if (parallaxSceneStudioApp) {
     window.parallaxSceneStudioApp = parallaxSceneStudioApp;
@@ -2151,13 +2175,15 @@ function bootParallaxSceneStudio() {
   app.applyProjectSystemState = function applyProjectSystemState(snapshot) {
     if (Date.now() <= Number(this.skipExternalProjectStateUntil || 0)) {
       this.skipExternalProjectStateUntil = 0;
-      return;
+      return true;
+    }
+    if (!isStrictWorkspaceParallaxSnapshot(snapshot)) {
+      this.updateStatus("Project state rejected: workspace snapshot is missing required parallax source data.");
+      return false;
     }
     const nextDocument = sanitizeParallaxDocument(snapshot?.documentModel);
     this.documentModel = nextDocument;
-    this.assetRegistry = snapshot?.assetRegistry && typeof snapshot.assetRegistry === "object"
-      ? sanitizeAssetRegistry(snapshot.assetRegistry)
-      : createAssetRegistry({ projectId: nextDocument?.map?.name || "parallax-project" });
+    this.assetRegistry = sanitizeAssetRegistry(snapshot.assetRegistry);
     this.selectedLayerId = typeof snapshot?.selectedLayerId === "string" && nextDocument.layers.some((layer) => layer.id === snapshot.selectedLayerId)
       ? snapshot.selectedLayerId
       : nextDocument.layers[0]?.id || "";
@@ -2169,6 +2195,7 @@ function bootParallaxSceneStudio() {
     this.syncInputsFromDocument();
     this.renderAll();
     this.updateStatus(`Project state loaded for ${this.documentModel.map.name}.`);
+    return true;
   };
   parallaxSceneStudioApp = app;
   window.parallaxSceneStudioApp = parallaxSceneStudioApp;

tools/Replay Visualizer/main.js

@@ -1,5 +1,4 @@
 import {
-  createDefaultReplayEvents,
   getReplayEventAtTime,
   normalizeReplayEvents,
   safeParseJson,
@@ -25,7 +24,7 @@ const refs = {
 };
 
 const state = {
-  events: createDefaultReplayEvents(),
+  events: [],
   currentTimeMs: 0,
   durationMs: 0,
   playing: false,
@@ -252,11 +251,7 @@ function bindEvents() {
   }
   if (refs.loadSampleButton instanceof HTMLButtonElement) {
     refs.loadSampleButton.addEventListener("click", () => {
-      const sample = createDefaultReplayEvents();
-      if (refs.input instanceof HTMLTextAreaElement) {
-        refs.input.value = toPrettyJson({ events: sample });
-      }
-      applyEvents(sample, "sample");
+      setStatus("No built-in replay sample is available. Load replay JSON from source data.");
     });
   }
   if (refs.playButton instanceof HTMLButtonElement) {
@@ -345,10 +340,8 @@ function bootReplayVisualizer() {
         refs.input.value = toPrettyJson({ events: normalizeReplayEvents(hostReplay) });
       }
     } else {
-      applyEvents(state.events, "default replay");
-      if (refs.input instanceof HTMLTextAreaElement) {
-        refs.input.value = toPrettyJson({ events: state.events });
-      }
+      applyEvents([], "empty replay");
+      setStatus("Awaiting replay source JSON. No default replay is applied.");
     }
     void tryLoadPresetFromQuery();
     initialized = true;

tools/Tile Model Converter/main.js

@@ -137,28 +137,12 @@ async function tryLoadPresetFromQuery() {
   }
 }
 
-function createDefaultPayload() {
-  return {
-    candidate: {
-      id: "arena-main",
-      name: "arena-main",
-      section: "tilemaps",
-      type: "tilemap",
-      path: "assets/tilemaps/arena-main.tilemap.json"
-    },
-    conversion: {
-      targetSection: "vectors",
-      targetType: "vector"
-    }
-  };
-}
-
 function bootTileModelConverter() {
   if (refs.runButton instanceof HTMLButtonElement) {
     refs.runButton.addEventListener("click", runConversion);
   }
   if (refs.input instanceof HTMLTextAreaElement && !refs.input.value.trim()) {
-    refs.input.value = toPrettyJson(createDefaultPayload());
+    setStatus("Awaiting source converter JSON. No default payload is applied.");
   }
   void tryLoadPresetFromQuery();
   return { runConversion };

tools/Tilemap Studio/main.js

@@ -2953,6 +2953,36 @@ class TileMapEditorApp {
 
 let tileMapStudioApp = null;
 
+function isStrictWorkspaceTilemapSnapshot(snapshot) {
+  if (!snapshot || typeof snapshot !== "object") {
+    return false;
+  }
+  const documentModel = snapshot.documentModel;
+  const assetRegistry = snapshot.assetRegistry;
+  if (!documentModel || typeof documentModel !== "object") {
+    return false;
+  }
+  if (documentModel.schema !== "toolbox.tilemap/1") {
+    return false;
+  }
+  if (!documentModel.map || typeof documentModel.map !== "object") {
+    return false;
+  }
+  if (!Array.isArray(documentModel.layers)) {
+    return false;
+  }
+  if (!Array.isArray(documentModel.tileset)) {
+    return false;
+  }
+  if (!documentModel.tilesetAtlas || typeof documentModel.tilesetAtlas !== "object") {
+    return false;
+  }
+  if (!assetRegistry || typeof assetRegistry !== "object") {
+    return false;
+  }
+  return true;
+}
+
 function bootTileMapStudio() {
   if (tileMapStudioApp) {
     window.tileMapStudioApp = tileMapStudioApp;
@@ -2965,13 +2995,15 @@ function bootTileMapStudio() {
   app.applyProjectSystemState = function applyProjectSystemState(snapshot) {
     if (Date.now() <= Number(this.skipExternalProjectStateUntil || 0)) {
       this.skipExternalProjectStateUntil = 0;
-      return;
+      return true;
+    }
+    if (!isStrictWorkspaceTilemapSnapshot(snapshot)) {
+      this.updateStatus("Project state rejected: workspace snapshot is missing required tilemap source data.");
+      return false;
     }
     const nextDocument = sanitizeDocument(snapshot?.documentModel);
     this.documentModel = nextDocument;
-    this.assetRegistry = snapshot?.assetRegistry && typeof snapshot.assetRegistry === "object"
-      ? sanitizeAssetRegistry(snapshot.assetRegistry)
-      : createAssetRegistry({ projectId: nextDocument?.map?.name || "tilemap-project" });
+    this.assetRegistry = sanitizeAssetRegistry(snapshot.assetRegistry);
     this.selectedLayerId = typeof snapshot?.selectedLayerId === "string" && nextDocument.layers.some((layer) => layer.id === snapshot.selectedLayerId)
       ? snapshot.selectedLayerId
       : nextDocument.layers[0]?.id || "";
@@ -2983,6 +3015,7 @@ function bootTileMapStudio() {
     this.syncInputsFromDocument();
     this.renderAll();
     this.updateStatus(`Project state loaded for ${this.documentModel.map.name}.`);
+    return true;
   };
   tileMapStudioApp = app;
   window.tileMapStudioApp = tileMapStudioApp;

tools/Vector Asset Studio/main.js

@@ -2923,11 +2923,19 @@ const vectorAssetStudioApi = {
     if (Date.now() <= Number(state.skipExternalProjectStateUntil || 0)) {
       return true;
     }
-    if (snapshot?.svgText) {
+    if (!snapshot || typeof snapshot !== "object") {
+      setStatus("Project state rejected: snapshot object is required.");
+      return false;
+    }
+    if (typeof snapshot.svgText !== "string") {
+      setStatus("Project state rejected: svgText is required.");
+      return false;
+    }
+    try {
       loadSvgFromText(snapshot.svgText, `${snapshot.documentName || "project"}.svg`);
-    } else {
-      createNewDocument();
-      setCanvasSize(snapshot?.canvasWidth || 1600, snapshot?.canvasHeight || 900);
+    } catch (error) {
+      setStatus(`Project state rejected: ${error instanceof Error ? error.message : "invalid SVG payload"}`);
+      return false;
     }
     state.documentName = snapshot?.documentName || state.documentName;
     state.zoom = Number.isFinite(Number(snapshot?.zoom)) ? Number(snapshot.zoom) : state.zoom;
@@ -2937,17 +2945,6 @@ const vectorAssetStudioApi = {
     updateViewTransform();
     setStatus(`Project state loaded for ${state.documentName}.`);
     return true;
-  },
-  createDefaultProjectState(projectName) {
-    return {
-      documentName: projectName || "untitled-background",
-      svgText: "",
-      canvasWidth: 1600,
-      canvasHeight: 900,
-      zoom: 1,
-      panX: 0,
-      panY: 0
-    };
   }
 };
 

tools/Vector Map Editor/editor/VectorMapDocument.js

@@ -44,10 +44,10 @@ function normalizeDegrees(value) {
 
 export class VectorMapDocument {
   constructor(data = null) {
-    this.data = data ? this.normalizeDocument(data) : this.createDefault();
+    this.data = data ? this.normalizeDocument(data) : this.createEmptyDocument();
   }
 
-  createDefault() {
+  createEmptyDocument() {
     return clone(DEFAULT_DOCUMENT);
   }
 

tools/Vector Map Editor/editor/VectorMapEditorApp.js

@@ -1247,6 +1247,15 @@ export class VectorMapEditorApp {
   }
 
   applyHistorySnapshot(snapshot) {
+    if (!snapshot || typeof snapshot !== "object") {
+      this.setStatus("Project state rejected: snapshot object is required.");
+      return false;
+    }
+    const documentData = snapshot.documentData;
+    if (!documentData || typeof documentData !== "object" || !Array.isArray(documentData.objects)) {
+      this.setStatus("Project state rejected: documentData with objects array is required.");
+      return false;
+    }
     this.documentModel.setData(snapshot.documentData);
     const objectId = snapshot.selection?.objectId;
     const pointIndex = snapshot.selection?.pointIndex;
@@ -1264,6 +1273,7 @@ export class VectorMapEditorApp {
     this.interactionController.clearCollisionResult();
     this.syncUIFromDocument();
     this.render();
+    return true;
   }
 
   commitHistorySnapshot(label, beforeSnapshot) {

tools/shared/debugInspectorData.js

@@ -74,16 +74,6 @@ export function normalizeReplayEvents(input) {
   }));
 }
 
-export function createDefaultReplayEvents() {
-  return normalizeReplayEvents([
-    { timeMs: 0, type: "boot", label: "Boot Runtime", payload: { scene: "intro" } },
-    { timeMs: 120, type: "input", label: "Press Start", payload: { key: "Enter", down: true } },
-    { timeMs: 260, type: "state", label: "Enter Gameplay", payload: { gameState: "playing", wave: 1 } },
-    { timeMs: 560, type: "spawn", label: "Spawn Enemy Group", payload: { kind: "asteroid", count: 3 } },
-    { timeMs: 900, type: "score", label: "Score +100", payload: { delta: 100, total: 100 } }
-  ]);
-}
-
 export function getReplayEventAtTime(events, timeMs = 0) {
   const normalized = asArray(events);
   const safeTimeMs = Math.max(0, asNumber(timeMs, 0));

tools/shared/projectSystemAdapters.js

@@ -68,8 +68,7 @@ function createVectorMapAdapter() {
       if (!state?.snapshot) {
         return false;
       }
-      api.applyHistorySnapshot(cloneValue(state.snapshot));
-      return true;
+      return api.applyHistorySnapshot(cloneValue(state.snapshot)) === true;
     }
   };
 }
@@ -101,8 +100,7 @@ function createTilemapAdapter() {
         return false;
       }
       if (typeof api.applyProjectSystemState === "function") {
-        api.applyProjectSystemState(cloneValue(state));
-        return true;
+        return api.applyProjectSystemState(cloneValue(state)) === true;
       }
       return false;
     }
@@ -136,8 +134,7 @@ function createParallaxAdapter() {
         return false;
       }
       if (typeof api.applyProjectSystemState === "function") {
-        api.applyProjectSystemState(cloneValue(state));
-        return true;
+        return api.applyProjectSystemState(cloneValue(state)) === true;
       }
       return false;
     }