@tscircuit/cli 0.1.1631 → 0.1.1632

package/dist/cli/build/build.worker.js

@@ -5608,8 +5608,8 @@ var require_utils = __commonJS((exports, module) => {
     }
     return ind;
   }
-  function removeDotSegments(path10) {
-    let input = path10;
+  function removeDotSegments(path11) {
+    let input = path11;
     const output = [];
     let nextSlash = -1;
     let len = 0;
@@ -5852,8 +5852,8 @@ var require_schemes = __commonJS((exports, module) => {
       wsComponent.secure = undefined;
     }
     if (wsComponent.resourceName) {
-      const [path10, query] = wsComponent.resourceName.split("?");
-      wsComponent.path = path10 && path10 !== "/" ? path10 : undefined;
+      const [path11, query] = wsComponent.resourceName.split("?");
+      wsComponent.path = path11 && path11 !== "/" ? path11 : undefined;
       wsComponent.query = query;
       wsComponent.resourceName = undefined;
     }
@@ -11883,6 +11883,7 @@ var import_make_vfs = __toESM(require_dist(), 1);
 // lib/shared/autorouter-diagnostics.ts
 import fs2 from "node:fs";
 import path2 from "node:path";
+import { convertCircuitJsonToPcbSvg } from "circuit-to-svg";
 
 // node_modules/kleur/index.mjs
 var FORCE_COLOR;
@@ -11981,6 +11982,17 @@ function init(open, close) {
 }
 var kleur_default = $;
 
+// lib/shared/convert-svg-to-png.ts
+import { Resvg } from "@resvg/resvg-js";
+var convertSvgToPngBuffer = (svg) => {
+  const resvg = new Resvg(svg, {
+    fitTo: {
+      mode: "original"
+    }
+  });
+  return resvg.render().asPng();
+};
+
 // lib/shared/autorouter-diagnostics.ts
 var DEFAULT_DEBUG_DIR = path2.join("dist", "autorouter-debug");
 var PROGRESS_LOG_INTERVAL_MS = 1e4;
@@ -12028,6 +12040,7 @@ class AutorouterDiagnostics {
   traceCountBySubcircuit = new Map;
   activePhase = null;
   completedPhaseTraces = [];
+  hasWrittenPlacementSnapshot = false;
   summary = [];
   rootCircuit;
   constructor(options = {}) {
@@ -12060,7 +12073,6 @@ class AutorouterDiagnostics {
     const phaseLabel = this.getPhaseLabel(this.activePhase);
     const message = `Autorouter timeout after ${this.formatElapsed(elapsedMs)} in ${phaseLabel}.`;
     this.log(kleur_default.red(message));
-    this.log(`Wrote debug artifact: ${path2.relative(process.cwd(), artifactPath)}`);
     throw new AutorouterPhaseTimeoutError(message, artifactPath);
   }
   finalize(circuitJson) {
@@ -12102,6 +12114,11 @@ class AutorouterDiagnostics {
       hasLoggedStart: false,
       longRunningLoggingStarted: false
     };
+    if (this.options.enabled && !this.hasWrittenPlacementSnapshot) {
+      const placementCircuitJson = this.getCurrentCircuitJson().filter((element) => !this.isRouteElement(element));
+      this.writePngSnapshot("placement-unrouted.png", placementCircuitJson);
+      this.hasWrittenPlacementSnapshot = true;
+    }
     if (this.options.enabled) {
       this.logPhaseStart(this.activePhase);
     }
@@ -12164,6 +12181,9 @@ class AutorouterDiagnostics {
     if (this.shouldDumpSuccessfulOutput(activePhase.routingPhaseIndex)) {
       this.writeJson(this.getPhaseFileName(activePhase, "output.traces.json"), outputSrj?.traces ?? []);
     }
+    if (this.options.enabled) {
+      this.writePngSnapshot(`phase-${activePhase.routingPhaseIndex}-routed.png`, this.getCircuitJsonWithCompletedPhaseTraces());
+    }
     if (this.activePhase === activePhase) {
       this.activePhase = null;
     }
@@ -12323,8 +12343,54 @@ class AutorouterDiagnostics {
     fs2.mkdirSync(debugDir, { recursive: true });
     const filePath = path2.join(debugDir, fileName);
     fs2.writeFileSync(filePath, JSON.stringify(value, null, 2));
+    this.logArtifact(filePath);
     return filePath;
   }
+  writePngSnapshot(fileName, circuitJson) {
+    const pcbSvg = convertCircuitJsonToPcbSvg(circuitJson);
+    const png = convertSvgToPngBuffer(pcbSvg);
+    const debugDir = path2.resolve(this.options.debugDir ?? DEFAULT_DEBUG_DIR);
+    fs2.mkdirSync(debugDir, { recursive: true });
+    const filePath = path2.join(debugDir, fileName);
+    fs2.writeFileSync(filePath, png);
+    this.logArtifact(filePath);
+  }
+  logArtifact(filePath) {
+    this.log(`Wrote debug artifact: ${path2.relative(process.cwd(), filePath)}`);
+  }
+  getCircuitJsonWithCompletedPhaseTraces() {
+    const circuitJson = [...this.getCurrentCircuitJson()];
+    const elementIndexById = new Map;
+    for (const [index, element] of circuitJson.entries()) {
+      const id = this.getCircuitElementId(element);
+      if (id)
+        elementIndexById.set(id, index);
+    }
+    for (const trace of this.completedPhaseTraces) {
+      if (!trace || typeof trace !== "object")
+        continue;
+      const element = trace;
+      const id = this.getCircuitElementId(element);
+      const existingIndex = id ? elementIndexById.get(id) : undefined;
+      if (existingIndex === undefined) {
+        circuitJson.push(element);
+        if (id)
+          elementIndexById.set(id, circuitJson.length - 1);
+      } else {
+        circuitJson[existingIndex] = element;
+      }
+    }
+    return circuitJson;
+  }
+  getCircuitElementId(element) {
+    if (typeof element.type !== "string")
+      return;
+    const id = element[`${element.type}_id`];
+    return typeof id === "string" ? id : undefined;
+  }
+  isRouteElement(element) {
+    return element.type === "pcb_trace" || element.type === "pcb_via";
+  }
   getPhaseFileName(activePhase, suffix) {
     const phaseNumber = activePhase.routingPhaseIndex;
     return `phase-${phaseNumber}.${suffix}`;
@@ -12655,7 +12721,7 @@ async function generateCircuitJson({
   }
   runner.emit("renderComplete");
   const circuitJson = await runner.getCircuitJson();
-  autorouterDiagnostics.finalize(circuitJson);
+  await autorouterDiagnostics.finalize(circuitJson);
   if (saveToFile) {
     debug(`Saving circuit JSON to ${outputPath}`);
     fs5.writeFileSync(outputPath, JSON.stringify(circuitJson, null, 2));
@@ -13126,6 +13192,9 @@ var renderCircuitJsonTo3dPng = async (circuitJson, options = {}) => {
   return renderGLTFToPNGFromGLB(glbArrayBuffer, getRenderCamera(circuitJson, defaultCamera, options));
 };
 
+// cli/build/worker-output-generators.ts
+import { convertCircuitJsonToGltf } from "circuit-json-to-gltf";
+
 // node_modules/circuit-json-to-step/node_modules/stepts/dist/index.js
 var Entity = class {
   static parse(_a, _ctx) {
@@ -15412,17 +15481,78 @@ async function circuitJsonToStep(circuitJson, options = {}) {
 }
 
 // cli/build/worker-output-generators.ts
-import { convertCircuitJsonToGltf } from "circuit-json-to-gltf";
 import {
-  convertCircuitJsonToPcbSvg,
+  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg2,
   convertCircuitJsonToSchematicSvg
 } from "circuit-to-svg";
 
+// lib/shared/load-local-step-model-fs-map.ts
+import { existsSync as existsSync2 } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path7 from "node:path";
+var isRemoteUrl = (value) => /^https?:\/\//i.test(value);
+async function loadLocalStepModelFsMap(circuitJson) {
+  const fsMap = {};
+  for (const element of circuitJson) {
+    if (!element || typeof element !== "object")
+      continue;
+    const modelUrl = element.model_step_url;
+    if (typeof modelUrl !== "string" || modelUrl.length === 0)
+      continue;
+    if (isRemoteUrl(modelUrl) || fsMap[modelUrl])
+      continue;
+    const localPath = path7.resolve(process.cwd(), modelUrl);
+    if (!existsSync2(localPath))
+      continue;
+    fsMap[modelUrl] = await readFile(localPath, "utf-8");
+  }
+  return fsMap;
+}
+
+// lib/shared/simulation-svg-assets.ts
+import {
+  convertCircuitJsonToSchematicSimulationSvg,
+  convertCircuitJsonToSimulationGraphSvg,
+  isSimulationExperiment,
+  isSimulationTransientVoltageGraph
+} from "circuit-to-svg";
+var isSimulationTransientCurrentGraph = (element) => element.type === "simulation_transient_current_graph";
+var getSimulationSvgInputs = (circuitJson) => {
+  const simulationExperiment = circuitJson.find(isSimulationExperiment);
+  if (!simulationExperiment)
+    return;
+  const simulationTransientCurrentGraphIds = circuitJson.filter((element) => isSimulationTransientCurrentGraph(element) && element.simulation_experiment_id === simulationExperiment.simulation_experiment_id).map((element) => element.simulation_transient_current_graph_id);
+  const simulationTransientVoltageGraphIds = circuitJson.filter((element) => isSimulationTransientVoltageGraph(element) && element.simulation_experiment_id === simulationExperiment.simulation_experiment_id).map((element) => element.simulation_transient_voltage_graph_id);
+  if (simulationTransientCurrentGraphIds.length === 0 && simulationTransientVoltageGraphIds.length === 0) {
+    return;
+  }
+  return {
+    simulation_experiment_id: simulationExperiment.simulation_experiment_id,
+    simulation_transient_current_graph_ids: simulationTransientCurrentGraphIds,
+    simulation_transient_voltage_graph_ids: simulationTransientVoltageGraphIds
+  };
+};
+var getSimulationSvgAssetsFromCircuitJson = (circuitJson) => {
+  const simulationSvgInputs = getSimulationSvgInputs(circuitJson);
+  if (!simulationSvgInputs)
+    return;
+  return {
+    simulationSvg: convertCircuitJsonToSimulationGraphSvg({
+      circuitJson,
+      ...simulationSvgInputs
+    }),
+    schematicSimulationSvg: convertCircuitJsonToSchematicSimulationSvg({
+      circuitJson,
+      ...simulationSvgInputs
+    })
+  };
+};
+
 // node_modules/conf/dist/source/index.js
 import { isDeepStrictEqual } from "node:util";
 import process7 from "node:process";
 import fs8 from "node:fs";
-import path10 from "node:path";
+import path11 from "node:path";
 import crypto from "node:crypto";
 import assert from "node:assert";
 
@@ -15437,12 +15567,12 @@ var disallowedKeys = new Set([
   "constructor"
 ]);
 var digits = new Set("0123456789");
-function getPathSegments(path7) {
+function getPathSegments(path8) {
   const parts = [];
   let currentSegment = "";
   let currentPart = "start";
   let isIgnoring = false;
-  for (const character of path7) {
+  for (const character of path8) {
     switch (character) {
       case "\\": {
         if (currentPart === "index") {
@@ -15564,11 +15694,11 @@ function assertNotStringIndex(object, key) {
     throw new Error("Cannot use string index");
   }
 }
-function getProperty(object, path7, value) {
-  if (!isObject(object) || typeof path7 !== "string") {
+function getProperty(object, path8, value) {
+  if (!isObject(object) || typeof path8 !== "string") {
     return value === undefined ? object : value;
   }
-  const pathArray = getPathSegments(path7);
+  const pathArray = getPathSegments(path8);
   if (pathArray.length === 0) {
     return value;
   }
@@ -15588,12 +15718,12 @@ function getProperty(object, path7, value) {
   }
   return object === undefined ? value : object;
 }
-function setProperty(object, path7, value) {
-  if (!isObject(object) || typeof path7 !== "string") {
+function setProperty(object, path8, value) {
+  if (!isObject(object) || typeof path8 !== "string") {
     return object;
   }
   const root = object;
-  const pathArray = getPathSegments(path7);
+  const pathArray = getPathSegments(path8);
   for (let index = 0;index < pathArray.length; index++) {
     const key = pathArray[index];
     assertNotStringIndex(object, key);
@@ -15606,11 +15736,11 @@ function setProperty(object, path7, value) {
   }
   return root;
 }
-function deleteProperty(object, path7) {
-  if (!isObject(object) || typeof path7 !== "string") {
+function deleteProperty(object, path8) {
+  if (!isObject(object) || typeof path8 !== "string") {
     return false;
   }
-  const pathArray = getPathSegments(path7);
+  const pathArray = getPathSegments(path8);
   for (let index = 0;index < pathArray.length; index++) {
     const key = pathArray[index];
     assertNotStringIndex(object, key);
@@ -15624,11 +15754,11 @@ function deleteProperty(object, path7) {
     }
   }
 }
-function hasProperty(object, path7) {
-  if (!isObject(object) || typeof path7 !== "string") {
+function hasProperty(object, path8) {
+  if (!isObject(object) || typeof path8 !== "string") {
     return false;
   }
-  const pathArray = getPathSegments(path7);
+  const pathArray = getPathSegments(path8);
   if (pathArray.length === 0) {
     return false;
   }
@@ -15642,41 +15772,41 @@ function hasProperty(object, path7) {
 }
 
 // node_modules/env-paths/index.js
-import path7 from "node:path";
+import path8 from "node:path";
 import os from "node:os";
 import process2 from "node:process";
 var homedir = os.homedir();
 var tmpdir = os.tmpdir();
 var { env } = process2;
 var macos = (name) => {
-  const library = path7.join(homedir, "Library");
+  const library = path8.join(homedir, "Library");
   return {
-    data: path7.join(library, "Application Support", name),
-    config: path7.join(library, "Preferences", name),
-    cache: path7.join(library, "Caches", name),
-    log: path7.join(library, "Logs", name),
-    temp: path7.join(tmpdir, name)
+    data: path8.join(library, "Application Support", name),
+    config: path8.join(library, "Preferences", name),
+    cache: path8.join(library, "Caches", name),
+    log: path8.join(library, "Logs", name),
+    temp: path8.join(tmpdir, name)
   };
 };
 var windows = (name) => {
-  const appData = env.APPDATA || path7.join(homedir, "AppData", "Roaming");
-  const localAppData = env.LOCALAPPDATA || path7.join(homedir, "AppData", "Local");
+  const appData = env.APPDATA || path8.join(homedir, "AppData", "Roaming");
+  const localAppData = env.LOCALAPPDATA || path8.join(homedir, "AppData", "Local");
   return {
-    data: path7.join(localAppData, name, "Data"),
-    config: path7.join(appData, name, "Config"),
-    cache: path7.join(localAppData, name, "Cache"),
-    log: path7.join(localAppData, name, "Log"),
-    temp: path7.join(tmpdir, name)
+    data: path8.join(localAppData, name, "Data"),
+    config: path8.join(appData, name, "Config"),
+    cache: path8.join(localAppData, name, "Cache"),
+    log: path8.join(localAppData, name, "Log"),
+    temp: path8.join(tmpdir, name)
   };
 };
 var linux = (name) => {
-  const username = path7.basename(homedir);
+  const username = path8.basename(homedir);
   return {
-    data: path7.join(env.XDG_DATA_HOME || path7.join(homedir, ".local", "share"), name),
-    config: path7.join(env.XDG_CONFIG_HOME || path7.join(homedir, ".config"), name),
-    cache: path7.join(env.XDG_CACHE_HOME || path7.join(homedir, ".cache"), name),
-    log: path7.join(env.XDG_STATE_HOME || path7.join(homedir, ".local", "state"), name),
-    temp: path7.join(tmpdir, username, name)
+    data: path8.join(env.XDG_DATA_HOME || path8.join(homedir, ".local", "share"), name),
+    config: path8.join(env.XDG_CONFIG_HOME || path8.join(homedir, ".config"), name),
+    cache: path8.join(env.XDG_CACHE_HOME || path8.join(homedir, ".cache"), name),
+    log: path8.join(env.XDG_STATE_HOME || path8.join(homedir, ".local", "state"), name),
+    temp: path8.join(tmpdir, username, name)
   };
 };
 function envPaths(name, { suffix = "nodejs" } = {}) {
@@ -15696,7 +15826,7 @@ function envPaths(name, { suffix = "nodejs" } = {}) {
 }
 
 // node_modules/atomically/dist/index.js
-import path9 from "node:path";
+import path10 from "node:path";
 
 // node_modules/stubborn-fs/dist/index.js
 import fs7 from "node:fs";
@@ -15893,7 +16023,7 @@ var isUndefined = (value) => {
 };
 
 // node_modules/atomically/dist/utils/temp.js
-import path8 from "node:path";
+import path9 from "node:path";
 
 // node_modules/when-exit/dist/node/interceptor.js
 import process6 from "node:process";
@@ -15993,7 +16123,7 @@ var Temp = {
     }
   },
   truncate: (filePath) => {
-    const basename = path8.basename(filePath);
+    const basename = path9.basename(filePath);
     if (basename.length <= LIMIT_BASENAME_LENGTH)
       return filePath;
     const truncable = /^(\.?)(.*?)((?:\.[^.]+)?(?:\.tmp-\d{10}[a-f0-9]{6})?)$/.exec(basename);
@@ -16035,7 +16165,7 @@ function writeFileSync2(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
       }
     }
     if (!filePathExists) {
-      const parentPath = path9.dirname(filePath);
+      const parentPath = path10.dirname(filePath);
       dist_default.attempt.mkdirSync(parentPath, {
         mode: DEFAULT_FOLDER_MODE,
         recursive: true
@@ -16351,7 +16481,7 @@ class Conf {
     this.events = new EventTarget;
     this.#encryptionKey = options.encryptionKey;
     const fileExtension = options.fileExtension ? `.${options.fileExtension}` : "";
-    this.path = path10.resolve(options.cwd, `${options.configName ?? "config"}${fileExtension}`);
+    this.path = path11.resolve(options.cwd, `${options.configName ?? "config"}${fileExtension}`);
     const fileStore = this.store;
     const store = Object.assign(createPlainObject(), options.defaults, fileStore);
     if (options.migrations) {
@@ -16525,7 +16655,7 @@ class Conf {
     throw new Error("Config schema violation: " + errors.join("; "));
   }
   _ensureDirectory() {
-    fs8.mkdirSync(path10.dirname(this.path), { recursive: true });
+    fs8.mkdirSync(path11.dirname(this.path), { recursive: true });
   }
   _write(value) {
     let data = this._serialize(value);
@@ -16697,12 +16827,12 @@ function jwtDecode(token, options) {
 // lib/cli-config/index.ts
 import fs10 from "node:fs";
 import os3 from "node:os";
-import path12 from "node:path";
+import path13 from "node:path";
 
 // lib/shared/handle-registry-auth-error.ts
 import fs9 from "node:fs";
 import os2 from "node:os";
-import path11 from "node:path";
+import path12 from "node:path";
 var AUTH_TOKEN_REGEX = /^\/\/npm\.tscircuit\.com\/:_authToken=(.+)$/m;
 function isUnauthorizedError(error) {
   const output = [
@@ -16735,8 +16865,8 @@ function handleRegistryAuthError({
   if (!isUnauthorizedError(error))
     return;
   const npmrcPaths = [
-    path11.join(projectDir, ".npmrc"),
-    path11.join(os2.homedir(), ".npmrc")
+    path12.join(projectDir, ".npmrc"),
+    path12.join(os2.homedir(), ".npmrc")
   ];
   const hasToken = npmrcPaths.some(hasTsciAuthToken);
   if (hasToken) {
@@ -16759,8 +16889,8 @@ var getSessionToken = () => {
 };
 var getSessionTokenFromNpmrc = () => {
   const npmrcPaths = [
-    path12.join(process.cwd(), ".npmrc"),
-    path12.join(os3.homedir(), ".npmrc")
+    path13.join(process.cwd(), ".npmrc"),
+    path13.join(os3.homedir(), ".npmrc")
   ];
   for (const npmrcPath of npmrcPaths) {
     if (!fs10.existsSync(npmrcPath))
@@ -16803,7 +16933,7 @@ var getCircuitJsonToGltfOptions = ({
 };
 
 // cli/build/convert-model-urls-to-file-urls.ts
-import path13 from "node:path";
+import path14 from "node:path";
 import { pathToFileURL as pathToFileURL3 } from "node:url";
 var convertModelUrlsToFileUrls = (circuitJson) => {
   const modelUrlKeys2 = [
@@ -16830,7 +16960,7 @@ var convertModelUrlsToFileUrls = (circuitJson) => {
         if (value.startsWith("/") || value.match(/^[a-zA-Z]:\\/)) {
           updated[key] = pathToFileURL3(value).href;
         } else if (value.startsWith(".")) {
-          updated[key] = pathToFileURL3(path13.resolve(process.cwd(), value)).href;
+          updated[key] = pathToFileURL3(path14.resolve(process.cwd(), value)).href;
         }
       }
     }
@@ -16857,79 +16987,6 @@ var normalizeToUint8Array2 = (value) => {
   throw new Error("Expected Uint8Array, ArrayBuffer, or ArrayBufferView for binary data");
 };
 
-// cli/build/svg-to-png.ts
-import { Resvg } from "@resvg/resvg-js";
-var convertSvgToPngBuffer = async (svg) => {
-  const resvg = new Resvg(svg, {
-    fitTo: {
-      mode: "original"
-    }
-  });
-  return resvg.render().asPng();
-};
-
-// lib/shared/load-local-step-model-fs-map.ts
-import { existsSync as existsSync2 } from "node:fs";
-import { readFile } from "node:fs/promises";
-import path14 from "node:path";
-var isRemoteUrl = (value) => /^https?:\/\//i.test(value);
-async function loadLocalStepModelFsMap(circuitJson) {
-  const fsMap = {};
-  for (const element of circuitJson) {
-    if (!element || typeof element !== "object")
-      continue;
-    const modelUrl = element.model_step_url;
-    if (typeof modelUrl !== "string" || modelUrl.length === 0)
-      continue;
-    if (isRemoteUrl(modelUrl) || fsMap[modelUrl])
-      continue;
-    const localPath = path14.resolve(process.cwd(), modelUrl);
-    if (!existsSync2(localPath))
-      continue;
-    fsMap[modelUrl] = await readFile(localPath, "utf-8");
-  }
-  return fsMap;
-}
-
-// lib/shared/simulation-svg-assets.ts
-import {
-  convertCircuitJsonToSchematicSimulationSvg,
-  convertCircuitJsonToSimulationGraphSvg,
-  isSimulationExperiment,
-  isSimulationTransientVoltageGraph
-} from "circuit-to-svg";
-var isSimulationTransientCurrentGraph = (element) => element.type === "simulation_transient_current_graph";
-var getSimulationSvgInputs = (circuitJson) => {
-  const simulationExperiment = circuitJson.find(isSimulationExperiment);
-  if (!simulationExperiment)
-    return;
-  const simulationTransientCurrentGraphIds = circuitJson.filter((element) => isSimulationTransientCurrentGraph(element) && element.simulation_experiment_id === simulationExperiment.simulation_experiment_id).map((element) => element.simulation_transient_current_graph_id);
-  const simulationTransientVoltageGraphIds = circuitJson.filter((element) => isSimulationTransientVoltageGraph(element) && element.simulation_experiment_id === simulationExperiment.simulation_experiment_id).map((element) => element.simulation_transient_voltage_graph_id);
-  if (simulationTransientCurrentGraphIds.length === 0 && simulationTransientVoltageGraphIds.length === 0) {
-    return;
-  }
-  return {
-    simulation_experiment_id: simulationExperiment.simulation_experiment_id,
-    simulation_transient_current_graph_ids: simulationTransientCurrentGraphIds,
-    simulation_transient_voltage_graph_ids: simulationTransientVoltageGraphIds
-  };
-};
-var getSimulationSvgAssetsFromCircuitJson = (circuitJson) => {
-  const simulationSvgInputs = getSimulationSvgInputs(circuitJson);
-  if (!simulationSvgInputs)
-    return;
-  return {
-    simulationSvg: convertCircuitJsonToSimulationGraphSvg({
-      circuitJson,
-      ...simulationSvgInputs
-    }),
-    schematicSimulationSvg: convertCircuitJsonToSchematicSimulationSvg({
-      circuitJson,
-      ...simulationSvgInputs
-    })
-  };
-};
-
 // cli/build/worker-output-generators.ts
 var writeSimulationSvgAssetsFromCircuitJson = (circuitJson, outputDir, imageFormats) => {
   if (!imageFormats.simulationSvgs && !imageFormats.simulationSchematicSvgs) {
@@ -16966,11 +17023,11 @@ var writeImageAssetsFromCircuitJson = async (circuitJson, options) => {
   const { outputDir, imageFormats, pcbSnapshotSettings } = options;
   fs11.mkdirSync(outputDir, { recursive: true });
   if (imageFormats.pcbSvgs) {
-    const pcbSvg = convertCircuitJsonToPcbSvg(circuitJson, pcbSnapshotSettings);
+    const pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson, pcbSnapshotSettings);
     fs11.writeFileSync(path15.join(outputDir, "pcb.svg"), pcbSvg, "utf-8");
   }
   if (imageFormats.pcbPngs) {
-    const pcbSvg = convertCircuitJsonToPcbSvg(circuitJson, pcbSnapshotSettings);
+    const pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson, pcbSnapshotSettings);
     fs11.writeFileSync(path15.join(outputDir, "pcb.png"), await convertSvgToPngBuffer(pcbSvg));
   }
   if (imageFormats.schematicSvgs) {

package/dist/cli/main.js

@@ -39878,7 +39878,7 @@ __export2(exports_dist_3YR26ALR, {
   convertCircuitJsonToSchematicSvg: () => convertCircuitJsonToSchematicSvg3,
   convertCircuitJsonToSchematicSimulationSvg: () => convertCircuitJsonToSchematicSimulationSvg2,
   convertCircuitJsonToPinoutSvg: () => convertCircuitJsonToPinoutSvg,
-  convertCircuitJsonToPcbSvg: () => convertCircuitJsonToPcbSvg3,
+  convertCircuitJsonToPcbSvg: () => convertCircuitJsonToPcbSvg4,
   convertCircuitJsonToAssemblySvg: () => convertCircuitJsonToAssemblySvg,
   circuitJsonToSchematicSvg: () => circuitJsonToSchematicSvg,
   circuitJsonToPcbSvg: () => circuitJsonToPcbSvg,
@@ -46226,7 +46226,7 @@ function getOutlineBounds(outline) {
     return;
   return { minX, minY, maxX, maxY };
 }
-function convertCircuitJsonToPcbSvg3(circuitJson, options) {
+function convertCircuitJsonToPcbSvg4(circuitJson, options) {
   const drawPaddingOutsideBoard = options?.drawPaddingOutsideBoard ?? true;
   const layer = options?.layer;
   const colorOverrides = options?.colorOverrides;
@@ -52774,7 +52774,7 @@ var init_dist_3YR26ALR = __esm(() => {
     pcb_component_outside_board_error: 80,
     pcb_rats_nest: 85
   };
-  circuitJsonToPcbSvg = convertCircuitJsonToPcbSvg3;
+  circuitJsonToPcbSvg = convertCircuitJsonToPcbSvg4;
   DEFAULT_BOARD_STYLE = {
     fill: "none",
     stroke: "rgb(0,0,0)",
@@ -93628,7 +93628,7 @@ var import_perfect_cli = __toESM2(require_dist2(), 1);
 // lib/getVersion.ts
 import { createRequire as createRequire2 } from "node:module";
 // package.json
-var version = "0.1.1628";
+var version = "0.1.1631";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -97762,6 +97762,20 @@ var saveProjectConfig = (config, projectDir = process.cwd()) => {
 // lib/shared/autorouter-diagnostics.ts
 import fs16 from "node:fs";
 import path16 from "node:path";
+import { convertCircuitJsonToPcbSvg } from "circuit-to-svg";
+
+// lib/shared/convert-svg-to-png.ts
+import { Resvg } from "@resvg/resvg-js";
+var convertSvgToPngBuffer = (svg) => {
+  const resvg = new Resvg(svg, {
+    fitTo: {
+      mode: "original"
+    }
+  });
+  return resvg.render().asPng();
+};
+
+// lib/shared/autorouter-diagnostics.ts
 var DEFAULT_DEBUG_DIR = path16.join("dist", "autorouter-debug");
 var PROGRESS_LOG_INTERVAL_MS = 1e4;
 var CIRCUIT_JSON_ID_PATTERN = /\b(?:source|pcb|schematic|subcircuit|cad|simulation)_[a-z0-9_]*_\d+\b/gi;
@@ -97808,6 +97822,7 @@ class AutorouterDiagnostics {
   traceCountBySubcircuit = new Map;
   activePhase = null;
   completedPhaseTraces = [];
+  hasWrittenPlacementSnapshot = false;
   summary = [];
   rootCircuit;
   constructor(options = {}) {
@@ -97840,7 +97855,6 @@ class AutorouterDiagnostics {
     const phaseLabel = this.getPhaseLabel(this.activePhase);
     const message = `Autorouter timeout after ${this.formatElapsed(elapsedMs)} in ${phaseLabel}.`;
     this.log(kleur_default.red(message));
-    this.log(`Wrote debug artifact: ${path16.relative(process.cwd(), artifactPath)}`);
     throw new AutorouterPhaseTimeoutError(message, artifactPath);
   }
   finalize(circuitJson) {
@@ -97882,6 +97896,11 @@ class AutorouterDiagnostics {
       hasLoggedStart: false,
       longRunningLoggingStarted: false
     };
+    if (this.options.enabled && !this.hasWrittenPlacementSnapshot) {
+      const placementCircuitJson = this.getCurrentCircuitJson().filter((element) => !this.isRouteElement(element));
+      this.writePngSnapshot("placement-unrouted.png", placementCircuitJson);
+      this.hasWrittenPlacementSnapshot = true;
+    }
     if (this.options.enabled) {
       this.logPhaseStart(this.activePhase);
     }
@@ -97944,6 +97963,9 @@ class AutorouterDiagnostics {
     if (this.shouldDumpSuccessfulOutput(activePhase.routingPhaseIndex)) {
       this.writeJson(this.getPhaseFileName(activePhase, "output.traces.json"), outputSrj?.traces ?? []);
     }
+    if (this.options.enabled) {
+      this.writePngSnapshot(`phase-${activePhase.routingPhaseIndex}-routed.png`, this.getCircuitJsonWithCompletedPhaseTraces());
+    }
     if (this.activePhase === activePhase) {
       this.activePhase = null;
     }
@@ -98103,8 +98125,54 @@ class AutorouterDiagnostics {
     fs16.mkdirSync(debugDir, { recursive: true });
     const filePath = path16.join(debugDir, fileName);
     fs16.writeFileSync(filePath, JSON.stringify(value, null, 2));
+    this.logArtifact(filePath);
     return filePath;
   }
+  writePngSnapshot(fileName, circuitJson) {
+    const pcbSvg = convertCircuitJsonToPcbSvg(circuitJson);
+    const png = convertSvgToPngBuffer(pcbSvg);
+    const debugDir = path16.resolve(this.options.debugDir ?? DEFAULT_DEBUG_DIR);
+    fs16.mkdirSync(debugDir, { recursive: true });
+    const filePath = path16.join(debugDir, fileName);
+    fs16.writeFileSync(filePath, png);
+    this.logArtifact(filePath);
+  }
+  logArtifact(filePath) {
+    this.log(`Wrote debug artifact: ${path16.relative(process.cwd(), filePath)}`);
+  }
+  getCircuitJsonWithCompletedPhaseTraces() {
+    const circuitJson = [...this.getCurrentCircuitJson()];
+    const elementIndexById = new Map;
+    for (const [index, element] of circuitJson.entries()) {
+      const id = this.getCircuitElementId(element);
+      if (id)
+        elementIndexById.set(id, index);
+    }
+    for (const trace of this.completedPhaseTraces) {
+      if (!trace || typeof trace !== "object")
+        continue;
+      const element = trace;
+      const id = this.getCircuitElementId(element);
+      const existingIndex = id ? elementIndexById.get(id) : undefined;
+      if (existingIndex === undefined) {
+        circuitJson.push(element);
+        if (id)
+          elementIndexById.set(id, circuitJson.length - 1);
+      } else {
+        circuitJson[existingIndex] = element;
+      }
+    }
+    return circuitJson;
+  }
+  getCircuitElementId(element) {
+    if (typeof element.type !== "string")
+      return;
+    const id = element[`${element.type}_id`];
+    return typeof id === "string" ? id : undefined;
+  }
+  isRouteElement(element) {
+    return element.type === "pcb_trace" || element.type === "pcb_via";
+  }
   getPhaseFileName(activePhase, suffix) {
     const phaseNumber = activePhase.routingPhaseIndex;
     return `phase-${phaseNumber}.${suffix}`;
@@ -105451,7 +105519,7 @@ async function generateCircuitJson({
   }
   runner.emit("renderComplete");
   const circuitJson = await runner.getCircuitJson();
-  autorouterDiagnostics.finalize(circuitJson);
+  await autorouterDiagnostics.finalize(circuitJson);
   if (saveToFile) {
     debug(`Saving circuit JSON to ${outputPath}`);
     fs25.writeFileSync(outputPath, JSON.stringify(circuitJson, null, 2));
@@ -106157,6 +106225,9 @@ var renderCircuitJsonTo3dPng = async (circuitJson, options = {}) => {
   return renderGLTFToPNGFromGLB(glbArrayBuffer, getRenderCamera(circuitJson, defaultCamera, options));
 };
 
+// cli/build/worker-output-generators.ts
+import { convertCircuitJsonToGltf as convertCircuitJsonToGltf2 } from "circuit-json-to-gltf";
+
 // node_modules/circuit-json-to-step/node_modules/stepts/dist/index.js
 var Entity = class {
   static parse(_a, _ctx) {
@@ -108443,42 +108514,11 @@ async function circuitJsonToStep(circuitJson, options = {}) {
 }
 
 // cli/build/worker-output-generators.ts
-import { convertCircuitJsonToGltf as convertCircuitJsonToGltf2 } from "circuit-json-to-gltf";
 import {
-  convertCircuitJsonToPcbSvg,
+  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg2,
   convertCircuitJsonToSchematicSvg
 } from "circuit-to-svg";
 
-// cli/build/worker-binary-utils.ts
-var viewToArrayBuffer3 = (view) => {
-  const copy = new Uint8Array(view.byteLength);
-  copy.set(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
-  return copy.buffer;
-};
-var normalizeToUint8Array3 = (value) => {
-  if (value instanceof Uint8Array) {
-    return value;
-  }
-  if (value instanceof ArrayBuffer) {
-    return new Uint8Array(value);
-  }
-  if (ArrayBuffer.isView(value)) {
-    return new Uint8Array(viewToArrayBuffer3(value));
-  }
-  throw new Error("Expected Uint8Array, ArrayBuffer, or ArrayBufferView for binary data");
-};
-
-// cli/build/svg-to-png.ts
-import { Resvg } from "@resvg/resvg-js";
-var convertSvgToPngBuffer = async (svg) => {
-  const resvg = new Resvg(svg, {
-    fitTo: {
-      mode: "original"
-    }
-  });
-  return resvg.render().asPng();
-};
-
 // lib/shared/load-local-step-model-fs-map.ts
 import { existsSync as existsSync6 } from "node:fs";
 import { readFile } from "node:fs/promises";
@@ -108541,6 +108581,25 @@ var getSimulationSvgAssetsFromCircuitJson = (circuitJson) => {
   };
 };
 
+// cli/build/worker-binary-utils.ts
+var viewToArrayBuffer3 = (view) => {
+  const copy = new Uint8Array(view.byteLength);
+  copy.set(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+  return copy.buffer;
+};
+var normalizeToUint8Array3 = (value) => {
+  if (value instanceof Uint8Array) {
+    return value;
+  }
+  if (value instanceof ArrayBuffer) {
+    return new Uint8Array(value);
+  }
+  if (ArrayBuffer.isView(value)) {
+    return new Uint8Array(viewToArrayBuffer3(value));
+  }
+  throw new Error("Expected Uint8Array, ArrayBuffer, or ArrayBufferView for binary data");
+};
+
 // cli/build/worker-output-generators.ts
 var writeSimulationSvgAssetsFromCircuitJson = (circuitJson, outputDir, imageFormats) => {
   if (!imageFormats.simulationSvgs && !imageFormats.simulationSchematicSvgs) {
@@ -108577,11 +108636,11 @@ var writeImageAssetsFromCircuitJson = async (circuitJson, options) => {
   const { outputDir, imageFormats, pcbSnapshotSettings } = options;
   fs30.mkdirSync(outputDir, { recursive: true });
   if (imageFormats.pcbSvgs) {
-    const pcbSvg = convertCircuitJsonToPcbSvg(circuitJson, pcbSnapshotSettings);
+    const pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson, pcbSnapshotSettings);
     fs30.writeFileSync(path33.join(outputDir, "pcb.svg"), pcbSvg, "utf-8");
   }
   if (imageFormats.pcbPngs) {
-    const pcbSvg = convertCircuitJsonToPcbSvg(circuitJson, pcbSnapshotSettings);
+    const pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson, pcbSnapshotSettings);
     fs30.writeFileSync(path33.join(outputDir, "pcb.png"), await convertSvgToPngBuffer(pcbSvg));
   }
   if (imageFormats.schematicSvgs) {
@@ -108680,7 +108739,7 @@ var buildPreviewGltf = async ({
 import fs33 from "node:fs";
 import path36 from "node:path";
 import {
-  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg2,
+  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg3,
   convertCircuitJsonToSchematicSvg as convertCircuitJsonToSchematicSvg2
 } from "circuit-to-svg";
 var generatePreviewAssets = async ({
@@ -108704,7 +108763,7 @@ var generatePreviewAssets = async ({
   if (imageFormats.pcbSvgs) {
     try {
       console.log(`${prefix}Generating PCB SVG...`);
-      const pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson, pcbSnapshotSettings);
+      const pcbSvg = convertCircuitJsonToPcbSvg3(circuitJson, pcbSnapshotSettings);
       fs33.writeFileSync(path36.join(outputDir, "pcb.svg"), pcbSvg, "utf-8");
       console.log(`${prefix}Written pcb.svg`);
     } catch (error) {
@@ -108714,7 +108773,7 @@ var generatePreviewAssets = async ({
   if (imageFormats.pcbPngs) {
     try {
       console.log(`${prefix}Generating PCB PNG...`);
-      const pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson, pcbSnapshotSettings);
+      const pcbSvg = convertCircuitJsonToPcbSvg3(circuitJson, pcbSnapshotSettings);
       fs33.writeFileSync(path36.join(outputDir, "pcb.png"), await convertSvgToPngBuffer(pcbSvg));
       console.log(`${prefix}Written pcb.png`);
     } catch (error) {
@@ -265289,7 +265348,7 @@ import path63 from "node:path";
 import { promisify as promisify3 } from "node:util";
 import { convertCircuitJsonToGltf as convertCircuitJsonToGltf4 } from "circuit-json-to-gltf";
 import {
-  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg4,
+  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg5,
   convertCircuitJsonToSchematicSvg as convertCircuitJsonToSchematicSvg4,
   convertCircuitJsonToAssemblySvg as convertCircuitJsonToAssemblySvg2
 } from "circuit-to-svg";
@@ -268935,7 +268994,7 @@ var exportSnippet = async ({
       outputContent = convertCircuitJsonToSchematicSvg4(circuitJson);
       break;
     case "pcb-svg":
-      outputContent = convertCircuitJsonToPcbSvg4(circuitJson, pcbSnapshotSettings);
+      outputContent = convertCircuitJsonToPcbSvg5(circuitJson, pcbSnapshotSettings);
       break;
     case "specctra-dsn":
       outputContent = convertCircuitJsonToDsnString(circuitJson);
@@ -290090,7 +290149,7 @@ var snapshotFilesWithWorkerPool = async (options) => {
 import fs66 from "node:fs";
 import path73 from "node:path";
 import {
-  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg5,
+  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg6,
   convertCircuitJsonToSchematicSvg as convertCircuitJsonToSchematicSvg5
 } from "circuit-to-svg";
 
@@ -290174,7 +290233,7 @@ var processSnapshotFile = async ({
   }
   if (!simulationOnly) {
     try {
-      pcbSvg = convertCircuitJsonToPcbSvg5(circuitJson, {
+      pcbSvg = convertCircuitJsonToPcbSvg6(circuitJson, {
         ...pcbSnapshotSettings,
         layer: pcbLayer
       });

package/dist/cli/snapshot/snapshot.worker.js

@@ -2674,7 +2674,7 @@ var renderCircuitJsonTo3dPng = async (circuitJson, options = {}) => {
 
 // lib/shared/process-snapshot-file.ts
 import {
-  convertCircuitJsonToPcbSvg,
+  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg2,
   convertCircuitJsonToSchematicSvg
 } from "circuit-to-svg";
 
@@ -2801,6 +2801,20 @@ var import_make_vfs = __toESM(require_dist(), 1);
 // lib/shared/autorouter-diagnostics.ts
 import fs from "node:fs";
 import path from "node:path";
+import { convertCircuitJsonToPcbSvg } from "circuit-to-svg";
+
+// lib/shared/convert-svg-to-png.ts
+import { Resvg } from "@resvg/resvg-js";
+var convertSvgToPngBuffer = (svg) => {
+  const resvg = new Resvg(svg, {
+    fitTo: {
+      mode: "original"
+    }
+  });
+  return resvg.render().asPng();
+};
+
+// lib/shared/autorouter-diagnostics.ts
 var DEFAULT_DEBUG_DIR = path.join("dist", "autorouter-debug");
 var PROGRESS_LOG_INTERVAL_MS = 1e4;
 var CIRCUIT_JSON_ID_PATTERN = /\b(?:source|pcb|schematic|subcircuit|cad|simulation)_[a-z0-9_]*_\d+\b/gi;
@@ -2847,6 +2861,7 @@ class AutorouterDiagnostics {
   traceCountBySubcircuit = new Map;
   activePhase = null;
   completedPhaseTraces = [];
+  hasWrittenPlacementSnapshot = false;
   summary = [];
   rootCircuit;
   constructor(options = {}) {
@@ -2879,7 +2894,6 @@ class AutorouterDiagnostics {
     const phaseLabel = this.getPhaseLabel(this.activePhase);
     const message = `Autorouter timeout after ${this.formatElapsed(elapsedMs)} in ${phaseLabel}.`;
     this.log(kleur_default.red(message));
-    this.log(`Wrote debug artifact: ${path.relative(process.cwd(), artifactPath)}`);
     throw new AutorouterPhaseTimeoutError(message, artifactPath);
   }
   finalize(circuitJson) {
@@ -2921,6 +2935,11 @@ class AutorouterDiagnostics {
       hasLoggedStart: false,
       longRunningLoggingStarted: false
     };
+    if (this.options.enabled && !this.hasWrittenPlacementSnapshot) {
+      const placementCircuitJson = this.getCurrentCircuitJson().filter((element) => !this.isRouteElement(element));
+      this.writePngSnapshot("placement-unrouted.png", placementCircuitJson);
+      this.hasWrittenPlacementSnapshot = true;
+    }
     if (this.options.enabled) {
       this.logPhaseStart(this.activePhase);
     }
@@ -2983,6 +3002,9 @@ class AutorouterDiagnostics {
     if (this.shouldDumpSuccessfulOutput(activePhase.routingPhaseIndex)) {
       this.writeJson(this.getPhaseFileName(activePhase, "output.traces.json"), outputSrj?.traces ?? []);
     }
+    if (this.options.enabled) {
+      this.writePngSnapshot(`phase-${activePhase.routingPhaseIndex}-routed.png`, this.getCircuitJsonWithCompletedPhaseTraces());
+    }
     if (this.activePhase === activePhase) {
       this.activePhase = null;
     }
@@ -3142,8 +3164,54 @@ class AutorouterDiagnostics {
     fs.mkdirSync(debugDir, { recursive: true });
     const filePath = path.join(debugDir, fileName);
     fs.writeFileSync(filePath, JSON.stringify(value, null, 2));
+    this.logArtifact(filePath);
     return filePath;
   }
+  writePngSnapshot(fileName, circuitJson) {
+    const pcbSvg = convertCircuitJsonToPcbSvg(circuitJson);
+    const png = convertSvgToPngBuffer(pcbSvg);
+    const debugDir = path.resolve(this.options.debugDir ?? DEFAULT_DEBUG_DIR);
+    fs.mkdirSync(debugDir, { recursive: true });
+    const filePath = path.join(debugDir, fileName);
+    fs.writeFileSync(filePath, png);
+    this.logArtifact(filePath);
+  }
+  logArtifact(filePath) {
+    this.log(`Wrote debug artifact: ${path.relative(process.cwd(), filePath)}`);
+  }
+  getCircuitJsonWithCompletedPhaseTraces() {
+    const circuitJson = [...this.getCurrentCircuitJson()];
+    const elementIndexById = new Map;
+    for (const [index, element] of circuitJson.entries()) {
+      const id = this.getCircuitElementId(element);
+      if (id)
+        elementIndexById.set(id, index);
+    }
+    for (const trace of this.completedPhaseTraces) {
+      if (!trace || typeof trace !== "object")
+        continue;
+      const element = trace;
+      const id = this.getCircuitElementId(element);
+      const existingIndex = id ? elementIndexById.get(id) : undefined;
+      if (existingIndex === undefined) {
+        circuitJson.push(element);
+        if (id)
+          elementIndexById.set(id, circuitJson.length - 1);
+      } else {
+        circuitJson[existingIndex] = element;
+      }
+    }
+    return circuitJson;
+  }
+  getCircuitElementId(element) {
+    if (typeof element.type !== "string")
+      return;
+    const id = element[`${element.type}_id`];
+    return typeof id === "string" ? id : undefined;
+  }
+  isRouteElement(element) {
+    return element.type === "pcb_trace" || element.type === "pcb_via";
+  }
   getPhaseFileName(activePhase, suffix) {
     const phaseNumber = activePhase.routingPhaseIndex;
     return `phase-${phaseNumber}.${suffix}`;
@@ -3474,7 +3542,7 @@ async function generateCircuitJson({
   }
   runner.emit("renderComplete");
   const circuitJson = await runner.getCircuitJson();
-  autorouterDiagnostics.finalize(circuitJson);
+  await autorouterDiagnostics.finalize(circuitJson);
   if (saveToFile) {
     debug(`Saving circuit JSON to ${outputPath}`);
     fs4.writeFileSync(outputPath, JSON.stringify(circuitJson, null, 2));
@@ -3690,7 +3758,7 @@ var processSnapshotFile = async ({
   }
   if (!simulationOnly) {
     try {
-      pcbSvg = convertCircuitJsonToPcbSvg(circuitJson, {
+      pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson, {
         ...pcbSnapshotSettings,
         layer: pcbLayer
       });

package/dist/lib/index.js

@@ -65811,7 +65811,7 @@ var getNodeHandler = (winterSpec, { port, middleware = [] }) => {
   }));
 };
 // package.json
-var version = "0.1.1628";
+var version = "0.1.1631";
 var package_default = {
   name: "@tscircuit/cli",
   version,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/cli",
-  "version": "0.1.1631",
+  "version": "0.1.1632",
   "main": "dist/cli/main.js",
   "exports": {
     ".": "./dist/cli/main.js",